Facebook Product Feed: campos obrigatórios, formatos e imagens

Um Facebook product feed é um arquivo de dados estruturado que lista todos os produtos que você quer anunciar no Facebook e Instagram, com uma linha ou item por produto. A Meta lê o feed e o importa para um catálogo no Commerce Manager, depois usa títulos, preços, imagens e disponibilidade automaticamente em catalog ads e Shops. Os campos obrigatórios são id, title, description, availability, condition, price, link, image_link e brand. Os formatos aceitos são CSV, TSV, XLSX, Google Sheets e XML. A precisão do feed decide o que os compradores realmente veem em cada catalog ad.

O product feed é o arquivo menos glamouroso de uma conta de Meta ads e decide silenciosamente o que aparece em todo catalog ad. Errar um preço em uma planilha não é apenas um erro de dados, é publicar o preço errado para todas as pessoas que veem o produto. Se o catálogo ainda não estiver pronto, comece pelo passo a passo de configuração.

O material de referência costuma ficar em um dos extremos. A especificação da própria Meta é completa e correta, mas parece um esquema de banco de dados, com os alertas importantes escondidos nas células das tabelas. A maioria das explicações de terceiros para em "é uma planilha dos seus produtos".

Este artigo fica no meio: o que o arquivo é, todos os campos obrigatórios com as restrições que realmente causam problemas, os campos opcionais que mudam suas possibilidades, como várias imagens e vídeos funcionam em um produto, quais formatos e limites de tamanho a Meta aceita e como o arquivo chega ao Commerce Manager.

O que é um Facebook Product Feed?

Um Facebook product feed é um arquivo estruturado no qual cada linha, ou item XML, descreve um produto, e cada coluna é um campo nomeado, como title ou price. É uma especificação, não uma exportação livre: a Meta lê apenas os campos que reconhece, e vários aceitam somente valores específicos.

Três termos são usados como sinônimos na documentação de Facebook product feed, mas significam coisas diferentes:

• Catálogo: o contêiner parecido com um banco de dados que fica no Commerce Manager e armazena os registros de produtos. Anúncios e Shops leem o catálogo.
• Fonte de dados: o método pelo qual produtos entram no catálogo. Um feed é uma fonte de dados. Entrada manual, integração com plataforma parceira e Batch API são outras.
• Product feed: o próprio arquivo, usado como uma fonte de dados para um catálogo.

Um único catálogo pode armazenar produtos de mais de uma fonte, por isso "feed" e "catálogo" não são sinônimos. Você pode ter três feeds apontando para um catálogo, e é o catálogo que suas campanhas segmentam.

Um feed também não é anúncio, público nem pixel. É um conjunto de dados de estoque. O que a Meta faz com esses dados depois é outro conjunto de decisões.

Uma observação de vocabulário, pois materiais antigos estão cheios disso. O que antes se chamava dynamic ads ou dynamic product ads agora é o formato Advantage+ catalog ads. O contêiner antes chamado Business Manager agora é o business portfolio, embora algumas páginas de ajuda da Meta ainda usem o nome antigo. Dentro do feed, status é o nome preferido para o campo antes chamado visibility, e internal_label substituiu o antigo product_tags.

O que um Product Feed realmente alimenta

Quando os produtos chegam a um catálogo, os dados do feed viram matéria-prima para vários formatos:

• Advantage+ catalog ads, que selecionam produtos por usuário, não por anúncio
• Catalog Carousel Ads, cujos cards são preenchidos pelo catálogo em vez de criados manualmente
• Collection Ads, incluindo a grade de quatro produtos abaixo do criativo principal
• Product tag ads e marcação orgânica de produtos elegível
• Collaborative ads, em que um lojista compartilha um segmento do catálogo com uma marca parceira
• Shops no Facebook e Instagram, onde houver suporte

O ponto mecânico importante é que, nesses formatos, você não envia um criativo por produto. A Meta monta o anúncio no momento da entrega usando os campos do feed. A imagem é o que estiver em image_link, a headline muitas vezes é o title, e o preço exibido é o price, ou sale_price se houver um ativo.

Essa é a diferença para um anúncio manual, no qual você escolhe a imagem e escreve a copy. É também o que separa um carrossel manual de um carrossel de catálogo. Nos formatos de catálogo, o feed não é um ativo de suporte. É a fonte criativa.

