Retention Messaging API: missatge abans de la baixa

La Retention Messaging API és un servei d'Apple, de servidor a servidor, que mostra el teu missatge a un subscriptor en el moment que toca Cancel Subscription. El missatge apareix en una pàgina de confirmació, abans que la cancel·lació es validi. Pot recordar el valor de la teva subscripció, proposar un altre pla o una oferta promocional, però el botó per cancel·lar sempre hi és. L'API és en versió preliminar des del juliol del 2025, amb sol·licitud d'accés, i Apple ha anunciat una versió més senzilla a App Store Connect per a la tardor del 2026.

Aquesta guia explica què mostra l'API, des de quan existeix, qui la pot fer servir, les seves condicions i com configurar-la. Tot surt de la documentació d'Apple i de la sessió de la WWDC26 que hi està dedicada, rellegides el 3 de novembre del 2026.

Venc subscripcions a les meves apps iOS: Solys, un bloquejador de xarxes socials, TradaZen, un simulador de trading, Nolera, una app per emprovar-se roba amb IA, i Vigie. Vaig demanar l'accés a l'API per a les quatre el 25 d'octubre del 2026, i vaig preparar els missatges en tots els seus idiomes. El 28 d'octubre, l'aprovació d'Apple encara no havia arribat: aquesta guia descriu, doncs, la norma i la meva preparació, encara no resultats.

Què fa la Retention Messaging API

Segons la documentació d'Apple, l'API et deixa triar el missatge que el sistema mostra quan un client consulta la pàgina de detall d'una subscripció i potser està a punt de cancel·lar-la. Prepares els missatges per endavant, per a cada producte i cada idioma.

El recorregut sempre és el mateix:

1. El subscriptor obre la seva subscripció, per exemple a Apple Account, Subscriptions, o des de l'App Store.
2. Toca Cancel Subscription.
3. El sistema mostra una pàgina de confirmació (Confirm Cancellation), amb el teu missatge.
4. Pot cancel·lar igualment, mantenir la subscripció o acceptar el que proposa el teu missatge.

El missatge es veu a iOS 15.1 i iPadOS 15.1 o posterior, a visionOS 1 i a macOS 14 o posterior.

Des de quan, i per a qui

Data	Què canvia, segons Apple
16 jul. 2025	Versió 1.0: primera versió preliminar de l'API
9 des. 2025	Prova de rendiment del servidor per al temps real
31 març 2026	Pics als missatges, configuració de l'adreça en temps real per l'API
27 abr. 2026	Compatibilitat amb subscripcions mensuals amb compromís de 12 mesos
Juny 2026	WWDC26: anunci d'un mòdul a App Store Connect

Les dates surten del registre de versions de l'API, excepte l'última, treta de la sessió de la WWDC26. L'API continua sent una versió preliminar: la documentació remet a un formulari de sol·licitud d'accés, que demana iniciar sessió amb el teu compte de desenvolupador.

A la WWDC26, la sessió Explore Retention Messaging in App Store Connect presenta un mòdul configurable sense codi, a App Store Connect. Apple diu que és «obert a tothom». La versió en temps real, en canvi, continua sent amb sol·licitud. La pàgina de novetats de l'App Store anuncia el mòdul per a «aquesta tardor». A 3 de novembre del 2026, l'ajuda d'App Store Connect encara no li dedica cap pàgina, i el mòdul no apareixia al meu compte el 28 d'octubre.

L'API afecta les apps que venen una subscripció amb renovació automàtica. No és només per a grans editors: RevenueCat apunta al seu estudi de 22 milions de missatges que les apps petites també poden demanar l'accès.

Els 4 tipus de missatges

Tipus	Què veu el subscriptor	Missatge per defecte	Temps real
Text	Un títol, un text, fins a cinc pics	Sí	Sí
Text amb imatge	El mateix, amb una imatge	Sí	Sí
Canvi de pla	Un text i una altra subscripció del mateix grup	No	Sí
Oferta promocional	Un text i una oferta per continuar a preu reduït	No	Sí

Segons la pàgina sobre la preparació dels missatges, un missatge per defecte només pot ser un text, amb imatge o sense. Amb l'API, proposar una oferta o un altre pla requereix respondre en temps real. El mòdul anunciat a App Store Connect, en canvi, permetrà un missatge amb una oferta, sense servidor.

L'oferta promocional és la que crees a App Store Connect. Segons l'ajuda sobre les ofertes promocionals, s'adreça als subscriptors actuals i antics. En un missatge de retenció, és el teu servidor qui la signa, segons la pàgina sobre la preparació dels missatges. El canvi de pla proposa una subscripció del mateix grup. Si comences amb aquestes ofertes, llegeix primer la meva guia sobre els codis d'oferta i les ofertes promocionals.

