Application Review

Configure

A mandatory condition for displaying the application review dialog is the parameter com.platform101xp.sdk.review.enabled, which you should add to AndroidManifest.xml:

<meta-data
  android:name="com.platform101xp.sdk.review.enabled"
  android:value="@bool/app_review_enabled" />

Add your skin name:

<meta-data
  android:name="com.platform101xp.sdk.app_skin_name"
  android:value="@string/app_skin_name" />

Optional parameters are:

app_review_days_delay - the number of days until the dialog reappears if the user didn't go to GooglePlay for rating. The default value is 7 days.

app_review_seconds_delay - the number of seconds delay, elapsed since the launch. The default value is 30 seconds.

<meta-data
  android:name="com.platform101xp.sdk.review.days_delay"
  android:value="@integer/app_review_days_delay" />
<meta-data
  android:name="com.platform101xp.sdk.review.seconds_delay"
  android:value="@integer/app_review_seconds_delay" />

Usage

To call the application review dialog for the first time, use the applicationReview method of the Platform101XP class:

// Java
Platform101XP.applicationReview();

---

// Kotlin
Platform101XP.applicationReview()

If you don't need delays and related logic you can use the forcedApplicationReview method.

That method shows the application rate dialog without delays.

// Java
Platform101XP.forcedApplicationReview();

---

// Kotlin
Platform101XP.forcedApplicationReview()

info

If the user has no rated the app, the dialog is called automatically after successfull authorization with delays in app_review_days_delay, app_review_seconds_delay. Also, the application review dialog is called automatically, if the user has rated application negatively.

If the user has already rated the application positively, the dialog doesn't show on applicationReview and forcedApplicationReview.

If you need call the application rate dialog under the following conditions:

• if this is the first time the window has been shown to this player.
• if the player has already seen this window and clicked in the window "show later" or selected a rating of 3 or lower, or simply closed the game.

use the conditionedForcedApplicationReview method of class P101XP:

// Java
Platform101XP.conditionedForcedApplicationReview();

---

// Kotlin
Platform101XP.conditionedForcedApplicationReview()

info

If the player during the first and subsequent impressions clicked 4 or 5 stars in the sdk window, then more when calling the method, the rating window is not shown to this player. Also, if the player put 3 stars or less and wrote the text in the feedback box, then this message is sent to the analytics.