Przewodnik migracji

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 import przenosi 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 to działa

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.

W twojej aplikacji

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

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.csv

Nikt 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.

Krok po kroku

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.

  1. 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.

  2. 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)

  3. 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)

  4. Importuj

    Uruchom openpurr import, najpierw jako przebieg próbny. Problemy z pojedynczymi wierszami trafiają do raportu i nie zatrzymują importu.

  5. Wydaj aktualizację aplikacji

    Dodaj URL proxy i jednorazowe syncPurchases. Wydaj ją, gdy import się zakończy.

  6. Sprawdź

    openpurr doctor sprawdza konfigurację. Wyszukaj klientów, których znasz, i porównaj aktywne subskrypcje z wykresami RevenueCat.

  7. 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 się przenosi

Co przenosi się z RevenueCat, a co nie

Subskrypcje i zakupy, z odnowieniami, zwrotami, okresami karencji i wygaśnięciamiTak, pobierane z Apple i Google
Kto jest właścicielem którego zakupuTak, z eksportu RevenueCat
Identyfikatory użytkowników aplikacji, także anonimoweTak, bez zmian
Atrybuty klientów ($email, $displayName i twoje własne)Tak, z Audience export
Produkty, entitlementy i ofertyOdtwarzasz je, z tymi samymi identyfikatorami
Historia wykresów sprzed przełączeniaCzęściowo: zachowaj pliki CSV z wykresami RevenueCat do swojej dokumentacji
Paywalle, eksperymenty, integracje, Customer CenterNie: openpurr ich nie ma
FAQ

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.