Campos obrigatórios em um Facebook Product Feed

Para um produto de varejo padrão, nove campos são obrigatórios, com size obrigatório sob determinadas condições para alguns produtos vendidos por Shops. Os nomes dos campos devem ser escritos em inglês americano, e vários aceitam apenas valores específicos, não texto livre.

Duas restrições causam mais falhas do que todas as outras juntas.

A primeira é o formato do preço. $49.99 falha. 49,99 EUR falha. Precisa ser um número, um espaço e o código da moeda, com ponto nos decimais e apenas uma moeda em cada arquivo de dados.

A segunda é o id, e ela explica por que um feed tecnicamente válido ainda pode não ser entregue. Para rodar Advantage+ catalog ads, o id precisa corresponder exatamente ao identificador enviado pelo site como content_id ou content_ids nos eventos do pixel. Não "aproximadamente" nem "depois de remover o prefixo". Uma diferença de capitalização ou um sufixo de variante em apenas um lado basta para quebrar a associação entre o comportamento de navegação e o item do catálogo. A orientação da própria Meta para catálogos sugere buscar uma taxa de correspondência acima de 75%.

Campos opcionais que vale preencher

A lista de opcionais é longa. Estes são os que mudam suas possibilidades, não apenas acrescentam detalhes.

sale_price e sale_price_effective_date. Usam o mesmo formato de price, e o preço promocional precisa ser menor que o integral. Defina-o como igual ou maior que price, e a Meta simplesmente não o exibirá no anúncio nem no Commerce Manager. A data efetiva é um intervalo com início e fim, como 2026-11-24T09:30-08:00/2026-11-30T23:59-08:00. Sem ela, o preço promocional continua ativo até você removê-lo.

item_group_id. O mecanismo de variantes, explicado em detalhes na próxima seção.

google_product_category e fb_product_category. As categorias são opcionais, mas ajudam a Meta a associar seu produto a itens semelhantes, o que importa quando o sistema escolhe o que mostrar a uma pessoa navegando. Use a categoria mais específica disponível, não um grupo geral.

gtin e mpn. Forneça valores reais ou nenhum. Um GTIN deve ficar sem hífens nem espaços. Um identificador inventado é pior do que um ausente.

color, gender, age_group, material, pattern. Atributos de variantes. gender aceita female, male ou unisex. age_group aceita adult, all ages, teen, kids, toddler, infant ou newborn. Os campos de texto livre aceitam até 200 caracteres, exceto pattern, com 100.

shipping. Formatado como Country:Region:Service:Price, por exemplo US:NY:Ground:9.99 USD, com vários destinos separados por vírgulas. É o campo por trás do overlay de frete grátis em catalog ads, e a condição do overlay é um preço zero no nível do país. Preço zero limitado a uma região não se qualifica.

status. Os valores são active e archived, com active como padrão. Produtos arquivados permanecem no catálogo, mas deixam de aparecer em anúncios e Shops, uma medida mais limpa que a exclusão quando algo sai de venda temporariamente.

internal_label versus custom_label_0 a custom_label_4. Ambos podem orientar filtros de product sets. A documentação atual da Meta recomenda rótulos internos para esse trabalho e apresenta um motivo operacional específico: "ao contrário dos rótulos personalizados, você pode adicionar ou atualizar rótulos internos sem enviar os produtos para análise de política toda vez, o que pode afetar a entrega de anúncios". Rótulos internos aceitam até 5,000 por produto, com 110 caracteres cada, e a Meta os normaliza em minúsculas. Rótulos personalizados são cinco campos separados com 100 caracteres cada.

rich_text_description. Descrição formatada para páginas de Shops, com description ainda obrigatória como alternativa em texto simples. Não é compatível com anúncios, então não muda nada na copy de catalog ads.

Várias imagens e vídeos no Facebook Product Feed

É aqui que a maioria dos feeds é criada de forma errada, pois três mecanismos diferentes parecem "mais imagens" e não são intercambiáveis.

Imagens adicionais em um produto

additional_image_link armazena até 20 URLs de imagens adicionais em um registro de produto. Contando o image_link principal, são até 21 imagens associadas a um único produto.

