A Meta Conversions API (CAPI) permite enviar eventos de conversão diretamente de um servidor ou integração para os sistemas da Meta.
Ela pode complementar o Meta Pixel, que coleta eventos no navegador, e também receber eventos originados em sistemas como CRM e plataformas de pagamento.
Como funciona
A CAPI utiliza requisições para enviar eventos associados a um conjunto de dados da Meta.
Os principais campos incluem:
| Parâmetro | Função |
|---|---|
| event_name | Nome do evento |
| event_time | Horário da ocorrência, em Unix timestamp |
| event_id | Identificador utilizado na deduplicação |
| action_source | Origem da ação |
| user_data | Identificadores utilizados para correspondência |
| custom_data | Informações adicionais, como valor e moeda |
Dependendo da origem e do tipo de evento, podem ser necessários campos adicionais.
Exemplo prático
Payload ilustrativo de um evento de lead:
{
"data": [
{
"event_name": "Lead",
"event_time": 1794400000,
"event_id": "lead_12345",
"action_source": "website",
"event_source_url": "https://exemplo.com/contato",
"user_data": {
"em": ["HASH_SHA256_EMAIL"]
},
"custom_data": {
"lead_type": "consultoria"
}
}
]
}O hash é apenas um marcador ilustrativo. Em produção, o valor deve ser gerado com normalização e SHA-256 conforme as especificações da Meta.
Como implementar
- Configure o conjunto de dados e o Pixel.
- Defina os eventos que serão enviados pela CAPI.
- Escolha a origem dos dados: servidor, GTM Server ou CRM.
- Configure a autenticação da integração.
- Estruture os campos obrigatórios e os identificadores disponíveis.
- Configure a deduplicação dos eventos compartilhados com o Pixel.
- Teste o recebimento e o processamento dos eventos.
Como funciona a deduplicação
Quando o mesmo evento é enviado pelo Pixel e pela CAPI, a Meta pode utilizar a combinação de event_name e event_id para identificar ocorrências duplicadas.
Exemplo:
Pixel: Lead + lead_12345
CAPI: Lead + lead_12345
Os dois envios precisam representar a mesma ação.
Se os identificadores forem gerados independentemente, a deduplicação pode falhar.
Como validar
No Gerenciador de Eventos, verifique:
- Recebimento dos eventos Browser e Server.
- Correspondência dos nomes dos eventos.
- Consistência dos identificadores de deduplicação.
- Diagnósticos de qualidade de correspondência.
- Alertas de parâmetros ausentes ou inválidos.
Pontos de atenção
A CAPI não deve ser utilizada para enviar eventos fictícios ou alterar artificialmente o momento de uma conversão.
Também é necessário diferenciar eventos online de eventos originados posteriormente no CRM.
Para eventos Web, client_user_agent, client_ip_address, _fbp e _fbc podem contribuir para a correspondência quando disponíveis, permitidos e adequados ao cenário.
A qualidade da implementação depende da consistência dos eventos, dos identificadores e da integração com a fonte original dos dados.
