API de reseñas integradas de Google Play: reglas y límites

La API permite a los usuarios valorar tu app sin salir de ella. Google la describe como una forma de "prompt users to submit Play Store ratings and reviews without the inconvenience of leaving your app or game." (pedir a los usuarios que envíen valoraciones y reseñas de Play Store sin la molestia de salir de tu app o juego). El usuario elige de 1 a 5 estrellas y puede añadir un comentario; una vez enviada, la reseña va a Play Store.

Por qué puede no aparecer el diálogo

• Existe una cuota. Google dice que "enforces a time-bound quota on how often a user can be shown the review dialog" (aplica una cuota por tiempo sobre la frecuencia con la que se puede mostrar el diálogo de reseña al usuario). Llamar a launchReviewFlow más de una vez en poco tiempo (por ejemplo, en menos de un mes) "might not always display a dialog" (puede que no siempre muestre un diálogo). Ese valor "can be changed by Google Play without any notice." (Google Play puede cambiarlo sin previo aviso).
• No recibes resultado. La guía de Kotlin/Java dice que la API "does not indicate whether the user reviewed or not, or even whether the review dialog was shown." (no indica si el usuario reseñó o no, ni siquiera si se mostró el diálogo). Continúa tu flujo normal en cualquier caso y no muestres ningún error al usuario si el flujo falla.
• Requisitos. Android 5.0 (API 21) o superior con Play Store instalada, y Play Core 1.8.0 o superior, según la página de descripción general en el momento de la consulta.

Reglas de uso

• Activa la API cuando el usuario haya probado la app lo suficiente para dar feedback útil, y no pidas en exceso.
• No hagas preguntas antes ni mientras se muestra la tarjeta, incluida "¿Te gusta la app?".
• Muestra la tarjeta tal cual: sin cambiar tamaño, opacidad o forma, sin superposiciones, y no la quites por programación.
• No ofrezcas un botón que active la API. En ese caso, redirige a la ficha de Play Store.
• Solicita el objeto ReviewInfo con antelación solo si estás seguro de que vas a lanzar el flujo; caduca.

Sobre recompensas: las páginas que leí no tratan incentivos. Las valoraciones recompensadas no son una opción; consulta comprar reseñas de apps para la política de Play.

Diseñar alrededor de la cuota

1. Elige uno o dos momentos de alto valor (tras completar una tarea) y no vayas más allá.
2. Nunca construyas lógica que dependa de que el diálogo se haya mostrado.
3. En una entrada de ajustes, enlaza a tu ficha de Play.
4. Recoge el feedback privado por separado: pide feedback, no reseñas.

Pruebas

Google dice que puedes probar sin publicar en producción usando una pista de pruebas interna o el uso compartido interno de apps. Los límites de cuota no se aplican a las apps descargadas desde la pista de pruebas interna. Con el uso compartido interno de apps no se pueden enviar reseñas. Las condiciones (cuenta en la pista, cuenta principal de Play Store, sin reseña previa) están en la página de pruebas de Google. Ver también por qué las reseñas de testers son privadas.

Google puede cambiar todo esto. Revisa las páginas anteriores antes de cada lanzamiento. No es asesoramiento legal.

Empieza gratis.

Relacionados: centro, por qué las reseñas de testers son privadas, reseñas publicadas por el desarrollador, diseño del aviso.