Retention Messaging API: Nachricht vor der Kündigung

Die Retention Messaging API ist ein Server-zu-Server-Dienst von Apple, der einem Abonnenten deine Nachricht zeigt, sobald er auf Cancel Subscription tippt. Die Nachricht erscheint auf einer Bestätigungsseite, bevor die Kündigung abgeschlossen ist. Sie kann an den Wert deines Abos erinnern, ein anderes Abo-Modell oder ein Werbeangebot vorschlagen, aber der Button zum Kündigen bleibt immer da. Die API ist seit Juli 2025 als Vorabversion verfügbar, nur auf Anfrage, und Apple hat für Herbst 2026 eine einfachere Version in App Store Connect angekündigt.

Dieser Guide erklärt, was die API anzeigt, seit wann es sie gibt, wer sie nutzen kann, welche Bedingungen gelten und wie du sie einrichtest. Alles stammt aus der Dokumentation von Apple und der WWDC26-Session zum Thema, gelesen am 3. November 2026.

Ich verkaufe Abos in meinen iOS-Apps: Solys, ein Blocker für soziale Netzwerke, TradaZen, ein Trading-Simulator, Nolera, eine App zum Anprobieren von Outfits per KI, und Vigie. Am 25. Oktober 2026 habe ich für alle vier Zugang zur API beantragt und ihre Nachrichten in allen Sprachen vorbereitet. Am 28. Oktober war die Freigabe von Apple noch nicht da: Dieser Guide beschreibt also die Regeln und meine Vorbereitung, noch keine Ergebnisse.

Was die Retention Messaging API macht

Laut der Dokumentation von Apple kannst du mit der API die Nachricht auswählen, die das System anzeigt, wenn ein Kunde die Detailseite eines Abos aufruft und vielleicht kurz davor ist zu kündigen. Du bereitest deine Nachrichten vorab vor, für jedes Produkt und jede Sprache.

Der Ablauf ist immer gleich:

1. Der Abonnent öffnet sein Abo, zum Beispiel unter Apple Account, Subscriptions oder über den App Store.
2. Er tippt auf Cancel Subscription.
3. Das System zeigt eine Bestätigungsseite (Confirm Cancellation) mit deiner Nachricht.
4. Er kann trotzdem kündigen, sein Abo behalten oder annehmen, was deine Nachricht anbietet.

Die Nachricht ist sichtbar ab iOS 15.1 und iPadOS 15.1, auf visionOS 1 und ab macOS 14.

Seit wann und für wen

Datum	Was sich laut Apple ändert
16. Juli 2025	Version 1.0: erste Vorabversion der API
9. Dez. 2025	Performancetest des Servers für Echtzeit
31. März 2026	Aufzählungspunkte in Nachrichten, Echtzeit-Adresse per API setzen
27. Apr. 2026	Unterstützung für Monatsabos mit 12 Monaten Mindestlaufzeit
Juni 2026	WWDC26: Ankündigung eines Moduls in App Store Connect

Die Daten stammen aus dem Versionsverlauf der API, außer dem letzten, das aus der WWDC26-Session kommt. Die API bleibt eine Vorabversion: Die Dokumentation verweist auf ein Formular für den Zugangsantrag, für das du dich mit deinem Entwicklerkonto anmelden musst.

Auf der WWDC26 stellt die Session Explore Retention Messaging in App Store Connect ein Modul vor, das sich ohne Code in App Store Connect einrichten lässt. Apple nennt es „für alle offen“. Die Echtzeit-Version bleibt dagegen auf Anfrage. Die Seite mit den Neuerungen im App Store kündigt das Modul für „diesen Herbst“ an. Stand 3. November 2026 hat die Hilfe von App Store Connect noch keine Seite dazu, und am 28. Oktober tauchte das Modul in meinem Konto nicht auf.

Die API betrifft Apps, die ein automatisch verlängerbares Abo verkaufen. Sie ist nicht großen Publishern vorbehalten: RevenueCat schreibt in seiner Studie zu 22 Millionen Nachrichten, dass auch kleine Apps Zugang beantragen können.

