자동차 광고 - 이벤트

자동차 광고는 매개변수 세트가 있는 이벤트를 사용합니다(이벤트 매개변수 상세 정보의 전체 리스트). Android 앱 및 iOS 앱의 웹사이트 및 모바일 앱 이벤트에서 Facebook 픽셀을 사용할 수 있습니다.

표준 및 필수 이벤트

  • 표준 이벤트는 Facebook이 광고 제품 전반에서 인식하고 지원하는 행동입니다. 이처럼 주요 행동의 이름을 지정하고 분류하는 방식에 일관성을 유지하면 비즈니스에 중요한 행동을 취할 가능성이 가장 큰 타겟에 속하는 사용자에게 광고를 게재하는 Facebook의 기능이 향상됩니다. 표준 이벤트의 전체 리스트 및 모범 사례는 여기를 참조하세요.
  • 필수 이벤트 - 아래의 표를 참조하세요. 모든 필수 이벤트에 대한 픽셀, Android, iOS 코드 샘플입니다.
이벤트실행 시기코드 샘플

Search

차량/인벤토리 검색에 대한 검색 결과 페이지

픽셀 | Android | iOS

ViewContent

주요 콘텐츠의 조회수를 추적하고자 하는 웹페이지. 예: 차량 상세 정보 페이지, 모델 페이지, 차량 쿠폰 또는 인센티브 페이지.

픽셀 | Android | iOS

AddToWishlist

누군가 특정 차량 품목을 저장하거나 즐겨찾기에 추가하거나 관심을 보이는 경우

픽셀 | Android | iOS

Facebook 픽셀(웹사이트용)

이 가이드에서는 Facebook 픽셀이 이미 설치되어 있다고 가정합니다. 그렇지 않은 경우 픽셀과 함께 마케팅 API 사용하기를 참조하세요.

시작하기 전에

  • 이벤트를 실행할 때는 픽셀 기본 코드를 이미 읽어들인 상태여야 합니다.
  • 태그 관리자를 사용하는 경우 모든 페이지에 픽셀 코드가 있는 태그를 포함하세요. 태그는 픽셀 이벤트 코드가 포함된 태그 앞에 표시되어야 합니다.
  • 픽셀 구현을 검증하려면 Facebook 픽셀 도우미를 사용하세요.

Search 픽셀 이벤트

    // 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
});

ViewContent 픽셀 이벤트

    // 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
});

AddToWishlist 픽셀 이벤트

// 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용 모바일 앱 이벤트

이 가이드에서는 Android 모바일 앱에서 Facebook SDK를 구현했다고 가정합니다. 그렇지 않은 경우 Android SDK를 참조하세요. 측정 파트너를 사용하는 경우 필수 이벤트를 Facebook에 전달해야 합니다.

Search Android 이벤트

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

);

ViewContent Android 이벤트

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

);

AddToWishlist Android 이벤트

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용 모바일 앱 이벤트

이 가이드에서는 iOS 모바일 앱에서 Facebook SDK를 구현했다고 가정합니다. 그렇지 않은 경우 iOS SDK를 참조하세요. 측정 파트너를 사용하는 경우 필수 이벤트를 Facebook에 전달해야 합니다.

Search iOS 이벤트

// 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]",
    }
  ];          

ViewContent iOS 이벤트

// 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, 
              

    }
  ];          

AddToWishlist iOS 이벤트

// 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를 더 쉽게 설정할 수 있도록 (최소한) 해당 특정 매개변수를 추가하는 것이 좋습니다.

앱 이벤트 매개변수 사양

  • 모바일에서 매개변수 이름은 Facebook 픽셀의 경우와 다릅니다. 일반적으로 앞에 fb_가 붙습니다(예외: content_idsfb_content_id, value_valueToSum).
  • 여러 값을 전송하는 경우(예: content_ids 또는 content_type 포함)에는 JSON 인코딩된 값의 배열(["value1", "value2"])을 제공합니다. 참고: 값을 쉼표로 연결하지 마세요.
