# تكامل AppsFlyer

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

## نظرة عامة على التكامل

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

بمجرد تكوين التكامل، سيرسل AppsFlyer المعلومات التالية إلى Pushwoosh:

*   سلوك المستخدم داخل التطبيق كأحداث (Events) وسماتها؛
*   مصادر اكتساب المستخدمين كقيم لوسم (Tag) _Acquisition Source_.

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

باستخدام هذه البيانات، يمكنك بناء شرائح للمستخدمين وإنشاء حملات مستهدفة وشخصية بدقة في Pushwoosh.
فيما يلي مثالان على الاستفادة من بيانات AppsFlyer لإنشاء رحلات عملاء فعالة في Pushwoosh.

**1. إنشاء حملات عالية الاستهداف في Pushwoosh باستخدام الأحداث التي يتتبعها AppsFlyer.**

لنفترض أن لديك تطبيقًا إخباريًا. لقد قمت بتكوين AppsFlyer لتتبع حدث _SubscribedToNews_، والذي يتم إطلاقه في كل مرة يشترك فيها مستخدم في قناة إخبارية. يحتوي هذا الحدث على سمة الفئة التي تشير إلى نوع الأخبار التي يشترك فيها المستخدم: _politics_، _business_، أو _sports_.

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

<img src="/integrations-appsflyer-integration-1.webp" alt="شرائح المستخدمين بناءً على سمات فئة الأخبار"/>

الآن يمكنك إنشاء حملات تستهدف المستخدمين المهتمين بنوع معين من الأخبار:

<img src="/integrations-appsflyer-integration-2.webp" alt="حملات مستهدفة للمستخدمين المهتمين بفئات أخبار محددة"/>

**2. تخصيص الرسائل بناءً على بيانات سلوك المستخدم من AppsFlyer.**

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

