Como adicionar o Pixel do Facebook (Pixel da Meta) à Shopify

O que o Pixel da Meta faz em uma loja Shopify

O Pixel da Meta, antigo Pixel do Facebook, é o código JavaScript da Meta que rastreia o que os visitantes fazem na sua loja: ver páginas e produtos, adicionar ao carrinho, iniciar o checkout e comprar. A Meta usa esses eventos para medir os seus anúncios e criar públicos para a segmentação. Cada pixel tem um ID do pixel, que o Gerenciador de Eventos também pode mostrar como ID do conjunto de dados.

O pixel roda no navegador do comprador. A Shopify observa que os bloqueadores de anúncios podem bloquear totalmente um web pixel, enquanto os relatórios e os registros de pedidos da própria Shopify não são afetados. A Conversions API da Meta, por sua vez, envia os eventos de um servidor, e a Meta recomenda usá-la além do pixel, com o mesmo ID do pixel nos eventos do navegador e do servidor.

Onde os pixels rodam hoje na Shopify

A Shopify gerencia os pixels em Configurações > Eventos de clientes. Os pixels de apps são adicionados por apps e canais de vendas. Os pixels personalizados são códigos que você mesmo cola, e a Shopify os executa em um sandbox em que nem todos os recursos de pixel funcionam. Um Pixel da Meta que ficava nas preferências da loja virtual, e não no canal Facebook e Instagram, foi removido de lá em fevereiro de 2025 e convertido em um pixel personalizado em Eventos de clientes.

As páginas do checkout também mudaram. A Shopify substituiu as antigas páginas de agradecimento e de status do pedido: as lojas Shopify Plus perderam o checkout.liquid e os scripts adicionais nessas páginas em 28 de agosto de 2025, e os outros planos tiveram prazo até 26 de agosto de 2026, quando a Shopify fez o upgrade automático das lojas restantes. Os scripts adicionais não são compatíveis com as novas páginas, e a caixa de scripts adicionais em Configurações > Checkout está somente para visualização desde 28 de agosto de 2025.

Um código de pixel colado no seu tema continua carregando nas páginas da vitrine. A Shopify pede que você remova o código de pixel do theme.liquid antes de adicionar um ID do pixel no canal Facebook e Instagram, e que remova ou altere os pixels existentes antes de adicionar um pixel personalizado, para que os eventos de clientes não sejam contados duas vezes.

• Pixels da Shopify explicados: pixel da web, pixel personalizado e incorporação de app

Três formas de adicionar o Pixel da Meta à Shopify

Cada caminho pode enviar eventos para o mesmo ID do pixel, então escolha um deles como a ferramenta de envio desse pixel. Eles diferem em quem mantém o código e em se os eventos também saem de um servidor.

A próxima seção mostra o passo a passo do canal. Um pixel personalizado é um código que você cola e mantém por conta própria, e as páginas de ajuda da Shopify explicam como adicionar um. O restante deste guia trata do terceiro caminho, com o WeProfit, e depois de como manter uma só ferramenta de envio por pixel e de como testar.

Adicione o Pixel da Meta com o canal Facebook e Instagram

O canal de vendas Facebook e Instagram da Shopify conecta a sua loja ao seu portfólio empresarial da Meta, e as configurações de compartilhamento de dados dele decidem se ele envia eventos para o seu pixel. A Shopify diz que o membro da equipe que faz a conexão precisa ter controle total sobre o portfólio empresarial e a Página do Facebook vinculados à loja.

