Formato de ID de produto: faça seu feed corresponder ao Facebook Pixel (content_id)
Anúncios dinâmicos e retargeting só funcionam quando o Facebook consegue conectar duas coisas: o id de cada item no seu catálogo e os `content_ids` que seu Meta pixel dispara quando um comprador visualiza um produto, adiciona ao carrinho ou compra. Se esses dois identificadores não corresponderem exatamente, a Meta não tem nada para relacionar — então seus anúncios de catálogo Advantage+ não mostram produtos, os públicos de retargeting ficam vazios e toda a configuração falha silenciosamente, sem nenhum erro em lugar nenhum. Esse é o motivo mais comum de um feed tecnicamente "válido" ainda não vender nada. Este app grava o id no campo `
1 Entenda a regra de correspondência
A regra é curta: o `id` no seu feed deve ser igual ao valor de `content_ids` que seu pixel envia para o mesmo produto. A Meta relaciona eventos a itens do catálogo por correspondência exata de string — o id diferencia maiúsculas de minúsculas (`abc123` e `ABC123` são dois itens diferentes) e é limitado a 100 caracteres. Se o seu pixel dispara `content_ids: ["shopify_284197941_670889949"]` mas o id do item do seu feed é apenas `670889949`, a Meta vê dois itens não relacionados e o anúncio não tem nada para mostrar. Existe um segundo identificador que importa: `
2 Abra a configuração de formato de ID de produto
O formato de ID de produto fica no Advanced editor. No seu painel, abra o menu Actions do feed e escolha Edit (advanced) (o Basic editor não expõe essa configuração). Se você estiver atualmente no Basic editor, use Switch to advanced — ambos os editores editam o mesmo feed, então nada se perde.
![Abra a configuração de formato de ID de produto — s-button[commandFor="feed-menu-1"] destacado](/docs-assets/img/product-ids-and-facebook-pixel-matching/00-dashboard-open.png?f8db7e61)
3 Encontre a seção "Other settings"
Role até a seção Other settings na parte inferior do Advanced editor. O último controle é Product ID format — uma lista de cinco opções de rádio. O que você escolher aqui se torna o id em cada item que o feed exporta, então mude com cuidado: alternar formatos renomeia todos os itens do seu catálogo, e a Meta trata itens renomeados como itens totalmente novos (qualquer desempenho de anúncios e avaliações associados aos ids antigos são zerados).
4 Mantenha o padrão: Product ID (recomendado)
O padrão é "Product ID default & recommended". Ele grava o ID numérico do Shopify de cada variante no `id` do item (por exemplo `6789012`) e o ID numérico do produto no `item_group_id`. Esta é a escolha certa para a maioria das lojas — especialmente se este app for a única coisa que constrói seu catálogo e você configurou seu pixel para enviar os mesmos IDs de variante, ou se você não estiver rodando anúncios dinâmicos que dependam de um esquema de id legado específico. Se os anúncios dinâmicos funcionam, não mude. A segunda opção, "Product ID (if you export only one variant of a product) or Variant ID (if you export all / multiple variants)", é o padrão antigo do app, mantido para feeds criados antes de o padrão mudar. Ele emite o ID do produto quando você exporta uma única variante por produto, e o ID da variante quando você exporta todas / múltiplas variantes. Escolha isso apenas se você construiu seu catálogo com o comportamento antigo e precisa manter esses ids exatos estáveis.
5 Combine com o canal do Facebook do Shopify: o formato Global
Se você também usa o Facebook & Instagram sales channel integrado do Shopify, o pixel dele envia content_ids em um formato `shopify_…` em vez de um id numérico puro. Para se alinhar com isso, escolha a opção Global format: - "Global format (shopify, country code, product ID, variant ID - example: shopify_US_12345_6789012)" — emite `shopify_
6 Use seu SKU como ID (com uma grande ressalva)
A última opção é "SKU as ID (note - all of your products MUST have an SKU, otherwise they won't be imported)". Ela usa o SKU de cada variante como o id do item. Isso é útil quando seu catálogo, seu ERP e seus outros canais de venda usam todos SKUs como chave e você quer um identificador único em todos os lugares — mas atenção ao aviso: qualquer variante sem SKU recebe um id vazio e é totalmente removida do feed. Escolha SKU as ID apenas se você tiver certeza de que cada variante tem um SKU único e não vazio.
7 Salve e depois verifique se os dois identificadores se alinham
Depois de escolher um formato, clique em Save. O feed é regenerado com os novos ids. Para confirmar a correspondência, abra uma página de produto da sua loja com a extensão de navegador Meta Pixel Helper e compare os `content_ids` que ela reporta com o `id` (ou `item_group_id`) do mesmo produto no Facebook Commerce Manager. Se forem strings idênticas, seus anúncios dinâmicos e retargeting vão disparar contra itens reais do catálogo. Se forem diferentes, volte e mude o Product ID format para aquele que produz o id que seu pixel já está enviando.
Perguntas frequentes
Por que meus anúncios dinâmicos do Facebook não mostram nenhum produto, mesmo com o feed válido?
Quase sempre porque o `id` no seu catálogo não corresponde aos `content_ids` que seu pixel envia. Um feed pode passar em todas as verificações de validação e ainda falhar aqui — a Meta relaciona eventos do pixel a itens do catálogo por correspondência exata de id, então se os dois identificadores diferem, não há nada para mostrar. Corrija definindo o Product ID format para que o id do feed seja igual ao que seu pixel dispara.
O que "content_id do Facebook pixel não corresponde ao catálogo" realmente significa?
Seu pixel dispara um valor de `content_ids` (como `shopify_284197941_670889949`) em visualizações de produto e compras. Seu item do catálogo tem um `id`. A Meta relaciona os dois por string exata. "Não corresponde" significa que o content_id do pixel e o id do catálogo são strings diferentes, então públicos de retargeting e anúncios de catálogo Advantage+ não conseguem vincular a atividade de um comprador a um produto específico.
Qual ID o app coloca no meu feed do Facebook?
O que o Product ID format definir. O padrão grava o ID numérico do Shopify de cada variante em `<g:id>`; outras opções gravam `shopify_US_…`, `shopify_EN_…` ou seu SKU. O ID numérico do produto sempre vai para `<g:item_group_id>`, que agrupa as variantes do mesmo produto.
Qual formato de Product ID devo escolher?
Mantenha o padrão <strong>Product ID</strong> se os anúncios dinâmicos já funcionam ou se este app constrói seu único catálogo. Escolha um <strong>Global format</strong> (`shopify_US_…` ou `shopify_EN_…`) se você também usa o canal Facebook & Instagram do Shopify e o pixel dele envia content_ids `shopify_…`. Escolha <strong>SKU as ID</strong> apenas se cada variante tiver um SKU e você usar SKUs como chave em tudo.
Qual formato o canal do Facebook do Shopify usa para IDs de produto?
O canal Facebook & Instagram do Shopify historicamente usou `shopify_<productID>_<variantID>` (por exemplo `shopify_284197941_670889949`) como content_id do pixel. Para lojas que vendem em Markets, as opções de Global format do app estendem isso para incluir um código de país ou idioma (`shopify_US_12345_6789012`). Confirme o formato exato da sua loja com o Meta Pixel Helper antes de escolher.
Mudar o Product ID format vai quebrar meu catálogo existente?
Isso renomeia todos os itens. A Meta trata um id renomeado como um item totalmente novo, então o desempenho histórico dos anúncios, avaliações e quaisquer edições manuais vinculadas aos ids antigos são zerados, e os anúncios existentes podem parar de veicular até o catálogo ser ressincronizado. Só mude o formato quando seus ids realmente não correspondem ao pixel — então mude uma vez e deixe tudo ressincronizar.
Por que todas as minhas variantes de produto correspondem ao mesmo ID no pixel?
Algumas configurações de pixel enviam o ID do produto pai para cada variante em vez do ID específico da variante. Se seu pixel faz isso, um feed indexado por IDs de variante não vai corresponder. Ou alinhe o feed para enviar o id no nível do produto, ou corrija o pixel para enviar o id da variante — os dois devem usar o mesmo esquema.
Preciso de um SKU em cada produto para usar SKU as ID?
Sim. A opção SKU as ID avisa explicitamente que <em>todos</em> os produtos devem ter um SKU; qualquer variante sem um recebe um id vazio e é removida do feed. Se seu catálogo tem lacunas de SKU, use um dos formatos de ID numérico em vez disso.
Onde verifico se o id e os content_ids correspondem?
Use a extensão de navegador Meta Pixel Helper em uma página de produto ativa para ler os `content_ids` que o pixel dispara, depois abra o mesmo produto no Facebook Commerce Manager e compare com o `id` (ou `item_group_id`) do item. Strings correspondentes significam que sua configuração está correta.
