O que é a API de Conversão da Meta (Conversions API)

Visão Geral #

A API de Conversão da Meta, também conhecida como Conversions API (CAPI), é uma solução de medição que permite enviar eventos de conversão diretamente dos servidores do anunciante para os servidores da Meta (Facebook), sem depender exclusivamente do navegador do usuário. Ela foi criada para complementar e, em certos casos, substituir o Facebook Pixel, especialmente em um cenário com restrições crescentes ao uso de cookies e JavaScript.

Por que utilizar a Conversions API #

A coleta de dados exclusivamente via navegador está cada vez mais limitada por:

Navegadores que bloqueiam cookies de terceiros por padrão (como Safari e Firefox)
Restrições de privacidade de sistemas operacionais, como o App Tracking Transparency (ATT) no iOS
Extensões de adblockers que bloqueiam scripts do Pixel
Requisitos legais, como GDPR e LGPD, que exigem mais controle sobre o rastreamento do usuário

A Conversions API permite contornar essas limitações ao enviar os dados diretamente do servidor da empresa para a Meta, aumentando a confiabilidade da medição e a eficácia das campanhas.

Como funciona #

Modelo tradicional (Facebook Pixel – client-side) #

Os eventos são enviados diretamente do navegador do usuário para os servidores da Meta.
Esse modelo depende da execução de JavaScript no navegador e do uso de cookies.
Pode ser bloqueado por navegadores, configurações de privacidade e extensões.

Modelo com Conversions API (server-side) #

Os eventos são enviados diretamente do servidor da empresa para os servidores da Meta.
Os dados não dependem do navegador do usuário.
Pode ser utilizado em conjunto com o Pixel, usando o mesmo event_id para deduplicação.

Tipos de eventos suportados #

Exemplos comuns de eventos que podem ser enviados:

PageView – Visualização de página
ViewContent – Visualização de produto
AddToCart – Adição ao carrinho
InitiateCheckout – Início do checkout
Purchase – Compra finalizada
Lead – Conversão via formulário

Dados recomendados para envio #

Para garantir a correspondência dos eventos (match rate), recomenda-se enviar os seguintes dados:

Identificadores do usuário: #

Email (em)
Número de telefone (ph)
Primeiro nome (fn)
Sobrenome (ln)
Cidade (ct)
Estado (st)
País (country)
Data de nascimento (db)
Gênero (ge)
External ID (external_id)
Facebook click ID (fbc)
Facebook browser ID (fbp)

Os dados pessoais como email e telefone devem ser normalizados e aplicados com hash SHA-256 antes do envio, conforme as políticas da Meta.

Metadados do evento: #

event_name
event_time (timestamp Unix UTC)
event_id (para deduplicação com o Pixel)
action_source (ex: website, app, phone_call)
user_agent
ip_address

Dados de conversão: #

Valor da compra (value)
Moeda (currency)
Lista de produtos (item ID, nome, categoria, quantidade)

Formas de implementação #

Integrações prontas (no-code):
- Shopify, WooCommerce, Magento (via plugins)
- Google Tag Manager Server-Side com container próprio
- TagServer, Segment, Stape.io, entre outros
Implementação manual:
- Backend personalizado via Node.js, PHP, Python, etc.
- Requisição HTTP POST para o endpoint:
  bash
  https://graph.facebook.com/v17.0/<PIXEL_ID>/events?access_token=<TOKEN>

Vantagens #

Redução da perda de dados causada por bloqueadores de anúncios ou cookies
Aumento da qualidade dos dados de conversão
Melhor desempenho das campanhas com atribuição mais precisa
Deduplicação de eventos entre client-side (Pixel) e server-side (CAPI)
Atendimento às políticas de privacidade mais restritivas