RevenueCat: In-App-Abo unter iOS einrichten

Warum RevenueCat statt nur StoreKit

Mit StoreKit, dem Framework von Apple, kannst du ein Abo ganz ohne Drittanbieter verkaufen. Als Anfänger musst du dann aber die gesamte Logik für Kauf, Wiederherstellung und Prüfung der Zugriffsrechte selbst schreiben. Das ist viel Code, den du pflegen musst, und dabei vergisst man leicht Sonderfälle: Gerätewechsel, Ablauf, Rückerstattung.

RevenueCat sitzt zwischen App Store Connect und deiner App: Es liest deine Produkte aus, verwaltet die aktiven Abos und nimmt dir diese Schicht ab. Preis und Angebote steuerst du weiter selbst über ein Dashboard, ohne deine App bei jeder Änderung neu veröffentlichen zu müssen.

Schritt 1: Deine Produkte in App Store Connect anlegen

Bevor du RevenueCat anfasst, müssen die Produkte bei Apple existieren. Leg in App Store Connect eine Abo-Gruppe an, dann eine oder mehrere Stufen mit ihrer Laufzeit, zum Beispiel monatlich oder jährlich, und ihrem Preis pro Land. Trag auch die Texte ein, die der Nutzer für jede Stufe sieht: Apple verlangt sie, bevor das Produkt im Review akzeptiert wird.

Ein häufiger Fehler an dieser Stelle: ein Produkt, das angelegt, aber nie zusammen mit der zugehörigen Version beim ersten Review der App eingereicht wurde. Ein wartendes Produkt, das nie Teil einer App-Einreichung war, bleibt für deine Nutzer unsichtbar, auch wenn RevenueCat es schon sieht.

Schritt 2: RevenueCat mit deiner App verbinden

In RevenueCat legst du ein Projekt an, hinterlegst deinen API-Schlüssel von App Store Connect, damit RevenueCat deine Produkte automatisch synchronisiert, und definierst dann „Entitlements“, also Zugriffsrechte. Ein Entitlement steht für das, was das Abo freischaltet, zum Beispiel den vollen Zugriff auf die App, unabhängig davon, welches Produkt genau es ausgelöst hat.

Dieser Umweg lohnt sich: Wenn du später die Struktur deiner Angebote änderst, etwa eine Jahresstufe hinzufügst, verknüpfst du das neue Produkt einfach mit demselben Entitlement, ohne den Code anzufassen, der in deiner App den Zugriff prüft.

In der App installierst du das RevenueCat-SDK für React Native in einem Expo-Projekt über ein eigenes Plugin. Es bietet eine einfache Funktion, mit der du prüfst, ob der aktuelle Nutzer ein aktives Entitlement hat.

Schritt 3: Deine Paywall bauen

Die Paywall ist der Screen, der das Angebot präsentiert und den Kauf auslöst. RevenueCat bietet Paywalls, die du im Dashboard konfigurierst und ohne neue App-Version ändern kannst. Oder du baust deine eigene mit dem SDK, wenn du volle Kontrolle über das Design willst.

Die Platzierung zählt genauso viel wie das Design. Eine Paywall, die erscheint, bevor die Person den Nutzen der App gesehen hat, konvertiert meist schlechter als eine, die direkt nach einer ersten erfolgreichen Aktion kommt. Der Guide zu Paywall-Fehlern unter iOS für Anfänger beschreibt die häufigsten Fallen an dieser Stelle, über die reine technische Anbindung hinaus.

Schritt 4: Kauf, Wiederherstellung und Ablauf testen

Das ist der Schritt, der am häufigsten schlampig erledigt wird, und genau den prüft Apple am genauesten. Drei Szenarien müssen vor dem Einreichen funktionieren:

Der Kauf. Mit einem Sandbox-Testkonto muss der Kauf das Entitlement sofort freischalten, und deine App muss auf diese Änderung reagieren, ohne dass sie neu gestartet werden muss.

Die Wiederherstellung. Auf einem neuen Gerät oder nach einer Neuinstallation muss ein Button „Käufe wiederherstellen“ mit demselben Apple-Account das aktive Abo wiederfinden. Apple prüft diesen Ablauf im Review jedes Mal, und wenn er fehlt oder nicht richtig funktioniert, ist das ein häufiger Ablehnungsgrund nach Guideline 3.1.1.

Der Ablauf. In der Sandbox laufen Abos nach wenigen Minuten statt nach mehreren Monaten ab. So kannst du prüfen, ob der Zugriff nach Ende der Laufzeit korrekt gesperrt wird, ohne auf einen echten Abrechnungszyklus zu warten.

Was RevenueCat nicht ersetzt

RevenueCat übernimmt die Kaufmechanik, nicht die Konformität deines Store-Eintrags oder deiner Paywall mit Guideline 3.1.2. Du musst weiterhin das Abo in deiner App-Store-Beschreibung korrekt beschreiben, den genauen Preis und die Laufzeit angeben und deine Nutzungsbedingungen hinterlegen. Die Seite Abo oder Einmalkauf unter iOS hilft dir, das richtige Modell zu wählen, noch bevor du bei diesem technischen Schritt ankommst.

