Iklan Otomotif

Iklan Otomotif - Peristiwa

Iklan otomotif menggunakan peristiwa yang memiliki set parameter (daftar lengkap detail parameter peristiwa). Anda dapat menggunakan pixel Facebook di situs web Anda serta peristiwa aplikasi seluler di aplikasi Android dan aplikasi iOS.

Peristiwa Standar dan Wajib

  • Peristiwa standar adalah tindakan yang kami kenali dan dukung di seluruh produk iklan. Konsistensi dalam cara kami memberi nama dan mengategorikan tindakan utama ini meningkatkan kemampuan kami untuk menampilkan iklan Anda kepada orang-orang dalam daftar pemirsa yang paling mungkin mengambil tindakan yang penting bagi bisnis Anda. Lihat daftar lengkap dan praktik terbaik untuk peristiwa standar di sini.
  • Peristiwa wajib - Lihat tabel di bawah ini. Contoh kode adalah Pixel, Android, iOS untuk semua peristiwa wajib.
PeristiwaKapan MengaktifkannyaContoh Kode

Cari

Pada halaman hasil pencarian untuk pencarian kendaraan/stok

Pixel | Android | iOS

ViewContent

Di halaman web tempat Anda ingin melacak tayangan konten utama. Misalnya: halaman detail kendaraan, halaman model, promo kendaraan, atau halaman insentif.

Pixel | Android | iOS

AddToWishlist

Ketika seseorang menyimpan, memfavoritkan, atau menunjukkan ketertarikan pada tawaran kendaraan tertentu

Pixel | Android | iOS

Pixel Facebook (untuk situs web)

Panduan ini mengasumsikan Anda sudah menginstal pixel Facebook. Jika tidak, baca Menggunakan API Marketing dengan pixel.

Sebelum Memulai

  • Pastikan kode dasar pixel sudah dimuat ketika Anda memicu sebuah peristiwa.
  • Jika Anda menggunakan pengelola tag, pastikan Anda menyertakan tanda yang berisi kode pixel pada setiap halaman. Tanda ini harus muncul sebelum tanda yang berisi kode peristiwa pixel.
  • Gunakan Bantuan Pixel Facebook untuk memvalidasi implementasi pixel Anda.

Cari Peristiwa Pixel

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

Peristiwa Pixel 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
});

Peristiwa Pixel 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
});

Peristiwa Aplikasi Seluler untuk Android

Panduan ini mengasumsikan Anda telah menerapkan Facebook SDK di aplikasi seluler Android Anda. Jika belum, lihat Android SDK. Jika Anda menggunakan partner pengukuran, pastikan partner tersebut meneruskan peristiwa yang diperlukan ke Facebook.

Cari Peristiwa 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

);

Peristiwa Android ViewContent

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

);

Peristiwa Android AddToWishlist

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

);

Peristiwa Aplikasi Seluler untuk iOS

Panduan ini mengasumsikan Anda telah menerapkan Facebook SDK di aplikasi seluler iOS Anda. Jika belum, lihat iOS SDK. Jika Anda menggunakan partner pengukuran, pastikan partner tersebut meneruskan peristiwa yang diperlukan ke Facebook.

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

Peristiwa iOS ViewContent

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

    }
  ];

Peristiwa iOS AddToWishlist

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

    }
  ];

Parameter Peristiwa Aplikasi dan Pixel

Meskipun setiap pengiklan otomotif mungkin memiliki target atau kebutuhan pelacakan khusus yang sedikit berbeda di situs web, kami telah menyediakan beberapa parameter yang direkomendasikan di bawah ini berdasarkan tindakan dan KPI yang paling umum untuk situs web otomotif.

Parameter adalah bagian dari peristiwa standar yang melacak informasi tambahan tentang setiap tindakan. Misalnya, jika Anda melacak peristiwa ViewContent pada Halaman Detail Kendaraan (VDP), Anda dapat menggunakan parameter untuk juga mengambil informasi setiap kali VDP dilihat, seperti merek, model, dan tahun kendaraan.

Meskipun parameter bersifat opsional untuk pengaturan pixel secara umum, tetapi ada beberapa parameter tertentu yang bersifat wajib untuk iklan otomotif. Kami sarankan untuk menambahkannya (minimal) agar lebih mudah untuk menyiapkan DAA sekarang atau di masa mendatang.