Die 4 Nachrichtentypen

Typ	Was der Abonnent sieht	Standardnachricht	Echtzeit
Text	Ein Titel, ein Text, bis zu fünf Aufzählungspunkte	Ja	Ja
Text mit Bild	Dasselbe, mit einem Bild	Ja	Ja
Wechsel des Modells	Ein Text und ein anderes Abo aus derselben Gruppe	Nein	Ja
Werbeangebot	Ein Text und ein Angebot, um günstiger weiterzumachen	Nein	Ja

Laut der Seite zur Vorbereitung der Nachrichten kann eine Standardnachricht nur ein Text sein, mit oder ohne Bild. Wer über die API ein Angebot oder ein anderes Abo-Modell vorschlagen will, muss in Echtzeit antworten. Das angekündigte Modul in App Store Connect wird dagegen eine Nachricht mit Angebot bieten, ganz ohne Server.

Das Werbeangebot ist das, das du in App Store Connect anlegst. Laut der Hilfe zu Werbeangeboten richtet es sich an aktuelle und ehemalige Abonnenten. In einer Retention-Nachricht signiert es dein Server, so die Seite zur Vorbereitung der Nachrichten. Der Modellwechsel schlägt ein Abo aus derselben Gruppe vor. Wenn du mit diesen Angeboten neu bist, lies zuerst meinen Guide zu Angebotscodes und Werbeangeboten.

Was du anzeigen kannst: die genauen Grenzen

Element	Grenze von Apple
Titel	höchstens 66 Zeichen
Text	höchstens 144 Zeichen
Aufzählungspunkte	höchstens 5
Bild in voller Breite	PNG ohne Transparenz, 3.840 px breit, 160 bis 2.160 hoch
Bild für Aufzählung	1.024 × 1.024 px
Bilder pro App	höchstens 2.000

Die Längen stammen aus der Beschreibung des Request-Bodys zum Hochladen einer Nachricht, die Formate von der Seite zum Hochladen eines Bildes. Apple verlangt außerdem Bilder, die im hellen wie im dunklen Modus gut aussehen.

Jede Nachricht und jedes Bild wird von Apple geprüft. Der Status wechselt von PENDING zu APPROVED, und das System zeigt nur Freigegebenes an. In der Sandbox erfolgt die Freigabe automatisch. Die Dokumentation stellt eine klare Inhaltsregel auf: nichts Irreführendes oder Ungenaues einreichen.

Die Bedingungen

• Eine Standardnachricht für jedes Produkt, in jeder Sprache. Ohne sie wird in dieser Sprache nichts angezeigt. Sie ist auch dein Ersatzrad, wenn dein Server nicht antwortet.
• Freigegebene Nachrichten und Bilder, bevor irgendetwas live geht.
• Für Echtzeit ein schneller Server. Die Seite zur Einrichtung der Echtzeit-Adresse verlangt ein gültiges SSL-Zertifikat, TLS 1.2 und eine Antwort in unter 700 ms in Produktion. Darüber schlägt die Anfrage fehl und die Standardnachricht wird angezeigt.
• Ein bestandener Performancetest in der Sandbox, bevor du deine Produktionsadresse einträgst.
• Eine Prüfung der App. Jede Anfrage von Apple enthält die ID der App, appAppleId. Stimmt sie nicht mit deiner überein, sollst du laut Apple nicht antworten.

Die Echtzeit-Anfrage liefert dir die ID der ursprünglichen Transaktion, das Produkt und die Sprache des Geräts. Welche Nachricht du wählst, entscheidest du nach deinen eigenen Regeln.

Retention Messaging einrichten: drei Wege

Weg	Für wen	Was du brauchst
Modul in App Store Connect	Alle, sobald es erschienen ist	Kein Code; Text, Bild oder Angebot
API mit eigenem Server	Wer ein Backend hat	Zugang von Apple, HTTPS-Adresse, Performancetest
API über RevenueCat	Apps, die schon RevenueCat nutzen	Zugang von Apple, Einstellungen im Dashboard

