자동차 광고는 매개변수 세트가 있는 이벤트를 사용합니다(이벤트 매개변수 상세 정보의 전체 리스트). Android 앱 및 iOS 앱의 웹사이트 및 모바일 앱 이벤트에서 Facebook 픽셀을 사용할 수 있습니다.
이 가이드에서는 Facebook 픽셀이 이미 설치되어 있다고 가정합니다. 그렇지 않은 경우 픽셀과 함께 마케팅 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 });
이 가이드에서는 Android 모바일 앱에서 Facebook SDK를 구현했다고 가정합니다. 그렇지 않은 경우 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 );
이 가이드에서는 iOS 모바일 앱에서 Facebook SDK를 구현했다고 가정합니다. 그렇지 않은 경우 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를 기반으로 몇 가지 권장 매개변수를 아래와 같이 제공합니다.
매개변수는 각 행동에 대한 추가적인 정보를 추적하는 표준 이벤트의 하위 집합입니다. 예를 들어 차량 상세 정보 페이지(VDP)에서 ViewContent
이벤트를 추적하는 경우, 매개변수를 사용하여 해당 VDP가 조회될 때마다 정보(예: 차량의 제조사, 모델, 연식)를 수집할 수도 있습니다.
매개변수는 일반적인 픽셀 설정에서 선택 사항이지만 자동차 광고에 필수인 몇 가지 특정 매개변수가 있습니다. 현재 또는 나중에 DAA를 더 쉽게 설정할 수 있도록 (최소한) 해당 특정 매개변수를 추가하는 것이 좋습니다.
fb_
가 붙습니다(예외: content_ids
대 fb_content_id
, value
대 _valueToSum
).content_ids
또는 content_type
포함)에는 JSON 인코딩된 값의 배열(["value1", "value2"]
)을 제공합니다. 참고: 값을 쉼표로 연결하지 마세요.필드 및 유형 | 설명 |
---|---|
유형: 문자열 |
캠페인 성과를 측정하고 타겟으로부터 인텐트를 수집할 수 있는 사전 정의된 이벤트 이름입니다. |
유형: 문자열의 배열 |
차량 카탈로그에 나와 있는 관련 ID입니다. 예: |
유형: 문자열 |
제품 또는 콘텐츠 유형입니다. 지원되는 값은 |
유형: 문자열 | 권장. 차량 위치의 우편번호입니다. 예: |
유형: 문자열 | 권장. 차량 위치의 국가 이름입니다. 예: |
유형: 문자열 | 권장. 차량 메이커/브랜드/제조업체입니다. 예: |
유형: 문자열 | 권장. 차량 모델입니다. 예: |
유형: 정수 | 권장. 차량이 출시된 연도(yyyy 형식)입니다. 예: |
유형: enum | 권장. 신차/중고차 여부를 알기 위한 필수 항목입니다. 지원되는 값은 |
유형: 정수 | 권장. 차량 주행 거리(킬로미터 또는 마일)이며, 신차의 경우 0( 예: |
유형: 문자열 | 권장. 주행 거리 단위: 마일( |
유형: 문자열 | 권장. 차량 외부 색상입니다. 예: |
유형: enum | 권장. 차량 변속기 유형입니다. 지원되는 값은 |
유형: enum | 권장. 차체 스타일입니다. 지원되는 값은 |
유형: enum | 권장. 차량의 연료 유형입니다. 지원되는 값은 |
유형: enum | 권장. 차량 구동 방식입니다. 지원되는 값은 |
유형: 부동 소수점 | 권장. 차량 가격입니다. 예: |
유형: [float (min), float (max)] | 권장. 차량 가격대입니다. 예: |
유형: 문자열 | 권장.
|
유형: 문자열 | 권장. 차량 트림입니다. 예: |
유형: 문자열 | 권장. 차량 식별 번호입니다. 최대 글자 수: 17 예: |
유형: 문자열 | 선택 사항. 차량 내부 색상입니다. 예: |
유형: enum | 선택 사항. 차량의 물리적 상태입니다. 지원되는 값은 |
유형: 문자열 |
예: |
유형: 문자열 |
예: |
유형: 문자열 |
예: |