Saltar para o conteúdo

Erros de catálogo: como detetar problemas antes de perder produtos nas campanhas

Um guia simples para rever importações, quebras de artigos, avisos do feed e limites de alerta sem depender da sorte.

J

Julia Villegas

· 9 min de leitura · 253 visualizações
Percurso de produtos para detetar erros de catálogo num feed

Os erros de catálogo podem deixar produtos fora das suas campanhas antes de alguém os ver em Meta, Google Shopping, TikTok ou Pinterest. Se gere uma loja online, rever importações, quebras de artigos e avisos do feed ajuda-o a detetar problemas cedo, sem assumir que o catálogo está correto só porque “foi carregado”.

Um catálogo é a lista estruturada de produtos que envia para uma plataforma de publicidade ou comércio. Normalmente inclui identificador, título, descrição, preço, disponibilidade, imagem, ligação do produto, marca, categoria e outros atributos exigidos por cada canal.

Um feed de produtos é o ficheiro ou URL que transporta esse catálogo. Pode estar em XML, CSV, TSV, JSON ou noutro formato aceite pela plataforma. A lógica é simples: a sua loja tem os dados; o feed prepara esses dados para que o canal os consiga ler.

Os erros de catálogo aparecem quando essa cadeia se parte ou perde qualidade. Nem sempre são visíveis de imediato. Às vezes, o canal aceita o feed, mas perde cobertura, segmentação ou qualidade de dados. Para começar, vale a pena distinguir três sinais:

Sinal O que significa Porque importa
Erro O produto ou o feed não cumpre uma condição necessária Pode impedir que um artigo seja usado em campanhas
Aviso Há um dado incompleto, fraco ou potencialmente problemático Pode afetar a qualidade do catálogo ou futuras revisões
Quebra de artigos O número de produtos importados ou exportados baixa face ao esperado Pode indicar stock mal lido, filtros excessivos ou campos partidos

Um erro típico seria um produto sem imagem válida. Um aviso pode ser uma categoria incompleta, um título pouco descritivo ou um atributo recomendado em falta. Uma quebra de artigos pode acontecer se um fornecedor mudar o nome de uma coluna, se uma regra filtrar mais produtos do que devia ou se uma importação chegar incompleta.

A questão principal não é apenas confirmar se “o feed existe”. Precisa também de perceber o que entrou, o que saiu, que dados foram transformados e que avisos se repetem.

Os anúncios de catálogo dependem de três condições básicas: o produto tem de existir no catálogo, os dados têm de ser legíveis e o artigo tem de estar disponível no canal certo. Quando o catálogo falha, o problema deixa de ser apenas técnico. Afeta orçamento, campanhas, planeamento e trabalho diário.

Isto é especialmente importante se:

  • Gere muitos produtos e não consegue validá-los manualmente um a um.
  • Tem alterações frequentes de preço, promoção ou stock.
  • Usa o mesmo catálogo para vários canais, cada um com requisitos próprios.
  • Ativa e desativa categorias por época, campanha ou margem.
  • Importa dados de fornecedores, marketplaces, ERP ou ficheiros externos.
  • Trabalha numa agência e precisa de detetar alterações anómalas em vários clientes.

Exemplo fictício: uma loja com 8.000 produtos começa a semana sem incidentes. Na terça-feira, uma coluna de disponibilidade muda de in_stock para available, mas a regra que prepara o feed não reconhece o novo valor. A URL continua a funcionar e ninguém vê uma falha evidente. Ainda assim, uma parte do catálogo pode ficar fora do conjunto de produtos usado nas campanhas.

É este tipo de problema que convém detetar antes de se transformar em perda de cobertura. Não se trata de prometer zero falhas: cada canal tem a sua própria revisão, e a frequência com que gera ou importa o feed pode ser diferente da frequência com que o canal o lê. O objetivo é criar uma rotina de controlo que reduza surpresas.

Erros de catálogo: sinais que deve rever

