Migratiegids

Stap over van RevenueCat naar openpurr zonder één abonnee te verliezen

Behoud de Purchases SDK die je app al gebruikt. Importeer je bestaande klanten uit de export van RevenueCat: openpurr haalt elke aankoop zelf op bij Apple en Google. Oude appversies blijven werken terwijl mensen updaten.

Bijgewerkt op

In het kort

  • openpurr is een self-hosted, open-source alternatief voor RevenueCat. Het werkt met de officiële, ongewijzigde RevenueCat Purchases SDK.
  • Je app krijgt één extra regel (de proxy-URL van de SDK) en een eenmalige aanroep van syncPurchases. De rest van je aankoopcode blijft hetzelfde.
  • openpurr import haalt bestaande klanten over uit de export van RevenueCat. De aankopen zelf worden opgehaald bij Apple en Google, niet gekopieerd.
  • Apps in de App Store kunnen de Scheduled Data Export van RevenueCat gebruiken. Voor Google Play heb je een migratie-export van RevenueCat Support nodig, de enige met aankooptokens.
  • Beide backends blijven bijgewerkt tot de meeste mensen de app hebben geüpdatet, zodat niemand zijn toegang verliest.
  • Op het gratis abonnement van Cloudflare verwerkt de import ongeveer 2.500 klanten per dag. Met Workers Paid duurt een grote import een paar uur.
Zo werkt het

Zo werkt een migratie van RevenueCat

openpurr kopieert geen aankoopgegevens uit RevenueCat. Het hoeft alleen te weten wie welke aankoop bezit en vraagt het daarna aan de stores, precies zoals wanneer je app een aankoop doorstuurt.

De import

De export van RevenueCat vermeldt welke app-user welke store-aankoop bezit. openpurr import vraagt Apple en Google naar elke aankoop en legt het antwoord van de store vast voor die user. Zo komt iedereen in één keer over, ook mensen die de app nooit meer openen.

De app-update

De nieuwe versie richt de Purchases SDK op openpurr en stuurt de aankopen van elke klant één keer door met syncPurchases. Zo vang je iedereen op die in de export ontbrak, en iedereen die daarna nog iets kocht.

Een tijdje beide backends

Oude appversies blijven met RevenueCat praten tot mensen updaten. RevenueCat stuurt de meldingen van Apple door naar openpurr, en een tweede Pub/Sub-subscription doet hetzelfde voor Google, zodat beide actueel blijven.

In je app

Wat er verandert in je app

Stel de proxy-URL in vóór configure en stuur de aankopen van elke klant één keer door. Dezelfde twee wijzigingen werken op Android, Flutter en React Native; de handleiding bevat de code voor elk platform.

// Vóór configure(): de enige regel die de meeste apps toevoegen
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")

// Eén keer per installatie: aankopen van deze klant naar openpurr sturen
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
  Purchases.shared.syncPurchases { _, error in
    if error == nil { UserDefaults.standard.set(true, forKey: synced) }
  }
}
De import

Klanten importeren uit RevenueCat

De openpurr CLI leest de kolommen van RevenueCat zoals ze zijn: app-user-ID's, transactie-ID's uit de App Store, aankooptokens van Google Play en attributen zoals $email.

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

# Controleer de eerste rijen: vraagt Apple en Google, schrijft niets
openpurr import revenuecat-export.csv --dry-run --limit 50

# Importeer iedereen. Stop wanneer je wilt; start opnieuw om verder te gaan.
openpurr import revenuecat-export.csv

Niemand verliest toegang

Een aankoop die de app al voor een klant heeft doorgestuurd, blijft van die klant; de import verplaatst hem nooit.

Geen dubbele webhooks

Geïmporteerde aankopen zijn niet nieuw, dus openpurr stuurt er geen events voor.

Eerlijke grafieken

Geïmporteerde klanten krijgen de datum van hun eerste aankoop en tellen niet als nieuw op de dag van de import.

Je app blijft werken

Op het gratis abonnement van Cloudflare stopt de import bij 90% van een daglimiet en gaat de volgende dag verder.

Stoppen en hervatten

De voortgang wordt opgeslagen. Een rij twee keer importeren verandert niets, dus je kunt een nieuwere export opnieuw draaien.

Probeer het eerst

Een proefrun vraagt het aan de stores en meldt wat er zou gebeuren, zonder iets te schrijven.

Stap voor stap

Overstappen van RevenueCat in zeven stappen

