Cómo probar las opiniones integradas en la app (Unity)

En esta guía, se describe cómo probar las opiniones integradas en la app con Unity. Hay guías de integración separadas que puedes usar con Kotlin o Java, código nativo o Unreal Engine.

Descripción general del SDK de Unity

La API de In-App Review de Play forma parte de la familia del SDK de Play Core. La API de Unity ofrece una clase de ReviewManager para solicitar y, luego, iniciar el flujo con los métodos RequestReviewFlow y LaunchReviewFlow. Después de realizar una solicitud, tu app puede verificar el estado de la solicitud con ReviewErrorCode.

Configura tu entorno de desarrollo

OpenUPM-CLI

Si tienes instalada la CLI de OpenUPM , puedes instalar el registro de OpenUPM con el siguiente comando:

openupm add com.google.play.review

OpenUPM

  1. Abre la configuración del administrador de paquetes seleccionando la opción del menú de Unity: Edit > Project Settings > Package Manager.

  2. Agrega OpenUPM como un registro con permisos en la ventana de Package Manager:

    Name: package.openupm.com
URL: https://package.openupm.com
Scopes: com.google.external-dependency-manager
  com.google.play.common
  com.google.play.core
  com.google.play.review

  3. Abre el menú del administrador de paquetes seleccionando la opción del menú de Unity : Window > Package Manager.

  4. Establece el menú desplegable de alcance del administrador en My Registries.

  5. Selecciona el paquete Google Play Integrity plugin for Unity en la lista de paquetes y presiona Install.

Importar desde GitHub

  1. Descarga la versión .unitypackage más reciente de GitHub.

  2. Importa el archivo .unitypackage. Para ello, selecciona Assets > Import package > Custom Package en el menú de Unity y, luego, importa todos los elementos.

Cómo crear el ReviewManager

Crea una instancia de ReviewManager que controle la comunicación entre tu app y la API de Google Play.

using Google.Play.Review;

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

Cómo solicitar un objeto ReviewInfo

Sigue las instrucciones sobre cuándo solicitar opiniones integradas en la app para determinar buenos puntos en el flujo de usuarios de tu app para solicitarle al usuario que brinde una opinión (por ejemplo, después de que descarte la pantalla de resumen al final de un nivel en un juego). Cuando tu app se acerque a uno de estos puntos, usa la ReviewManager instancia para crear una operación asíncrona, como se muestra en el siguiente ejemplo:

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 la llamada se ejecuta correctamente, la API muestra el PlayReviewInfo objeto que tu app necesita para iniciar el flujo de opiniones integradas en la app. En el ejemplo, la llamada se completa dentro de una corrutina para realizar la operación asíncrona (esto no bloquea el subproceso principal). Dado que la llamada se realiza de forma asíncrona, es posible que tarde unos segundos, por lo que tu app debería realizar la llamada antes de que la app alcance el punto en el flujo de usuarios en el que quieres mostrar las opiniones integradas en la app.

Cómo iniciar el flujo de opiniones integradas en la app

Después de que tu app reciba la instancia de PlayReviewInfo, puede iniciar el flujo de opiniones integradas en la app. Ten en cuenta que el objeto PlayReviewInfo solo es válido por un período limitado, por lo que tu app no debería esperar demasiado para iniciar un flujo.

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.

Próximos pasos

Prueba el flujo de opiniones integradas en la app para verificar que la integración funcione correctamente.