As URLs podem ser separadas por vírgula, ponto e vírgula, espaço ou barra vertical. Cada imagem segue as mesmas regras da principal: JPEG ou PNG, pelo menos 500 x 500 pixels e menos de 8 MB. Em um CSV, coloque o campo inteiro entre aspas corretamente se o separador também aparecer dentro dos dados.

Use isso para mais visualizações do mesmo item vendável. Uma caneca de cerâmica fotografada de frente, por cima e em uso sobre uma mesa é um produto com três imagens, não três produtos.

Onde essas imagens adicionais aparecem? As especificações de imagem da Meta recomendam várias imagens para Shops e Carousel Ads que usam a opção slideshow, sugerindo quatro ou mais boas imagens nesses casos. Do lado dos anúncios, templates de catalog ads oferecem show_multiple_images, que exibe várias imagens de um produto em um carrossel, e carousel_slideshows, que cria um slideshow em um card quando o produto tem várias imagens. O que a Meta não diz é que todo catalog ad gira automaticamente por todas as imagens adicionais. O uso depende do formato, template e automação criativa ativos. Preencher o campo disponibiliza essas opções, não garante que sejam usadas.

Variantes versus imagens extras

item_group_id faz algo completamente diferente. Ele conecta linhas de produtos separadas que são variantes entre si.

Cada variante é um registro próprio: id, price, availability, link e image_link principal próprios. O que elas compartilham é o ID do grupo. Uma mochila de lona em três cores são três linhas com um item_group_id em comum, não uma linha com três imagens.

Duas regras costumam passar despercebidas. Primeiro, o ID do grupo não pode coincidir com nenhum id de produto no catálogo e é sensível a maiúsculas e minúsculas. Segundo, apenas uma imagem diferente não cria uma variante válida: a Meta espera pelo menos um atributo realmente distinto, como color ou size. A Meta aceita até 800 variantes em um grupo, mas avisa que grupos acima de 300 são difíceis de gerenciar e exibir.

A divisão fica simples quando dita em voz alta. additional_image_link significa mais fotos de um produto. item_group_id significa vários produtos relacionados. Escolher o campo errado é o motivo comum para uma variante de cor mostrar a foto incorreta.

Vídeo de produto no Feed

O vídeo é associado ao produto por video[0].url a video[19].url, portanto são até 20 vídeos por produto.

video[0].url é o padrão, e a Meta recomenda 4:5 para ele. As posições adicionais contêm outras proporções, geralmente 1:1 e 9:16, para que o mesmo produto tenha mídia apropriada para feed e posicionamentos verticais.

As regras técnicas:

• A URL deve levar a um arquivo de vídeo que possa ser baixado. Um link do YouTube ou qualquer outra página com player não funciona, pois a URL entrega uma página web, não o arquivo.
• Máximo de 200 MB por vídeo, sem limite de duração informado.
• As extensões aceitas incluem uma longa lista, como .mp4, .mov, .avi, .mkv, .flv e .gif.

O teste prático leva cinco segundos: cole a URL em um navegador. Se o arquivo bruto for baixado ou reproduzido, funciona. Se abrir uma página com player, a Meta não consegue usá-lo.

Vale entender a entrega: a automação de vídeos de produtos fica ativa por padrão quando elegível, e a Meta pode substituir a imagem do produto por um vídeo de catálogo quando prevê redução no custo por resultado. Carousel e Collection são os formatos recomendados. Dentro de um Collection ad, o vídeo pode ocupar o slot principal, enquanto as miniaturas de produtos abaixo continuam sendo imagens.

Por que uma imagem substituída não é atualizada

A Meta armazena as mídias de produtos em cache por URL. A especificação é direta sobre a consequência: "a nova imagem precisa ter uma URL diferente para reconhecermos a mudança e atualizá-la no catálogo".

Sobrescreva o arquivo no mesmo endereço, e a Meta não terá sinal de que algo mudou. A imagem antiga continuará rodando.

É também por isso que imagens provisórias são uma armadilha. Publique image-coming-soon.jpg em uma URL estável e, quando a foto real chegar depois no mesmo endereço, ela nunca será buscada. A Meta recomenda esperar e adicionar a imagem final em vez de publicar uma provisória.

