Feeds iniciais (legados)

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 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): o feed descreve os serviços e action_links de nível de serviço que seus comerciantes fornecem à sua plataforma.

    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 Opcional se feeds de serviço forem fornecidos. Caso contrário, é obrigató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ço for fornecido)
    Serviços merchant_id Link para o comerciante que fornece esse serviço Sim (somente se o feed de serviço for fornecido)
    Serviços localized_service_name Nome do serviço prestado Sim (somente se o feed de serviço 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ço for fornecido)
    Serviços digitar Tipo de link direto (por exemplo, SERVICE_TYPE_DINING_RESERVATION) Sim (somente se o feed de serviço for fornecido)

    Para começar, confira os feeds de amostra

    Comerciantes que têm vários serviços, mas os veiculam usando um único link de ação, precisam fornecer um único link de ação para todos os serviços associados a um comerciante no feed de comerciantes.

    Saiba mais sobre como especificar links de ação nos feeds de integração inicial legados 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, é improvável que a integração inicial legada atinja o limite de 200 MB por si só.
    • 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.