المرجع

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

يمكنك استخدام وظيفة fbq('track') لبيكسل Meta لتتبع الأحداث القياسية التالية. كما تدعم الأحداث القياسية كائنات المعلمة المزوّدة بخصائص محددة للكائن والتي تسمح لك بتضمين معلومات تفصيلية حول حدث ما.

إذا كنت تقوم بتنفيذ بيكسل Meta بجانب واجهة API التحويلات، فنوصيك بتضمين المعلمة eventID كمعلمة رابعة إلى الوظيفة fbq(‘track’). راجع وثائق إلغاء تكرار أحداث الخادم والبيكسل لمزيد من المعلومات.

اسم الحدث	وصف الحدث	خصائص الكائنات	قيمة custom_event_type للكائن الذي يتم ترويجه
`AddPaymentInfo`	عند إضافة معلومات دفع في دفق إتمام الشراء. ينقر شخص على زر حفظ معلومات الفوترة.	`content_ids`, `contents`, `currency`, `value` اختياري.	ADD_PAYMENT_INFO
`AddToCart`	عند إضافة منتج إلى عربة التسوق. ينقر شخص على زر إضافة إلى عربة التسوق.	`content_ids`, `content_type`, `contents`, `currency`, `value` اختياري. مطلوب لإعلانات كتالوج Advantage+: `contents`	ADD_TO_CART
`AddToWishlist`	عند إضافة منتج إلى قائمة رغبات. ينقر شخص على زر إضافة إلى قائمة الرغبات.	`content_ids`, `contents`, `currency`, `value` اختياري.	ADD_TO_WISHLIST
`CompleteRegistration`	عند اكتمال نموذج تسجيل. يرسل شخص نموذج تسجيل أو اشتراك مكتملاً.	`currency`، `value` اختياري.	COMPLETE_REGISTRATION
`Contact`	عندما يبدأ شخص بالتواصل مع نشاطك التجاري عبر الهاتف أو رسالة SMS أو رسالة بريد إلكتروني أو دردشة أو غير ذلك. يرسل شخص سؤالاً حول منتج.	اختياري.	CONTACT
`CustomizeProduct`	عندما يخصص شخص منتجًا. يحدد شخص لون قميص.	اختياري.	CUSTOMIZE_PRODUCT
`Donate`	عندما يتبرع شخص بأموال لمؤسستك أو قضيتك. يضيف شخص تبرعًا لصالح جمعية الرفق بالحيوان إلى عربة التسوق.	اختياري.
`FindLocation`	عندما يبحث شخص عن موقع متجرك عبر موقع ويب أو تطبيق مع إبداء النية لزيارة الموقع الفعلي. يريد شخص العثور على منتج محدد في متجر محلي.	اختياري.	FIND_LOCATION
`InitiateCheckout`	عندما يدخل شخص إلى دفق إتمام الشراء قبل اكتمال دفق إتمام الشراء. ينقر شخص على زر إتمام الشراء.	`content_ids`، `contents`، `currency`، `num_items`، `value` اختياري.	INITIATE_CHECKOUT
`Lead`	عند اكتمال تسجيل. ينقر شخص على زر التسعير.	`currency`، `value` اختياري.	LEAD
`Purchase`	عند إجراء عملية شراء أو إكمال دفق إتمام شراء. أكمل شخص عملية الشراء أو دفق إتمام الشراء وتم توجيهه إلى صفحة الشكر أو صفحة التأكيد.	`content_ids`، `content_type`، `contents`، `currency`، `num_items`، `value` مطلوب:`currency` و`value` مطلوب لإعلانات كتالوج Advantage+: `contents` أو `content_ids`	PURCHASE
`Schedule`	عندما يحجز شخص موعدًا لزيارة أحد مواقعك. يحدد شخص ما تاريخ ووقت تدريب التنس.	اختياري.	SCHEDULE
`Search`	عند إجراء عملية بحث. يبحث شخص ما عن منتج في موقعك على الويب.	`content_ids`، `content_type`، `contents`، `currency`، `search_string`، `value` اختياري. مطلوب لإعلانات كتالوج Advantage+: `contents` أو `content_ids`	SEARCH
`StartTrial`	عندما يبدأ شخص في استخدام نسخة تجريبية مجانية لأحد المنتجات أو الخدمات التي تعرضها. يحدد شخص أسبوعًا مجانيًا لتجربة لعبتك.	`currency`، `predicted_ltv`، `value` اختياري.	START_TRIAL
`SubmitApplication`	عندما يقدم شخص طلبًا للحصول على منتج أو خدمة أو برنامج تعرضه. يقدم شخص طلبًا للحصول على بطاقة ائتمان أو برنامج تعليمي أو وظيفة.	اختياري.	SUBMIT_APPLICATION
`Subscribe`	عندما يقدم شخص طلبًا لبدء اشتراك مدفوع للحصول على منتج أو خدمة تعرضها. يشترك شخص في خدمة البث لديك.	`currency`، `predicted_ltv`، `value` اختياري.	SUBSCRIBE
`ViewContent`	يمكن زيارة إحدى صفحات الويب التي تهتم بها (على سبيل المثال، صفحة منتج أو صفحة مقصودة). ويخبرك `ViewContent` بما إذا كان شخص ما قد زار عنوان URL الخاص بصفحة الويب أم لا، ولكن لا يخبرك بما عرضه هذا الشخص أو قام به على هذه الصفحة. يتم توجيه الشخص إلى صفحة تفاصيل المنتج.	`content_ids`, `content_type`, `contents`, `currency`, `value` اختياري. مطلوب لإعلانات كتالوج Advantage+: `contents` أو `content_ids`	VIEW_CONTENT

