Passa da RevenueCat a openpurr senza perdere nessun abbonato
Tieni il Purchases SDK che la tua app usa già. Importa i clienti esistenti dall'export di RevenueCat: openpurr recupera da sé ogni acquisto da Apple e Google. Le vecchie versioni dell'app continuano a funzionare mentre gli utenti aggiornano.
Aggiornato il
In breve
- openpurr è un'alternativa a RevenueCat open source e self-hosted. Funziona con il Purchases SDK ufficiale di RevenueCat, senza modifiche.
- La tua app aggiunge una riga (l'URL del proxy dell'SDK) e una chiamata a
syncPurchasesda fare una sola volta. Il resto del codice di acquisto resta uguale. openpurr importporta i clienti esistenti dall'export di RevenueCat. Gli acquisti veri e propri vengono recuperati da Apple e Google, non copiati.- Le app dell'App Store possono usare lo Scheduled Data Export di RevenueCat. Per Google Play serve un export per la migrazione dal supporto di RevenueCat, l'unico che contiene i token di acquisto.
- Entrambi i backend restano aggiornati finché la maggior parte degli utenti non ha aggiornato l'app, così nessuno perde l'accesso.
- Con il piano gratuito di Cloudflare, l'import gestisce circa 2.500 clienti al giorno. Con Workers Paid, un import grande richiede qualche ora.
Come funziona una migrazione da RevenueCat
openpurr non copia i record degli acquisti da RevenueCat. Gli basta sapere chi possiede quale acquisto, poi interroga gli store, esattamente come quando la tua app invia un acquisto.
L'import
L'export di RevenueCat dice quale utente dell'app possiede quale acquisto sugli store. openpurr import chiede ad Apple e Google ogni acquisto e registra la risposta dello store per quell'utente. Porta tutti in una volta, comprese le persone che non apriranno mai più l'app.
L'aggiornamento dell'app
La nuova versione punta il Purchases SDK a openpurr e invia una volta gli acquisti di ogni cliente con syncPurchases. Così recupera chi mancava nell'export e chi ha acquistato dopo la sua creazione.
Entrambi i backend, per un po'
Le vecchie versioni dell'app continuano a parlare con RevenueCat finché gli utenti non aggiornano. RevenueCat inoltra a openpurr le notifiche di Apple, e una seconda sottoscrizione Pub/Sub fa lo stesso per Google, così entrambi restano aggiornati.
Cosa cambia nella tua app
Imposta l'URL del proxy prima di configure e invia una volta gli acquisti di ogni cliente. Le stesse due modifiche valgono per Android, Flutter e React Native; la guida ha il codice per ciascuno.
// Prima di configure(): l'unica riga che quasi tutte le app aggiungono
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")
// Una volta per installazione: invia a openpurr gli acquisti del cliente
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
Purchases.shared.syncPurchases { _, error in
if error == nil { UserDefaults.standard.set(true, forKey: synced) }
}
}Importare i clienti da RevenueCat
La CLI di openpurr legge le colonne di RevenueCat così come sono: ID utente dell'app, ID transazione dell'App Store, token di acquisto di Google Play e attributi come $email.
npm install -g @openpurr/cli
openpurr login --url https://<your back office>
# Controlla le prime righe: interroga Apple e Google, non scrive nulla
openpurr import revenuecat-export.csv --dry-run --limit 50
# Importa tutti. Fermati quando vuoi; rilancialo per riprendere.
openpurr import revenuecat-export.csvNessuno perde l'accesso
Un acquisto che l'app ha già inviato per un cliente resta suo; l'import non lo sposta mai.
Nessun webhook doppio
Gli acquisti importati non sono nuovi, quindi openpurr non invia eventi per loro.
Grafici fedeli
I clienti importati sono datati dal loro primo acquisto, non contati come nuovi il giorno dell'import.
La tua app continua a funzionare
Con il piano gratuito di Cloudflare, l'import si ferma al 90% di un limite giornaliero e riprende il giorno dopo.
Fermati e riprendi
L'avanzamento viene salvato. Importare due volte una riga non cambia nulla, quindi puoi rilanciare l'import con un export più recente.
Provalo prima
Una prova a vuoto (dry run) interroga gli store e riporta cosa succederebbe, senza scrivere nulla.
Come migrare da RevenueCat in sette passaggi
Entrambi i backend restano attivi finché non sei pronto a passare, così i clienti con versioni vecchie dell'app mantengono l'accesso.
Configura openpurr
Distribuisci openpurr Lite sul tuo account Cloudflare, dagli accesso alle API dell'App Store e di Google Play, e ricrea prodotti, entitlement e offering con gli stessi identificatori. Puoi anche tenere le chiavi SDK pubbliche di RevenueCat.
Tieni informati entrambi i backend
Imposta openpurr come Apple Server Notification Forwarding URL di RevenueCat e aggiungi la sottoscrizione push di openpurr al topic delle notifiche di Play.
Ottieni l'export
Solo App Store: lo Scheduled Data Export di RevenueCat contiene ciò che serve. Con Google Play, chiedi al supporto di RevenueCat un export per la migrazione, perché solo quello contiene i token di acquisto. La guida ha una richiesta che puoi copiare.
Fonte: RevenueCat: esportare i dati o migrare altrove (in inglese)
Importa
Esegui
openpurr import, prima con una prova a vuoto. I problemi sulle singole righe finiscono in un report e non fermano l'import.Pubblica l'aggiornamento dell'app
Aggiungi l'URL del proxy e una chiamata una tantum a
syncPurchases. Pubblicalo quando l'import è finito.Verifica
openpurr doctorcontrolla la configurazione. Cerca clienti che conosci e confronta gli abbonamenti attivi con i grafici di RevenueCat.Completa il passaggio
Quando la maggior parte dei clienti ha aggiornato, punta Apple e Google direttamente a openpurr, attiva i webhook di openpurr e disattiva quelli di RevenueCat.
Ogni comando e impostazione è nella guida completa (in inglese) →
Cosa si sposta da RevenueCat e cosa no
| Abbonamenti e acquisti, con rinnovi, rimborsi, periodi di tolleranza e scadenze | Sì, recuperati da Apple e Google |
|---|---|
| Chi possiede quale acquisto | Sì, dall'export di RevenueCat |
| ID utente dell'app, compresi quelli anonimi | Sì, invariati |
| Attributi dei clienti ($email, $displayName e i tuoi) | Sì, da un Audience export |
| Prodotti, entitlement e offering | Li ricrei tu, con gli stessi identificatori |
| Storico dei grafici prima del passaggio | In parte: conserva i CSV dei grafici di RevenueCat per il tuo archivio |
| Paywall, esperimenti, integrazioni, Customer Center | No: openpurr non li offre |
FAQ sulla migrazione da RevenueCat
Devo cambiare il mio codice di acquisto?
No. openpurr funziona con il Purchases SDK ufficiale di RevenueCat, senza modifiche. L'aggiornamento dell'app aggiunge l'URL del proxy prima di configure e una chiamata una tantum a syncPurchases. getOfferings, purchase, restorePurchases, logIn e il resto restano come sono.
Mi serve l'aiuto di RevenueCat per migrare?
Per le app dell'App Store no: lo Scheduled Data Export di RevenueCat contiene gli ID transazione di cui openpurr ha bisogno. Per Google Play sì: secondo la documentazione di RevenueCat, solo un export per la migrazione preparato dal supporto di RevenueCat include i token di acquisto richiesti da Google.
E i clienti che non aggiornano mai l'app?
L'import copre anche loro: i loro acquisti vengono recuperati da Apple e Google e assegnati agli stessi ID utente dell'app. Finché usano una versione vecchia dell'app, quella versione parla con RevenueCat, ed è per questo che entrambi i backend restano informati finché la maggior parte degli utenti non ha aggiornato.
Quanto dura un import?
Ogni cliente richiede circa 30 scritture di righe nel database. Con il piano gratuito di Cloudflare sono circa 2.500 clienti al giorno, e l'import si mette in pausa da solo al limite giornaliero e riprende il giorno dopo. Con Workers Paid (5 $ al mese), un import grande richiede qualche ora.
I miei dati vengono copiati da RevenueCat?
Viene copiata solo la corrispondenza tra utenti dell'app e acquisti sugli store, più gli attributi se li importi. Gli acquisti veri e propri arrivano direttamente da Apple e Google, quindi openpurr registra lo stato attuale degli store, rinnovi e rimborsi compresi.
Pronto a passare?
La guida spiega ogni passaggio. Se qualcosa nella tua configurazione non torna, apri una issue: le migrazioni influenzano cosa verrà sviluppato dopo.
