RevenueCat: إعداد اشتراك داخل التطبيق على iOS

لماذا تستخدم RevenueCat بدلًا من StoreKit وحده

يتيح لك StoreKit، وهو إطار العمل الخاص بـ Apple، بيع اشتراك دون أي خدمة خارجية. لكن بالنسبة للمبتدئ، كتابة منطق الشراء والاستعادة والتحقق من صلاحيات الوصول بنفسك تعني كمية كبيرة من الكود عليك صيانتها، مع حالات خاصة من السهل نسيانها: تغيير الجهاز، وانتهاء الاشتراك، واسترداد المبلغ.

يقف RevenueCat بين App Store Connect وتطبيقك: يقرأ منتجاتك، ويدير الاشتراكات النشطة، ويعفيك من كتابة هذه الطبقة بنفسك. وتبقى متحكمًا في السعر والعروض من لوحة تحكم، دون إعادة نشر تطبيقك مع كل تغيير.

الخطوة 1: أنشئ منتجاتك في App Store Connect

قبل RevenueCat، يجب أن تكون المنتجات موجودة لدى Apple. في App Store Connect، أنشئ مجموعة اشتراكات، ثم مستوى واحدًا أو أكثر مع مدته، شهري أو سنوي مثلًا، وسعره حسب كل منطقة. املأ أيضًا النصوص التي تظهر للمستخدم لكل مستوى: تطلبها Apple قبل قبول المنتج في المراجعة.

سهو شائع في هذه المرحلة: منتج تم إنشاؤه لكنه لم يُرسل أبدًا مع أول مراجعة للتطبيق ضمن النسخة المرتبطة به. المنتج المعلّق الذي لم يُضمَّن قط في إرسال تطبيق يبقى غير مرئي لمستخدميك، حتى لو كان RevenueCat يراه بالفعل.

الخطوة 2: اربط RevenueCat بتطبيقك

في RevenueCat، تنشئ مشروعًا، وتربط مفتاح API الخاص بـ App Store Connect حتى يزامن RevenueCat منتجاتك تلقائيًا، ثم تعرّف "entitlements"، أي صلاحيات الوصول. يمثّل الـ entitlement ما يفتحه الاشتراك، مثل الوصول الكامل إلى التطبيق، بغض النظر عن المنتج المحدد الذي فعّله.

هذه الطبقة الوسيطة مفيدة: إذا غيّرت بنية عروضك لاحقًا، بإضافة مستوى سنوي مثلًا، فما عليك إلا ربط المنتج الجديد بنفس الـ entitlement، دون لمس الكود الذي يتحقق من الوصول في تطبيقك.

من جهة التطبيق، يُثبَّت SDK الخاص بـ RevenueCat لـ React Native في مشروع Expo عبر plugin مخصص، ويوفر دالة بسيطة لمعرفة ما إذا كان المستخدم الحالي يملك entitlement نشطًا.

الخطوة 3: ابنِ شاشة الدفع (paywall)

الـ paywall هو الشاشة التي تعرض العرض وتطلق عملية الشراء. يقدّم RevenueCat شاشات paywall قابلة للضبط من لوحة التحكم، يمكن تعديلها دون إعادة نشر التطبيق، أو يمكنك بناء شاشتك الخاصة عبر الـ SDK إذا أردت تحكمًا كاملًا في التصميم.

مكان العرض مهم بقدر التصميم. الـ paywall الذي يظهر قبل أن يرى الشخص قيمة التطبيق يحقق عادةً تحويلًا أقل من paywall يظهر مباشرة بعد أول إجراء ناجح. يشرح دليل أخطاء paywall على iOS للمبتدئين أكثر الفخاخ شيوعًا في هذه المرحلة، أبعد من مجرد الربط التقني.

الخطوة 4: اختبر الشراء والاستعادة وانتهاء الاشتراك

هذه هي الخطوة التي تُنجز على عجل في أغلب الأحيان، ومع ذلك هي الأكثر فحصًا من Apple. يجب أن تعمل ثلاثة سيناريوهات قبل الإرسال:

الشراء. باستخدام حساب مختبِر sandbox، يجب أن يفتح الشراء الـ entitlement فورًا، ويجب أن يستجيب تطبيقك لهذا التغيير دون الحاجة إلى إعادة تشغيله.

الاستعادة. على جهاز جديد أو بعد إعادة التثبيت، وبنفس حساب Apple، يجب أن يستعيد زر "Restore Purchases" الاشتراك النشط. تتحقق Apple من هذا المسار في كل مراجعة، وغيابه أو خلله سبب رفض شائع بموجب الإرشاد 3.1.1.

انتهاء الاشتراك. في بيئة sandbox، تنتهي الاشتراكات خلال دقائق بدلًا من عدة أشهر، ما يتيح لك التحقق من أن الوصول يُغلق بشكل صحيح بعد انتهاء المدة، دون انتظار دورة فوترة حقيقية.

ما لا يحل RevenueCat محله

يدير RevenueCat آلية الشراء، لا امتثال صفحة تطبيقك ولا امتثال الـ paywall لـالإرشاد 3.1.2. يبقى عليك دائمًا وصف الاشتراك بشكل صحيح في وصف App Store، وذكر سعره الدقيق ومدته، وإضافة شروط الاستخدام. تساعدك صفحة اشتراك أم شراء لمرة واحدة على iOS على اختيار النموذج المناسب قبل الوصول إلى هذه المرحلة التقنية.

