Automotive Ads

Automotive Ads – Events

Automotive Ads verwenden Events mit Parametern (vollständige Liste der Event-Parameter-Details). Du kannst das Facebook-Pixel auf deiner Website und mobile App Events in deiner Android-App und iOS-App verwenden.

Standard- und erforderliche Events

  • Zu den Standard-Events zählen Handlungen, die von uns anerkannt und bei einer Vielzahl von Werbeprodukten unterstützt werden. Durch die einheitliche Benennung und Kategorisierung dieser wichtigen Handlungen können wir deine Anzeigen besser den Personen in deiner Zielgruppe zeigen, die am wahrscheinlichsten die für dein Unternehmen wichtigen Handlungen durchführen. Die vollständige Liste und Best Practices für Standard-Events findest du hier.
  • Erforderliche Events: Siehe Tabelle unten. Das Codebeispiel steht für alle erforderlichen Events für Pixel, Android und iOS zur Verfügung.
EventAuslösungCode-Beispiel

Search

Bei Suchergebnis-Seiten für Suchanfragen im Fahrzeugbestand

Pixel | Android | iOS

ViewContent

Auf Webseiten, auf denen du die Ansichten von wichtigen Inhalten tracken möchtest. Zum Beispiel: Fahrzeugdetailseiten, Modellseiten, Fahrzeugangebote oder Incentive-Seiten.

Pixel | Android | iOS

AddToWishlist

Wenn jemand ein bestimmtes Fahrzeug speichert, es seine*ihren Favoriten hinzufügt oder Interesse an einem bestimmten Fahrzeuginserat zeigt

Pixel | Android | iOS

Facebook-Pixel (für Websites)

Dieser Leitfaden setzt voraus, dass du bereits ein Facebook-Pixel installiert hast. Informationen hierzu findest du unter Verwenden der Marketing API mit dem Pixel.

Bevor du beginnst

  • Stelle sicher, dass der Pixel-Basiscode bereits geladen wurde, bevor du ein Event auslöst.
  • Wenn du einen Tag-Manager verwendest, musst du das Tag, das den Pixel-Code enthält, zur jeder Seite hinzufügen. Das Tag muss vor dem Tag stehen, das den Pixel-Event-Code enthält.
  • Verwende das Hilfsprogramm für das Facebook-Pixel, um die Pixel-Implementierung zu überprüfen.

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

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

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

Mobile App-Events für Android

Dieser Leitfaden setzt voraus, dass du bereits das Facebook-SDK in deine mobile Android-App implementiert hast. Entsprechende Informationen findest du unter Android-SDK. Wenn du einen Measurement Partner verwendest, stelle sicher, dass die erforderlichen Events an Facebook übermittelt werden.

Android-Event „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

);

Android-Event „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

);

Android-Event „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

);

Mobile App-Events für iOS

Dieser Leitfaden setzt voraus, dass du bereits das Facebook-SDK in deine mobile iOS-App implementiert hast. Entsprechende Informationen findest du unter iOS-SDK. Wenn du einen Measurement Partner verwendest, stelle sicher, dass die erforderlichen Events an Facebook übermittelt werden.

iOS-Event „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]",
    }
  ];

iOS-Event „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, 
              

    }
  ];

iOS-Event „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, 
              

    }
  ];

Pixel- und App-Event-Parameter

Da jedes Automobil-Werbetreibende unterschiedliche Ziele oder selbstdefinierte Tracking-Anforderungen für seine Website hat, stellen wir nachfolgend empfohlene Parameter bereit, die auf den häufigsten Handlungen und KPIs für Auto-Websites beruhen.

Parameter sind Teilmengen eines Standard-Events, die zusätzliche Informationen zu jeder Handlung tracken. Wenn du beispielsweise ViewContent-Events auf einer Fahrzeugdetailseite (VDP) erfasst, kannst du Parameter nutzen, um bei jedem Aufruf der Seite weitere Informationen wie Marke, Modell und Baujahr des Fahrzeugs aufzuzeichnen.

Parameter sind für die allgemeine Pixeleinrichtung zwar optional; für Automotive Ads sind einige bestimmte Parameter jedoch erforderlich. Wir empfehlen, diese (zumindest) hinzuzufügen, um die sofortige oder spätere Einrichtung von DAA zu vereinfachen.

