# تكامل AppsFlyer ESP 2.0

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

[AppsFlyer](https://www.appsflyer.com/) هي منصة لتحليلات التسويق وإسناد الأجهزة المحمولة. [AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide) هو تكامل AppsFlyer لمزودي خدمة البريد الإلكتروني (ESPs). قم بتوصيل Pushwoosh مع ESP 2.0 لتمكين تتبع الروابط في حملات البريد الإلكتروني. في هذا التكامل، يقوم Pushwoosh بتغليف عناوين URL، ويحافظ حل ESP 2.0 على عمل الربط العميق لروابط iOS Universal Links و Android App Links عند تغليف الروابط للتتبع.

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

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


### المتطلبات الأساسية

*   تطبيق Pushwoosh مع [تكوين إرسال البريد الإلكتروني](/ar/product/first-steps/start-with-your-project/configure-platforms/email-verification/)
*   حساب AppsFlyer مع [تكامل AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide). هذه ميزة مميزة. اتصل بمدير نجاح العملاء (CSM) في AppsFlyer أو دعم AppsFlyer للحصول على الوصول.



### الكيانات المتزامنة

يتم تسجيل نقرات روابط البريد الإلكتروني عبر نطاق تتبع النقرات (Click Tracking Domain) الخاص بك كإحصائيات نقر في Pushwoosh وكأحداث نقر مع بيانات الإسناد في AppsFlyer.

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

*   **تتبع نقرات البريد الإلكتروني:** قم بقياس نقرات روابط البريد الإلكتروني عبر AppsFlyer.
*   **الربط العميق من البريد الإلكتروني:** حافظ على عمل Universal Links (iOS) و App Links (Android) عند تغليف الروابط في رسائل البريد الإلكتروني.

### كيف يعمل التكامل


بمجرد أن يصبح التكامل فعالاً، تمر كل نقرة بثلاث خطوات:

1.  يستبدل Pushwoosh الروابط في رسائل البريد الإلكتروني الخاصة بك بعناوين URL للتتبع على CTD الخاص بك، على سبيل المثال:
    `https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...`

2.  عندما ينقر المستخدم على الرابط، يذهب الطلب إلى AppsFlyer عبر CNAME الذي تم تكوينه. يسجل AppsFlyer الإسناد، ويتعامل مع الربط العميق، ويعيد توجيه المستخدم إلى عنوان URL النهائي أو إلى التطبيق عبر Universal Link / App Link. كما يرسل طلب GET إلى Pushwoosh، ويمرر CTD الخاص بك في رأس المضيف (Host header)، حتى يتمكن Pushwoosh من تسجيل النقرة:
```
   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>
```

3.  يستقبل Pushwoosh الطلب ويسجل النقرة لإحصائياته الخاصة.

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

<Aside type="note" title="Pushwoosh مقابل AppsFlyer">
يشارك Pushwoosh فقط في الإعداد الأولي لـ CTD. يتم إكمال بقية التكامل من جانب AppsFlyer.
</Aside>

### الخطوة 1. إنشاء وتفعيل نطاق تتبع النقرات

**نطاق تتبع النقرات (CTD)** هو جزء النطاق من عنوان URL للرابط المتعقب الذي يظهر في رسالة البريد الإلكتروني. يجمع بين نطاق فرعي ونطاقك الرئيسي، على سبيل المثال، `clickpush.esp-integrations1.com`. يتم إنشاء النطاق الفرعي في إعدادات DNS لنطاقك مع مزود النطاق الخاص بك، عادةً عن طريق إضافة سجل CNAME.
<Aside type="caution" title="مطلوب CTD جديد">
إنشاء CTD جديد إلزامي لتكامل AppsFlyer ESP 2.0، حتى لو كنت تستخدم بالفعل نطاق تتبع نقرات موجود. استخدام نطاق جديد يتجنب التأثير على حركة المرور لحملات البريد الإلكتروني الحالية الخاصة بك.

للتفاصيل، راجع دليل AppsFlyer: [إعداد تكامل ESP الخاص بك مع AppsFlyer](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-1-create-a-onelink-template-for-your-email-campaign).
</Aside>

1.  قرر أي نطاق فرعي ستستخدمه كـ CTD الخاص بك (على سبيل المثال، `clickpush.esp-integrations1.com`).
2.  في Pushwoosh، افتح **الإعدادات**، ثم حدد **تكوين المنصات**.
3.  في صفحة **تكوين قناة البريد الإلكتروني**، مرر لأسفل إلى **نطاق التتبع المخصص** وحدد **تمكين**.

<Aside type="note" >
يظهر قسم **نطاق التتبع المخصص** فقط بعد تكوين قناة البريد الإلكتروني لتطبيقك. إذا لم تره، أكمل [تكوين البريد الإلكتروني](/ar/product/first-steps/start-with-your-project/configure-platforms/email-verification/) أولاً.
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="لوحة تحكم Pushwoosh: الإعدادات، تكوين المنصات، تكوين قناة البريد الإلكتروني، نطاق التتبع المخصص مع تمكين."/>

4.  أدخل CTD الخاص بك في حقل **النطاق** وحدد **التالي**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="مربع حوار تمكين نطاق التتبع المخصص: حقل النطاق، إلغاء، والتالي."/>

5.  خارج Pushwoosh، افتح الخدمة التي تدير فيها DNS العام لنطاق CTD الخاص بك (عادةً مسجل النطاق الخاص بك، أو مضيف DNS، أو حساب الاستضافة الخاص بك). في محرر DNS أو المنطقة الخاص به لهذا النطاق، أضف **CNAME** الذي يعرضه Pushwoosh في هذه الخطوة حتى يشير CTD الخاص بك إلى `api.pushwoosh.com`.

<Aside type="note" title="انتشار DNS">
عادةً ما تدخل تغييرات DNS حيز التنفيذ في غضون دقائق ولكن يمكن أن تستغرق ما يصل إلى 48 ساعة.
</Aside>

6.  في Pushwoosh، حدد **تحقق**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="خطوة DNS لنطاق التتبع المخصص: CNAME إلى api.pushwoosh.com، رجوع، تحقق، وحفظ."/>

7.  عندما ينجح التحقق، حدد **حفظ**.
8.  إذا كنت بحاجة إلى تغيير **النطاق** أو سجل DNS، فحدد **رجوع** واضبط الخطوات السابقة.

9.  بعد النقر على **حفظ**، يظهر CTD الخاص بك في قائمة **نطاق التتبع المخصص** في **تكوين قناة البريد الإلكتروني**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="تكوين قناة البريد الإلكتروني: قسم نطاق التتبع المخصص يعرض CTD المحفوظ في القائمة."/>

لتعطيله لاحقًا، حدد `...` بجوار CTD الخاص بك، ثم حدد **تعطيل نطاق التتبع المخصص**.

<Aside type="tip">
قبل المتابعة، أرسل بريدًا إلكترونيًا تجريبيًا وتأكد من أن الرابط يستخدم CTD الخاص بك.

**مثال على رابط متعقب**

`https://clickpush.example.com/json/1.3/emailRedirect?d=...`
</Aside>

### الخطوة 2. بدء التكامل في AppsFlyer

في [منصة AppsFlyer](https://hq1.appsflyer.com/)، ابدأ تكامل ESP 2.0. اتبع [دليل AppsFlyer لإعداد تكامل ESP الخاص بك](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer).

سيطلب منك AppsFlyer التفاصيل التالية:

*   **نطاق تتبع النقرات:** CTD الخاص بك (على سبيل المثال، `clickpush.example.com`)
*   **نقطة نهاية ESP:** `api.pushwoosh.com` (هدف CNAME الذي يظهر في Pushwoosh عند تمكين نطاق التتبع المخصص)

سيقوم AppsFlyer بالتحقق من صحة التكوين. حافظ على توجيه CNAME الخاص بـ CTD إلى **`api.pushwoosh.com`** حتى يكتمل التحقق.

### الخطوة 3. تحديث CNAME إلى AppsFlyer

بعد أن يتحقق AppsFlyer من صحة الإعداد، سيعطيك نطاق توجيه (على سبيل المثال، `jyvls.espclicks.appsflyer.com`).

قم بتحديث CNAME الخاص بك بحيث يشير CTD إلى AppsFlyer بدلاً من Pushwoosh:

**قبل:**

`clickpush.example.com` → `api.pushwoosh.com`

**بعد:**

`clickpush.example.com` → `jyvls.espclicks.appsflyer.com` (استخدم النطاق الذي يوفره AppsFlyer)

<Aside type="note" title="وقت الانتشار">
بعد تحديث CNAME، قد يستغرق التكامل ما يصل إلى 24 ساعة لبدء العمل.
</Aside> 

بعد تبديل CNAME، أرسل بريدًا إلكترونيًا تجريبيًا وتحقق من أن الروابط تفتح بشكل صحيح وأن النقرات تظهر في AppsFlyer.

## ماذا يحدث بعد ذلك

بمجرد أن يدخل التغيير حيز التنفيذ، تمر حركة مرور النقرات عبر البنية التحتية لـ AppsFlyer. يوفر AppsFlyer طبقة التوجيه، و SSL، و AASA (Apple App Site Association)، و Android App Links.

يستمر Pushwoosh في تغليف الروابط وتسجيل إحصائيات النقرات. لا يلزم تكوين إضافي في Pushwoosh.

لمعرفة المزيد حول الإعداد والاختبار من جانب AppsFlyer، راجع:

<LinkCard title="إعداد تكامل ESP الخاص بك مع AppsFlyer" href="https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-5-test-the-link" />

<LinkCard title="دليل تكامل مزود خدمة البريد الإلكتروني" href="https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide" />