معالجة أحداث واجهة API التحويلات وأحداث البيكسل المكررة

بالنسبة لأداء الإعلان المثالي، نوصي المعلنين بتنفيذ واجهة API التحويلات جنبًا إلى جنب مع بيكسل Meta. نُسمي هذا "إعدادًا متكررًا" وتوجد المزيد من التفاصيل حول هذا النهج الموصى به هنا.

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

لا يحتاج المعلنون الذين لا يرسلون الحدث ذاته مرتين عبر كل من واجهة API التحويلات وحدث بيكسل Meta إلى إعداد إلغاء التكرار لتلك الأحداث.

خيارات إلغاء تكرار الحدث

يحاول فيسبوك إلغاء تكرار الأحداث المتطابقة المرسلة من خلال حدث بيكسل Meta وواجهة API التحويلات. توجد طريقتان لإلغاء تكرار الأحداث:

معرف الحدث واسم الحدث (موصى به)

المعلمات المطلوبة

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

وصف النهج

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

1. في الأحداث المقابلة، يجب أن يتطابق eventID لبيكسل Meta مع event_id في واجهة API التحويلات.
2. في الأحداث المقابلة، يجب أن يتطابق event لبيكسل Meta مع event_name في واجهة API التحويلات.

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

لاحظ أن المعلمة eventID لحدث البيكسل هي الوسيطة الرابعة في استدعاء تتبع fbq.

المثال

fbq('track', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'});

المعرف الخارجي أو FBP

المعلمات المطلوبة

بالنسبة لهذا النهج، يجب استخدام event_name و/أو fbp و/أو external_id بشكل متسق في كل أحداث المتصفح والخادم. راجع معلمات معلومات العملاء لمعرفة المزيد من المعلومات حول المعلمتين external_id وfbp.

وصف النهج

إذا قمت بتكوين المعلمتين external_id و/أو fbp المطلوب إرسالهما عبر كل من المتصفح والخادم، فيمكننا إزالة الأحداث المتكررة تلقائيًا. فيما يلي طريقة سير العملية:

1. يمكنك إرسال حدث متصفح يتضمن event_name وfbp و/أو external_id.
2. بعد ذلك، يمكنك أن ترسل إلينا حدث خادم يتضمن event_name وfbp و/أو external_id.
3. يمكننا مقارنة حدث الخادم مع حدث المتصفح المرسل مسبقًا. على وجه التحديد، يمكننا مقارنة التركيبات event_name وfbp و/أو external_id.
4. نقوم باستخدام عدد من الإستراتيجيات لإلغاء التكرار بين الأحداث التي قد تساعد في التحسين والقياس. إذا كانت تلف أحداث الخادم والمتصفح لا تختلف بشكل كبير في محتواها، فإننا نفضل بشكل عام الحدث الذي يتم تلقيه أولاً.

تقييدات النهج

أسلوب إلغاء التكرار هذا:

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

إعداد إلغاء التكرار في بيكسل المتصفح

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

• يجب أن يكون eventID الموجود داخل المعلمة eventData الاختيارية قيمة فريدة. استنادًا إلى تطبيق بيكسل Meta، يمكنك استخدام:

  • track لإرسال الحدث لكل وحدات البيكسل في الصفحة

    fbq('track', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'});

  • trackSingle لإرسال الحدث لبيكسل واحد

    fbq('trackSingle', 'SPECIFIC_PIXEL_ID', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'});

  • إشارة بيكسل صورة تحتوي على المعلمة eid

    <img src="https://www.facebook.com/tr?id=PIXEL_ID&ev=Purchase&eid=EVENT_ID"/>

  إذا كان الحدث الذي تشاركه لا يحتوي على معلمات، مثل القيمة والعملة، فيمكنك إعداد ما يلي:

  fbq('track', 'Lead', {}, {eventID: 'EVENT_ID'});

• يجب أن يكون eventID من بيكسل Meta متطابقًا مع event_id في الحدث المقابل الوارد من واجهة API التحويلات.
• إذا وجدنا مجموعة مفاتيح الخادم نفسها (event_id وevent_name) ومجموعة مفاتيح المتصفح (eventID وevent) المُرسلة إلى معرف البيكسل نفسه في غضون 48 ساعة، فإننا نتجاهل الأحداث اللاحقة.
• إذا كنت ترسل إلينا أحداثك عبر المتصفح وواجهة API التحويلات بجانب مطابقة event_ids، فيرجى مراعاة أنه لا يتم إلغاء تكرار الأحداث إلا إذا تم تلقيها في غضون 48 ساعة من موعد استلام الحدث الأول مع event_id محدد.

التحقق من إعداد إلغاء التكرار لديك

تعرَّف على كيفية التحقق من إعداد إلغاء التكرار ودمج الأحداث في وثائق التحقق من الإعداد.

معرفة المزيد

• المعلمات
• أداة مساعدة حمولة البيانات