Retention Messaging API: üzenet a lemondás előtt

A Retention Messaging API az Apple szerverek közötti szolgáltatása. Akkor jeleníti meg az üzenetedet egy előfizetőnek, amikor a Cancel Subscription gombra koppint. Az üzenet egy megerősítő oldalon jelenik meg, még mielőtt a lemondás érvényes lenne. Emlékeztethet az előfizetésed értékére, ajánlhat másik csomagot vagy promóciós ajánlatot, de a lemondás gombja mindig ott marad. Az API 2025 júliusa óta előzetes verzióban érhető el, hozzáférési kérelemmel, és az Apple 2026 őszére egy egyszerűbb változatot jelentett be az App Store Connectben.

Ez az útmutató elmagyarázza, mit jelenít meg az API, mióta létezik, ki használhatja, milyen feltételei vannak, és hogyan állítod be. Minden az Apple dokumentációjából és a neki szentelt WWDC26-előadásból származik, amelyeket 2026. november 3-án néztem át újra.

Az iOS-appjaimban előfizetéseket árulok: Solys (közösségimédia-blokkoló), TradaZen (kereskedési szimulátor), Nolera (MI-alapú ruhapróba-app) és Vigie. 2026. október 25-én mind a négyhez hozzáférést kértem az API-hoz, és minden nyelvükön elkészítettem az üzeneteiket. Október 28-án az Apple jóváhagyása még nem érkezett meg, ezért ez az útmutató a szabályokat és a felkészülésemet írja le, eredményeket még nem.

Mit csinál a Retention Messaging API

Az Apple dokumentációja szerint az API-val te választod ki, milyen üzenetet jelenítsen meg a rendszer, amikor egy ügyfél megnyitja egy előfizetés részletes oldalát, és talán épp lemondani készül. Az üzeneteidet előre készíted el, minden termékhez és minden nyelvhez.

A folyamat mindig ugyanaz:

1. Az előfizető megnyitja az előfizetését, például az Apple Account, Subscriptions menüben vagy az App Store-ból.
2. A Cancel Subscription gombra koppint.
3. A rendszer megjelenít egy megerősítő oldalt (Confirm Cancellation) az üzeneteddel.
4. Ekkor is lemondhat, megtarthatja az előfizetését, vagy elfogadhatja, amit az üzeneted ajánl.

Az üzenet iOS 15.1 és iPadOS 15.1 vagy újabb, visionOS 1, illetve macOS 14 vagy újabb rendszeren látható.

Mióta és kinek

Dátum	Mi változik az Apple szerint
2025. júl. 16.	1.0-s verzió: az API első előzetes verziója
2025. dec. 9.	Szerverteljesítmény-teszt a valós idejű működéshez
2026. márc. 31.	Felsorolásjelek az üzenetekben, a valós idejű cím beállítása API-val
2026. ápr. 27.	12 hónapos elköteleződésű havi előfizetések támogatása
2026. június	WWDC26: egy App Store Connect-modul bejelentése

A dátumok az API változásnaplójából származnak, kivéve az utolsót, amely a WWDC26-előadásból való. Az API továbbra is előzetes verzió: a dokumentáció egy hozzáférési kérelem űrlapra mutat, amelyhez be kell jelentkezned a fejlesztői fiókodba.

A WWDC26-on az Explore Retention Messaging in App Store Connect előadás egy kód nélkül beállítható modult mutat be az App Store Connectben. Az Apple szerint ez „mindenki számára nyitott”. A valós idejű változat viszont továbbra is kérelemhez kötött. Az App Store újdonságai oldal „idén ősszel” ígéri a modult. 2026. november 3-án az App Store Connect súgójában még egyetlen oldal sem szól róla, és október 28-án a fiókomban sem jelent meg a modul.

Az API azokat az appokat érinti, amelyek automatikusan megújuló előfizetést árulnak. Nem csak a nagy kiadóknak szól: a RevenueCat a 22 millió üzenetet vizsgáló tanulmányában megjegyzi, hogy a kis appok is kérhetnek hozzáférést.

