Facebook Conversions API: Guia de Implementação para 2026

Por Marcus Chen

Especialistas em Performance Marketing Revisto por Media Buyers Sénior

Resposta Rápida IA

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

Publicado a 10 julho 2026

Leitura de 12 min · Configuração

A Conversions API (CAPI) do Facebook é o complemento do lado do servidor para o pixel do navegador. Após o iOS 14.5 ter destruído o tracking baseado no navegador, a CAPI tornou-se a única forma de recuperar as conversões que a Meta estava a perder. Em 2026, os anunciantes que utilizam apenas Pixel estão a deixar 30-60% das conversões atribuídas na mesa. 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 a Meta, ignorando completamente o navegador. Isto significa que os eventos chegam mesmo quando o pixel do navegador está bloqueado, quando o dispositivo iOS do utilizador limita o tracking, ou quando as condições de rede quebram o pixel.

• Recupera conversões iOS. Utilizadores restritos pelo ATT ainda acionam eventos do servidor.
• Ignora bloqueadores de anúncios. Eventos servidor-a-servidor não são bloqueados.
• Maior qualidade de dados. Eventos do servidor podem incluir identificadores primários (email hashed, telefone, ID de cliente) para um matching mais forte.
• Melhor desduplicação. Quando emparelhado com o Pixel usando event_id, a Meta desduplica 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 Meta CAPI. Ative no seu painel de administração da plataforma, cole o token de acesso, está feito. Melhor para equipas não técnicas.

2. Gestor de tags do lado do servidor (recomendado)

Use o Stape ou o Google Tag Manager Server-Side para disparar eventos CAPI a partir de um contentor sGTM. Obtém controlo total de eventos, desduplicação e Advanced Matching sem escrever código de servidor. Padrão da indústria para operadores sérios.

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

Envie pedidos POST diretamente para https://graph.facebook.com/v18.0/{pixel_id}/events a partir do seu backend. Melhor para SaaS, aplicações personalizadas e qualquer coisa não construída numa grande plataforma de comércio.

Passo a Passo: Implementação Direta da API

1. Gere um token de acesso CAPI. Events Manager → o seu pixel → Definições → Conversions API → Generate Access Token.
2. Escolha os eventos a enviar do lado do servidor. Envie sempre Purchase, Lead e CompleteRegistration. Opcional: ViewContent, AddToCart, InitiateCheckout para um matching mais rico.
3. Construa o payload do evento. Obrigatório: event_name, event_time, action_source ("website"), event_id (para desduplicação) e user_data (email/telefone/external_id hashed).
4. Faça hash de todos os campos user_data com SHA-256. Email, telefone, nome, cidade, estado, código postal, tudo hashed, minúsculas, 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 falhados (erros 5xx) devem repetir com backoff exponencial até 3 vezes.
7. Registe cada evento para auditoria. Armazene o payload do evento e a resposta da Meta para poder depurar a atribuição mais tarde.

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

• Gere um event_id único para cada conversão (ex.: o seu ID de pedido).
• Envie o mesmo event_id tanto na chamada do pixel do navegador como no evento CAPI.
• Confirme que o event_name corresponde exatamente, "Purchase" não "purchase".
• Confirme que o event_time está dentro de 1 minuto entre os dois eventos para uma desduplicação limpa.
• Use o relatório de Desduplicação do Events Manager para verificar se os rácios estão saudáveis (eventos correspondidos navegador+servidor devem ser o balde dominante).

Advanced Matching: Porque É Que os Identificadores Hashed São Importantes

A CAPI permite-lhe passar identificadores de utilizador (email hashed, telefone, nome, cidade, etc.) em cada evento. A Meta usa estes para corresponder a conversão de volta ao utilizador 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).
• Primeiro nome (fn) e último nome (ln): Minúsculas.
• Cidade (ct), estado (st), código postal (zp), país (country): Tudo minúsculas, sem espaços.
• ID Externo (external_id): O seu ID de cliente interno, hashed. Excelente para corresponder compradores recorrentes.
• Click ID (fbc) e Browser ID (fbp): Capture dos cookies do navegador e passe em cada evento do servidor para um matching mais forte.

Validar Que a CAPI Está a Funcionar

1. Events Manager → Separador Diagnostics. Não deve mostrar avisos críticos.
2. Events Manager → Event Quality / Event Match Quality. Aponte para 7+ numa escala de 10 pontos.
3. Events Manager → Gráfico de Barras Events Received. Confirme que ambas as barras Browser e Server estão preenchidas.
4. Test Events. Gere um test_event_code, dispare uma conversão real e veja-a aterrar em tempo real.
5. Após 7 dias: Compare as conversões atribuídas no Ads Manager antes e depois da CAPI. Um aumento de 20%+ nas conversões atribuídas confirma que a CAPI está a recuperar dados.

A CAPI já não é opcional. Os anunciantes que utilizam apenas Pixel em 2026 estão a competir com uma mão atrás das costas. Escolha o caminho de instalação que corresponde à sua stack, desduplique corretamente e valide com Event Match Quality. Dois dias de trabalho compensam permanentemente.