Configuração do Pixel do Meta
Configure o Pixel do Meta para rastrear uma conversão real em um site, verificada, para que a otimização de anúncios do Facebook/Instagram tenha algo verdadeiro para aprender. Duas coisas pegam as pessoas e esta habilidade as aborda de antemão: a decisão Pixel vs. Conversions API (o assistente do Meta empurra agressivamente a opção mais pesada) e qual categoria de dados declarar (uma escolha errada pode limitar seus anúncios).
Nota de nomenclatura: o Meta renomeou "Pixel" para "Dataset" na interface. Um dataset contém o pixel e seu ID do Dataset = ID do Pixel (um número de ~15–16 dígitos). Trate as duas palavras como a mesma coisa.
Comece de onde o usuário está
A configuração é uma cadeia: Página do Facebook → Portfólio de negócios → Events Manager → Pixel/Dataset (obter o ID) → código base no site → evento de conversão → verificar. As pessoas chegam no meio da cadeia. Pergunte primeiro e então entre — não recrie o que já existe (um negócio muitas vezes já tem um pixel; reutilize-o em vez de fragmentar dados entre dois).
Pergunte (adapte ao que eles disseram):
- Você já tem uma Página do Facebook e Meta Business Suite / Portfólio de negócios configurados?
- Você já tem um Pixel / Dataset (no Events Manager)? Se sim, qual é o ID do Dataset (o número de ~16 dígitos)? Cole-o — pode ser tudo o que é necessário.
- Qual é a única conversão que importa (um lead/envio de lista de espera, um cadastro, uma compra)? É para isso que os anúncios otimizam.
- A stack + domínio do site (Next.js, HTML puro, WordPress, Shopify) — decide como o código será inserido.
Se eles já tiverem o ID do Dataset e uma Página, pule direto para a instalação (§3). Não os guie de volta pela criação de conta que já fizeram.
Decisão 1: Apenas Pixel, ou + Conversions API? (comece com apenas Pixel)
O assistente de configuração do Meta mostra "Conversions API e Meta Pixel (Recomendado)" com uma estatística brilhante. Não aceite reflexivamente. Aqui está a troca honesta:
- Meta Pixel (navegador) — um snippet de código no site envia eventos do navegador do visitante. Simples, sem backend, funciona hoje. Isso é tudo que você precisa para lançar.
- Conversions API (CAPI) — seu servidor envia eventos diretamente para o Meta. É servidor-para-servidor, "requer suporte de desenvolvedor" e, para realmente ajudar, precisa de PII do cliente (e-mail, telefone, IP) enviados ao Meta para correspondência. Isso é mais construção e uma superfície de privacidade/conformidade maior (LGPD/GDPR/CCPA).
Portanto: lance com o Pixel do navegador. Adicione CAPI depois, somente se a perda de sinal do navegador (bloqueadores de anúncios, ATT da iOS) estiver prejudicando você de forma mensurável e você tiver resolvido a questão de PII/consentimento. Trate CAPI como uma otimização pós-lançamento, não uma etapa de configuração. Leia references/conversions-api.md antes de conectá-lo — ele existe para impedir que você envie dados pessoais para o Meta por acidente.
Decisão 2: a "categoria" do Dataset — deixe em branco a menos que se encaixe claramente
Ao criar o dataset, o Meta pergunta para "selecionar quaisquer categorias aplicáveis." Esta é uma armadilha para produtos financeiros/saúde/sensíveis. O diálogo avisa: "dependendo da categoria e localização, o compartilhamento de dados pode ser limitado ou bloqueado." Categorias como "Serviço financeiro," "Vulnerabilidade econômica," "Dificuldade pessoal," "Nacionalidade" acionam o manuseio restrito de dados do Meta e podem limitar ou bloquear a otimização dos seus anúncios.
Regra: marque uma categoria somente se ela descrever você com precisão e inevitabilidade, e você entender que ela restringe dados. Uma ferramenta de orçamento/produtividade/SaaS é software, não um "serviço financeiro" (essa categoria é para credores, relatórios de crédito, finanças ao consumidor). Em caso de dúvida, deixe as categorias vazias (é opcional) — vazio significa sem restrição, que é o que um teste normal de lista de espera/cadastro deseja.
1. Criar ou encontrar o Pixel/Dataset (obter o ID)
No Events Manager:
- Barra lateral esquerda → Conectar dados (verde +) → Web → Meta Pixel → Conectar. (Ou se um dataset existir, clique nele — o ID está logo abaixo do nome.)
- Nomeie-o após o negócio (ex.: "Acme Web"). Para categoria, veja Decisão 2 (geralmente deixe em branco).
- Copie o ID do Dataset — o número de ~16 dígitos abaixo do nome. Também sempre visível depois em Events Manager → Datasets.
- Se ele abrir um assistente "configurar / conectar seu website" oferecendo Conversions-API vs apenas Pixel — você pode fechar/pular. Você só precisa do ID; o código é inserido manualmente (§3). Se prosseguir, escolha Apenas Meta Pixel (Decisão 1).
2. (Opcional) Reutilizar um pixel existente
Um pixel não é uma parede rígida de relatórios como uma propriedade do GA4. Um pixel pode cobrir um domínio inteiro — o aplicativo principal e uma página de destino /waitlist. Diferencie funis pelo evento + parâmetros personalizados (ex.: content_name: 'waitlist'), não por um segundo pixel. Se o negócio já tiver um, reutilize seu ID.
3. Instalar o código base
Cole no <head> em todas as páginas, substituindo YOUR_PIXEL_ID. Ele dispara PageView automaticamente. (Copie seu snippet exato do Events Manager — ele tem o ID pré-preenchido — ou use esta forma canônica.)
<!-- Meta Pixel Code -->
<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>
<noscript><img height="1" width="1" style="display:none"
src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/></noscript>
<!-- End Meta Pixel Code -->
NÃO adicione um hash integrity/SRI — fbevents.js é um carregador versionado que o Meta atualiza no lugar e não publica um hash estável; SRI o quebrará. Instalação específica para frameworks (Next.js next/script, WordPress, Shopify, GTM) está em references/install-by-platform.md.
4. Disparar o evento de conversão na ação
Use um evento padrão para que a otimização e os relatórios do Meta o reconheçam — Lead (lista de espera/contato), CompleteRegistration (cadastro), Purchase (venda). Lista completa + quando usar cada: references/standard-events.md. Dispare-o somente após a ação ter realmente sucedido, nunca em um erro capturado.
<script>
form.addEventListener('submit', async function (e) {
e.preventDefault();
try {
await saveTheLead(/* ... */); // 1. persista PRIMEIRO — o sucesso real
if (window.fbq) fbq('track', 'Lead', { // 2. só então, conte (proteja contra bloqueadores)
content_name: 'waitlist', // parâmetros segmentáveis, NÃO PII apenas
value_bucket: 'high'
});
window.location.href = '/thank-you';
} catch (err) {
showError('Algo deu errado, por favor tente novamente.'); // sem evento, sem sucesso falso
}
});
</script>
Regra de PII — não envie dados pessoais através do Pixel do navegador
Nunca passe e-mail, telefone, nome ou endereço como parâmetros de evento. Envie categorias/faixas (content_name, uma faixa de valor, uma persona) — suficiente para segmentar, não para identificar. (O único lugar onde o Meta usa PII com hash é no Advanced Matching do CAPI, que é uma escolha deliberada, consentida e do lado do servidor — veja references/conversions-api.md, não algo para espalhar em eventos do navegador.)
5. Verifique ANTES de gastar — o portão
Faça uma conversão real no site ao vivo/pré-visualização, então confirme:
- Instale a extensão Chrome Meta Pixel Helper. Carregue a página → ele mostra o pixel +
PageView. Envie o formulário → ele mostra o eventoLeadcom seus parâmetros. - Ou Events Manager → seu dataset → Testar eventos, insira a URL do site e veja os eventos chegarem ao vivo.
- Dispara somente no sucesso: cause uma falha e confirme que o evento NÃO dispara.
Somente depois que você conseguir ver a conversão disparar corretamente, o orçamento de anúncio deve entrar no ar. Uma conversão mal configurada faz o Meta otimizar para as pessoas erradas e você não consegue perceber pelo painel. Lista de verificação completa: references/verify-checklist.md.
"Você pode configurar isso para mim?"
A criação da conta/Página/Business-Suite/Pixel precisa do próprio login do Meta do usuário — não pode ser feita em nome dele; é uma curta caminhada na interface (esta habilidade a guia). Obter o ID do Dataset é o único trabalho do usuário. O assistente pode escrever o código base + evento no site assim que tiver o ID. Divida dessa forma — e afaste-os do assistente de CAPI e de categorias sensíveis conforme as duas decisões acima.
Arquivos de referência
references/install-by-platform.md— instalação do código base para Next.js, HTML, WordPress, Shopify, GTM.references/standard-events.md— nomes de eventos padrão do Meta + parâmetros para conversões comuns.references/conversions-api.md— o que é CAPI, quando vale a pena e as barreiras de PII/consentimento ANTES de conectá-lo.references/verify-checklist.md— o portão de verificação pré-gasto (Pixel Helper, Test Events, falhas comuns).