Supported in SDKs 1.4 and above. 

Build Guide

The store review action triggers a review request for the relevant application store for the user's device, Play Store for Android devices or App store for iOS devices. This Build Guide works well as a follow up from our guide Create a Mobile Survey Without Code.

Step 1. Create a Follow-up Flow

After you've created your survey question asking your users if they're enjoying your app, you can take the opportunity to follow up right after with the users that have given you the highest score. This is a great chance to ask them to rate your app in the App Store. 

For that, create your follow-up flow that should only be one step, as shown below. Provide two options for the users: to rate your app or to dismiss the flow and maybe do it later.

Step 2. Add the store review action

After creating the buttons with the options for the users, add the store review action. To add this action, select the relevant button in the flow, change the Button action to Dismiss Flow, and toggle on the Prompt app store rating option as shown below.

When a user presses the button the flow will be dismissed and an attempt will be made to trigger the Play Store or the App store rating depending on the device.

Step 3. Target your flow to users that gave you a high score before

Now you'll want to ensure this follow-up flow only shows to users that have given you a high rating on a previous flow. When users provide a rating in a survey in Appcues, the response is captured in a user property. Use this property to target your flow to users that have given you a rating of 5.

If you'd like this follow-up to show right after the users have seen the previous flow, you can trigger it with an event. This event was set up in the button that submits the rating in the previous flow, in this case it was called Rating Submitted. You can read more about setting up the previous flow here.

How Google and Apple rating requests work

Google provides general guidelines about Play Store reviews in their comment posting document. Play Store reviews should not be triggered more frequently than the quota that 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.

Android devices that don't use the Play Store

Some Android devices don't include the Play Store. In these cases the review action can be excluded. Reference information is available in the developer docs here.