Overview

The App Review native plugin allows you to prompt your users to leave ratings and reviews for your Apple App Store and Google Play Store listings.


Apple App Store App Review	Google Play App Review

Implementation Guide

For the Apple App Store you will need to configure the plugin with your App Store ID, the numerical component in your app store listing URL idXXXXXXX. For example, the App Store ID for the YouTube app is 544007664 given the URL is https://apps.apple.com/us/app/youtube-watch-listen-stream/id544007664

Once the native plugin has been added to your app, you may use the following Median JavaScript Bridge commands to access its functionality.

↔️Median JavaScript Bridge
median.appreview.prompt({'callback':appReviewComplete});

callback is an optional function to run once the app review modal has been closed.

Notes on prompting for a review

The Apple App Store controls the actual display of this alert so it may not show for some cases. This is to prevent frequent rating prompts which can be irritating for users. See more details in Apple's Documentation

Google Play enforces a time-bound quota on how often a user can be shown the review dialog. Because of this quota, requesting display of the dialog more than once during a short period of time (for example, less than a month) might not always display a dialog. Because the quota is subject to change, it's important to apply your own logic and target the best possible moment to request a review. For example, you should not have a call-to-action option (such as a button) to trigger the API, as a user might have already hit their quota and the flow won’t be shown, presenting a broken experience to the user. For this use case, redirect the user to the Play Store instead.