The store review action prompts a rating request in the user's app store — the Play Store on Android, or the App Store on iOS. A common use is to follow up with users who gave your app a high survey score and invite them to rate it. This guide pairs well with Create a Mobile Survey Without Code.

Prerequisites

• A published survey Flow that captures a rating (see Create a Mobile Survey Without Code).

Step 1. Create a follow-up Flow

After your survey asks whether users are enjoying your app, follow up with the users who gave the highest score — this is a great chance to ask them to rate your app in the store. Create a one-step follow-up Flow with two options: rate the app, or dismiss the Flow and maybe do it later.

Step 2. Add the store review action

Select the button users tap to rate, change its Button action to Dismiss Flow, and toggle on Prompt app store rating.

When the user taps the button, the Flow dismisses and a rating request is attempted for the Play Store or App Store, depending on the device.

Step 3. Target users who gave a high score

Show this follow-up only to users who already rated you highly. When a user submits a rating in an Appcues survey, the response is captured in a user property. Use that property to target the Flow to users who gave a rating of 5.

To show the follow-up right after users see the previous Flow, trigger it with an event — the event set on the rating submit button in that Flow (in this example, "Rating Submitted"). See Create a Mobile Survey Without Code for setting up the previous Flow.

Need more inspiration? Have a look at our Create a Mobile Survey Without Code use case for additional ways to build your mobile surveys.

How Google and Apple rating requests work

Google provides general guidelines about Play Store reviews in their comment posting document. Play Store reviews shouldn't be triggered more frequently than the quota Google has set.

Apple provides their guidelines for App Store ratings in their ratings and reviews document. They limit ratings to three occurrences in a 365-day period.

Confirm it worked

• Publish the Flow and, as a user who matches the high-rating targeting, tap the rate button. The device's store rating prompt appears (subject to the store quotas above).

If the rating prompt doesn't appear

• The operating system limits how often the prompt shows (Apple: up to three times per 365 days; Google enforces its own quota). The prompt may not appear even when the action fires correctly.
• Some Android devices don't include the Play Store. In these cases the review action can be excluded — see the developer reference.
• Confirm the button's action is Dismiss Flow with Prompt app store rating toggled on.

Still stuck?

Collect the following and contact support:

• The platform (iOS or Android) and OS version of the test device.
• The Flow's settings URL and the targeting you configured.
• A screen recording showing what happens when you tap the rate button.