O feed é a fonte de dados central que o Google usa para acessar e mostrar seus veículos. No momento, aceitamos feeds no formato de arquivo CSV, que podem ser compactados com os formatos ZIP ou GZ.
Criar um feed
Para formatar suas informações para o serviço de listagem de veículos, use o formato descrito em Formato do feed, os atributos fornecidos em Especificação do feed e nosso exemplo de feed. Recomendamos que você comece com alguns veículos de teste e envie um arquivo CSV de exemplo para a ferramenta de validação para validar o formato do seu feed. Depois, você pode escalonar para incluir todo o inventário no Google.
Inclua os seguintes detalhes no feed para que possamos fazer a correspondência exata entre veículos e concessionárias de carros no Google:
- Obrigatório:código da loja
- Para mais detalhes, consulte Correspondência de concessionárias.
- Obrigatório:nome e endereço postal da concessionária
- Recomendado:ID do lugar do Google ou URL do Maps
- Eles identificam exclusivamente o Perfil da Empresa da concessionária no Google e removem qualquer ambiguidade em comparação com correspondências que usam o nome e o endereço postal.
Formato do feed
Faça o upload do feed como um arquivo de valores separados por vírgulas (CSV) ou valores separados por tabulação (TSV). Verifique se o arquivo atende aos seguintes requisitos:
- O formato CSV precisa estar em conformidade com o
RFC 4180:
- Não inclua aspas duplas em nenhum lugar do arquivo, a menos que elas sejam isoladas.
- Para fazer o escape de uma aspa dupla, use duas aspas duplas e, além disso, envolva todo o campo CSV entre aspas duplas. Para mais detalhes, consulte as seções 2.5 a 2.7 do RFC 4180 (em inglês).
- Um exemplo de uso válido de aspas duplas é
"Wheels 17"" Alloy", que aparece comoWheels 17" Alloy.
- Não inclua aspas duplas em nenhum lugar do arquivo, a menos que elas sejam isoladas.
- Você pode compactar o arquivo com os formatos ZIP ou GZ.
- O feed precisa conter um único arquivo. Não oferecemos suporte ao uso de vários fragmentos de arquivo, também chamados de fragmentação.
- Cada versão do feed precisa conter todo o inventário de todas as concessionárias que você quer mostrar no Google. Como cada arquivo de feed contém o inventário de todas suas concessionárias, não é necessário criar contas separadas para cada concessionária. Depois que o feed for processado, os veículos serão agrupados por concessionária na página de diagnóstico do portal do parceiro.
- Não oferecemos suporte a atualizações parciais (incrementais) de inventário.
Exemplo de feed
O exemplo de feed CSV a seguir pode ser usado como modelo para seus feeds:
store_code,id,VIN,year,make,model,trim,exterior_color,interior_color,mileage,condition,price,dealership_name,dealership_address,link,image_link,additional_image_link,vehicle_option,vehicle_fulfillment,legal_disclaimer
123,123,JA4AR3AW8GZ057772,2016,Mitsubishi,Outlander Sport,SE,Silver,Black,90377,Used,13998 USD,Dealer 123,123 Street,http://www.example.com/JA4AR3AW8GZ057772,http://www.image.com/image1,"http://www.image.com/image2, http://www.image.com/image3","Bluetooth,Rear View Camera,Front Seat Heaters,Navigation System",IN_STORE,"Price does not include taxes, fees"
Fazer upload do feed para sua caixa de depósito SFTP
Quando você se inscreve na conta de listagens de veículos, uma caixa de depósito SFTP é criada automaticamente. Use as informações do SFTP fornecidas na página Feed do portal do parceiro para fazer o upload dos arquivos CSV.
Há vários métodos para fazer upload de um arquivo com SFTP. As maneiras mais comuns são usar a linha de comando (Terminal) ou um programa SFTP. O método ideal depende de como você gerencia seu inventário. Por isso, não damos instruções específicas sobre como exportar e fazer upload dos seus veículos para o servidor SFTP do Google.
Para minimizar os atrasos no processamento do seu feed pelo Google, recomendamos o seguinte:
- Verifique se o feed passa pela nossa ferramenta de validação.
- Verifique se os dados do veículo estão em conformidade com a especificação do feed e nossas políticas e restrições.
- Envie o feed pelo menos uma vez por dia.
- Faça upload de todo o inventário de cada concessionária que você quer mostrar no Google.
Analisar os resultados do processamento de feed
Depois de enviar o feed, você pode analisar os resultados do processamento. A página Feed no portal do parceiro mostra o status de cada upload de feed. Ele verifica apenas problemas básicos de arquivos e dados, como campos obrigatórios ausentes ou formatação incorreta. Os resultados completos do processamento ficam disponíveis na página Diagnóstico após algumas horas.
Manter seu feed
Recomendamos que você faça o upload da versão mais recente do feed a cada quatro horas. Recomendamos que você atualize o feed com frequência por dois motivos:
- Os uploads de feed mais frequentes aumentam a atualização geral dos dados. Isso reduz o tempo entre as atualizações do inventário e o envio dos dados ao Google.
- Atualizações frequentes permitem a detecção e recuperação mais rápidas de falhas que podem impedir o processamento de um feed.
Sempre que você fizer upload do feed, verifique se ele contém todo o inventário de todas as concessionárias. Os veículos e as concessionárias que não estão em um feed são removidos do Google em algumas horas.
Depois de fazer upload de um feed para o Google, o tempo que os dados levam para atualizar depende do tipo de atualização. Os números na tabela a seguir são estimativas e não são garantidos.
| Mudança no feed | Horário de atualização esperado no Google |
|---|---|
| Adicionar uma nova concessionária | 1 dia |
| Remover uma concessionária | 6 horas |
| Mudar o Perfil da Empresa de uma concessionária | 12 horas |
| Adicionar, remover ou atualizar um carro | 6 horas |
Assinar alertas de feed
Você pode receber uma notificação por e-mail quando o Google não recebe um feed ou quando o feed não é processado por mais de 24 horas. Acesse a página Conta no Portal do parceiro e adicione um novo e-mail de contato para receber esses alertas.