Google Play In-App Review e In-App Updates en 2026
Dos funciones de Play Core deciden en silencio si tu app sigue mejorando por sí sola en la ficha de la tienda. La API de reseñas dentro de la app permite que el usuario valore y reseñe tu app sin salir de ella. Las actualizaciones dentro de la app te permiten pedir a un usuario activo que pase a una compilación más reciente sin tener que ir a Play Store. Bien usadas, suben las valoraciones y reducen la proporción de usuarios atascados en una versión antigua. Usadas sin cuidado, molestan a la gente, consumen una cuota que no puedes ver y te dejan con tickets de soporte en lugar de señales.
Este tutorial recorre ambas API en el orden en el que realmente las implementas: requisitos, momento de la solicitud, límites de diseño, la ruta del código y, por último, las pruebas en hardware real. Todo lo que sigue se basa en el comportamiento documentado de Play Core de Google, y dos reglas enmarcan todo el proceso: no puedes forzar que aparezca un diálogo de revisión y no puedes prometer que una actualización se instalará según tu calendario. Play decide ambas cosas. Tu trabajo es solicitarlo en el momento adecuado, con el tipo de flujo correcto, y mantener la app funcionando cuando la respuesta es no.
1. Qué hace cada API y qué no hace deliberadamente
El flujo de reseñas dentro de la app permite que tu app muestre una tarjeta de valoración de Play Store. El usuario puede dejar de 1 a 5 estrellas y un comentario opcional, y la reseña se envía a Play Store y con el tiempo se muestra. Lo que no obtienes es información sobre tu propia solicitud: la API no indica si el usuario dejó una reseña ni siquiera si se mostró el diálogo. No hay ningún valor sobre el que ramificar, ni un número de estrellas que leer, ni forma de volver a mostrar la tarjeta a demanda.
Las actualizaciones dentro de la app invitan a los usuarios activos a instalar una versión más reciente. No es un interruptor de control remoto: las instalaciones nunca son silenciosas, los reinicios nunca son forzosos y las actualizaciones solo avanzan a un código de versión superior. Lo que controlas es el tipo de flujo —flexible o inmediato— y con qué fuerza lo recomiendas, mediante la prioridad de actualización asociada a la versión. Todo lo demás lo decide Play.
Un detalle más que conviene saber antes de diseñar la interfaz: si tu app está en un canal de pruebas cerradas, la calificación y el comentario recogidos mediante el flujo de reseña se comparten de forma privada contigo como desarrollador en lugar de publicarse. Resulta útil para ensayar, pero no son los mismos datos que las calificaciones públicas.
2. Requisitos que comprobar antes de escribir código
- Las reseñas dentro de la app funcionan en dispositivos Android (teléfonos, tablets y TVs con Google TV) que ejecuten Android 5.0 (nivel de API 21) o superior y tengan instalada la tienda Google Play, y en dispositivos ChromeOS que tengan instalada Play Store.
- La integración de reseñas requiere la versión 1.8.0 o superior de la biblioteca Play Core; la guía de integración actual usa
com.google.android.play:review:2.0.2, además decom.google.android.play:review-ktx:2.0.2para Kotlin. - Las actualizaciones dentro de la app son compatibles con Android 5.0 (nivel de API 21) o superior, y solo en teléfonos Android, tablets Android y ChromeOS. No son compatibles con apps que usan archivos de expansión APK (
.obb). - La integración de actualizaciones usa
com.google.android.play:app-update:2.1.0, además decom.google.android.play:app-update-ktx:2.1.0para Kotlin.
De ahí se derivan dos consecuencias. Si tu app incluye archivos de expansión, las actualizaciones dentro de la app quedan descartadas y debes solicitar las actualizaciones a través de la ficha de la tienda. Y en un dispositivo sin Play Store, ambas API simplemente no hacen nada: fallan en silencio. Por eso, condiciona tu interfaz al resultado de tu propia llamada de solicitud en lugar de dar por hecho que la función está disponible.
3. Reseña dentro de la app: los momentos en que puedes solicitarla
La guía de Google es breve y estricta. Activa el flujo después de que el usuario haya experimentado lo suficiente de la app o el juego como para dar feedback útil: un nivel terminado, una exportación completada, una primera sesión exitosa. No lo solicites en exceso; cada solicitud innecesaria consume la cuota descrita a continuación y frustra a la persona a la que pretendías complacer.
La prohibición estricta se refiere a condicionar con preguntas previas. Tu app no debe preguntar nada al usuario antes o durante la presentación del botón o la tarjeta de valoración, incluidas preguntas de opinión como "¿Te gusta la app?" y predictivas como "¿Valorarías esta app con 5 estrellas?". Filtrar antes a los usuarios insatisfechos es justo lo que la norma pretende evitar. Si quieres tu propio punto de entrada, dirígelo a la ficha de Play Store —un enlace simple que siempre funciona— y reserva la API para los momentos que tú controlas.
4. Reseñas dentro de la app: las reglas de diseño que no puedes flexibilizar
La tarjeta pertenece a Play, no a tu sistema de diseño. Muéstrala tal cual: sin cambios de tamaño, opacidad, forma ni ninguna otra propiedad. No coloques superposiciones encima ni alrededor de la tarjeta, y mantén la tarjeta y su fondo en la capa superior. Una vez que la tarjeta ha aparecido, nunca la elimines por programación: se descarta mediante una acción explícita del usuario o mediante un mecanismo interno de Play Store.
En el código, espera a que termine el flujo de revisión antes de que tu app continúe su ruta normal, por ejemplo antes de pasar al siguiente nivel. Si se produce un error durante el flujo, no se lo digas al usuario y no cambies tu flujo: continúa con normalidad cuando se active la devolución de llamada de finalización.
5. Cuotas: por qué launchReviewFlow no es un botón
Play aplica una cuota temporal a la frecuencia con la que se puede mostrar el diálogo de reseña a un usuario, por lo que llamar a launchReviewFlow más de una vez en un periodo corto —el propio ejemplo de Google es menos de un mes— puede que simplemente no muestre nada. El valor exacto es un detalle de implementación y puede cambiar sin previo aviso.
Como la cuota cambia, no puedes crear una interfaz que dé por hecho el éxito. Un botón de llamada a la acción dedicado que invoque la API es el antipatrón que Google señala explícitamente: puede que el usuario haya agotado su cuota, el flujo nunca aparezca y tu botón parezca roto. Para un clic deliberado en "valóranos", redirige a Play Store. Reserva la API para los momentos en que la solicitud es esperada y la ausencia de un diálogo pasa desapercibida.
6. Reseña dentro de la app: la ruta del código, paso a paso
Tres llamadas, en este orden.
- Crea el manager.
ReviewManagerFactory.create(context)te da elReviewManagerque inicia el flujo. - Precarga la información. Llama a
requestReviewFlow(). Si tiene éxito, recibes el objetoReviewInfoque necesita el lanzamiento; si falla, lee elReviewErrorCodede laReviewExceptiony regístralo. El objetoReviewInfosolo es válido durante un tiempo limitado, así que solicítalo con antelación, pero solo cuando tengas la certeza de que el flujo se va a lanzar. - Lanzamiento.
launchReviewFlow(activity, reviewInfo)muestra la tarjeta. La devolución de llamada de finalización te indica que el flujo ha terminado, y nada más. Continúa el flujo de tu app independientemente del resultado.
7. Actualizaciones dentro de la app: flexibles o inmediatas
Hay dos flujos y responden a preguntas de producto distintas. Las actualizaciones flexibles se descargan en segundo plano con un seguimiento cuidadoso del estado, de modo que el usuario sigue trabajando mientras llega la actualización: la opción adecuada cuando la nueva versión añade funciones o mejoras de rendimiento que pueden esperar unos minutos. Las actualizaciones inmediatas son un flujo a pantalla completa que obliga al usuario a actualizar y reiniciar antes de continuar, para actualizaciones críticas para la funcionalidad principal; tras la aceptación del usuario, Play se encarga tanto de la instalación como del reinicio de la app.
Elige el flujo más pequeño que resuelva el problema real. La escalada es legítima —puedes avisar de forma suave primero y acabar exigiendo la actualización—, pero pertenece a tu lógica de prioridad y antigüedad, no a una decisión tomada una sola vez en el momento de la implementación.
8. Días de antigüedad y prioridad de actualización: cómo se expresa la "gravedad"
Dos señales le indican a tu app cuán atrasada está una actualización.
clientVersionStalenessDays()devuelve el número de días desde que la actualización estuvo disponible en Play Store. Es el reloj natural de escalado: espera unos días antes de un aviso flexible y unos cuantos más antes de exigir uno inmediato.updatePriority()devuelve la prioridad que asignaste a la versión: un entero entre 0 (el valor predeterminado) y 5 (el máximo). Se establece mediante el campoinAppUpdatePrioritydentro deEdits.tracks.releasesen la Google Play Developer API. Todas las versiones añadidas recientemente en una publicación comparten la prioridad de la publicación, y la prioridad solo puede establecerse mientras se implementa una nueva versión: no puede cambiarse después, así que el valor debe decidirse antes de publicar.
Un detalle sutil pilla a muchos: la prioridad que ve tu app tiene en cuenta todos los códigos de versión entre la versión instalada y la más reciente disponible, sea cual sea el canal en el que se publicó cada uno. Publica la versión 1 en producción sin prioridad, la versión 2 en un canal de pruebas internas con prioridad 5 y luego la versión 3 en producción sin prioridad: los usuarios de producción que actualicen de la 1 a la 3 seguirán recibiendo la prioridad 5, porque la versión 2 queda en medio.
Ten en cuenta también el límite: inAppUpdatePriority no es compatible cuando subes una compilación a la compartición interna de apps, así que el comportamiento que depende de la prioridad no puede ensayarse de esa forma.
9. Iniciar el flujo de actualización y leer el resultado
Comprueba primero la disponibilidad. Crea un AppUpdateManager con AppUpdateManagerFactory.create(context), lee appUpdateInfo, confirma que updateAvailability() devuelve UPDATE_AVAILABLE y confirma que el tipo de flujo que pretendes usar está permitido con isUpdateTypeAllowed(). Solo entonces llama a startUpdateFlowForResult() con un lanzador de resultados de actividad registrado para el contrato integrado StartIntentSenderForResult.
Cada instancia de AppUpdateInfo solo puede iniciar una actualización una vez. Si la actualización falla y quieres reintentarla, solicita un nuevo AppUpdateInfo y vuelve a comprobar la disponibilidad y el permiso. La devolución de llamada devuelve RESULT_OK (aceptada), RESULT_CANCELED (rechazada) o RESULT_IN_APP_UPDATE_FAILED (algo más bloqueó el consentimiento o la actualización). Con las actualizaciones inmediatas puede que nunca veas RESULT_OK, porque la actualización suele haber terminado antes de que el control vuelva a tu app.
AppUpdateOptions también incluye un indicador AllowAssetPackDeletion, falso por defecto, que permite a una actualización borrar paquetes de recursos cuando el almacenamiento del dispositivo está ajustado. Actívalo de forma deliberada: primero comprueba si la actualización se realiza correctamente con el indicador en falso, y solo entonces opta por activarlo, porque el indicador existe precisamente para eliminar recursos.
10. Actualizaciones flexibles: monitorea, descarga y luego reinicia
Registra un InstallStateUpdatedListener antes de iniciar el flujo y anula su registro cuando ya no necesites actualizaciones. Mientras el estado sea DOWNLOADING, puedes leer bytesDownloaded() y totalBytesToDownload() para mostrar el progreso real. Cuando el estado llegue a DOWNLOADED, Play no reinicia la app por ti: esa es la razón de ser de un flujo flexible. Muestra una notificación o un snackbar, deja que el usuario confirme y llama a completeUpdate() cuando lo haga.
Dónde ocurre esa llamada cambia la experiencia. En primer plano, la plataforma muestra una interfaz a pantalla completa y reinicia la app en segundo plano; en segundo plano, la actualización se instala en silencio. En ambos casos, comprueba en cada punto de entrada a la app —onResume() suele ser el lugar habitual— si una actualización sigue en estado DOWNLOADED y vuelve a preguntar si es así. De lo contrario, los bytes descargados siguen ocupando el almacenamiento del usuario sin llegar a instalarse nunca.
11. Actualizaciones inmediatas: reanudar un flujo atascado
Cuando el usuario acepta una actualización inmediata, Play muestra el progreso sobre tu interfaz durante todo el proceso, y si el usuario cierra o finaliza la app, la descarga e instalación continúan en segundo plano. Eso es cómodo para la actualización e incómodo para tu código: tu app puede volver al primer plano en un estado en el que el flujo nunca se completó formalmente.
Gestiónalo en onResume(). Si updateAvailability() devuelve DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS, vuelve a llamar a startUpdateFlowForResult() para reanudar. Cuando el usuario rechaza o cancela, la interfaz de Play se cierra y tu app debe elegir: si puede funcionar sin la actualización, deja que continúe y vuelve a preguntar más adelante; si realmente no puede, dilo con palabras sencillas antes de reiniciar el flujo, para que el reinicio se entienda en lugar de vivirse como un bucle de fallos.
12. Probar ambas API en dispositivos reales
La mayoría de las integraciones "rotas" son artefactos de las pruebas. Para las actualizaciones dentro de la app, el uso compartido interno de apps es la vía estándar: asegúrate de que el dispositivo de prueba tenga instalada una compilación que admita actualizaciones dentro de la app desde una URL de uso compartido interno, sube una versión con un código de versión superior, abre el enlace de uso compartido de la nueva versión en el dispositivo sin instalarla desde la página de Play que aparece y luego inicia la app desde el lanzador: ahora debería ofrecerse la actualización a tu app.
Si aun así no funciona, revisa las cuatro causas habituales: la cuenta debe ser propietaria de la app, es decir, haber descargado tu app desde Play al menos una vez; la compilación de prueba debe compartir el ID de aplicación y la clave de firma con la versión de Play; el código de versión instalado debe ser inferior al de la actualización; y inAppUpdatePriority no es compatible con el uso compartido interno de apps, así que los flujos basados en prioridad se ven distintos allí.
Para las reseñas, la diferencia práctica está en lo que ve el tester. En un canal de pruebas cerradas, la calificación y el comentario recopilados llegan de forma privada al desarrollador en lugar de mostrarse públicamente: útil para verificar tu integración y los tiempos, pero no sirve como indicador de la evolución real de la calificación.
13. Qué vigilar una vez que ambas estén activas
Los avisos de reseña deben mover el volumen de valoraciones de forma gradual y nunca con un pico que coincida con un lanzamiento: un pico es un efecto de timing, no un cambio de calidad, y la causa habitual es un aviso colocado demasiado pronto en la sesión. Para las actualizaciones, sigue semana a semana la proporción de usuarios activos en el código de versión más reciente: una actualización flexible debería hacer crecer esa cifra sin tocar tu media de valoración, y debería reducir el número de informes de errores que recibes de compilaciones antiguas.
Si los avisos se correlacionan con desinstalaciones o con comentarios enojados de una estrella, la respuesta no es mostrar el aviso con más frecuencia ni antes en el ciclo de vida de la instalación. Lleva el disparador más adentro del recorrido del usuario, donde el valor de la app ya se ha demostrado.
¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.
Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.
← Volver a editar