App Reviews

Request App Store reviews from your users

The app-review action launches the system control for asking your users to review your app.

Apple's SKStoreReviewController, launched from a CM App Review Action

Our Developer Guide for Improving App Reviews has everything you need to quickly get up and running with an optimal app-review prompt.

It details optimizations that will improve your averate app store rating including:

• Showing the review prompt at the optimial moment

• Avoiding negative conditions, such as: low battery, no internet connection, user distractions (e.g., being on a call or driving), and more

• Excluding users who are running buggy releases of your app, or are using an interface languages not supported by your app's UI

• Avoiding users who have blocked permissions crucial to your app

• And many more!

App Review Config

An app review action has actionType of review_prompt and an empty actionData.

Example Configs

Simple Example

"reviewAction": {
    "actionType": "review_prompt",
    "actionData": {}
}

Smart Conditional Prompt

This example uses a condition to ask users to rate you at the right moment.

It will only ask users who haven't been asked in the last 21 days (504 hours), if they are using a recent app version, their device isn't in a bad state (low battery, no network, etc), and they are running a somewhat recent version of iOS. See our blog post for more ideas on how to improve when you ask for app reviews.

"smartReviewAction": {
    "actionType": "review_prompt",
    "actionData": {},
    "condition": "(
                     eventCount('system_app_review_requested') == 0 || 
                     latestEventTime('system_app_review_requested') < now() - duration('504h')
                  ) 
                 && versionGreaterThan(app_version, '2.2') 
                 && !device_low_power_mode 
                 && has_active_network 
                 && !low_data_mode 
                 && device_battery_level > 0.2 
                 && !versionLessThan(os_version, '17.0')'"
}

Be aware that iOS will only display the prompt to a user a maximum of three times within a 365-day period. See Apple's documentation on app reviews for limits and best practices.