In-app Ratings
In-app Ratings module helps improve app rating by allowing you to customize the appropriate location and time for prompting users to rate your application. Refer to this user guide to configure in-app ratings in the Apptics web console.
Installation
Copied
Import
Dynamic in-app ratings
In dynamic in-app ratings, you can configure the criteria using screens, events, and sessions in the Apptics web console. A rate us pop-up will be shown to the user whenever the criteria are satisfied.
- Enable the Rate us module by using Apptics config class AppticsConfig.default.enableRateUs=true.
- Apptics SDK will fetch the criteria set as configured on the web console, refer to the user guide.
- Configure the anchor points on the web or call the method APRateUs.showPromptOnFulfillingCriteria() manually in your application to show the review prompt.
- The criteria set will be fetched by the Apptics SDK, every time the app is launched.
Static in-app ratings
To enable a user to initiate a review as a result of an action in the UI (probably in the settings screen), call the below method and it will open the App Store page for your app. The below method will work only when the app is live in the App Store.
Copied
Customize in-app ratings
- Call this method in the willDisplayReviewPrompt callback if you want to show a custom prompt instead of Apple's store review prompt. Please refer to APCustomHandler class.
Copied
- Open the Feedback screen from your custom review prompt.
Copied
- Call the below method to update the user action for App Store review screen when you open the store review from your custom review prompt.
Copied
- Call the below method to update the user action for feedback when you open your custom feedback screen.
Copied
- The below method will mark the review prompt shown for the current version of the app.
Note: Call this method if you have used a custom review prompt.
Copied
Note: The above method should be called only if you show the custom prompt in ‘willDisplayReviewPrompt’ callback. Also the hitcount of sessions, events and screens will be reset.
Callbacks
ARCustomHandler is the protocol to use to get callbacks related to the Feedback module.
- Create a swift/Obj class in the CustomHandler and extend the protocols to provide implementations of its requirement.
- You will get this callback whenever the criteria are satisfied.
Note: Native prompt will not be shown when you implement this method.
-(void) willDisplayReviewPrompt;
- To get notified on user actions of custom review prompt like takeToItunesConnect and sendFeedback.
-(void) rateUsActionCompletionHandler:(JRateUsAction) action;
- You can now pass the instance to the ARCustomHandler.