Publicités automobiles – Évènements

Les publicités automobiles utilisent des évènements associés à un ensemble de paramètres (liste complète et détaillée des paramètres d’évènement). Vous pouvez utiliser le pixel Facebook sur votre site web et les évènements d’application mobile dans votre application Android et iOS.

Évènements standard et obligatoires

  • Les évènements standard sont des actions reconnues et prises en charge par Facebook pour l’ensemble des produits publicitaires. Notre système de nomenclature et de catégorisation des actions importantes nous permet d’améliorer notre faculté à diffuser des publicités auprès des membres de votre audience les plus susceptibles d’effectuer les actions qui comptent pour votre entreprise. Vous pouvez consulter la liste complète des évènements standard et les recommandations qui s’y rapportent ici.
  • Évènements obligatoires – Voir le tableau ci-dessous. Cliquez sur Pixel, Android et iOS pour accéder à l’exemple de code pour tous les évènements obligatoires.
ÉvènementCas d’utilisationExemple de code

Search

Sur les pages de résultats de recherche pour les recherches de véhicules/inventaire

Pixel | Android | iOS

ViewContent

Sur les pages web où vous souhaitez suivre les vues de contenus clés. Par exemple : pages de détails relatifs à un véhicule, de modèles, d’offres de véhicules ou de promotions.

Pixel | Android | iOS

AddToWishlist

Quand un utilisateur ou une utilisatrice enregistre, ajoute à ses favoris ou manifeste un intérêt pour une offre de véhicule spécifique.

Pixel | Android | iOS

Pixel Facebook (pour les sites web)

Ce guide suppose que vous avez déjà installé un pixel Facebook. Si ce n’est pas le cas, consultez Utilisation de l’API Marketing avec le pixel.

Avant de commencer

  • Vérifiez que le code de base du pixel est déjà chargé lorsque vous déclenchez un évènement.
  • Si vous utilisez un gestionnaire de balises, veillez à inclure la balise contenant le code de pixel sur chaque page. La balise doit apparaître avant celle qui contient le code d’évènement de pixel.
  • Utilisez l’outil Facebook Pixel Helper pour valider l’implémentation de votre pixel.

Évènement du 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
});

Évènement du 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
});

Évènement du 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
});

Évènements d’application mobile pour Android

Ce guide suppose que vous avez implémenté le SDK Facebook dans votre application mobile Android. Si ce n’est pas le cas, consultez SDK Android. Si vous avez recours à un partenaire de mesure, assurez-vous qu’il transmette les évènements requis à Facebook.

Évènement 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

);

Évènement 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

);

Évènement 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

);

Évènements d’application mobile pour iOS

Ce guide suppose que vous avez déjà implémenté le SDK Facebook dans votre application mobile iOS. Si ce n’est pas le cas, consultez SDK iOS. Si vous avez recours à un partenaire de mesure, assurez-vous qu’il transmette les évènements requis à Facebook.

Évènement 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]",
    }
  ];          

Évènement 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, 
              

    }
  ];          

Évènement 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, 
              

    }
  ];          

Paramètres du pixel et des évènements d’application

Même si chaque annonceur automobile a des objectifs ou des besoins légèrement différents en matière de suivi personnalisé sur son site web, vous trouverez ci-dessous certains des paramètres recommandés pour les actions et les KPI les plus fréquemment associés aux sites web automobiles.

Ces paramètres sont des sous-ensembles d’un évènement standard qui permettent d’effectuer le suivi d’informations supplémentaires sur chaque action. Par exemple, si vous suivez un évènement ViewContent sur la page de détails d’un véhicule, vous pouvez utiliser des paramètres pour consigner également certaines informations chaque fois que cette page est consultée (comme la marque, le modèle et l’année du véhicule en question).

Si certains paramètres sont facultatifs pour la configuration générale du pixel, d’autres paramètres spécifiques sont obligatoires pour les publicités automobiles. Nous vous recommandons d’ajouter ces derniers (au moins) pour faciliter la configuration des publicités dynamiques pour le secteur automobile, aujourd’hui et ultérieurement.

Spécifications aux paramètres des évènements d’application

  • Pour les mobiles, les noms de paramètres sont différents de ceux du pixel Facebook. Souvent précédés de fb_, à quelques exceptions près, comme content_ids et fb_content_id ou value et _valueToSum.
  • Lorsque vous envoyez plusieurs valeurs (par exemple avec content_ids ou content_type), fournissez un tableau de valeurs codé JSON : ["value1", "value2"]. Remarque : ne concaténez pas les valeurs à l’aide d’une virgule.