A solução é versionar a URL. desk-lamp-01-v2.jpg ou um caminho que muda quando o ativo mudar. Depois, coloque a nova URL no próximo upload.

Formatos e limites de tamanho de Facebook Product Feed

Os formatos aceitos pela Meta são CSV, TSV, Excel XLSX, Google Sheets e XML em formato RSS ou Atom. ZIP e GZIP são formas de compactação desses arquivos, não formatos independentes.

Um esclarecimento, pois isso circula muito: um arquivo JSON independente não está na lista aceita da Meta. JSON aparece no ecossistema como valor codificado dentro de um campo CSV, por exemplo para objetos de vídeo, e em payloads de solicitações da Marketing API. Nenhum desses casos transforma um arquivo .json em um upload válido de feed de dados.

Os limites:

• 100 MB para upload único e 4 GB para feed programado
• Compacte em ZIP ou GZIP acima de 1 GB
• Até aproximadamente 1 milhão de produtos por feed, dividindo acima disso em vez de cortar
• Máximo de 5,242,880 caracteres em qualquer linha individual

Duas observações específicas de formato. Feeds do Google Sheets devem ter os dados na primeira aba, com compartilhamento definido para que qualquer pessoa com o link possa visualizar. Se você gera CSV em código em vez de um app de planilhas, aplique as aspas padrão do CSV: coloque entre aspas duplas todos os valores com vírgula ou espaço significativo e escape aspas duplas internas duplicando-as.

Como o Feed chega ao Commerce Manager

Um Facebook product feed chega ao Commerce Manager de duas formas, e a diferença é mais importante do que parece.

Um upload único usa um arquivo do computador ou uma URL fornecida uma vez. É um retrato daquele momento. A Meta não voltará a buscá-lo.

Uma busca programada aponta a Meta para um arquivo hospedado e permite que ela o colete em uma frequência definida. As regras da URL são específicas: deve começar com http://, https://, ftp:// ou sftp:// e levar ao próprio arquivo, não a uma landing page, formulário de login ou tela de preview. Teste no navegador primeiro. Se ele abrir ou baixar o arquivo, a Meta conseguirá buscá-lo.

O Commerce Manager oferece programações horárias, diárias e semanais, e a frequência horária é o máximo: um feed programado não pode ser buscado mais vezes. A Marketing API também oferece a opção mensal. Se definir uma programação, faça-a acontecer depois que seu arquivo for regenerado. Um arquivo reconstruído às 09:00 combina com uma busca às 09:15, não às 09:00.

Também existe uma diferença entre uma programação de substituição, que trata o arquivo como a imagem completa e pode excluir produtos ausentes, e uma programação de atualização, que adiciona e atualiza, mas nunca exclui. A Meta documenta uma programação de atualizações frequentes junto com uma substituição completa menos frequente, desde que as duas tenham pelo menos dez minutos de intervalo. Esse padrão atende a catálogos em que preço e estoque mudam rápido, mas a lista completa de produtos muda devagar.

No primeiro upload, se os nomes das colunas não corresponderem ao esquema da Meta, o Commerce Manager pode oferecer mapeamento, por exemplo associando uma coluna name ao campo compatível title. Aprove as correspondências, e a Meta as salvará como regras de dados para uploads futuros do mesmo feed. É útil, mas não é motivo para manter cabeçalhos fora do padrão. Nomes oficiais tornam o arquivo mais fácil de depurar fora do Commerce Manager.

Cada upload concluído retorna um resumo: quantos produtos foram adicionados ou atualizados, quais erros bloquearam produtos ou o arquivo inteiro e quais problemas impedirão os produtos de aparecer. Esse resumo é o primeiro lugar a consultar quando algo estiver ausente.

Feeds principais, complementares e de país

Nem todo Facebook product feed faz o mesmo trabalho.

Um feed principal cria e controla os registros de produtos. Ele leva o conjunto completo de campos obrigatórios e é o que a maioria das pessoas chama de "o feed".

