MÉTRICAS DE CHURNAPP STORE

Medir el churn con las App Store Server Notifications V2

Medir el churn de suscripciones iOS con las App Store Server Notifications V2: configuración, qué significa cada notificación y churn voluntario o de pago.

Publicado el 6 min de lectura

Medir el churn con las App Store Server Notifications V2

App Store Connect te da informes de ventas y de suscripciones, pero si quieres cifras de churn en las que puedas confiar y sobre las que puedas actuar (quién se fue, por qué y quién está a punto de irse), necesitas tu propio registro de eventos. En iOS, ese registro viene de las App Store Server Notifications V2: el servidor de Apple llama al tuyo cada vez que una suscripción cambia de estado.

Esta guía muestra cómo configurarlas de forma fiable, cómo se traduce cada notificación en una métrica de churn y cómo cubrir los huecos. Se basa en la documentación de Apple: Enabling App Store Server Notifications, Responding to App Store Server Notifications, la referencia de notificationType y Get Notification History (todo consultado en noviembre de 2026).

Configurar el endpoint

Los requisitos de Apple son breves:

  1. Una URL HTTPS en tu servidor, con TLS 1.2 o posterior. Si indicas un puerto, debe ser el 443 o del 1024 en adelante.
  2. Elige la versión 2 para la URL en App Store Connect. Apple recomienda V2 para todas las implementaciones nuevas. Puedes definir una URL distinta para sandbox o reutilizar la misma.
  3. Si tu firewall usa una lista de permitidos, añade 17.0.0.0/8, que cubre sandbox y producción.
  4. Devuelve un HTTP de 200 a 206 cuando hayas guardado la notificación. Cualquier otro código cuenta como fallo.
  5. Prueba con el endpoint Request a Test Notification, que envía una notificación TEST, y después comprueba el resultado con Get Test Notification Status.

Cada notificación llega como un signedPayload en formato JWS. Verifica la firma antes de fiarte de nada de lo que contiene y después decodifica el payload.

Entrega, reintentos y duplicados

Las cosas fallan: despliegues, caídas, timeouts. La documentación de Apple describe lo que pasa entonces.

  • Reintentos. En V2, si tu servidor no devuelve un código de éxito, Apple reintenta cinco veces, a las 1, 12, 24, 48 y 72 horas del intento anterior. Los reintentos solo ocurren en producción; en sandbox Apple envía cada notificación una sola vez.
  • Duplicados. Cada payload tiene un notificationUUID, que Apple dice que uses para identificar los duplicados. Guárdalo con una restricción única e ignora las repeticiones.
  • Historial. Get Notification History devuelve las notificaciones que Apple intentó enviar en los últimos 180 días en producción (30 días en sandbox), 20 registros por página, con filtro opcional por tipo, subtipo o transacción. Ejecútalo después de cualquier caída.
  • La verdad actual. Los registros del historial reflejan el estado en el momento del envío. Para el estado actual de una suscripción, Apple remite a Get All Subscription Statuses.

Un buen patrón: guarda primero la notificación en bruto, devuelve 200 y después procésala desde una cola. Nunca hagas trabajo lento antes de responder a Apple.

Qué contiene una notificación

El payload decodificado tiene un notificationType, un subtype opcional, un signedDate y un objeto data. Para las suscripciones, data contiene:

  • signedTransactionInfo: la transacción (producto, fechas, oferta usada, revocación si la hay).
  • signedRenewalInfo: lo que pasará en la próxima renovación, incluidos autoRenewStatus, expirationIntent, isInBillingRetryPeriod, gracePeriodExpiresDate y eligibleWinBackOfferIds.
  • status: el estado de la suscripción a fecha de signedDate: 1 activa, 2 caducada, 3 en billing retry, 4 en Billing Grace Period, 5 revocada.

Para vincular una suscripción a uno de tus usuarios, fija un appAccountToken en la compra. Apple lo devuelve en la información de transacción y de renovación. Sin él, solo tienes los IDs de transacción de Apple.

Traducir las notificaciones en métricas de churn

Así se traducen los tipos de notificación de Apple en las cifras que siguen la mayoría de los equipos. Las descripciones siguen la tabla de notificationType de Apple.

