API de opiniones integradas en la app de Google Play

La API de opiniones integradas en la app de Google Play te permite solicitar a los usuarios que envíen calificaciones y opiniones de Play Store sin tener que salir del juego o la app.

Por lo general, el flujo de opiniones integradas en la app (consulta la figura 1) se puede activar en cualquier momento mientras el usuario está en la app. Durante el flujo, el usuario puede calificar la app con el sistema de 1 a 5 estrellas y agregar un comentario opcional. Una vez lista, la opinión se envía a Play Store y, posteriormente, se muestra.

Para proteger la privacidad del usuario y evitar el uso inadecuado de la API, tu app debe seguir unos lineamientos estrictos respecto de cuándo solicitar opiniones integradas en la app y el diseño de la solicitud de opinión.

Flujo de trabajo de las opiniones integradas en la app para un usuario

Figura 1: Flujo de las opiniones integradas en la app para un usuario

Requisitos del dispositivo

Las opiniones integradas en la app solo funcionan en los siguientes dispositivos:

  • Dispositivos Android (teléfonos y tablets) con Android 5.0 (nivel de API 21) o versiones posteriores que tengan Google Play Store instalado.
  • Dispositivos con Sistema operativo Chrome que tengan Google Play Store instalado.

Requisitos de la biblioteca de Play Core

Para incorporar las opiniones integradas a la app, esta debe usar la versión 1.8.0 o una posterior de la biblioteca de Play Core.

Cuándo solicitar una opinión integrada en la app

Sigue estos lineamientos para decidir cuándo solicitar opiniones integradas en la app de los usuarios:

  • Activa el flujo de opiniones integradas en la app una vez que el usuario dedicó tiempo suficiente a la app o el juego para proporcionar comentarios útiles.
  • No envíes demasiadas solicitudes de opinión al usuario. Este enfoque ayuda a minimizar la frustración de los usuarios y limitar el uso de la API (consulta la sección sobre cuotas).
  • Tu app no debe hacer ninguna pregunta al usuario antes de mostrar el botón o la tarjeta de calificación ni en ese momento. Esto incluye preguntas sobre su opinión (como "¿Te gusta la app?") o preguntas predictivas (como "¿Calificarías esta app con 5 estrellas?").

Lineamientos de diseño

Sigue estos lineamientos para determinar la forma de incorporar opiniones integradas a la app:

  • Muestra la tarjeta tal como está, sin alterar ni modificar el diseño existente de ninguna manera, incluidos el tamaño, la opacidad, la forma y otras propiedades.
  • No agregues ninguna superposición sobre la tarjeta ni alrededor de esta.
  • La tarjeta y su fondo deben estar en la capa superior. Una vez que aparezca la tarjeta, no la quites de manera programática. La tarjeta se quitará automáticamente según la acción explícita del usuario o por medio un mecanismo interno de Play Store.

Cuotas

Para brindar una excelente experiencia del usuario, Google Play aplica una cuota de límite de tiempo a la frecuencia con la que el diálogo de opinión se puede mostrar al usuario. Debido a esa cuota, es posible que llamar al método launchReviewFlow más de una vez durante un corto período de tiempo (por ejemplo, menos de un mes) no siempre muestre un diálogo.

Dado que la cuota está sujeta a cambios, es importante que apliques tu propia lógica y que te orientes al mejor momento posible para solicitar una opinión. Por ejemplo, no debes tener una opción de llamado a la acción (como un botón) que active la API, porque es posible que el usuario ya haya alcanzado la cuota y el flujo no se muestre, lo que presentará una experiencia dañada al usuario. Para este caso de uso, redirecciona al usuario a Play Store.

Cómo incorporar opiniones integradas a la app

Obtén más información para incorporar opiniones integradas a la app según el entorno de desarrollo: