Anuncios de automóviles: eventos

Los anuncios de automóviles utilizan eventos que tienen un conjunto de parámetros (información completa de los parámetros del evento). Puedes utilizar el pixel de Facebook en eventos de tu sitio web y de app para celulares en tu app de Android e iOS.

Eventos estándar y obligatorios

  • Los eventos estándar son acciones que reconocemos y admitimos en todos los productos publicitarios. Esa coherencia en la forma en que nombramos y categorizamos las acciones clave mejora nuestra capacidad de mostrar anuncios a los miembros de tu público con más probabilidades de realizar las acciones que son importantes para tu negocio. Consulta la lista completa de eventos estándar y las prácticas recomendadas correspondientes aquí.
  • Eventos obligatorios: consulta la tabla a continuación. El código de muestra es píxel, Android e iOS en relación con todos los eventos obligatorios.
EventoCuándo se activaCódigo de ejemplo

Search

En las páginas de resultados de búsqueda de vehículos e inventario

Píxel | Android | iOS

ViewContent

En páginas web donde desees hacer seguimiento de vistas de contenido clave. Por ejemplo: páginas de detalles de vehículos, de modelos, de ofertas de vehículos o de incentivos.

Píxel | Android | iOS

AddToWishlist

Cuando alguien guarda un anuncio de un vehículo específico, lo agrega a favoritos o muestra interés en él

Píxel | Android | iOS

Píxel de Facebook (para sitios web)

En esta guía, se asume que ya tienes instalado el píxel de Facebook. De lo contrario, consulta usar la API de marketing con píxel.

Antes de empezar

  • Asegúrate de que el código base del píxel ya esté cargado cuando actives un evento.
  • Si usas un administrador de etiquetas, asegúrate de incluir la etiqueta que contiene el código del píxel en cada página. Esta etiqueta debe aparecer antes de la que contiene el código de evento del píxel.
  • Usa el asistente para píxeles de Facebook a fin de validar la implementación del píxel.

Evento "Search" del píxel

    // 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 "ViewContent" del píxel

    // 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 "AddToWishlist" del píxel

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

Eventos de la app para celulares para Android

En esta guía, se asume que tienes el SDK de Facebook implementado en tu app para celulares para Android. De lo contrario, consulta SDK para Android. Si usas un socio de medición, asegúrate de que este pase los eventos necesarios a Facebook.

Evento "Search" de 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

);

Evento "ViewContent" de 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

);

Evento "AddToWishlist" de 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

);

Eventos de la app para celulares para iOS

En esta guía, se asume que tienes el SDK de Facebook implementado en tu app para celulares para iOS. De lo contrario, consulta el SDK de iOS. Si usas un socio de medición, asegúrate de que este pase los eventos necesarios a Facebook.

Evento "Search" de 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]",
    }
  ];          

Evento "ViewContent" de 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, 
              

    }
  ];          

Evento "AddToWishlist" de 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, 
              

    }
  ];          

Parámetros de eventos de la app y del píxel

Aunque es posible que cada anunciante de automóviles tenga objetivos o necesidades de seguimiento personalizado ligeramente diferentes, a continuación, presentamos algunas recomendaciones respecto de los parámetros en función de las acciones y los KPI más habituales en los sitios web del sector.

Los parámetros son subconjuntos de un evento estándar que hacen seguimiento de la información adicional de cada acción. Por ejemplo, si realizas un seguimiento del evento ViewContent en una página de información detallada del vehículo, puedes usar los parámetros también para capturar información cada vez que alguien ve la página, como la marca, el modelo y el año del vehículo.

Mientras que los parámetros son opcionales para la configuración general de los píxeles, hay algunos parámetros específicos obligatorios para los anuncios de vehículos. Recomendamos agregar al menos esos para facilitar la configuración de los DAA ahora o en el futuro.

Especificaciones de parámetros de eventos de la app

  • En el celular, los nombres de los parámetros son diferentes con respecto al píxel de Facebook. A menudo, tienen fb_ antepuesto, pero hay algunas excepciones, como content_ids, que varía a fb_content_id, y value, que es _valueToSum.
  • Cuando envíes varios valores (por ejemplo, con content_ids o content_type), proporciona una matriz de valores cifrada mediante JSON: ["value1", "value2"]. Nota: No concatenar los valores con una coma.