Außerdem nimmt RevenueCat ab einer bestimmten monatlichen Umsatzschwelle eine Provision, zusätzlich zur Provision von Apple auf in der App verkaufte Abos. Prüf die aktuellen Stufen direkt auf der Website von RevenueCat, bevor du dein Geschäftsmodell um diese beiden Provisionen herum aufbaust.

Die häufigsten Anfängerfehler

Den Ladezustand vergessen. Beim Start braucht RevenueCat einen kurzen Moment, um die Zugriffsrechte des Nutzers abzurufen. Zeigt deine App die Bezahlinhalte standardmäßig an, bevor die Antwort da ist, kann ein Nutzer ohne Abo kurz Inhalte sehen, für die er nicht bezahlt hat. Plane einen expliziten Ladezustand ein statt einer optimistischen Standardanzeige.

Die Rechte an der falschen Stelle prüfen. Ein aktives Entitlement muss bei jedem Öffnen eines kostenpflichtigen Screens erneut geprüft werden, nicht nur einmal beim Start. Kündigt der Nutzer oder läuft sein Abo ab, während er die App nutzt, muss der nächste Screen diese Änderung widerspiegeln.

Sandbox und Produktion verwechseln. Produkt-IDs und Sandbox-Testkonten sind von der Produktion getrennt. Ein Test, der in der Sandbox mit dem falschen Apple-Account funktioniert, oder ein Produkt, das nur in der Produktion angelegt wurde, kann den falschen Eindruck erwecken, dass alles bereit ist.

Eine geprüfte App, nicht nur eine App, die kompiliert

Ein Abo, das im schnellen Test auf deinem eigenen Account „funktioniert“, übersteht deshalb noch lange keine Wiederherstellung auf einem anderen Gerät oder einen echten Ablauf. Genau das prüft ein Apple-Reviewer. Die Seite In-App-Abo unter iOS beschreibt diese ganze Kette, vom Anlegen der Produkte bis zur finalen Prüfung.

Wenn du mit einer Basis starten willst, in der Paywall und Abos schon im Code stecken: Genau das enthält der Startcode des iOS Kit. Um dein Abo so zu prüfen, wie es der Reviewer tun wird, bündelt das Apple Review Kit meine Checkliste vor dem Einreichen und die Notizen, die du dem Tester zum In-App-Kauf hinterlassen solltest.

Häufige Fragen

Wie richte ich ein Abo mit RevenueCat unter iOS ein?

In vier Schritten. Leg zuerst deine Produkte in App Store Connect an. Verbinde dann RevenueCat mit deinem API-Schlüssel von App Store Connect, definiere deine Entitlements (die Zugriffsrechte) und bau anschließend die Paywall. Zum Schluss testest du Kauf, Wiederherstellung und Ablauf: Dieser Schritt wird oft schlampig erledigt, dabei prüft Apple genau ihn.

Brauche ich RevenueCat, um unter iOS ein Abo zu verkaufen?

Nein. Mit StoreKit, dem Framework von Apple, kannst du ein Abo ohne Drittanbieter verkaufen. Dann schreibst du aber die gesamte Logik für Kauf, Wiederherstellung und Prüfung der Zugriffsrechte selbst, mit Sonderfällen, die man leicht vergisst: Gerätewechsel, Ablauf, Rückerstattung. RevenueCat sitzt zwischen App Store Connect und deiner App und nimmt dir diese Schicht ab.

Was ist ein Entitlement in RevenueCat?

Ein Entitlement ist ein Zugriffsrecht: Es steht für das, was das Abo freischaltet, zum Beispiel den vollen Zugriff auf die App, egal welches Produkt genau es ausgelöst hat. Fügst du später eine Jahresstufe hinzu, verknüpfst du das neue Produkt einfach mit demselben Entitlement. Der Code, der in deiner App den Zugriff prüft, muss sich nicht ändern.

Wie teste ich ein RevenueCat-Abo vor dem Einreichen bei Apple?

Drei Szenarien müssen vor dem Einreichen funktionieren. Kauf: Mit einem Sandbox-Testkonto wird der Zugriff sofort freigeschaltet, ohne Neustart der App. Wiederherstellung: Auf einem neuen Gerät oder nach einer Neuinstallation findet der Wiederherstellen-Button mit demselben Apple-Account das aktive Abo wieder. Ablauf: In der Sandbox laufen Abos nach wenigen Minuten ab, sodass du prüfen kannst, ob der Zugriff wieder gesperrt wird.

Warum bleibt ein Produkt, das RevenueCat sieht, für Nutzer unsichtbar?

Oft, weil das Produkt nie Teil einer App-Einreichung war. Ein Produkt, das in App Store Connect angelegt, aber nie zusammen mit der zugehörigen Version beim ersten Review eingereicht wurde, bleibt für deine Nutzer unsichtbar, auch wenn RevenueCat es schon sieht. Das ist ein häufiger Fehler beim Anlegen der Produkte.

Nimmt RevenueCat eine Provision auf Abos?

RevenueCat nimmt ab einer bestimmten monatlichen Umsatzschwelle eine Provision. Sie kommt zur Provision von Apple auf in der App verkaufte Abos hinzu. Prüf die aktuellen Stufen auf der Website von RevenueCat, bevor du dein Geschäftsmodell um diese beiden Provisionen herum aufbaust.