AppsFlyer: إرسال حدث

يرسل قالب النقطة AppsFlyer: send event حدثًا داخل التطبيق من خادم إلى خادم إلى AppsFlyer لكل مسافر يمر بهذه الخطوة. يحمل الحدث إسناد التثبيت، بحيث تظهر خطوة الرحلة في تقارير AppsFlyer ويمكن تسليمها إلى شبكات الإعلانات كتحويل.

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

النقطة لا تقوم بتعيين علامة AppsFlyer ID بنفسها. بدون كود التطبيق الذي يقرأ AppsFlyerLib.getAppsFlyerUID() ويحفظه كعلامة Pushwoosh بعد بدء AppsFlyer SDK، تظل العلامة فارغة على كل جهاز وتقوم النقطة بتخطي كل مسافر. شارك هذا مع فريق التطوير لديك:

Java

String appsflyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(context);
Pushwoosh.getInstance().setTags(new TagsBundle.Builder().putString("AppsFlyer ID", appsflyerId).build());

Swift

let appsflyerId = AppsFlyerLib.shared().getAppsFlyerUID
Pushwoosh.sharedInstance().setTags(["AppsFlyer ID": appsflyerId])

تكوين النقطة

1. اسحب AppsFlyer: send event من قسم Integrations إلى لوحة العمل.
2. انقر نقرًا مزدوجًا على النقطة وأدخل Step Name (اسم الخطوة).
3. في App ID (معرّف التطبيق)، أدخل معرّف التطبيق من AppsFlyer: App Settings (إعدادات التطبيق)، id123456789 لنظام iOS أو com.example.app لنظام Android.

4. في Dev key (مفتاح المطور)، أدخل مفتاح المطور للتطبيق من App Settings > Dev Key. يتم تخزينه مقنعًا، مثل رأس سري لـ webhook — لا يعرضه Pushwoosh أو يعيده أبدًا بمجرد حفظه، ولا يظهر أبدًا في الطلب المخزن للنقطة أو في سجل المكالمات.

5. في Event name (اسم الحدث)، أدخل الاسم الذي يجب أن يحصل عليه الحدث في AppsFlyer، سواء كان اسمًا قياسيًا (af_purchase، af_complete_registration) أو اسمًا خاصًا بك (paywall_reached).

6. في Tag with the AppsFlyer ID (العلامة التي تحتوي على معرّف AppsFlyer)، اكتب اسم علامة Pushwoosh حيث يحفظ التطبيق معرّف AppsFlyer بعد بدء AppsFlyer SDK (انظر ملاحظة المطور أعلاه). أدخل اسم العلامة كنص عادي. قوالب النقاط لا تحتوي على منتقي العلامات الذي يستخدمه Push أو Email. يقوم AppsFlyer بمطابقة حدث الخادم مع التثبيت فقط بواسطة هذا المعرّف، لذا تأكد من إدخال اسم العلامة بشكل صحيح تمامًا.

7. اختياري. في Customer user ID (معرّف المستخدم للعميل)، احتفظ بالقيمة الافتراضية {{device:user_id}} لإرسال معرّف مستخدم Pushwoosh، أو أدخل معرّفًا خاصًا بك للتسوية في AppsFlyer.

8. اختياري. في Currency (العملة)، احتفظ بالقيمة الافتراضية USD أو أدخل رمز ISO 4217 آخر. يتم إرساله كـ eventCurrency.

9. اختياري. في Event value (قيمة الحدث)، أضف المعلمات لإرسالها كحمولة eventValue لـ AppsFlyer — انظر حقول المفتاح/القيمة. يبدأ الجدول مملوءًا مسبقًا بصف af_revenue وصف af_currency؛ امسح أيًا منهما لا تحتاجه. استخدم af_revenue للمبلغ، و af_content_id أو af_content_type لمعلوماتك الخاصة. لا يوجد حقل إيرادات رقمي منفصل: af_revenue هو خلية نصية في هذا الجدول، مثل أي معلمة أخرى، ويأخذ ماكرو مثل {{tag:Price}}. لا يتم إرسال الخلية الفارغة.

10. انقر على Save (حفظ).

متى لا يتم إرسال طلب

يتخطى Pushwoosh الطلب (ويستمر المسافر إلى الخطوة التالية) عندما تكون العلامة في Tag with the AppsFlyer ID فارغة لذلك المسافر. هذا ليس طلبًا فاشلاً. لن يكون لدى AppsFlyer أي شيء لمطابقة الحدث به.

الطلب الفاشل (الذي كان يحتوي على AppsFlyer ID) يسقط المسافر من الرحلة بدلاً من ذلك. انظر الأخطاء والطلبات الفاشلة.

سيناريو مثال: الإبلاغ عن عملية شراء مكتملة إلى AppsFlyer

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

1. أضف AppsFlyer: send event مباشرة بعد الخطوة التي تؤكد الشراء. اضبط Event name على af_purchase. في Event value، اضبط af_revenue على {{tag:LastPurchaseAmount}}.
2. انقر على Save (حفظ).

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