Criar feeds
Os feeds precisam ser fornecidos ao Google regularmente para que os dados sejam mostrados diretamente na plataforma. Os feeds a seguir são necessários.
Feed | Descrição | Frequência |
---|---|---|
Comerciantes | Descreve seus comerciantes. | Uma vez a cada 24 horas |
Serviços | Descreve os serviços que seus comerciantes oferecem | Uma vez a cada 24 horas |
Disponibilidade | Caça-níqueis disponíveis para os serviços oferecidos pelos seus comerciantes. É necessário fornecer um mínimo de 30 dias de cobertura. | Uma vez a cada 24 horas |
Em cada feed, inclua os metadados que mostrem ao Google como interpretá-lo.
O formato dos feeds é descrito usando a sintaxe do buffer de protocolo 3, mas é possível fazer upload dos feeds no formato JSON correspondente. Consulte os exemplos de feed para ver o formato JSON. Recomendamos que você faça upload dos feeds no formato JSON.
Tamanho do arquivo do feed, fragmentação e compactação
Consulte os seguintes tutoriais sobre compactação e fragmentos:Para determinar o tamanho dos feeds, siga as diretrizes a seguir (um feed pode ser constituído por vários arquivos chamados de "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 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 melhor desempenho, divida os dados uniformemente entre os fragmentos para tornar todos os arquivos de fragmento semelhantes.
- 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 para o ambiente do sandbox. Para isso, consulte os nomes de usuário na página 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 seguintes páginas 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 do 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 o upload de comerciantes sem serviços ou de serviços sem horários disponíveis no futuro.
O front-end do sandbox, que emula a experiência da interface em tempo real, mostra como os dados serão exibidos da perspectiva do usuário. Para acessá-lo, verifique se o alternador de ambiente na parte superior está definido como Sandbox e acesse Inventário > Inventário , encontre um comerciante "Pronto" ou "Ativo (no sandbox)" e clique no link na coluna mais à direita (se disponível) ou na linha e depois no link "RwG - E2E". Se não houver um comerciante com status "Pronto" ou "Ativo (no sandbox)", abra um comerciante desativado e corrija todos os problemas listados à direita (por exemplo, garantir que a disponibilidade futura seja enviada).
Se não for possível acessar o front-end do sandbox, verifique se você fez login com uma conta que recebeu acesso a ele. Verifique também se essa é a única conta em que você fez login. Se você fizer login com uma conta diferente e usar o recurso "Trocar usuário" para fazer login na Conta do Google aprovada, ainda não poderá 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, você pode começar o upload para o ambiente de produção. Nesse momento, sua integração não estará ativa.
Faça upload de um feed completo do comerciante o mais rápido possível (no mínimo uma semana antes do lançamento) para começar a associar seus comerciantes a uma ficha da empresa no Google. Verifique se a correspondência está correta.
Quando todos os dados do feed de produção estiverem sendo enviados de maneira consistente e conectados ao seu sistema de produção, os feeds estarão prontos para revisão.
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 correspondem à especificação.
- Os feeds incluem todos os campos obrigatórios.
- O número total de comerciantes nos feeds corresponde ao número discutido com o Google.
- Pelo menos um serviço está definido para cada comerciante.
- O número total de serviços nos feeds corresponde ao número discutido com o Google.
- Verificamos quantos serviços têm horários disponíveis para os próximos 1 a 30 dias.
- Verificamos quantos comerciantes indicados podem ser correspondidos a recursos no Google Maps.