Verificar a integridade do seu feed de produtos

Prev Next

Disponibilidade da plataforma

Este artigo indica recursos que ainda estão disponíveis somente na Awin Classic.

Este guia explica como identificar e resolver erros comuns de feed de dados na sua conta Awin. É importante fazer a manutenção de seu feed de produtos, evitando problemas que podem impedir seus parceiros de acessarem os links que desejam compartilhar com seus usuários.

Como verificar o status do seu feed de produtos

Para verificar o status do seu feed de produtos na plataforma, acesse Ferramentas > Links e ferramentas > Meus Feeds de Produtos.

Ao lado do feed, há um ícone na coluna Integridade do feed indicando o status — um tique verde, uma bolinha amarela ou um x vermelho.

Se a integridade do feed estiver amarela ou vermelha, há um problema que precisa ser resolvido. Passando o cursor sobre o ícone, você vê informações sobre o que precisa ser feito.

Entenda os status de integridade do feed

Tique verde - feed saudável

  • O tique verde significa que o feed não contém erros.

  • Está funcionando perfeitamente e disponível para afiliados.

Bolinha amarela - erros não graves

  • Se o feed estiver marcado com a bolinha amarela, há alguns problemas, mas ele ainda pode ser usado por afiliados.

Problemas comuns

  • O feed não contém produtos válidos: erro que ocorre quando há falha geral no upload de um feed, o que é comum em uploads de arquivos XML fora das especificações da Awin.

  • Produtos com erro: duplicação nos IDs de produto ou valores ausentes/incorretos em campos obrigatórios (ex.: preço, nome, URL do produto).

  • Descrição ausente: não há descrições de produtos ou a coluna description não está mapeada corretamente.

  • Problemas de mapeamento de categorias: A coluna merchant_category não está mapeada ou está ausente, ou algumas entradas ainda precisam de mapeamento de categorias.

Solução de problemas

  • Feed sem produtos válidos: verifique se o arquivo está no formato CSV, TSV ou XML. Arquivos CSV e TSV podem ser enviados em formato .TXT. Se estiver usando um URL ou localização FTP, confirme se o link direciona diretamente para um arquivo de feed.

  • Erros nos produtos: clique na opção Clique aqui para baixar ao lado do aviso e verifique as colunas A–R para ver os detalhes do erro.

  • Descrições ausentes: revise o feed e confirme se a description está vinculada à coluna correta.

  • Categorias não mapeadas: verifique se existe uma coluna de categoria de produto, se o nome da coluna está correto e se ela está mapeada para merchant_category.

Cruz vermelha - erros fatais

  • A cruz vermelha indica que o feed tem problemas críticos e não pode ser usado.

  • O último feed funcional continua disponível para os afiliados.

  • Se o erro ocorrer em um feed agendado, ele será desagendado automaticamente.

Problemas comuns

  • O mapeamento de colunas não foi feito durante o upload.

  • Erros na formatação do XML, no pré-processamento do XSLT ou no CML.

  • O caminho para o URL ou FTP do feed não está válido ou acessível.

  • Formato de arquivo incorreto ou formato errado selecionado durante o upload.

  • Ocorreu um problema no sistema durante o upload.

Pode aparecer a mensagem O feed só pode ser processado após o mapeamento de colunas. Se você acessar a seção Atribuição de colunas e encontrar um erro, o mapeamento ficará indisponível até que o problema no feed seja resolvido.

Solução de problemas

  • Verifique se está usando um arquivo em formato CSV, TSV ou XML. Arquivos TXT são aceitos se estiverem formatados corretamente.

  • Verifique se o tipo de arquivo e o delimitador corretos foram selecionados para o upload.

  • Confirme se o URL ou local FTP está correto e acessível. Verifique as credenciais de login.

  • Revise e corrija quaisquer regras de processamento XSLT ou CML.

  • Abra os arquivos XML em um navegador para verificar erros de sintaxe ou formatação inválida.

Outras considerações para solução de problemas

  • Alertas por e-mail: em caso de falha num feed, enviamos um relatório de erros para o endereço de e-mail indicado em Enviar um relatório de erros por e-mail para. Problemas com limites de tempo podem acionar esses alertas, por isso é importante conferir o feed mesmo que você não tenha feito alterações.

  • Ativar o debugging: ative o modo debugging para visualizar logs após cada recuperação. Isso pode ajudar a identificar a causa de uma falha.

  • Processar o feed: adicione o feed à fila de atualização manualmente clicando em Processar o feed.

  • Editar configurações do feed: clique no ícone de lápis para atualizar as configurações do feed.

  • Verificar o atribuição de colunas: clique no ícone de colunas para revisar ou alterar os mapeamentos de colunas.

  • Baixar cópia de teste: use o ícone de download para acessar uma cópia do feed no formato visto pelo afiliado de exemplo.

  • Excluir feed: clique no ícone de lixeira para remover permanentemente o feed.

Solução de problemas internos

Em alguns casos, alterações feitas internamente (fora da plataforma Awin) não aparecem no seu feed de produtos. Para verificar isso, recomendamos baixar o feed para revisão:

  • Se as atualizações estiverem visíveis, seu feed está funcionando corretamente.

  • Se as atualizações não estiverem visíveis, será necessário revisar seu processo interno de atualização.

Importante

Falhas nas atualizações podem não refletir no status de integridade do feed. Recomendamos verificar manualmente o seu feed após qualquer alteração.

Problemas comuns

Se as alterações não estiverem presentes, um dos itens a seguir pode estar impedindo as atualizações:

  • Upload manual não realizado: Seu feed está hospedado em um FTP ou local semelhante que requer uploads manuais.

  • Falha no processo de exportação: Sua exportação interna pode estar bloqueada devido à falta de acesso ou permissões.

  • Sem permissão de gravação: o script de atualização não pode substituir o arquivo existente.

  • Erros de sincronização do PIM: a sincronização automática entre o seu PIM e o local do feed pode estar falhando.

  • Arquivo de feed em cache: uma versão em cache pode estar exibindo dados desatualizados.

Se não conseguir resolver os erros do feed de dados após seguir este guia de solução de problemas, estamos à disposição para ajudar. Se você tem um contato exclusivo na Awin, fale com ele. Caso contrário, você pode falar com nossa equipe de suporte através do formulário de contato.