Migration guide

बिना कोई subscriber खोए RevenueCat से openpurr पर जाएँ

आपका app जो Purchases SDK पहले से इस्तेमाल करता है, वही रखें। अपने मौजूदा ग्राहकों को RevenueCat के export से import करें: openpurr हर purchase Apple और Google से ख़ुद लाता है। जब तक लोग app update करते हैं, पुराने app versions चलते रहते हैं।

अपडेट:

संक्षेप में

  • openpurr, RevenueCat का self-hosted, open-source विकल्प है। यह आधिकारिक, बिना बदलाव वाले RevenueCat Purchases SDK के साथ काम करता है।
  • आपका app एक line (SDK का proxy URL) और एक बार का syncPurchases call जोड़ता है। बाक़ी purchase code वैसा ही रहता है।
  • openpurr import मौजूदा ग्राहकों को RevenueCat के export से लाता है। Purchases ख़ुद Apple और Google से लाई जाती हैं, copy नहीं की जातीं।
  • App Store apps, RevenueCat का Scheduled Data Export इस्तेमाल कर सकते हैं। Google Play के लिए RevenueCat Support से migration export चाहिए, क्योंकि सिर्फ़ उसी में purchase tokens होते हैं।
  • जब तक ज़्यादातर लोग app update नहीं कर लेते, दोनों backends up to date रहते हैं, इसलिए किसी का access नहीं जाता।
  • Cloudflare के free plan पर import रोज़ लगभग 2,500 ग्राहक handle करता है। Workers Paid पर बड़े import में कुछ घंटे लगते हैं।
यह कैसे काम करता है

RevenueCat migration कैसे काम करता है

openpurr, RevenueCat से purchase records copy नहीं करता। उसे बस यह जानना होता है कि कौन-सी purchase किसकी है, फिर वह stores से पूछता है, ठीक वैसे ही जैसे तब करता है जब आपका app कोई purchase भेजता है।

Import

RevenueCat का export बताता है कि कौन-सी store purchase किस app user की है। openpurr import हर purchase के बारे में Apple और Google से पूछता है और store का जवाब उस user के लिए record करता है। यह सबको एक साथ ले आता है, उन लोगों को भी जो app दोबारा कभी नहीं खोलेंगे।

App update

नया version, Purchases SDK को openpurr पर point करता है और syncPurchases से हर ग्राहक की purchases एक बार भेजता है। इससे वे लोग भी आ जाते हैं जो export में छूट गए, और वे भी जिन्होंने export बनने के बाद ख़रीदा।

कुछ समय तक दोनों backends

पुराने app versions तब तक RevenueCat से बात करते रहते हैं जब तक लोग update नहीं करते। RevenueCat, Apple के notifications openpurr को forward करता है, और एक दूसरा Pub/Sub subscription Google के लिए यही करता है, इसलिए दोनों up to date रहते हैं।

आपके app में

आपके app में क्या बदलता है

configure से पहले proxy URL set करें, और हर ग्राहक की purchases एक बार भेजें। यही दो बदलाव Android, Flutter और React Native पर भी काम करते हैं; guide में हर एक का code है।

// configure() से पहले: ज़्यादातर apps बस यही line जोड़ते हैं
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")

// हर install पर एक बार: इस ग्राहक की purchases 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

RevenueCat से ग्राहकों को import करना

openpurr CLI, RevenueCat के columns को जैसे हैं वैसे ही पढ़ता है: app user IDs, App Store transaction IDs, Google Play purchase tokens, और $email जैसे attributes।

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

# पहली rows जाँचें: Apple और Google से पूछता है, कुछ नहीं लिखता
openpurr import revenuecat-export.csv --dry-run --limit 50

# सबको import करें। कभी भी रोकें; आगे बढ़ाने के लिए फिर चलाएँ।
openpurr import revenuecat-export.csv

किसी का access नहीं जाता

जो purchase app किसी ग्राहक के लिए पहले ही भेज चुका है, वह उसी की रहती है; import उसे कभी नहीं हटाता।

कोई duplicate webhooks नहीं

Import की गई purchases नई नहीं हैं, इसलिए openpurr उनके लिए कोई events नहीं भेजता।

सही charts

Import किए गए ग्राहकों की तारीख़ उनकी पहली purchase से गिनी जाती है, उन्हें import वाले दिन नए ग्राहक नहीं गिना जाता।

आपका app चलता रहता है

Cloudflare के free plan पर import, daily limit के 90% पर रुक जाता है और अगले दिन फिर शुरू होता है।

रोकें और फिर शुरू करें

Progress save रहती है। किसी row को दो बार import करने से कुछ नहीं बदलता, इसलिए नया export फिर से चलाया जा सकता है।

पहले आज़माएँ

Dry run, stores से पूछता है और बताता है कि क्या होगा, बिना कुछ लिखे।

Step by step

सात steps में RevenueCat से माइग्रेट कैसे करें