Champ et typeDescription

event_name

Type : chaîne

Obligatoire pour Search, ViewContent et AddToWishlist.

Noms d’évènement prédéfinis qui vous permettent de mesurer les performances de vos campagnes et de capturer les intentions de vos audiences.

content_ids

Type : tableau de chaînes

Obligatoire pour ViewContent et AddToWishlist. Recommandé pour Search.

ID concernés tels qu’ils sont indiqués dans votre catalogue de véhicules.

Exemple : ['123', 456]

content_type

Type : chaîne

Recommandé pour Search, ViewContent et AddToWishlist.

Type de produit ou de contenu. Valeur prise en charge : value.

postal_code

Type : chaîne

Recommandé.

Code postal du lieu où le véhicule se trouve.

Exemple : 94112

country

Type : chaîne

Recommandé.

Nom du pays où le véhicule se trouve.

Exemple : New Zealand

make

Type : chaîne

Recommandé.

Nom/marque/constructeur du véhicule.

Exemple : Ford, Toyota, Honda

model

Type : chaîne

Recommandé.

Modèle du véhicule.

Exemple : F-150, Camry, Accord

year

Type : entier

Recommandé.

Année de commercialisation du véhicule, au format aaaa.

Exemple : 2013

state_of_vehicle

Type : énumération

Recommandé.

Essentiel pour savoir s’il s’agit d’un véhicule neuf ou d’occasion. Valeurs prises en charge : New, Used, CPO

mileage.value

Type : entier

Recommandé.

Kilométrage du véhicule (en km ou miles) ; zéro (0) pour les véhicules neufs.

Exemple : 5000

mileage.unit

Type : chaîne

Recommandé.

Unités de kilométrage en miles (MI) ou kilomètres (KM)

exterior_color

Type : chaîne

Recommandé.

Couleur extérieure du véhicule.

Exemple : black, blue, white, etc.

transmission

Type : énumération

Recommandé.

Type de transmission du véhicule. Valeurs prises en charge : Automatic, Manual, Other

body_style

Type : énumération

Recommandé.

Catégorie du véhicule. Valeurs prises en charge : Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Other

fuel_type

Type : énumération

Recommandé.

Type de carburant du véhicule. Valeurs prises en charge : Diesel, Electric, Flex, Gasoline, Hybrid, Other

drivetrain

Type : énumération

Recommandé.

Transmission du véhicule. Valeurs prises en charge : AWD, FOUR_WD, FWD, RWD, TWO_WD, Other

price

Type : virgule flottante

Recommandé.

Prix du véhicule.

Exemple : 8000

preferred_price_range

Type : [virgule flottante (min), virgule flottante (max)]

Recommandé.

Fourchette de prix du véhicule.

Exemple : [8000, 12000]

currency

Type : chaîne

Recommandé.

Devise du price et de la price_range. Utilisez un format de devise ISO 4217, tel que USD.

trim

Type : chaîne

Recommandé.

Garniture du véhicule.

Exemple : 5DR HB SE

vin

Type : chaîne

Recommandé.

Numéro d’identification du véhicule. 17 caractères maximum.

Exemple : KL9CD9S99EC111111

interior_color

Type : chaîne

Facultatif.

Couleur intérieure du véhicule.

Exemple : Black, White, Blue, etc.

condition_of_vehicle

Type : énumération

Facultatif.

État physique du véhicule. Valeurs prises en charge : Excellent, Good, Fair, Poor, Other.

viewcontent_type

Type : chaîne

Facultatif pour ViewContent.

Utilisez viewcontent_type pour différencier les pages de destination des prospects.

Exemple : Model Page, Offers Page

search_type

Type : chaîne

Facultatif pour Search.

Utilisez search_type pour différencier les autres recherches de l’utilisateur ou de l’utilisatrice (comme la recherche de concessionnaire) par rapport à la recherche dans l’inventaire.

Exemple : Dealer Locator

registriation_type

Type : chaîne

Facultatif pour CompleteRegistration.

Utilisez registriation_type pour différencier plusieurs types d’inscription de clients ou de clientes sur le site web.

Exemple : Brochure request