Как интегрировать отзывы в приложении (Unity)

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

Обзор Unity SDK

Play In-App Review API входит в семейство Play Core SDK. API для Unity предлагает класс ReviewManager, который позволяет запрашивать и запускать процесс с помощью методов RequestReviewFlow и LaunchReviewFlow. После отправки запроса приложение может проверить его статус с помощью ReviewErrorCode.

Как настроить среду разработки

openupm add com.google.play.review

Создайте ReviewManager

Создайте экземпляр ReviewManager, который будет обрабатывать обмен данными между вашим приложением и Google Play API.

using Google.Play.Review;

// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();

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

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

var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();

Если вызов выполнен успешно, API возвращает объект PlayReviewInfo, который необходим приложению для запуска процесса оценки. В примере вызов выполняется внутри сопрограммы для выполнения асинхронной операции (это не блокирует основной поток). Поскольку вызов выполняется асинхронно, он может занять до нескольких секунд. Поэтому приложение должно выполнить вызов до того, как пользователь дойдет до момента, когда вы хотите показать ему форму отзыва.

Как запустить процесс оценки в приложении

После получения экземпляра PlayReviewInfo приложение может запустить процесс оценки. Обратите внимание, что объект PlayReviewInfo действителен только в течение ограниченного времени, поэтому ваше приложение должно запустить процесс как можно скорее.

var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using launchFlowOperation.Error.ToString().
    yield break;
}
// 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.

Дальнейшие действия

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