जब तक आप switch करने के लिए तैयार नहीं होते, दोनों backends चलते रहते हैं, इसलिए पुराने app versions वाले ग्राहकों का access बना रहता है।

  1. openpurr set up करें

    openpurr Lite को अपने Cloudflare account पर deploy करें, उसे App Store और Google Play API access दें, और अपने products, entitlements और offerings उन्हीं identifiers के साथ दोबारा बनाएँ। आप चाहें तो अपनी RevenueCat public SDK keys भी रख सकते हैं।

  2. दोनों backends को जानकारी मिलती रहे

    openpurr को RevenueCat के Apple Server Notification Forwarding URL के रूप में set करें, और openpurr का push subscription अपने Play notifications topic में जोड़ें।

    Source: RevenueCat: Apple server notifications (अंग्रेज़ी में)

  3. अपना export लें

    सिर्फ़ App Store: RevenueCat के Scheduled Data Export में ज़रूरी सब कुछ है। Google Play के साथ, RevenueCat Support से migration export माँगें, क्योंकि सिर्फ़ उसी में purchase tokens होते हैं। Guide में एक request है जिसे आप copy कर सकते हैं।

    Source: RevenueCat: data export करना या migrate करना (अंग्रेज़ी में)

  4. Import करें

    openpurr import चलाएँ, पहले एक dry run के साथ। अलग-अलग rows की समस्याएँ एक report में जाती हैं और import नहीं रोकतीं।

  5. App update ship करें

    Proxy URL और एक बार का syncPurchases जोड़ें। Import पूरा होने के बाद इसे release करें।

  6. जाँचें

    openpurr doctor setup जाँचता है। जिन ग्राहकों को आप जानते हैं उन्हें खोजें, और active subscriptions की तुलना RevenueCat के charts से करें।

  7. Switch पूरा करें

    जब ज़्यादातर ग्राहक update कर लें, तो Apple और Google को सीधे openpurr पर point करें, openpurr के webhooks चालू करें और RevenueCat के बंद करें।

हर command और setting पूरी guide में है (अंग्रेज़ी में) →

क्या आता है

RevenueCat से क्या आता है, और क्या नहीं

Subscriptions और purchases, renewals, refunds, grace periods और expiry के साथहाँ, Apple और Google से लाई जाती हैं
कौन-सी purchase किसकी हैहाँ, RevenueCat के export से
App user IDs, anonymous IDs समेतहाँ, बिना बदलाव के
Customer attributes ($email, $displayName और आपके अपने)हाँ, Audience export से
Products, entitlements और offeringsआप इन्हें उन्हीं identifiers के साथ दोबारा बनाते हैं
Switch से पहले की chart historyआंशिक रूप से: अपने records के लिए RevenueCat के chart CSVs रख लें
Paywalls, experiments, integrations, Customer Centerनहीं: ये openpurr में नहीं हैं
FAQ

RevenueCat migration FAQ

क्या मुझे अपना purchase code बदलना होगा?

नहीं। openpurr आधिकारिक, बिना बदलाव वाले RevenueCat Purchases SDK के साथ काम करता है। App update में configure से पहले proxy URL और एक बार का syncPurchases call जुड़ता है। getOfferings, purchase, restorePurchases, logIn और बाक़ी सब वैसे ही रहते हैं।

क्या माइग्रेट करने के लिए मुझे RevenueCat की मदद चाहिए?

App Store apps के लिए नहीं: RevenueCat के Scheduled Data Export में वे transaction IDs होते हैं जिनकी openpurr को ज़रूरत है। Google Play के लिए हाँ: RevenueCat के documentation के अनुसार, Google को जिन purchase tokens की ज़रूरत होती है, वे सिर्फ़ RevenueCat Support के तैयार किए migration export में होते हैं।

उन ग्राहकों का क्या जो कभी app update नहीं करते?

Import उन्हें cover करता है: उनकी purchases Apple और Google से लाकर उन्हीं app user IDs को दी जाती हैं। जब तक वे पुराने app version पर हैं, वह version RevenueCat से बात करता है, इसीलिए ज़्यादातर लोगों के update करने तक दोनों backends को जानकारी मिलती रहती है।

Import में कितना समय लगता है?

हर ग्राहक के लिए database में लगभग 30 row writes होते हैं। Cloudflare के free plan पर इसका मतलब है रोज़ लगभग 2,500 ग्राहक, और import daily limit पर अपने आप रुक जाता है और अगले दिन फिर शुरू होता है। Workers Paid ($5 प्रति माह) पर बड़े import में कुछ घंटे लगते हैं।

क्या मेरा data RevenueCat से copy होता है?

सिर्फ़ app users और store purchases की mapping, और अगर आप import करें तो attributes। Purchases ख़ुद सीधे Apple और Google से आती हैं, इसलिए openpurr stores की मौजूदा सही स्थिति record करता है, renewals और refunds समेत।

Switch करने के लिए तैयार हैं?

Guide हर step समझाती है। अगर आपके setup में कुछ फ़िट नहीं बैठता, तो issue खोलें: migrations से तय होता है कि आगे क्या बनेगा।