A 4 üzenettípus

Típus	Mit lát az előfizető	Alapértelmezett üzenet	Valós idejű
Szöveg	Egy cím, egy szöveg, legfeljebb öt felsorolásponttal	Igen	Igen
Szöveg képpel	Ugyanez, egy képpel	Igen	Igen
Csomagváltás	Egy szöveg és egy másik előfizetés ugyanabból a csoportból	Nem	Igen
Promóciós ajánlat	Egy szöveg és egy ajánlat, hogy kedvezményesen folytassa	Nem	Igen

Az üzenetek előkészítéséről szóló oldal szerint az alapértelmezett üzenet csak szöveg lehet, képpel vagy anélkül. Az API-val ajánlatot vagy másik csomagot csak valós idejű válasszal kínálhatsz. Az App Store Connectbe bejelentett modul viszont szerver nélkül is kínál majd ajánlatos üzenetet.

A promóciós ajánlat az, amit az App Store Connectben hozol létre. A promóciós ajánlatokról szóló súgó szerint a jelenlegi és korábbi előfizetőknek szól. Megtartó üzenetben a szervered írja alá, az üzenetek előkészítéséről szóló oldal szerint. A csomagváltás ugyanabból a csoportból ajánl egy előfizetést. Ha még új vagy ezekben az ajánlatokban, előbb olvasd el az útmutatómat az ajánlatkódokról és promóciós ajánlatokról.

Mit jeleníthetsz meg: a pontos korlátok

Elem	Az Apple korlátja
Cím	Legfeljebb 66 karakter
Szöveg	Legfeljebb 144 karakter
Felsorolásjelek	Legfeljebb 5
Teljes szélességű kép	Átlátszóság nélküli PNG, 3 840 px széles, 160-2 160 px magas
Felsorolásjel képe	1 024 × 1 024 px
Képek appanként	Legfeljebb 2 000

A hosszak az üzenetküldési kérés törzsének leírásából, a formátumok a képfeltöltésről szóló oldalról származnak. Az Apple azt is kéri, hogy a képek világos és sötét módban egyaránt jól működjenek.

Minden üzenetet és képet az Apple átnéz. Az állapotuk PENDING-ről APPROVED-ra vált, és a rendszer csak a jóváhagyottat jeleníti meg. Sandboxban a jóváhagyás automatikus. A dokumentáció egyértelmű tartalmi szabályt szab: semmi félrevezetőt vagy pontatlant ne küldj.

A teljesítendő feltételek

• Minden termékhez, minden nyelven egy alapértelmezett üzenet. Enélkül azon a nyelven semmi sem jelenik meg. Ez a tartalék is arra az esetre, ha a szervered nem válaszol.
• Jóváhagyott üzenetek és képek minden élesítés előtt.
• Valós idejű működéshez gyors szerver. A valós idejű cím beállításáról szóló oldal érvényes SSL-tanúsítványt, TLS 1.2-t és éles környezetben 700 ms alatti választ kér. Ezen felül a kérés meghiúsul, és az alapértelmezett üzenet jelenik meg.
• Sikeres teljesítményteszt sandboxban, mielőtt megadod az éles címedet.
• Az app ellenőrzése. Az Apple minden kérése tartalmazza az app azonosítóját, az appAppleId-t. Ha nem egyezik a tiéddel, az Apple azt kéri, ne válaszolj.

A valós idejű kérés megadja az eredeti tranzakció azonosítóját, a terméket és az eszköz nyelvét. Te döntöd el a saját szabályaid szerint, melyik üzenetet adod.

A Retention Messaging beállítása: három út

Út	Kinek	Mi kell hozzá
App Store Connect-modul	Mindenkinek, ha megjelent	Semmi kód; szöveg, kép vagy ajánlat
API, saját szerverrel	Akinek van back-endje	Apple-hozzáférés, HTTPS-cím, teljesítményteszt
API, RevenueCaten át	A már RevenueCatet használó appoknak	Apple-hozzáférés, beállítások az irányítópulton