1. Se você colou o código do Pixel da Meta no theme.liquid, remova-o primeiro: a Shopify pede que você o remova antes de poder adicionar um ID do pixel no canal, porque duas cópias do pixel podem gerar dados duplicados ou incorretos.
2. No admin da Shopify, abra Configurações > Canais de vendas e adicione o Facebook e Instagram pela Shopify App Store. Clique em Conectar conta, faça login no Facebook, conecte os seus ativos empresariais da Meta, aceite os termos e clique em Concluir configuração.
3. Acesse Canais de vendas > Facebook e Instagram, clique em Configurações e abra as Configurações de compartilhamento de dados.
4. Ative o compartilhamento de dados e escolha um nível. O Padrão usa só o Pixel da Meta. O Avançado e o Máximo acrescentam a Conversions API, que, segundo a Shopify, envia o evento de compra entre os servidores da Shopify e da Meta, e compartilham dados do cliente, como nome, e-mail e telefone.
5. Selecione o seu pixel na lista e clique em Confirmar.

Conecte a Meta no WeProfit: ID do pixel e token de acesso

O WeProfit envia os eventos da loja à Meta pelo próprio servidor, pela Conversions API, e, na Shopify, a incorporação de app dele também carrega nas páginas da vitrine o Pixel da Meta que você conectar. Você precisa de dois valores do Gerenciador de Eventos da Meta: o ID do pixel e um token de acesso da Conversions API.

Com o pixel conectado e a incorporação de app ativada, a Meta recebe PageView, ViewContent e AddToCart pelo navegador e pelo servidor do WeProfit com os mesmos IDs de evento, e InitiateCheckout, AddPaymentInfo e Purchase só pelo servidor. O Purchase é montado a partir do webhook de pedidos da Shopify, uma vez por pedido e pixel, com o total e a moeda do pedido, o e-mail, o telefone, o nome e o sobrenome, a cidade, o estado, o CEP, o país e o ID externo do comprador com hash, além do endereço IP, do user agent e dos IDs de navegador fbp e fbc, quando conhecidos. Os reembolsos não são enviados à Meta.

No WooCommerce (beta), o WeProfit não carrega nenhum pixel da Meta no navegador e envia os eventos da Meta só pelo servidor.

1. No Gerenciador de Eventos da Meta, selecione Fontes de dados e abra o pixel do seu site, que a Meta pode chamar de conjunto de dados. Na aba Configurações, copie o ID do conjunto de dados: esse é o seu ID do pixel.
2. Na mesma aba, role até a seção da Conversions API e, em Configurar manualmente, selecione Gerar token de acesso. Copie o token na hora, porque a Meta o mostra uma única vez. A Meta só mostra esse link para pessoas com acesso de desenvolvedor à empresa dona do pixel.
3. No WeProfit, abra Redes de anúncios > Meta e selecione Adicionar pixel. Informe o ID do pixel e o token de acesso da CAPI e adicione um rótulo se você conectar mais de um pixel.
4. Deixe as condições em branco para enviar todos os eventos a esse pixel ou adicione condições, como país, evento, valor do pedido ou campanha, para limitar o que ele recebe. Depois, selecione Conectar pixel.
5. Abra Instalação e confira se Incorporação de app (rastreamento na vitrine) mostra Ativa. Se não mostrar, selecione Abrir editor de temas, confira se o WeProfit está ativado em Incorporações de app e clique em Salvar.
6. Selecione Enviar teste no card do pixel. O WeProfit não testa o token quando você salva, então essa é a primeira verificação: ele envia um PageView pela Conversions API e mostra a resposta da Meta. Sem um código de evento de teste, esse PageView é um evento real no pixel.

• A API de Conversões da Meta no WeProfit
• Conexão com a Shopify e configuração da incorporação de app

Evite compras duplicadas: uma ferramenta de envio por ID do pixel

A forma que a Meta recomenda para contar uma única vez um evento do navegador e um evento do servidor é usar o mesmo nome de evento e o mesmo ID do evento nos dois, recebidos em até 48 horas depois do primeiro. Ferramentas que enviam para o mesmo pixel com os próprios IDs dão à Meta eventos separados, então um pedido pode aparecer como duas compras.