Què pots mostrar: els límits exactes

Element	Límit d'Apple
Títol	66 caràcters com a màxim
Text	144 caràcters com a màxim
Pics	5 com a màxim
Imatge d'amplada completa	PNG sense transparència, 3.840 px d'ample, de 160 a 2.160 d'alt
Imatge de pic	1.024 × 1.024 px
Imatges per app	2.000 com a màxim

Les longituds surten de la descripció del cos de la sol·licitud d'enviament d'un missatge, i els formats, de la pàgina sobre l'enviament d'una imatge. Apple també demana imatges que funcionin igual de bé en mode clar que en mode fosc.

Apple revisa cada missatge i cada imatge. El seu estat passa de PENDING a APPROVED, i el sistema només mostra el que està aprovat. A la sandbox, l'aprovació és automàtica. La documentació estableix una norma de contingut clara: no enviar res enganyós ni inexacte.

Les condicions que cal complir

• Un missatge per defecte per a cada producte, en cada idioma. Sense ell, no es mostra res en aquell idioma. També és la roda de recanvi si el teu servidor no respon.
• Missatges i imatges aprovats abans de qualsevol posada en marxa.
• Per al temps real, un servidor ràpid. La pàgina sobre la configuració de l'adreça en temps real demana un certificat SSL vàlid, TLS 1.2 i una resposta en menys de 700 ms en producció. Si triga més, la sol·licitud falla i es mostra el missatge per defecte.
• Una prova de rendiment superada a la sandbox, abans de declarar la teva adreça de producció.
• Una verificació de l'app. Cada sol·licitud d'Apple conté l'identificador de l'app, appAppleId. Si no coincideix amb el teu, Apple demana que no responguis.

La sol·licitud en temps real et dona l'identificador de la transacció original, el producte i l'idioma del dispositiu. Tu tries el missatge, segons les teves regles.

Configurar la Retention Messaging: tres camins

Camí	Per a qui	Què cal
Mòdul App Store Connect	Tothom, un cop surti	Cap codi; text, imatge o oferta
API, amb el teu servidor	Qui té un backend	Accés d'Apple, adreça HTTPS, prova de rendiment
API, amb RevenueCat	Les apps que ja fan servir RevenueCat	Accés d'Apple, configuració al tauler

Quan conviuen diverses configuracions, Apple explica a la sessió de la WWDC26 l'ordre que segueix: primer la resposta en temps real. Si falta o està mal formada, la configuració d'App Store Connect. Si no existeix, el missatge per defecte configurat per l'API.

Amb el teu propi servidor

1. Demana l'accés amb el formulari d'Apple.
2. Envia les imatges i després els missatges, amb un títol i un text per a cadascun.
3. Espera que s'aprovin i després declara un missatge per defecte per a cada subscripció i cada idioma.
4. Per al temps real, crea l'adreça Get Retention Message al teu servidor i declara-la a la sandbox.
5. Llança la prova de rendiment, a la sandbox, amb una transacció de prova.
6. Un cop superada la prova, declara la teva adreça de producció.

Amb RevenueCat

És el camí que vaig triar: cap servidor per programar, i les meves apps ja passen per RevenueCat, com explico a RevenueCat i la subscripció in-app a iOS. Segons la documentació de RevenueCat:

1. Al formulari d'Apple, l'adreça que has de donar és la que RevenueCat mostra a la configuració de la teva app App Store.
2. Després de l'aprovació, obre Lifecycle, després Retention, i connecta l'adreça de sandbox.
3. Llança la prova de rendiment amb una subscripció de sandbox o de TestFlight activa. Pot durar fins a una hora.
4. Crea primer un missatge per defecte, idioma per idioma.
5. Afegeix després missatges en temps real, amb regles. Una d'elles, «Is in free trial», s'adreça a les persones en prova gratuïta.
6. Passa a producció: la configuració de sandbox no es conserva, cal tornar a crear els missatges.

Escriure un missatge que retingui sense enganyar

El text és fix i Apple el revisa abans de mostrar-lo. Per tant, no pot parlar de la persona que el llegeix, ni del dia que el llegeix. Aquest és el missatge per defecte que vaig preparar per a TradaZen, en francès; aquí el tens adaptat al català:

Títol (52 caràcters):
Volies aprendre a fer trading i ara tornes a cegues?

Text (132 caràcters):
Sense entrenament, els teus diners reals paguen cada error. Aquí no costen res. La teva ratxa, la teva lliga i les lliçons s'aturen.

Les regles que em vaig marcar per a les quatre apps:

