API de Google Play In-App Reviews

La API de Google Play In-App Reviews 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 ChromeOS 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:

Condiciones del Servicio y seguridad de los datos

Cuando accedes a la Biblioteca de opiniones integradas en la app de Play o la usas, aceptas las Condiciones del Servicio del kit de desarrollo de software de Play Core. Asegúrate de leer y entender todas las condiciones y políticas aplicables antes de acceder a la biblioteca.

Seguridad de los datos

Las bibliotecas de Play Core son la interfaz de tiempo de ejecución de tu app con Google Play Store. Por lo tanto, cuando usas Play Core en tu app, Play Store ejecuta sus propios procesos, que incluyen el manejo de datos en virtud de las Condiciones del Servicio de Google Play. La siguiente información describe cómo las bibliotecas de Play Core manejan los datos para procesar solicitudes específicas de tu app.

Opiniones integradas en la app

Datos recopilados sobre el uso Datos ingresados por el usuario (calificación y opinión de texto libre)
Propósito de la recopilación de datos Los datos recopilados se usan para dejar una opinión en Play Store.
Encriptación de datos Los datos se encriptan.
Datos compartidos Los datos recopilados se usan en una revisión pública en Play Store o, si la app está en un segmento de prueba cerrada, se comparten de forma privada con el desarrollador de la app.
Eliminación de datos Los usuarios pueden borrar sus opiniones en su cuenta de Google Play Store o Cuenta de Google.

Si bien nuestro objetivo es ser lo más transparentes que podamos, eres la única persona responsable de decidir cómo responder el formulario de la sección de Seguridad de datos de Google Play en relación con las prácticas de seguridad, el uso compartido y la recopilación de datos del usuario de tu app.