Etapa 2: feeds

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

Criar feeds

  1. Gere seus feeds. A maioria dos seus dados de inventário é transmitida para o Google por feeds. Para começar, crie seu feed de comerciante (e feed 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 é recomendado implementar feeds de serviços para novas integrações do link comercial do Agendamentos. Se você quiser manter a 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 name 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 Recomendado
    Comerciante action_link Informações sobre 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 feeds de amostra

    Saiba mais sobre como especificar links de ação nos feeds de integração do link comercial de agendamentos neste link.

    Inclua metadados em cada um dos seus feeds para instruir 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 de feeds é descrito com a sintaxe de buffer de protocolo 3. No entanto, você pode consultar os exemplos mencionados acima para ver o formato JSON. Recomendamos que você faça upload dos feeds no formato JSON.

    Se você realmente quiser continuar com o formato pb3, para informações gerais sobre como usar buffers de protocolo para gerar um arquivo pb3, consulte Noções básicas do buffer de protocolo: Java.

  3. Faça o upload dos feeds para sua caixa de depósito SFTP. Para fazer upload dos feeds, use as informações da caixa de depósito SFTP disponibilizadas pelo Google 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 nomes que incluam um carimbo de data/hora. Nomes exclusivos ajudam na solução de problemas e permitem consultas sobre o status do feed.

    Para determinar o tamanho dos feeds e a frequência de entrega, use as seguintes diretrizes:

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

O Google avalia os feeds

Depois que você faz o upload dos seus feeds, o Google os processa e avalia para garantir a qualidade e a integridade. Analisamos os seguintes fatores:

  • Os feeds atendem às especificações.
  • Os feeds incluem todos os campos obrigatórios.
  • Cada comerciante tem pelo menos um action_link ou um serviço com pelo menos action_link definido.
  • A maioria dos dados do comerciante corresponde aos locais do Google Maps.
Anterior
Etapa 1: configuração
Próxima
Etapa 3: piloto e lançamento