Um feed complementar enriquece os produtos já criados por um feed principal. Ele faz a correspondência por IDs existentes exatos, é vinculado pelo feed principal em vez de existir sozinho e pode preencher campos como títulos, descrições, imagens, categorias, marca, agrupamento de variantes e vídeo. O que explicitamente não pode substituir é o ID do produto, price, sale_price, availability ou quantity_to_sell_on_facebook. Essa fronteira é o ponto importante: feed complementar não é o caminho para atualizações de preço ou estoque. Quando um campo compatível aparece nos dois, o valor complementar prevalece no catálogo sem alterar o arquivo principal. Um feed complementar pode atender vários feeds principais, mas cada feed principal se conecta a apenas um complementar.

Feeds de país e idioma substituem valores localizados em produtos que já existem. Um feed de país trata de preço, preço promocional, disponibilidade, status e link de destino específicos do mercado. Um feed de idioma trata de textos traduzidos, como títulos e descrições. Existe um modo combinado, e quando várias substituições poderiam corresponder, a prioridade é idioma e país primeiro, depois idioma, país e o valor do feed principal.

Essa também é a resposta real para várias moedas. Um arquivo de dados principal comum contém uma moeda. Um catálogo atende várias por feeds de país. Para catálogos acima de 100,000 produtos, a Meta recomenda um feed por país ou idioma, não um grande arquivo de substituições.

Vale conhecer outros dois comportamentos antes que surpreendam você. Atualmente, a exclusão em um feed vem ativada por padrão, o que significa que uma substituição completa pode remover produtos controlados pelo feed que estejam ausentes no novo arquivo. Depois que a exclusão é ativada, a Meta não permite desativá-la nesse feed. É um motivo forte para marcar produtos como out of stock em vez de remover linhas, pois o catálogo preserva o item e seu histórico. Quando um feed ultrapassa os limites de tamanho ou itens, a divisão tem suporte correto: crie o novo feed referenciando o ID do antigo como origem, envie o subconjunto e a propriedade dos itens será transferida na primeira sessão concluída, em vez de ser registrada como exclusão em massa.

Mantendo um Facebook Product Feed correto

A Meta não determina uma única frequência de atualização, e nem deveria, pois os catálogos mudam em velocidades diferentes. A regra funcional é buscar pelo menos com a mesma frequência das mudanças reais nos campos importantes.

• Horária para estoques com alta rotatividade, promoções relâmpago ou preços voláteis
• Diária para estoque comum de ecommerce
• Semanal apenas quando produtos, preços e disponibilidade realmente mudam devagar

Além da frequência, uma lista curta cobre a maioria dos erros:

• Use out of stock para indisponibilidade temporária em vez de excluir linhas. Availability é o campo que mantém produtos indisponíveis fora dos anúncios.
• Mantenha IDs estáveis e idênticos no feed, no pixel, nos eventos do servidor e em todos os feeds localizados de substituição. Um ID que muda deixa o histórico do produto órfão.
• Versione URLs de imagens sempre que o conteúdo mudar.
• Escreva títulos que pareçam nomes de produtos, não copy promocional. Em um catalog ad, o título muitas vezes é o único texto que a pessoa vê ligado ao produto.
• Preencha categorias mesmo sendo opcionais, pois ajudam a Meta a associar seus produtos ao que o usuário já estava procurando.
• Leia o resumo do upload após cada busca, não apenas a primeira.
• Evite edições desnecessárias de campos. Mudanças substanciais podem enviar produtos novamente para análise de políticas, justamente o tipo de instabilidade que rótulos internos evitam.

A orientação da própria Meta sobre catálogos de alta qualidade reforça o mesmo ponto geral: dados de produtos completos e corretos ajudam seus sistemas a recomendar os itens certos. Ela não publica um número ligado a isso, e não existe uma estatística confiável em todo o mercado sobre a parcela do investimento em ecommerce que roda por catalog ads, então desconfie de qualquer porcentagem específica divulgada.

O contexto mais amplo é que o sistema de entrega da Meta depende cada ano mais da qualidade dos dados e menos da configuração manual. Nos formatos de catálogo, a integridade do feed é essa base de dados.

Perguntas frequentes

O que é um Facebook product feed? Um arquivo estruturado em formato CSV, TSV, XLSX, Google Sheets ou XML, com um registro por produto. A Meta o importa para um catálogo no Commerce Manager, e catalog ads e Shops leem esse catálogo. O feed é a entrada, o catálogo é o contêiner, e um catálogo pode ser alimentado por várias fontes.

