API de Conversões da Meta (CAPI) para formulários de leads: envie leads sem contagem duplicada
Como enviar leads para a Meta pelo Pixel e pela API de Conversões ao mesmo tempo com um ID de evento compartilhado, gerar um token de acesso, verificar em Eventos de teste e lidar com o consentimento para dados de contato com hash.
Resposta: A API de Conversões da Meta (CAPI) envia eventos a partir do seu servidor, e não do navegador do visitante. Use-a junto com o Pixel e dê aos dois o mesmo nome de evento e o mesmo ID de evento; assim a Meta fica com um e descarta o duplicado. Os leads que o Pixel perde (bloqueadores de anúncios, limites de rastreamento dos navegadores, abas fechadas) continuam sendo registrados pelo evento do servidor.
Por que só o Pixel não basta
O Pixel roda no navegador do visitante. Bloqueadores de anúncios, limites de rastreamento do iOS e pessoas que fecham a aba logo depois de enviar, tudo isso faz eventos se perderem. A Meta passa então a reportar menos conversões do que houve e otimiza seus anúncios com menos dados. Uma cópia enviada pelo servidor cobre essa lacuna.
O que você precisa
- ID do Pixel (conjunto de dados), em Gerenciador de Eventos da Meta → Fontes de dados.
- Token de acesso da API de Conversões: Gerenciador de Eventos → seu conjunto de dados → Configurações → API de Conversões → Gerar token de acesso.
- Código de evento de teste (opcional): aparece na aba Eventos de teste e começa com
TEST.
Como funciona a desduplicação
| Enviado por | Nome do evento | ID do evento |
|---|---|---|
| Pixel no navegador | Lead |
fbq('track', 'Lead', {}, {eventID: 'abc123'}) |
| Servidor (CAPI) | Lead |
"event_id": "abc123" |
Quando o mesmo nome e o mesmo ID chegam pelos dois lados, a Meta fica com um. Se os IDs forem diferentes, ou se o nome for diferente (por exemplo Lead e SubmitApplication), o lead é contado duas vezes. Gere um único ID no navegador no momento do envio e passe-o para os dois.
O que colocar no evento do servidor
event_name(Lead),event_time,event_id,action_source: "website",event_source_urluser_data- enviados como estão:
client_ip_address,client_user_agent,fbc(cookie do ID de clique),fbp(cookie do ID do navegador) - com hash SHA-256: telefone (
ph, só dígitos com código do país, ex.: 821012345678), e-mail (em, em minúsculas), nome
- enviados como estão:
Mais identificadores melhoram a Qualidade da Correspondência de Eventos, mas resolva o consentimento antes.
Consentimento: dado com hash continua sendo dado pessoal
Pela Personal Information Protection Act da Coreia (e pela maioria das leis de privacidade), aplicar hash a um número de telefone não o torna anônimo, e a Meta é uma destinatária no exterior. Uma configuração segura:
- Adicione um consentimento separado e opcional para "transferência internacional para mensuração de anúncios": destinatário (Meta Platforms), país, itens, finalidade, prazo de retenção.
- Inclua os dados de contato com hash só de quem concordou.
- Para todos os outros, envie o evento só com IP, user agent e IDs de clique.
- Nunca envie informações de saúde, como sintomas.
Veja texto de consentimento para formulários de leads na Coreia ou gere o seu com a ferramenta grátis de consentimento.
Verifique
- Adicione o código de evento de teste e envie um lead de teste.
- Em Eventos de teste, deve aparecer um evento do Navegador e um do Servidor, um deles marcado como desduplicado.
- Remova o código de teste antes de colocar no ar.
Devolva os resultados
Quando um lead vira consulta ou venda, envie um evento personalizado pelo servidor com os mesmos identificadores com hash (ou um ID externo). Assim a Meta consegue aprender quais pessoas vão além de preencher o formulário.
No CutLanding
Cole o ID do Pixel e o token de acesso em Configurações → Conectar. Depois que um lead é salvo, os eventos do Pixel e do servidor saem com o mesmo ID, os dados de contato com hash são adicionados só para quem deu consentimento para mensuração de anúncios, dados de saúde nunca são enviados e envios que falham são repetidos por 24 horas.
FAQ
Posso tirar o Pixel e usar só a API de Conversões?
A Meta recomenda usar os dois com desduplicação. Os dados do navegador (cookies fbp e fbc) ajudam na correspondência e, se um dos lados falhar, o outro ainda registra o lead.
Meus leads estão sendo contados duas vezes. Por quê?
Os nomes ou os IDs de evento são diferentes entre o Pixel e o servidor. Use um único ID por envio nos dois lados e o mesmo nome de evento.
E se o meu token de acesso vazar?
Gere um novo token no Gerenciador de Eventos e substitua-o em todos os lugares onde ele é usado. Mantenha o token só no servidor, nunca no HTML da página.