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 ou a fonte de dados de produtos é 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 são exigidos apenas para determinados tipos de anúncios; e alguns são recomendados. Não fornecer um atributo que é obrigatório impede que determinados anúncios de veículos sejam exibidos 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.
Nesta página
- Antes de começar
- Como criar seu feed principal
- Aplicabilidade dos atributos de preço
- Atualizações de inventário mais frequentes
Antes de começar
- Tipos de veículos aceitos: consulte as políticas de anúncios de veículos para saber quais tipos são aceitos.
- 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 atendimento do pedido, use campos repetidos para códigos de loja e o atributo de grupo para o atendimento 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 veículo/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.
Como criar seu feed principal
Etapa 1 de 2: criar um arquivo de texto delimitado, um arquivo XML ou usar uma API
Para começar, crie um arquivo de texto delimitado (recomendado), um arquivo XML ou use a API.
Etapa 2 de 2: fornecer informações 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 da fonte de dados de anúncios de veículos
Observação: para visualizar todo o conteúdo, role a tabela da esquerda para a direita.
| Atributo | Descrição | Tipo |
|---|---|---|
Disponibilidade [availability] |
Obrigatório apenas para ofertas de veículos fabricados sob encomenda. Opcional ou pode ser omitido para ofertas que não são sob encomenda. |
Valores compatíveis:
Como mapear para valores do Merchant Center:
|
Categoria Google do produto [google_product_category] |
Obrigatório Categoria Google do produto. |
Categorias disponíveis (todos os países em que os anúncios de veículos, ou VLA, estão disponíveis globalmente):
Categorias aceitas (restritas e permitidas apenas nos EUA):
|
Atendimento do pedido de veículo [vehicle_fulfillment] |
Obrigatório Esse atributo de grupo é usado com o subatributo |
Valores aceitos:
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 atendimento 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 e para ofertas sob encomenda (quando a disponibilidade 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 para ofertas na loja Identificador alfanumérico exclusivo de cada concessionária. Observação: o atributo de código da loja diferencia 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. |
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 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 " |
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. 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. No Japão, o valor precisa ser o preço base do veículo, sem incluir taxas de seguro e registro. No Reino Unido, o preço precisa incluir todos os tributos e cobranças não opcionais realmente pagos pelo consumidor (na moeda local). Para outros países, confira se o preço corresponde ao valor final na página de destino VDP e obedece à legislação local em relação às informações de preço. Observação: para ofertas somente de leasing em que não há preço total em dinheiro disponível, o atributo de preço precisa ser definido como 0. Se o financiamento ou o leasing forem opções alternativas, o preço total à vista deverá permanecer no campo preço |
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, no Canadá e no Japão e carros usados na Austrália e no Japão. Opcional em alguns países Tipo enumerado: preço total, valor final com emplacamento e outros. Saiba mais sobre o Tipo de preço do veículo [vehicle_price_type]. |
Use o atributo Valores aceitos:
|
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. |
Parcelas [installment] |
Opcional Preço (em parcelas) para compra ou leasing do veículo. Indisponível na Austrália. Na página de destino do veículo, os detalhes da oferta com parcelamento precisam seguir a legislação local. Os detalhes das parcelas mostrados no formato do anúncio se baseiam em um exemplo representativo que aparece na página de destino. São apenas estimativas. |
Atributo de grupo
Esse atributo de grupo pode ser usado com os seguintes subatributos:
|
Estado [condition] |
Obrigatório O estado do veículo. Consulte as diretrizes adicionais para ver considerações sobre quilometragem relacionadas ao estado do veículo. |
Valores aceitos:
|
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. Opcional para ofertas sob encomenda. |
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 sem custo financeiro) A lista de opcionais instalados, separados por vírgulas. Exemplo: banco de couro, câmera de ré, sistema de navegação, aquecedores nos bancos 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 e outros. |
Valores aceitos:
|
Motor [engine] |
Opcional Obrigatório em alguns países. Tipo enumerado: gasolina, diesel, elétrico, híbrido e outros |
Valores aceitos:
|
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 único dono e/ou uma lista separada de opcionais, como banco de couro, câmera de ré, sistema de navegação, aquecedores nos bancos dianteiros, ar-condicionado, teto solar, preparado para 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. Saiba como usar rótulos personalizados nos anúncios do Shopping. |
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 Saiba mais sobre o destino incluído |
Valores aceitos:
|
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 Saiba mais sobre os destinos excluídos |
Valores aceitos:
|
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. Use kg/100 km para motores a gás natural. Observação: os valores especificados precisam ser medidos no ciclo de teste combinado. |
Número + unidade (l/100 km ou kg/100 km) Exemplo:6,2 l/100 km |
Consumo de combustível com bateria descarregada [fuel_consumption_discharged_battery] |
Obrigatório em alguns países. A quantidade de combustível consumida em litros para rodar 100 quilômetros usando o veículo especificado quando a bateria está descarregada. Exemplo: 6,2 l/100 km (a unidade é representada pelo "L" em letra minúscula). Use kg/100 km para motores a gás natural. |
Número + unidade (l/100 km ou kg/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/100 km |
Autonomia elétrica [electric_range] |
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 [certification] |
Obrigatório na Alemanha para carros novos, usados com menos de 1.000 km ou usados registrados nos últimos 8 meses. A certificação de emissões do veículo (por exemplo, BMWK para a Alemanha ou ADEME para a França). |
Atributo de grupo |
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 para carros novos. |
Valores compatíveis:
|
Despesas com o veículo [vehicle_expenses] |
Opcional Obrigatório no Japão para veículos usados. Despesas diversas, incluindo seguro, taxas de documentação e muito mais. |
Número e moeda (use a ISO 4217) |
Categoria do veículo [vehicle_category] |
Opcional no Japão A categoria do veículo. No momento, esse atributo é usado somente no Japão. Kei Jidosha: veículos leves com motores de até ~660 cc Futsu sha: moderado, motores entre 660 e 2.000 cc e outros que não são classificados como Kei Jidosha ou Ogata Sha Ogata sha: motor de veículos de grande porte |
Valores aceitos:
|
Garantia [warranty] |
Opcional e disponível somente no Japão. Quando não especificado, é equivalente a "Sem garantia". Tempo de uso: número (em meses) Quilometragem: número (em quilômetros) Para garantias com quilometragem ilimitada com base apenas em um período, especifique a duração em meses e deixe o campo de quilometragem em branco. |
Atributo de grupo |
Inspeção obrigatória do veículo incluída [vehicle_mandatory_inspection_included] |
Obrigatório no Japão para veículos usados Se o veículo for vendido com inspeção e manutenção obrigatórias realizadas antes da entrega, no Japão, os anúncios dele serão exibidos com o atributo "manutenção de inspeção regular incluída". |
Booleano (yes / no) |
Observação: mesmo ao usar as novas categorias Google do produto (por exemplo, 3018 para ATVs, 920 para veículos recreacionais e 4243 para trailers de viagem), os seguintes atributos são obrigatórios:
Aplicabilidade dos atributos de preço
Observação: para visualizar todo o conteúdo, role a tabela da esquerda para a direita.
| País | Tipo de inventário | Tipo de anunciante | price |
vehicle_price_type |
vehicle_msrp |
vehicle_all_in_price |
|---|---|---|---|---|---|---|
| Austrália | Usados | Todos | Obrigatório |
Obrigatório
|
Opcional | Não relevante* |
| Novo | Todos | Obrigatório | Obrigatório
|
Obrigatório | Não relevante* | |
| Canadá | Usados | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Opcional |
| Novo | 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* |
| Japão | Ambos | Todos | Obrigatório |
Obrigatório
|
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* |
| Estados Unidos | Usados | Todos | Obrigatório | Opcional
Não relevante. Deixe em branco ou não forneça o atributo no feed. |
Opcional | Não relevante* |
| Novo | 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á
vehicle_price_type = all_in_price |
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.
vehicle_price_type = drive_away_price |
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.
vehicle_price_type = estimated_drive_away_price |
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.
vehicle_price_type = excluding_government_charges_price |
vehicle_base_price
Relevante para o Japão
O preço base do veículo não inclui as taxas de seguro e registro.
- Obrigatório para carros novos e usados no Japão.
vehicle_price_type = vehicle_base_price |
- Os anúncios de veículos geralmente não têm o atributo de disponibilidade
[availability]. Não envie esse atributo se ele não se aplicar à sua oferta de veículo, o que pode causar erros no feed.- Exceção: as ofertas de veículos fabricados sob encomenda precisam incluir o atributo de disponibilidade
[availability]com o valor de tipo enumeradobuild_to_order.
- Exceção: as ofertas de veículos fabricados sob encomenda precisam incluir o atributo de disponibilidade
- Se você não fornecer um valor para um atributo opcional, o Google vai interpretá-lo 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 Merchant e como usá-la para enviar dados do produto.