البيكسل في API التسويق

بيكسل Meta هو الأداة الرئيسية التي يمكنك استخدامها لتتبع الأحداث على موقع ويب. يمكنك استخدام البيانات الواردة من بيكسل Meta من خلال API التسويق للقيام بما يلي:

  • إعداد جماهير مخصصة استنادًا إلى النشاط الذي يتم على موقع الويب
  • قياس نشاط التحويل وتحديد الإعلانات التي تؤدي إلى نتائج مثل تنفيذ عمليات شراء

المتطلبات

  • يجب أن يكون الرمز الأساسي لبيكسل Meta مثبّتًا بالفعل في كل صفحة ويب حيث ستتبع الأحداث.

تحديثات نظام iOS 14.5

نظرًا للتغييرات التي تطرأ على نظام iOS 14.5، طرحنا أداة جديدة لتتبع أحداث الويب الخاصة بالحملات الإعلانية في نظام iOS 14.5.

قياس الأحداث المُجمعة

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

تعمل عملية قياس الأحداث المجمَّعة حاليًا على تقييد النطاقات وتطبيقات الهواتف المحمولة عند 8 أحداث تحويل والتي يمكن تكوينها وإعطاؤها الأولوية لإجراء عملية قياس الأحداث المجمَّعة.

للتحقق من ملكية النطاق لديك بالنسبة لقياس الأحداث المُجمعة، تفضل بزيارة دليل التحقق من النطاق.

لمعرفة المزيد، تفضل بزيارة مركز مساعدة الأعمال.

لمزيد من المعلومات حول التغييرات الأخرى المتوفرة، تفضل بزيارة سجل التغييرات لدينا.

الأحداث القياسية

الأمثلة التالية عبارة عن أحداث قياسية يمكنك تتبعها.

Lead

تتبع حدث Lead القياسي التالي على موقع الويب.

fbq(
  'track', 'Lead', {
    content_name: 'Auto Insurance',
    content_category: 'Quote',
    value: 40.00,
    currency: 'USD'
  }
);

ViewContent

تتبع حدث ViewContent القياسي التالي على موقع الويب.

fbq(
  'track', 'ViewContent', { 
    content_type: 'product',
    content_ids: ['1234'],
    content_name: 'ABC Leather Sandal',
    content_category: 'Shoes'
    value: 0.50,
    currency: 'USD'
  }
);

Search

تتبع حدث Search القياسي التالي على موقع الويب.

fbq(
  'track', 'Search', { 
    search_string: 'leather sandals',
    content_category: 'Product Search',
    content_ids: ['1234', '2424', '1318', '6832'],
    value: 0.50,
    currency: 'USD'
  }
);

Purchase

تتبع حدث Purchase القياسي التالي في صفحة تأكيد الدفع على موقع الويب.

fbq(
  'track', 'Purchase', { 
    content_type: 'product',
    contents: [
      { 'id': '1234', 'quantity': 2, },
      { 'id': '4642', 'quantity': 1, }
    ],
    value: 25.00,
    currency: 'USD'
  }
);

الأحداث المخصصة

تتبع حدثًا مخصصًا يرتبط بموقع الويب لديك. استبدل CUSTOM-EVENT-NAME باسم الحدث المخصص لديك وcustom_parameter باسم المعلمة المخصصة.

fbq(
  'trackCustom', 'CUSTOM-EVENT-NAME', {
    custom_parameter: 'ABC',
    value: 10.00,
    currency: 'USD'
  }
);

الأحداث داخل الصفحة

تتبع الإجراءات داخل الصفحة عن طريق ربط الأحداث القياسية أو المخصصة بعناصر HTML مثل الأزرار.

<button onClick="fbq('track', 'Purchase');">Button Text</button>

أنشئ وظيفة إذا كان لديك عناصر HTML متعددة.

<script>
function onClick() {
fbq('track', 'Purchase');
};
</script>

قم باستدعاء هذه الوظيفة لتتبع أحداث Purchase لعناصر HTML المتعددة.

<button onClick="onClick()">Buy Now</button>

<button onClick="onClick()">Buy as a Gift</button>

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

تتبع بيكسل محدد

تتبع حدثًا مخصصًا واحدًا من بيكسل Meta محدد. استبدل PIXEL-ID بمعرف بيكسل Meta الذي تريد تتبعه.

<script>
  function onClick() {
    fbq(
      'trackSingleCustom', 'PIXEL-ID', 'PageView'
    );
  };
</script>

ملاحظة: لا يتحقق الأسلوب trackSingleCustom من صحة البيانات المخصصة.

إيقاف البيكسل

يمكنك إيقاف وحدات بيكسل Meta باستخدام pushState أو replaceState.

fbq.disablePushState = true;

تحسين عرض الإعلان باستخدام وحدات البيكسل

يمكنك تحسين عرض الإعلان استنادًا إلى الأحداث القياسية التي يتم تتبعها من خلال بيكسل Meta باستخدام الحقل promoted_object لنقطة النهاية /act_AD-ACCOUNT/adsets.

يعمل المثال التالي على تحسين عرض الإعلانات استنادًا إلى قيمة الشراء باستخدام بيكسل يتتبع أحداث الشراء.

تم التنسيق لإمكانية القراءة
curl -i -X POST "https://graph.facebook.com/v2.10/act_AD-ACCOUNT-ID/adsets
    ?name=Ad Set for Value Optimization
    &campaign_id=CAMPAIGN-ID
    &optimization_goal=VALUE
    &promoted_object={"pixel_id":"PIXEL-ID","custom_event_type":"PURCHASE"}
    &billing_event=IMPRESSIONS
    &daily_budget=1000
    &attribution_spec=[{'event_type': 'CLICK_THROUGH', 'window_days':'1'}]
    &access_token=ACCESS-TOKEN"

ملاحظة: قِيم conversion_specs يتم استنتاجها تلقائيًا استنادًا إلى الهدف وpromoted_object. ولا يمكنك تعيين conversion_specs يدويًا.

رمز لبيكسل الصورة فقط

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

الأحداث القياسية

<img src="https://www.facebook.com/tr?id=PIXEL-ID&amp;amp;ev=ViewContent&amp;amp;cd[content_name]=ABC%20Leather%20Sandal&amp;amp;cd[content_category]=Shoes&amp;amp;cd[content_type]=product&amp;amp;cd[content_ids]=1234&amp;amp;cd[value]=0.50&amp;amp;cd[currency]=USD&amp;amp;noscript=1" height="1" width="1" style="display:none"/>

الأحداث المخصصة

<img src="https://www.facebook.com/tr?id=PIXEL-ID&amp;amp;ev=CustomEventName&amp;amp;cd[custom_param1]=ABC&amp;amp;cd[custom_param2]=123&amp;amp;cd[value]=10.00&amp;amp;cd[currency]=USD&amp;amp;noscript=1" height="1" width="1" style="display:none"/>

راجع أيضًا