Pindah dari RevenueCat ke openpurr tanpa kehilangan satu pelanggan pun
Tetap pakai Purchases SDK yang sudah digunakan aplikasi Anda. Impor pelanggan yang sudah ada dari ekspor RevenueCat: openpurr mengambil sendiri setiap pembelian dari Apple dan Google. Versi aplikasi lama tetap berfungsi selama pengguna memperbarui aplikasi.
Diperbarui
Ringkasnya
- openpurr adalah alternatif RevenueCat open source yang di-host sendiri. openpurr bekerja dengan RevenueCat Purchases SDK resmi tanpa modifikasi.
- Aplikasi Anda menambahkan satu baris (URL proxy SDK) dan satu panggilan
syncPurchasessatu kali. Sisa kode pembelian Anda tetap sama. openpurr importmemindahkan pelanggan yang sudah ada dari ekspor RevenueCat. Pembeliannya sendiri diambil dari Apple dan Google, bukan disalin.- Aplikasi App Store bisa memakai Scheduled Data Export dari RevenueCat. Google Play membutuhkan ekspor migrasi dari RevenueCat Support, satu-satunya ekspor yang berisi purchase token.
- Kedua backend tetap terbarui sampai sebagian besar pengguna sudah memperbarui aplikasi, sehingga tidak ada yang kehilangan akses.
- Di paket gratis Cloudflare, impor menangani sekitar 2.500 pelanggan per hari. Di Workers Paid, impor besar selesai dalam hitungan jam.
Cara kerja migrasi dari RevenueCat
openpurr tidak menyalin catatan pembelian dari RevenueCat. openpurr hanya perlu tahu siapa pemilik setiap pembelian, lalu bertanya ke store, persis seperti saat aplikasi Anda mengirim pembelian.
Impor
Ekspor RevenueCat menunjukkan app user mana yang memiliki pembelian store yang mana. openpurr import menanyakan setiap pembelian ke Apple dan Google, lalu mencatat jawaban store untuk pengguna tersebut. Semua pelanggan dipindahkan sekaligus, termasuk mereka yang tidak pernah membuka aplikasi lagi.
Update aplikasi
Versi baru mengarahkan Purchases SDK ke openpurr dan mengirim pembelian setiap pelanggan satu kali dengan syncPurchases. Cara ini menjangkau siapa pun yang terlewat oleh ekspor, dan siapa pun yang membeli setelah ekspor dibuat.
Dua backend, untuk sementara
Versi aplikasi lama tetap berkomunikasi dengan RevenueCat sampai pengguna memperbarui aplikasi. RevenueCat meneruskan notifikasi Apple ke openpurr, dan subscription Pub/Sub kedua melakukan hal yang sama untuk Google, sehingga keduanya tetap terbarui.
Apa yang berubah di aplikasi Anda
Atur URL proxy sebelum configure, dan kirim pembelian setiap pelanggan satu kali. Dua perubahan yang sama berlaku di Android, Flutter, dan React Native; panduan berisi kode untuk masing-masing.
// Sebelum configure(): satu-satunya baris yang ditambahkan kebanyakan aplikasi
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")
// Sekali per instalasi: kirim pembelian pelanggan ini ke 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) }
}
}Mengimpor pelanggan dari RevenueCat
CLI openpurr membaca kolom RevenueCat apa adanya: app user ID, ID transaksi App Store, purchase token Google Play, dan atribut seperti $email.
npm install -g @openpurr/cli
openpurr login --url https://<your back office>
# Cek baris pertama: bertanya ke Apple dan Google, tidak menulis apa pun
openpurr import revenuecat-export.csv --dry-run --limit 50
# Impor semua. Hentikan kapan saja; jalankan lagi untuk melanjutkan.
openpurr import revenuecat-export.csvTidak ada yang kehilangan akses
Pembelian yang sudah dikirim aplikasi untuk seorang pelanggan tetap menjadi miliknya; impor tidak pernah memindahkannya.
Tidak ada webhook ganda
Pembelian yang diimpor bukan pembelian baru, jadi openpurr tidak mengirim event untuknya.
Grafik yang jujur
Pelanggan yang diimpor diberi tanggal sesuai pembelian pertamanya, bukan dihitung sebagai pelanggan baru pada hari impor.
Aplikasi Anda tetap berjalan
Di paket gratis Cloudflare, impor berhenti di 90% batas harian dan melanjutkan keesokan harinya.
Hentikan dan lanjutkan
Progres disimpan. Mengimpor baris yang sama dua kali tidak mengubah apa pun, jadi ekspor yang lebih baru bisa dijalankan lagi.
Coba dulu
Dry run bertanya ke store dan melaporkan apa yang akan terjadi, tanpa menulis apa pun.
Cara migrasi dari RevenueCat dalam tujuh langkah
Kedua backend tetap berjalan sampai Anda siap beralih, sehingga pelanggan di versi aplikasi lama tetap memiliki akses.
Siapkan openpurr
Deploy openpurr Lite ke akun Cloudflare Anda, berikan akses API App Store dan Google Play, lalu buat ulang produk, entitlement, dan offering Anda dengan identifier yang sama. Anda bahkan bisa tetap memakai public SDK key RevenueCat Anda.
Jaga kedua backend tetap terbarui
Atur openpurr sebagai Apple Server Notification Forwarding URL di RevenueCat, dan tambahkan push subscription openpurr ke topik notifikasi Play Anda.
Sumber: RevenueCat: notifikasi server Apple (bahasa Inggris)
Dapatkan ekspor Anda
Khusus App Store: Scheduled Data Export dari RevenueCat sudah berisi yang dibutuhkan. Untuk Google Play, minta ekspor migrasi ke RevenueCat Support, karena hanya ekspor itu yang berisi purchase token. Panduan berisi contoh permintaan yang bisa Anda salin.
Sumber: RevenueCat: mengekspor data atau bermigrasi (bahasa Inggris)
Impor
Jalankan
openpurr import, dengan dry run terlebih dahulu. Masalah pada baris tertentu masuk ke laporan dan tidak menghentikan impor.Rilis update aplikasi
Tambahkan URL proxy dan
syncPurchasessatu kali. Rilis setelah impor selesai.Periksa
openpurr doctormemeriksa setup. Cari pelanggan yang Anda kenal, dan bandingkan langganan aktif dengan grafik RevenueCat.Selesaikan peralihan
Setelah sebagian besar pelanggan memperbarui aplikasi, arahkan Apple dan Google langsung ke openpurr, aktifkan webhook openpurr, dan matikan webhook RevenueCat.
Semua perintah dan pengaturan ada di panduan lengkap (bahasa Inggris) →
Apa yang ikut pindah dari RevenueCat, dan apa yang tidak
| Langganan dan pembelian, beserta perpanjangan, pengembalian dana, masa tenggang, dan kedaluwarsa | Ya, diambil dari Apple dan Google |
|---|---|
| Siapa pemilik setiap pembelian | Ya, dari ekspor RevenueCat |
| App user ID, termasuk yang anonim | Ya, tanpa perubahan |
| Atribut pelanggan ($email, $displayName, dan atribut Anda sendiri) | Ya, dari Audience export |
| Produk, entitlement, dan offering | Anda membuatnya ulang, dengan identifier yang sama |
| Riwayat grafik sebelum peralihan | Sebagian: simpan CSV grafik RevenueCat sebagai arsip Anda |
| Paywall, eksperimen, integrasi, Customer Center | Tidak: openpurr tidak memilikinya |
FAQ migrasi dari RevenueCat
Apakah saya harus mengubah kode pembelian saya?
Tidak. openpurr bekerja dengan RevenueCat Purchases SDK resmi tanpa modifikasi. Update aplikasi menambahkan URL proxy sebelum configure, dan satu panggilan syncPurchases satu kali. getOfferings, purchase, restorePurchases, logIn, dan lainnya tetap seperti semula.
Apakah saya butuh bantuan RevenueCat untuk migrasi?
Untuk aplikasi App Store, tidak: Scheduled Data Export dari RevenueCat sudah berisi ID transaksi yang dibutuhkan openpurr. Untuk Google Play, ya: menurut dokumentasi RevenueCat, hanya ekspor migrasi yang disiapkan oleh RevenueCat Support yang berisi purchase token yang dibutuhkan Google.
Bagaimana dengan pelanggan yang tidak pernah memperbarui aplikasi?
Impor mencakup mereka: pembelian mereka diambil dari Apple dan Google dan diberikan ke app user ID yang sama. Selama mereka masih memakai versi aplikasi lama, versi tersebut berkomunikasi dengan RevenueCat, karena itulah kedua backend tetap terbarui sampai sebagian besar pengguna memperbarui aplikasi.
Berapa lama proses impor?
Setiap pelanggan membutuhkan sekitar 30 penulisan baris database. Di paket gratis Cloudflare, itu berarti sekitar 2.500 pelanggan per hari, dan impor berhenti sendiri di batas harian lalu melanjutkan keesokan harinya. Di Workers Paid ($5 per bulan), impor besar selesai dalam hitungan jam.
Apakah data saya disalin dari RevenueCat?
Hanya pemetaan app user ke pembelian store, ditambah atribut jika Anda mengimpornya. Pembeliannya sendiri datang langsung dari Apple dan Google, sehingga openpurr mencatat kondisi terkini menurut store, termasuk perpanjangan dan pengembalian dana.
Siap beralih?
Panduan ini membahas setiap langkah. Jika ada bagian setup Anda yang tidak cocok, buka issue: migrasi menentukan apa yang dibangun berikutnya.