خصائص الكائنات

يمكنك تضمين خصائص الكائنات المحددة مسبقًا التالية وأي أحداث مخصصة وأي أحداث قياسية تدعمها. قم بتنسيق بيانات كائن المعلمة لديك باستخدام JSON. تعرف على المزيد حول معلمات الحدث من خلال Blueprint.

مفتاح الخاصية	نوع القيمة	وصف المعلمة
`content_category`	String (سلسلة)	فئة الصفحة/المنتج. اختياري.
`content_ids`	مصفوفة الأعداد الصحيحة أو السلاسل	معرفات المنتجات المرتبطة بالحدث، مثل وحدات حفظ المخزون (مثل `['ABC123', 'XYZ789']`).
`content_name`	String (سلسلة)	اسم الصفحة/المنتج. اختياري.
`content_type`	String (سلسلة)	إما `product` أو `product_group` بناءً على `content_ids` أو `contents` التي يتم إدخالها. إذا كانت المعرفات التي يتم تمريرها في المعلمة `content_ids` أو `contents` تمثل معرفات المنتجات، فمن ثمّ يجب أن تكون بالقيمة `product`. في حالة تمرير معرفات مجموعة المنتجات، من ثمّ يجب أن تكون بالقيمة `product_group`. إذا لم يتم تقديم أي `content_type`، فستطابق Meta الحدث لكل عنصر يحتوي على المعرف ذاته، بغض النظر عن النوع.
`contents`	مصفوفة الكائنات	مصفوفة بكائنات JSON تحتوي على الكمية ورقم المقالة العالمي (EAN) إذا أمكن أو معرف (معرفات) منتج أو محتوى آخر. ويكون الحقلان `id` و`quantity` هما الحقلين المطلوبين. على سبيل المثال `[{'id': 'ABC123', 'quantity': 2}, {'id': 'XYZ789', 'quantity': 2}]`.
`currency`	String (سلسلة)	عملة `value` المحددة.
`num_items`	Integer (عدد صحيح)	يتم استخدامه مع حدث `InitiateCheckout`. عدد العناصر عند بدء إتمام الشراء.
`predicted_ltv`	عدد صحيح، عدد عشري	القيمة الدائمة المتوقعة للمشترك كما حددها المعلن وتم عرضها على أنها قيمة دقيقة.
`search_string`	String (سلسلة)	يتم استخدامه مع الحدث `Search`. السلسلة التي أدخلها المستخدم للبحث.
`status`	Boolean (قيمة منطقية)	يتم استخدامها مع الحدث `CompleteRegistration`، لعرض حالة التسجيل. اختياري.
`value`	عدد صحيح أو عدد عشري	قيمة المستخدم الذي يقوم بهذا الحدث للنشاط التجاري.