Intégrer des avis dans l'application (Unity)

Ce guide explique comment intégrer des avis dans votre application à l'aide d'Unity. Il existe des guides d'intégration distincts si vous utilisez Kotlin ou Java, le code natif ou Unreal Engine.

Présentation du SDK Unity

L'API Play In-App Review fait partie de la famille du SDK Play Core. L'API pour Unity propose une classe ReviewManager permettant de demander et de lancer le flux à l'aide des méthodes RequestReviewFlow et LaunchReviewFlow. Une fois la requête envoyée, votre application peut vérifier l'état de la requête à l'aide de ReviewErrorCode.

Configurer l'environnement de développement

openupm add com.google.play.review

Créer le ReviewManager

Créez une instance de ReviewManager qui gère la communication entre votre application et l'API Google Play.

using Google.Play.Review;

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

Demander un objet ReviewInfo

Suivez les conseils pour savoir quand demander un avis dans l'application afin de déterminer les points clés du parcours utilisateur dans votre application et inviter l'utilisateur à donner son avis (par exemple, lorsqu'il ferme l'écran récapitulatif à la fin d'un niveau dans un jeu). Lorsque votre application approche de l'un de ces points, utilisez l'instance ReviewManager pour créer une opération asynchrone, comme illustré dans l'exemple suivant:

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();

Si l'appel aboutit, l'API renvoie l'objet PlayReviewInfo dont votre application a besoin pour lancer le flux d'examen dans l'application. Dans cet exemple, l'appel est effectué dans une coroutine pour effectuer l'opération asynchrone (ce qui ne bloque pas le thread principal). Étant donné que l'appel est effectué de manière asynchrone, cela peut prendre quelques secondes. Par conséquent, l'application doit effectuer l'appel avant d'atteindre le point du parcours de l'utilisateur où vous souhaitez faire apparaître la demande d'avis dans l'application.

Lancer la procédure d'examen dans l'application

Une fois que votre application a reçu l'instance PlayReviewInfo, elle peut lancer la procédure d'examen dans l'application. Notez que l'objet PlayReviewInfo n'est valide que pour une durée limitée. Votre application ne doit donc pas attendre trop longtemps avant de lancer un flux.

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.

Étapes suivantes

Testez le flux d'examen dans l'application de votre application pour vérifier que votre intégration fonctionne correctement.