Anúncios de automóveis

Anúncios de automóveis – Eventos

Os anúncios de automóveis usam eventos que têm um conjunto de parâmetros (lista completa de detalhes dos parâmetros do evento). Você pode usar o pixel do Facebook em eventos do site e do app para celular no seu app Android e iOS.

Eventos-padrão e obrigatórios

  • Eventos-padrão – são ações que reconhecemos e aceitamos em todos os produtos de anúncios. A consistência na maneira de atribuir nomes e categorizar as principais ações melhora nossa capacidade de exibir seus anúncios às pessoas do público que estão mais propensas a realizar as ações que importam para sua empresa. Veja a lista completa de eventos-padrão e as boas práticas relacionadas aqui.
  • Eventos obrigatórios – consulte a tabela abaixo. O exemplo de código é Pixel, Android, iOS para todos os eventos obrigatórios.
EventoQuando dispararExemplo de código

Search

Em páginas de resultados da pesquisa para buscas sobre veículos/inventário.

Pixel | Android | iOS

ViewContent

Em páginas da web onde você quer rastrear visualizações de conteúdo-chave. Por exemplo: páginas de detalhes de um veículo, páginas sobre modelos de veículos, ofertas de veículos ou páginas de incentivos.

Pixel | Android | iOS

AddToWishlist

Quando alguém salva, adiciona aos Favoritos ou manifesta interesse em um classificado de veículo específico.

Pixel | Android | iOS

Pixel do Facebook (para sites)

Para usar este guia, pressupomos que você já tenha um pixel do Facebook instalado. Caso não tenha um, consulte Pixel para a API de Marketing.

Antes de começar

  • Ao disparar um evento, verifique se o código de base do pixel já está carregado.
  • Caso você use um gerenciador de tags, inclua a tag que contém o código do pixel em todas as páginas. Ela deve aparecer antes da tag que contém o código de evento do pixel.
  • Use a Ferramenta para Pixel do Facebook para validar a implementação do pixel.

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

Eventos do app para celular (Android)

Para usar este guia, pressupomos que você já tenha implementado o SDK do Facebook no seu app para celular (Android). Se ainda não tiver feito isso, consulte o artigo SDK do Facebook para Android. Caso você utilize os serviços de um parceiro de mensuração, será preciso verificar se ele transmite os eventos necessários para o Facebook.

Evento Search para 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 para 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 para 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 do app para celular (iOS)

Para usar este guia, pressupomos que você já tenha implementado o SDK do Facebook no seu app para celular (iOS). Se ainda não tiver feito isso, consulte o artigo SDK do Facebook para iOS. Caso você utilize os serviços de um parceiro de mensuração, será preciso verificar se ele transmite os eventos necessários para o Facebook.

Evento Search para 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 para 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 para 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 pixel e eventos do app

Embora cada anunciante possa ter metas ou necessidades de rastreamento personalizado no site um pouco diferentes, disponibilizamos alguns parâmetros recomendados abaixo com base nas ações e nos KPIs mais comuns para sites de automóveis.

Os parâmetros são subconjuntos de um evento-padrão que rastreiam informações adicionais sobre cada ação. Por exemplo, se você estiver rastreando um evento ViewContent na página de detalhes de um veículo, será possível usar parâmetros para capturar outras informações toda vez que a página em questão for visualizada, como dados sobre o fabricante, o modelo e o ano de fabricação do veículo.

Embora os parâmetros sejam opcionais para a configuração geral do pixel, existem parâmetros específicos que são obrigatórios para anúncios de automóveis. Recomendamos que você inclua (pelo menos) esses parâmetros para facilitar a configuração de anúncios dinâmicos para automóveis agora ou no futuro.

Especificações de parâmetros de eventos do app

  • No celular, os nomes dos parâmetros são diferentes dos exibidos no pixel do Facebook. Geralmente, eles são precedidos por fb_ com algumas exceções, como content_ids em vez de fb_content_id e value em vez de _valueToSum.
  • Se você enviar vários valores (por exemplo, com content_ids ou content_type), será preciso fornecer uma matriz de valores codificada em JSON: ["value1", "value2"]. Observação: não concatene valores com uma vírgula.