O WeProfit pareia os próprios eventos: os eventos da vitrine dele no navegador têm os mesmos IDs das cópias do servidor, e o Purchase de cada pedido vai para um pixel uma vez, pelo servidor, com um ID montado a partir do pedido, como pur_a1b2c3d4-6012345678901. O canal Facebook e Instagram, um pixel personalizado ou um código no tema usam os próprios IDs, que não coincidem com os do WeProfit.

Depois de alguns dias de pedidos, compare as compras da Meta com os seus pedidos da Shopify nos mesmos dias e leia a aba de desduplicação de eventos nos detalhes do evento Purchase no Gerenciador de Eventos.

• Se você usa o WeProfit para um ID do pixel: impeça que o canal Facebook e Instagram, os pixels personalizados e o código do tema enviem para esse mesmo pixel, para que ele tenha uma só ferramenta de envio no navegador e uma só ferramenta de envio de compras.
• Se você mantém o canal Facebook e Instagram como ferramenta de envio: não conecte o mesmo ID do pixel no WeProfit. O WeProfit não tem uma opção de envio só pelo servidor por pixel; a chave Rastreamento no navegador, que vale para a loja toda, remove o Pixel da Meta dele, mas também interrompe todo o rastreamento na vitrine.
• Usar dois pixels diferentes de propósito não é problema, desde que cada ID do pixel tenha uma só ferramenta de envio no navegador e uma só ferramenta de envio de compras.

• IDs de evento do Pixel da Meta e da Conversions API

Teste com os Eventos de teste da Meta e o log de envios da CAPI

Extensões de navegador como o Meta Pixel Helper só veem os eventos disparados no navegador, então elas nunca mostram um evento do servidor, como o Purchase do WeProfit. Use os Eventos de teste da Meta e o Log de envios da CAPI do WeProfit para os eventos do servidor, e o Shopify Pixel Helper para os pixels em Configurações > Eventos de clientes.

1. No Gerenciador de Eventos, abra a aba Eventos de teste do seu pixel e copie o código de teste que a Meta mostra para os eventos do servidor.
2. No WeProfit, edite o pixel, cole o código em Código de evento de teste e salve; depois, selecione Enviar teste. O PageView deve aparecer nos Eventos de teste, e o WeProfit mostra Evento de teste aceito pela Meta com o número de eventos recebidos.
3. Navegue pela sua loja como um comprador: abra um produto e adicione-o ao carrinho. Enquanto o código estiver definido, o WeProfit envia com ele todos os eventos reais desse pixel, então esses eventos também aparecem nos Eventos de teste.
4. Faça um pedido de teste. O WeProfit conta um pedido de teste da Shopify e o envia às suas redes de anúncios conectadas como um pedido real, e cancelá-lo depois não retira o Purchase.
5. Encontre o Purchase no Log de envios da CAPI do WeProfit. O log mostra o ID do evento do WeProfit, como pur_6012345678901, e a Meta o mostra com um código da loja, como pur_a1b2c3d4-6012345678901. O log não tem coluna de valor: confira o valor na página Eventos ou abra o evento nos Eventos de teste.
6. Remova o código de evento de teste ao terminar. A Meta pede que o código seja usado só para testes, e o WeProfit o desativa sozinho 24 horas depois que você o define.

Pixel adicionado, mas nenhuma compra no Gerenciador de Anúncios?

Confira primeiro o Gerenciador de Eventos. Se os eventos Purchase chegam ali, a Meta os tem, e a questão é a atribuição: o Gerenciador de Anúncios mostra só as compras que a Meta credita aos seus anúncios de acordo com a configuração de atribuição de cada conjunto de anúncios. Se nenhuma compra chega, o problema está na ferramenta de envio: um ID do pixel errado, um pixel desconectado ou um código que parou na nova página de agradecimento da Shopify.

O checklist de solução de problemas percorre cada verificação em ordem, de um pedido real até o log de envios da CAPI.

• Pixel do Facebook não rastreia as compras na Shopify: o checklist
• Por que as suas plataformas de anúncios e a sua loja mostram vendas diferentes