Migrationsanleitung

Von RevenueCat zu openpurr wechseln, ohne einen Abonnenten zu verlieren

Behalte das Purchases SDK, das deine App schon nutzt. Importiere deine bestehenden Kunden aus dem Export von RevenueCat: openpurr holt jeden Kauf selbst bei Apple und Google ab. Alte App-Versionen funktionieren weiter, während die Leute aktualisieren.

Aktualisiert am

Kurz gesagt

  • openpurr ist eine selbst gehostete Open-Source-Alternative zu RevenueCat. Es funktioniert mit dem offiziellen, unveränderten RevenueCat Purchases SDK.
  • Deine App bekommt eine zusätzliche Zeile (die Proxy-URL des SDK) und einen einmaligen Aufruf von syncPurchases. Der restliche Kaufcode bleibt gleich.
  • openpurr import übernimmt bestehende Kunden aus dem Export von RevenueCat. Die Käufe selbst werden bei Apple und Google abgerufen, nicht kopiert.
  • Apps im App Store können den Scheduled Data Export von RevenueCat nutzen. Für Google Play brauchst du einen Migrationsexport vom RevenueCat Support, denn nur dieser enthält Kauftokens.
  • Beide Backends bleiben auf dem neuesten Stand, bis die meisten Leute die App aktualisiert haben. So verliert niemand seinen Zugang.
  • Im kostenlosen Cloudflare-Tarif schafft der Import etwa 2.500 Kunden pro Tag. Mit Workers Paid dauert ein großer Import einige Stunden.
So funktioniert's

So funktioniert der Umstieg von RevenueCat

openpurr kopiert keine Kaufdatensätze aus RevenueCat. Es muss nur wissen, wem welcher Kauf gehört, und fragt dann die Stores, genau wie wenn deine App einen Kauf sendet.

Der Import

Der Export von RevenueCat zeigt, welchem App-User welcher Store-Kauf gehört. openpurr import fragt Apple und Google nach jedem Kauf und speichert die Antwort des Stores für diesen User. So kommen alle auf einmal herüber, auch Leute, die die App nie wieder öffnen.

Das App-Update

Die neue Version richtet das Purchases SDK auf openpurr und sendet die Käufe jedes Kunden einmal mit syncPurchases. Das erfasst alle, die der Export verpasst hat, und alle, die nach seiner Erstellung gekauft haben.

Eine Zeit lang beide Backends

Alte App-Versionen sprechen weiter mit RevenueCat, bis die Leute aktualisieren. RevenueCat leitet die Benachrichtigungen von Apple an openpurr weiter, und eine zweite Pub/Sub-Subscription erledigt dasselbe für Google. So bleiben beide aktuell.

In deiner App

Was sich in deiner App ändert

Setze die Proxy-URL vor configure und sende die Käufe jedes Kunden einmal. Dieselben zwei Änderungen funktionieren unter Android, Flutter und React Native; die Anleitung enthält den Code für jede Plattform.

// Vor configure(): die einzige neue Zeile in den meisten Apps
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")

// Einmal pro Installation: Käufe dieses Kunden an openpurr senden
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
  Purchases.shared.syncPurchases { _, error in
    if error == nil { UserDefaults.standard.set(true, forKey: synced) }
  }
}
Der Import

Kunden aus RevenueCat importieren

Die openpurr CLI liest die Spalten von RevenueCat so, wie sie sind: App-User-IDs, Transaktions-IDs aus dem App Store, Kauftokens von Google Play und Attribute wie $email.

npm install -g @openpurr/cli
openpurr login --url https://<your back office>

# Erste Zeilen prüfen: fragt Apple und Google, schreibt nichts
openpurr import revenuecat-export.csv --dry-run --limit 50

# Alle importieren. Jederzeit abbrechen; erneut starten, um fortzusetzen.
openpurr import revenuecat-export.csv

Niemand verliert seinen Zugang

Ein Kauf, den die App bereits für einen Kunden gesendet hat, bleibt bei ihm; der Import verschiebt ihn nie.

Keine doppelten Webhooks

Importierte Käufe sind nicht neu, deshalb sendet openpurr für sie keine Ereignisse.

Ehrliche Diagramme

Importierte Kunden zählen ab ihrem ersten Kauf und nicht als Neukunden am Tag des Imports.

Deine App läuft weiter

Im kostenlosen Cloudflare-Tarif hält der Import bei 90 % eines Tageslimits an und macht am nächsten Tag weiter.

Anhalten und fortsetzen

Der Fortschritt wird gespeichert. Eine Zeile zweimal zu importieren ändert nichts, also kannst du einen neueren Export erneut einspielen.

Erst ausprobieren

Ein Probelauf fragt die Stores und meldet, was passieren würde, ohne etwas zu schreiben.

Schritt für Schritt

In sieben Schritten von RevenueCat umsteigen

