Adwize

Guia de rastreamento da Meta 2026

A API de Conversões da Meta, explicada.
O que ela envia, por que anda junto com o pixel, como configurar.

O que é a API de Conversões (CAPI), como funcionam a desduplicação com event_id e a Qualidade da Correspondência de Eventos, e as quatro formas que a Meta oferece para configurá-la. Verificado na documentação da Meta.

O que é a API de Conversões da Meta, e você precisa dela?

A API de Conversões da Meta (CAPI, ou Conversions API) envia eventos de conversão para a Meta a partir do seu servidor, da plataforma do seu site, do seu app ou do seu CRM, sem depender só do navegador do visitante como o Pixel da Meta.

Ler a resposta completa

A Meta recomenda usar os dois, uma configuração que ela chama de redundante: o pixel e a API de Conversões compartilham os mesmos eventos, e a API de Conversões pode captar eventos do site que o pixel perde por falhas de rede ou de carregamento da página. Para não contar uma compra duas vezes, dê às cópias do navegador e do servidor o mesmo nome e o mesmo ID de evento; a Meta fica com uma delas se as duas chegarem em até 48 horas. A Qualidade da Correspondência de Eventos (Event Match Quality), uma nota de 1 a 10, mostra o quanto as informações do cliente enviadas associam os eventos a contas da Meta. Você pode configurar a API de Conversões com um parceiro como a Shopify em poucos cliques, com o Gateway da API de Conversões sem código ou com uma integração direta feita por um desenvolvedor.

Como a Meta transforma duas cópias de uma compra em uma só?

A mesma compra chega duas vezes à Meta: uma pelo navegador, outra pelo seu servidor. A Meta conta uma vez só quando o nome e o ID correspondem.

Exemplo

Navegador · Pixel da Meta

event
"Purchase"
eventID
"order-1042"

Servidor · API de Conversões

event_name
"Purchase"
event_id
"order-1042"

1 compra contada

Mesmo nome de evento e mesmo ID de evento, recebidos em menos de 48 horas: a Meta fica com o primeiro.

O que é a API de Conversões da Meta?

A API de Conversões da Meta é uma conexão direta entre os seus dados de marketing e os sistemas de anúncios da Meta. Em vez de depender só de código no navegador do visitante, ela envia eventos como compras, cadastros ou adições ao carrinho a partir do seu servidor, da plataforma do site, do app ou do CRM, para que a Meta meça e otimize os seus anúncios.

Ler mais

A Meta a apresenta como uma forma de otimizar a segmentação dos anúncios, reduzir o custo por resultado e medir resultados em todas as suas tecnologias. Uma única API transporta eventos do site, eventos do app, conversões offline e eventos de mensagens. Você vai vê-la abreviada como CAPI, e muitas vezes chamada de API de Conversões do Facebook.

A Meta também informa que a API de Conversões Offline foi descontinuada em maio de 2025: os eventos offline agora passam pela API de Conversões, para conjuntos de dados.

Por que usar a API de Conversões além do pixel?

Porque o pixel sozinho perde eventos. As boas práticas da Meta dizem que a API de Conversões pode captar eventos do site que o pixel deixa escapar por problemas de rede ou erros de carregamento da página. A Meta recomenda uma configuração redundante: envie os mesmos eventos, como compra, início do checkout ou contato, pelo pixel e pela API de Conversões.

Ler mais

A Meta dá até uma meta para essa paridade: buscar uma cobertura de 75% de eventos da API de Conversões em relação aos eventos do Pixel da Meta. Você acompanha essa taxa no Gerenciador de Eventos.

A Meta também pede que você compartilhe os eventos em tempo real, ou o mais perto possível disso, para que o sistema de veiculação consiga avaliar quem tem mais chance de agir depois de ver um anúncio.

Como funciona a desduplicação com event_id?

Quando o pixel e a API de Conversões informam a mesma compra, a Meta precisa saber que é uma compra, não duas. Ela compara dois campos: o eventID do pixel precisa corresponder ao event_id da API de Conversões, e o event do pixel ao event_name. Quando os dois correspondem, a Meta fica com um evento e descarta o duplicado.

Ler mais

A Meta só desduplica eventos recebidos nas 48 horas seguintes ao primeiro e, em geral, fica com o que recebeu primeiro.

A Meta documenta um segundo método, que envia os mesmos valores fbp ou external_id das duas fontes, mas ele só funciona quando o evento do navegador chega antes do evento do servidor. A Meta recomenda o método do ID e do nome de evento.

Os duplicados que escapam inflam as conversões informadas, e o seu ROAS junto. Se os seus números parecem bons demais, ou caem de repente, leia o seu relatório da Meta linha por linha.

O que é a Qualidade da Correspondência de Eventos?

