تكامل 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 الذي يتم إطلاقه كلما أضاف مستخدم عنصرًا إلى قائمة أمنياته. يحتوي هذا الحدث على سمة العنصر (item) التي تشير إلى اسم العنصر المضاف إلى قائمة الأمنيات.

يرسل AppsFlyer بيانات حدث AddToWishlist إلى Pushwoosh، حيث يمكنك تخصيص الرسائل اعتمادًا على اختيارات المستخدمين. على سبيل المثال، يمكنك إنشاء إعداد مسبق للدفع (push preset) يقدم خصمًا على عنصر أضافه المستخدم إلى قائمة أمنياته. بدلاً من اسم العنصر، أضف عنصر نائب للمحتوى الديناميكي (Dynamic Content placeholder) مع سمة 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، يتم تمكين وضع الخصوصية المتقدم (Advanced Privacy Mode) افتراضيًا مما يسمح بالتحكم في توفر بيانات الإحالة على مستوى المستخدم عبر منصة 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 وقم بتكوين الأحداث والبيانات التي سيتم تضمينها في الـ postbacks المرسلة إلى Pushwoosh.

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

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

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

ملاحظة

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