Para detetar erros de catálogo de forma prática, pense em cinco pontos de controlo: importação, mapeamento, variação de artigos, regras e avisos por canal.

1. Importação: confirmar que entra o catálogo esperado

A primeira pergunta não deve ser “o feed foi gerado?”, mas sim “entrou o catálogo certo?”. Se liga uma loja ou um ficheiro, confirme se a fonte foi lida e se os campos principais aparecem preenchidos.

Campos mínimos a verificar:

  • ID ou identificador único do produto.
  • Título.
  • Preço.
  • Disponibilidade ou stock.
  • URL do produto.
  • URL da imagem.
  • Categoria ou tipo de produto.
  • Marca, quando aplicável.

Se um destes campos aparece vazio em massa, o problema pode estar na loja, no ficheiro original, no mapeamento ou numa transformação posterior.

2. Mapeamento: traduzir os seus campos para o formato do canal

Mapear significa indicar que campo do seu catálogo corresponde a cada atributo pedido por um canal. Por exemplo, a sua loja pode chamar nome_produto ao que Meta, Google Shopping ou outro destino esperam receber como título.

O mapeamento costuma funcionar bem até alguém alterar a estrutura do ficheiro de origem. Se um fornecedor muda price para sale_price, o feed pode deixar de receber o preço esperado se essa correspondência não for revista.

Uma revisão simples consiste em abrir uma amostra de produtos e confirmar se cada atributo aparece no sítio certo. Não precisa de ler milhares de linhas: escolha casos representativos, incluindo produtos com promoção, sem stock, com variantes e de categorias diferentes.

3. Quebra de artigos: definir limites antes do susto

Uma quebra de artigos acontece quando o catálogo final contém menos produtos do que o esperado. Pode ser normal se filtrou artigos sem stock ou se uma campanha usa apenas uma categoria. O problema surge quando a quebra não estava prevista.

Para principiantes, um limite de alerta é uma regra interna de vigilância: “se baixar mais do que considero normal, tenho de rever”. Não existe uma percentagem universal. Uma loja com stock muito volátil precisa de tolerâncias diferentes de uma loja com catálogo estável.

Exemplo fictício: uma loja de decoração costuma importar entre 12.000 e 12.500 produtos. Depois de aplicar regras para excluir artigos descontinuados, o feed para Meta fica normalmente entre 10.500 e 11.000 artigos. Se num dia o feed final tiver 6.200, não basta dizer “foi gerado”. É preciso perceber o que aconteceu.

Pode começar com uma tabela de controlo simples:

Ponto de controlo Valor esperado O que rever se mudar
Produtos na origem Intervalo habitual da loja ou ficheiro Fonte incompleta, fornecedor, exportação da loja
Produtos após limpeza Intervalo depois de remover duplicados ou dados inválidos Regras demasiado amplas, campos vazios
Produtos por conjunto Intervalo de cada campanha ou categoria Filtros de categoria, stock, preço ou marca
Produtos no feed final Intervalo aceitável por canal Mapeamento, formato, requisitos do destino

Trabalhar com intervalos evita reagir a variações normais, mas ajuda a detetar mudanças fora do padrão.

4. Regras e conjuntos: vigiar o que está a excluir

Uma regra transforma, completa ou filtra dados. Por exemplo: “se o produto não tiver imagem, excluir do feed” ou “se o preço for zero, marcar para revisão”. Um conjunto é um subconjunto do catálogo: produtos de uma categoria, uma marca, um intervalo de preço ou uma campanha específica.

As regras ajudam a manter o catálogo organizado, mas também podem provocar quebras se forem demasiado abrangentes. Antes de publicar alterações importantes, confirme que regra foi modificada, a que produtos se aplica, quantos produtos ficam antes e depois e se o conjunto final continua a fazer sentido para a campanha.

Este cuidado é ainda mais importante quando um único catálogo alimenta vários feeds. Um canal pode precisar de atributos, formatos ou conjuntos diferentes de outro. Por isso, nem sempre deve aplicar a mesma lógica a Meta, Google Shopping, TikTok, Pinterest ou outros destinos.

