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âmetroFunção
event_nameNome do evento
event_timeHorário da ocorrência, em Unix timestamp
event_idIdentificador utilizado na deduplicação
action_sourceOrigem da ação
user_dataIdentificadores utilizados para correspondência
custom_dataInformaçõ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

  1. Configure o conjunto de dados e o Pixel.
  2. Defina os eventos que serão enviados pela CAPI.
  3. Escolha a origem dos dados: servidor, GTM Server ou CRM.
  4. Configure a autenticação da integração.
  5. Estruture os campos obrigatórios e os identificadores disponíveis.
  6. Configure a deduplicação dos eventos compartilhados com o Pixel.
  7. 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.

Compartilhe