API de Conversões do Facebook: Guia de Implementação para 2026

Por Marcus Chen

Especialistas em Marketing de Performance Revisado por Senior Media Buyers

Resposta Rápida da IA

Teste mais de 15 variantes criativas por semana contra uma matriz de hooks controlada, renove assim que a fadiga aparecer na taxa de hook, e deixe a plataforma DCO recombinar os vencedores. A velocidade das variantes supera o polimento de estúdio em todos os canais de mídia paga e pesquisa paga que medimos. A Unled opera a bancada de testes e a linha de produção como uma única operação.

Publicado em 10 julho 2026

Leitura de 12 min · Configuração

A API de Conversões do Facebook (CAPI) é o complemento server-side do pixel do navegador. Após o iOS 14.5 prejudicar o rastreamento baseado em navegador, a CAPI se tornou a única maneira de recuperar as conversões que o Meta estava perdendo. Em 2026, anunciantes que usam apenas Pixel estão deixando de 30 a 60% das conversões atribuídas de lado. Este guia cobre uma instalação limpa da CAPI do início ao fim.

O Que a CAPI Realmente Faz

A CAPI envia eventos de conversão diretamente do seu servidor para o Meta, ignorando completamente o navegador. Isso significa que os eventos chegam mesmo quando o pixel do navegador está bloqueado, quando o dispositivo iOS do usuário limita o rastreamento ou quando as condições de rede interrompem o pixel.

• Recupera conversões iOS. Usuários restritos pelo ATT ainda disparam eventos do servidor.
• Ignora bloqueadores de anúncios. Eventos servidor-para-servidor não são bloqueados.
• Maior qualidade de dados. Eventos do servidor podem incluir identificadores primários (email com hash, telefone, ID do cliente) para correspondência mais forte.
• Melhor deduplicação. Quando combinado com Pixel usando event_id, o Meta deduplica e conta cada conversão uma vez.

Três Caminhos de Instalação

1. Integrações nativas de plataforma (mais fácil)

Shopify, WooCommerce, BigCommerce, Magento, Wix e Squarespace têm conectores nativos da CAPI do Meta. Ative no admin da sua plataforma, cole o token de acesso, pronto. Melhor para equipes não técnicas.

2. Gerenciador de tags server-side (recomendado)

Use Stape ou Google Tag Manager Server-Side para disparar eventos CAPI a partir de um contêiner sGTM. Você obtém controle total de eventos, deduplicação e Correspondência Avançada sem escrever código de servidor. Padrão da indústria para operadores sérios.

3. Integração direta com a API (mais controle)

Envie requisições POST diretamente para https://graph.facebook.com/v18.0/{pixel_id}/events do seu backend. Melhor para SaaS, aplicativos personalizados e qualquer coisa não construída em uma plataforma de comércio importante.

Passo a Passo: Implementação Direta da API

1. Gere um token de acesso CAPI. Gerenciador de Eventos → seu pixel → Configurações → API de Conversões → Gerar Token de Acesso.
2. Escolha os eventos para enviar server-side. Sempre envie Purchase, Lead e CompleteRegistration. Opcional: ViewContent, AddToCart, InitiateCheckout para correspondência mais rica.
3. Construa o payload do evento. Obrigatório: event_name, event_time, action_source ("website"), event_id (para deduplicação) e user_data (email/telefone/external_id com hash).
4. Faça hash de todos os campos user_data com SHA-256. Email, telefone, nome, cidade, estado, CEP, todos com hash, minúsculos e sem espaços.
5. Faça POST para o endpoint da Graph API. Inclua o token de acesso como parâmetro de consulta ou cabeçalho.
6. Configure lógica de repetição. POSTs com falha (erros 5xx) devem ser repetidos com backoff exponencial até 3 vezes.
7. Registre cada evento para auditoria. Armazene o payload do evento e a resposta do Meta para depurar a atribuição posteriormente.

Deduplicação de Eventos: O Detalhe Crítico

• Gere um event_id único para cada conversão (ex.: seu ID do pedido).
• Envie o mesmo event_id tanto na chamada do pixel do navegador quanto no evento CAPI.
• Confirme se o event_name corresponde exatamente, "Purchase" não "purchase".
• Confirme se o event_time está dentro de 1 minuto entre os dois eventos para deduplicação limpa.
• Use o relatório de Deduplicação do Gerenciador de Eventos para verificar se as proporções estão saudáveis (eventos correspondidos navegador+servidor devem ser o bucket dominante).

Correspondência Avançada: Por Que Identificadores com Hash São Importantes

A CAPI permite que você passe identificadores de usuário (email com hash, telefone, nome, cidade, etc.) em cada evento. O Meta usa esses dados para corresponder a conversão de volta ao usuário que clicou no anúncio, mesmo que o cookie do navegador tenha desaparecido.

• Email (em): O identificador de maior impacto individual. Passe-o em todos os eventos que puder.
• Telefone (ph): Número, sem formatação, com código do país (ex.: 14155551234).
• Nome (fn) e sobrenome (ln): Em minúsculas.
• Cidade (ct), estado (st), CEP (zp), país (country): Tudo em minúsculas, sem espaços.
• ID Externo (external_id): Seu ID interno do cliente, com hash. Excelente para corresponder compradores recorrentes.
• ID do Clique (fbc) e ID do Navegador (fbp): Capture dos cookies do navegador e passe em cada evento do servidor para correspondência mais forte.

Validando se a CAPI Está Funcionando

1. Gerenciador de Eventos → guia Diagnóstico. Não deve mostrar avisos críticos.
2. Gerenciador de Eventos → Qualidade do Evento / Qualidade da Correspondência do Evento. Busque 7+ em uma escala de 10 pontos.
3. Gerenciador de Eventos → Gráfico de Barras de Eventos Recebidos. Confirme se as barras do Navegador e do Servidor estão preenchidas.
4. Testar Eventos. Gere um test_event_code, dispare uma conversão real e veja-a chegar em tempo real.
5. Após 7 dias: Compare as conversões atribuídas no Gerenciador de Anúncios antes e depois da CAPI. Um aumento de 20%+ nas conversões atribuídas confirma que a CAPI está recuperando dados.

A CAPI não é mais opcional. Os anunciantes que usam apenas Pixel em 2026 estão competindo com uma mão amarrada nas costas. Escolha o caminho de instalação que corresponde à sua pilha, deduplique corretamente e valide com a Qualidade da Correspondência do Evento. Dois dias de trabalho compensam permanentemente.