Inserzioni per il settore automotive - Eventi

Le inserzioni per il settore automotive usano eventi che hanno un gruppo di parametri (lista completa dei dettagli dei parametri degli eventi). Puoi usare il pixel di Facebook sul tuo sito web e gli eventi nell'app mobile nella tua app Android e nell'app per iOS.

Eventi standard e obbligatori

  • Gli eventi standard sono azioni che riconosciamo e supportiamo nei prodotti pubblicitari. Inserendo le azioni principali in categorie fisse e con nomi sempre uguali, possiamo mostrare in modo efficace le tue inserzioni agli utenti del tuo pubblico più propensi a eseguire azioni più importanti per la tua azienda. Consulta la lista completa e le best practice per gli eventi standard qui.
  • Eventi obbligatori: consulta la tabella sottostante. L'esempio di codice è Pixel, Android, iOS per tutti gli eventi obbligatori.
EventoAttivazione consigliataEsempio di codice

Ricerca

Sulle pagine dei risultati di ricerca per ricerche di veicoli/inventario

Pixel | Android | iOS

ViewContent

Sulle pagine web dove vuoi monitorare le visualizzazioni dei contenuti chiave. Ad esempio: pagine di dettagli del veicolo, pagine dei modelli, offerte di veicoli o pagine di incentivi.

Pixel | Android | iOS

AddToWishlist

Quando qualcuno salva, aggiunge ai preferiti o mostra interesse per un annuncio di un veicolo specifico.

Pixel | Android | iOS

Pixel di Facebook (per i siti web)

Questa guida presume che tu abbia già installato un pixel di Facebook. In caso contrario, consulta Uso dell'API Marketing con il pixel.

Prima di iniziare

  • Assicurati che il codice base del pixel sia già caricato quando attivi un evento.
  • Se usi uno strumento di gestione dei tag, assicurati di includere il tag che contiene il codice pixel su ogni pagina. Il tag dovrebbe essere visualizzato prima del tag che contiene il codice dell'evento del pixel.
  • Usa Facebook Pixel Helper per convalidare l'implementazione del tuo pixel.

Evento del pixel 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
});

Evento del 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
});

Evento del 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
});

Eventi nell'app mobile per Android

Questa guida presume che tu abbia implementato l'SDK di Facebook nella tua app mobile Android. Se non hai eseguito l'implementazione, consulta SDK per Android. Se usi un Measurement Partner, assicurati che passi gli eventi richiesti a Facebook.

Evento Android Search

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

);

Evento 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

);

Evento 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

);

Eventi nell'app mobile per iOS

Questa guida presume che tu abbia già implementato l'SDK di Facebook nella tua app mobile iOS. Se non ha eseguito l'implementazione, consulta SDK per iOS. Se usi un Measurement Partner, assicurati che passi gli eventi richiesti a Facebook.

Evento iOS Search

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

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

    }
  ];          

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

    }
  ];          

Parametri del pixel e degli eventi nell'app

Anche se ogni inserzionista del settore automotive potrebbe avere obiettivi leggermente diversi o esigenze di monitoraggio personalizzate sul sito web, di seguito sono riportati alcuni parametri consigliati in base alle azioni più comuni e ai KPI per i siti web del settore automotive.

I parametri sono sottoinsiemi di un evento standard che monitorano informazioni aggiuntive su ogni azione. Ad esempio, se stai monitorando un evento ViewContent su una pagina di dettagli del veicolo (VDP), puoi usare parametri per acquisire informazioni anche ogni volta che viene visualizzata la VDP, come marca, modello e anno del veicolo.

Anche se i parametri sono facoltativi per la configurazione generica del pixel, ci sono alcuni parametri specifici necessari per le inserzioni per il settore automotive. Consigliamo di aggiungerli (come minimo) per facilitare la configurazione dei DAA ora o in futuro.

Specifiche dei parametri degli eventi nell'app

  • Su mobile, i nomi dei parametri sono diversi da quelli del pixel di Facebook. Spesso è anteposta la preposizione fb_ con poche eccezioni, quali content_ids vs fb_content_id, value vs _valueToSum.
  • Quando invii più valori (ad esempio, con content_ids o content_type), fornisce un array di valori codificato JSON: ["value1", "value2"]. Nota: non concatenare i valori con una virgola.