Campo y tipoDescripción

event_name

Tipo: cadena

Obligatorio para Search, ViewContent y AddToWishlist.

Son nombres de eventos definidos previamente que te permiten medir el rendimiento de tus campañas y capturar las intenciones de tus públicos.

content_ids

Tipo: matriz de cadenas

Obligatorio para ViewContent y AddToWishlist. Obligatorio para Search.

Identificador relevante según el catálogo de vehículos.

Ejemplo: ['123', 456]

content_type

Tipo: cadena

Recomendado para Search, ViewContent y AddToWishlist.

Tipo de producto o contenido. Valor admitido: value.

postal_code

Tipo: cadena

Recomendado.

Código postal de la ubicación del vehículo.

Ejemplo: 94112

country

Tipo: cadena

Recomendado.

Nombre de país de la ubicación del vehículo.

Ejemplo: New Zealand

make

Tipo: cadena

Recomendado.

Marca/fabricante/proveedor de vehículos.

Ejemplo: Ford, Toyota y Honda

model

Tipo: cadena

Recomendado.

Modelo del vehículo.

Ejemplo: F-150, Camry y Accord

year

Tipo: entero

Recomendado.

Año en que se lanzó el vehículo, en formato aaaa.

2013

state_of_vehicle

Tipo: enumeración

Recomendado.

Es importante saber si el vehículo es nuevo o usado. Valores admitidos: New, Used y CPO

mileage.value

Tipo: entero

Recomendado.

Kilometraje del vehículo (en km o millas); cero (0) para vehículos nuevos.

Ejemplo: 5000

mileage.unit

Tipo: cadena

Recomendado.

Unidades de kilometraje en millas (MI) o kilómetros (KM)

exterior_color

Tipo: cadena

Recomendado.

Color del exterior del vehículo.

Ejemplo: black, blue y white, y así sucesivamente

transmission

Tipo: enumeración

Recomendado.

Tipo de transmisión de vehículo. Valores admitidos: Automatic, Manual y Other

body_style

Tipo: enumeración

Recomendado.

Estilo de carrocería del vehículo. Valores admitidos: Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover y Other

fuel_type

Tipo: enumeración

Recomendado.

Tipo de combustible del vehículo. Valores admitidos: Diesel, Electric, Flex, Gasoline, Hybrid, Other

drivetrain

Tipo: enumeración

Recomendado.

Tracción del vehículo. Valores admitidos: AWD, FOUR_WD, FWD, RWD, TWO_WD y Other

price

Tipo: flotante

Recomendado.

Precio del vehículo.

Ejemplo: 8000

preferred_price_range

Tipo: [flotante (mín.), flotante (máx.)]

Recomendado.

Rango de precio del vehículo.

Ejemplo: [8000, 12000]

currency

Tipo: cadena

Recomendado.

Moneda para el price y el price_range. Utiliza el formato de divisa ISO 4217, como "USD".

trim

Tipo: cadena

Recomendado.

Versión del vehículo.

Ejemplo: 5DR HB SE

vin

Tipo: cadena

Recomendado.

Número de identificación del vehículo. Máximo de caracteres: 17

KL9CD9S99EC111111

interior_color

Tipo: cadena

Opcional.

Color del interior del vehículo.

Ejemplo: Black, White y Blue, y así sucesivamente

condition_of_vehicle

Tipo: enumeración

Opcional.

Condición física del vehículo. Valores admitidos: Excellent, Good, Fair, Poor y Other.

viewcontent_type

Tipo: cadena

Opcional para ViewContent.

Utiliza viewcontent_type para diferenciar entre las páginas de destino de clientes potenciales temporales.

Ejemplo: Model Page y Offers Page

search_type

Tipo: cadena

Opcional para Search.

Utiliza search_type para diferenciar otras búsquedas de los usuarios (como búsqueda de proveedores) de la búsqueda de inventario.

Dealer Locator

registriation_type

Tipo: cadena

Opcional para CompleteRegistration.

Utiliza registriation_type para diferenciar entre los distintos tipos de registros de clientes en el sitio web.

Ejemplo: Brochure request