Panduan migrasi

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 syncPurchases satu kali. Sisa kode pembelian Anda tetap sama.
  • openpurr import memindahkan 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 kerjanya

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.

Di aplikasi Anda

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) }
  }
}
Impor

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

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

Langkah demi langkah

Cara migrasi dari RevenueCat dalam tujuh langkah

Kedua backend tetap berjalan sampai Anda siap beralih, sehingga pelanggan di versi aplikasi lama tetap memiliki akses.

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

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

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

  4. Impor

    Jalankan openpurr import, dengan dry run terlebih dahulu. Masalah pada baris tertentu masuk ke laporan dan tidak menghentikan impor.

  5. Rilis update aplikasi

    Tambahkan URL proxy dan syncPurchases satu kali. Rilis setelah impor selesai.

  6. Periksa

    openpurr doctor memeriksa setup. Cari pelanggan yang Anda kenal, dan bandingkan langganan aktif dengan grafik RevenueCat.

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

Apa yang ikut pindah dari RevenueCat, dan apa yang tidak

Langganan dan pembelian, beserta perpanjangan, pengembalian dana, masa tenggang, dan kedaluwarsaYa, diambil dari Apple dan Google
Siapa pemilik setiap pembelianYa, dari ekspor RevenueCat
App user ID, termasuk yang anonimYa, tanpa perubahan
Atribut pelanggan ($email, $displayName, dan atribut Anda sendiri)Ya, dari Audience export
Produk, entitlement, dan offeringAnda membuatnya ulang, dengan identifier yang sama
Riwayat grafik sebelum peralihanSebagian: simpan CSV grafik RevenueCat sebagai arsip Anda
Paywall, eksperimen, integrasi, Customer CenterTidak: openpurr tidak memilikinya
FAQ

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.