Implementar CAPI Meta com precisão server-side | Kognos
A Conversions API (CAPI) envia eventos do servidor diretamente para a Meta — complementando o pixel e recuperando conversões bloqueadas por iOS, ad blockers e Consent Mode. A Kognos implementa CAPI com deduplicação event_id, QA no Events Manager e integração ao CRM para atribuição de receita.
Quando você precisa de CAPI
- Pixel sozinho perde eventos em dispositivos iOS e Safari
- Match rate baixo entre pixel e CAPI no Events Manager
- Campanhas de conversão degradaram após ATT / iOS 14+
- Operação B2B com funil longo — CRM é fonte de verdade
Escopo da implementação Kognos
- Server-side tagging e envio CAPI com event_id único
- Deduplicação pixel + CAPI conforme documentação Meta
- Eventos Lead, Purchase e custom alinhados ao CRM
- Monitoramento de match rate e alertas de qualidade
CAPI não substitui o pixel
A recomendação oficial da Meta é usar pixel e CAPI juntos, com deduplicação via event_id. CAPI sozinho ou pixel sozinho deixa lacunas. Implementação correta melhora sinal para o algoritmo e reduz CPL em campanhas maduras.
A Kognos implementa a arquitetura completa — não apenas "instalar CAPI". Conectamos ao CRM para que conversões offline e pipeline alimentem o mesmo modelo de atribuição.
Fases da implementação Kognos
Fase 1 — Diagnóstico: auditoria Events Manager, inventário de eventos, match rate baseline, mapeamento CRM → conversões Meta. Entregável: backlog priorizado.
Fase 2 — Fundação: event_id em formulários e checkout, CAPI server-side (cloud tagging ou API direta), deduplicação pixel+CAPI validada em Test Events.
Fase 3 — CRM loop: webhooks HubSpot/RD/Pipedrive → eventos Qualified e Purchase com mesmo external_id. Monitoramento match rate e alertas de queda.
Fase 4 — Atribuição: dashboard receita por campanha, multi-touch opcional, devolução sinal para Advantage+ e campanhas de conversão.
Mapeamento de eventos: CRM → Meta
Cada estágio comercial vira evento nomeado consistentemente: Lead (form), QualifiedLead (MQL), Schedule (demo agendada), Purchase (won). Nomes devem bater entre pixel, CAPI e documentação interna.
Parâmetros user_data: email e phone SHA-256, client_ip quando permitido, fbp/fbc capturados no form. external_id = ID do contato CRM para offline matching.
Evite criar 15 eventos custom irrelevantes — algoritmo precisa volume. Priorize 3–5 eventos alinhados ao funil real e receita.
QA e go-live sem surpresas
Checklist go-live: domínio verificado, CAPI token com escopo ads_management, Test Events passando Lead+Purchase, dedup confirmado (1 evento por event_id no Events Manager).
Primeiras 2 semanas pós-go-live: review diário de Event Match Quality e comparação CRM vs Meta por campanha — não escalar budget antes de estabilizar.
Documentação entregue: diagrama arquitetura, runbook de troubleshooting, responsáveis marketing/dev/RevOps.
Perguntas frequentes
Quanto custa implementar CAPI? Varia conforme stack. Diagnóstico gratuito define escopo e investimento — sem surpresas.
Preciso de servidor próprio? Avaliamos server-side tagging cloud ou infraestrutura existente no diagnóstico.
Prazo de go-live? Tipicamente 2–4 semanas após kickoff, conforme eventos e integrações.
CAPI funciona para Google Ads? Google tem Enhanced Conversions — tratamos Meta CAPI nesta página; Google entra no escopo multi-plataforma.