MÉTRICAS DE CHURNGOOGLE PLAY

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.

Publicado el 7 min de lectura

Seguir el churn con las notificaciones de desarrollador en tiempo real de Google Play

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:

  1. Crea un tema de Pub/Sub en un proyecto de Google Cloud.
  2. Da a la cuenta de servicio google-play-developer-notifications@system.gserviceaccount.com el rol Pub/Sub Publisher en el tema.
  3. Crea una suscripción al tema: push hacia un endpoint HTTPS de tu backend, o pull desde un worker.
  4. En Play Console, introduce el nombre del tema para tu app y haz clic en Send Test Message.
  5. 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:

  1. Recibir, comprobar duplicados por messageId (Google lo recomienda), guardar el mensaje original, confirmar.
  2. Llamar a purchases.subscriptionsv2.get con el token de compra.
  3. Guardar el estado resultante como una instantánea con el tipo de notificación y eventTimeMillis.
  4. 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

  1. Activas al inicio: suscripciones en estado activo, en periodo de gracia o canceladas pero no caducadas.
  2. Churn voluntario: caducidades cuyo contexto es iniciado por el usuario.
  3. Churn involuntario: caducidades cuyo contexto es iniciado por el sistema.
  4. 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.
  5. Restauraciones: SUBSCRIPTION_RESTARTED.
  6. En pausa: número, y cuántas se reanudan.
  7. 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.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Deja de perder ingresos.

  • Gratis hasta 300 € de MRR
  • Sin tarjeta
  • Listo en 10 minutos
  • Sin comisión