Confira abaixo alguns problemas comuns que podem surgir ao processarmos seus feeds de avaliações do comerciante. Fornecemos descrições de cada problema de dados e as etapas que você pode seguir para resolver cada um deles. Quando um problema de dados é detectado no seu feed, o suporte do agregador de classificações da loja notifica você sobre ele.
A maioria dos problemas de dados pode ser resolvida enviando novos arquivos de feed para seu endpoint. Em vez de consolidar as correções com seu feed diário de novas lojas e avaliações, crie um arquivo separado com todas as correções para problemas pendentes. Além disso, observe os nomes dos arquivos que contêm correções. Os nomes de arquivo são necessários caso uma correção não resolva um problema de dados e você precise entrar em contato com a equipe de suporte para receber ajuda.
Confira abaixo as etapas típicas envolvidas na correção de um problema de dados.
- Você entrega um arquivo de feed diário ao seu endpoint: 2017-11-10.xml. Esse arquivo contém uma classificação inválida.
- Você entrega um segundo arquivo de feed diário ao endpoint, que não tem problemas de dados: 2017-11-11.xml.
- Depois que a equipe de suporte notifica você sobre um problema, você envia um novo arquivo de feed, 2017-11-11_fix.xml,
que contém uma classificação válida para a avaliação inválida enviada anteriormente. Esse registro válido tem um
last_update_timestampatualizado para indicar que a avaliação tem uma classificação válida e resolver o problema de dados.
Ao ler este guia, lembre-se do seguinte:
- Os arquivos de feed são baixados em buscas periódicas. Se um problema de dados for detectado em uma busca, os novos dados dessa busca ou das seguintes não serão veiculados até que todos os problemas sejam resolvidos.
- Enquanto houver problemas de dados pendentes no seu feed, eles vão continuar sendo buscados e processados para novos problemas.
- Quando todos os problemas de dados forem resolvidos, todos os dados baixados do seu endpoint serão veiculados.
- Há uma causa raiz para cada problema de dados, seja um dado inválido no banco de dados ou um bug na forma como os dados foram gerados. Antes de fornecer um feed de correção para problemas de dados pendentes, verifique se a causa raiz do problema foi resolvida. Resolver a causa raiz evita que novos problemas do mesmo tipo ocorram. Depois de corrigir a causa raiz, você pode trabalhar na entrega de arquivos de feed corrigidos.
- Os arquivos de correção (ou seja, arquivos que terminam em "_fix.xml") não devem incluir registros que não se destinam a corrigir problemas de dados pendentes.
- Se as correções não resolverem automaticamente os problemas de dados, responda à comunicação que notificou você sobre o problema para entrar em contato com a equipe de suporte.
- Como essas correções para problemas de dados geralmente envolvem a entrega de entidades de comerciantes e avaliações nos seus feeds, é útil consultar a documentação do esquema XML antes de ler sobre cada problema de dados.
- Para simplificar, a documentação abaixo pressupõe que você está corrigindo um único problema de dados de um tipo específico. Na prática, vários problemas de dados podem ocorrer ao mesmo tempo. Ao entregar correções, você pode consolidar as correções de vários problemas em um único arquivo de feed. Da mesma forma, ao entrar em contato com a equipe de suporte, consolide as comunicações sobre diferentes problemas de dados.