تكامل 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.

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

مزامنة معرفات المستخدم (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. يمكنك العثور على هذا الرمز تحت Settings > API Access في Pushwoosh.

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

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

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