Campo e tipoDescrição

event_name

Tipo: string

Obrigatório para Search, ViewContent, AddToWishlist.

Nomes de eventos predefinidos que permitem mensurar o desempenho das suas campanhas e capturar a intenção dos públicos.

content_ids

Tipo: matriz de strings

Obrigatório para ViewContent, AddToWishlist. Recomendado para Search.

Identificação relevante conforme listado no seu catálogo de veículos.

Exemplo: ['123', 456]

content_type

Tipo: string

Recomendado para Search, ViewContent, AddToWishlist.

Tipo de produto ou conteúdo. Valor aceito: value.

postal_code

Tipo: string

Recomendado.

Código postal referente à localização do veículo.

94112

country

Tipo: string

Recomendado.

Nome do país referente à localização do veículo.

Exemplo: New Zealand

make

Tipo: string

Recomendado.

Marca/fabricante do veículo.

Exemplo: Ford, Toyota, Honda

model

Tipo: string

Recomendado.

Modelo do veículo.

Exemplo: F-150, Camry, Accord

year

Tipo: número inteiro

Recomendado.

Ano de lançamento do veículo no formato aaaa.

2013

state_of_vehicle

Tipo: enumeração

Recomendado.

Fundamental para informar se o veículo é novo ou usado. Valores aceitos: New, Used, CPO.

mileage.value

Tipo: número inteiro

Recomendado.

Quilometragem do veículo (em quilômetros ou milhas); zero (0) para veículos novos.

Exemplo: 5000

mileage.unit

Tipo: string

Recomendado.

Unidades de quilometragem em milhas (MI) ou quilômetros (KM).

exterior_color

Tipo: string

Recomendado.

Cor externa do veículo.

Exemplo: black, blue, white e assim por diante

transmission

Tipo: enumeração

Recomendado.

Tipo de transmissão do veículo. Valores aceitos: Automatic, Manual, Other.

body_style

Tipo: enumeração

Recomendado.

Estilo de carroçaria do veículo. Valores aceitos: Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Other.

fuel_type

Tipo: enumeração

Recomendado.

Tipo de combustível do veículo. Valores aceitos: Diesel, Electric, Flex, Gasoline, Hybrid, Other.

drivetrain

Tipo: enumeração

Recomendado.

Sistema de tração do veículo. Valores aceitos: AWD, FOUR_WD, FWD, RWD, TWO_WD, Other.

price

Tipo: float

Recomendado.

Preço do veículo.

Exemplo: 8000

preferred_price_range

Tipo: [float (mínimo), float (máximo)]

Recomendado.

Faixa de preço do veículo.

Exemplo: [8000, 12000]

currency

Tipo: string

Recomendado.

Moeda para o price e a price_range. Use o formato de moeda no padrão ISO 4217, como "USD".

trim

Tipo: string

Recomendado.

Acabamento do veículo.

Exemplo: 5DR HB SE.

vin

Tipo: string

Recomendado.

Número de identificação do veículo. Máximo de caracteres: 17

KL9CD9S99EC111111

interior_color

Tipo: string

Opcional.

Cor interna do veículo.

Exemplo: Black, White, Blue e assim por diante

condition_of_vehicle

Tipo: enumeração

Opcional.

Condição física do veículo. Valores aceitos: Excellent, Good, Fair, Poor, Other.

viewcontent_type

Tipo: string

Opcional para ViewContent.

Use viewcontent_type para diferenciar páginas de destino criadas para atrair clientes em potencial.

Exemplo: Model Page, Offers Page

search_type

Tipo: string

Opcional para Search.

Use search_type para diferenciar outros tipos de pesquisa feitas pelo usuário (como pesquisa por revendedor) da pesquisa por inventário.

Dealer Locator

registriation_type

Tipo: string

Opcional para CompleteRegistration.

Use registriation_type para distinguir os tipos de registro realizados pelos clientes no site.

Brochure request