Como gerar o token da API de Conversões da Meta (pixel pelo servidor)
Atualizado em
O pixel do navegador perde quem recusa os cookies, usa bloqueador ou fecha a aba antes de carregar. Com o token da API de Conversões, o servidor do site manda à Meta o cadastro, o lead e o pagamento direto, e a Meta aprende com todas as conversões, não só com as que o navegador viu.
O que você ganha
- Lead, cadastro, início do pagamento e compra chegando à Meta pelo servidor (inclusive pagamento confirmado pelo webhook do Stripe, que o navegador nunca vê)
- Mais conversões contadas: a campanha sai da fase de aprendizado mais cedo e o custo por conversão fica mais estável
- Sem contagem dobrada: o evento do navegador e o do servidor vão com o mesmo event_id e a Meta junta os dois
Antes de começar
- Acesso de administrador ao portfólio empresarial (business.facebook.com) que é dono do pixel. Sem isso, o botão de gerar o token não aparece.
- O ID do pixel que o site usa (um número de 15 ou 16 dígitos, no código do site: fbq('init', '…')). No FarejaLeads, Anúncios → Pixel mostra o ID.
- Um token vale para o pixel inteiro: se vários sites usam o mesmo pixel, o mesmo token serve para todos.
Passo a passo
1. Abra o Gerenciador de Eventos
Entre em business.facebook.com/events_manager2 com a conta que administra o portfólio.
Confira no topo, à esquerda, se o portfólio selecionado é o dono do pixel. Se não for, troque ali.
2. Escolha o pixel certo
No menu da esquerda, clique em "Fontes de dados" (em algumas contas aparece "Conjuntos de dados").
Na lista, ache o pixel pelo número do ID, que aparece abaixo do nome. O nome pode não ser o do site; o ID é o que vale.
3. Gere o token
Com o pixel aberto, vá à aba "Configurações".
Desça até a seção "API de Conversões" e, em "Configurar manualmente", clique em "Gerar token de acesso".
Copie o token na hora: ele aparece uma vez só. Se perder, gere outro; os tokens anteriores continuam valendo.
Não aparece o botão? Em business.facebook.com → Configurações do negócio → Fontes de dados → Conjuntos de dados (ou Pixels), escolha o pixel, clique em "Atribuir pessoas", dê "Controle total" ao seu usuário e volte ao passo 3.
4. Cole no FarejaLeads
Para o próprio FarejaLeads (quem administra a plataforma): app → Admin → Compras e integrações → Anúncios na Meta → META_CAPI_TOKEN. Fica cifrado e não aparece de novo.
5. Cole no servidor de cada site que usa o mesmo pixel
O token é segredo: vai só na variável de ambiente do servidor do site, nunca no código do navegador, no repositório nem numa conversa.
Railway: projeto → serviço do site → Variables → New Variable, com o nome que o código do site lê (em geral META_CAPI_TOKEN), e salve; o Railway faz o deploy de novo.
Lovable (Supabase): Cloud → Secrets → Add secret, com o nome que as funções do site leem; depois publique as funções.
Vercel, Netlify e outros: Settings → Environment Variables, e faça um deploy novo.
Não sabe o nome que o site lê? Peça ao agente de código do site, ou procure no código por graph.facebook.com e /events.
6. Teste antes de valer
No Gerenciador de Eventos, com o pixel aberto, abra a aba "Testar eventos" e copie o código (algo como TEST12345).
No FarejaLeads, cole em META_CAPI_TESTE (ou na variável de teste do site) e faça um cadastro de teste no site.
O evento aparece em "Testar eventos" com a origem "Servidor". Viu? Apague o código de teste: enquanto ele estiver lá, os eventos não contam para os anúncios.
7. Confira depois de um dia
Na "Visão geral" do pixel, cada evento mostra de onde veio: "Navegador", "Servidor" ou os dois. Com os dois, a Meta juntou pelo event_id e não contou dobrado.
A "Qualidade da correspondência do evento" sobe quando o servidor manda o e-mail ou o telefone (sempre com hash, que o código já faz).
Regras que valem sempre
- LGPD: mande pelo servidor só os eventos de quem aceitou os cookies de marketing, o mesmo critério do pixel do navegador.
- O token dá acesso para mandar eventos ao pixel: se vazar, gere outro e apague o antigo em Configurações → API de Conversões.
- Um pixel por conta de anúncios é o mais simples. Se vários sites dividem o pixel, as campanhas separam os resultados pelo domínio do evento.