Instalar o Pixel do Facebook e a API de Conversões

Muita gente enxerga o Pixel da Meta como uma simples ferramenta de medição. Na verdade, ele é o fluxo de dados com o qual o algoritmo aprende quem são seus clientes. Um Pixel limpo junto com a API de Conversões (CAPI) reduz o custo por resultado e mostra à Meta que por trás do domínio existe uma empresa real. Uma instalação mal feita causa o efeito contrário.

Este guia mostra passo a passo onde colocar o código e como conferir se tudo funciona. Vale para as suas contas e para uma conta de agência do Facebook usada com a gente.

Por que a qualidade do rastreamento afeta a saúde da conta

Os sistemas da Meta avaliam o quadro completo de um anunciante. Uma empresa que envia com regularidade eventos de conversão de qualidade a partir de um domínio verificado parece o que é: um negócio real com clientes reais. Uma conta que leva tráfego a um domínio sem eventos, ou com eventos quebrados, parece mais arriscada.

O custo também conta: dados melhores significam otimização melhor e, portanto, CPA menor. Entre nossos clientes, passar de "só Pixel" para "Pixel mais CAPI bem deduplicada" reduz o CPA em média de 10 a 25%.

Pixel ou API de Conversões: o que cada um faz

Você precisa dos dois: o Pixel captura o que dá no navegador e a CAPI envia os mesmos eventos pelo servidor para não perder nada.

Passo 1: verifique seu domínio

Nas configurações da empresa, abra Segurança da marca → Domínios e adicione seu domínio. Verifique por registro DNS TXT (recomendado) ou meta tag. Isso comprova que o domínio é seu e é necessário para configurar eventos da web.

Se você usa um Business Manager alugado, verifique o domínio no BM dono do Pixel, de preferência o seu.

Passo 2: instale o Pixel no lugar certo para a sua plataforma

O código base é igual em qualquer lugar; muda apenas onde você cola. O ID do Pixel está em Gerenciador de Eventos → Fontes de dados → seu Pixel.

Site próprio ou HTML estático

Cole o código no modelo compartilhado por todas as páginas, logo antes da tag de fechamento do head. Troque YOUR_PIXEL_ID pelo seu ID.

<script>
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
document,'script','https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>

WordPress

Use o plugin oficial Meta for WordPress (Facebook for WordPress). Conecte sua conta da Meta, escolha o Pixel e ative a API de Conversões. Se colar o código manualmente, coloque no cabeçalho e não no rodapé, para o PageView disparar antes de o visitante sair.

Shopify e WooCommerce

Instale o canal de vendas Facebook & Instagram (Shopify) ou o Facebook for WooCommerce. Escolha o Pixel, defina o compartilhamento de dados como Máximo e confirme que e-mail e telefone são enviados. Purchase, AddToCart e ViewContent passam então pelo navegador e pela CAPI.

Next.js, React e outros apps de página única

Carregue o código base uma vez no layout raiz e dispare PageView a cada mudança de rota. Envie os eventos de conversão a partir do componente que executa a ação, por exemplo o manipulador do formulário.

// after the form is saved successfully
const eventId = crypto.randomUUID();
fbq('track', 'Lead', { content_name: 'contact-form' }, { eventID: eventId });
await fetch('/api/lead', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ ...formData, eventId }),
});

Google Tag Manager

Crie uma tag de HTML personalizado com o código base, dispare em Todas as páginas e adicione uma tag por evento (Lead, Purchase) com o acionador correspondente. Confira no modo Visualização se cada tag dispara só uma vez. Nunca instale o mesmo Pixel ao mesmo tempo pelo GTM e no código, ou cada evento será contado duas vezes.

Os eventos padrão principais: ViewContent nas páginas de produto, AddToCart ao adicionar ao carrinho, InitiateCheckout no início do checkout, Purchase na página de agradecimento com valor e moeda, Lead ao enviar um formulário. Prefira nomes padrão: eventos personalizados são mais difíceis de otimizar.

Passo 3: envie os mesmos eventos pela API de Conversões

Seu servidor envia o evento à Graph API com um token de acesso gerado no Gerenciador de Eventos, em Configurações → API de Conversões. Guarde-o em uma variável de ambiente, nunca no código do front-end.

import crypto from 'node:crypto';

const sha256 = (v) =>
  crypto.createHash('sha256').update(String(v).trim().toLowerCase()).digest('hex');

export async function sendLead({ email, phone, eventId, url, ip, userAgent, fbp, fbc }) {
  const body = {
    data: [{
      event_name: 'Lead',
      event_time: Math.floor(Date.now() / 1000),
      event_id: eventId,            // same value the browser sent
      action_source: 'website',
      event_source_url: url,
      user_data: {
        em: [sha256(email)],
        ph: [sha256(phone.replace(/\D/g, ''))],
        client_ip_address: ip,       // not hashed
        client_user_agent: userAgent, // not hashed
        fbp, fbc,                    // not hashed
      },
    }],
    // test_event_code: 'TEST12345', // only while testing
  };
  const res = await fetch(
    `https://graph.facebook.com/v21.0/${process.env.PIXEL_ID}/events?access_token=${process.env.CAPI_TOKEN}`,
    { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }
  );
  return res.json();
}

