โฆษณายานยนต์ใช้เหตุการณ์ที่มีชุดพารามิเตอร์ (รายการทั้งหมดของรายละเอียดพารามิเตอร์เหตุการณ์) คุณสามารถใช้พิกเซล Facebook กับเหตุการณ์บนเว็บไซต์หรือในแอพมือถือในแอพ Android และแอพ iOS ของคุณได้
เหตุการณ์ | เวลาที่ใช้งาน | ตัวอย่างรหัส |
---|---|---|
Search | ในหน้าผลการค้นหาสำหรับการค้นหายานพาหนะ/สินค้าคงคลัง | |
ViewContent | ในหน้าเว็บที่คุณต้องการติดตามยอดดูเนื้อหาหลัก ตัวอย่างเช่น หน้ารายละเอียดยานพาหนะ หน้ารุ่น ข้อเสนอยานพาหนะ หรือหน้าการส่งเสริมการขาย | |
AddToWishlist | เมื่อมีคนบันทึก เพิ่มในรายการโปรด หรือสนใจรายการสินค้ายานพาหนะใดเป็นพิเศษ |
คำแนะนำนี้ได้สมมติว่าคุณได้ติดตั้งพิกเซลของ Facebook แล้ว หากยังไม่ได้ติดตั้ง โปรดดูการใช้ Marketing 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 หากคุณใช้พาร์ทเนอร์การวัดผล ให้ตรวจสอบว่าได้ผ่านเหตุการณ์ที่จำเป็นต้องใช้ไปยัง Facebook
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 หากคุณใช้พาร์ทเนอร์การวัดผล ให้ตรวจสอบว่าได้ผ่านเหตุการณ์ที่จำเป็นต้องใช้ไปยัง Facebook
// 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, } ];
ถึงแม้ว่าผู้ลงโฆษณายานยนต์แต่ละรายอาจมีเป้าหมายหรือความต้องการในการติดตามที่กำหนดเองซึ่งแตกต่างกันเล็กน้อย แต่เราก็ได้จัดเตรียมพารามิเตอร์ที่แนะนำไว้ในตารางด้านล่างนี้ โดยอิงตามการดำเนินการที่พบบ่อยที่สุดและ KPI สำหรับเว็บไซต์ยานยนต์
พารามิเตอร์คือเหตุการณ์มาตรฐานระดับย่อยที่คอยติดตามข้อมูลเพิ่มเติมเกี่ยวกับการดำเนินการแต่ละรายการ ตัวอย่างเช่น หากคุณติดตามเหตุการณ์ ViewContent
ในหน้ารายละเอียดยานพาหนะ (VDP) คุณสามารถใช้พารามิเตอร์ต่างๆ เพื่อบันทึกข้อมูลทุกครั้งที่มีการดู VDP เช่น ยี่ห้อ รุ่น และปีของยานพาหนะได้เช่นกัน
แม้ว่าพารามิเตอร์จะเป็นตัวเลือกที่ไม่ได้บังคับสำหรับการตั้งค่าพิกเซลทั่วไป แต่มีพารามิเตอร์พิเศษบางตัวที่จำเป็นต้องใช้สำหรับโฆษณายานยนต์ เราแนะนำให้เพิ่มพารามิเตอร์เหล่านั้น (ขั้นต่ำ) เพื่อให้ตั้งค่า DAA ตอนนี้หรือในอนาคตได้ง่ายขึ้น
fb_
โดยมีข้อยกเว้นบางประการ เช่น content_ids
กับ fb_content_id
และ value
กับ _valueToSum
content_ids
หรือ content_type
) จะเป็นการระบุอาร์เรย์ของค่าที่เข้ารหัส JSON: '["value1", "value2"]'
หมายเหตุ: ห้ามเชื่อมโยงด้วยเครื่องหมายจุลภาคช่องและประเภท | คำอธิบาย |
---|---|
ประเภท: สตริง | จำเป็นต้องใช้สำหรับ ชื่อเหตุการณ์ที่กำหนดไว้ล่วงหน้าซึ่งคุณใช้วัดผลประสิทธิภาพการทำงานแคมเปญของคุณและบันทึกข้อมูลความสนใจจากกลุ่มเป้าหมายของคุณได้ |
ประเภท: อาร์เรย์ของสตริง | จำเป็นต้องใช้สำหรับ ID ที่เกี่ยวข้องตามที่ระบุไว้ในแค็ตตาล็อกยานพาหนะของคุณ ตัวอย่าง: |
ประเภท: สตริง | แนะนำสำหรับ ประเภทผลิตภัณฑ์และเนื้อหา ค่าที่รองรับ: |
ประเภท: สตริง | แนะนำ รหัสไปรษณีย์สำหรับตำแหน่งของยานพาหนะ ตัวอย่าง: |
ประเภท: สตริง | แนะนำ ชื่อประเทศสำหรับตำแหน่งของยานพาหนะ ตัวอย่าง: |
ประเภท: สตริง | แนะนำ ผู้สร้าง/แบรนด์/ผู้ผลิตยานพาหนะ ตัวอย่าง: |
ประเภท: สตริง | แนะนำ รุ่นของยานพาหนะ ตัวอย่าง: |
ประเภท: จำนวนเต็ม | แนะนำ ปีที่เปิดตัวยานพาหนะดังกล่าวในรูปแบบ yyyy ตัวอย่าง: |
ประเภท: enum | แนะนำ จำเป็นที่จะต้องทราบว่าเป็นยานพาหนะใหม่หรือยานพาหนะมือสอง ค่าที่รองรับs: |
ประเภท: จำนวนเต็ม | แนะนำ ระยะทางวิ่งของยานพาหนะ (เป็นหน่วยกม. หรือไมล์); ศูนย์ ( ตัวอย่าง: |
ประเภท: สตริง | แนะนำ หน่วยวัดระยะทางวิ่งเป็นไมล์ ( |
ประเภท: สตริง | แนะนำ สีภายนอกของยานพาหนะ ตัวอย่าง: |
ประเภท: enum | แนะนำ ระบบเกียร์ของยานพาหนะ ค่าที่รองรับ: |
ประเภท: enum | แนะนำ สไตล์ของยานพาหนะ ค่าที่รองรับ: |
ประเภท: enum | แนะนำ ประเภทเชื้อเพลิงของยานพาหนะ ค่าที่รองรับ: |
ประเภท: enum | แนะนำ ระบบขับเคลื่อนของยานพาหนะ ค่าที่รองรับ: |
ประเภท: ทศนิยม | แนะนำ ราคาของยานพาหนะ ตัวอย่าง: |
ประเภท: [ทศนิยม (ขั้นต่ำ), ทศนิยม (สูงสุด)] | แนะนำ ช่วงราคาของยานพาหนะ ตัวอย่าง: |
ประเภท: สตริง | แนะนำ สกุลเงินสำหรับ |
ประเภท: สตริง | แนะนำ รุ่นย่อยของยานพาหนะ ตัวอย่าง: |
ประเภท: สตริง | แนะนำ หมายเลขประจำยานพาหนะ สูงสุด 17 อักขระ ตัวอย่าง: |
ประเภท: สตริง | ระบุหรือไม่ก็ได้ สีภายในยานพาหนะ ตัวอย่าง: |
ประเภท: enum | ระบุหรือไม่ก็ได้ สภาพทางกายภาพของยานพาหนะ ค่าที่รองรับ: |
ประเภท: สตริง | ระบุหรือไม่ก็ได้สำหรับ ใช้ ตัวอย่าง: |
ประเภท: สตริง | ระบุหรือไม่ก็ได้สำหรับ ใช้ ตัวอย่าง: |
ประเภท: สตริง | ระบุหรือไม่ก็ได้สำหรับ ใช้ ตัวอย่าง: |