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 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.
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) }
}
}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.csvNiemand 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.
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.
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.
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.
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)
Importieren
Führe
openpurr importaus, zuerst als Probelauf. Probleme mit einzelnen Zeilen landen in einem Bericht und halten den Import nicht an.App-Update ausliefern
Ergänze die Proxy-URL und einen einmaligen Aufruf von
syncPurchases. Veröffentliche das Update, sobald der Import fertig ist.Prüfen
openpurr doctorprüft die Einrichtung. Schlag Kunden nach, die du kennst, und vergleiche die aktiven Abos mit den Diagrammen von RevenueCat.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 von RevenueCat mitkommt und was nicht
| Abos und Käufe, mit Verlängerungen, Erstattungen, Kulanzzeiträumen und Ablauf | Ja, abgerufen bei Apple und Google |
|---|---|
| Wem welcher Kauf gehört | Ja, aus dem Export von RevenueCat |
| App-User-IDs, auch anonyme | Ja, unverändert |
| Kundenattribute ($email, $displayName und eigene) | Ja, aus einem Audience export |
| Produkte, Entitlements und Offerings | Du legst sie mit denselben IDs neu an |
| Diagrammverlauf vor dem Wechsel | Teilweise: Bewahre die Diagramm-CSVs von RevenueCat für deine Unterlagen auf |
| Paywalls, Experimente, Integrationen, Customer Center | Nein: Das bietet openpurr nicht |
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.