필드 및 유형설명

event_name

유형: 문자열

Search, ViewContent, AddToWishlist필수입니다.

캠페인 성과를 측정하고 타겟으로부터 인텐트를 수집할 수 있는 사전 정의된 이벤트 이름입니다.

content_ids

유형: 문자열의 배열

ViewContent, AddToWishlist에 대해 필수입니다. Search권장됩니다.

차량 카탈로그에 나와 있는 관련 ID입니다.

예: ['123', 456]

content_type

유형: 문자열

Search, ViewContent, AddToWishlist권장됩니다.

제품 또는 콘텐츠 유형입니다. 지원되는 값은 value입니다.

postal_code

유형: 문자열

권장.

차량 위치의 우편번호입니다.

예: 94112

country

유형: 문자열

권장.

차량 위치의 국가 이름입니다.

예: New Zealand

make

유형: 문자열

권장.

차량 메이커/브랜드/제조업체입니다.

예: Ford, Toyota, Honda

model

유형: 문자열

권장.

차량 모델입니다.

예: F-150, Camry, Accord

year

유형: 정수

권장.

차량이 출시된 연도(yyyy 형식)입니다.

예: 2013

state_of_vehicle

유형: enum

권장.

신차/중고차 여부를 알기 위한 필수 항목입니다. 지원되는 값은 New, Used, CPO입니다.

mileage.value

유형: 정수

권장.

차량 주행 거리(킬로미터 또는 마일)이며, 신차의 경우 0(0)입니다.

예: 5000

mileage.unit

유형: 문자열

권장.

주행 거리 단위: 마일(MI) 또는 킬로미터(KM)

exterior_color

유형: 문자열

권장.

차량 외부 색상입니다.

예: black, blue, white 등.

transmission

유형: enum

권장.

차량 변속기 유형입니다. 지원되는 값은 Automatic, Manual, Other입니다.

body_style

유형: enum

권장.

차체 스타일입니다. 지원되는 값은 Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Other입니다.

fuel_type

유형: enum

권장.

차량의 연료 유형입니다. 지원되는 값은 Diesel, Electric, Flex, Gasoline, Hybrid, Other입니다.

drivetrain

유형: enum

권장.

차량 구동 방식입니다. 지원되는 값은 AWD, FOUR_WD, FWD, RWD, TWO_WD, Other입니다.

price

유형: 부동 소수점

권장.

차량 가격입니다.

예: 8000

preferred_price_range

유형: [float (min), float (max)]

권장.

차량 가격대입니다.

예: [8000, 12000]

currency

유형: 문자열

권장.

priceprice_range에 대한 통화입니다. ISO 4217 통화 형식(예: 'USD')을 사용합니다.

trim

유형: 문자열

권장.

차량 트림입니다.

예: 5DR HB SE

vin

유형: 문자열

권장.

차량 식별 번호입니다. 최대 글자 수: 17

예: KL9CD9S99EC111111

interior_color

유형: 문자열

선택 사항.

차량 내부 색상입니다.

예: Black, White, Blue 등.

condition_of_vehicle

유형: enum

선택 사항.

차량의 물리적 상태입니다. 지원되는 값은 Excellent, Good, Fair, Poor, Other입니다.

viewcontent_type

유형: 문자열

ViewContent에 선택 사항입니다.

viewcontent_type을 사용하여 소프트 잠재 고객 랜딩 페이지를 구분합니다.

예: Model Page, Offers Page

search_type

유형: 문자열

Search에 선택 사항입니다.

search_type을 사용하여 인벤토리 검색과 다른 사용자 검색(예: 대리점 검색)을 구분합니다.

예: Dealer Locator

registriation_type

유형: 문자열

CompleteRegistration에 선택 사항입니다.

registriation_type을 사용하여 웹사이트에서 다양한 유형의 고객 등록을 구분합니다.

예: Brochure request