Feeds básicos (legados)

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

Criar feeds

  1. Gere seus feeds. Você transmite a maioria dos seus dados de inventário para o Google por feeds. Para começar, crie dois tipos de feed:

    • Feed de comerciantes:descreve seus comerciantes e os links de ação no nível deles.
    • Feed de serviços (opcional): descreve os serviços e os action_links no nível do serviço que os comerciantes prestam para sua plataforma.

    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 links diretos específicos do comerciante Opcional se os feeds de serviços forem fornecidos, obrigatório caso contrário
    Comerciante brand_id String que identifica a marca voltada para o consumidor a ser usada. Opcional
    Serviços service_id Identificador exclusivo do serviço prestado pelo comerciante Sim (somente se o feed de serviços for fornecido)
    Serviços merchant_id Link para o comerciante que fornece esse serviço Sim (somente se o feed de serviços for fornecido)
    Serviços localized_service_name Nome do serviço prestado Sim (somente se o feed de serviços for fornecido)
    Serviços localized_description Descrição do serviço visível para o usuário Opcional
    Serviços action_link Fornece informações sobre os links diretos relacionados ao serviço. Sim (somente se o feed de serviços for fornecido)
    Serviços tipo Tipo de link direto (por exemplo, SERVICE_TYPE_DINING_RESERVATION) Sim (somente se o feed de serviços for fornecido)

    Para começar, confira os exemplos de feeds

    Os comerciantes que têm vários serviços, mas os veiculam usando um único link de ação, podem disponibilizar esse link para todos os serviços associados a um comerciante no feed relevante.

    Saiba mais sobre como especificar links de ação nos feeds de integração inicial legada neste link.

    Inclua metadados do feed em cada um deles para informar ao Google 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 com a sintaxe do buffer de protocolo 3, mas 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 Fundamentos do buffer de protocolo: Java.

  3. Faça o upload dos feeds para seu servidor SFTP. Para fazer upload dos seus feeds, use as informações do servidor 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 e que incluam 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 de feed e fragmentos:
      • O arquivo do feed precisa ter até 200 MB (após a compactação). Compacte-os usando gzip
      • Se o arquivo puder atingir mais de 200 MB (após a compactação), divida-o em vários fragmentos seguindo o tutorial Fragmentação de arquivos de feed . No entanto, é improvável que a integração inicial legada sozinha atinja 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 completo de serviços é disponibilizado 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 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.