> 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 do catálogo de produtos Cada catálogo de produtos tem uma pontuação de integridade que indica quais, se houver, problemas estão presentes no seu catálogo. Para colocar seu catálogo na *excelente* faixa, você deve solucionar 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 duplicados, você verá quantos de cada tipo existem no *Saúde* coluna.
* Os métodos de upload que buscam o catálogo automaticamente devem ser atualizados automaticamente quando o próximo evento de busca ocorrer.
Descrições de integridade | Indicador de integridade | Descrição | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pendente** | Seu catálogo de produtos está sendo enviado. | | **Em processamento** | 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, dando a ele a melhor chance de 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 enviados. Este catálogo terá de ser corrigido e reenviado. |
#### Ver erros e avisos 1. No *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 *Pesquisar* campo 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 quaisquer campos obrigatórios ausentes do catálogo de produtos ou *Todos* campos. | | **Sugeridos** | Você pode filtrar por quaisquer campos recomendados ausentes 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 necessárias. 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 que o registrado com o catálogo* | O *Nome do arquivo enviado* 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 contém nenhum dado processável. | | *O item do catálogo com o ID ocorre mais de uma vez no catálogo, e os após o primeiro serão ignorados* | 2 ou mais itens têm o mesmo ID — todos os produtos exigem um valor exclusivo. Itens duplicados não serão processados. | | *O 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. Isso precisa ser tratado corretamente envolvendo o campo entre aspas duplas e substituindo todas as outras aspas duplas por 2 aspas duplas (por exemplo, *disquete de 3"* torna-se *"3"" disquete"*). | | *(Linha inicial X) EOF atingido antes de o token encapsulado ser concluído* |

EOF significa "fim do arquivo". A linha inicial mencionada tem uma aspa dupla de abertura sem uma aspa dupla de fechamento. Esse erro ocorreu porque não foi encontrada uma aspa dupla de fechamento, mesmo ao ler até o fim do arquivo.

Alternativamente, 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 de produto é inválido e não pode ser aceito. | | *O registro (númeroDoRegistro) tem um erro: O número de valores delimitados (FieldsLength) não corresponde ao esperado (ColumnNamesLength)* | Para uma determinada linha de dados, se houver 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 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 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 taxonomia do seu catálogo de produtos, e os problemas provavelmente surgirão em torno do formato `Categoria` seção. {% tabs %} {% tab title="Categoria de produto do Google ausente" %} Quando você selecionar *erros* na tela de *Catálogos de produtos* tela, você poderá ver *Categoria de produto do Google ausente* no *Sugestões* coluna. Isso significa que nenhum Código de Categoria do Google ou Cadeia 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 itens — essa sugestão deve ser usada ao enviar o catálogo corrigido.
{% endtab %} {% tab title="Incompatibilidade na categoria de produto do Google" %} Quando você selecionar *erros* no *Catálogos de produtos* tela, você poderá ver *Incompatibilidade na categoria de produto do Google* no *Inválido* coluna. Isso significa que a categoria usada para os itens no seu catálogo não corresponde ao [código de taxonomia](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (por exemplo, 7386) ou ao formato de categoria completa que o Google fornece. Veja o exemplo abaixo de um formato completo de categoria do Google. `Animais e suprimentos para animais de estimação > Suprimentos para animais de estimação > Suprimentos para aves > Acessórios para gaiolas de aves > Comedouros e bebedouros para gaiolas 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, em seguida, reenvie o catálogo.
{% endtab %} {% endtabs %} #### Solucionar *Buscar da URL* problemas Se o seu catálogo estiver configurado para extrair de uma URL e não estiver sendo carregado, atualizado ou processado corretamente, use a tabela abaixo para identificar e resolver o problema.
ProblemaO que verificarComo corrigir
A URL não é um link de download diretoAbra sua URL em um navegador. Se ela redirecionar para uma página de login, uma página de destino de armazenamento em nuvem ou retornar um erro 404/403, a URL não é um link de download direto.Atualize a URL para uma que baixe o arquivo diretamente ou o exiba como dados brutos quando aberta em um navegador.
Incompatibilidade no nome do arquivoO Nome do arquivo enviado nas configurações do 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 enviado nas configurações do catálogo para corresponder exatamente ao nome do seu arquivo — uma pequena incompatibilidade 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 que está configurado.Corrija o formato ou o delimitador nas configurações do 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 na 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 busca expira ou falha ao 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çãoPull From URL não oferece suporte a autenticação baseada em sessão ou em cookies.Em vez disso, use uma destas opções: uma URL pública de download direto, 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 Envio 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 preso em Processando ou PendenteVerifique se o arquivo ainda está acessível na URL e se o tamanho do arquivo é incomumente grande para sua frequência de busca.Verifique se o arquivo está disponível. Se o catálogo permanecer em Em processamento ou Pendente, entre em contato com o suporte para solicitar um reprocessamento manual.
Catálogo parou de ser atualizado automaticamenteVerifique se o arquivo ainda está disponível na mesma URL e se o nome do arquivo, o 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 o novo nome do arquivo. Para catálogos grandes (mais de 1 milhão de itens), considere reduzir a frequência de busca para evitar timeouts.
Campos ou dados ausentes após o envioConfirme 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 espaços de campos personalizados do impact.com (Numeric1, Text1, etc.).Baixe o catálogo enviado do impact.com e compare-o com o seu arquivo de origem para identificar onde os dados estão sendo perdidos. Atualize os nomes dos campos ou os mapeamentos conforme necessário e, em seguida, reenvie.
--- # 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.