Cómo integrar opiniones en la app (Kotlin o Java)

En esta guía, se describe cómo integrar opiniones en la app con Kotlin o Java. Las guías de integración son diferentes para código nativo y Unity.

Cómo configurar tu entorno de desarrollo

La API de opiniones en la app es parte del SDK de Play Core. Para configurar tu entorno de desarrollo, sigue las instrucciones de configuración de la sección Java o Kotlin de la guía de la biblioteca de Play Core.

Cómo crear el ReviewManager

El objeto ReviewManager es la interfaz que permite que tu app inicie un flujo de opiniones integradas. Para obtenerlo, crea una instancia con ReviewManagerFactory.

val manager = ReviewManagerFactory.create(context)

ReviewManager manager = ReviewManagerFactory.create(context)

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 a fin de solicitarles que brinden una opinión (por ejemplo, cuando completan un nivel en un juego). Cuando tu app alcance uno de estos puntos, usa la instancia ReviewManager para crear una tarea de solicitud. Si se ejecuta de forma correcta, la API muestra el objeto ReviewInfo necesario para iniciar el flujo de opiniones en la app.

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = task.result
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode val reviewErrorCode = (task.getException() as TaskException).errorCode
    }
}

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode int reviewErrorCode = ((TaskException) task.getException()).getErrorCode();
    }
});

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

Usa la instancia ReviewInfo para iniciar el flujo de opiniones en la app. Espera hasta que el usuario complete el flujo de opiniones en la app antes de que tu app continúe su flujo normal de usuarios (como ir al siguiente nivel).

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // 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.
}

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // 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 a fin de verificar que la integración funcione correctamente.