معلمات بيانات الحدث الأصلي

استخدم هذه المعلمات لمشاركة معلومات الحدث الأصلي الذي تريد إقرانه بواجهة API التحويلات.

المعلمةالوصف
event_name
string (سلسلة)

اختياري.
اسم حدث قياسي أو حدث مخصص.

event_time
integer (عدد صحيح)

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

order_id
string (سلسلة)

اختياري.
معرف الطلب لهذه المعاملة كسلسلة.

event_id
string (سلسلة)

اختياري.
يمكن أن يكون هذا المعرف أي سلسلة فريدة يختارها المعلن. يتم استخدام المعلمتين event_id وevent_name لإلغاء تكرار الأحداث من جانب كل من الويب (عبر بيكسل Meta) أو التطبيق (عبر مجموعة SDK أو واجهة API أحداث التطبيق) وواجهة API التحويلات. لاحظ أنه على الرغم من تحديد event_idكمعلمة اختيارية، فإنه يوصى باستخدامها لإلغاء تكرار الحدث.

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

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

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