Quais campos são obrigatórios em um Facebook product feed? Para um feed padrão de varejo: id, title, description, availability, condition, price, link, image_link e brand. O campo size também é obrigatório para produtos relevantes vendidos por Shops, especialmente roupas e calçados.

Um Facebook product feed pode ter várias imagens por produto? Sim. Um image_link principal com até 20 URLs em additional_image_link, somando até 21 imagens por registro de produto. Separe as URLs com vírgula, ponto e vírgula, espaço ou barra vertical e aplique a todas as imagens as mesmas especificações da principal.

Qual é a diferença entre additional_image_link e item_group_id? additional_image_link adiciona mais fotos a um registro de produto. item_group_id conecta vários registros separados que são variantes entre si, cada um com id, preço, disponibilidade e imagem principal próprios, além de pelo menos um atributo que realmente os diferencia.

Quais formatos de arquivo o Facebook aceita em um product feed? CSV, TSV, Excel XLSX, Google Sheets e XML em formato RSS ou Atom, com compactação opcional em ZIP ou GZIP. Um arquivo JSON independente não é um formato de feed aceito.

Por que a imagem do meu produto não foi atualizada depois da substituição? A Meta armazena mídias de produtos em cache por URL, então sobrescrever o arquivo no mesmo endereço não fornece à Meta um sinal para uma nova busca. Altere ou versione a URL da imagem e inclua a nova URL no próximo upload.

Com que frequência um Facebook product feed deve ser atualizado? Pelo menos com a mesma frequência das mudanças em preço, disponibilidade e dados do produto. O Commerce Manager aceita programações horárias, diárias e semanais, e a frequência máxima de busca é horária.

Qual pode ser o tamanho de um Facebook product feed? 100 MB para upload único, 4 GB para feed programado, com compactação recomendada acima de 1 GB, aproximadamente um milhão de produtos por feed e limite de 5,242,880 caracteres em uma linha.

Qual é a diferença entre product feed e catálogo? O feed é um arquivo de entrada que descreve produtos. O catálogo é o contêiner persistente que os armazena após a importação e é o que anúncios e Shops realmente leem.

Um product feed pode ter mais de uma moeda? Um arquivo de dados principal comum deve conter uma moeda. Vários mercados são tratados por feeds de país, que substituem preço, preço promocional, disponibilidade, status e link por país. Assim, o catálogo atende várias moedas mesmo que o arquivo principal use uma.

Fontes e leituras adicionais

Todas as especificações acima vêm da documentação atual da Meta:

• Especificações de dados de produtos para catálogos no Commerce Manager, a referência oficial de campos
• Especificações de imagens de produtos para catálogos, incluindo a regra de nova busca de imagens
• Referência da API de product feed no Meta for Developers, para tipos de feed, programação e comportamento de exclusão
• Dicas para criar um catálogo de alta qualidade

Conclusão

Um Facebook product feed é um arquivo com campos nomeados, e quase tudo que dá errado em catalog ads vem de um desses campos estar errado, ausente ou desatualizado.

O que vale lembrar:

• Nove campos fazem o trabalho: id, title, description, availability, condition, price, link, image_link e brand, com size adicional para categorias relevantes de Shops.
• price é um número, um espaço e um código ISO 4217, com uma moeda por arquivo. Feeds de país cuidam do restante.
• id precisa corresponder exatamente ao content id enviado pelo pixel, ou Advantage+ catalog ads não conseguem ligar o comportamento de navegação ao produto.
• Várias imagens ficam em additional_image_link, até 20 extras por produto. Variantes ficam em linhas separadas que compartilham um item_group_id. Vídeos ficam de video[0].url a video[19].url. Três mecanismos, três trabalhos.
• Uma imagem substituída precisa de nova URL ou nunca será buscada novamente.
• Os formatos aceitos são CSV, TSV, XLSX, Google Sheets e XML, com 100 MB para upload único e 4 GB para o programado.

O próximo passo útil é abrir seu arquivo ao lado da tabela de campos obrigatórios acima e revisar campo por campo. A maioria dos feeds com baixa performance não está quebrada de uma forma interessante. Falta categoria, a URL da imagem não está versionada ou o id deixou de corresponder ao site seis meses atrás.