Feeds de exportação

Criar feeds

Os feeds precisam ser enviados ao Google regularmente para que os dados sejam exibidos diretamente nele. Os feeds a seguir são necessários.

Feed Descrição Frequência
Comerciantes Descreve os comerciantes. Uma vez a cada 24 horas
Serviços Descreve os serviços que seus comerciantes oferecem Uma vez a cada 24 horas
Disponibilidade Horários disponíveis para os serviços que seus comerciantes oferecem. É necessário cobrir no mínimo 30 dias. Uma vez a cada 24 horas

Em cada feed, inclua metadados que ensinem o Google a interpretá-lo.

O formato dos feeds é descrito com a sintaxe do buffer de protocolo 3, mas é possível fazer o upload dos seus feeds no formato JSON correspondente. Consulte as amostras de feed para ver o formato JSON. Recomendamos que você faça upload dos feeds no formato JSON.

Tamanho, fragmentação e compactação de arquivos de feed

Veja os seguintes tutoriais sobre compactação e fragmentos:

Para determinar o tamanho dos feeds, use as seguintes diretrizes (um feed pode ser constituído por vários arquivos chamados "fragmentos"):

  • Fragmentação sugerida do feed:
    • Feed de comerciantes: 1 fragmento
    • Feed de serviços: 1 fragmento
    • Feed de disponibilidade : menos de 20 fragmentos
  • Tamanho dos arquivos do feed e da fragmentação:
    • O arquivo de fragmento precisa ter até 200 MB (após a compactação). Use vários fragmentos, se necessário.
    • Registros individuais enviados em um fragmento não precisam ser enviados no mesmo fragmento em feeds futuros.
    • Para melhorar o desempenho, divida os dados uniformemente entre os fragmentos para tornar todos os arquivos de fragmento semelhantes em tamanho.
    • Se necessário, use o gzip para compactar os feeds JSON de texto simples. No entanto, faça isso para cada fragmento de feed individual.

Fazer upload dos feeds para sua caixa de depósito SFTP

Faça upload dos seus feeds no ambiente do sandbox. Para isso, consulte os nomes de usuário na página de configuração do feed do Portal do parceiro. O servidor SFTP do Google está disponível em sftp://partnerupload.google.com, na porta 19321.

Recomendamos usar um nome exclusivo em cada arquivo que você enviar. Por exemplo, pode ser útil anexar cada nome de arquivo com um carimbo de data/hora. Isso ajuda a resolver problemas e consultar o status do feed.

Confirmar se seus dados estão corretos

Faça login no Portal do Google Partners. Alterne para o ambiente Sandbox para encontrar as páginas a seguir na seção Painéis.

Feeds
Mostra as estatísticas de resumo do feed e aponta erros durante o upload do feed.

Para confirmar se os dados estão corretos após o upload inicial para o ambiente de sandbox, verifique se há erros na página Feeds. Em seguida, verifique se há problemas de dados na página Resumo do inventário. Problemas comuns incluem fazer upload de comerciantes sem serviços ou enviar serviços sem horários disponíveis no futuro.

O front-end do sandbox, que emula a experiência da IU em tempo real, mostra a aparência dos dados da perspectiva do usuário. Para acessá-lo, verifique se o alternador de ambientes na parte superior está definido como sandbox e acesse Inventário > Inventário , encontre um comerciante que esteja "Pronto" ou "Ativo (no sandbox)". Depois, clique no link na coluna mais à direita (se disponível) ou na linha e, em seguida, no link "RwG – E2E". Se não houver um comerciante com o status "Pronto" ou "Ativo (no sandbox)", abra um comerciante desativado e corrija todos os problemas listados à direita, como um upload futuro de disponibilidade.

Se não for possível acessar o front-end do sandbox, confirme se você fez login com uma conta que recebeu acesso a esse recurso. Verifique também se essa é a única conta em que você fez login. Se você fizer login com uma conta diferente e depois usar o recurso "Alternar usuário" para fazer login na Conta do Google aprovada, ainda não será possível acessar o front-end do sandbox.

Fazer upload dos seus feeds na produção

Depois de fazer o upload consistente de feeds completos e sem erros para o ambiente do sandbox, é possível começar o upload para o ambiente de produção. A integração não vai estar ativa no momento.

Faça upload de um feed completo do comerciante o mais rápido possível (pelo menos uma semana antes do lançamento). Assim, você pode começar a associar seus comerciantes a uma ficha de empresa do Google. Verifique a correção correspondente.

Depois que todos os dados do feed de produção forem enviados de maneira consistente e conectados ao sistema de produção, os feeds estarão prontos para revisão.

O Google avalia os feeds

Depois que você faz upload dos seus feeds, o Google os processa e avalia em relação à qualidade e integridade. Analisamos os seguintes fatores:

  1. Os feeds correspondem à especificação.
  2. Os feeds incluem todos os campos obrigatórios.
  3. O número total de comerciantes nos feeds corresponde ao número discutido com o Google.
  4. Pelo menos um serviço está definido para cada comerciante.
  5. O número total de serviços nos feeds corresponde ao número discutido com o Google.
  6. Verificamos quantos dos serviços têm slots disponíveis durante os próximos 1 a 30 dias .
  7. Verificamos quantos comerciantes podem ser associados a recursos no Google Maps.