Ha több beállítás is létezik egyszerre, az Apple a WWDC26-előadásban elmagyarázza a sorrendet: először a valós idejű válasz. Ha hiányzik vagy hibás, az App Store Connect beállítása. Ha az nem létezik, az API-n beállított alapértelmezett üzenet.

Saját szerverrel

1. Kérj hozzáférést az Apple űrlapján.
2. Töltsd fel a képeidet, majd az üzeneteidet, mindegyikhez címmel és szöveggel.
3. Várd meg a jóváhagyásukat, aztán adj meg egy alapértelmezett üzenetet minden előfizetéshez és minden nyelvhez.
4. Valós idejű működéshez hozd létre a Get Retention Message címet a szervereden, és add meg sandboxban.
5. Indítsd el a teljesítménytesztet sandboxban, egy teszttranzakcióval.
6. Ha a teszt sikerült, add meg az éles címedet.

RevenueCattel

Ezt az utat választottam: nem kell szervert írni, és az appjaim már amúgy is RevenueCatet használnak, ahogy a RevenueCat és az iOS-es in-app előfizetés cikkben elmagyarázom. A RevenueCat dokumentációja szerint:

1. Az Apple űrlapján azt a címet kell megadnod, amelyet a RevenueCat az App Store-appod beállításaiban mutat.
2. A jóváhagyás után nyisd meg a Lifecycle, majd a Retention menüt, és kösd be a sandbox-címet.
3. Indítsd el a teljesítménytesztet egy aktív sandbox- vagy TestFlight-előfizetéssel. Akár egy óráig is tarthat.
4. Először hozz létre egy alapértelmezett üzenetet, nyelvenként.
5. Utána adj hozzá valós idejű üzeneteket, szabályokkal. Az egyik, az „Is in free trial”, az ingyenes próbaidőszakban lévőket célozza.
6. Válts élesre: a sandbox-beállítások nem kerülnek át, az üzeneteket újra létre kell hozni.

Olyan üzenet, ami megtart, de nem csapdába ejt

A szöveg rögzített, és az Apple megjelenítés előtt átnézi. Így nem szólhat arról, aki olvassa, sem arról, melyik napon olvassa. Ezt az alapértelmezett üzenetet készítettem a TradaZenhez, magyarul:

Cím (52 karakter):
Kereskedni akartál tanulni, és most vakon folytatod?

Szöveg (125 karakter):
Gyakorlás nélkül minden hibát a valódi pénzed fizet meg. Itt semmibe sem kerülnek. A sorozatod, a ligád és a leckéid leállnak.

A szabályok, amelyeket mind a négy appomhoz felállítottam:

• A cím a célja felé tereli a felhasználót, kérdés formájában. Nem szégyeníti meg.
• A szöveg pontosan megmondja, mi áll le. Azt írom, hogy a hozzáférés „zárolódik”, amikor az adatok megmaradnak, sosem azt, hogy „törlődnek”.
• Semmi időre utaló szó, mint a „holnap” vagy a „ma”: ugyanaz a szöveg az időszak bármely pontján megjelenik.
• Semmilyen nyereségígéret, semmi hamis sürgetés. Egy első címet, amely azt ígérte, hogy a kereskedés megváltoztatja az életed, még a feltöltés előtt kidobtam. Az 5.6-os irányelv tilt minden manipulatív gyakorlatot, és a TradaZen paywallját már elutasították emiatt, ahogy az 5.6-os irányelvről és a paywallról szóló cikkben elmesélem.
• Minden nyelvnek saját szövege van, a lefordított app szókincsével, karakterre pontosan megszámolva.

A TradaZenhez egy valós idejű üzenetet is tervezek azoknak, akik az éves előfizetés próbaidőszakában vannak. Egy olcsóbb éves csomagot ajánl majd ugyanabból a csoportból, mert a számaim szerint ezek az emberek ugyanannyit használják az appot, mint a fizetők: az árat utasítják el. Ez a beállítás az Apple jóváhagyására vár.

Mire számíthatsz