• El títol recorda a la persona el seu objectiu, en forma de pregunta. No la fa sentir avergonyida.
• El text diu què s'atura, exactament. Escric que l'accés «es bloqueja» quan les dades es conserven, mai que «s'esborraran».
• Cap paraula de temps com «demà» o «avui»: el mateix text es mostra en qualsevol moment del període.
• Cap promesa de guanys, cap urgència falsa. Un primer títol que prometia canviar de vida gràcies al trading el vaig descartar abans d'enviar-lo. La guideline 5.6 prohibeix qualsevol pràctica manipuladora, i el paywall de TradaZen ja va ser rebutjat per aquest motiu, com explico a la guideline 5.6 i el paywall.
• Cada idioma té el seu text, amb el vocabulari de l'app traduïda, i comptat caràcter a caràcter.

Per a TradaZen, també preveig un missatge en temps real per a les persones en prova amb la subscripció anual. Proposarà un pla anual més barat del mateix grup, perquè les meves xifres mostren que aquestes persones fan servir l'app tant com les que paguen: el que rebutgen és el preu. Aquesta configuració espera l'aprovació d'Apple.

Què en pots esperar

No comptis amb un miracle. Apple anomena taxa de recuperació la proporció de subscriptors que mantenen la subscripció un cop arriben a la pàgina de confirmació. A la sessió de la WWDC26, Apple anuncia que les subscripcions que han adoptat la Retention Messaging guanyen de mitjana 1,4 punts d'aquesta taxa. Els missatges amb una oferta promocional obtenen el millor guany observat, 5,5 punts, i els resultats varien d'un desenvolupador a un altre. Per la seva banda, l'estudi de RevenueCat constata que els subscriptors només accepten al voltant de l'1,1 % de les ofertes promocionals i el 0,6 % dels canvis de pla.

El missatge, doncs, no substitueix la feina prèvia. Una prova gratuïta que es cancel·la al cap d'un minut es juga al paywall i a les primeres sessions: les causes i les palanques són a la meva guia sobre la prova gratuïta cancel·lada, i la creació de la prova, a l'oferta introductòria.

Preparar la subscripció abans del missatge

L'iOS & Android Kit parteix del codi base de les meves apps: l'onboarding, el paywall i les subscripcions ja estan programats, i el recorregut en quatre etapes et porta fins a l'App Store, al teu ritme. Tota la cadena, des dels productes a App Store Connect fins al paywall, està descrita a la pàgina subscripció in-app a iOS.

Si prepares el teu primer llançament, fes el teu diagnòstic gratuït: et diu què bloqueja de debò el teu projecte i t'envia la meva checklist antirebuig d'Apple.

Preguntes freqüents

Què és la Retention Messaging API d'Apple?

És un servei de servidor a servidor que tria el missatge que es mostra a un subscriptor quan toca Cancel Subscription. El missatge es mostra en una pàgina de confirmació, abans de la cancel·lació. Pot recordar el valor de la subscripció, proposar un altre pla o una oferta promocional.

La Retention Messaging està disponible per a tots els desenvolupadors?

L'API és una versió preliminar, amb sol·licitud d'accés a Apple. A la WWDC26, Apple va anunciar un mòdul a App Store Connect, obert a tothom, previst per a la tardor del 2026. A 3 de novembre del 2026, l'ajuda d'App Store Connect encara no el descriu.

En quines versions d'iOS es mostra el missatge?

A iOS 15.1 i iPadOS 15.1 o posterior, a visionOS 1 i a macOS 14 o posterior. En un dispositiu més antic, la cancel·lació es fa sense missatge.

El missatge impedeix que el subscriptor cancel·li?

No. La pàgina de confirmació manté un botó per cancel·lar. El subscriptor també pot mantenir la subscripció, o acceptar l'oferta o el pla proposat.

Es pot oferir un descompte en el moment de la cancel·lació?

Sí. Amb l'API, és un missatge d'oferta promocional, només en temps real: l'oferta es crea a App Store Connect i la signa el teu servidor. El mòdul anunciat a App Store Connect també permet un missatge amb una oferta. El canvi de pla, en canvi, proposa una altra subscripció del mateix grup.

Quants caràcters té un missatge de retenció?

El títol té 66 caràcters com a màxim, i el text, 144. Pots afegir fins a cinc pics i una imatge PNG sense transparència. Cada idioma necessita el seu propi missatge per defecte.

Cal un servidor per fer servir la Retention Messaging?

No cal allotjar cap adreça per als missatges per defecte: n'hi ha prou de cridar l'API per enviar-los i declarar-los. Amb RevenueCat, és RevenueCat qui fa de servidor. El temps real requereix una adreça HTTPS que respongui en menys de 700 ms. El mòdul anunciat a App Store Connect es configura sense codi.