Como Configurar a API de Conversões da Meta (CAPI)

O que é a API de Conversões da Meta

A API de Conversões, conhecida como CAPI, é a forma de enviar eventos de conversão do seu servidor direto para a Meta, em vez de depender só do Pixel no navegador. Ela existe porque bloqueadores de anúncio, restrições de privacidade de navegador e do iOS fazem o Pixel perder parte dos eventos.

O uso recomendado é combinar os dois: o Pixel continua no site e a CAPI envia os mesmos eventos pelo servidor. A Meta junta as duas fontes e descarta as duplicatas, desde que os eventos tenham o mesmo identificador.

• Pixel: evento enviado pelo navegador do visitante.
• CAPI: evento enviado pelo seu servidor.
• Os dois juntos recuperam eventos que o Pixel sozinho perderia.
• A deduplicação evita que a mesma compra seja contada duas vezes.

Passo a passo da configuração

A configuração começa no Gerenciador de Eventos e termina no seu servidor ou na plataforma que processa as vendas. Algumas plataformas de checkout e de e-commerce já têm integração pronta com a CAPI; nesse caso, basta autorizar. Quando não têm, o envio é feito por uma chamada à API a cada evento.

• 1. No Gerenciador de Eventos, abra o conjunto de dados do seu Pixel.
• 2. Em Configurações, na seção da API de Conversões, gere o token de acesso.
• 3. Envie cada evento com nome, horário, identificador do evento, origem e URL da página.
• 4. Inclua os dados do cliente com hash SHA-256, como e-mail e telefone, além de IP, navegador e os cookies fbp e fbc quando existirem.
• 5. Use o mesmo nome e identificador do evento no Pixel e na CAPI para a deduplicação.
• 6. Valide com a ferramenta de eventos de teste antes de ligar em produção.

Deduplicação entre Pixel e servidor

A deduplicação é o ponto onde mais configurações dão errado. A Meta só entende que dois eventos são o mesmo quando o nome do evento e o identificador do evento chegam iguais pelas duas fontes. Se o Pixel manda um identificador e o servidor manda outro, a venda aparece em dobro e o custo por compra parece metade do real.

A forma prática é gerar o identificador no momento da conversão, usar o mesmo valor no disparo do Pixel e repassá-lo ao servidor junto com os dados do pedido.

• Mesmo nome de evento nas duas fontes, como Purchase.
• Mesmo identificador do evento nas duas fontes.
• Identificador gerado uma vez por conversão, nunca reaproveitado.
• Confira no Gerenciador de Eventos se os eventos aparecem como deduplicados.

Como testar antes de ligar

O Gerenciador de Eventos tem uma aba de eventos de teste que gera um código temporário. Enviando os eventos com esse código, você vê em tempo real se eles chegam, se os parâmetros estão corretos e se a deduplicação está funcionando, sem misturar com os dados reais da conta.

• Gere o código de teste no Gerenciador de Eventos.
• Faça uma conversão de teste no site.
• Confira se o evento chegou pelo navegador e pelo servidor.
• Remova o código de teste antes de ligar em produção.

Erros comuns na configuração da CAPI

A maior parte dos problemas não aparece como erro: o evento chega, mas chega errado. Por isso vale acompanhar a qualidade de correspondência dos eventos no Gerenciador nas primeiras semanas e comparar o número de compras da Meta com o da sua plataforma de pagamento.

• Identificador diferente entre Pixel e servidor, gerando conversão em dobro.
• Dados do cliente enviados sem hash ou com formatação inconsistente.
• Horário do evento muito antigo, que a Meta pode recusar.
• Código de teste esquecido em produção.
• Token de acesso colado em arquivo público ou compartilhado.