Neste artigo
- O que o Pixel da Meta faz?
- O que é a API de Conversões e por que usar junto?
- Passo 1: como criar o pixel e instalar o código base?
- Passo 2: quais eventos configurar?
- Passo 3: como ligar a API de Conversões?
- Passo 4: como evitar evento contado em dobro?
- Passo 5: como melhorar a correspondência e testar?
- O que não pode ser enviado?
- Para quem serve e para quem não serve?
Pixel Meta é o nome que muita gente digita para o Pixel da Meta: um trecho de código colocado no site que registra o que o visitante faz (ver uma página, enviar um formulário, comprar) e devolve essa informação para as campanhas do Facebook e do Instagram. A API de Conversões faz o mesmo trabalho a partir do servidor, sem depender do navegador. A própria Meta recomenda usar os dois juntos.
Instalar do jeito certo significa cinco coisas: o código base em todas as páginas, os eventos certos para o seu negócio, a API de Conversões ligada, os eventos duplicados tratados e um teste antes de rodar anúncio. O passo a passo abaixo segue essa ordem, com a documentação oficial conferida em setembro de 2026. Se a Black Friday de 27 de novembro está no seu plano, o momento de fazer isso é agora, para chegar lá com semanas de eventos registrados.
Neste artigo
- O que o Pixel da Meta faz
- O que é a API de Conversões e por que usar junto
- Passo 1: criar o pixel e instalar o código base
- Passo 2: escolher os eventos
- Passo 3: ligar a API de Conversões
- Passo 4: cuidar da desduplicação
- Passo 5: melhorar a correspondência e testar
- O que não pode ser enviado
- Para quem serve e para quem não serve
O que o Pixel da Meta faz?
Confirmado na página Sobre o Pixel da Meta: o pixel “é um trecho de código que você coloca no seu site” e que registra quando alguém realiza uma ação, chamada de evento. A Meta lista três usos:
- Mostrar anúncio para as pessoas certas, incluindo quem visitou uma página específica ou realizou uma ação no site.
- Gerar mais vendas, com lance automático para alcançar quem tem mais chance de realizar a ação que você quer.
- Medir o resultado dos anúncios.
Os eventos aparecem no Gerenciador de Eventos, e a partir deles você cria públicos personalizados no Gerenciador de Anúncios. Leitura nossa: sem evento configurado, a campanha não tem como otimizar para venda ou para lead. Sobra otimizar para clique.
O que é a API de Conversões e por que usar junto?
O pixel roda no navegador do visitante. Se o navegador bloqueia, a página não termina de carregar ou a conexão cai, o evento se perde.
Confirmado na página Sobre a API de Conversões: ela cria “uma conexão direta” entre os dados do seu servidor, plataforma do site, aplicativo ou CRM e a Meta, e os dados enviados por ela “são menos afetados do que o Pixel da Meta por erros de carregamento do navegador, problemas de conexão e bloqueadores de anúncios”. A Meta afirma que usar as duas fontes juntas cria uma conexão mais confiável, o que ajuda o sistema a reduzir o custo por resultado. A página não traz percentual de ganho, então não citamos nenhum.
Dois limites escritos pela própria Meta. A recomendação é usar a API junto com o pixel, não no lugar dele. E a API “não foi criada para contornar” políticas de compartilhamento de dados, como a Transparência no Rastreamento em Apps do iOS. Ela melhora a entrega do dado, não passa por cima da escolha do usuário.
Passo 1: como criar o pixel e instalar o código base?
Confirmado na página Como configurar e instalar o Pixel da Meta. São duas etapas: criar o pixel e pôr o código base no site, depois configurar os eventos.
O caminho descrito pela Meta começa no Gerenciador de Eventos, em conectar dados do tipo Web, dando um nome ao pixel. Em seguida você digita a URL do site, e o sistema informa se existe uma integração de parceiro disponível para a sua plataforma. Os nomes dos botões mudam com frequência, então siga a página oficial na hora de clicar. Na sequência, a Meta oferece dois modos: “Obter orientação”, que ela recomenda, ou “Faça você mesmo”, em que você escolhe entre “API de Conversões e Pixel da Meta” ou só o pixel.
Na instalação manual, a página de eventos padrão orienta colar o código base entre as tags <head> e </head> de todas as páginas. O evento de visualização de página já vem dentro do código base.
Leitura nossa, três cuidados que evitam dor de cabeça depois:
- Crie o pixel dentro do Gerenciador de Negócios da sua empresa, não no da agência. Na Cordilheira, a conta de anúncios fica sempre no nome do cliente, e o pixel segue a mesma regra: o histórico de eventos é um ativo seu.
- Um pixel só, instalado uma vez. O erro que mais encontramos é o mesmo código inserido por duas vias (tema e plugin, por exemplo), contando tudo em dobro.
- Só no seu site. Os termos da Meta proíbem instalar o seu pixel em site que não é seu sem permissão.
Passo 2: quais eventos configurar?
Evento padrão é uma ação com nome predefinido que a Meta reconhece em todos os produtos de anúncio. Evento personalizado é o que não cabe em nenhum padrão. A página sobre eventos padrão do Pixel da Meta lista 17 eventos. Os que mais importam para pequena e média empresa, com a descrição oficial resumida:
| Evento padrão | Código | O que registra, segundo a Meta |
|---|---|---|
| Lead | Lead | Envio de informações pelo cliente, sabendo que poderá ser contatado depois (formulário, cadastro para avaliação) |
| Contato | Contact | Contato por telefone, SMS, email, chat ou outros meios |
| Agendamento | Schedule | Marcação de horário para visitar uma das suas localizações |
| Adição ao carrinho | AddToCart | Item adicionado ao carrinho |
| Iniciar finalização da compra | InitiateCheckout | Início do checkout |
| Compra | Purchase | Compra concluída, em geral na página de confirmação. Leva valor e moeda |
| Visualização de conteúdo | ViewContent | Visita a uma página importante, como a de um produto |
Há três formas de configurar: integração de parceiro, a ferramenta de configuração de eventos (de apontar e clicar, sem código) ou código manual.
Leitura nossa sobre a escolha:
- Serviço local que capta por formulário:
Leadno envio confirmado do formulário, não no clique do botão. Clique em botão de WhatsApp entra comoContact. - Loja virtual:
ViewContent,AddToCart,InitiateCheckoutePurchase, este último com o valor real do pedido e a moeda em BRL. Sem valor no evento de compra não existe ROAS na Meta, como explicamos em o que é ROAS. - Menos é mais. Três eventos bem disparados valem mais do que doze que ninguém sabe o que significam.
Passo 3: como ligar a API de Conversões?
A Meta descreve três caminhos na página que compara as opções de configuração. Confirmado, com os termos da tabela oficial:
| API habilitada pela Meta | Integração de parceiro | Integração direta | |
|---|---|---|---|
| Custo | Grátis | Depende do parceiro | Varia com desenvolvimento e manutenção |
| Tempo de implementação | Um clique | Depende do parceiro | Duas a quatro semanas para integração nova |
| O que exige | Pixel da Meta | Depende do parceiro | Desenvolvedor e infraestrutura para enviar eventos em tempo real |
| Fontes aceitas | Só web | Depende do parceiro | Web, app, offline, CRM e mensagens |
| Eventos enviados | Os mesmos do pixel, desduplicados automaticamente | Depende do parceiro | Configurável |
Sobre parceiros, a mesma página cita plataformas de comércio como Shopify, WooCommerce, Wix e BigCommerce, em que a configuração sai “com apenas alguns cliques e sem custos adicionais”, e plataformas como o Gerenciador de tags do Google.
Leitura nossa: para a maioria das pequenas empresas, a ordem de tentativa é esta. Se a sua plataforma tem integração de parceiro, use. Se não tem, a API habilitada pela Meta resolve o site com um clique. A integração direta vale quando você precisa mandar o que o navegador nunca vê: venda fechada no balcão, status do lead no CRM, pedido aprovado depois do boleto.
Passo 4: como evitar evento contado em dobro?
Se a compra é enviada pelo navegador e também pelo servidor, a Meta recebe duas compras. A desduplicação é o processo de contar esse par uma vez só.
Confirmado na página sobre desduplicação de eventos:
- Ela é necessária quando você envia o mesmo evento pelas duas fontes. Se cada fonte envia eventos diferentes (por exemplo, carrinho pelo navegador e compra pelo servidor), não precisa.
- Para a Meta desduplicar, o nome do evento (
event_name) precisa ser igual nas duas fontes e o identificador (event_id) precisa ser idêntico. - Se os dois eventos forem equivalentes, a Meta fica com o que chegou primeiro.
- Sem isso, a própria página avisa, os números de conversão ficam “artificialmente altos”, o ROAS perde confiabilidade e as decisões de verba saem erradas.
Na API habilitada pela Meta, a desduplicação é automática. Em integração de parceiro ou direta, confirme com quem implementou que o event_id vai nas duas pontas.
Passo 5: como melhorar a correspondência e testar?
Qualidade da correspondência. Para um evento servir, a Meta precisa ligá-lo a uma conta. Confirmado na página sobre qualidade da correspondência de eventos: a nota vai de 0 a 10, é calculada com os dados das últimas 48 horas e vale para eventos do site enviados pela API de Conversões. Os parâmetros de prioridade alta são email e identificação de clique. Telefone, identificação externa, identificação do navegador, país e data de nascimento têm prioridade média. Nome, sobrenome, cidade e CEP, baixa. Os termos da Meta exigem que as informações de contato sigam convertidas em hash e que você tenha o direito legal e os consentimentos necessários para compartilhar esses dados.
Teste antes de anunciar. A ferramenta Eventos de teste, dentro do Gerenciador de Eventos, abre o seu site em uma nova aba e mostra os eventos chegando enquanto você navega. Ela também mostra quais eventos foram processados e quais foram desduplicados. Três avisos da página: a atividade do site só é registrada enquanto a aba de teste está aberta, as informações ficam na aba por 24 horas e os dados podem levar 30 minutos ou mais para aparecer nas análises.
Leitura nossa, o roteiro de teste: faça você mesmo o caminho inteiro do cliente (abrir a página, enviar o formulário ou concluir um pedido de teste) e confira se cada evento aparece uma vez, na hora certa, e a compra com o valor correto.
O que não pode ser enviado?
Confirmado na página do pixel: você deve garantir que nenhuma informação proibida seja compartilhada, o que inclui dados de saúde, financeiros ou de crianças. A Meta pede revisão regular de nomes de eventos, parâmetros e URLs. Clínica, consultório e serviço financeiro precisam de atenção extra: o nome de um evento ou o endereço de uma página pode revelar mais do que deveria.
Leitura nossa: no Brasil, esse assunto também passa pela LGPD. Aviso de cookies, consentimento e base legal são conversa para ter com o seu jurídico antes de ligar parâmetros avançados, não depois.
Para quem serve e para quem não serve?
O critério: a ação que vale dinheiro acontece no seu site?
Serve, e é prioridade, para:
- Loja virtual. Sem
Purchasecom valor, a campanha de vendas trabalha no escuro. - Negócio que capta lead por formulário ou página de destino.
- Quem vai anunciar na Black Friday e ainda tem semanas para acumular eventos. O planejamento está no cronograma de mídia paga da Black Friday.
Serve pouco para:
- Quem vende só por conversa, com anúncio de clique para WhatsApp ou direct, sem passar pelo site. O pixel não enxerga o que acontece dentro do chat. A API de Conversões aceita eventos de mensagens, mas a página da Meta informa que, no momento, a otimização só está disponível para eventos de compra no Messenger.
- Quem não tem site próprio. O pixel precisa de um site da sua empresa.
Se o pixel já está instalado e os anúncios mesmo assim não vendem, o problema costuma estar em outro lugar. Veja por que seu tráfego pago não converte e, para dimensionar a verba, quanto custa tráfego pago.
Perguntas frequentes
O que é o pixel Meta?
É o Pixel da Meta: um trecho de código instalado no site que registra ações dos visitantes, como envio de formulário e compra. Esses eventos servem para medir os anúncios, criar públicos e otimizar campanhas do Facebook e do Instagram.
Qual a diferença entre o Pixel da Meta e a API de Conversões?
O pixel envia os eventos a partir do navegador do visitante. A API de Conversões envia a partir do servidor, da plataforma do site ou do CRM, e por isso é menos afetada por bloqueadores e falhas de carregamento. A Meta recomenda usar os dois juntos.
A API de Conversões é paga?
A opção habilitada pela Meta é gratuita e configurada com um clique, só para eventos da web. Em plataformas de comércio parceiras, como WooCommerce e Shopify, a Meta informa que a configuração não tem custo adicional. A integração direta tem custo de desenvolvimento e manutenção.
O que é desduplicação de eventos?
É o processo de contar uma vez só o evento que chegou pelo pixel e pela API de Conversões. Para funcionar, o nome do evento e o event_id precisam ser idênticos nas duas fontes. Sem isso, as conversões aparecem em dobro e o ROAS fica inflado.
Como saber se o pixel está funcionando?
Use a ferramenta Eventos de teste, no Gerenciador de Eventos da Meta. Ela abre o seu site em outra aba e mostra os eventos chegando enquanto você navega, inclusive quais foram desduplicados. Os dados podem levar 30 minutos ou mais para aparecer nos relatórios.
Posso enviar qualquer dado do cliente pelo pixel?
Não. A Meta proíbe o envio de dados de saúde, financeiros ou de crianças, exige que informações de contato sejam convertidas em hash e que você tenha o direito legal e os consentimentos necessários. No Brasil, o tema também envolve a LGPD.
Quer o pixel conferido antes da Black Friday?
Auditamos pixel, eventos, API de Conversões e desduplicação na sua conta, no seu nome, e entregamos a lista do que corrigir. Chame no WhatsApp e diga que veio pelo guia do Pixel da Meta.
Fontes
- Central de Ajuda da Meta: Sobre o Pixel da Meta
- Central de Ajuda da Meta: Como configurar e instalar o Pixel da Meta
- Central de Ajuda da Meta: Sobre a API de Conversões
- Central de Ajuda da Meta: Comparar as opções de configuração da API de Conversões
- Central de Ajuda da Meta: Sobre a desduplicação de eventos do Pixel da Meta e da API de Conversões
- Central de Ajuda da Meta: Sobre a qualidade da correspondência de eventos
- Central de Ajuda da Meta: Especificações para eventos padrão do Pixel da Meta
- Central de Ajuda da Meta: Ferramenta Eventos de teste