An open API service indexing awesome lists of open source software.

https://github.com/backbase/rating-request-android


https://github.com/backbase/rating-request-android

Last synced: 11 months ago
JSON representation

Awesome Lists containing this project

README

          

# 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.
![InAppRatingAndReviewJourney](https://developer.android.com/static/images/google/play/in-app-review/iar-flow.jpg)

## Table of Contents
- [Device Requirements](#device-requirements)
- [Environment Setup](#environment-setup)
- [Troubleshooting](#troubleshooting)
- [Assumptions](#assumptions)
- [LTS Support](#lts-support)
- [License](#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](https://developer.android.com/guide/playcore/in-app-review/test)

## 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](https://github.com/Backbase/backbase-micro-frontends/blob/main/LICENSE) for more info.