5. Avisos: não esperar pela rejeição

Um aviso nem sempre bloqueia um produto, mas indica que algo merece atenção. Em feeds grandes, os avisos repetidos costumam ser mais úteis do que casos isolados. Se vinte produtos têm uma imagem partida, pode ser uma incidência pontual. Se milhares partilham o mesmo aviso, provavelmente existe um padrão.

Classifique os avisos por prioridade:

  • Alta: afetam campos essenciais como preço, disponibilidade, imagem ou URL.
  • Média: afetam qualidade dos dados, categorização ou atributos recomendados.
  • Baixa: melhorias menores que não bloqueiam a operação imediata.

Separar erros críticos de avisos planeáveis permite agir sem transformar cada revisão do feed numa urgência.

Como rever um catálogo com AdMotion

Com o Feed Manager da AdMotion, pode criar uma rotina de revisão mais organizada: ligar a fonte do catálogo, mapear campos, aplicar regras, segmentar produtos em conjuntos e gerar feeds por URL. A documentação do produto descreve esta base como uma forma de manter um catálogo limpo e preparado para diferentes canais.

Um fluxo realista seria:

  1. Ligar a fonte do catálogo. Pode partir de uma loja compatível ou de um ficheiro de produtos. O essencial é que a origem seja clara, repetível e fácil de rever.
  2. Mapear os campos. Relacione os campos de origem com os atributos necessários: título, preço, disponibilidade, imagem, ligação, categoria e outros dados relevantes.
  3. Normalizar com regras. Corrija valores inconsistentes, complete dados quando fizer sentido e defina exclusões razoáveis. As regras também podem ser escritas em linguagem natural e revistas antes de serem aplicadas.
  4. Criar conjuntos de produtos. Separe subconjuntos do catálogo, como produtos em stock, presentes por intervalo de preço, categorias sazonais ou artigos para uma campanha específica.
  5. Gerar o feed por canal. Cada destino pode exigir formato e atributos próprios. Com Export Channels, pode preparar feeds para Meta, Google Shopping, TikTok, Pinterest, Snapchat, Criteo, Microsoft Advertising, Thribee, ChatGPT ou um canal personalizado.
  6. Rever erros e avisos. O analisador verifica o feed contra a especificação do canal. Isto ajuda a detetar problemas antes de registar a URL, mas não equivale a aprovação garantida pela plataforma.
  7. Copiar a URL para o canal. A URL do feed é registada na plataforma correspondente. Tenha em conta que a frequência de geração ou descarga do feed e a frequência de leitura do canal podem ser diferentes.

Se está a começar, foque-se primeiro na estabilidade operacional: entrada do catálogo, mapeamento, regras, quebras e avisos. Depois, quando o feed estiver mais previsível, pode trabalhar a camada visual com o Editor de Plantillas, criando uma imagem por produto com marca, preço, oferta e stock atualizados a partir do catálogo.

Exemplo fictício: revisão antes de uma campanha

Imagine uma loja online de material desportivo que prepara uma campanha de outono. Tem produtos de corrida, montanha e fitness. Quer ativar anúncios de catálogo e enviar feeds para vários canais.

A equipa revê o catálogo e encontra este percurso:

  • Na origem existem 18.400 produtos.
  • Depois de excluir produtos sem imagem, ficam 17.900.
  • Depois de filtrar produtos sem stock, ficam 13.700.
  • O conjunto de corrida contém 4.200 produtos.
  • O feed final para um canal mostra apenas 1.100 produtos.

A diferença entre 4.200 e 1.100 não é explicada pelo stock nem pelas imagens. A equipa revê as regras e encontra uma condição que exige uma categoria exata chamada “corrida”, mas parte do catálogo usa “sapatilhas corrida”, “roupa corrida” e “acessórios corrida”. A regra não estava errada na intenção, mas era demasiado rígida.

