Интегрируйте обзоры в приложении (Kotlin или Java)

В этом руководстве описано, как интегрировать отзывы в ваше приложение, используя Kotlin или Java. Для приложений, использующих нативный код , Unity или Unreal Engine , существуют отдельные руководства по интеграции.

Настройте среду разработки.

Библиотека отзывов о приложениях в Play Store является частью основных библиотек Google Play . Для интеграции библиотеки отзывов о приложениях в Play Store добавьте следующую зависимость Gradle.

Классный

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:review:2.0.2'

    // For Kotlin users also add the Kotlin extensions library for Play In-App Review:
    implementation 'com.google.android.play:review-ktx:2.0.2'
    ...
}

Котлин

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:review:2.0.2")

    // For Kotlin users also import the Kotlin extensions library for Play In-App Review:
    implementation("com.google.android.play:review-ktx:2.0.2")
    ...
}

Создайте менеджер отзывов.

ReviewManager — это интерфейс, позволяющий вашему приложению запускать процесс написания отзывов внутри приложения. Получить его можно, создав экземпляр с помощью ReviewManagerFactory .

Котлин

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

Запросить объект ReviewInfo

Следуйте рекомендациям о том, когда следует запрашивать отзывы внутри приложения, чтобы определить наиболее подходящие моменты в пользовательском сценарии вашего приложения для запроса отзыва (например, когда пользователь проходит уровень в игре). Когда ваше приложение достигнет одного из этих моментов, используйте экземпляр ReviewManager для создания задачи запроса. В случае успеха API вернет объект ReviewInfo , необходимый для запуска процесса отправки отзыва внутри приложения.

Котлин

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = task.result
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode val reviewErrorCode = (task.getException() as ReviewException).errorCode
    }
}

Java

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode int reviewErrorCode = ((ReviewException) task.getException()).getErrorCode();
    }
});

Примечание: Объект ReviewInfo действителен только в течение ограниченного времени. Вашему приложению следует запросить объект ReviewInfo заранее (до кэширования), но только после того, как вы убедитесь, что ваше приложение запустит процесс написания отзывов внутри приложения.

Запустите процесс написания отзывов внутри приложения.

Используйте экземпляр ReviewInfo для запуска процесса написания отзыва внутри приложения. Подождите, пока пользователь завершит процесс написания отзыва, прежде чем ваше приложение продолжит свой обычный пользовательский процесс (например, перейдет на следующий уровень).

Котлин

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
}

Java

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
});

Важно: если во время процесса проверки в приложении возникает ошибка, не сообщайте об этом пользователю и не изменяйте обычный пользовательский интерфейс приложения. Продолжайте обычный пользовательский интерфейс приложения после вызова onComplete .

Следующие шаги

Проверьте процесс написания отзывов внутри приложения, чтобы убедиться в корректной работе интеграции.