Пример внедрения SDK отзывов и оценок RuStore

Документация SDK отзывов и оценок

Условия работы SDK оценок и отзывов
Подготовка требуемых параметров
Настройка примера приложения
Сценарий использования
Условия распространения
Техническая поддержка

Условия работы SDK оценок и отзывов

Для работы SDK оценок и отзывов необходимо соблюдение следующих условий:

Требования для пользователя:

ОС Android версии 7.0 или выше.
На устройстве пользователя установлена актуальная версия RuStore.
Пользователь авторизован в RuStore.
Приложение должно быть опубликовано в RuStore.

Требования для разработчика/приложения:

ApplicationId, указанный в build.gradle, совпадает с applicationId apk-файла, который вы публиковали в консоль RuStore.
Подпись keystore должна совпадать с подписью, которой было подписано приложение, опубликованное в консоль RuStore. Убедитесь, что используемый buildType (пр. debug) использует такую же подпись, что и опубликованное приложение (пр. release).

Подготовка требуемых параметров

applicationId - из приложения, которое вы публиковали в консоль RuStore, находится в файле build.gradle вашего проекта
```
android {
    defaultConfig {
        applicationId = "ru.rustore.sdk.reviewexample"
    }
}
```
release.keystore - подпись, которой было подписано приложение, опубликованное в консоль RuStore.
release.properties - в этом файле должны быть указаны параметры подписи, которой было подписано приложение, опубликованное в консоль RuStore. Как работать с ключами подписи APK-файлов

Настройка примера приложения

Замените applicationId, в файле build.gradle, на applicationId apk-файла, который вы публиковали в консоль RuStore:
```
android {
   defaultConfig {
       applicationId = "ru.rustore.sdk.reviewexample"
   }
}
```
В директории cert замените сертификат release.keystore - сертификатом своего приложения, так же в release.properties выполните настройку параметров key_alias, key_password, store_password. Подпись release.keystore должна совпадать с подписью, которой было подписано приложение, опубликованное в консоль RuStore. Убедитесь, что используемый buildType (пр. debug) использует такую же подпись, что и опубликованное приложение (пр. release).
Запустите проект и проверьте работу приложения

Сценарий-использования

Представим, что у нас есть игра, где нужно нажать 5 раз кнопку, чтобы победить. Это означает, что начало флоу пользователя - старт игры (открытие экрана), а конец флоу - победа в игре.

Начало флоу Оценка приложения Конец флоу

Подготовка к работе с оценками

Для работы с оценками необходимо создать RuStoreReviewManager с помощью RuStoreReviewManagerFactory.

RuStoreReviewManager reviewManager = RuStoreReviewManagerFactory.INSTANCE.create(requireContext());

Подготовка к запуску оценки приложения

Рекомендуется использовать requestReviewFlow заранее, перед вызовом launchReviewFlow, чтобы подготовить необходимую информацию для отображения экрана. Срок жизни ReviewInfo — около пяти минут.

private void requestReviewFlow() {
    if (reviewInfo != null) return

    reviewManager.requestReviewFlow()
           .addOnSuccessListener(reviewInfo -> {
               this.reviewInfo = reviewInfo;
           });
}

Запуск оценки приложения

Для запуска формы запроса оценки и отзыва о приложении у пользователя вызовите метод launchReviewFlow, используя ранее полученный ReviewInfo.

private void launchReviewFlow(){
    if (reviewInfo != null) {
        reviewManager.launchReviewFlow(reviewInfo)
               .addOnSuccessListener(reviewInfo -> Log.w("ReviewFlow", "Review Flow started"))
               .addOnFailureListener(throwable -> Log.e("ReviewFlow", "Review Flow error" + throwable));
    }
}

Полный код приведенных выше примеров кода приведен в данном репозитории (UserFlowFragment).

Условия распространения

Данное программное обеспечение, включая исходные коды, бинарные библиотеки и другие файлы распространяется под лицензией MIT. Информация о лицензировании доступна в документе MIT-LICENSE.txt

Техническая поддержка

Если появились вопросы по интеграции SDK оценок и отзывов, обратитесь по ссылке.