Wenn mehrere Einstellungen nebeneinander bestehen, erklärt Apple in der WWDC26-Session die Reihenfolge: zuerst die Echtzeit-Antwort. Fehlt sie oder ist sie fehlerhaft, die Einstellung in App Store Connect. Gibt es die nicht, die per API konfigurierte Standardnachricht.

Mit deinem eigenen Server

1. Beantrage den Zugang über das Formular von Apple.
2. Lade deine Bilder hoch, dann deine Nachrichten, jeweils mit Titel und Text.
3. Warte auf die Freigabe und lege dann eine Standardnachricht für jedes Abo und jede Sprache fest.
4. Für Echtzeit legst du die Adresse Get Retention Message auf deinem Server an und trägst sie in der Sandbox ein.
5. Starte den Performancetest in der Sandbox mit einer Testtransaktion.
6. Sobald der Test bestanden ist, trägst du deine Produktionsadresse ein.

Mit RevenueCat

Das ist der Weg, den ich gewählt habe: kein Server zu schreiben, und meine Apps laufen ohnehin über RevenueCat, wie ich in RevenueCat und In-App-Abos unter iOS erkläre. Laut der Dokumentation von RevenueCat:

1. Im Formular von Apple gibst du die Adresse an, die RevenueCat in den Einstellungen deiner App-Store-App anzeigt.
2. Nach der Freigabe öffnest du Lifecycle, dann Retention, und verbindest die Sandbox-Adresse.
3. Starte den Performancetest mit einem aktiven Sandbox- oder TestFlight-Abo. Er kann bis zu einer Stunde dauern.
4. Erstelle zuerst eine Standardnachricht, Sprache für Sprache.
5. Füge dann Echtzeit-Nachrichten mit Regeln hinzu. Eine davon, „Is in free trial“, zielt auf Leute im kostenlosen Testzeitraum.
6. Wechsle in die Produktion: Die Sandbox-Einstellungen werden nicht übernommen, du musst die Nachrichten neu anlegen.

Eine Nachricht schreiben, die hält, ohne zu tricksen

Der Text ist fest und wird von Apple geprüft, bevor er angezeigt wird. Er kann also weder über die Person sprechen, die ihn liest, noch über den Tag, an dem sie ihn liest. Hier die Standardnachricht, die ich für TradaZen vorbereitet habe, in der deutschen Fassung:

Titel (56 Zeichen):
Du wolltest traden lernen und machst jetzt blind weiter?

Text (125 Zeichen):
Ohne Training zahlt dein echtes Geld jeden Fehler. Hier kosten sie nichts. Deine Serie, deine Liga und deine Lektionen enden.

Die Regeln, die ich mir für meine vier Apps gesetzt habe:

• Der Titel erinnert die Person an ihr Ziel, als Frage. Er beschämt sie nicht.
• Der Text sagt genau, was endet. Ich schreibe, dass der Zugang „gesperrt“ wird, wenn die Daten erhalten bleiben, nie, dass sie „gelöscht“ werden.
• Keine Zeitwörter wie „morgen“ oder „heute“: Derselbe Text erscheint zu jedem Zeitpunkt des Zeitraums.
• Keine Gewinnversprechen, keine falsche Dringlichkeit. Ein erster Titel, der ein neues Leben durch Trading versprach, flog vor dem Einreichen raus. Die Guideline 5.6 verbietet jede manipulative Praxis, und die Paywall von TradaZen wurde genau deshalb schon abgelehnt, wie ich in Guideline 5.6 und die Paywall erzähle.
• Jede Sprache bekommt ihren eigenen Text, im Vokabular der übersetzten App und aufs Zeichen genau gezählt.

Für TradaZen plane ich außerdem eine Echtzeit-Nachricht für Leute im Testzeitraum des Jahresabos. Sie wird ein günstigeres Jahresmodell aus derselben Gruppe anbieten, denn meine Zahlen zeigen, dass diese Leute die App genauso viel nutzen wie zahlende Nutzer: Es ist der Preis, den sie ablehnen. Diese Einstellung wartet auf die Freigabe von Apple.

Was du erwarten kannst

