تكامل 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	تم بدء نقل المعاملات والاستحقاقات بين معرف (معرفات) مستخدم تطبيق وآخر.
تمديد الاشتراك	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، حدد ما إذا كان يجب إرسال أحداث webhook لتطبيق واحد أو لجميع التطبيقات داخل المشروع.
8. في القائمة المنسدلة Event Type، حدد ما إذا كنت تريد إرسال جميع الأحداث أو تحديد الأحداث التي سيتم إرسالها إلى Pushwoosh.

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

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