تستخدم إعلانات السيارات أحداثًا تحتوي على مجموعة من المعلمات (قائمة كاملة بتفاصيل معلمة الحدث). يمكنك استخدام بيكسل فيسبوك في أحداث موقعك على الويب وتطبيق الهاتف المحمول في تطبيق Android وتطبيق iOS.
الحدث | وقت التشغيل | عينة من الرمز |
---|---|---|
Search | في صفحات نتائج البحث لعمليات البحث عن المركبات/المخزون | |
ViewContent | في صفحات الويب حيث تريد تتبع مشاهدات المحتوى الأساسي. على سبيل المثال: صفحات تفاصيل المركبات أو صفحات الطُرز أو عروض المركبات أو الصفحات الإجراءات التحفيزية. | |
AddToWishlist | عندما يقوم شخص ما بحفظ قائمة مركبات معينة أو إضافتها إلى المفضلة أو إظهار اهتمام بها |
يفترض هذا الدليل تثبيت بيكسل فيسبوك بالفعل. إذا لم تقم بتثبيته بعد، فراجع استخدام API التسويق مع البيكسل.
قبل البدء
// This sample assumes the FB Pixel base code is already loaded fbq('track', 'Search', { content_type: 'vehicle', // RECOMMENDED: If sent, it must be set to 'vehicle' content_ids: ['123'], // RECOMMENDED: array of vehicle IDs postal_code: '94025', // RECOMMENDED country: 'United States', // RECOMMENDED don't use abbreviations make: 'Lexus', // RECOMMENDED model: 'ES', // RECOMMENDED year: '2017', // RECOMMENDED state_of_vehicle: 'CPO', // RECOMMENDED exterior_color: 'black', // RECOMMENDED transmission: 'automatic', // RECOMMENDED body_style: 'sedan', // RECOMMENDED fuel_type: 'gasoline', // RECOMMENDED drivetrain: 'awd', // RECOMMDENDED price: 1234.99, // RECOMMENDED, up to 2 decimals optional currency: 'USD', // REQUIRED if price and preferred_price_range is used, currency has to be the same for both price and preferred_price_range preferred_price_range: '[10000,20000]' // Optional up to two decimals, min,max });
// This sample assumes the FB Pixel base code is already loaded fbq('track', 'ViewContent', { content_type: 'vehicle', // RECOMMENDED: If sent, it must be set to 'vehicle' content_ids: ['123'], // REQUIRED: array of vehicle IDs postal_code: '94025', // RECOMMENDED country: 'United States', // RECOMMENDED don't use abbreviations make: 'Lexus', // RECOMMENDED model: 'ES', // RECOMMENDED year: '2017', // RECOMMENDED state_of_vehicle: 'CPO', // RECOMMENDED exterior_color: 'black', // RECOMMENDED transmission: 'automatic', // RECOMMENDED body_style: 'sedan', // RECOMMENDED fuel_type: 'gasoline', // RECOMMENDED drivetrain: 'awd', // RECOMMDENDED price: 1234.99, // RECOMMENDED, up to 2 decimals optional currency: 'USD', // REQUIRED if price and preferred_price_range is used preferred_price_range: '[10000,20000]' // Optional up to two decimals, min,max });
// This sample assumes the FB Pixel base code is already loaded fbq('track', 'AddToWishlist', { content_type: 'vehicle', // RECOMMENDED: If sent, it must be set to 'vehicle' content_ids: ['123'], // REQUIRED: array of vehicle IDs postal_code: '94025', // RECOMMENDED country: 'United States', // RECOMMENDED don't use abbreviations make: 'Lexus', // RECOMMENDED model: 'ES', // RECOMMENDED year: '2017', // RECOMMENDED state_of_vehicle: 'CPO', // RECOMMENDED exterior_color: 'black', // RECOMMENDED transmission: 'automatic', // RECOMMENDED body_style: 'sedan', // RECOMMENDED fuel_type: 'gasoline', // RECOMMENDED drivetrain: 'awd', // RECOMMDENDED price: 1234.99, // RECOMMENDED, up to 2 decimals optional currency: 'USD', // REQUIRED if price and preferred_price_range is used preferred_price_range: '[10000,20000]' // Optional up to two decimals, min,max });
يفترض هذا الدليل تثبيت مجموعة Facebook SDK بالفعل في تطبيقك للهواتف المحمولة بنظام Android. إذا لم يكن الأمر كذلك، فراجع مجموعة Android SDK. إذا كنت تستخدم أحد شركاء القياس، فيجب التأكد من قيامه بإرسال الأحداث المطلوبة إلى فيسبوك.
Bundle parameters = new Bundle(); // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY // RECOMMENDED: If sent, it must be set to 'vehicle' parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "vehicle"); // RECOMMENDED: content ids - include eg top 5 search results parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"123\", \"234\", \"345\", \"456\", \"567\"]"); // top search results // RECOMMENDED: postal_code parameters.putString("fb_postal_code", "94025"); // RECOMMENDED: country parameters.putString("fb_country", "United States"); // RECOMMENDED: make // Allows you to target people based on their search of a specific make parameters.putString("fb_make", "Lexus"); // RECOMMENDED: model // Allows you to target people based on their search of a specific make model parameters.putString("fb_model", "ES"); // RECOMMENDED: year, in yyyy format // Allows you to target people based on their search for vehicles manufactured from a specific year parameters.putInt("fb_year", "2017"); // RECOMMENDED: state_of_vehicle // Allows you to target people based on their search of specific type of vehicle parameters.putString("fb_state_of_vehicle", "CPO"); // RECOMMENDED: exterior_color parameters.putString("fb_exterior_color", "black"); // RECOMMENDED: transmission parameters.putString("fb_transmission", "automatic"); // RECOMMENDED: body_style // Allows you to target people based on their search of a vehicle body style parameters.putString("fb_body_style", "sedan"); // RECOMMENDED: fuel_type parameters.putString("fb_fuel_type", "gasoline"); // RECOMMENDED: drivetrain parameters.putString("fb_drivetrain", "awd"); // RECOMMENDED: price parameters.putInt("fb_price", 1234.99); // RECOMMENDED: currency parameters.putInt("fb_currency", 'USD'); // RECOMMENDED: preferred_price_range parameters.putInt("fb_preferred_price_range", '[10000,20000]'); // Fire the 'Search' event on the search results page logger.logEvent(AppEventsConstants.EVENT_NAME_SEARCHED, parameters );
Bundle parameters = new Bundle(); // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY // REQUIRED: content id of the vehicle that is shown parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "123"); // RECOMMENDED: If sent, it must be set to 'vehicle' parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "vehicle"); // RECOMMENDED: postal_code parameters.putString("fb_postal_code", "94025"); // RECOMMENDED: country parameters.putString("fb_country", "United States"); // RECOMMENDED: make // Allows you to target people based on their search of a specific make parameters.putString("fb_make", "Lexus"); // RECOMMENDED: model // Allows you to target people based on their search of a specific make model parameters.putString("fb_model", "ES"); // RECOMMENDED: year, in yyyy format // Allows you to target people based on their search for vehicles manufactured from a specific year parameters.putInt("fb_year", "2017"); // RECOMMENDED: state_of_vehicle // Allows you to target people based on their search of specific type of vehicle parameters.putString("fb_state_of_vehicle", "CPO"); // RECOMMENDED: exterior_color parameters.putString("fb_exterior_color", "black"); // RECOMMENDED: transmission parameters.putString("fb_transmission", "automatic"); // RECOMMENDED: body_style // Allows you to target people based on their search of a vehicle body style parameters.putString("fb_body_style", "sedan"); // RECOMMENDED: fuel_type parameters.putString("fb_fuel_type", "gasoline"); // RECOMMENDED: drivetrain parameters.putString("fb_drivetrain", "awd"); // RECOMMENDED: price parameters.putInt("fb_price", 1234.99); // RECOMMENDED: currency parameters.putInt("fb_currency", 'USD'); // RECOMMENDED: preferred_price_range parameters.putInt("fb_preferred_price_range", '[10000,20000]'); // Fire the 'ViewContent' event on the vehicle details or other specific content page logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT, parameters );
Bundle parameters = new Bundle(); // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY // REQUIRED: content id of the vehicle that is added to wishlist parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "123"); // RECOMMENDED: If sent, it must be set to 'vehicle' parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "vehicle"); // RECOMMENDED: postal_code parameters.putString("fb_postal_code", "94025"); // RECOMMENDED: country parameters.putString("fb_country", "United States"); // RECOMMENDED: make // Allows you to target people based on their search of a specific make parameters.putString("fb_make", "Lexus"); // RECOMMENDED: model // Allows you to target people based on their search of a specific make model parameters.putString("fb_model", "ES"); // RECOMMENDED: year, in yyyy format // Allows you to target people based on their search for vehicles manufactured from a specific year parameters.putInt("fb_year", "2017"); // RECOMMENDED: state_of_vehicle // Allows you to target people based on their search of specific type of vehicle parameters.putString("fb_state_of_vehicle", "CPO"); // RECOMMENDED: exterior_color parameters.putString("fb_exterior_color", "black"); // RECOMMENDED: transmission parameters.putString("fb_transmission", "automatic"); // RECOMMENDED: body_style // Allows you to target people based on their search of a vehicle body style parameters.putString("fb_body_style", "sedan"); // RECOMMENDED: fuel_type parameters.putString("fb_fuel_type", "gasoline"); // RECOMMENDED: drivetrain parameters.putString("fb_drivetrain", "awd"); // RECOMMENDED: price parameters.putInt("fb_price", 1234.99); // RECOMMENDED: currency parameters.putInt("fb_currency", 'USD'); // RECOMMENDED: preferred_price_range parameters.putInt("fb_preferred_price_range", '[10000,20000]'); // Fire the 'AddToWishlist' event on the vehicle details or other specific content page logger.logEvent(AppEventsConstants.EVENT_NAME_ADDED_TO_WISHLIST, parameters );
يفترض هذا الدليل تثبيت مجموعة Facebook SDK بالفعل في تطبيقك للهواتف المحمولة بنظام iOS. إذا لم يكن الأمر كذلك، فراجع مجموعة iOS SDK. إذا كنت تستخدم أحد شركاء القياس، فيجب التأكد من قيامه بإرسال الأحداث المطلوبة إلى فيسبوك.
// Fire the 'Search' event on the search results page [FBSDKAppEvents logEvent:FBSDKAppEventNameSearched // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY parameters:@{ // RECOMMENDED: If sent, it must be set to 'vehicle' FBSDKAppEventParameterNameContentType : @"vehicle", // RECOMMENDED: content ids - include eg top 5 search results FBSDKAppEventParameterNameContentID : @"[\"123\", \"234\", \"345\", \"456\", \"567\"]", // RECOMMENDED: postal_code @"fb_postal_code" : @"94110", // RECOMMENDED: country @"fb_country" : @"US", // RECOMMENDED: make // Allows you to target people based on their search of a specific make @"fb_make" : @"Toyota", // RECOMMENDED: model // Allows you to target people based on their search of a specific make model @"fb_model" : @"Camry", // RECOMMENDED: year, in yyyy format @"fb_year" : @"2015", // RECOMMENDED: state_of_vehicle // Allows you to target people based on their search of specific type of vehicle @"fb_state_of_vehicle" : @"CPO", // RECOMMENDED: exterior_color @"fb_exterior_color" : @"black", // RECOMMENDED: transmission @"fb_transmission" : @"automatic", // RECOMMENDED: body_style // Allows you to target people based on their search of a vehicle body style @"fb_body_style" : @"Sedan", // RECOMMENDED: fuel_type @"fb_fuel_type" : @"gasoline", // RECOMMENDED: drivetrain @"fb_drivetrain" : @"awd", // RECOMMENDED: price @"fb_price" : @18000, // RECOMMENDED: currency @"fb_currency" : @"USD", // RECOMMENDED: preferred_price_range @"fb_preferred_price_range" : @"[10000,20000]", } ];
// Fire the 'ViewContent' event on the search results page [FBSDKAppEvents logEvent:FBSDKAppEventNameViewedContent // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY parameters:@{ // REQUIRED: content ids for vehicle shown FBSDKAppEventParameterNameContentID : @"123", // RECOMMENDED: If sent, it must be set to 'vehicle' FBSDKAppEventParameterNameContentType : @"vehicle", // RECOMMENDED: postal_code @"fb_postal_code" : @"94110", // RECOMMENDED: country @"fb_country" : @"US", // RECOMMENDED: make // Allows you to target people based on their search of a specific make @"fb_make" : @"Toyota", // RECOMMENDED: model // Allows you to target people based on their search of a specific make model @"fb_model" : @"Camry", // RECOMMENDED: year, in yyyy format @"fb_year" : @"2015", // RECOMMENDED: body_style // Allows you to target people based on their search of a vehicle body style @"fb_body_style" : @"Sedan", // RECOMMENDED: state_of_vehicle // Allows you to target people based on their search of specific type of vehicle @"fb_state_of_vehicle" : @"CPO", // RECOMMENDED: exterior_color @"fb_exterior_color" : @"black", // RECOMMENDED: transmission @"fb_transmission" : @"automatic", // RECOMMENDED: fuel_type @"fb_fuel_type" : @"gasoline", // RECOMMENDED: drivetrain @"fb_drivetrain" : @"FWD", // RECOMMENDED: price @"fb_price" : 18000, } ];
// Fire the 'AddToWishlist' event on the search results page [FBSDKAppEvents logEvent:FBSDKAppEventNameAddedToWishlist // IF YOU CHOOSE NOT TO USE A RECOMMENDED PARAM, THEN REMOVE IT, DON'T LEAVE IT EMPTY parameters:@{ // REQUIRED: content id of vehicle added to wishlist FBSDKAppEventParameterNameContentID : @"123", // RECOMMENDED: If sent, it must be set to 'vehicle' FBSDKAppEventParameterNameContentType : @"vehicle", // RECOMMENDED: postal_code @"fb_postal_code" : @"94110", // RECOMMENDED: country @"fb_country" : @"US", // RECOMMENDED: make // Allows you to target people based on their search of a specific make @"fb_make" : @"Toyota", // RECOMMENDED: model // Allows you to target people based on their search of a specific make model @"fb_model" : @"Camry", // RECOMMENDED: year, in yyyy format @"fb_year" : @"2015", // RECOMMENDED: body_style // Allows you to target people based on their search of a vehicle body style @"fb_body_style" : @"Sedan", // RECOMMENDED: state_of_vehicle // Allows you to target people based on their search of specific type of vehicle @"fb_state_of_vehicle" : @"CPO", // RECOMMENDED: exterior_color @"fb_exterior_color" : @"black", // RECOMMENDED: transmission @"fb_transmission" : @"automatic", // RECOMMENDED: fuel_type @"fb_fuel_type" : @"gasoline", // RECOMMENDED: drivetrain @"fb_drivetrain" : @"FWD", // RECOMMENDED: price @"fb_price" : 18000, } ];
على الرغم من أن كل معلن عن السيارات قد يكون لديه أهدافًا مختلفة قليلاً أو احتياجات تتبع مخصصة على موقع الويب، فإننا نوفر بعض المعلمات الموصى بها أدناه استنادًا إلى الإجراءات ومؤشرات الأداء الأساسية الأكثر شيوعًا في مواقع الويب الخاصة بالسيارات.
المعلمات هي مجموعات فرعية من حدث قياسي يتتبع معلومات إضافية حول كل إجراء. على سبيل المثال، إذا كنت تتتبع حدث ViewContent
في إحدى صفحات تفاصيل المركبات (VDP)، فيمكنك استخدام معلمات، مثل الشركة المصنّعة للمركبة وطرازها وعام الصنع، للحصول أيضًا على معلومات في كل مرة تتم فيها مشاهدة صفحة تفاصيل المركبة.
على الرغم من أن المعلمات اختيارية لإعداد البيكسل العام، فإن هناك بعض المعلمات المحددة المطلوبة لإعلانات السيارات. نوصي بإضافة هذه المعلمات (على الأقل) لتسهيل إعداد DAA حاليًا أو في المستقبل.
fb_
مع بعض الاستثناءات مثل content_ids
مقابل fb_content_id
وvalue
مقابل _valueToSum
.content_ids
أو content_type
)، يتم توفير مصفوفة من القيم بتشفير JSON: ["value1", "value2"]
. ملاحظة: لا تحاول تعيين تسلسيل القيم باستخدام فاصلة.الحقل والنوع | الوصف |
---|---|
النوع: string (سلسلة) | مطلوب لـ أسماء الأحداث المحددة مسبقًا التي تسمح لك بقياس أداء حملاتك الإعلانية وتحديد نية جمهورك. |
النوع: array of strings (مصفوفة السلاسل) | مطلوب لـ المعرف ذو الصلة كما هو مدرج في كتالوج السيارات. مثال: |
النوع: string (سلسلة) | موصى به لـ نوع المنتج أو المحتوى. القيمة المدعومة: |
النوع: string (سلسلة) | موصى به. الرمز البريدي لموقع السيارة. مثال: |
النوع: string (سلسلة) | موصى به. اسم البلد الذي يوجد فيه موقع السيارة. المثال: |
النوع: string (سلسلة) | موصى به. ماركة السيارة/ العلامة التجارية/المصنِّع. مثال: |
النوع: string (سلسلة) | موصى به. طراز المركبة. مثال: |
النوع: integer (عدد صحيح) | موصى به. سنة طرح المركبة بتنسيق yyyy. مثال: |
النوع: enum (تعداد) | موصى به. أساسي لمعرفة إذا ما كانت المركبة جديدة أم مستعملة. القيم المدعومة: |
النوع: integer (عدد صحيح) | موصى به. المسافة التي قطعتها السيارة (بالكيلومتر أو الأميال)؛ صفر ( مثال: |
النوع: string (سلسلة) | موصى به. وحدات المسافة المقطوعة بالأميال ( |
النوع: string (سلسلة) | موصى به. اللون الخارجي للمركبة. مثال: |
النوع: enum (تعداد) | موصى به. نوع ناقل الحركة. القيم المدعومة: |
النوع: enum (تعداد) | موصى به. تصميم جسم السيارة. القيم المدعومة: |
النوع: enum (تعداد) | موصى به. نوع الوقود المُستخدم بالمركبة. القيم المدعومة: |
النوع: enum (تعداد) | موصى به. مجموعة نقل القدرة بالمركبة. القيم المدعومة: |
النوع: float (رقم عشري) | موصى به. سعر السيارة. مثال: |
النوع: [float (min)، float (max)] [رقم عشري (الحد الأدنى)، رقم عشري (الحد الأقصى)] | موصى به. نطاق سعر السيارة. مثال: |
النوع: string (سلسلة) | موصى به. العملة لـ |
النوع: string (سلسلة) | موصى به. تجهيزات المركبة. المثال: |
النوع: string (سلسلة) | موصى به. رقم تعريف المركبة. الحد الأقصى للأحرف: 17 مثال: |
النوع: string (سلسلة) | اختياري. اللون الداخلي للمركبة. مثال: |
النوع: enum (تعداد) | اختياري. الحالة الفعلية للمركبة. القيم المدعومة: |
النوع: string (سلسلة) | اختياري لـ استخدم مثال: |
النوع: string (سلسلة) | اختياري لـ استخدم مثال: |
النوع: string (سلسلة) | اختياري لـ استخدم مثال: |