O Meta Pixel sozinho perde uma parte relevante dos eventos: bloqueadores de anúncio, restrições de cookies no Safari e iOS e falhas de carregamento derrubam o envio pelo navegador. A API de Conversões (CAPI) resolve isso mandando os mesmos eventos pelo servidor. Este guia mostra as formas de ativar a CAPI em um site WordPress sem depender de plugin pago, com prós e contras de cada uma.
Como Pixel e CAPI trabalham juntos
A recomendação da Meta é usar os dois ao mesmo tempo. O Pixel envia o evento pelo navegador; a CAPI envia o mesmo evento pelo servidor. Para não contar em dobro, os dois carregam o mesmo event_id e o mesmo event_name, e a Meta faz a desduplicação. Quanto mais dados de correspondência (e-mail, telefone, IP, user agent, fbp e fbc) chegam pela CAPI, maior a qualidade de correspondência do evento (EMQ) e melhor a otimização das campanhas.
Opção 1: integração de um clique no Gerenciador de Eventos
No Gerenciador de Eventos, a Meta oferece configurar a API de Conversões com poucos cliques para quem já tem o Pixel. Ela replica pelo servidor os eventos que o Pixel já envia.
- Prós: sem custo, sem código, ativa em minutos.
- Contras: só reenvia o que o Pixel captura. Não registra eventos que acontecem apenas no servidor (pagamento aprovado depois, venda no CRM) e oferece pouco controle sobre os dados enviados.
Opção 2: plugin gratuito para WordPress
Plugins de pixel para WordPress, como o PixelYourSite, instalam o Pixel e enviam eventos pela CAPI usando um token de acesso gerado no Gerenciador de Eventos. A versão gratuita costuma cobrir eventos padrão (PageView e eventos de formulário ou WooCommerce básicos); recursos avançados ficam na versão paga.
- Prós: instala pelo painel, gera
event_idautomaticamente para desduplicação. - Contras: mais um plugin para manter, recursos limitados no plano gratuito, menos controle sobre consentimento se o CMP não estiver integrado.
Opção 3: GTM server-side
Com um contêiner de servidor do Google Tag Manager, o mesmo fluxo que envia dados ao GA4 envia para a Meta usando o template de tag da API de Conversões. É a opção mais completa e a que dá mais controle sobre consentimento e dados pessoais. Os custos de hospedagem estão em GTM server-side: Stape, Cloud Run ou servidor próprio.
- Prós: um só fluxo para várias plataformas, enriquecimento e limpeza de dados no servidor, eventos de CRM.
- Contras: exige conhecimento de GTM e um servidor (gratuito em volume baixo na Stape).
Opção 4: código próprio no WordPress
Para desenvolvedores, enviar eventos pela API é uma chamada HTTP. Exemplo de envio de um Lead a partir do PHP, depois que o formulário foi validado:
$payload = [
'data' => [[
'event_name' => 'Lead',
'event_time' => time(),
'event_id' => $event_id, // o mesmo enviado pelo Pixel
'action_source' => 'website',
'event_source_url' => home_url( $_SERVER['REQUEST_URI'] ),
'user_data' => [
'em' => [ hash( 'sha256', strtolower( trim( $email ) ) ) ],
'ph' => [ hash( 'sha256', preg_replace( '/\D/', '', $telefone ) ) ],
'client_ip_address' => $_SERVER['REMOTE_ADDR'],
'client_user_agent' => $_SERVER['HTTP_USER_AGENT'],
'fbp' => $_COOKIE['_fbp'] ?? null,
'fbc' => $_COOKIE['_fbc'] ?? null,
],
]],
];
wp_remote_post(
'https://graph.facebook.com/v21.0/' . PIXEL_ID . '/events?access_token=' . CAPI_TOKEN,
[ 'headers' => [ 'Content-Type' => 'application/json' ], 'body' => wp_json_encode( $payload ), 'timeout' => 5 ]
);No navegador, o Pixel envia o mesmo evento com o mesmo ID:
fbq('track', 'Lead', {}, { eventID: 'ID_GERADO_NO_SERVIDOR' });Confira na documentação da Meta a versão atual da Graph API e guarde o token fora do código-fonte (por exemplo, em constante no wp-config.php).
- Prós: sem custo de plugin ou servidor extra, controle total.
- Contras: manutenção sua, cuidado com tempo de resposta (faça o envio de forma assíncrona) e com a segurança do token.
Qual escolher
| Cenário | Opção recomendada |
|---|---|
| Site institucional com poucos eventos, sem equipe técnica | Integração de um clique ou plugin gratuito |
| WooCommerce com tráfego pago relevante | GTM server-side |
| Leads que viram venda no CRM | GTM server-side ou código próprio com evento offline |
| Equipe de desenvolvimento própria | Código próprio ou GTM server-side |
Consentimento e LGPD
A CAPI envia dados pessoais (e-mail e telefone em hash, IP, identificadores). Ela precisa respeitar a escolha do visitante no banner de cookies. Se o visitante recusou marketing, nem o Pixel nem a CAPI devem enviar o evento com dados de identificação. Veja como amarrar isso ao Consent Mode e ao CMP em Consent Mode v2 e LGPD.
Como validar
- No Gerenciador de Eventos, use Testar eventos com o código de teste.
- Confira se o evento aparece como recebido pelo navegador e pelo servidor e marcado como desduplicado.
- Acompanhe a nota de qualidade de correspondência (EMQ) de cada evento e envie mais parâmetros se estiver baixa.
Erros comuns
- Enviar o evento pelo servidor sem
event_id, duplicando conversões. - Mandar e-mail sem normalizar antes do hash (maiúsculas e espaços mudam o resultado).
- Disparar CAPI para quem recusou cookies de marketing.
- Deixar o token de acesso exposto no tema ou em repositório público.
Perguntas frequentes
Preciso de plugin pago para usar a API de Conversões da Meta no WordPress?
Não. Dá para usar a integração de um clique do Gerenciador de Eventos, um plugin gratuito, GTM server-side ou código próprio enviando eventos pela Graph API.
Pixel e API de Conversões juntos duplicam eventos?
Não, se os dois enviarem o mesmo event_name e o mesmo event_id. A Meta desduplica automaticamente.
A API de Conversões precisa de consentimento pela LGPD?
Sim. Ela envia dados pessoais, como e-mail em hash e IP, e deve respeitar a escolha do visitante no banner de cookies.
O que é EMQ na API de Conversões?
É a qualidade de correspondência do evento, uma nota que indica quantos dados de identificação a Meta recebeu para associar o evento a uma pessoa. Quanto maior, melhor a otimização.