Beide backends blijven draaien tot je klaar bent om over te schakelen, zodat klanten met oudere appversies hun toegang houden.

  1. openpurr opzetten

    Rol openpurr Lite uit in je Cloudflare-account, geef het API-toegang tot de App Store en Google Play, en maak je producten, entitlements en offerings opnieuw aan met dezelfde identifiers. Je kunt zelfs je openbare SDK-sleutels van RevenueCat houden.

  2. Beide backends op de hoogte houden

    Stel openpurr in RevenueCat in als Apple Server Notification Forwarding URL, en voeg de push-subscription van openpurr toe aan je topic voor Play-meldingen.

    Bron: RevenueCat: Apple server notifications (Engels)

  3. Je export ophalen

    Alleen App Store: de Scheduled Data Export van RevenueCat bevat wat nodig is. Gebruik je Google Play, vraag RevenueCat Support dan om een migratie-export, want alleen die bevat aankooptokens. De handleiding bevat een verzoek dat je kunt kopiëren.

    Bron: RevenueCat: data exporteren of overstappen (Engels)

  4. Importeren

    Voer openpurr import uit, eerst als proefrun. Problemen met afzonderlijke rijen komen in een rapport en houden de import niet tegen.

  5. De app-update uitbrengen

    Voeg de proxy-URL en een eenmalige syncPurchases toe. Publiceer de update zodra de import klaar is.

  6. Controleren

    openpurr doctor controleert de setup. Zoek klanten op die je kent en vergelijk de actieve abonnementen met de grafieken van RevenueCat.

  7. De overstap afronden

    Zodra de meeste klanten hebben geüpdatet, richt je Apple en Google rechtstreeks op openpurr, zet je de webhooks van openpurr aan en die van RevenueCat uit.

Alle commando's en instellingen staan in de volledige handleiding (Engels) →

Wat er meegaat

Wat er van RevenueCat meegaat, en wat niet

Abonnementen en aankopen, met verlengingen, terugbetalingen, respijtperiodes en afloopJa, opgehaald bij Apple en Google
Wie welke aankoop bezitJa, uit de export van RevenueCat
App-user-ID's, ook anoniemeJa, ongewijzigd
Klantattributen ($email, $displayName en je eigen attributen)Ja, uit een Audience export
Producten, entitlements en offeringsJe maakt ze opnieuw aan, met dezelfde identifiers
Grafiekgeschiedenis van vóór de overstapDeels: bewaar de grafiek-CSV's van RevenueCat voor je administratie
Paywalls, experimenten, integraties, Customer CenterNee: openpurr heeft ze niet
FAQ

FAQ over migreren van RevenueCat

Moet ik mijn aankoopcode aanpassen?

Nee. openpurr werkt met de officiële, ongewijzigde RevenueCat Purchases SDK. De app-update voegt de proxy-URL toe vóór configure, plus een eenmalige aanroep van syncPurchases. getOfferings, purchase, restorePurchases, logIn en de rest blijven zoals ze zijn.

Heb ik de hulp van RevenueCat nodig om over te stappen?

Voor apps in de App Store niet: de Scheduled Data Export van RevenueCat bevat de transactie-ID's die openpurr nodig heeft. Voor Google Play wel: volgens de documentatie van RevenueCat bevat alleen een migratie-export die RevenueCat Support voorbereidt de aankooptokens die Google vereist.

Hoe zit het met klanten die de app nooit updaten?

De import dekt hen: hun aankopen worden opgehaald bij Apple en Google en gekoppeld aan dezelfde app-user-ID's. Zolang ze nog een oude appversie gebruiken, praat die versie met RevenueCat. Daarom blijven beide backends op de hoogte tot de meeste mensen hebben geüpdatet.

Hoe lang duurt een import?

Elke klant kost ongeveer 30 schrijfacties naar databaserijen. Op het gratis abonnement van Cloudflare zijn dat ongeveer 2.500 klanten per dag, en de import pauzeert zichzelf bij de daglimiet en gaat de volgende dag verder. Met Workers Paid ($ 5 per maand) duurt een grote import een paar uur.

Worden mijn gegevens gekopieerd uit RevenueCat?

Alleen de koppeling tussen app-users en store-aankopen, plus attributen als je die importeert. De aankopen zelf komen rechtstreeks van Apple en Google, dus openpurr legt de actuele stand van de stores vast, inclusief verlengingen en terugbetalingen.

Klaar om over te stappen?

De handleiding loopt elke stap met je door. Past iets in je setup niet, open dan een issue: migraties bepalen mee wat er hierna wordt gebouwd.