Integrare le recensioni in-app (Unity)

Questa guida descrive come integrare le recensioni in-app nella tua app utilizzando Unity. Se utilizzi Kotlin o Java o codice nativo.

Panoramica dell'SDK Unity

L'API In-App Review di Play fa parte di Play Core SDK. L'API per Unity offre un ReviewManager per richiedere e avviare il flusso utilizzando RequestReviewFlow e LaunchReviewFlow di machine learning. Dopo aver effettuato una richiesta, la tua app può controllarne lo stato utilizzando ReviewErrorCode.

Configura l'ambiente di sviluppo

Scarica l'ultima versione del plug-in Unity per la revisione in-app di Google Play dai pacchetti Google per Unity.

Crea ReviewManager

Crea un'istanza di ReviewManager che gestisce la comunicazione tra la tua app e l'API.

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

Richiedi un oggetto ReviewInfo

Segui le indicazioni su quando richiedere l'accesso in-app revisioni per stabilire i punti positivi nel flusso utente della tua app per chiedere all'utente una recensione (ad esempio, dopo una l'utente chiude la schermata di riepilogo al termine di un livello in un gioco). Quando l'app si avvicina a uno di questi punti, usa ReviewManager per creare un'operazione asincrona, come illustrato nell'esempio seguente:

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

Se la chiamata ha esito positivo, l'API restituisce PlayReviewInfo necessario alla tua app per avviare il flusso di revisione in-app. In questo esempio, la chiamata viene effettuata all'interno di una coroutine per eseguire l'operazione asincrona (questo non blocca il thread principale). Poiché avviene in modo asincrono. L'operazione potrebbe richiedere fino a un paio di secondi, l'app deve effettuare la chiamata prima che l'app raggiunga il punto di accesso flusso in cui vuoi mostrare la recensione in-app.

Avviare il flusso di revisione in-app

Dopo che l'app ha ricevuto il PlayReviewInfo Ad esempio, può avviare il flusso di revisione in-app. Tieni presente che PlayReviewInfo è valido solo per un periodo di tempo limitato, quindi la tua app non dovrebbe attendere troppo tempo prima di avviare un flusso.

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

Passaggi successivi

Testare il flusso di revisione in-app dell'app per: verificare il corretto funzionamento dell'integrazione.