المطابقة المتقدمة

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

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

يمكنك إعداد المطابقة المتقدمة باستخدام أحد الأساليب التالية:

• مجموعة Facebook SDK – أضف رمزًا إلى تطبيق الهواتف المحمولة بنظام Android أو iOS لإرسال البيانات إلى فيسبوك يدويًا.
• واجهة API أحداث تطبيق فيسبوك - أضف استعلامات إلى الرمز لديك لإرسال البيانات إلى فيسبوك يدويًا.
• مدير الأحداث – قم بتكوين تطبيقك في لوحة معلومات مدير الأحداث لتشغيل المطابقة المتقدمة التلقائية وإرسال البيانات إلى فيسبوك.
• مجموعة SDK شريك قياس أداء تطبيقات الهواتف المحمولة (MMP) – أضف رمزًا إلى تطبيقك بنظام Android أو iOS لإرسال البيانات إلى لوحة معلومات Adjust لديك.

استخدام مجموعة Facebook SDK

عند استخدام مجموعة FB SDK لإرسال بيانات أحداث تطبيق المستخدم إلى فيسبوك، ستتم تجزئة جميع بيانات المستخدم. وتتوفر هذه البيانات المجزأة بين مثيلات التطبيقات.

المتطلبات

• مجموعة Facebook SDK بالإصدار 4.36 أو الإصدارات الأحدث

نظام Android

يمكنك تعيين بيانات المستخدم أثناء تهيئة AppEventsLogger باستخدام الوظيفة setUserData. وستعمل هذه الوظيفة على تجزئة بيانات المستخدم.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

نظام iOS

يمكنك تعيين بيانات المستخدم أثناء تهيئة FBSDKAppEvents باستخدام الوظيفة setUserData. وستتم تجزئة بيانات المستخدم وتوفيرها بين مثيلات التطبيقات.

التوصيات

• للتأكد من أن المطابقة المتقدمة تعمل بشكل صحيح، نوصي بالترقية إلى أحدث إصدار من مجموعة Facebook SDK لنظام iOS. لمزيد من المعلومات، يمكنك الرجوع إلى سجل تغييرات مجموعة SDK لنظام iOS.

عينة من الرمز لتعيين نوع بيانات واحد

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

عينة من الرمز لتعيين أنواع بيانات متعددة

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

استخدام مدير الأحداث

تعمل المطابقة المتقدمة التلقائية على تكوين مجموعة Facebook SDK لديك تلقائيًا لاكتشاف بيانات المستخدم واستلامها مع الحدث أو الإجراء الذي تم في تطبيقك. وتتم تجزئة هذه البيانات قبل إرسالها إلى فيسبوك.

لتشغيل المطابقة المتقدمة التلقائية، انتقل إلى مدير الأحداث وحدّد علامة التبويب الإعدادات في تطبيقك ثم بدّل مفتاح المطابقة المتقدمة التلقائية إلى تشغيل. ويمكنك أيضًا مشاركة عناوين البريد الإلكتروني وأرقام الهواتف المجزأة.

لاحظ أنه يجب تنفيذ مجموعة Facebook SDK بالإصدار 5.8.0 أو الإصدارات الأحدث.

استخدام مجموعة Adjust SDK

إضافة بيانات العميل إلى أحداث Adjust

عند استخدام مجموعة Adjust SDK لشريك قياس أداء تطبيقات الهواتف المحمولة (MMP)، يرجى استخدام وظيفة التجزئة كما هو موضح في المثال أدناه، نظرًا لأن مجموعة MMP SDK لن تعمل على تجزئة البيانات تلقائيًا. وإذا لم تستخدم وظيفة تجزئة، فسترسل API استثناءً ولن تقبل النص العادي.

أضف معلمات بيانات العميل لإرسالها إلى شركاء الشبكة والتي تم تنشيطها في لوحة معلومات Adjust ، عن طريق استدعاء الأسلوب addPartnerParameter في المثيل ADJEvent لديك.

لاحظ أنه لا توجد حاجة إلى تنفيذ مجموعة Facebook SDK.

مثال على الرمز البرمجي لنظام Android

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

مثال على الرمز البرمجي لنظام iOS

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

لمزيد من المعلومات، يُرجى زيارة أمثلة على الرموز في Github.

تعيين معلمات Adjust إلى معلمات فيسبوك

استخدم الخطوات التالية لتعيين معلمة Adjust إلى معلمة فيسبوك في لوحة معلومات Adjust.

1. في لوحة معلومات Adjust لديك، انقر على الإعدادات في التطبيق الذي تريد تعيين معلمات الشريك به.
2. حدّد إعداد الشريك.
3. انقر على الشريك الذي تريده.
4. حدّد تعيين معلمة الشريك.
5. أدخل أسماء معلمات الشريك كما تم إرسالها إلى Adjust بواسطة مجموعة SDK في العمود الأيمن من تطبيق. ويجب أن تكون هذه هي الخطوات نفسها المُتبعة بالنسبة لكل شريك. على سبيل المثال، إذا كنت تستخدم email كاسم معلمة في مجموعة Adjust SDK، فيجب إدخال "email".
6. أدخل أسماء معلمات الشريك حسب رغبة هذا الشريك في العمود الأيسر إلى الشريك. هذه الخطوة خاصة بالشريك. يجب أن تكون المعلمة المُستخدمة في مجموعة Facebook SDK بتنسيق ud[pii_type_name]. على سبيل المثال، يجب أن تستخدم المعلمة "email" التنسيق ud[em]، وتستخدم المعلمة "phone" التنسيق ud[ph].

لمزيد من المعلومات، يُرجى زيارة وثائق Adjust.