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.

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:
- 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.
- 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.
- Si tu firewall usa una lista de permitidos, añade
17.0.0.0/8, que cubre sandbox y producción. - Devuelve un HTTP de 200 a 206 cuando hayas guardado la notificación. Cualquier otro código cuenta como fallo.
- 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, incluidosautoRenewStatus,expirationIntent,isInBillingRetryPeriod,gracePeriodExpiresDateyeligibleWinBackOfferIds.status: el estado de la suscripción a fecha designedDate:1activa,2caducada,3en billing retry,4en Billing Grace Period,5revocada.
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_DISABLEDcomo indicador adelantado: suscripciones en riesgo en este periodo. - Usa
EXPIREDcomo 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:
- 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).
- Perdidas: notificaciones
EXPIREDdel mes, divididas por subtipo. - Tasa de churn voluntario:
EXPIRED/VOLUNTARYdividido entre las activas a principio de mes. - Tasa de churn involuntario:
EXPIRED/BILLING_RETRYdividido entre las activas a principio de mes. - Recuperación de cobros:
DID_RENEW/BILLING_RECOVERYdividido entreDID_FAIL_TO_RENEWsobre la misma cohorte. - En riesgo ahora: suscripciones cuya última información de renovación tiene la renovación automática desactivada y una caducidad futura.
- 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.
SUBSCRIBEDyREVOKEtambié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
REFUNDtermina 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.