Przejdź z RevenueCat do openpurr bez utraty żadnego subskrybenta
Zostajesz przy Purchases SDK, którego twoja aplikacja już używa. Importujesz obecnych klientów z eksportu RevenueCat, a openpurr sam pobiera każdy zakup z Apple i Google. Stare wersje aplikacji działają dalej, dopóki ludzie ich nie zaktualizują.
Zaktualizowano
W skrócie
- openpurr to otwartoźródłowa alternatywa dla RevenueCat, hostowana samodzielnie. Działa z oficjalnym, niezmodyfikowanym RevenueCat Purchases SDK.
- Twoja aplikacja dostaje jedną linijkę (URL proxy w SDK) i jednorazowe wywołanie
syncPurchases. Reszta kodu zakupów zostaje bez zmian. openpurr importprzenosi obecnych klientów z eksportu RevenueCat. Same zakupy są pobierane z Apple i Google, a nie kopiowane.- Aplikacje z App Store mogą użyć Scheduled Data Export z RevenueCat. Dla Google Play potrzebny jest eksport migracyjny od RevenueCat Support, jedyny, który zawiera tokeny zakupów.
- Oba backendy pozostają aktualne, dopóki większość ludzi nie zaktualizuje aplikacji, więc nikt nie traci dostępu.
- W darmowym planie Cloudflare import obsługuje około 2500 klientów dziennie. W planie Workers Paid duży import trwa kilka godzin.
Jak przebiega migracja z RevenueCat
openpurr nie kopiuje historii zakupów z RevenueCat. Musi tylko wiedzieć, kto jest właścicielem którego zakupu, a potem pyta sklepy, dokładnie tak jak wtedy, gdy twoja aplikacja wysyła zakup.
Import
Eksport RevenueCat mówi, który użytkownik aplikacji jest właścicielem którego zakupu w sklepie. openpurr import pyta Apple i Google o każdy zakup i zapisuje odpowiedź sklepu dla tego użytkownika. Przenosi wszystkich naraz, także tych, którzy już nigdy nie otworzą aplikacji.
Aktualizacja aplikacji
Nowa wersja kieruje Purchases SDK do openpurr i jednorazowo wysyła zakupy każdego klienta przez syncPurchases. To wyłapuje każdego, kogo pominął eksport, i każdego, kto kupił coś po jego utworzeniu.
Przez jakiś czas oba backendy
Stare wersje aplikacji rozmawiają z RevenueCat, dopóki ludzie ich nie zaktualizują. RevenueCat przekazuje powiadomienia Apple do openpurr, a druga subskrypcja Pub/Sub robi to samo dla Google, więc oba backendy pozostają aktualne.
Co się zmienia w twojej aplikacji
Ustaw URL proxy przed configure i jednorazowo wyślij zakupy każdego klienta. Te same dwie zmiany działają na Androidzie, we Flutterze i w React Native; przewodnik zawiera kod dla każdej platformy.
// Przed configure(): jedyna linijka, którą dodaje większość aplikacji
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")
// Raz na instalację: wyślij zakupy tego klienta do openpurr
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
Purchases.shared.syncPurchases { _, error in
if error == nil { UserDefaults.standard.set(true, forKey: synced) }
}
}Import klientów z RevenueCat
CLI openpurr czyta kolumny RevenueCat bez przeróbek: identyfikatory użytkowników aplikacji, identyfikatory transakcji App Store, tokeny zakupów Google Play i atrybuty, takie jak $email.
npm install -g @openpurr/cli
openpurr login --url https://<your back office>
# Sprawdź pierwsze wiersze: pyta Apple i Google, nic nie zapisuje
openpurr import revenuecat-export.csv --dry-run --limit 50
# Zaimportuj wszystkich. Przerwij kiedy chcesz; uruchom ponownie, by kontynuować.
openpurr import revenuecat-export.csvNikt nie traci dostępu
Zakup, który aplikacja już wysłała dla klienta, zostaje przy nim; import nigdy go nie przenosi.
Bez zdublowanych webhooków
Zaimportowane zakupy nie są nowe, więc openpurr nie wysyła dla nich żadnych zdarzeń.
Rzetelne wykresy
Zaimportowani klienci są datowani od pierwszego zakupu, a nie liczeni jako nowi w dniu importu.
Twoja aplikacja działa dalej
W darmowym planie Cloudflare import zatrzymuje się przy 90% dziennego limitu i kontynuuje następnego dnia.
Przerwij i wznów
Postęp jest zapisywany. Dwukrotny import tego samego wiersza niczego nie zmienia, więc nowszy eksport można uruchomić ponownie.
Najpierw przetestuj
Przebieg próbny (dry run) pyta sklepy i pokazuje, co by się stało, niczego nie zapisując.
Jak przeprowadzić migrację z RevenueCat w siedmiu krokach
Oba backendy działają, dopóki nie będziesz gotowy na przełączenie, więc klienci ze starszymi wersjami aplikacji zachowują dostęp.
Skonfiguruj openpurr
Wdróż openpurr Lite na swoim koncie Cloudflare, daj mu dostęp do API App Store i Google Play i odtwórz swoje produkty, entitlementy i oferty z tymi samymi identyfikatorami. Możesz nawet zachować publiczne klucze SDK z RevenueCat.
Informuj oba backendy
Ustaw openpurr jako Apple Server Notification Forwarding URL w RevenueCat i dodaj subskrypcję push openpurr do swojego tematu powiadomień Play.
Źródło: RevenueCat: powiadomienia serwerowe Apple (po angielsku)
Zdobądź eksport
Tylko App Store: Scheduled Data Export z RevenueCat zawiera wszystko, co potrzebne. Przy Google Play poproś RevenueCat Support o eksport migracyjny, bo tylko on zawiera tokeny zakupów. Przewodnik zawiera prośbę, którą możesz skopiować.
Źródło: RevenueCat: eksport danych lub migracja (po angielsku)
Importuj
Uruchom
openpurr import, najpierw jako przebieg próbny. Problemy z pojedynczymi wierszami trafiają do raportu i nie zatrzymują importu.Wydaj aktualizację aplikacji
Dodaj URL proxy i jednorazowe
syncPurchases. Wydaj ją, gdy import się zakończy.Sprawdź
openpurr doctorsprawdza konfigurację. Wyszukaj klientów, których znasz, i porównaj aktywne subskrypcje z wykresami RevenueCat.Dokończ przełączenie
Gdy większość klientów zaktualizuje aplikację, skieruj Apple i Google bezpośrednio do openpurr, włącz webhooki openpurr i wyłącz te z RevenueCat.
Wszystkie polecenia i ustawienia znajdziesz w pełnym przewodniku (po angielsku) →
Co przenosi się z RevenueCat, a co nie
| Subskrypcje i zakupy, z odnowieniami, zwrotami, okresami karencji i wygaśnięciami | Tak, pobierane z Apple i Google |
|---|---|
| Kto jest właścicielem którego zakupu | Tak, z eksportu RevenueCat |
| Identyfikatory użytkowników aplikacji, także anonimowe | Tak, bez zmian |
| Atrybuty klientów ($email, $displayName i twoje własne) | Tak, z Audience export |
| Produkty, entitlementy i oferty | Odtwarzasz je, z tymi samymi identyfikatorami |
| Historia wykresów sprzed przełączenia | Częściowo: zachowaj pliki CSV z wykresami RevenueCat do swojej dokumentacji |
| Paywalle, eksperymenty, integracje, Customer Center | Nie: openpurr ich nie ma |
Migracja z RevenueCat: najczęstsze pytania
Czy muszę zmienić kod zakupów?
Nie. openpurr działa z oficjalnym, niezmodyfikowanym RevenueCat Purchases SDK. Aktualizacja aplikacji dodaje URL proxy przed configure i jednorazowe wywołanie syncPurchases. getOfferings, purchase, restorePurchases, logIn i cała reszta zostają bez zmian.
Czy do migracji potrzebuję pomocy RevenueCat?
W przypadku aplikacji z App Store nie, bo Scheduled Data Export z RevenueCat zawiera identyfikatory transakcji, których potrzebuje openpurr. W przypadku Google Play tak, bo według dokumentacji RevenueCat tylko eksport migracyjny przygotowany przez RevenueCat Support zawiera tokeny zakupów wymagane przez Google.
Co z klientami, którzy nigdy nie zaktualizują aplikacji?
Obejmuje ich import: ich zakupy są pobierane z Apple i Google i przypisywane do tych samych identyfikatorów użytkowników aplikacji. Dopóki korzystają ze starej wersji aplikacji, ta wersja rozmawia z RevenueCat, i dlatego oba backendy pozostają aktualne, dopóki większość ludzi nie zaktualizuje aplikacji.
Ile trwa import?
Każdy klient to około 30 zapisów wierszy w bazie danych. W darmowym planie Cloudflare daje to około 2500 klientów dziennie, a import sam wstrzymuje się przy dziennym limicie i wznawia następnego dnia. W planie Workers Paid (5 USD miesięcznie) duży import trwa kilka godzin.
Czy moje dane są kopiowane z RevenueCat?
Tylko przypisanie użytkowników aplikacji do zakupów w sklepach, oraz atrybuty, jeśli je importujesz. Same zakupy pochodzą bezpośrednio z Apple i Google, więc openpurr zapisuje aktualny stan ze sklepów, łącznie z odnowieniami i zwrotami.
Gotowy na przejście?
Przewodnik prowadzi przez każdy krok. Jeśli coś w twojej konfiguracji nie pasuje, zgłoś issue: migracje wpływają na to, co powstanie w następnej kolejności.
