Seguir el churn con las notificaciones de desarrollador en tiempo real de Google Play
Cómo medir el churn de las suscripciones de Android con las notificaciones en tiempo real de Google Play: Pub/Sub, qué significa cada evento y métricas.
Google Play informa a tu backend de los cambios en las suscripciones mediante las notificaciones de desarrollador en tiempo real (RTDN), publicadas en un tema de Google Cloud Pub/Sub. Son la base de cualquier seguimiento serio del churn en una app de Android: quién canceló, quién tiene un problema de facturación, quién hizo una pausa, quién se fue de verdad.
Hay un matiz que condiciona todo lo demás: una notificación solo dice que algo cambió. Esta guía cubre la configuración, cómo procesar cada mensaje, cómo se corresponden los tipos de notificación con las métricas de churn y los errores que distorsionan las cifras. Se basa en la documentación de Google: configurar las RTDN, la referencia de RTDN, el ciclo de vida de las suscripciones y la referencia de la API de purchases.subscriptionsv2 (todas consultadas en noviembre de 2026).
Configurar las notificaciones
La guía de configuración de Google lo explica paso a paso:
- Crea un tema de Pub/Sub en un proyecto de Google Cloud.
- Da a la cuenta de servicio
google-play-developer-notifications@system.gserviceaccount.comel rol Pub/Sub Publisher en el tema. - Crea una suscripción al tema: push hacia un endpoint HTTPS de tu backend, o pull desde un worker.
- En Play Console, introduce el nombre del tema para tu app y haz clic en Send Test Message.
- Elige los tipos de notificación: solo suscripciones y compras anuladas, o todo, incluidos los productos de compra única.
Confirma (acknowledge) cada mensaje. En las suscripciones pull, Google dice que confirmes los mensajes recibidos “para evitar entregas repetidas por parte de Cloud Pub/Sub”; en push, un código de respuesta correcto sirve como confirmación.
Procesar un mensaje
Cada mensaje de Pub/Sub tiene un campo data en base64. Decodificado, contiene version, packageName, eventTimeMillis y exactamente uno de subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification, pendingRefundReviewNotification o testNotification.
Una notificación de suscripción solo lleva un notificationType y un purchaseToken. La referencia de Google es explícita: “debes llamar a la Google Play Developer API tras recibir las notificaciones de desarrollador en tiempo real para obtener el estado completo”, porque las notificaciones “no te dan información completa sobre la compra”. La guía del ciclo de vida llama a purchases.subscriptionsv2.get “la fuente de verdad para la gestión de suscripciones”.
Así que el proceso es:
- Recibir, comprobar duplicados por
messageId(Google lo recomienda), guardar el mensaje original, confirmar. - Llamar a
purchases.subscriptionsv2.getcon el token de compra. - Guardar el estado resultante como una instantánea con el tipo de notificación y
eventTimeMillis. - Actualizar los derechos de acceso y las métricas a partir de la instantánea, no solo de la notificación.
Ten en cuenta que el token de compra solo funciona hasta 60 días después de la caducidad. Obtén el estado cuando llega la notificación, no semanas después.
Los tipos de notificación de suscripción
Según la referencia de RTDN:
| Código | Tipo | Qué pasó |
|---|---|---|
| 1 | SUBSCRIPTION_RECOVERED |
Recuperada tras la suspensión de la cuenta, o reanudada tras una pausa |
| 2 | SUBSCRIPTION_RENEWED |
Una suscripción activa se renovó |
| 3 | SUBSCRIPTION_CANCELED |
Cancelada, de forma voluntaria o involuntaria |
| 4 | SUBSCRIPTION_PURCHASED |
Nueva suscripción comprada |
| 5 | SUBSCRIPTION_ON_HOLD |
Entró en suspensión de la cuenta |
| 6 | SUBSCRIPTION_IN_GRACE_PERIOD |
Entró en periodo de gracia |
| 7 | SUBSCRIPTION_RESTARTED |
El usuario restauró una suscripción cancelada aún no caducada |
| 9 | SUBSCRIPTION_DEFERRED |
Fecha de renovación ampliada |
| 10 | SUBSCRIPTION_PAUSED |
La pausa entró en vigor |
| 11 | SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED |
Pausa programada o modificada |
| 12 | SUBSCRIPTION_REVOKED |
Revocada antes de caducar |
| 13 | SUBSCRIPTION_EXPIRED |
Caducada |
| 18 | SUBSCRIPTION_CANCELLATION_SCHEDULED |
Cancelación de un plan a plazos programada para el final del compromiso |
| 20 | SUBSCRIPTION_PENDING_PURCHASE_CANCELED |
Se canceló una transacción pendiente |
Hay algunos más (cambio de artículos, actualizaciones de cambio de precio, consentimiento a una subida de precio escalonada). El código 8 está obsoleto.
Los estados que importan para el churn
El campo subscriptionState de la API es más fiable que el tipo de notificación para contar. La guía del ciclo de vida describe qué significa cada estado para el acceso:
| Estado | ¿Tiene acceso el usuario? | Significado para el churn |
|---|---|---|
SUBSCRIPTION_STATE_ACTIVE |
Sí | Suscriptor |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
Sí | En riesgo: el pago falló |
SUBSCRIPTION_STATE_ON_HOLD |
No | En riesgo: el pago falló, acceso bloqueado |
SUBSCRIPTION_STATE_PAUSED |
No | En pausa, no perdido |
SUBSCRIPTION_STATE_CANCELED |
Hasta expiryTime |
En riesgo: renovación detenida |
SUBSCRIPTION_STATE_EXPIRED |
No | Perdido |
El periodo de gracia y la suspensión de la cuenta tienen valores por defecto que conviene conocer. El periodo de gracia está activado por defecto en todos los planes base de renovación automática. La suspensión de la cuenta también está activada por defecto, con una duración que Google calcula como 60 días menos el periodo de gracia. Ambos pueden cambiarse en Play Console. Antes de que empiece la suspensión, Google hace intentos de cobro adicionales durante un máximo de 48 horas.
De los eventos a las métricas de churn
Cuenta el churn en la caducidad
SUBSCRIPTION_CANCELED significa que se detuvo la renovación, no que el usuario se fue. Conserva el acceso hasta expiryTime y puede restaurarlo (SUBSCRIPTION_RESTARTED). Cuenta el churn en SUBSCRIPTION_EXPIRED y usa las cancelaciones como indicador adelantado.
Separa el churn voluntario del involuntario
El canceledStateContext del recurso de suscripción dice quién canceló:
userInitiatedCancellation: voluntario. También puede contener la respuesta a la encuesta de cancelación del usuario.systemInitiatedCancellation: cancelada por el sistema, “por ejemplo por un problema de facturación”. Es tu churn involuntario.developerInitiatedCancellation: cancelaste tú.replacementCancellation: sustituida por una nueva suscripción, por ejemplo tras un cambio de plan. No es churn.
El camino de la facturación tiene una secuencia reconocible: SUBSCRIPTION_IN_GRACE_PERIOD, luego SUBSCRIPTION_ON_HOLD, luego SUBSCRIPTION_RECOVERED o bien, al final de la suspensión de la cuenta, SUBSCRIPTION_CANCELED seguido inmediatamente de SUBSCRIPTION_EXPIRED.
No cuentes las pausas como churn
SUBSCRIPTION_RECOVERED se envía tanto cuando una suscripción sale de la suspensión de la cuenta como cuando se reanuda tras una pausa. Revisa el estado anterior antes de contarla como una recuperación de facturación.
Gestiona los cambios de plan y las nuevas suscripciones
Las subidas y bajadas de plan y las nuevas suscripciones dentro de la app antes de la caducidad crean una nueva compra con un token nuevo. La nueva suscripción tiene un linkedPurchaseToken que apunta a la anterior. Si no sigues estos vínculos, cada cambio de plan parece un suscriptor perdido y un suscriptor nuevo.
Las nuevas suscripciones desde Play Store tras la caducidad son distintas: Google dice que no llevan un linkedPurchaseToken, pero la respuesta de la API incluye outOfAppPurchaseContext con el token caducado hasta que confirmas la compra. Cuéntalas como reactivaciones.
Revocaciones
SUBSCRIPTION_REVOKED significa que el acceso terminó antes de tiempo: lo revocaste tú, o la compra fue objeto de un contracargo. El estado pasa a caducado. Infórmalo aparte del churn normal, junto a las compras anuladas.
Un informe mensual
- Activas al inicio: suscripciones en estado activo, en periodo de gracia o canceladas pero no caducadas.
- Churn voluntario: caducidades cuyo contexto es iniciado por el usuario.
- Churn involuntario: caducidades cuyo contexto es iniciado por el sistema.
- Tasa de recuperación de la facturación: suscripciones que entraron en periodo de gracia o suspensión de la cuenta y se recuperaron, sobre todas las que entraron.
- Restauraciones:
SUBSCRIPTION_RESTARTED. - En pausa: número, y cuántas se reanudan.
- Reactivaciones: nuevas suscripciones desde Play Store y dentro de la app tras la caducidad.
Las fórmulas generales están en cómo calcular la tasa de churn.
Errores frecuentes
- Fiarse solo del tipo de notificación. Obtén siempre el estado de la suscripción.
- Contar las cancelaciones como churn. Infla el churn y oculta las restauraciones.
- Ignorar los tokens de compra vinculados. Los cambios de plan se convierten en churn falso.
- Llamar a la API demasiado tarde. Los tokens dejan de funcionar 60 días después de la caducidad.
- No confirmar los mensajes de Pub/Sub. Recibes duplicados y malgastas cuota de API.
- Sin ID de cuenta ofuscado en la compra. No puedes cruzar los datos de Play con tus propios datos de usuario.
Hacerlo con NoChurn
Apuntas tus notificaciones de desarrollador en tiempo real de Play a NoChurn y le das una cuenta de servicio con acceso a tu Play Console. NoChurn obtiene el estado de la suscripción en cada evento, sigue los tokens de compra vinculados, separa el churn voluntario, el de facturación y el revocado, y mantiene una cronología por cliente, asociada mediante el ID de cuenta ofuscado que fijas en la compra. El periodo de gracia, la suspensión de la cuenta y las cancelaciones alimentan la puntuación de churn de 0 a 100, y puedes añadir tus propios atributos por API. Google conserva los pagos, los reintentos y el botón de cancelar. Consulta NoChurn + Google Play.