إعلانات كتالوج Advantage+ لتطبيقات الهواتف المحمولة

يمكنك إعداد إعلانات كتالوج Advantage+ على الهاتف المحمول من خلال مجموعات Facebook SDK. ويجب دمج إمكانية إضافة رابط لموضع معين إلى جانب إضافة رابط لموضع معين مؤجل في تطبيقك لتوفير أفضل تجربة ممكنة للأشخاص الذين يستخدمون تطبيقك.

الخطوة الأولى: إعداد مجموعة Facebook SDK للهواتف المحمولة بنظام iOS/Android

يمكنك دمج مجموعة Facebook SDK لنظام التشغيل iOS أو Android.

الخطوة الثانية: إعداد أحداث تطبيقات الهواتف المحمولة

على الويب، استخدم أحداث بيكسل Meta، مثل ViewContent لتتبع التفاعلات على الأحداث. وعلى الهاتف المحمول، يمكنك تتبع الأحداث نفسها من خلال أحداث التطبيق.

يجب إرسال الأحداث المطلوبة الثلاثة ذاتها من تطبيقك كما تفعل من البيكسل لديك: ViewContent وAddToCart وPurchase. تتطلب إعلانات كتالوج Advantage+ هذه الأحداث للعمل بشكل صحيح.

حدث iOSحدث لنظام Androidمكافئ الويب

FBSDKAppEventNameViewedContent

AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT

ViewContent

FBSDKAppEventNameAddedToCart

AppEventsConstants:: EVENT_NAME_ADDED_TO_CART

AddToCart

[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString *) parameters:(NSDictionary *)];

AppEventsConstants:: EVENT_NAME_PURCHASED

Purchase

على سبيل المثال، يتم تشغيل حدث ViewContent عندما يعرض شخص ما منتجًا في التطبيق:

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

يمكنك أيضًا توفير مصفوفة بلغة JSON تضم قيم معرف المنتج عند تشغيل أي حدث لعدة منتجات. على سبيل المثال، يمكنك إرسال عدة منتجات تتضمن الحدث Purchase.

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

معرفات المحتويات المتعددة

إذا كانت لديك معرفات محتويات متعددة، فإنك توفر مصفوفة بلغة JSON تم تجاوزها، على سبيل المثال:

"[\"1234\",\"5678\"]"

المعلمات الاختيارية

بالنسبة لكل حدث تطبيق، يمكنك إرسال معلمات إضافية؛ ويجب إرسالها عندما يجري أحد الأشخاص عملية شراء:

الاسمالوصف

_valueToSum

string (سلسلة)

اختياري.
قيمة المنتج أو مبلغ الشراء

fb_currency

string (سلسلة)

اختياري.
عملة المنتج أو مبلغ الشراء

استخدام شريك قياس أداء تطبيقات الهواتف المحمولة (MMP)

إذا كنت تستخدم شريك قياس أداء تطبيقات الهواتف المحمولة (MMP) معتمدًا للإبلاغ عن الأحداث إلى Facebook، فيمكنك ضبط التنفيذ لإرسال الأحداث المطلوبة أيضًا. وعلى الرغم من اختلاف هذه العملية حسب MMP، إلا أنها تبدو عادةً كما يلي:

  1. ضبط الدمج الخاص بك للإبلاغ عن الأحداث الثلاثة المطلوبة إلى MMP، إلى جانب المعلمات المطلوبة.
  2. من خلال MMP، يمكن تعيين أسماء الأحداث لديك إلى أسماء أحداث فيسبوك.
  3. اختبار أحداث التطبيق.

الأحداث المطلوبة لدى MMP

الأحداث التالية مطلوبة:

الاسمالوصف

fb_mobile_content_view

عندما يعرض حساب بمركز الحسابات منتجًا

fb_mobile_add_to_cart

عند إضافة عنصر إلى عربة التسوق

fb_mobile_purchase

عند شراء عنصر/عناصر

يتعين عليك أيضًا إرسال معلمتين إضافيتين حتى تعمل إعلانات كتالوج Advantage+:

  • معرف العنصر الذي تم عرضه أو إضافته إلى سلة التسوق أو شراؤه
  • سواء كان المعرف product أو product_group

المعلمات الإضافية المتوفرة هي:

الاسمالوصف

fb_content_type

string (سلسلة)

إما product أو product_group

fb_content_id

string (سلسلة)

مطلوب.
سلسلة تحتوي على مصفوفة بتشفير JSON تضم معرف تاجر التجزئة أو معرفات مجموعة المنتجات

_valueToSum

string (سلسلة)

اختيارية.
قيمة شراء المنتج

fb_currency

string (سلسلة)

اختياري.
عملة المنتج أو مبلغ الشراء

ملاحظة: يجب أيضًا إرسال المعلمتين _valueToSum وfb_currency عندما يشتري شخص ما عناصر.

اختبار أحداث التطبيق

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

  1. حدّد تطبيقًا.
  2. سترى أداتين في أسفل الصفحة. حدّد اختبار أحداث التطبيق.
  3. يتوفر لديك خياران وهما: عرض الأحداث التي يتم الإبلاغ عنها من جانبك أو بواسطة معرف إعلانات محدد. وفي معظم الحالات، يكون تحديد Me (أنا) كافيًا. تأكد من تثبيت فيسبوك على جهازك وأنك قد سجّلت الدخول.
  4. عندما تنفّذ الإجراءات في تطبيقك، تظهر الأحداث في الأداة مع المعلمات المرتبطة بها.

ستظهر أسماء الأحداث الثلاثة التالية في حالة نجاح الدمج:

  • FB_MOBILE_CONTENT_VIEW
  • FB_MOBILE_ADD_TO_CART
  • FB_MOBILE_PURCHASE

تعرف على المزيد حول أحداث تطبيقات نظامي iOS وAndroid.

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

مدير الأحداث من Facebook

.

الخطوة الثالثة: إعداد روابط لمواضع معينة

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

إعادة التوجيه إلى الويب مقابل متجر التطبيقات

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

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

الاسمالوصف

web_only

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

deeplink_with_web_fallback

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

deeplink_with_appstore_fallback

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

الخطوة الرابعة: إعداد قائمة بيانات المنتجات

يتعين عليك في هذه الخطوة توفير روابط فعلية لموضع معين لإعلانات كتالوج Advantage+ التي توفرها. راجع كتالوج المنتجات، إضافة رابط لموضع معين للمزيد من المعلومات.

الخطوة الخامسة: مواصفات التتبع

لقياس أحداث التحويل من موقع الويب وتطبيقات الهواتف المحمولة، تأكد من أن إعلانات كتالوج Advantage+ تحتوي على مجموعة مواصفات التتبع الصحيحة لهذه الأحداث:

الحدثمواصفات التتبع

offsite_conversion

{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }

app_custom_event

{'action.type':'app_custom_event','application':APP_ID}

mobile_app_install

{'action.type':'mobile_app_install','application':APP_ID}

يمكن لفيسبوك حينها تتبع أي أحداث تبدأ من جانب إعلان كتالوج Advantage+، بغض النظر عما إذا كان أحد الأشخاص يعرض موقعك على الويب أو تطبيقك. ولتعيين مواصفات التتبع هذه:

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();
curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>