Spesifikasi Parameter Peristiwa Aplikasi

  • Pada seluler, nama parameter berbeda dengan pixel Facebook. Sering diawali dengan fb_, dengan sedikit pengecualian, misalnya content_ids versus fb_content_id, value versus _valueToSum.
  • Ketika Anda mengirim banyak nilai (misalnya, dengan content_ids atau content_type) maka hasilnya adalah array nilai yang dikodekan dengan JSON: ["value1", "value2"]. Catatan: Jangan menggabungkan nilai dengan koma.
Kolom dan JenisDeskripsi

event_name

Jenis: string

Wajib untuk Search, ViewContent, AddToWishlist.

Nama peristiwa yang telah ditentukan sebelumnya yang memungkinkan Anda untuk mengukur kinerja kampanye dan merekam niat dari pemirsa Anda.

content_ids

Jenis: array string

Wajib untuk ViewContent, AddToWishlist. Direkomendasikan untuk Search.

ID yang relevan seperti yang tercantum dalam katalog kendaraan Anda.

Contoh: ['123', 456]

content_type

Jenis: string

Direkomendasikan untuk Search, ViewContent, AddToWishlist.

Jenis produk atau konten. Nilai yang didukung: value.

postal_code

Jenis: string

Direkomendasikan.

Kode pos untuk lokasi kendaraan.

Contoh: 94112

country

Jenis: string

Direkomendasikan.

Nama negara untuk lokasi kendaraan.

Contoh: New Zealand

make

Jenis: string

Direkomendasikan.

Tipe/merek/produsen kendaraan.

Contoh: Ford, Toyota, Honda

model

Jenis: string

Direkomendasikan.

Model kendaraan.

Contoh: F-150, Camry, Accord

year

Jenis: integer

Direkomendasikan.

Tahun kendaraan diluncurkan dalam format yyyy.

Contoh: 2013

state_of_vehicle

Jenis: enum

Direkomendasikan.

Penting untuk mengetahui apakah kendaraan tersebut baru atau bekas. Nilai yang didukung: New, Used, CPO

mileage.value

Jenis: integer

Direkomendasikan.

Jarak tempuh kendaraan (dalam km atau mil); nol (0) untuk kendaraan baru.

Contoh: 5000

mileage.unit

Jenis: string

Direkomendasikan.

Satuan jarak tempuh dalam mil (MI) atau kilometer (KM)

exterior_color

Jenis: string

Direkomendasikan.

Warna eksterior kendaraan.

Contoh: black, blue, white, dan seterusnya

transmission

Jenis: enum

Direkomendasikan.

Jenis transmisi kendaraan. Nilai yang didukung: Automatic, Manual, Other

body_style

Jenis: enum

Direkomendasikan.

Gaya bodi kendaraan. Nilai yang didukung: Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Other

fuel_type

Jenis: enum

Direkomendasikan.

Jenis BBM kendaraan. Nilai yang didukung: Diesel, Electric, Flex, Gasoline, Hybrid, Other

drivetrain

Jenis: enum

Direkomendasikan.

Jenis penggerak roda kendaraan. Nilai yang didukung:AWD, FOUR_WD, FWD, RWD, TWO_WD, Other

price

Jenis: float

Direkomendasikan.

Harga kendaraan.

Contoh: 8000

preferred_price_range

Jenis: [float (min), float (maks)]

Direkomendasikan.

Kisaran harga kendaraan.

Contoh: [8000, 12000]

currency

Jenis: string

Direkomendasikan.

Mata uang untuk price dan price_range. Gunakan format mata uang ISO 4217, seperti "USD".

trim

Jenis: string

Direkomendasikan.

Trim kendaraan.

Contoh: 5DR HB SE

vin

Jenis: string

Direkomendasikan.

Nomor identifikasi kendaraan. Karakter maksimum: 17

Contoh: KL9CD9S99EC111111

interior_color

Jenis: string

Opsional.

Warna interior kendaraan.

Contoh: Black, White, Blue, dan seterusnya

condition_of_vehicle

Jenis: enum

Opsional.

Kondisi fisik kendaraan. Nilai yang didukung: Excellent, Good, Fair, Poor, Other.

viewcontent_type

Jenis: string

Opsional untuk ViewContent.

Gunakan viewcontent_type untuk membedakan antara halaman tujuan prospek potensial.

Contoh: Model Page, Offers Page

search_type

Jenis: string

Opsional untuk Search.

Gunakan search_type untuk membedakan pencarian pengguna lain (seperti pencarian dealer) dari pencarian stok.

Contoh: Dealer Locator

registriation_type

Jenis: string

Opsional untuk CompleteRegistration.

Gunakan registriation_type untuk membedakan berbagai jenis pendaftaran pelanggan di situs web.

Contoh: Brochure request