App Rating engagements

The Digital In-app intercept and targeting mechanisms can also be used to engage users to leave a store rating and review. App rating prompts are available for iOS and Android, and collect the review directly in the appropriate app store for the platform. When the Digital Mobile SDK is already integrated into an app this feature can be enabled without code changes in the app, and is configured from the Digital Command Center in a similar way to survey forms. Use this feature to consolidate your feedback surveys and App Rating prompts into one targeting strategy.

The following methods of App Rating engagement are available:

  • Using a direct engagement that appears as part of the app. This is the preferred and default method of App Rating engagement. A wizard guides you through the steps required.

  • Using an intercept in a similar way to an invite triggered survey. Redirects the user to the appropriate store in a separate browser.

When implementing app rating prompts with Digital Mobile SDK:
  • SDK version must be v3.3 or later.
  • To retrieve App Rating data from your Medallia instance, contact your Medallia expert.

When you use the recommended direct app rating engagement, the rating process is directly part of the app. This more direct engagement encourages users to leave feedback more than the redirect method. On both iOS and Android there is no need to integrate additional APIs for this functionality, and the app rating prompt is configured directly from the Digital Command Center.

Regardless of the type, app rating prompts use Digital's targeting rules to seamlessly prompt the user to provide a rating while ensuring session, quarantine, and all other unique SDK traits are preserved.

App rating prompts.

General Guidelines

When implementing app rating prompts, observe the following guidelines:

  • Target the relevant user segment with the ability to take into account previous feedback submitted including NPS/CSAT/OSAT scores
  • Key SDK behavior such as targeting, session logic, and quarantine remains intact for both methods
  • Suppress Targeting (Disable/Enable Intercept APIs): Calling these APIs also disables or enables intercept of app rating prompts in addition to survey invitations
  • Listeners (Android) / Delegates (iOS) - The intercept listener and delegate APIs of the SDK support App Rating prompts in addition to survey related events

iOS Direct App Rating

This feature is available from Digital SDK v3.6.0 and relies on SKStoreReviewController. For more information see Apple direct method.

Before you start, confirm the ID of your app in the app store. For example in a browser navigate to the app's page on the app store and check the address. The app's ID is listed in the URL.

Configure App rating prompts using Digital Command Center. See Configuring App Rating Prompts. Once applied, targeted users are seamlessly intercepted with the Apple Store Review prompt.

Note: The actual Apple API is handled directly by the SDK and does not require any integration efforts.

Example of iOS direct app ratings

Example of app rating prompt on iOS.

iOS Direct App Rating Notes

  • Global API limitations apply to the SDK, for example iOS versions below 10.3 are not supported for this capability
  • Quarantine logic is based on API trigger
  • A static native alert is displayed if this method is enabled and you are using an unsupported SDK version (below iOS-v3.6.0)

Android Direct App Rating

This feature is available from Digital SDK v4.0.0 and relies on ReviewManager. For more information see Google direct method.

Before you start, confirm the ID of your app in the Google Play store. For example in a browser navigate to the app's page on the store and check the address. The app's ID is listed in the URL.

Configure App rating prompts using Digital Command Center. See Configuring App Rating Prompts. Once applied, targeted users are seamlessly intercepted with the Google Play Review prompt.

Note: The actual Google API is handled directly by the SDK and does not require any integration efforts.

Example of Android direct app ratings

Example of app rating prompt on Android

Android Direct App Rating Notes

  • Global API limitations apply to the SDK, for example Android versions below API 21 are not supported for this capability
  • Quarantine logic is based on API trigger
  • A static native alert is displayed if this method is enabled and you are using an unsupported SDK version (below Android-v4.0.0)

Configuring App Rating Prompts

Configure app rating prompts from the App Rating menu option in the Digital Command Center using a quick all-in-one wizard.

To set up an app rating prompt:

  1. Add a new app rating, or edit an existing app rating.

  2. Set prompts, which is similar to the process for setting up form invitations.

  3. Set targeting, which is similar to the process for setting up targeting in form invitations.

  4. Provide App ID to redirect the prompt to the store page.

Once an app rating prompt is configured, targeted app users are prompted to rate the app in iOS App Store or Android Google Play by a the chosen type of intercept.

App ratings screen

List of app ratings, currently empty.

App Rating (1)
Swap between intercept types by selecting Banner Invite from this dropdown. This intercept type is applied to new forms automatically.
New App Rating (2)
Click this button to open a new app rating setup wizard. All actions required to set up a new app rating are done directly in this wizard.

Set prompt

Set prompt for app rating.

App rating name (3)
Enter the name of the app rating directly from the wizard. The name can only be edited in this location.
Wizard progress (4)
This indicates what step you are currently on in the App Rating wizard.
Prompt Type (5)
Use this dropdown to swap between intercept types. New app ratings default to Banner. On-device appearance is identical to existing feedback invitations.
Prompt design (6)
Customize the app rating using these options, which are the same options available for feedback invitations.

Targeting

Set targeting for app rating.

Score Targeting (7)
Non-filtered way to target end users on submitted scores in future SDK sessions. App Ratings may be targeted by CSAT/NPS score in the last minutes/hours/days.

  • 7.1 — CSAT/NPS scores of previously submitted feedback will be used.

  • 7.2 — These are kept as long as app is not erased, the most recent value will be utilized.

  • 7.3 — Contact your Medallia expert to determine if CSAT or NPS matches your program and how to configure it properly

By Custom Rule (8)
Target with a rule using a custom parameter.
Generic Rules (9)
All existing generic SDK rules are available for targeting App Ratings.
Quarantine (10)
Unique quarantine rules apply to app ratings:

  • Form Invitations are evaluated first and prioritized over App Ratings.

  • Because the "Feedback Submit" quarantine logic applies only to forms, App Rating prompt "accepted" intercept logic is utilized to assess positive user sentiment of App Ratings.

Set destination

Set app rating destination.

App ID (11)
Enter the App ID of your app per platform (Android/iOS). This determines which app page in the store the end user is redirected to in order to leave their app rating and review.
Help (12)
Click to view help.
Save (13)
Click to apply customized settings to your property.

Manage app ratings

Manage app ratings.

Publish / Unpublish (14)
Toggle to publish or unpublish the App Rating. This toggle is the same as the Publish or Unpublish toggle for forms.
Edit (15)
Click this icon to relaunch the App Rating setup wizard.
Lock / Unlock (16)
Click this icon to lock or unlock the App Rating. This function works the same as the Lock or Unlock function in forms.
Delete (17)
Click to delete App Rating. Deleting an App Rating is an irreversible action.
App Rating ID (18)
Unique App Rating ID. This ID naming convention is the same as the ID naming convention for forms.