A Qualidade da Correspondência de Eventos (Event Match Quality) é uma pontuação de 1 a 10 que mostra o quanto as informações do cliente enviadas com os seus eventos de servidor os associam a contas da Meta. A Meta calcula essa nota pela qualidade dessas informações e pela parcela de eventos associados, com os dados das últimas 48 horas, por isso os eventos precisam chegar com regularidade.

Ler mais

Ela vale para eventos do site enviados pela API de Conversões com a origem da ação definida como Site. A Meta diz que uma correspondência melhor ajuda a mostrar os anúncios para pessoas com mais chance de converter e a atribuir as conversões aos seus anúncios, e pode aumentar as conversões adicionais informadas.

Para subir a nota, envie mais parâmetros de informações do cliente, com hash, como explica a documentação para desenvolvedores da Meta, e só com as autorizações e os consentimentos legais necessários. A Meta ordena a prioridade deles:

  • Alta: e-mail e ID de clique.
  • Média: ID do Login do Facebook, data de nascimento, país, número de telefone, ID externo e ID do navegador.
  • Baixa: ID do cadastro, nome, sobrenome, cidade e CEP.

Como você configura a API de Conversões?

A Meta lista vários caminhos e diz que muitos não precisam de desenvolvedor. O certo depende de onde o seu site roda e de quem cuida dele: um parceiro de plataforma de e-commerce, a API de Conversões ativada pela Meta com um clique, o Gateway da API de Conversões sem código ou uma integração direta programada sobre a API.

Ler mais
  • Integrações de parceiros. Na Shopify, WooCommerce, Wix ou BigCommerce, a Meta diz que a configuração leva poucos cliques, sem custo adicional. Adobe, Google Tag Manager, Tealium e outros parceiros também podem conectá-la.
  • API de Conversões ativada pela Meta. Uma opção só para web que cria a conexão do lado do servidor com um clique, de graça, e envia os mesmos eventos e parâmetros do seu pixel, desduplicados automaticamente.
  • Gateway da API de Conversões. Uma configuração sem código que você escolhe no Gerenciador de Eventos, hospedada na sua própria conta AWS ou Google Cloud. A Meta diz que ele reduz a configuração de semanas para menos de 30 minutos e desduplica automaticamente; as taxas de nuvem, seu único custo, começam em 30 $ por mês.
  • Integração direta. Um desenvolvedor envia os seus eventos para a API. A Meta estima de 2 a 4 semanas para uma nova integração, e é a única opção para eventos de app e de loja física.

A Meta sugere o Gateway se você já usa o pixel, ainda não envia eventos web pela API de Conversões, investe mais de 300 $ por mês em campanhas otimizadas para eventos web e não trabalha com um parceiro de e-commerce. Se um parceiro como a Shopify já gerencia o seu pixel, a Meta recomenda a integração desse parceiro.

Opções de configuração da API de Conversões, comparadas pela Meta
OpçãoQuem configuraCustoEventosDesduplicação
Parceiro de e-commerce (Shopify, WooCommerce…)Você, em poucos cliquesSem custo adicionalDepende do parceiroDepende do parceiro
API de Conversões ativada pela MetaVocê, com um cliqueGrátisSó webAutomática
Gateway da API de ConversõesVocê, sem códigoTaxas de nuvem, a partir de 30 $ por mêsWebAutomática
Integração diretaUm desenvolvedor, de 2 a 4 semanasSeu desenvolvimento e manutençãoWeb, app, offline, CRM, mensagensVocê envia o event_id

Custos e prazos são números da própria Meta. As taxas de nuvem do Gateway variam conforme a sua região e o seu tráfego.

Como verificar no Gerenciador de Eventos se a API de Conversões funciona?

Abra o Gerenciador de Eventos, vá em Data Sources, escolha o pixel para o qual seu servidor envia eventos e clique em Overview. A Meta diz que você deve conseguir verificar os eventos do servidor em até 20 minutos após o envio. O Overview conta os eventos que a Meta recebeu e, em Connection Method, mostra o canal pelo qual cada evento foi enviado. Clique em um evento para ver os detalhes.

Ler mais

Antes de confiar nos dados reais, use a ferramenta Test Events: Gerenciador de Eventos > Data Sources > seu pixel > Test Events. Ela gera um ID de teste que você envia com seus eventos do servidor no parâmetro test_event_code; esses eventos aparecem então na janela Test Events. A Meta cita três usos: confirmar que seus eventos do servidor estão configurados e sendo recebidos, verificar a desduplicação vendo quais eventos foram processados e quais foram desduplicados, e depurar atividades incomuns.

A Meta faz duas ressalvas. Remova o test_event_code ao terminar os testes: os eventos enviados com ele não são descartados, eles entram no Gerenciador de Eventos e são usados para segmentação e mensuração de anúncios. E teste com suas próprias informações de cliente, como nome, e-mail ou telefone, porque eventos de teste podem ser rejeitados se não corresponderem a uma conta do Facebook ou da Meta.

