تكامل RevenueCat

مطلوب مساعدة من المطور

ستحتاج إلى مساعدة من فريق التطوير لديك لإعداد التكامل. يرجى مشاركة هذا الدليل معهم.

RevenueCat هي منصة لإدارة الاشتراكات تبسط عمليات الشراء والاشتراكات داخل التطبيق للشركات عبر منصات iOS و Android والويب. توفر أدوات شاملة لبناء وتحليل وتعزيز الاشتراكات داخل التطبيق.

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

حالات الاستخدام

التواصل المخصص

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

إشعارات مشاكل الفوترة

عندما يواجه اشتراك المستخدم مشكلة في الفوترة، يمكن للشركات استخدام تكامل RevenueCat مع Pushwoosh لإرسال إشعارات مستهدفة على الفور. على سبيل المثال، يمكن لخدمة بث المحتوى إخطار المستخدم بمشكلة الفوترة وتقديم إرشادات لحلها، مثل تحديث معلومات الدفع.

إشعارات الشراء غير المتجدد

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

عروض ترقية الباقة

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

الأحداث

يتيح التكامل تتبع أحداث مختلفة، وإنشاءها تلقائيًا في Pushwoosh بمجرد إرسال الحدث الأول من RevenueCat. تشمل هذه الأحداث:

الحدث	اسم الحدث	الوصف	السمات
الشراء الأولي	RC_INITIAL_PURCHASE	تم شراء اشتراك جديد.	price price_in_purchased_currency currency
الشراء غير المتجدد	RC_NON_RENEWING_PURCHASE	قام العميل بعملية شراء لن تتجدد تلقائيًا.	price price_in_purchased_currency currency
التجديد	RC_RENEWAL	تم تجديد اشتراك حالي أو أعاد مستخدم سابق الاشتراك.	price price_in_purchased_currency currency
تغيير المنتج	RC_PRODUCT_CHANGE	قام مشترك بتغيير منتج اشتراكه.
الإلغاء	RC_CANCELLATION	تم إلغاء اشتراك أو عملية شراء غير متجددة.
مشاكل الفوترة	RC_BILLING_ISSUE	حدثت مشكلة أثناء محاولة تحصيل الرسوم من المشترك.
اسم مستعار للاشتراك	RC_SUBSCRIBER_ALIAS	يحدث كلما تم تسجيل app_user_id جديد لمشترك حالي.
إيقاف الاشتراك مؤقتًا	RC_SUBSCRIPTION_PAUSED	تم تعيين الاشتراك ليكون متوقفًا مؤقتًا في نهاية الفترة.
إلغاء الإلغاء	RC_UNCANCELLATION	تم إعادة تفعيل اشتراك ملغى لم تنته صلاحيته.
النقل	RC_TRANSFER	تم بدء نقل المعاملات والاستحقاقات بين معرف مستخدم تطبيق (App User ID) وآخر.
تمديد الاشتراك	RC_SUBSCRIPTION_EXTENDED	تم تمديد اشتراك حالي (تم تأجيل تاريخ انتهاء فترة الاشتراك الحالية).
انتهاء الصلاحية	RC_EXPIRATION	ينتهي اشتراك العميل.	price price_in_purchased_currency currency expiration_at purchased_at

يمكنك استخدام كل هذه الأحداث في رحلات العملاء. يمكن استخدام الأحداث التي تحتوي على السمة price مع تجزئة RFM.

نصيحة

يمكنك أيضًا ربط الأحداث التي تحمل إيرادات مثل RC_INITIAL_PURCHASE أو RC_RENEWAL أو RC_NON_RENEWING_PURCHASE (باستخدام سمات price و currency) كمصدر لـ أحداث التحويل. تجنب ربط RC_CANCELLATION أو RC_EXPIRATION بهذه الطريقة — أحداث التحويل لا تدعم المبالغ المستردة أو الإلغاءات، لذلك ستبقى محسوبة كإيرادات.

إعداد التكامل

مزامنة User IDs و HWIDs عبر Pushwoosh و RevenueCat

لمزامنة الأحداث بين RevenueCat و Pushwoosh لنفس المستخدم، تحتاج إلى تعيين UserID في Pushwoosh ليتطابق مع App User Id في RevenueCat. للقيام بذلك، قم بتعيين appUserID من RevenueCat SDK في Pushwoosh SDK. تعرف على المزيد حول appUserID في RevenueCat

لنظام Android

قم بتعيين appUserID الذي تم الحصول عليه من RevenueCat SDK في Pushwoosh SDK باستخدام طريقة Pushwoosh.getInstance().setUserId(appUserIDFromRC);.

لنظام iOS

قم بتعيين appUserID الذي تم الحصول عليه من RevenueCat SDK في Pushwoosh SDK باستخدام طريقة [[Pushwoosh sharedInstance] setUserId: appUserIDFromRC];.

إرسال أحداث RevenueCat إلى Pushwoosh

بعد مزامنة User IDs و HWIDs في Pushwoosh و RevenueCat، قم بتمكين تكامل Pushwoosh في لوحة تحكم RevenueCat الخاصة بك.

1. انتقل إلى مشروعك في لوحة تحكم RevenueCat وابحث عن بطاقة التكاملات (Integrations) في القائمة اليسرى. انقر على + جديد (+ New) أو إضافة تكامل (Add integration)

2. حدد Webhooks من قائمة التكاملات (Integrations)

3. أعطِ التكامل اسمًا واضحًا، مثل Pushwoosh، لسهولة التعرف عليه.
4. أدخل عنوان URL التالي في حقل Webhook URL:

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE"

في عنوان URL، استبدل APP_CODE برمز تطبيق Pushwoosh الحالي الخاص بك والذي يوجد أسفل اسم تطبيقك في حساب Pushwoosh الخاص بك.

5. في حقل قيمة رأس التفويض (Authorization header value)، أدخل رمز API لـ Pushwoosh. يمكنك العثور على هذا الرمز تحت الإعدادات > الوصول إلى API (Settings > API Access) في Pushwoosh.

6. حدد ما إذا كنت تريد إرسال الأحداث لعمليات الشراء الإنتاجية (الحية)، أو عمليات الشراء في بيئة الاختبار (sandbox)، أو كليهما.
7. في القائمة المنسدلة التطبيق (App)، حدد ما إذا كان يجب إرسال أحداث webhook لتطبيق واحد أو لجميع التطبيقات داخل المشروع.
8. في القائمة المنسدلة نوع الحدث (Event Type)، حدد ما إذا كنت تريد إرسال جميع الأحداث أو تحديد الأحداث التي سيتم إرسالها إلى Pushwoosh.

9. اختر عرض جميع الأحداث، أو الأحداث الناجحة فقط، أو الأحداث الفاشلة فقط.

بالإضافة إلى ذلك، لديك خيار إرسال Webhook اختباري.