A solução não é acrescentar produtos manualmente. É ajustar a lógica do conjunto, rever uma amostra, confirmar a nova contagem e voltar a analisar o feed. Só depois faz sentido atualizar a URL no canal correspondente.

Este exemplo mostra porque as contagens intermédias são tão úteis. Se olhar apenas para o total final, sabe que algo correu mal. Se observar cada etapa, sabe onde procurar.

Verificação final antes de enviar o feed

Antes de copiar ou atualizar a URL do feed num canal, faça uma revisão curta:

  1. O número de produtos na origem está dentro do intervalo normal?
  2. Os campos críticos estão preenchidos numa amostra representativa?
  3. As regras alteradas tiveram o efeito esperado?
  4. Os conjuntos usados nas campanhas continuam com volume coerente?
  5. Os avisos mais repetidos foram classificados por prioridade?
  6. O feed final foi revisto contra os requisitos do canal?
  7. A equipa sabe que a atualização do feed e a leitura pelo canal podem acontecer em momentos diferentes?

Esta verificação não substitui a revisão de Meta, Google ou qualquer outra plataforma. Mas reduz a probabilidade de descobrir problemas apenas quando a campanha já está a perder cobertura.

Qué hacer esta semana

  1. Registe as suas contagens normais. Veja quantos produtos tem na origem, depois da limpeza, por conjunto e no feed final. Para começar, precisa mais de uma referência do que de um processo complexo.
  2. Defina limites de alerta. Decida que quebra justifica revisão. Faça-o por catálogo e por conjunto, não apenas com um número global.
  3. Reveja os campos críticos. Verifique uma amostra com produtos em promoção, variantes, artigos sem stock e categorias diferentes. Confirme título, imagem, URL, preço e disponibilidade.
  4. Organize os avisos por impacto. Priorize os que afetam dados essenciais. Deixe melhorias menores para uma revisão planeada.
  5. Documente regras e alterações. Sempre que mudar uma regra ou conjunto, anote o que esperava que acontecesse e compare com o resultado real.

Se quer centralizar esta rotina, reveja o Feed Manager: pode ligar o catálogo, limpá-lo com regras, segmentá-lo em conjuntos e publicar feeds por URL para cada canal. Também pode testar gratuitamente com o seu próprio catálogo se precisa de perceber onde ocorrem as quebras antes de escalar a revisão.

Detetar erros de catálogo não é perseguir problemas quando já afetaram as campanhas. É criar uma rotina simples, repetível e realista: o que entra, o que é transformado, o que é excluído e o que chega finalmente a cada canal.

Perguntas frequentes

Qual é a diferença entre um erro e um aviso num catálogo?

Um erro indica normalmente que um produto ou feed não cumpre uma condição necessária, como uma imagem inválida ou um campo obrigatório vazio. Um aviso aponta para algo melhorável ou potencialmente problemático, mas nem sempre bloqueia o produto. Deve rever ambos, dando prioridade a preço, disponibilidade, imagem e URL.

Porque pode baixar de repente o número de produtos do feed?

Uma quebra pode resultar de stock real, alterações no ficheiro de origem, campos renomeados, regras demasiado restritivas ou conjuntos mal definidos. O ideal é comparar vários pontos: produtos importados, produtos após limpeza, produtos por conjunto e produtos no feed final. Assim consegue localizar onde ocorre a perda.

Um analisador de feed garante que o canal aprova todos os produtos?

Não. Um analisador ajuda a detetar erros e avisos face à especificação do canal antes de registar ou enviar o feed, mas não substitui a revisão própria de cada plataforma. Além disso, a atualização do feed e a leitura feita pelo canal podem acontecer com frequências diferentes.

Fontes

  1. Feed Manager de AdMotion — AdMotion
  2. Export Channels de AdMotion — AdMotion
Partilhar:
J

Escrito por

Julia Villegas

Performance Marketing

Julia Villegas trabalha em performance marketing na AdMotion.

Artigos relacionados