Os campos principais são event_name, event_time (segundos Unix), uma event_id idêntica à do navegador, action_source "website", a URL da página e user_data.

Aplique o hash nos dados pessoais corretamente

E-mail, telefone, nome, sobrenome, cidade e ID externo precisam ser normalizados e receber SHA-256: e-mail sem espaços e em minúsculas, telefone só com dígitos incluindo o código do país, nomes em minúsculas e sem pontuação. IP, user agent, fbp e fbc não levam hash. Leia também o fbclid da URL da página de destino e guarde-o em um cookie: com ele se monta o fbc, que permite à Meta ligar o lead ao clique exato no anúncio.

Passo 4: deduplique os eventos do navegador e do servidor

Se o Pixel e a CAPI enviam ambos um evento Lead, a Meta conta duas vezes, a menos que você deduplique. A regra: mesmo event_name e mesma event_id nas duas origens. Gere o ID no navegador no envio do formulário, passe-o ao Pixel como eventID e mande-o ao servidor junto com os dados do formulário, que o reutiliza na requisição da CAPI. No Gerenciador de Eventos aparecerá "Deduplicado".

Passo 5: melhore a qualidade de correspondência de eventos

A qualidade de correspondência (EMQ) mostra o quanto a Meta consegue ligar seus eventos a pessoas reais. Envie mais identificadores em cada evento do servidor: e-mail com hash (maior impacto), telefone com hash, fbp e fbc, IP e user agent, e ID externo com hash. Muitos clientes sobem de EMQ 4–6 para mais de 8 em uma semana. Para o tráfego do iOS, ordene seus eventos por prioridade na mensuração agregada de eventos e coloque o mais valioso (Lead ou Purchase) no topo.

Privacidade e consentimento: LGPD no Brasil, RGPD em Portugal e na UE

O Pixel grava cookies e envia dados pessoais à Meta. No Brasil, a LGPD exige base legal, transparência e uma política de privacidade clara. Para visitantes da UE e de Portugal, o RGPD na prática exige um banner de cookies com consentimento antes de carregar o Pixel. Tecnicamente, o código base só roda depois do aceite, por exemplo com um acionador de consentimento no Tag Manager ou com a função de consentimento do fbq. A CAPI também deve enviar apenas dados de quem consentiu. Isto não é aconselhamento jurídico: peça a um profissional para revisar banner, política de privacidade e transferências de dados.

O que não enviar

• Categorias sensíveis como condição de saúde ou situação financeira em URLs, parâmetros de evento ou nomes de conteúdo.
• Dados pessoais sem hash em qualquer parâmetro, inclusive em URLs. Uma página de agradecimento como /obrigado?email=joao@exemplo.com.br entrega o e-mail ao Pixel automaticamente.
• Eventos de páginas que não são suas.

Teste antes de gastar o primeiro real

1. Abra Gerenciador de Eventos → Testar eventos, digite sua URL e faça uma conversão de teste.
2. O evento Lead deve aparecer duas vezes, como Navegador e Servidor, unidas em uma linha marcada "Deduplicado".
3. Confira na visão geral se a qualidade de correspondência de Lead é de pelo menos 6,0.
4. Instale a extensão do Chrome Meta Pixel Helper. Um ícone verde com um único PageView por página indica que o código base dispara uma vez.
5. Remova o test_event_code antes de ir ao ar, para que eventos reais não sejam tratados como testes.
6. Após 24 horas, veja os Diagnósticos: parâmetros ausentes, eventos duplicados ou domínio não verificado.

Problemas comuns e soluções

Usando seu Pixel com uma conta de agência

Quando você usa uma conta de anúncios com a gente, o Pixel fica no seu Business Manager e é compartilhado com a conta de agência. Dados, públicos e aprendizado continuam seus. Se a conta precisar ser substituída, você compartilha o Pixel com a nova e as campanhas retomam com todo o histórico. Por isso a instalação do Pixel está incluída nos planos Growth e Scale: veja serviços e preços. Combine rastreamento sólido com aumento gradual de orçamento e a fase de aprendizado termina bem mais rápido.

Checklist

• Domínio verificado no BM dono do Pixel
• Código base em todas as páginas, PageView a cada mudança de rota
• Eventos padrão nas ações principais
• CAPI enviando os mesmos eventos com event_id idêntica
• E-mail e telefone com hash SHA-256
• EMQ de 6 ou mais no evento principal
• Consentimento obtido antes do Pixel (UE/Portugal) e política de privacidade clara (LGPD)
• Nenhum dado sensível em URLs ou parâmetros

Leia também: Por que sua conta de anúncios do Facebook continua sendo banida e Aluguel de conta de anúncios do Facebook: custos e riscos.

Prefere não fazer sozinho? A HD Agency instala o Pixel, verifica seu domínio e configura a API de Conversões deduplicada. Fale com a gente no Telegram ou WhatsApp, resposta em cerca de 5 minutos. Veja também as soluções por setor.