# تكامل RevenueCat

<Aside type="caution" icon="setting" title="مطلوب مساعدة من المطور">
 ستحتاج إلى مساعدة من فريق التطوير لديك لإعداد التكامل. يرجى مشاركة هذا الدليل معهم.
</Aside>

[RevenueCat](https://www.revenuecat.com/) هي منصة لإدارة الاشتراكات تبسط عمليات الشراء والاشتراكات داخل التطبيق للشركات عبر منصات iOS و Android والويب. توفر أدوات شاملة لبناء وتحليل وتعزيز الاشتراكات داخل التطبيق.

من خلال دمج Pushwoosh مع [RevenueCat](https://www.revenuecat.com/)، يمكن للشركات إرسال إشعارات لحظية مستهدفة، ورسائل داخل التطبيق، ورسائل أخرى للمستخدمين بناءً على أحداث الاشتراك التي يرسلها RevenueCat إلى Pushwoosh. يمكن أن يشجع ذلك المستخدمين على تجديد الاشتراكات، أو الترقية إلى باقات أعلى، أو الاستفادة من العروض الخاصة، مما يعزز التفاعل، ويزيد الإيرادات، ويبسط إدارة الاشتراكات.

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

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

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

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

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

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

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

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

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

## الأحداث

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

| الحدث | اسم الحدث <div style="width:160px"></div> | الوصف | السمات <div style="width:200px"></div> |
|---------------------- |--------------------------- |------------------------------------------------------------------------------------------------------------------------------ |--------------------------------------------------------------------------------------------------------------- |
| الشراء الأولي | `RC_INITIAL_PURCHASE` | تم شراء اشتراك جديد. | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li></ul> |
| الشراء غير المتجدد | `RC_NON_RENEWING_PURCHASE` | قام العميل بعملية شراء لن تتجدد تلقائيًا. | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li></ul> |
| التجديد | `RC_RENEWAL` | تم تجديد اشتراك حالي أو أعاد مستخدم سابق الاشتراك. | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li></ul> |
| تغيير المنتج | `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` | ينتهي اشتراك العميل. | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li><li>expiration_at</li><li>purchased_at</li></ul> |

يمكنك استخدام كل هذه الأحداث في [رحلات العملاء](/ar/product/customer-journey/pushwoosh-journey-overview). يمكن استخدام الأحداث التي تحتوي على السمة `price` مع [تجزئة RFM](/ar/product/audience-data-and-segmentation/segmentation/rfm-segmentation).

<Aside type="tip">
يمكنك أيضًا ربط الأحداث التي تحمل إيرادات مثل `RC_INITIAL_PURCHASE` أو `RC_RENEWAL` أو `RC_NON_RENEWING_PURCHASE` (باستخدام سمات `price` و `currency`) كمصدر لـ [أحداث التحويل](/ar/product/audience-data-and-segmentation/events/conversion-events/). تجنب ربط `RC_CANCELLATION` أو `RC_EXPIRATION` بهذه الطريقة — أحداث التحويل لا تدعم المبالغ المستردة أو الإلغاءات، لذلك ستبقى محسوبة كإيرادات.
</Aside>

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

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

لمزامنة الأحداث بين RevenueCat و Pushwoosh لنفس المستخدم، تحتاج إلى تعيين UserID في Pushwoosh ليتطابق مع App User Id في RevenueCat. للقيام بذلك، قم بتعيين appUserID من RevenueCat SDK في Pushwoosh SDK. [تعرف على المزيد حول appUserID في RevenueCat](https://www.revenuecat.com/docs/customers/user-ids#provide-app-user-id-on-configuration)

#### لنظام 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**)

<img src="/integrations-revenuecat-integration-1.webp" alt="العثور على التكاملات في لوحة تحكم RevenueCat"/>

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

<img src="/integrations-revenuecat-integration-2.webp" alt="اختيار Webhooks من قائمة التكاملات"/>

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

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

<img src="/integrations-revenuecat-integration-3.webp" alt="إدخال عنوان URL للـ Webhook لتكامل Pushwoosh"/>

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

<img src="/integrations-revenuecat-integration-4.webp" alt="العثور على رمز تطبيق Pushwoosh"/>

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

<img src="/integrations-revenuecat-integration-5.webp" alt="إدخال رمز API لـ Pushwoosh في رأس التفويض"/>

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

<img src="/integrations-revenuecat-integration-6.webp" alt="تكوين أنواع الأحداث في RevenueCat webhook"/>

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

<img src="/integrations-revenuecat-integration-7.webp" alt="اختيار خيارات عرض الأحداث في webhook"/>

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