> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md). # Solucionar erros e avisos de catálogos de produtos Cada catálogo de produtos tem uma pontuação de saúde que indica quais problemas, se houver, estão presentes no seu catálogo. Para colocar seu catálogo na *faixa excelente* , você precisa identificar e corrigir quaisquer erros, avisos e duplicatas presentes nele. {% embed url="" %} 1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage]** → **Conteúdo** → **Produtos** → [**Catálogos de Produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. Se um catálogo tiver erros, avisos ou itens de linha duplicados, você verá quantos de cada um estão presentes na *Saúde* coluna.
* Os métodos de upload que buscam automaticamente o catálogo devem ser atualizados automaticamente quando o próximo evento de busca acontecer.
Descrições de saúde | Indicador de saúde | Descrição | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pendente** | Seu catálogo de produtos está sendo enviado. | | **Processando** | Seu catálogo de produtos está sendo processado. | | **Excelente** | Indica um catálogo saudável—este conjunto de dados de produtos está completo e bem estruturado, o que lhe dá a melhor chance de ter um desempenho eficaz. | | **Bom** | Indica que certos campos sugeridos que contêm dados cruciais, como categoria ou status, podem estar ausentes. Corrigir essas lacunas melhorará a qualidade geral do seu catálogo. | | **Ruim** | Indica que informações obrigatórias estão ausentes em mais de 10% dos registros que você enviou. Esse catálogo terá de ser corrigido e reenviado. |
#### Ver erros e avisos 1. Na *Saúde* coluna, selecione o **erros**, **avisos**, ou **duplicatas** link. * Você será redirecionado para uma página com mais detalhes sobre os erros ou avisos. Apenas o primeiro item em um conjunto de duplicatas será representado no impact.com; todos os itens que duplicarem o primeiro serão ignorados. 2. Opcionalmente, use o *campo de Pesquisa* e os filtros no topo da página para classificar os problemas.
Descrições dos filtros | | | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Tipo de erro** | Você pode filtrar especificamente por *Erros*, *Avisos*, *Duplicatas*, ou *Todos* problemas. | | **Obrigatório** | Você pode filtrar por qualquer campo obrigatório ausente específico do catálogo de produtos ou *Todos* campos. | | **Sugerido** | Você pode filtrar por qualquer campo recomendado ausente específico do catálogo de produtos ou *Todos* campos. | | **Inválido** | Você pode filtrar por qualquer erro específico baseado em validação. Isso pode ser um SKU duplicado, um Código de Categoria do Google inválido ou outros erros. |
3. Revise os problemas e faça as alterações conforme necessário. Depois, reenvie seu catálogo de produtos.
Mensagens comuns de erro e aviso | Mensagem de erro | Explicação | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | *Registro 'X': campo(s) obrigatório(s) ausente(s): (nome do campo)* | A linha especificada está sem um ou mais campos obrigatórios. | | *Registro 'X': CatalogItemId(CatalogItemId): campo(s) obrigatório(s) ausente(s): (nome do campo)* | Uma linha no arquivo de dados está sem um campo obrigatório. | | *Nenhum catálogo encontrado para a solicitação. Verifique se o nome do arquivo enviado é o mesmo registrado com o catálogo* | O *Nome do Arquivo de Upload* definido na *Método de Upload* seção ao criar um catálogo de produtos não corresponde exatamente ao nome do arquivo que você enviou. | | *Nenhum atributo presente no arquivo do catálogo* | O arquivo de dados do catálogo de produtos não tem nenhum dado processável. | | *Um item do catálogo com ID aparece mais de uma vez no catálogo, e os que vierem após o primeiro serão ignorados* | 2 ou mais itens têm o mesmo ID—todos os produtos exigem um valor único. Itens duplicados não serão processados. | | *Registro 'X' tem um erro: (linha X) caractere inválido entre o token encapsulado e o delimitador* | Uma linha no arquivo de dados contém um uso inválido de aspas duplas. Elas precisam ser tratadas corretamente envolvendo o campo em aspas duplas e substituindo todas as outras aspas duplas por 2 aspas duplas (por exemplo, *3" disquete* torna-se *"3"" disquete"*). | | *(Linha de início X) EOF alcançado antes de o token encapsulado ser concluído* |

EOF significa "fim do arquivo". A linha de início mencionada tem uma aspas duplas de abertura sem uma aspas duplas de fechamento. Esse erro ocorreu porque uma aspas duplas de fechamento não foi encontrada, mesmo ao ler até o fim do arquivo.

Como alternativa, uma quebra de linha inesperada pode ter interrompido o fluxo de dados.

| | *Erro ao analisar o campo (tipo de catálogo): com valor: (campo)* | O campo do produto é inválido e não pode ser aceito. | | *O registro (recordNumber) tem um erro: o número de valores delimitados (FieldsLength) não corresponde ao esperado (ColumnNamesLength)* | Para uma determinada linha de dados, se existir dados em uma coluna sem cabeçalho, esse erro ocorrerá. | | *Nenhum registro válido foi encontrado no arquivo do catálogo* | Ou o arquivo de dados está vazio (ou seja, sem dados), os dados detectados não são válidos, ou o nome do arquivo especificado está incorreto. | | *Mais de 10% dos registros no arquivo apresentaram erros.* | O arquivo de dados não pode ser processado se esse erro ocorrer. | | *O processamento falhou devido a um erro interno do sistema. Nenhuma ação é necessária por parte do usuário. Nossa equipe de Engenharia foi notificada e está trabalhando para resolver o problema. O último catálogo processado com sucesso continuará disponível para os Parceiros de Mídia. Entre em contato com o suporte do impact.com se precisar de mais informações.* | Consulte a [página de status do impact.com](https://status.impact.com/) para detalhes sobre interrupções de serviço. | | *O campo (nome do campo) com o valor (valor do campo) não tem um protocolo válido* | O valor do campo não é uma URL formatada corretamente. |
#### Erros de formato do Google Merchant Há 2 problemas que você pode encontrar se estiver usando o formato do Google Merchant Center como a taxonomia do seu catálogo de produtos, e os problemas provavelmente surgirão na seção `Categoria` do formato. {% tabs %} {% tab title="Categoria de Produto do Google ausente" %} Quando você seleciona *erros* na *Catálogos de Produtos* tela, você pode ver *Categoria de Produto do Google ausente* em *Sugestões* coluna. Isso significa que nenhum Código de Categoria do Google ou string completa de categoria do Google foi incluído no seu catálogo. Para resolver esse problema, consulte sua conta do Google Merchant Center. O Google sugere categorias automaticamente para os itens — essa sugestão deve ser usada ao enviar o catálogo corrigido.
{% endtab %} {% tab title="Incompatibilidade da Categoria de Produto do Google" %} Quando você seleciona *erros* em *Catálogos de Produtos* tela, você pode ver *Incompatibilidade da Categoria de Produto do Google* em *Inválido* coluna. Isso significa que a categoria usada para os itens no seu catálogo não corresponde ao esperado [código de taxonomia](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (por exemplo, 7386) ou ao formato completo de categoria fornecido pelo Google. Veja o exemplo abaixo de um formato completo de categoria do Google. `Animais e suprimentos para pets > Suprimentos para pets > Suprimentos para aves > Acessórios para gaiola de aves > Comedouros e bebedouros para gaiola de aves` Para resolver esse problema, corrija o formato em que as Categorias de Produto do Google estão listadas no seu catálogo e, depois, reenvie-o.
{% endtab %} {% endtabs %} #### Solucionar problemas *Buscar da URL* problemas Se o seu catálogo estiver configurado para buscar de uma URL e não estiver carregando, atualizando ou processando corretamente, use a tabela abaixo para identificar e resolver o problema.
ProblemaO que verificarComo corrigir
A URL não é um link direto de downloadAbra sua URL em um navegador. Se ela redirecionar para uma página de login, uma página inicial de armazenamento em nuvem ou retornar um erro 404/403, a URL não é um link direto de download.Atualize a URL para uma que faça download do arquivo diretamente ou o exiba como dados brutos quando aberta em um navegador.
Nome do arquivo incompatívelO Nome do Arquivo de Upload nas configurações do seu catálogo deve corresponder exatamente ao nome real do arquivo na URL, incluindo a extensão (.csv, .xml, .txt, .gz).Atualize o Nome do Arquivo de Upload nas suas configurações de catálogo para corresponder exatamente ao nome do arquivo — uma pequena diferença causa um Nenhum catálogo encontrado para a solicitação erro.
Incompatibilidade de formato ou delimitadorConfirme se o formato selecionado (CSV, TXT, XML, GMC) corresponde ao seu arquivo. Se estiver usando um arquivo delimitado, confirme se o delimitador (vírgula, tabulação, barra vertical) corresponde ao configurado.Corrija o formato ou delimitador nas configurações do seu catálogo. Uma incompatibilidade causa Nenhum registro válido encontrado erros.
FTP/SFTP: credenciais ou caminho inválidosVerifique se sua URL usa o formato: sftp://{username}:{password}@{host}/{file_path}. O caminho deve apontar para o arquivo exato, não apenas para um diretório. Caracteres especiais nas credenciais devem ser codificados em URL (por exemplo, @ → %40).Teste suas credenciais com um cliente FTP como o FileZilla. Atualize a URL com as credenciais corrigidas e o caminho completo do arquivo.
A extração expira ou não consegue se conectarO firewall do seu servidor pode estar bloqueando as solicitações do impact.com.Entre em contato com seu provedor de hospedagem ou equipe de TI para permitir os intervalos de endereços IP do impact.com.
A URL requer autenticaçãoBuscar da URL não oferece suporte à autenticação baseada em sessão ou em cookies.Use uma das alternativas a seguir: uma URL de download direto publicamente acessível, Autenticação Básica HTTP incorporada na URL (https://user:pass@host/path), ou FTP/SFTP com credenciais na URL. Se seu feed exigir login baseado em navegador, mude para Upload Direto ou FTP Push.
A URL excede 2.048 caracteresURLs assinadas de armazenamento em nuvem podem exceder o limite de 2.048 caracteres e podem ser truncadas.Use um encurtador de URL que preserve o download direto ou hospede o arquivo em uma URL mais curta.
Catálogo travado em Processando ou PendenteVerifique se o arquivo ainda está acessível na URL e se o tamanho do arquivo é incomumente grande para a frequência da sua extração.Verifique se o arquivo está disponível. Se o catálogo permanecer em Processando ou Pendente, entre em contato com o suporte para solicitar um reprocessamento manual.
O catálogo parou de se atualizar automaticamenteVerifique se o arquivo ainda está disponível na mesma URL e se o nome do arquivo, formato ou as configurações de acesso ao servidor mudaram.Restaure o arquivo na URL original ou atualize as configurações do catálogo para refletir a nova URL ou nome do arquivo. Para catálogos grandes (1 milhão+ de itens), considere reduzir a frequência de extração para evitar timeouts.
Campos ou dados ausentes após o uploadConfirme se os nomes dos seus campos correspondem à especificação do formato selecionado — por exemplo, campos do Google Merchant Center para o formato GMC. Mapeie campos personalizados fora da especificação padrão para os slots de campos personalizados do impact.com (Numeric1, Text1, etc.).Baixe o catálogo enviado do impact.com e compare-o com seu arquivo de origem para identificar onde os dados estão sendo perdidos. Atualize os nomes ou mapeamentos dos campos conforme necessário e, em seguida, envie novamente.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.