InApp Rating and Review journey (Android)

This repository contains the components and documentation of the Android Version of InApp Rating and Review journey.

Description

This journey lets you trigger dialog to add rating & review on the App's Google PlayStore account.

Table of Contents

• Device Requirements
• Environment Setup
• Troubleshooting
• Assumptions
• LTS Support
• License

Device requirements

In-app reviews only work on the following devices:

Android devices (phones and tablets) running Android 5.0 (API level 21) or higher that have the Google Play Store installed.

When to request an in-app review

Follow these guidelines to help you decide when to request in-app reviews from users:

Trigger the in-app review flow after a user has experienced enough of your app to provide useful feedback. To provide a great user experience, Google Play enforces a time-bound quota on how often a user can be shown the review dialog. Because of this quota, invoking the dialog more than once during a short period of time (for example, less than a month) might not always display a dialog.

Environment Setup

1. Setup gradle dependency

In your app's build.gradle file:

dependencies {
implementation("com.google.android.play:review:2.0.2")
...
}

2. Invoke context extension function to trigger review dialog

Context.launchInAppReview{ isSuccessful -> }

TroubleShooting

Test in-app reviews with guidelines from Google developer docs

Assumptions

The trigger logic is app specific and is not handled by the journey. Boolean isSuccessful on invoking launchInAppReview{ isSuccessful -> } gives status if the process has finished. The API does not indicate whether the user reviewed or not, or even whether the review dialog was shown. Thus, no matter the result, we continue our app flow.

LTS Support

No restrictions

License

Backbase License. See LICENSE for more info.