تكامل AppsFlyer

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

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

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

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

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

• سلوك المستخدم داخل التطبيق كـ Events وسماتها؛
• مصادر اكتساب المستخدمين كقيم لـ Tag Acquisition Source.

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

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

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

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

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

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

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

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

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

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

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

ملاحظة

عملية التكامل متطابقة لكل من منصتي Android و iOS.

1. قم بدمج Pushwoosh SDK في تطبيقك إذا لم تكن قد فعلت ذلك بالفعل. لمزيد من الإرشادات التفصيلية، اقرأ الدليل.

تنبيه

للتشغيل الصحيح، يلزم إصدار Pushwoosh iOS SDK 6.5.7 أو أحدث وإصدار Pushwoosh Android SDK 6.6.16 أو أحدث.

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

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);

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];

خطر

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

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

3. قم بتكوين تكامل Pushwoosh في AppsFlyer. للقيام بذلك، في حساب AppsFlyer الخاص بك، انتقل إلى Collaborate > Partner Marketplace. في قائمة الشركاء، حدد واختر Pushwoosh.

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

ملاحظة

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

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

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

• API Access Token. للحصول على الرمز، في حساب Pushwoosh الخاص بك، انتقل إلى Settings > API Access وانسخ الشفرة. يمكنك معرفة المزيد عن API Access Token في هذا الدليل.
• Application Code (XXXXX-XXXXX) الذي يمكنك العثور عليه أسفل اسم تطبيقك في حساب Pushwoosh الخاص بك.

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

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

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

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

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

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

ملاحظة

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

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

لاستخدام تتبع نقرات البريد الإلكتروني والحفاظ على الروابط الشاملة / روابط التطبيقات عند إرسال رسائل البريد الإلكتروني من خلال Pushwoosh، يمكنك إعداد تكامل البريد الإلكتروني AppsFlyer ESP 2.0.