Para ver a desduplicação nos dados reais, abra Event Details de um tipo de evento a partir do Overview e vá até a aba Event Deduplication. Ela mostra a taxa de eventos desduplicados de cada fonte, em que, segundo a Meta, quanto maior melhor, com um aviso quando a taxa está baixa demais, e a taxa de uso das chaves de desduplicação. Um Overlap baixo, explica a Meta, significa que uma ou as duas fontes enviam chaves não exclusivas, ou que só uma fonte envia chave.

A mesma página Event Details tem uma aba Event Freshness, com o atraso médio entre um evento e seu envio, numa escala de Real Time a Weekly. A Meta recomenda compartilhar os eventos o mais perto possível do tempo real.

Quais dados a API de Conversões envia, e o que precisa de hash?

Cada evento do servidor leva o próprio evento, como nome, horário, URL de origem e fonte da ação, mais parâmetros de informações do cliente que ajudam a Meta a associá-lo a uma conta. Os dados de contato precisam ser normalizados e depois criptografados com hash SHA-256: a Meta diz que seus sistemas foram feitos para não aceitar dados de contato sem hash, que ela usa só para a correspondência. Com o SDK da Meta Business, o hash é feito automaticamente.

Ler mais

Primeiro vem a normalização, como detalha a página Customer Information Parameters da Meta. E-mail: tirar os espaços do início e do fim e passar tudo para minúsculas. Telefone: tirar símbolos, letras e zeros à esquerda, e sempre incluir o código do país. País: o código ISO 3166-1 de duas letras em minúsculas, como br.

A Meta divide os parâmetros em três grupos:

  • Com hash SHA-256: e-mail, telefone, nome, sobrenome, data de nascimento, gênero, cidade, estado, CEP e país.
  • Hash recomendado: ID externo, seu próprio identificador de cliente, como um número de fidelidade ou de usuário.
  • Nunca com hash: endereço IP do cliente, user agent do cliente, ID de clique (fbc), ID do navegador (fbp), ID de assinatura, ID do Facebook Login e ID do lead.

O IP e o user agent são adicionados automaticamente aos eventos do navegador, mas a Meta diz que você precisa informá-los nos eventos do servidor, e o user agent é obrigatório para eventos do site. Os valores fbc e fbp vêm de cookies próprios que o pixel define no seu domínio, e a Meta pede que você os atualize com frequência se os enviar.

O hash não substitui o consentimento. Se você controla o que o pixel compartilha conforme o consentimento, a Meta pede que aplique a mesma lógica à API de Conversões. Para usuários nos Estados Unidos, a Meta documenta opções de processamento de dados, adicionadas em cada evento, para ativar o Limited Data Use.

O que ler em seguida?

Eventos limpos são só o ponto de partida. O que conta depois é ler os resultados que eles geram.

A Adwize lê os resultados que os seus eventos geram

A Adwize não configura a API de Conversões. Quando os seus eventos chegam à Meta, a Adwize lê os resultados das suas campanhas, escreve relatórios em linguagem simples e aponta o que sai do esperado. Nada muda até você aprovar.

Perguntas sobre a API de Conversões da Meta

Ainda tem dúvidas? Escreva para a gente. Quem responde é uma pessoa de verdade.

A Meta recomenda manter os dois. As boas práticas dela descrevem uma configuração redundante em que o pixel e a API de Conversões compartilham os mesmos eventos, porque a API de Conversões pode captar eventos que o pixel perde por problemas de rede ou erros de carregamento da página. Depois, a desduplicação fica com uma única cópia de cada evento.

Fontes

Cada fato desta página vem da Central de Ajuda da Meta e do Meta for Developers. A página foi verificada pela última vez em 11 de outubro de 2026; cada fonte mostra a data em que a lemos na íntegra. Quando a Meta muda uma regra ou um número, a página muda junto.

  1. Central de Ajuda do Meta Business: About Conversions API
  2. Central de Ajuda do Meta Business: Compare Conversions API setup options
  3. Central de Ajuda do Meta Business: Best practices for Conversions API
  4. Central de Ajuda do Meta Business: About event match quality
  5. Central de Ajuda do Meta Business: About Conversions API Gateway
  6. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
  7. Meta for Developers: Conversions API Gateway
  8. Meta for Developers: Verifying Your Setup
  9. Meta for Developers: Using the API
  10. Meta for Developers: Best Practices for the Conversions API
  11. Meta for Developers: Customer Information Parameters
  12. Meta for Developers: End-to-End Implementation of the Conversions API

Anúncios na Meta, sem complicação

Lance sua próxima campanha em 2 minutos.

Meta Ads