API de conversões (CAPI)

Uma API de conversões (CAPI) é uma conexão server-to-server que envia eventos de conversão, como instalações, cadastros e compras, dos sistemas do anunciante para uma plataforma de anúncios. A plataforma associa cada conversão à pessoa que viu ou clicou no anúncio. Seu algoritmo então aprende quem converte e otimiza a campanha para alcançar mais pessoas como elas.

CAPI também é escrito como conversion API, e a Meta Conversions API ainda é amplamente pesquisada como Facebook conversions API. Uma CAPI está relacionada, mas é mais restrita que o server-side tracking. O server-side tracking é a prática ampla de coletar eventos em um servidor em vez do navegador, enquanto uma conversions API é o endpoint específico que uma plataforma de anúncios fornece para receber esses eventos.

Como os dados viajam de servidor para servidor, bloqueadores de anúncios e limites de cookies do navegador não os bloqueiam. Uma CAPI também pode reportar conversões que um pixel de navegador não vê, como uma compra no app após um anúncio web. Meta, TikTok, Google Ads, LinkedIn, Snapchat e Reddit aceitam conversões server-side, e Meta, TikTok, LinkedIn e Snapchat recomendam rodar uma CAPI junto com o pixel para campanhas web.

Quando um usuário converte, seu servidor, ou uma plataforma de medição como a Singular trabalhando para você, envia o evento para a API da plataforma de anúncios via HTTPS. A requisição carrega o nome do evento, horário e valor, além de identificadores como um click ID ou um e-mail com hash. A plataforma combina esses identificadores com uma interação de anúncio e registra a conversão.

Uma conversão web geralmente passa por seis etapas:

1. Um usuário clica em um anúncio e a plataforma adiciona um click ID à URL da landing page. O Google Ads usa gclid, a Meta usa fbclid e o TikTok usa ttclid.
2. Seu site, app ou backend registra a conversão quando ela acontece, junto com o click ID e quaisquer dados do cliente que o usuário concordou em compartilhar.
3. Seu servidor normaliza e faz hash dos dados pessoais com SHA-256, depois envia o evento com nome, timestamp, valor e um ID de evento único.
4. A plataforma associa o evento ao clique no anúncio ou a um usuário logado. Enviar mais identificadores, como um click ID mais um e-mail com hash, ajuda a associar mais das suas conversões.
5. Se o pixel também reportou a conversão, a plataforma remove a duplicata usando o ID de evento compartilhado. Cada plataforma define suas próprias regras de como e quando desduplicar.
6. A conversão aparece nos relatórios e alimenta o modelo de lances.

Singular atribui conversões web, web-to-app, PC e console, e depois as envia para a API de conversões de cada parceiro com o click ID e chaves de correspondência com hash padronizadas. Parceiros suportados incluem Meta, Google Ads, TikTok, Snapchat, Reddit, X e OpenAI Ads no ChatGPT, cada um configurado na Singular Partner Configuration.

Para saber mais sobre APIs de conversões, consulte os guias de Integrações da API de Conversões na Singular Central de Ajuda.