> 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, se houver, problemas estão presentes no seu catálogo. Os problemas podem aparecer em qualquer etapa: quando o arquivo é enviado ou conectado, após ser processado, ou quando seus parceiros tentam visualizar e promover seus produtos. Use este guia para resolver problemas em cada etapa e levar seu catálogo ao *excelente* faixa. {% hint style="info" %} **Dica:** Um catálogo saudável vai além de apenas corrigir erros. Siga as [Práticas recomendadas para catálogos de produtos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) para manter seus dados completos, bem estruturados e preparados para boa visibilidade e desempenho. {% endhint %} {% embed url="" %} ## Pontuações de saúde do catálogo 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, a *Saúde* coluna mostra quantos de cada um estão presentes. * Os métodos de upload que buscam o catálogo automaticamente o atualizam por conta própria na próxima vez que ocorrer um evento de busca.
Descrições de saúde | Indicador de saúde | Descrição | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pendente** | Seu catálogo de produtos está aguardando o primeiro upload ou a primeira busca de dados. | | **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, dando a ele a melhor chance de ter um bom desempenho. | | **Bom** | Indica que certos campos sugeridos que contêm dados cruciais, como categoria ou descrição, podem estar ausentes. Corrigir essas lacunas melhora 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ê forneceu. Este catálogo precisa ser corrigido e enviado novamente. |
## Solucione problemas de upload e conexão Antes que um catálogo possa ser processado, o impact.com precisa recebê-lo com sucesso. As etapas abaixo estão agrupadas pelo método de upload que você selecionou ao criar o catálogo. Se você não tiver certeza de qual método está em uso, selecione o catálogo e revise suas *Método de upload* configurações. ### Upload direto Os problemas de Upload direto geralmente são uma incompatibilidade de formato ou nome de arquivo, ou um arquivo que excede o limite de 1 GB. | Problema | O que verificar | Como corrigir | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Formato incorreto selecionado | O formato que você escolheu (por exemplo, TXT) não corresponde ao arquivo que você enviou (por exemplo, XML). | Envie novamente e selecione o formato que corresponda ao seu arquivo. Arquivos XML usam a `.xml` extensão; arquivos CSV usam `.csv`, e arquivos delimitados por TAB usam `.txt`. | | Incompatibilidade no nome do arquivo | O nome do arquivo que você enviou deve corresponder exatamente ao *Nome do arquivo de upload* definido nas configurações do seu catálogo, incluindo a extensão. | Renomeie seu arquivo ou atualize o *Nome do arquivo de upload* para que os dois correspondam exatamente. | | Arquivo compactado não será processado | O impact.com oferece suporte a arquivos compactados gzip e zip padrão. Um arquivo compactado pode usar uma segunda extensão para indicar a compactação, por exemplo `catalog.xml.gz`. | Confirme se o tipo de compactação é gzip ou zip e se o arquivo usa as extensões corretas tanto para o formato quanto para a compactação. | ### Servidor FTP do impact.com A maioria dos problemas de FTP se resume a configurações de conexão ou credenciais. | Problema | O que verificar | Como corrigir | | ----------------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Não é possível conectar ao servidor | Confirme que você está se conectando ao host `products.impact.com` na porta `21`. | Atualize seu cliente FTP com o host e a porta corretos e, em seguida, reconecte-se. | | Credenciais FTP ausentes | Você precisa do login e da senha de FTP emitidos para sua conta para se conectar. | Localize suas *credenciais do FTP Product Data System* nas configurações de configuração técnica da sua conta. Se você não conseguir encontrá-las ou acessá-las, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml). | ### Buscar da URL Os protocolos suportados para *Buscar da URL* são `http://`, `https://`, `ftp://`, e `sftp://`. Se o seu catálogo não estiver carregando, atualizando ou processando corretamente, use a tabela abaixo para identificar e resolver o problema. | Problema | O que verificar | Como corrigir | | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | A URL não é um link de download direto | Abra 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 ou 403, a URL não é um link de download direto. | Atualize a URL para uma que faça o download do arquivo diretamente ou o exiba como dados brutos quando aberta em um navegador. | | Incompatibilidade no nome do arquivo | A *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 a *Nome do arquivo de upload* 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 delimitador | Confirme se o formato selecionado (CSV, TXT, XML, GMC) corresponde ao seu arquivo. Se você usar um arquivo delimitado, confirme se o delimitador (vírgula, tabulação, barra vertical) corresponde ao que está 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álidos | Verifique se sua URL usa o formato `sftp://{username}:{password}@{host}/{file_path}`. O caminho deve apontar para o arquivo exato, e não apenas para um diretório. Caracteres especiais nas credenciais devem ser codificados na URL (por exemplo, `@` torna-se `%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 atinge o tempo limite ou falha ao conectar | O 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 colocar os intervalos de endereços IP do impact.com na lista de permissões. | | A URL requer autenticação | Este método de upload não oferece suporte a autenticação baseada em sessão ou em cookies. | Use 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 o seu feed exigir login pelo navegador, altere seu catálogo para um método de upload diferente, como *Upload direto* ou o *Servidor FTP do impact.com*. | | A URL excede 2.048 caracteres | URLs 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 Pendente | Verifique se o arquivo ainda está acessível na URL e se o tamanho do arquivo é incomumente grande para a sua frequência de busca. | Verifique se o arquivo está disponível. Se o catálogo permanecer em *Processando* ou *Pendente*, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml) para solicitar um reprocessamento manual. | | O catálogo parou de se atualizar automaticamente | Verifique 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 foram alterados. | Restaure o arquivo na URL original ou atualize as configurações do seu catálogo para refletir a nova URL ou o novo nome do arquivo. Para catálogos grandes (mais de 1.000.000 de itens), considere reduzir a frequência de busca para evitar timeouts. | | Campos ou dados ausentes após o upload | Confirme se os nomes dos seus campos correspondem à especificação do formato selecionado, por exemplo [Campos do Google Merchant Center](https://support.google.com/merchants/answer/7052112) para o formato GMC. Mapeie campos personalizados fora da especificação padrão para os slots de campos personalizados do impact.com (`Numeric1`, `Text1`, e assim por diante). | Baixe o catálogo enviado do impact.com e compare-o ao seu arquivo de origem para descobrir onde os dados estão sendo perdidos. Atualize os nomes ou mapeamentos dos campos conforme necessário e, em seguida, envie novamente. | ### Importação integrada do carrinho de compras Este método busca seu catálogo de uma plataforma de e-commerce existente. A maioria dos problemas de conexão se resume a credenciais incorretas ou permissões de leitura ausentes. Selecione sua plataforma abaixo. {% tabs %} {% tab title="Shopify" %} Se você vir um erro como *Unsuccessful HTTP status code when connecting to Shopify: 401* ou *Nenhum registro válido encontrado no arquivo do catálogo*, suas credenciais de autenticação ou permissões geralmente são a causa. * Sua senha deve ser o **token de acesso da API Admin**, que começa com `shpat_` (ou `shap_`). Você o encontrará no seu Admin do Shopify em **Apps** **→** **Credenciais da API** **→** **token de acesso da API Admin**. * Se você não vir o **token de acesso da API Admin**, selecione **Instalar app** no Shopify para gerá-lo. * Confirme se a permissão `read_products` de leitura de produtos (scope) foi concedida ao app. Sem ela, o Shopify retorna um erro informando que a ação requer aprovação do lojista para o `read_products` scope. * Para coleções, encontre o ID da coleção no seu Admin do Shopify em **Produtos** **→** **Coleções**. Selecione a coleção; o ID aparece no final da URL da página. Para ver as etapas completas de configuração, consulte o [guia de integração de catálogo de produtos do Shopify](https://integrations.impact.com/impact-brand/docs/shopify-product-catalog). {% endtab %} {% tab title="WooCommerce" %} Se você vir *A conexão com o WooCommerce não foi bem-sucedida. Tente novamente*, verifique suas credenciais e configurações de API. * Seu **Nome de usuário da API** é sua *Chave do consumidor*, e sua **Senha da API** é sua *Secret do consumidor*. * Ative a Legacy REST API no WooCommerce: **WooCommerce** **→** **Configurações** **→** **Avançado** **→** **API legada**, depois marque a caixa de seleção para ativá-la. Para referência, consulte a [documentação da API REST do WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/). {% endtab %} {% tab title="BigCommerce" %} Conectar o BigCommerce requer dois valores e as permissões corretas somente leitura. * Insira seu **Store Hash** e **Token de acesso** na interface do impact.com. Seu store hash é o identificador no caminho da API da sua loja. * Defina as permissões **Produtos** e **Informações e configurações** como somente leitura ao criar a conta de API no BigCommerce. Para referência, consulte o guia do BigCommerce sobre [criação de tokens de API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token). {% endtab %} {% tab title="Shoplazza" %} Seu aplicativo privado Shoplazza precisa de acesso de leitura aos seguintes recursos: `produto`, `coleção`, e `loja`. Para ver as etapas de configuração, consulte o guia do Shoplazza sobre [criação de aplicativos privados](https://www.shoplazza.dev/reference/quick-construction-of-private-apps). {% endtab %} {% endtabs %} ## Solucione erros e avisos após o upload Assim que um arquivo é recebido, o impact.com valida cada registro. Erros impedem que os registros sejam processados, enquanto avisos sinalizam dados que foram aceitos, mas podem causar problemas. Use as seções abaixo para interpretar e resolvê-los. ### Ver erros e avisos 1. Na *Saúde* coluna, selecione o link **erros**, **avisos**, ou **duplicados** link. * Você será redirecionado para uma página com mais detalhes. Apenas o primeiro item em um conjunto de duplicados é representado no impact.com; todos os itens que duplicam o primeiro são ignorados. 2. Opcionalmente, use o *Pesquisar* campo e os filtros no topo da página para classificar os problemas. 3. Revise os problemas e faça as alterações necessárias; depois, envie novamente seu catálogo de produtos.
Descrições dos filtros | Filtrar | Descrição | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | | Tipo de erro | Filtrar especificamente por *Erros*, *Avisos*, *Duplicados*, ou *Todos* problemas. | | Obrigatório | Filtre por quaisquer campos específicos obrigatórios ausentes do catálogo de produtos, ou *Todos* campos. | | Sugeridos | Filtre por quaisquer campos específicos recomendados ausentes do catálogo de produtos, ou *Todos* campos. | | Inválido | Filtre por qualquer erro específico baseado em validação, como um SKU duplicado, um Código de Categoria do Google inválido ou outros erros. |
Mensagens comuns de erro e aviso | Mensagem | 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 no catálogo* | A *Nome do arquivo de upload* definido na *Método de upload* seção ao criar o catálogo 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 dados processáveis. | | *O item do catálogo com o ID aparece mais de uma vez no catálogo, e os itens após o primeiro serão ignorados* | Dois ou mais itens têm o mesmo ID. Todos os produtos exigem um valor exclusivo, e itens duplicados não são processados. | | *O registro 'X' tem um erro: (linha X) caractere inválido entre o token encapsulado e o delimitador* | Uma linha contém um uso inválido de aspas duplas. Coloque o campo entre aspas duplas e substitua todas as outras aspas duplas por duas aspas duplas. | | *(Linha inicial X) EOF alcançado antes de o token encapsulado terminar* | EOF significa "fim do arquivo". A linha inicial mencionada tem uma aspa dupla de abertura sem uma aspa dupla de fechamento, ou uma quebra de linha inesperada interrompeu o fluxo de dados. | | *Erro ao analisar o campo (tipo de catálogo): com o valor: (campo)* | O campo de 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, existem dados em uma coluna que não tem cabeçalho. | | *Nenhum registro válido foi encontrado no arquivo do catálogo* | O arquivo de dados está vazio, os dados detectados não são válidos ou o nome de arquivo especificado está incorreto. | | *Mais de 10% dos registros no arquivo apresentaram erros* | O arquivo de dados não pode ser processado se isso ocorrer. Consulte *Entenda o limite de 10% de erros* abaixo. | | *O processamento falhou devido a um erro interno do sistema...* | Nenhuma ação é necessária da sua parte. O último catálogo que foi processado com sucesso continua disponível para os parceiros de mídia. 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 possui um protocolo válido* | O valor do campo não é uma URL formatada corretamente. |
### Avisos de formatação e delimitador | Problema | Como corrigir | | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Problemas de delimitador: uma vírgula, tabulação ou linha em branco incorreta quebra o limite entre os campos. | Corrija o uso do delimitador no arquivo do catálogo para que cada campo seja separado de forma consistente e, em seguida, envie novamente. | | Novas linhas em um campo de descrição interrompem o processamento do registro. | Novas linhas não são suportadas em formatos de texto delimitados (CSV e TSV). Remova quebras de linha de campos de texto, como descrições, antes de enviar. | ### Erros de formato do Google Merchant Center Se você usar o formato do Google Merchant Center (GMC), a maioria dos problemas surge em torno da `Categoria` seção, dos valores de campo predefinidos ou da estrutura XML. {% 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* na *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 isso, consulte sua [conta do Google Merchant Center](https://merchants.google.com/). O Google sugere automaticamente categorias para os itens; use essas sugestões ao enviar o catálogo corrigido.
{% endtab %} {% tab title="Incompatibilidade na categoria de produto do Google" %} Quando você seleciona *erros* na *Catálogos de produtos* tela, você pode ver *Incompatibilidade na categoria de produto do Google* na *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 completo de categoria fornecido pelo Google, por exemplo: `Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes` Para resolver isso, corrija o formato em que as Categorias de Produto do Google estão listadas e, em seguida, envie novamente seu catálogo.
{% endtab %} {% tab title="Valor de disponibilidade não aceito" %} Um erro como *Não foi possível analisar o campo: availability com o valor* significa que um campo predefinido está usando um valor que o GMC não reconhece. Para catálogos GMC, categorias e valores devem ser exatos. * Use `availability` para o campo de disponibilidade. * Os valores de disponibilidade suportados são `in_stock`, `out_of_stock`, `preorder`, e `backorder`. * Verifique se há símbolos especiais que podem afetar a formatação, como um símbolo de moeda aparecendo em um campo de valor. {% endtab %} {% tab title="XML: nenhum registro válido encontrado" %} Se você enviar um catálogo do Google Merchant Center (formato XML) e vir *Nenhum registro válido encontrado no arquivo do catálogo. Corrija o arquivo e envie novamente*, a estrutura XML provavelmente está incorreta. O arquivo XML deve conter `rss`, `RDF`, ou `feed` em seu elemento inicial. Corrija o elemento raiz e envie novamente. {% endtab %} {% endtabs %} {% hint style="info" %} **Formato do eBay Commerce Merchant Center:** Em um `.csv` arquivo, substitua os espaços nos valores da coluna de campo (categorias) por sublinhados. Por exemplo, use `Item_Title` em vez de `Item Title`. {% endhint %} ### Entenda o limite de 10% de erros Se mais de 10% dos registros em um arquivo enviado contiverem erros, o arquivo não será processado. Quando isso acontecer: * Seu catálogo continua mostrando a versão do último envio bem-sucedido, então um *último envio bem-sucedido* timestamp é esperado. * A **Ver produtos** a opção só aparece se um arquivo tiver sido enviado com sucesso anteriormente para esse ID de catálogo. Corrija os registros sinalizados para que menos de 10% contenham erros e, em seguida, envie novamente. ## Torne seu catálogo disponível para parceiros Um catálogo saudável ainda não chegará aos seus parceiros até que você o disponibilize e atenda aos requisitos de visibilidade para parceiros. Use esta seção se o seu catálogo foi processado com sucesso, mas os parceiros estiverem enfrentando problemas de visibilidade, acesso ao produto ou links de rastreamento. ### Os parceiros não conseguem ver o catálogo Verifique as duas configurações a seguir: * Certifique-se de que o catálogo esteja disponível para uso: 1. 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) e localize o catálogo. 2. Selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[Mais]** e depois escolha **Tornar disponível para uso**. * Verifique se o acesso de parceiros está restrito: 1. 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) e localize o catálogo. 2. Passe o mouse sobre o catálogo e, em seguida, selecione **Editar**. 3. Na *Restringir acesso de parceiros* seção, verifique se **Permitir acesso somente a parceiros específicos** está ![](/files/56148a29d7f42673dde9884eb52356c45eca06c3) ativado. 4. Se estiver, ![](/files/31ae814d7a1b0e318e06b0e354badc33a8e27e14) desative-o e selecione **Salvar**. ### Os parceiros não conseguem ver nem pesquisar produtos específicos Para um produto ficar visível na interface do parceiro, ele deve atender a todos os seguintes requisitos: * O preço original é superior a US$ 2,00. * A disponibilidade de estoque do produto não é *Sem estoque.* * O produto tem uma URL válida que leva a uma página ativa de detalhes do produto. * O produto tem uma URL de imagem. * O produto está em um catálogo sem [regras](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) aplicadas. ### Os links de rastreamento dos parceiros retornam um erro de "malformado" Se os parceiros virem "O link em que você clicou está malformado" ao usar links de rastreamento dos seus produtos, o deep linking geralmente não está ativado, ou o domínio da página de destino do produto não está definido como um domínio permitido. Para ativar o deep linking, defina seus domínios permitidos e resolver esse erro, consulte [Configurar domínios permitidos para deep linking](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md). --- # 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.