Integrare le recensioni in-app (Unity)

Questa guida descrive come integrare le recensioni in-app nella tua app utilizzando Unity. Sono disponibili guide all'integrazione separate per chi utilizza Kotlin o Java o il codice nativo.

Panoramica dell'SDK Unity

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

Configurazione dell'ambiente di sviluppo

Scarica l'ultima release del plug-in Unity recensione in-app di Play dai pacchetti Google per Unity.

Crea ReviewManager

Crea un'istanza di ReviewManager che gestisca 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 revisioni in-app per stabilire i punti positivi della procedura per richiedere all'utente una recensione (ad esempio, dopo che un utente chiude la schermata di riepilogo alla fine di un livello in un gioco). Quando l'app si avvicina a uno di questi punti, utilizza l'istanza ReviewManager per creare un'operazione asincrona, come mostrato 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 l'oggetto PlayReviewInfo necessario all'app per avviare il flusso di revisione in-app. Nell'esempio, la chiamata viene effettuata all'interno di una coroutine per eseguire l'operazione asincrona (questo non blocca il thread principale). Poiché la chiamata viene eseguita in modo asincrono, potrebbero essere necessari fino a un paio di secondi, quindi l'app deve effettuare la chiamata prima che raggiunga il punto del flusso utente in cui vuoi mostrare la recensione in-app.

Avviare il flusso di revisione in-app

Dopo che l'app ha ricevuto l'istanza PlayReviewInfo, può avviare il flusso di revisione in-app. Tieni presente che l'oggetto PlayReviewInfo è valido solo per un periodo di tempo limitato, quindi l'app non deve attendere troppo a lungo 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

Testa il flusso di revisione in-app dell'app per verificare che l'integrazione funzioni correttamente.