يرسل AppsFlyer بيانات حدث _AddToWishlist_ إلى Pushwoosh، حيث يمكنك تخصيص الرسائل اعتمادًا على اختيارات المستخدمين. على سبيل المثال، يمكنك إنشاء إعداد مسبق للدفع يقدم خصمًا على عنصر أضافه المستخدم إلى قائمة أمنياته. بدلاً من اسم العنصر، أضف [عنصر نائب للمحتوى الديناميكي](/ar/developer/guides/personalization/dynamic-content/#personalizing-messages-sent-via-api-with-dynamic-content) مع سمة _item_:

<img src="/integrations-appsflyer-integration-3.webp" alt="عنصر نائب للمحتوى الديناميكي في إعداد Pushwoosh المسبق للدفع"/>

إذا أضاف مستخدم عنصرًا إلى قائمة أمنياته، فسيتلقى إشعارًا فوريًا يحتوي على معلومات عنه. على سبيل المثال، أولئك الذين يختارون iPhone 14 Pro Max سيرون هذه الرسالة:

<img src="/integrations-appsflyer-integration-4.webp" alt="معاينة إشعار الدفع لعرض عنصر iPhone 14 Pro Max" width="375"/>

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

<Aside type="note">
عملية التكامل متطابقة لمنصتي Android و iOS.
</Aside>

1.  ادمج Pushwoosh SDK في تطبيقك إذا لم تكن قد فعلت ذلك بالفعل. لمزيد من الإرشادات التفصيلية، [اقرأ الدليل](/ar/developer/pushwoosh-sdk/pushwoosh-sdk-overview).

<Aside type="caution">
للتشغيل الصحيح، يلزم إصدار Pushwoosh iOS SDK 6.5.7 أو أحدث وإصدار Pushwoosh Android SDK 6.6.16 أو أحدث.
</Aside>

2.  لضمان إرسال البيانات الصحيحة إلى AppsFlyer، ادمج مقتطف الكود هذا في الكود الخاص بك. تأكد من أنه يتم تنفيذه بعد تهيئة كل من Pushwoosh SDK و AppsFlyer SDK.

<Tabs>
<TabItem label="Java">
```
String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);
```
</TabItem>

<TabItem label="Objective-C">
```
NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];
```
</TabItem>
</Tabs>

<Aside type="danger">
عند استخدام قيم UserID مخصصة من Pushwoosh لتحديد المستخدمين واستهدافهم، تأكد من تشغيل الكود بعد استدعاء طريقة **setUserId()** في Pushwoosh SDK بالقيمة المخصصة.

تتبع متى يتغير UserID في Pushwoosh وفقًا للمنطق في تطبيق الهاتف المحمول الخاص بك وأرسل القيم المحدثة إلى AppsFlyer على الفور. هذا مهم للربط الصحيح للبيانات المرسلة مع المستخدمين في قاعدة بيانات Pushwoosh الخاصة بك.
</Aside>

3.  قم بتكوين تكامل Pushwoosh في AppsFlyer. للقيام بذلك، في [حساب AppsFlyer](https://hq1.appsflyer.com/auth/login) الخاص بك، انتقل إلى **Collaborate** > **Partner Marketplace**. في قائمة الشركاء، حدد موقع Pushwoosh واختره.

<img src="/integrations-appsflyer-integration-5.webp" alt="تحديد موقع Pushwoosh في AppsFlyer"/>

4.  انقر على **Set up integration**. ثم سيتم توجيهك إلى صفحة إعداد التكامل. هناك، قم بتمكين مفتاح **Activate partner**.

<img src="/integrations-appsflyer-integration-6.webp" alt="تمكين مفتاح تفعيل الشريك في AppsFlyer"/>

<Aside type="note">
بالنسبة لتطبيقات iOS، يتم تمكين وضع الخصوصية المتقدم افتراضيًا مما يسمح بالتحكم في توفر بيانات الإسناد على مستوى المستخدم عبر منصة AppsFlyer. على الرغم من أن AppsFlyer لا يرسل هذا النوع من البيانات إلى Pushwoosh، إلا أن إبقاء مفتاح الخصوصية المتقدمة مفعلًا قد يتعارض مع نقل البيانات.

لضمان تلقي Pushwoosh لجميع البيانات، نوصي بتعطيل وضع الخصوصية المتقدم في **إعدادات التطبيق**. لن يؤدي القيام بذلك إلى المساس بخصوصية بيانات المستخدم. تلتزم Pushwoosh بإدارة البيانات بشكل آمن ومسؤول، وتستخدم بروتوكولات الأمان القياسية في الصناعة لحماية السرية.
</Aside>

<img src="/integrations-appsflyer-integration-7.webp" alt="تعطيل وضع الخصوصية المتقدم في AppsFlyer"/>

5.  في قسم **General settings**، أدخل بيانات اعتماد Pushwoosh الخاصة بك:

*   **API Access Token**. للحصول على الرمز، في حساب Pushwoosh الخاص بك، انتقل إلى **Settings > API Access** وانسخ الكود. يمكنك معرفة المزيد حول API Access Token [في هذا الدليل](/ar/developer/api-reference/api-access-token).
*   **Application Code** (XXXXX-XXXXX) الذي يمكنك العثور عليه أسفل اسم تطبيقك في حساب Pushwoosh الخاص بك.

<img src="/integrations-appsflyer-integration-8.webp" alt="إضافة بيانات اعتماد Pushwoosh في الإعدادات العامة لـ AppsFlyer"/>

6.  في قسم **Default postback**، حدد **All media sources, including organic**.

<img src="/integrations-appsflyer-integration-9.webp" alt="تكوين قسم postback الافتراضي"/>

7.  في قسم **In-app event settings**، أدخل **Application Code** و **API Access Token** الخاصين بـ Pushwoosh.

<img src="/integrations-appsflyer-integration-10.webp" alt="قسم إعدادات الأحداث داخل التطبيق مع رمز التطبيق ورمز API"/>

8.  قم بتمكين مفتاح **In-app event postback** وقم بتكوين الأحداث والبيانات التي سيتم تضمينها في عمليات postbacks المرسلة إلى Pushwoosh.

<img src="/integrations-appsflyer-integration-11.webp" alt="تكوين مفتاح postback للأحداث داخل التطبيق في AppsFlyer"/>

اختر حدثًا أو أكثر من أحداث AppsFlyer لإرسالها إلى Pushwoosh من القائمة المنسدلة، وأكمل المعلمات اللازمة.

| المعلمة | الوصف |
| --- | --- |
| **the mapped to partner event** | على الرغم من أن هذا الحقل إلزامي، لا تقلق بشأن ما تكتبه لأنه لن يغير كيفية تسمية الأحداث. سيستمر Pushwoosh في تلقي الأحداث بنفس الأسماء التي تظهر بها في AppsFlyer. |
| **for users from** | في هذا الحقل، حدد ما إذا كانت عمليات postbacks تُرسل حصريًا للمستخدمين المنسوبين إلى هذا الشريك أو لجميع مصادر الوسائط، بما في ذلك العضوية. |
| **including** | <p>اختر كيفية مشاركة بيانات الحدث مع Pushwoosh:</p><ul><li><strong>No values & no revenue:</strong> إرسال الحدث نفسه فقط بدون أي معلمات (قيم أو إيرادات).</li><li><strong>Values & no revenue:</strong> إرسال جميع المعلمات باستثناء قيمة الإيرادات.</li><li><strong>Values & revenue:</strong> إرسال جميع معلمات الحدث، بما في ذلك قيمة الإيرادات (إذا كانت موجودة في الحدث).<br/>لتلقي الأحداث ذات السمات الإضافية المرسلة إلى Pushwoosh، حدد القيم والإيرادات.</li></ul> |

9.  بمجرد تكوين التكامل، انقر على **Save**.

<Aside type="note">
قبل إطلاق حملاتك، تأكد من اختبار التكامل. غالبًا ما تحدث الأخطاء أثناء الإعداد، لذا يساعد الاختبار السريع على منع إهدار الموارد في الحملات التي تحتوي على بيانات مفقودة أو غير صحيحة.
</Aside>

## تتبع نقرات البريد الإلكتروني مع AppsFlyer ESP 2.0

لاستخدام تتبع نقرات البريد الإلكتروني والحفاظ على الروابط العالمية / روابط التطبيقات عند إرسال رسائل البريد الإلكتروني عبر Pushwoosh، يمكنك إعداد [تكامل البريد الإلكتروني AppsFlyer ESP 2.0](/ar/product/integrations/appsflyer-esp2-email-integration).