Campo e tipoDescrizione

event_name

Tipo: stringa

Obbligatorio per Search, ViewContent, AddToWishlist.

Nomi degli eventi predefiniti che ti consentono di misurare le prestazioni delle tue campagne e acquisire l'intenzione del tuo pubblico.

content_ids

Tipo: array di stringhe

Obbligatorio per ViewContent, AddToWishlist. Consigliato per Search.

ID pertinente come indicato nel tuo catalogo di veicoli.

Esempio: ['123', 456]

content_type

Tipo: stringa

Consigliato per Search, ViewContent, AddToWishlist.

Tipo di prodotto o contenuto. Valore supportato: value.

postal_code

Tipo: stringa

Consigliato.

Codice postale relativo alla posizione del veicolo.

Esempio: 94112

country

Tipo: stringa

Consigliato.

Nome del Paese in cui si trova il veicolo.

Esempio: New Zealand

make

Tipo: stringa

Consigliato.

Marca/produttore del veicolo.

Esempio: Ford, Toyota, Honda

model

Tipo: stringa

Consigliato.

Modello del veicolo.

Esempio: F-150, Camry, Accord

year

Tipo: intero

Consigliato.

Anno di lancio del veicolo in formato aaaa.

Esempio: 2013

state_of_vehicle

Tipo: enum

Consigliato.

Fondamentale per sapere se il veicolo è nuovo o usato. Valori supportati: New, Used, CPO

mileage.value

Tipo: intero

Consigliato.

Chilometraggio del veicolo (in km o miglia); zero (0) per i veicoli nuovi.

Esempio: 5000

mileage.unit

Tipo: stringa

Consigliato.

Unità di chilometraggio in miglia (MI) o chilometri (KM)

exterior_color

Tipo: stringa

Consigliato.

Colore della verniciatura del veicolo.

Esempio: black, blue, white e così via

transmission

Tipo: enum

Consigliato.

Tipo di cambio del veicolo. Valori supportati: Automatic, Manual, Other

body_style

Tipo: enum

Consigliato.

Tipo di veicolo. Valori supportati: Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Other

fuel_type

Tipo: enum

Consigliato.

Tipo di alimentazione del veicolo. Valori supportati: Diesel, Electric, Flex, Gasoline, Hybrid, Other

drivetrain

Tipo: enum

Consigliato.

Trazione del veicolo. Valori supportati: AWD, FOUR_WD, FWD, RWD, TWO_WD, Other

price

Tipo: float

Consigliato.

Prezzo del veicolo.

Esempio: 8000

preferred_price_range

Tipo: [float (min), float (max)]

Consigliato.

Fascia di prezzo del veicolo.

Esempio: [8000, 12000]

currency

Tipo: stringa

Consigliato.

Valuta per price e price_range. Usa il formato valuta ISO 4217, come ad esempio "USD".

trim

Tipo: stringa

Consigliato.

Allestimento del veicolo.

Esempio: 5DR HB SE

vin

Tipo: stringa

Consigliato.

Numero di identificazione del veicolo. Caratteri massimi: 17

Esempio: KL9CD9S99EC111111

interior_color

Tipo: stringa

Facoltativo.

Colore degli interni del veicolo.

Esempio: Black, White, Blue e così via

condition_of_vehicle

Tipo: enum

Facoltativo.

Condizioni del veicolo. Valori supportati: Excellent, Good, Fair, Poor, Other.

viewcontent_type

Tipo: stringa

Facoltativo per ViewContent.

Usa viewcontent_type per distinguere le pagine di destinazione per "soft lead".

Esempio: Model Page, Offers Page

search_type

Tipo: stringa

Facoltativo per Search.

Usa search_type per differenziare tra le altre ricerche degli utenti (come quelle per un concessionario) e le ricerche in inventario.

Esempio: Dealer Locator

registriation_type

Tipo: stringa

Facoltativo per CompleteRegistration.

Usa registriation_type per differenziare i diversi tipi di registrazioni dei clienti sul sito web.

Esempio: Brochure request