Etapa 2: feeds

Primeiro, você precisa criar seus feeds, e depois o Google os avalia.

Criar feeds

  1. Gerar os feeds. Você transmite a maioria dos seus dados de inventário para o Google por feeds. Para começar, crie seu feed de comerciante (e de serviços, se aplicável):

    • Feed de comerciantes:descreve seus comerciantes e os links de ação no nível deles.
    • Feed de serviços (opcional / não recomendado): Não é recomendável implementar feeds de serviços para novas integrações do Business Link de pedidos de varejo. Se você quiser manter sua integração atual, siga esta documentação legada.

    Campos obrigatórios e recomendados

    Feed Nome do campo Descrição Obrigatório?
    Comerciante merchant_id Identificador exclusivo do comerciante Sim
    Comerciante nome Nome do comerciante Sim
    Comerciante geo Endereço e coordenadas geográficas do comerciante Sim
    Comerciante telefone Telefone do comerciante Sim
    Comerciante categoria Tipo de lugar do comerciante Nice to Have
    Comerciante action_link Informações sobre os links diretos específicos do comerciante Sim
    Comerciante action_link_type
    Comerciante brand_id String que identifica a marca voltada para o consumidor a ser usada Opcional

    Para começar, confira os exemplos de feeds

    Saiba mais sobre como especificar links de ação nos feeds de integração da Ação comercial de pedidos de varejo neste link.

    Inclua metadados em cada feed que instruem o Google sobre como interpretá-lo.

    Veja a seguir um snippet de metadados de feed:

    "metadata": {
     "generation_timestamp": "1467993600",
     "processing_instruction": "PROCESS_AS_COMPLETE",
     "total_shards": 1
    }
  2. Exporte seus feeds. O formato dos feeds é descrito usando a sintaxe do buffer de protocolo 3, mas você pode consultar os exemplos mencionados acima para conferir o formato JSON. Recomendamos que você faça o upload dos feeds no formato JSON.

    Se você realmente quiser continuar com o formato pb3, confira informações gerais sobre como usar buffers de protocolo para gerar um arquivo pb3 em Fundamentos do buffer de protocolo: Java.

  3. Faça o upload dos feeds para sua caixa de depósito SFTP. Para fazer upload dos seus feeds, use as informações da caixa de depósito SFTP que o Google forneceu e a chave privada que você criou em Configuração. O servidor SFTP do Google está disponível em sftp://partnerupload.google.com na porta 19321.

    Faça o upload dos arquivos com nomes exclusivos, como um nome que inclua um carimbo de data/hora. Isso ajuda na solução de problemas e permite consultar o status do feed.

    Para determinar o tamanho dos feeds e a frequência de exibição, siga estas diretrizes:

    • Tamanho dos arquivos e fragmentos de feed:
      • O arquivo de feed precisa ter até 200 MB (após a compactação). Compacte usando gzip
      • Se o arquivo alcançar mais de 200 MB (após a compactação), divida-o em vários fragmentos seguindo o tutorial Como dividir arquivos de feed . No entanto, essa integração sozinha não vai alcançar o limite de 200 MB.
    • Frequência de atualizações completas:
      • Um feed completo de comerciantes é disponibilizado uma vez por dia.
      • (Se implementado) Um feed de serviços completo é fornecido uma vez por dia.

O Google avalia os feeds

Depois de fazer o upload dos seus feeds, o Google os processa e avalia quanto à qualidade e à integridade. Analisamos os seguintes fatores:

  • Os feeds atendem às especificações.
  • Os feeds incluem todos os campos obrigatórios.
  • Cada comerciante tem pelo menos uma action_link ou um serviço com pelo menos action_link definido.
  • A maioria dos dados do comerciante corresponde aos locais do Google Maps.