Beide Backends laufen weiter, bis du für den Wechsel bereit bist. So behalten Kunden mit älteren App-Versionen ihren Zugang.

  1. openpurr einrichten

    Stelle openpurr Lite in deinem Cloudflare-Konto bereit, gib ihm API-Zugriff auf App Store und Google Play und lege deine Produkte, Entitlements und Offerings mit denselben IDs neu an. Du kannst sogar deine öffentlichen SDK-Keys von RevenueCat behalten.

  2. Beide Backends auf dem Laufenden halten

    Trage openpurr in RevenueCat als Apple Server Notification Forwarding URL ein und füge die Push-Subscription von openpurr zu deinem Topic für Play-Benachrichtigungen hinzu.

    Quelle: RevenueCat: Apple Server Notifications (Englisch)

  3. Export besorgen

    Nur App Store: Der Scheduled Data Export von RevenueCat enthält alles Nötige. Bei Google Play bittest du den RevenueCat Support um einen Migrationsexport, denn nur dieser enthält Kauftokens. Die Anleitung enthält eine Anfrage zum Kopieren.

    Quelle: RevenueCat: Daten exportieren oder wechseln (Englisch)

  4. Importieren

    Führe openpurr import aus, zuerst als Probelauf. Probleme mit einzelnen Zeilen landen in einem Bericht und halten den Import nicht an.

  5. App-Update ausliefern

    Ergänze die Proxy-URL und einen einmaligen Aufruf von syncPurchases. Veröffentliche das Update, sobald der Import fertig ist.

  6. Prüfen

    openpurr doctor prüft die Einrichtung. Schlag Kunden nach, die du kennst, und vergleiche die aktiven Abos mit den Diagrammen von RevenueCat.

  7. Wechsel abschließen

    Sobald die meisten Kunden aktualisiert haben, richte Apple und Google direkt auf openpurr, schalte die Webhooks von openpurr ein und die von RevenueCat aus.

Alle Befehle und Einstellungen stehen in der vollständigen Anleitung (Englisch) →

Was umzieht

Was von RevenueCat mitkommt und was nicht

Abos und Käufe, mit Verlängerungen, Erstattungen, Kulanzzeiträumen und AblaufJa, abgerufen bei Apple und Google
Wem welcher Kauf gehörtJa, aus dem Export von RevenueCat
App-User-IDs, auch anonymeJa, unverändert
Kundenattribute ($email, $displayName und eigene)Ja, aus einem Audience export
Produkte, Entitlements und OfferingsDu legst sie mit denselben IDs neu an
Diagrammverlauf vor dem WechselTeilweise: Bewahre die Diagramm-CSVs von RevenueCat für deine Unterlagen auf
Paywalls, Experimente, Integrationen, Customer CenterNein: Das bietet openpurr nicht
FAQ

FAQ zum Umstieg von RevenueCat

Muss ich meinen Kaufcode ändern?

Nein. openpurr funktioniert mit dem offiziellen, unveränderten RevenueCat Purchases SDK. Das App-Update ergänzt die Proxy-URL vor configure und einen einmaligen Aufruf von syncPurchases. getOfferings, purchase, restorePurchases, logIn und der Rest bleiben, wie sie sind.

Brauche ich für den Umstieg die Hilfe von RevenueCat?

Für Apps im App Store nicht: Der Scheduled Data Export von RevenueCat enthält die Transaktions-IDs, die openpurr braucht. Für Google Play schon: Laut der Dokumentation von RevenueCat enthält nur ein Migrationsexport, den der RevenueCat Support erstellt, die Kauftokens, die Google verlangt.

Was ist mit Kunden, die die App nie aktualisieren?

Der Import deckt sie ab: Ihre Käufe werden bei Apple und Google abgerufen und denselben App-User-IDs zugeordnet. Solange sie noch eine alte App-Version nutzen, spricht diese mit RevenueCat. Deshalb bleiben beide Backends informiert, bis die meisten Leute aktualisiert haben.

Wie lange dauert ein Import?

Jeder Kunde braucht etwa 30 Schreibvorgänge für Datenbankzeilen. Im kostenlosen Cloudflare-Tarif sind das etwa 2.500 Kunden pro Tag, und der Import pausiert beim Tageslimit von selbst und macht am nächsten Tag weiter. Mit Workers Paid (5 $ im Monat) dauert ein großer Import einige Stunden.

Werden meine Daten von RevenueCat kopiert?

Nur die Zuordnung von App-Usern zu Store-Käufen, dazu Attribute, falls du sie importierst. Die Käufe selbst kommen direkt von Apple und Google, also speichert openpurr den aktuellen Stand der Stores, einschließlich Verlängerungen und Erstattungen.

Bereit für den Wechsel?

Die Anleitung führt dich durch jeden Schritt. Wenn etwas an deinem Setup nicht passt, eröffne ein Issue: Migrationen bestimmen mit, was als Nächstes gebaut wird.