Rechne nicht mit einem Wunder. Apple nennt den Anteil der Abonnenten, die ihr Abo behalten, nachdem sie auf der Bestätigungsseite gelandet sind, die Rettungsquote. In der WWDC26-Session sagt Apple, dass Abos mit Retention Messaging im Schnitt 1,4 Prozentpunkte dieser Quote gewinnen. Nachrichten mit Werbeangebot erzielen den besten beobachteten Zuwachs, 5,5 Punkte, und die Ergebnisse schwanken von Entwickler zu Entwickler. Die Studie von RevenueCat stellt ihrerseits fest, dass Abonnenten nur etwa 1,1 % der Werbeangebote und 0,6 % der Modellwechsel annehmen.

Die Nachricht ersetzt also nicht die Arbeit davor. Ein kostenloser Test, der in der ersten Minute gekündigt wird, entscheidet sich bei der Paywall und den ersten Sessions: Ursachen und Hebel findest du in meinem Guide zum gekündigten kostenlosen Test, das Anlegen des Tests im Einführungsangebot.

Dein Abo vor der Nachricht vorbereiten

Das iOS & Android Kit basiert auf dem Startcode meiner Apps: Onboarding, Paywall und Abos sind schon programmiert, und der Weg in vier Schritten führt dich in deinem Tempo bis in den App Store. Die ganze Kette, von den Produkten in App Store Connect bis zur Paywall, ist auf der Seite In-App-Abos unter iOS beschrieben.

Wenn du deinen ersten Release vorbereitest, mach deine kostenlose Diagnose: Sie zeigt dir, was dein Projekt wirklich blockiert, und schickt dir meine Checkliste gegen Ablehnungen durch Apple.

Häufige Fragen

Was ist die Retention Messaging API von Apple?

Ein Server-zu-Server-Dienst, der die Nachricht auswählt, die ein Abonnent sieht, wenn er auf Cancel Subscription tippt. Die Nachricht erscheint auf einer Bestätigungsseite, vor der Kündigung. Sie kann an den Wert des Abos erinnern, ein anderes Modell oder ein Werbeangebot vorschlagen.

Ist Retention Messaging für alle Entwickler verfügbar?

Die API ist eine Vorabversion, nur auf Anfrage bei Apple. Auf der WWDC26 hat Apple ein Modul in App Store Connect angekündigt, offen für alle, geplant für Herbst 2026. Stand 3. November 2026 beschreibt die Hilfe von App Store Connect es noch nicht.

Auf welchen iOS-Versionen wird die Nachricht angezeigt?

Ab iOS 15.1 und iPadOS 15.1, auf visionOS 1 und ab macOS 14. Auf älteren Geräten läuft die Kündigung ohne Nachricht ab.

Hindert die Nachricht den Abonnenten am Kündigen?

Nein. Die Bestätigungsseite behält einen Button zum Kündigen. Der Abonnent kann auch sein Abo behalten oder das vorgeschlagene Angebot bzw. Modell annehmen.

Kann man bei der Kündigung einen Rabatt anbieten?

Ja. Über die API ist das eine Nachricht mit Werbeangebot, nur in Echtzeit: Das Angebot wird in App Store Connect angelegt und von deinem Server signiert. Das angekündigte Modul in App Store Connect erlaubt ebenfalls eine Nachricht mit Angebot. Der Modellwechsel schlägt dagegen ein anderes Abo aus derselben Gruppe vor.

Wie viele Zeichen hat eine Retention-Nachricht?

Der Titel hat höchstens 66 Zeichen, der Text 144. Du kannst bis zu fünf Aufzählungspunkte und ein PNG-Bild ohne Transparenz hinzufügen. Jede Sprache braucht ihre eigene Standardnachricht.

Braucht man einen Server für Retention Messaging?

Für Standardnachrichten musst du keine Adresse hosten: Du rufst nur die API auf, um sie hochzuladen und festzulegen. Mit RevenueCat übernimmt RevenueCat die Rolle des Servers. Echtzeit verlangt eine HTTPS-Adresse, die in unter 700 ms antwortet. Das angekündigte Modul in App Store Connect lässt sich ohne Code einrichten.