انتقل من RevenueCat إلى openpurr دون أن تخسر أي مشترك
احتفظ بـ Purchases SDK الذي يستخدمه تطبيقك أصلًا. استورد عملاءك الحاليين من ملف تصدير RevenueCat: يجلب openpurr كل عملية شراء من Apple وGoogle بنفسه. وتبقى إصدارات التطبيق القديمة تعمل ريثما يحدّث المستخدمون التطبيق.
آخر تحديث:
باختصار
- openpurr بديل لـ RevenueCat مستضاف ذاتيًا ومفتوح المصدر. يعمل مع Purchases SDK الرسمي من RevenueCat دون أي تعديل.
- يضيف تطبيقك سطرًا واحدًا (رابط الوكيل في SDK) واستدعاءً واحدًا لـ
syncPurchases. ويبقى باقي كود الشراء كما هو. - ينقل
openpurr importالعملاء الحاليين من ملف تصدير RevenueCat. أما عمليات الشراء نفسها فتُجلب من Apple وGoogle، ولا تُنسخ. - يمكن لتطبيقات App Store استخدام Scheduled Data Export من RevenueCat. أما Google Play فيحتاج إلى ملف تصدير للانتقال من فريق دعم RevenueCat، فهو الوحيد الذي يتضمن رموز الشراء (purchase tokens).
- تبقى الواجهتان الخلفيتان محدّثتين حتى يحدّث معظم المستخدمين التطبيق، فلا يفقد أحد إمكانية الوصول.
- على الخطة المجانية من Cloudflare، يعالج الاستيراد نحو 2,500 عميل يوميًا. وعلى Workers Paid، يستغرق الاستيراد الكبير بضع ساعات.
كيف يعمل الانتقال من RevenueCat
لا ينسخ openpurr سجلات الشراء من RevenueCat. كل ما يحتاج إليه هو معرفة من يملك كل عملية شراء، ثم يسأل المتاجر، تمامًا كما يفعل عندما يرسل تطبيقك عملية شراء.
الاستيراد
يحدد ملف تصدير RevenueCat أي مستخدم في التطبيق يملك كل عملية شراء في المتجر. يسأل openpurr import شركتي Apple وGoogle عن كل عملية شراء، ويسجّل إجابة المتجر لذلك المستخدم. وينقل الجميع دفعة واحدة، بمن فيهم من لن يفتحوا التطبيق مرة أخرى.
تحديث التطبيق
يوجّه الإصدار الجديد Purchases SDK إلى openpurr، ويرسل عمليات شراء كل عميل مرة واحدة باستخدام syncPurchases. وبذلك يلتقط كل من فاته ملف التصدير، وكل من اشترى بعد إنشائه.
الواجهتان الخلفيتان معًا، لفترة
تواصل إصدارات التطبيق القديمة الاتصال بـ RevenueCat حتى يحدّث المستخدمون التطبيق. يعيد RevenueCat توجيه إشعارات Apple إلى openpurr، ويفعل اشتراك Pub/Sub ثانٍ الشيء نفسه مع Google، فتبقى الواجهتان محدّثتين.
ما الذي يتغيّر في تطبيقك
اضبط رابط الوكيل (proxy URL) قبل configure، وأرسل عمليات شراء كل عميل مرة واحدة. يصلح هذان التغييران أنفسهما على Android وFlutter وReact Native، والدليل يتضمن الكود لكل منها.
// قبل configure(): السطر الوحيد الذي تضيفه معظم التطبيقات
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")
// مرة لكل تثبيت: أرسل مشتريات هذا العميل إلى 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) }
}
}استيراد العملاء من RevenueCat
تقرأ أداة openpurr CLI أعمدة RevenueCat كما هي: معرّفات مستخدمي التطبيق، ومعرّفات معاملات App Store، ورموز الشراء في Google Play، والسمات مثل $email.
npm install -g @openpurr/cli
openpurr login --url https://<your back office>
# افحص الصفوف الأولى: يسأل Apple وGoogle ولا يكتب شيئًا
openpurr import revenuecat-export.csv --dry-run --limit 50
# استورد الجميع. أوقفه متى شئت، وشغّله مجددًا ليكمل.
openpurr import revenuecat-export.csvلا يفقد أحد إمكانية الوصول
عملية الشراء التي أرسلها التطبيق لعميل ما تبقى له، ولا ينقلها الاستيراد أبدًا.
لا webhooks مكررة
عمليات الشراء المستوردة ليست جديدة، لذا لا يرسل openpurr أي أحداث بشأنها.
مخططات صادقة
يُؤرَّخ العملاء المستوردون بتاريخ أول عملية شراء لهم، ولا يُحتسبون عملاء جددًا يوم الاستيراد.
يبقى تطبيقك يعمل
على الخطة المجانية من Cloudflare، يتوقف الاستيراد عند 90% من الحد اليومي ويكمل في اليوم التالي.
الإيقاف والاستئناف
يُحفظ التقدم. استيراد الصف مرتين لا يغيّر شيئًا، لذا يمكن تشغيل ملف تصدير أحدث مجددًا.
جرّبه أولًا
التشغيل التجريبي يسأل المتاجر ويعرض ما سيحدث، دون أن يكتب شيئًا.
كيفية الانتقال من RevenueCat في سبع خطوات
تبقى الواجهتان الخلفيتان تعملان حتى تكون مستعدًا للتبديل، فيحتفظ العملاء على إصدارات التطبيق القديمة بإمكانية الوصول.
أعدّ openpurr
انشر openpurr Lite على حسابك في Cloudflare، وامنحه صلاحية الوصول إلى واجهات API في App Store وGoogle Play، وأعد إنشاء منتجاتك واستحقاقاتك (entitlements) وعروضك (offerings) بالمعرّفات نفسها. يمكنك حتى الاحتفاظ بمفاتيح SDK العامة من RevenueCat.
أبقِ الواجهتين الخلفيتين على اطلاع
اضبط openpurr ليكون Apple Server Notification Forwarding URL في RevenueCat، وأضف اشتراك الدفع (push subscription) الخاص بـ openpurr إلى موضوع إشعارات Play لديك.
احصل على ملف التصدير
لتطبيقات App Store فقط: يتضمن Scheduled Data Export من RevenueCat كل ما يلزم. أما مع Google Play، فاطلب من فريق دعم RevenueCat ملف تصدير للانتقال، لأنه وحده يتضمن رموز الشراء. والدليل يتضمن نص طلب يمكنك نسخه.
المصدر: RevenueCat: تصدير البيانات أو الانتقال إلى خدمة أخرى (بالإنجليزية)
الاستيراد
شغّل
openpurr import، مع تشغيل تجريبي أولًا. تُسجَّل مشكلات الصفوف المفردة في تقرير، ولا توقف الاستيراد.أصدر تحديث التطبيق
أضف رابط الوكيل واستدعاءً واحدًا لـ
syncPurchases. وأصدره بعد انتهاء الاستيراد.التحقق
يفحص
openpurr doctorالإعداد. ابحث عن عملاء تعرفهم، وقارن الاشتراكات النشطة بمخططات RevenueCat.أكمل التبديل
بعد أن يحدّث معظم العملاء التطبيق، وجّه Apple وGoogle مباشرة إلى openpurr، وفعّل webhooks في openpurr، وأوقف webhooks في RevenueCat.
ما الذي ينتقل من RevenueCat، وما الذي لا ينتقل
| الاشتراكات وعمليات الشراء، مع التجديدات والمبالغ المستردة وفترات السماح وانتهاء الصلاحية | نعم، تُجلب من Apple وGoogle |
|---|---|
| من يملك كل عملية شراء | نعم، من ملف تصدير RevenueCat |
| معرّفات مستخدمي التطبيق، بما فيها المجهولة | نعم، دون تغيير |
| سمات العملاء ($email و$displayName وسماتك الخاصة) | نعم، من Audience export |
| المنتجات والاستحقاقات والعروض | تعيد إنشاءها بالمعرّفات نفسها |
| سجل المخططات قبل التبديل | جزئيًا: احتفظ بملفات CSV لمخططات RevenueCat في سجلاتك |
| شاشات الدفع، والتجارب، والتكاملات، وCustomer Center | لا: هذه غير متوفرة في openpurr |
أسئلة شائعة عن الانتقال من RevenueCat
هل عليّ تغيير كود الشراء؟
لا. يعمل openpurr مع Purchases SDK الرسمي من RevenueCat دون أي تعديل. يضيف تحديث التطبيق رابط الوكيل قبل configure، واستدعاءً واحدًا لـ syncPurchases. أما getOfferings وpurchase وrestorePurchases وlogIn وغيرها فتبقى كما هي.
هل أحتاج إلى مساعدة RevenueCat للانتقال؟
لتطبيقات App Store، لا: يتضمن Scheduled Data Export من RevenueCat معرّفات المعاملات التي يحتاج إليها openpurr. أما لتطبيقات Google Play، فنعم: وفقًا لوثائق RevenueCat، لا يتضمن رموز الشراء التي تطلبها Google إلا ملف تصدير للانتقال يعدّه فريق دعم RevenueCat.
ماذا عن العملاء الذين لا يحدّثون التطبيق أبدًا؟
يشملهم الاستيراد: تُجلب عمليات شرائهم من Apple وGoogle وتُربط بمعرّفات مستخدمي التطبيق نفسها. وما داموا على إصدار قديم من التطبيق، فإن ذلك الإصدار يتواصل مع RevenueCat، ولهذا تبقى الواجهتان الخلفيتان على اطلاع حتى يحدّث معظم المستخدمين التطبيق.
كم يستغرق الاستيراد؟
يتطلب كل عميل نحو 30 عملية كتابة لصفوف قاعدة البيانات. على الخطة المجانية من Cloudflare، يعني ذلك نحو 2,500 عميل يوميًا، ويتوقف الاستيراد تلقائيًا عند الحد اليومي ويستأنف في اليوم التالي. وعلى Workers Paid (بسعر 5 دولارات شهريًا)، يستغرق الاستيراد الكبير بضع ساعات.
هل تُنسخ بياناتي من RevenueCat؟
لا يُنسخ إلا الربط بين مستخدمي التطبيق وعمليات الشراء في المتاجر، إضافة إلى السمات إذا استوردتها. أما عمليات الشراء نفسها فتأتي مباشرة من Apple وGoogle، فيسجّل openpurr الحالة الفعلية الحالية لدى المتاجر، بما فيها التجديدات والمبالغ المستردة.
هل أنت مستعد للانتقال؟
يشرح الدليل كل خطوة. وإذا كان في إعدادك ما لا يتوافق معه، فافتح issue: فعمليات الانتقال تحدد ما سيُبنى بعد ذلك.
