تكامل RevenueCat

تحتاج إلى مساعدة المطور

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

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

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

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

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

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

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

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

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

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

عروض ترقية المستوى

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

الأحداث (Events)

يتيح التكامل تتبع أحداث (events) متنوعة، وإنشاءها تلقائيًا في 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

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

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

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

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

لنظام 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، أدخل Pushwoosh API token الخاص بك. يمكنك العثور على هذا الرمز المميز تحت Settings > API Access في Pushwoosh.

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

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

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