Métrica Notificación Subtipo
Nuevo suscriptor SUBSCRIBED INITIAL_BUY
Suscriptor que vuelve (incluidas las ofertas de win-back) SUBSCRIBED RESUBSCRIBE
Renovación DID_RENEW ninguno
Intención de cancelar (renovación desactivada) DID_CHANGE_RENEWAL_STATUS AUTO_RENEW_DISABLED
Cancelación revertida DID_CHANGE_RENEWAL_STATUS AUTO_RENEW_ENABLED
Fallo de cobro DID_FAIL_TO_RENEW GRACE_PERIOD o ninguno
Cobro recuperado DID_RENEW BILLING_RECOVERY
Churn voluntario EXPIRED VOLUNTARY
Churn involuntario (de pago) EXPIRED BILLING_RETRY
Churn por subida de precio EXPIRED PRICE_INCREASE
Producto retirado de la venta EXPIRED PRODUCT_NOT_FOR_SALE
Reembolso REFUND ninguno, o SEATS para multiasiento
Downgrade programado DID_CHANGE_RENEWAL_PREF DOWNGRADE

El expirationIntent de la información de renovación da la misma división en forma de número: 1 el cliente canceló, 2 error de cobro, 3 sin consentimiento a una subida de precio o a la conversión de una oferta, 4 producto no disponible, 5 otro (referencia).

Cuenta el churn en la caducidad, no en la cancelación

En el App Store, una cancelación solo detiene la renovación. El cliente conserva el acceso hasta que termina el periodo y puede volver a activar la renovación. Así que:

  • Usa AUTO_RENEW_DISABLED como indicador adelantado: suscripciones en riesgo en este periodo.
  • Usa EXPIRED como evento de churn: suscripciones que realmente terminaron.

Si cuentas el churn con AUTO_RENEW_DISABLED, lo sobrestimarás y te perderás a todos los clientes que cambiaron de opinión.

El churn de pago tiene una cola larga

La referencia de Apple dice que tras una renovación fallida, el App Store sigue reintentando el cobro durante 60 días, o hasta que el cliente arregla su facturación o cancela. Con el Billing Grace Period activado, el cliente conserva el acceso durante el periodo de gracia; GRACE_PERIOD_EXPIRED marca su final mientras los reintentos continúan. Una suscripción en billing retry no está ni activa ni perdida todavía. Repórtala en su propio grupo y cuéntala como churn solo cuando llegue EXPIRED con BILLING_RETRY.

Fíjate también en recentSubscriptionStartDate en la información de renovación: Apple lo calcula ignorando las interrupciones de 60 días o menos, lo que es práctico para la antigüedad y las cohortes.

Un informe de churn sencillo a partir de las notificaciones

Con todas las notificaciones guardadas, un informe mensual son unas pocas consultas:

  1. Activas a principio de mes: suscripciones cuyo último estado antes del mes era activa, en periodo de gracia o en billing retry (decide una vez si el retry cuenta como activa y mantenlo).
  2. Perdidas: notificaciones EXPIRED del mes, divididas por subtipo.
  3. Tasa de churn voluntario: EXPIRED/VOLUNTARY dividido entre las activas a principio de mes.
  4. Tasa de churn involuntario: EXPIRED/BILLING_RETRY dividido entre las activas a principio de mes.
  5. Recuperación de cobros: DID_RENEW/BILLING_RECOVERY dividido entre DID_FAIL_TO_RENEW sobre la misma cohorte.
  6. En riesgo ahora: suscripciones cuya última información de renovación tiene la renovación automática desactivada y una caducidad futura.
  7. Reactivaciones: SUBSCRIBED/RESUBSCRIBE.

Para las fórmulas generales y las trampas (mezclar planes mensuales y anuales, contar las pruebas), consulta cómo calcular la tasa de churn.

Huecos habituales

  • Escuchar solo V1, o solo producción. Prueba V2 en sandbox antes de cambiar producción; Apple recomienda exactamente ese orden.
  • Ningún job de conciliación. Incluso con reintentos, ejecuta Get Notification History periódicamente y después de los incidentes.
  • Ignorar En Familia y los grupos. SUBSCRIBED y REVOKE también se disparan para los miembros de la familia y los asientos de grupo. Decide si cuentan como suscriptores en tus métricas.
  • Tratar los reembolsos como cancelaciones. Un REFUND termina el acceso y devuelve el dinero; repórtalo aparte.
  • Sin appAccountToken. Tienes cifras limpias del App Store, pero no puedes cruzarlas con datos de uso, de plan o de adquisición, que es de donde salen las explicaciones del churn.

Hacerlo con NoChurn

NoChurn te da una URL para pegar como endpoint de tus App Store Server Notifications. Verifica y deduplica cada notificación, mantiene la cronología por cliente (asociada mediante tu appAccountToken), separa el churn voluntario, el de pago y el de subida de precio, y marca la renovación automática desactivada como señal de riesgo temprana en el churn score de 0 a 100. Puedes añadir tus propios atributos por API para ver qué impulsa el churn. Apple se queda con la facturación, los reintentos y el botón de cancelar. Consulta NoChurn + App Store.

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