Spezifikationen für App-Event-Parameter

  • Die Parameternamen auf Mobilgeräten unterscheiden sich von denen für das Facebook-Pixel. Ihnen wird oft fb_ vorangestellt (mit einigen Ausnahmen), wie z. B. content_ids gegenüber fb_content_id bzw. value gegenüber _valueToSum.
  • Wenn du mehrere Werte sendest (z. B. mit content_ids oder content_type), wird ein JSON-kodiertes Array mit Werten angegeben: ["value1", "value2"]. Hinweis: Verkette die Werte nicht mit einem Komma.
Feld und TypBeschreibung

event_name

Typ: String

Erforderlich für Search, ViewContent, AddToWishlist.

Vordefinierte Event-Namen, die es dir ermöglichen, die Performance deiner Kampagnen zu messen und eine Absicht auf Seiten deiner Zielgruppen zu erfassen.

content_ids

Typ: Array von Strings

Erforderlich für ViewContent, AddToWishlist. Empfohlen für Search.

Relevante ID in deinem Fahrzeugkatalog.

Beispiel: ['123', 456]

content_type

Typ: String

Empfohlen für Search, ViewContent, AddToWishlist.

Produkt- oder Inhaltstyp. Unterstützter Wert: value.

postal_code

Typ: String

Empfohlen.

Postleitzahl für den Standort des Fahrzeugs.

Beispiel: 94112

country

Typ: String

Empfohlen.

Name des Landes für den Standort des Fahrzeugs.

Beispiel: New Zealand

make

Typ: String

Empfohlen.

Fahrzeugmarke/Marke/Hersteller.

Beispiel: Ford, Toyota, Honda

model

Typ: String

Empfohlen.

Fahrzeugmodell.

Beispiel: F-150, Camry, Accord

year

Typ: Integer

Empfohlen.

Modelljahr des Fahrzeugs im Format JJJJ.

Beispiel: 2013

state_of_vehicle

Typ: Enum

Empfohlen.

Angabe, ob Neu- oder Gebrauchtwagen. Unterstützte Werte: New, Used, CPO

mileage.value

Typ: Integer

Empfohlen.

Tachostand (in Kilometer oder Meilen); null (0) für Neufahrzeuge.

Beispiel: 5000

mileage.unit

Typ: String

Empfohlen.

Tachostand in Meilen (MI) oder (KM)

exterior_color

Typ: String

Empfohlen.

Fahrzeugfarbe (außen).

Beispiel: black, blue, white und so weiter

transmission

Typ: Enum

Empfohlen.

Getriebetyp des Fahrzeugs. Unterstützte Werte: Automatic, Manual, Other

body_style

Typ: Enum

Empfohlen.

Der Karosserietyp des Fahrzeugs. Unterstützte Werte: Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Other

fuel_type

Typ: Enum

Empfohlen.

Kraftstofftyp des Fahrzeugs. Unterstützte Werte: Diesel, Electric, Flex, Gasoline, Hybrid, Other

drivetrain

Typ: Enum

Empfohlen.

Fahrzeugantrieb. Unterstützte Werte: AWD, FOUR_WD, FWD, RWD, TWO_WD, Other

price

Typ: Float

Empfohlen.

Fahrzeugpreis.

Beispiel: 8000

preferred_price_range

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

Empfohlen.

Preisspanne des Fahrzeugs.

Beispiel: [8000, 12000]

currency

Typ: String

Empfohlen.

Währung für den price und die price_range. Verwende das Währungsformat ISO 4217, wie z. B. „USD“.

trim

Typ: String

Empfohlen.

Fahrzeugausstattung.

Beispiel: 5DR HB SE

vin

Typ: String

Empfohlen.

Fahrzeugidentifikationsnummer. Maximal 17 Zeichen.

Beispiel: KL9CD9S99EC111111

interior_color

Typ: String

Optional.

Farbe der Innenausstattung.

Beispiel: Black, White, Blue und so weiter

condition_of_vehicle

Typ: Enum

Optional.

Physischer Zustand des Fahrzeugs. Unterstützte Werte: Excellent, Good, Fair, Poor, Other.

viewcontent_type

Typ: String

Optional für ViewContent.

Verwende viewcontent_type, um zwischen Soft-Lead-Landingpages zu unterscheiden.

Beispiel: Model Page, Offers Page

search_type

Typ: String

Optional für Search.

Verwende search_type, um andere Benutzer*innensuchen (z. B. Händlersuche) von der Bestandssuche zu unterscheiden.

Beispiel: Dealer Locator

registriation_type

Typ: String

Optional für CompleteRegistration.

Verwende registriation_type, um zwischen verschiedenen Arten von Kunden*innenregistrierungen auf der Website zu unterscheiden.

Beispiel: Brochure request