Small library which can be used to display a rating popup. Different informations are used to trigger the popup such as last crash date, number of session, etc

// Local config
implementation 'com.smartnsoft:smartapprating-core:2.0.0'

// Firebase Remote Config
implementation 'com.smartnsoft:smartapprating-remoteconfig:2.0.0'

// Remote JSON config
implementation 'com.smartnsoft:smartapprating-json:2.0.0'

There are multiple ways to configure the popup: A local configuration, a remote json or Firebase RemoteConfig.

For the local configuration, you just have to create a Configuration object with the required values and then give it to the builder via the setFallbackConfiguration method.

For the remote configuration, first you must host on your server a json which look like that : (sample). Then set the factory to JsonConfigFactory in the builder with the right URL and path.

Finally, for Firebase RemoteConfig, you can declare each field independently or just one field containing a json. The parameters to declare in RemoteConfig with their respective default key are :

If you want to change the keys in Firebase, you must override them by giving a RemoteConfigMatchingInformation object to the factory.

If not provided, some parameters have default values:

• No popup can be displayed if a crash has occured in the last 15 days
• No popup can be displayed if the last popup was diplayed in the last 3 days
• Time between user sessions cannot exceed 3 days
• 3 reminders maximum

Application class :

final SmartAppRatingManager ratingManager = new Builder(this)
        .setIsInDevelopmentMode(BuildConfig.DEBUG)
        .setApplicationId(BuildConfig.DEBUG ? "com.smartnsoft.metro" : BuildConfig.APPLICATION_ID)
        .setRatePopupActivity(AnimatedSmartAppRatingActivity.class)
        .setApplicationVersionName(BuildConfig.VERSION_NAME)
        .setFallbackConfiguration(new Configuration())
        .setFactory(new JsonConfigFactory("https://next.json-generator.com/", "api/json/get/4yBX9X0CN"))
        //.setFactory(new RemoteConfigFactory())
        .build();

// Needed to detect crashes
SmartAppRatingManager.setUncaughtExceptionHandler(this, Thread.getDefaultUncaughtExceptionHandler());

In order to count the number of session :

SmartAppRatingManager.increaseNumberOfSession(PreferenceManager.getDefaultSharedPreferences(this));

Display the popup :

• If you want to retrieve the configuration and display the popup in one call

smartAppRatingManager.fetchConfigurationAndTryToDisplayPopup();

• If you want to retrieve the configuration and display the popup later

// first
smartAppRatingManager.fetchConfiguration();
...
// then later
smartAppRatingManager.showRatePopup();

If you want to ask user to rate the app again, for example after a major update, you'll have to use this method:

SmartAppRatingManager.resetRating(sharedPreferences);

If you want to use a custom layout or override specific parts of the popup activity :

• Extends from class AbstractSmartAppRatingActivity

public final class MyCustomAppRatingActivity
    extends AbstractSmartAppRatingActivity
{

  @Override
  protected int getLayoutId()
  {
    return R.layout.my_custom_layout;
  }
  
}

• And register the new one in the SmartAppRatingManager Builder

final SmartAppRatingManager smartAppRatingManager = new Builder(this)
        .setRatePopupActivity(MyCustomAppRatingActivity.class)
        ...
        .build();

• Analytics

A lot of analytics events can be sent from the popup. If you need them, you will need to send events to your analytics platform via the method sendAnalyticsEvent

Events currently implemented in the library :

• Main screen is displayed
• User selects a rating
• User clicks on later button on the main screen
• User clicks on the action button on the positive or negative feedback button
• User clicks on the later button on the positive or negative feedback button

To override default event names or extras, just override the correct method from RatingScreenAnalyticsInterface interface implemented by AbstractSmartAppRatingActivity

• Converted a lot of files to Kotlin
• Added Local and RemoteConfig configuration support
• Each configuration support requires a specific module

• Added the ability to set custom drawable for each position of the rating bar
• Available on Bintray !

• Updated ConstraintLayout to version 1.1.0
• Added a way to get RatingPopup Intent to add more extras
• Improved the rating bar widget
• Disabled the reset rating feature of the SimpleRatingBar

• Initial release

The Android Team @ Smart&Soft, software agency

All sorts of contributions are welcome. Please create a pull request and/or issue.