ويأخذ RevenueCat أيضًا عمولة على الإيرادات بعد تجاوز حد شهري معيّن، إضافةً إلى عمولة Apple على الاشتراكات المباعة داخل التطبيق. تحقق من المستويات الحالية على موقعهم قبل بناء نموذجك الاقتصادي على هاتين العمولتين.

أكثر الأخطاء شيوعًا لدى المبتدئين

نسيان حالة التحميل. عند التشغيل، يحتاج RevenueCat لحظة قصيرة لجلب صلاحيات وصول المستخدم. إذا عرض تطبيقك المحتوى المدفوع افتراضيًا قبل هذا الرد، فقد يرى مستخدم بلا اشتراك، للحظة، محتوى لم يدفع ثمنه. خطّط لحالة تحميل صريحة بدلًا من عرض افتراضي متفائل.

التحقق من الصلاحيات في المكان الخطأ. يجب إعادة التحقق من الـ entitlement النشط عند كل فتح لشاشة مدفوعة، لا مرة واحدة فقط عند بدء التشغيل. إذا ألغى المستخدم اشتراكه أو انتهى أثناء استخدامه التطبيق، يجب أن تعكس الشاشة التالية هذا التغيير.

الخلط بين بيئة sandbox وبيئة الإنتاج. معرّفات المنتجات وحسابات المختبِرين في sandbox منفصلة عن بيئة الإنتاج. اختبار ينجح في sandbox بحساب Apple خاطئ، أو منتج أُنشئ في الإنتاج فقط، قد يعطيك انطباعًا خاطئًا بأن كل شيء جاهز.

تطبيق تم التحقق منه، لا مجرد تطبيق يُبنى دون أخطاء

اشتراك "يعمل" في اختبار سريع على حسابك الخاص لا يضمن أنه سيصمد أمام استعادة على جهاز آخر أو انتهاء حقيقي. وهذا بالضبط ما يتحقق منه مراجع Apple. تشرح صفحة الاشتراك داخل التطبيق على iOS هذه السلسلة كاملة، من إنشاء المنتجات حتى التحقق النهائي.

إذا أردت البدء من أساس يحتوي الـ paywall والاشتراكات جاهزة في الكود، فهذا ما يتضمنه كود البداية في iOS Kit. وللتحقق من اشتراكك كما سيفعل المراجع، يجمع Apple Review Kit قائمة التحقق التي أستخدمها قبل الإرسال والملاحظات التي تتركها للمختبِر بخصوص الشراء داخل التطبيق.

الأسئلة الشائعة

كيف أُعدّ اشتراك RevenueCat على iOS؟

في أربع خطوات. أنشئ أولًا منتجاتك في App Store Connect. ثم اربط RevenueCat بمفتاح API الخاص بـ App Store Connect وعرّف الـ entitlements (صلاحيات الوصول)، ثم ابنِ الـ paywall. واختم باختبار الشراء والاستعادة وانتهاء الاشتراك: هذه هي الخطوة التي تُنجز على عجل غالبًا، ومع ذلك تتحقق منها Apple.

هل RevenueCat إلزامي لبيع اشتراك على iOS؟

لا. يتيح لك StoreKit، إطار عمل Apple، بيع اشتراك دون خدمة خارجية. لكنك ستكتب حينها كل منطق الشراء والاستعادة والتحقق من صلاحيات الوصول، مع حالات خاصة من السهل نسيانها: تغيير الجهاز، وانتهاء الاشتراك، واسترداد المبلغ. يقف RevenueCat بين App Store Connect وتطبيقك ليعفيك من هذه الطبقة.

ما هو الـ entitlement في RevenueCat؟

الـ entitlement هو صلاحية وصول: يمثّل ما يفتحه الاشتراك، مثل الوصول الكامل إلى التطبيق، أيًّا كان المنتج المحدد الذي فعّله. إذا أضفت لاحقًا مستوى سنويًا، فما عليك إلا ربط المنتج الجديد بنفس الـ entitlement. لا حاجة لتغيير الكود الذي يتحقق من الوصول في تطبيقك.

كيف أختبر اشتراك RevenueCat قبل إرساله إلى Apple؟

يجب أن تعمل ثلاثة سيناريوهات قبل الإرسال. الشراء: بحساب مختبِر sandbox، يُفتح الوصول فورًا دون إعادة تشغيل التطبيق. الاستعادة: على جهاز جديد أو بعد إعادة التثبيت، وبنفس حساب Apple، يستعيد زر الاستعادة الاشتراك النشط. انتهاء الاشتراك: في sandbox، تنتهي الاشتراكات خلال دقائق، ما يتيح لك التحقق من أن الوصول يُغلق.

لماذا يبقى منتج ظاهر في RevenueCat غير مرئي للمستخدمين؟

غالبًا لأن المنتج لم يُضمَّن قط في إرسال تطبيق. المنتج الذي أُنشئ في App Store Connect لكنه لم يُرسل أبدًا مع أول مراجعة ضمن النسخة المرتبطة به يبقى غير مرئي لمستخدميك، حتى لو كان RevenueCat يراه بالفعل. إنه سهو شائع في مرحلة إنشاء المنتجات.

هل يأخذ RevenueCat عمولة على الاشتراكات؟

يأخذ RevenueCat عمولة على الإيرادات بعد تجاوز حد شهري معيّن. وتُضاف إلى عمولة Apple على الاشتراكات المباعة داخل التطبيق. تحقق من المستويات الحالية على موقع RevenueCat قبل بناء نموذجك الاقتصادي على هاتين العمولتين.