Ne várj csodát. Az Apple mentési aránynak hívja azon előfizetők arányát, akik a megerősítő oldalra érve megtartják az előfizetésüket. A WWDC26-előadásban az Apple azt közli, hogy a Retention Messaginget bevezető előfizetések átlagosan 1,4 százalékpontot javítanak ezen az arányon. A promóciós ajánlatos üzenetek hozzák a legnagyobb megfigyelt javulást, 5,5 pontot, és az eredmények fejlesztőnként eltérnek. A RevenueCat tanulmánya pedig azt találta, hogy az előfizetők a promóciós ajánlatoknak csak körülbelül 1,1%-át, a csomagváltásoknak pedig 0,6%-át fogadják el.

Az üzenet tehát nem helyettesíti a korábbi munkát. Az egy percen belül lemondott ingyenes próbaidőszak a paywallon és az első munkameneteken dől el: az okokat és a megoldásokat a lemondott ingyenes próbaidőszakról szóló útmutatómban találod, a próbaidőszak létrehozását pedig a bevezető ajánlatról szólóban.

Készítsd elő az előfizetésedet az üzenet előtt

Az iOS & Android Kit az appjaim kezdőkódjára épül: az onboarding, a paywall és az előfizetések már le vannak kódolva, a négylépéses út pedig a saját tempódban elvezet az App Store-ig. A teljes lánc, az App Store Connect termékeitől a paywallig, az iOS-es in-app előfizetés oldalon van leírva.

Ha az első megjelenésedre készülsz, végezd el az ingyenes diagnózist: megmondja, mi akasztja meg valójában a projektedet, és elküldi az Apple-elutasítások elleni ellenőrzőlistámat.

Gyakori kérdések

Mi az Apple Retention Messaging API?

Egy szerverek közötti szolgáltatás, amely kiválasztja, milyen üzenet jelenjen meg az előfizetőnek, amikor a Cancel Subscription gombra koppint. Az üzenet egy megerősítő oldalon jelenik meg, a lemondás előtt. Emlékeztethet az előfizetés értékére, ajánlhat másik csomagot vagy promóciós ajánlatot.

Minden fejlesztő számára elérhető a Retention Messaging?

Az API előzetes verzió, az Apple-től kell hozzáférést kérni. A WWDC26-on az Apple bejelentett egy mindenki számára nyitott modult az App Store Connectben, 2026 őszére. 2026. november 3-án az App Store Connect súgója még nem írja le.

Mely iOS-verziókon jelenik meg az üzenet?

iOS 15.1 és iPadOS 15.1 vagy újabb, visionOS 1, illetve macOS 14 vagy újabb rendszeren. Régebbi eszközön a lemondás üzenet nélkül történik.

Megakadályozza az üzenet, hogy az előfizető lemondjon?

Nem. A megerősítő oldalon megmarad a lemondás gombja. Az előfizető meg is tarthatja az előfizetését, vagy elfogadhatja a felajánlott ajánlatot vagy csomagot.

Lehet kedvezményt ajánlani a lemondáskor?

Igen. Az API-val ez egy promóciós ajánlatos üzenet, csak valós időben: az ajánlatot az App Store Connectben hozod létre, és a szervered írja alá. Az App Store Connectbe bejelentett modul is lehetővé tesz ajánlatos üzenetet. A csomagváltás pedig egy másik előfizetést ajánl ugyanabból a csoportból.

Hány karakteres lehet egy megtartó üzenet?

A cím legfeljebb 66, a szöveg legfeljebb 144 karakter. Legfeljebb öt felsorolásjelet és egy átlátszóság nélküli PNG-képet adhatsz hozzá. Minden nyelvnek saját alapértelmezett üzenet kell.

Kell szerver a Retention Messaging használatához?

Az alapértelmezett üzenetekhez nem kell címet üzemeltetned: elég meghívni az API-t, hogy feltöltsd és megadd őket. RevenueCattel a RevenueCat tölti be a szerver szerepét. A valós idejű működéshez egy 700 ms alatt válaszoló HTTPS-cím kell. Az App Store Connectbe bejelentett modul kód nélkül beállítható.