Neste artigo, descrevemos como fazer upload de um feed principal para ativar os anúncios de veículos.
Se você tiver interesse em enviar dados de anúncios de veículos usando a API, clique aqui.
O feed principal é uma lista de todo seu inventário de veículos com atributos descritivos. Alguns atributos são obrigatórios para todos os anúncios de veículos no seu feed, outros para determinados tipos de anúncios de veículos, e alguns atributos são recomendados. Não fornecer um atributo que é obrigatório impede a veiculação de determinados anúncios de veículos nos resultados, e não fornecer os atributos recomendados pode afetar a performance do anúncio.
O Google recomenda que você envie todo seu inventário de veículos em um único feed.
Observação: para simplificar o gerenciamento do feed, você pode trabalhar com um provedor terceirizado dedicado, como a Fullpath ou a Ansira. Os provedores de feeds de veículos podem automatizar a criação e o envio desses feeds. Saiba como registrar e enviar seu feed.
Antes de começar
- Tipos de veículos aceitos: só são aceitos automóveis não comerciais, como carros de passeio e caminhonetes (chamadas de "utes" na Austrália). Não é possível usar anúncios de veículos para promover trailers, barcos, ônibus, trens etc.
- Ofertas aceitas: seu feed só deve incluir ofertas de veículos. Ele não pode incluir peças de reposição, acessórios ou outros tipos de itens.
- Cabeçalhos de atributo: você precisa usar os cabeçalhos de atributo listados abaixo para que seu feed seja processado corretamente.
- Ofertas de veículos exclusivos: envie as ofertas de veículos apenas uma vez no feed, verificando o número de identificação do veículo (chassi). Se o mesmo veículo estiver disponível em vários códigos da loja ou tiver vários tipos de processamento do pedido, use campos repetidos para códigos de loja e o atributo de grupo para o processamento do pedido de veículo. Nesse caso, não é necessário enviar o chassi várias vezes. Se um chassi for enviado para mais de uma oferta de veículo, elas serão reprovadas no feed.
- Exceção: se você enviar ofertas em vários idiomas, o chassi poderá ser enviado uma vez para cada idioma (se disponível).
- No EEE e no Reino Unido, envie o ID
[id]como um identificador alternativo. O ID também precisa aparecer na página de destino do veículo.
Criar seu feed principal
Etapa 1: crie um arquivo de texto delimitado, um arquivo XML ou use uma API
Para começar, crie um arquivo de texto delimitado (recomendado), um Arquivo XML ou use a API. Os feeds automáticos pelo rastreamento do site e os veículos adicionados manualmente no Merchant Center não são compatíveis com anúncios de veículos.
Etapa 2: informe sobre os veículos do seu inventário
Seu feed principal é a fonte de informações do Google para seus anúncios de veículos. As informações que você enviar nesse feed serão mostradas para os compradores que procurarem seus produtos.
Especificação do feed de anúncios de veículos
| Atributo | Descrição | Tipo |
|---|---|---|
Categoria Google do produto [google_product_category] |
Obrigatório Categoria Google do produto. |
Selecione OU Use o código de categoria |
Atendimento do pedido de veículo [vehicle_fulfillment] |
Obrigatório Esse atributo de grupo é usado com o subatributo |
Valores compatíveis:
Esse atributo pode ser repetido até três vezes para cada oferta, permitindo que as concessionárias especifiquem uma opção para cada tipo de processamento do pedido. |
Título [title] |
Opcional Título específico do veículo à venda. Esse nome é mostrado no Merchant Center. |
O título é gerado automaticamente com base em outros atributos. As concessionárias podem incluir os títulos de maneira independente, mas eles não serão usados. |
Tipo de produto [product_type] |
Opcional Use esse atributo para incluir seu próprio sistema de categorização nos dados do produto. |
String |
Chassi [VIN] |
Obrigatório Opcional em alguns países. Número de identificação do veículo (identificador exclusivo de cada carro). Se o chassi |
String com 17 dígitos |
ID [id] |
Obrigatório O identificador exclusivo do seu produto. Pode ser um número de estoque interno ou o chassi. No EEE e no Reino Unido, esse identificador também precisa aparecer na página de destino do veículo. |
String. Precisa ser única. |
Código da loja [store_code] |
Obrigatório Identificador alfanumérico exclusivo de cada concessionária. Observação: o atributo de código da loja diferencia letras maiúsculas de minúsculas e precisa ser idêntico aos códigos de lojas enviados no Perfil da Empresa. |
String Esse é um Campo repetido que aceita vários valores. |
Link da imagem [image_link] |
Obrigatório Imagem exclusiva do veículo específico. |
URL da imagem principal do seu veículo. Saiba mais sobre as diretrizes de imagem para anúncios de veículos. |
Link da imagem adicional [additional_image_link] |
Opcional Até 10 imagens adicionais do veículo específico. |
Mais imagens do seu veículo, além da foto principal fornecida no atributo de link da imagem, geralmente usadas para mostrar um veículo de vários ângulos. Esse é um Campo repetido que aceita vários valores. |
Modelo de link [link_template] |
Obrigatório para ofertas na loja física e de frete para a loja. Link para uma página de descrição do veículo (VDP, na sigla em inglês). Inclua o parâmetro ValueTrack Observação: o parâmetro no URL precisa incluir "store_code". Não insira o código real da loja. |
O URL das páginas de destino do veículo no seu site. Exemplo: incluir "store_code" como um parâmetro de URL, http://mikemart.com/123?store={store_code} Exemplo: incluir "store_code" como parte do caminho do URL, http://acmestores.com/456/store/{store_code} |
Link [link] |
Obrigatório para ofertas on-line. Link para uma página de descrição do veículo (VDP, na sigla em inglês). |
O URL das páginas de destino do veículo no seu site para computadores. |
Modelo de link móvel [mobile_link_template] |
Opcional Link para uma página de descrição do veículo (VDP) para dispositivos móveis. Inclua o parâmetro ValueTrack Observação: o parâmetro no URL precisa incluir "store_code". Não insira o código real da loja. |
O URL das páginas de destino do veículo no seu site móvel. |
Link móvel [mobile_link] |
Opcional Link para uma página de descrição do veículo (VDP) para dispositivos móveis. |
O URL das páginas de destino do veículo no seu site móvel. |
Redirecionamento de anúncios [ads_redirect] |
Opcional É semelhante a um modelo de link, mas pode incluir parâmetros de acompanhamento de anúncios. Link para uma página de descrição do veículo (VDP, na sigla em inglês). Inclua o parâmetro ValueTrack |
Exemplo: https://tracking.example.com?product=sports-car&store={store_code}&src=google¶m=abc |
Preço [price] |
Obrigatório É o preço de venda a ser incluído no anúncio. Verifique se o preço corresponde ao valor mais proeminente ou final na página de destino e obedece à legislação local em relação às informações de preço. No Reino Unido, o preço precisa incluir todos os tributos e cobranças não opcionais realmente pagos pelo consumidor (na moeda local). Nos Estados Unidos, o preço deve ser o valor real que qualquer consumidor pagará pelo veículo anunciado, excluindo apenas cobranças e taxas governamentais obrigatórias. |
Número e moeda (use a ISO 4217). Exemplo: |
Tipo de preço do veículo [vehicle_price_type] |
Obrigatório para carros novos na Austrália e no Canadá e carros usados na Austrália. Opcional em alguns países. Tipo enumerado: all-in, drive-away etc. Entender a aplicabilidade do atributo de tipo de preço do veículo. |
Use o atributo Valores compatíveis:
|
Preço de tabela do veículo [vehicle_msrp] |
Obrigatório para carros novos em alguns países. Opcional para carros usados. O preço de varejo sugerido pelo fabricante (MSRP) do veículo na configuração atual. Se o MSRP não for igual ao preço de venda (acima), ele deverá ser mostrado separadamente na VDP e rotulado como MSRP. |
Use a mesma formatação do atributo de preço. |
Preço total do veículo [vehicle_all_in_price] |
Obrigatório para carros novos em alguns países. Opcional para carros usados. O preço total anunciado inclui os custos dos seguintes itens: qualquer acessório instalado no veículo, tarifas ambientais, garantia extra, combustível, transporte, inspeção pré-entrega (PDI, na sigla em inglês), taxas do revendedor para fazer o licenciamento, tarifas regulamentares regionais, cobranças diversas da concessionária para gravações de chassi e calibração de pneus com nitrogênio e descontos ou incentivos de fábrica para cliente ou de revendedor para cliente. Esse preço também precisa estar na página de descrição do veículo. Observação: o preço total anunciado não inclui tributo sobre vendas, licenciamento (o custo da placa e do registro), qualquer troca ou custos associados ao financiamento de veículos. |
Use a mesma formatação do atributo de preço. |
|
Parcela |
Opcional Disponível apenas no Reino Unido |
|
Estado [condition] |
Obrigatório O estado do veículo. Observação: para que um veículo seja considerado "novo", a quilometragem máxima precisa ser de 200 quilômetros (ou 200 milhas). |
Valores compatíveis:
|
Seminovo certificado [certified_pre-owned] |
Opcional Carro seminovo certificado da OEM. |
Booleano (yes / no) |
Marca [brand] |
Obrigatório O nome da empresa que fabricou o veículo. |
String |
Modelo [model] |
Obrigatório Modelo do carro sem itens opcionais. Por exemplo, envie "Model" e não "Model deluxe" ou "Model standard". |
String |
Itens opcionais [trim] |
Opcional Itens opcionais do modelo. |
String (por exemplo, S, SV, SL) |
Ano [year] |
Obrigatório Opcional em alguns países. Ano do modelo. |
Número inteiro com 4 dígitos. |
Quilometragem [mileage] |
Obrigatório Quilometragem do veículo. Inclua a unidade (km ou milhas). |
Número inteiro e unidade (km ou milhas) Exemplo: |
Cor [color] |
Obrigatório Cor externa, com texto especificado pelo OEM. |
String Exemplos: tri-coat metálico, branco, preto, vermelho e platina. Observações:
|
Opcionais do veículo [vehicle_option] |
Opcional Obrigatório para anúncios de veículos gratuitos. A lista de opcionais instalados separados por vírgulas. Exemplo: assentos de couro, câmera de ré, sistema de navegação, aquecedores dianteiros, ar-condicionado, teto solar e Bluetooth. |
String O número máximo de valores aceitos é 200. Cada valor pode conter até 256 caracteres. Esse é um Campo repetido que aceita vários valores. |
Tipo de carroceria [body_style] |
Opcional Tipo enumerado: Sedan, SUV, Crossover etc. |
Valores compatíveis:
|
Motor [engine] |
Opcional Obrigatório em alguns países. Tipo enumerado: gasolina, diesel, elétrico, híbrido etc. |
Valores compatíveis:
|
Descrição [description] |
Opcional Texto livre. Observações e opções do vendedor: campo de texto livre para informações adicionais sobre o carro, como proprietário único e/ou uma lista separada de opcionais instalados, como assentos de couro, câmera de ré, sistema de navegação, aquecedores dianteiros, ar-condicionado, teto solar, rádio por satélite etc. |
String |
Rótulo personalizado [custom_label_[0-4]] |
Opcional Adicione até cinco rótulos personalizados. De Por exemplo, você pode rotular um grupo de produtos por marca, modelo ou ano. |
String Exemplo:
|
Destino incluído [included_destination] |
Opcional Se você quiser que seu produto participe de outros destinos (além do que foi especificado nas configurações do feed), use o atributo de destino incluído |
Valores compatíveis:
|
Destino excluído [excluded_destination] |
Opcional Se você não quiser que seu produto apareça em determinados lugares, use o atributo de destino excluído |
Valores compatíveis:
|
Data do primeiro registro [date_first_registered] |
Obrigatório para veículos usados em alguns países. Opcional em outros países |
String (AAAA-MM) Exemplo:2020-07 |
Consumo de combustível [fuel_consumption] |
Obrigatório em alguns países para carros novos se o motor usar gasolina, diesel, ou for híbrido e híbrido plug-in. A quantidade de combustível consumida em litros para viajar 100 quilômetros usando o veículo especificado. Observação: os valores especificados precisam ser medidos no ciclo de teste combinado. |
Número + unidade de medida Exemplo:6,2 l/100 km |
|
Bateria descarregada pelo consumo de combustível |
Obrigatório em alguns países Por exemplo: 6,2 l/100 km (a unidade tem o "L" em letras minúsculas). |
Número + unidade (l/100 km) |
Emissões de CO₂ [co2_emissions] |
Obrigatório em alguns países para carros novos. Quando o motor for elétrico, insira 0 g/km. As emissões de CO₂ em g/km do veículo especificado. Observação: os valores especificados precisam ser medidos no ciclo de teste combinado. |
Número + unidade de medida Exemplo:120 g/km |
Consumo de energia [energy_consumption] |
Obrigatório em alguns países para carros novos se o motor for híbrido plug-in ou elétrico. Observação: os valores especificados precisam ser medidos no ciclo de teste combinado. |
Número + unidade de medida Exemplo:17,2 kWh/100km |
|
Faixa de consumo elétrico |
Obrigatório em alguns países para carros novos quando o motor é híbrido plug-in ou elétrico. Alcance elétrico para veículos elétricos. Observação: os valores especificados precisam ser medidos no ciclo de teste combinado. Autonomia elétrica equivalente (EAER, na sigla em inglês) para veículos híbridos plug-in em km, de acordo com a agência reguladora local. |
Int + unidade (km/milhas) Exemplo: 2.333 milhas |
|
Certificação |
Obrigatório na Alemanha para carros novos. A certificação de emissões do veículo (por exemplo, BMWK para a Alemanha ou ADEME para a França). |
|
Padrão de emissões [emissions_standard] |
Padrão de emissão associado ao valor das emissões de CO₂ do veículo. Obrigatório na Itália. |
Valores compatíveis:
|
vehicle_fulfillment
| Atributo de grupo | vehicle_fulfillment |
| Valores aceitos |
|
| Subatributos |
|
Feeds de texto
Formate o nome do atributo de grupo usando vehicle_fulfillment e, entre parênteses, adicione um dos valores de processamento do pedido aceitos seguido por vehicle_fulfillment (conforme necessário). O subatributo de código da loja store_code precisa ser repetido para cada valor do código da loja que você pretende enviar, separados por dois-pontos (:).
Exemplo: processamento do pedido na loja
Se o subatributo store_code for repetido no nome do atributo de grupo, mas somente um valor de código da loja for enviado, a entrada ainda será aceita, já que há apenas uma marcação de dois-pontos (:) no valor.
Quando os dois-pontos (:) não indicarem um valor de subatributo separado, coloque o valor entre aspas (").
| Nome | vehicle_fulfillment(option:store_code:store_code) |
| Valores | in_store:1111:2222 |
Exemplo: atendimento de pedidos on-line
O subatributo código da loja store_code não é obrigatório para ofertas on-line.
| Nome | vehicle_fulfillment(option) |
| Valor | online |
Exemplo 3: oferta híbrida
Uma oferta híbrida combina os exemplos acima como colunas separadas nos dados.
|
{other feed cols} |
vehicle_fulfillment(option) |
vehicle_fulfillment |
| … | online |
in_store:1111:2222 |
Planilhas Google
Formate o nome do atributo de grupo da mesma maneira que os feeds de texto. Quando os valores de subatributos não são separados por dois-pontos (:), eles precisam ser enviados com uma barra invertida no início ("\").
| Nome | vehicle_fulfillment(option:store_code:store_code) |
| Valores | in_store:1111:2222 |
XML (feeds)
Inclua o subatributo store_code conforme necessário. Para especificar diferentes opções de atendimento de pedidos, envie vários atributos vehicle_fulfillment e inclua o subatributo vehicle_fulfillment.
Exemplo
<g:vehicle_fulfillment>
<g:option>online</g:option>
</g:vehicle_fulfillment>
<g:vehicle_fulfillment>
<g:option>in_store</g:option>
<g:store_code>1111</g:store_code>
<g:store_code>2222</g:store_code>
</g:vehicle_fulfillment>
Aplicabilidade dos atributos de preço
| País |
Tipo de inventário |
Tipo de anunciante |
price |
vehicle_price_type |
|
|
|---|---|---|---|---|---|---|
| Austrália | Used | Todos | Obrigatório |
Obrigatório
|
Opcional | Não relevante* |
| New | Todos | Obrigatório | Obrigatório
|
Obrigatório | Não relevante* | |
| Canadá | Used | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Opcional |
| New | Todos | Obrigatório | Obrigatório
|
Opcional | Obrigatório | |
| França | Ambos | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Não relevante* |
| Alemanha | Ambos | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Não relevante* |
| Reino Unido | Ambos | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Não relevante* |
| EUA | Used | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Não relevante* |
| New | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Obrigatório | Não relevante* |
Não relevante*: deixe em branco ou não forneça o atributo no feed.
all_in_price
Relevante para o Canadá
Obrigatório para todas as ofertas de carros novos no Canadá.
drive_away_price
Relevante para a Austrália
O preço drive-away inclui tarifas de documentação, tributo sobre carros de luxo (se for o caso), seguro obrigatório para terceiros, registro e entrega da concessionária.
- Esse tipo de preço ou
estimated_drive_away_price(abaixo) é obrigatório para os carros novos na Austrália. - Esse tipo de preço ou
excluding_government_charges_price(abaixo) é obrigatório para os carros usados na Austrália.
estimated_drive_away_price
Relevante para a Austrália
O preço drive-away estimado, conforme descrito acima, inclui tarifas de documentação, tributo sobre carros de luxo (se for o caso), seguro obrigatório para terceiros, registro e entrega da concessionária, mas é apenas um indicativo. O preço real pode variar com a região e outros fatores.
- Esse tipo de preço ou
drive_away_price(acima) é obrigatório para os carros novos na Austrália.
excluding_government_charges_price
Relevante para a Austrália
O preço sem os encargos governamentais exclui obrigações, taxas, tarifas ou cobranças a serem pagas pelo consumidor diretamente a uma autoridade terceira relevante.
Esse tipo de preço ou drive_away_price (acima) é obrigatório para os carros usados na Austrália.
- Os anúncios de veículos não têm o atributo de disponibilidade
[availability], então ele não deve ser fornecido, ou podem haver erros no feed. - Se você não fornecer um valor para um atributo opcional, o Google vai interpretar como não enviado.
Atualizações de inventário mais frequentes
O preço e a disponibilidade do inventário podem mudar com frequência. Aumente a frequência do feed para realizar atualizações mais frequentes dos dados do inventário. Saiba mais sobre a API Google Content e como usá-la para enviar dados de produtos.