تكامل RevenueCat

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

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

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

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

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

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

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

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

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

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

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

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

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

الأحداث

يتحول كل webhook يرسله RevenueCat إلى حدث في Pushwoosh يحمل الاسم RC_ متبوعًا بنوع الحدث في RevenueCat، مثل RC_INITIAL_PURCHASE أو RC_RENEWAL أو RC_CANCELLATION أو RC_BILLING_ISSUE أو RC_EXPIRATION. ينشئ Pushwoosh الحدث عند وصول أول webhook من هذا النوع، لذلك تظهر أنواع أحداث RevenueCat الجديدة في تطبيقك تلقائيًا. راجع أنواع الأحداث في وثائق RevenueCat للاطلاع على القائمة الكاملة.

يحمل كل حدث حقول webhook الخاص بـ RevenueCat كسمات للحدث، مثل price وprice_in_purchased_currency وcurrency وproduct_id وstore وperiod_type وenvironment وcountry_code وentitlement_ids:

• تتحول الحقول التي تحتوي على وقت بالمللي ثانية إلى تواريخ بدون اللاحقة _ms، مثل purchased_at وexpiration_at. تاريخ إرسال الـ webhook هو السمة timestamp.
• هذه التواريخ بتوقيت UTC وبالتنسيق YYYY-MM-DD، بدون الوقت من اليوم.
• تصبح سمات العميل التي تعيّنها في RevenueCat سمات للحدث أيضًا. أما السمات التي تحدد هوية شخص أو جهاز، مثل البريد الإلكتروني ورقم الهاتف واسم العرض وعنوان IP ومعرّفات الإعلانات ورموز الإشعارات، فلا تُمرَّر إلى Pushwoosh.
• يحتفظ الحدث بما يصل إلى 100 سمة.

تُسجَّل المشتريات من App Store وGoogle Play وMac App Store وAmazon على منصات iOS وAndroid وmacOS وAmazon. أما المشتريات من المتاجر الأخرى، مثل Stripe أو RevenueCat Billing أو المنح الترويجية، فتُسجَّل بدون منصة.

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

نصيحة

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

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

يعمل التكامل عبر webhooks الخاصة بـ RevenueCat، وهي متاحة في خطة Pro من RevenueCat.

مطابقة عملاء RevenueCat مع مستخدمي Pushwoosh

يسجّل Pushwoosh الـ webhook للمستخدم في Pushwoosh الذي يحدده، ويتجاهل الـ webhook الذي لا يحدد أي مستخدم. اختر كيف يحدد RevenueCat المستخدم:

• إذا كان تطبيقك يعرّف المستخدمين بمعرّفه الخاص ويمرّره إلى RevenueCat بوصفه App User ID، فاستخدم App User ID بوصفه User ID في Pushwoosh.
• إذا كان App User ID يختلف عن User ID في Pushwoosh، مثلًا عندما يستخدم RevenueCat معرّفات مجهولة مثل $RCAnonymousID:…، فأرسل معرّفات Pushwoosh كسمات في RevenueCat. بدونها، تذهب الأحداث إلى User ID غير موجود في Pushwoosh.

استخدام App User ID من RevenueCat بوصفه User ID في Pushwoosh

عيّن App User ID الذي تمرّره إلى RevenueCat بوصفه User ID في Pushwoosh (setUserId).

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

إرسال معرّفات Pushwoosh كسمات في RevenueCat

عيّن السمتين pushwooshUserId وpushwooshHwid في RevenueCat. يستخدمهما Pushwoosh بدلًا من App User ID:

• pushwooshUserId: معرّف User ID للعميل في Pushwoosh.
• pushwooshHwid: معرّف الجهاز (HWID) في Pushwoosh لجهاز العميل. هذه السمة اختيارية. بدونها، يستخدم Pushwoosh الـ User ID بوصفه HWID.

Android

Kotlin

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Swift

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

إرسال webhooks من RevenueCat إلى Pushwoosh

في لوحة تحكم RevenueCat:

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

2. اختر Webhooks.

3. إذا عرض RevenueCat قائمة الـ webhooks الخاصة بك، فانقر على إضافة تكوين جديد (Add new configuration).
4. أعطِ التكامل اسمًا واضحًا، مثل Pushwoosh، لسهولة التعرف عليه.
5. أدخل عنوان URL التالي بوصفه عنوان URL للـ webhook:

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

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

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

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

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

للتحقق من الاتصال، أرسل webhook اختباريًا من RevenueCat. يعني التسليم الناجح أن Pushwoosh قبِل عنوان URL ورمز API. لا يُسجَّل الـ webhook الاختباري نفسه كحدث: يظهر كل حدث RC_ ضمن الجمهور → الأحداث في تطبيق Pushwoosh الخاص بك بمجرد وصول أول webhook حقيقي من هذا النوع.