Meta Conversions API para afiliados: configurar e deduplicar

A Meta Conversions API (CAPI) é o canal servidor a servidor da Meta para eventos de conversão. Seu tracker ou servidor envia um cadastro ou um depósito direto para a Meta, de modo que a otimização não depende de um pixel de navegador disparar em uma página que você controla. Para afiliados, cujas conversões acontecem no site de um operador, muitas vezes é a única forma de reportá-las.

Este guia cobre esse caso: você é dono do anúncio e da landing page, o operador é dono do cadastro e do caixa, e a conversão chega até você como postback.

O que é a Meta Conversions API

A Meta descreve a Conversions API como uma conexão entre os dados de marketing de um anunciante e os sistemas da Meta. Os dados podem vir de um servidor, de uma plataforma de site, de um app mobile ou de um CRM, e podem abranger eventos do site, eventos de app, eventos de mensagens comerciais e conversões offline.

Antes ela se chamava Facebook Conversions API e, antes ainda, Server-Side API. “Facebook conversion API”, “conversion API Meta” e “CAPI” se referem todos ao mesmo endpoint da Marketing API da Meta.

Dois termos importam para a configuração:

• Dataset. Os eventos de servidor são vinculados a um ID de dataset no Events Manager. O dataset também guarda o seu Meta Pixel, e a Meta orienta usar o mesmo Pixel ID para eventos de navegador e de servidor.

• Eventos offline. A Meta lista as conversões offline entre os dados que a Conversions API transporta, então a “Meta offline conversions API” está documentada no mesmo lugar.

Como a CAPI funciona para afiliados

Um funil de afiliado cruza dois domínios, e só um é seu, então o seu tracker repassa cada conversão para a Meta:

1. Clique. Um usuário clica no seu anúncio. A Meta adiciona um parâmetro fbclid à URL da landing page.

2. O tracker registra o clique. Ele armazena o próprio click ID junto com o fbclid, o endereço IP do visitante, o user agent e o timestamp, e depois passa o click ID para o link do operador como sub-ID.

3. Conversão no site do operador. O jogador se cadastra e faz um primeiro depósito. O operador registra os dois vinculados ao seu sub-ID.

4. Postback. O sistema do operador chama o seu tracker com o sub-ID e o tipo de evento. Nosso guia de rastreamento por postback explica como essa chamada é montada.

5. O tracker chama a Meta. O tracker encontra o clique armazenado, converte o fbclid no valor fbc que a Meta espera (um prefixo fb., um índice de subdomínio, um timestamp de criação e o fbclid, unidos por pontos) e envia o evento com nome, horário, ID e dados do usuário.

6. A Meta tenta fazer o match. Ela procura a pessoa que viu o anúncio ou clicou nele; as conversões com match aparecem nos relatórios e alimentam a entrega.

O ponto fraco é a etapa 2. A Meta ainda aceita um evento de um clique salvo sem o fbclid, mas tem pouco com que fazer o match, a menos que você também envie dados de contato.

Meta Pixel vs. Conversions API

O Pixel roda no navegador do visitante e reporta o que acontece naquela página. A CAPI é uma requisição que o seu próprio sistema envia assim que fica sabendo de uma conversão, onde quer que ela tenha acontecido.

A página de boas práticas da Meta recomenda usar a Conversions API além do Pixel e compartilhar os mesmos eventos pelos dois. Os afiliados precisam adaptar isso, porque o Pixel não consegue ver os eventos que pagam.

Meta Pixel ou Conversions API: de qual você precisa?

A maioria dos afiliados de iGaming precisa dos dois: o Pixel para o comportamento na página, a CAPI para cadastros e depósitos. A pergunta decisiva é onde a conversão é registrada.

• No site do operador. É a maior parte do tráfego de afiliados de cassino e apostas esportivas. O Pixel só vê as suas páginas, então, sem a CAPI, você otimiza para cliques de saída, e a Meta aprende a encontrar pessoas que clicam, e não pessoas que depositam.

• Tráfego principalmente de iPhone e Safari. Os limites de privacidade do navegador reduzem quanto tempo os cookies duram e quanto um pixel consegue reportar, então o sinal do servidor ganha mais peso.

• Alto volume. Cada evento que falta é sinal que o sistema de entrega nunca recebe, e a entrega se apoia nesse sinal, como explica nosso guia sobre o Meta Andromeda.

• Um teste pequeno em um formulário seu. Se o lead é capturado em uma única etapa na sua própria página, o Pixel sozinho basta para começar. Adicione a CAPI quando o teste conquistar um orçamento.

Um media buyer que roda ofertas de iGaming na Meta cai no primeiro grupo quase sempre.

Como configurar a Conversions API com um tracker

A configuração com um tracker tem quatro etapas: dataset, método de conexão, eventos e token, depois as configurações do tracker e um evento de teste. As telas do Events Manager mudam, então confira à medida que avança.

1. Escolha ou crie o dataset

Você precisa de uma Meta Business Suite e de um Pixel ID. No Events Manager, conecte uma fonte de dados web ou reutilize o dataset que já guarda o seu Pixel. Conecte a esse dataset todas as contas de anúncios que vão otimizar com esses eventos.

2. Escolha o método de conexão

A central de ajuda da Meta lista três caminhos: uma integração de parceiro, uma opção habilitada pela Meta para eventos web e a configuração manual. A Meta também oferece um Conversions API Gateway, e algumas equipes usam tagueamento do lado do servidor, como um contêiner do Google Tag Manager do lado do servidor.

Para um tracker que recebe postbacks do operador, a configuração manual é a que serve: os eventos nascem dos postbacks, então o próprio tracker monta as requisições. O Gateway, hospedado em uma conta de nuvem sua, recebe os eventos dos navegadores por meio do Pixel, não do postback de um operador. Um contêiner de tags do lado do servidor poderia aceitá-los, mas duplicaria o trabalho do tracker.

3. Eventos e access token

Selecione só os eventos que os seus postbacks conseguem de fato reportar. Um mapeamento comum é CompleteRegistration para um cadastro e Purchase para um primeiro depósito.

Gere o access token no Events Manager, na configuração manual. Só as pessoas com privilégios de desenvolvedor na empresa veem esse link. A Meta então cria para você um app e um usuário do sistema da Conversions API, sem App Review. Se você já tem um app próprio, atribua o Pixel a um usuário do sistema existente no Business Suite e gere o token lá.

Qualquer pessoa com o token pode enviar eventos para o seu dataset. Guarde-o nas configurações do tracker, nunca no código da página nem em uma planilha compartilhada, e troque-o quando alguém com acesso sair.

4. Lado do tracker e eventos de teste

Insira o Pixel ID e o token na integração da Meta do tracker e associe cada status de postback a um nome de evento. Confirme que o tracker armazena fbclid, IP e user agent no momento do clique e envia esses dados, e não o IP do próprio servidor.

Todo evento também precisa de action_source, que a Meta marca como obrigatório; para um funil web, o valor usual é website. Ao usar a API, você concorda que o valor é preciso até onde você sabe.

Para eventos do site, defina event_source_url como a sua própria landing page: a Meta exige isso e diz que o valor deve corresponder ao seu domínio verificado, então a URL do operador não cabe ali. Depois envie uma conversão de teste e confira no Events Manager se ela chega, é deduplicada e tem match.

Deduplicação: como evitar eventos contados em dobro

A Meta conta um evento de navegador e um evento de servidor como uma única conversão quando o eventID do Pixel é igual ao event_id do servidor e o evento do Pixel é igual ao event_name. Em torno dessa correspondência:

• Janela de 48 horas. A Meta só deduplica eventos recebidos dentro de 48 horas; uma cópia posterior com o mesmo ID conta de novo.

• Vale o primeiro recebido. Quando as duas cópias não diferem de forma significativa, a Meta geralmente mantém a que recebeu primeiro.

• Um segundo método. A Meta também faz o match por event_name mais fbp e/ou external_id, usados de forma consistente dos dois lados. Em geral, isso só funciona quando o evento de navegador é enviado primeiro; um evento de servidor sem evento de navegador nas 48 horas anteriores é mantido.

• Uma fonte, sem dedup. A Meta não deduplica um fluxo só de navegador ou só de servidor. Dois eventos de servidor idênticos são ambos mantidos.

Onde as configurações de afiliados quebram:

1. Um nome, duas ações. O Pixel dispara Lead quando um visitante clica para ir ao operador, e o tracker envia Lead para cadastros. A Meta passa a aprender com duas ações diferentes sob um mesmo rótulo. Dê a cada ação o seu próprio nome.

2. IDs que nunca se encontram. A página cria um event_id e o tracker cria outro. A dedup precisa do mesmo nome de evento e do mesmo ID dos dois lados; uma divergência em qualquer um deles deixa dois eventos. Se uma ação realmente dispara nos dois lugares, gere o ID uma única vez, no clique ou na página, e passe exatamente esse valor para o Pixel e para o postback.

3. Postbacks atrasados. Os depósitos costumam ser confirmados dias depois do clique. Um postback que chega depois de 48 horas já não pode ser mesclado com um evento de navegador anterior, então os dois contam. Mantenha os eventos de nível de depósito só no servidor.

4. Postbacks repetidos. Operadores reenviam postbacks ou mandam atualizações de status para o mesmo jogador. Duplicatas só de servidor são mantidas, então o tracker precisa enviar cada tipo de evento uma vez por clique.

5. Eventos antigos. O event_time pode ter no máximo sete dias. Se um evento de uma requisição for mais antigo, a Meta retorna erro para a requisição inteira e não processa nada dela, então envie os eventos conforme chegam, em vez de juntar um acúmulo em lote.

O Ads Manager conta as conversões de acordo com a sua configuração de atribuição, então nunca vai bater exatamente com uma contagem de postbacks. Levando isso em conta, compare cadastros e depósitos por campanha nos mesmos poucos dias: um excedente persistente na Meta indica duplicatas; um déficit persistente, eventos rejeitados ou sem match. Eventos inflados ou inventados corrompem a otimização e colocam a conta de anúncios em risco, e os operadores procuram os mesmos padrões, como abordado em fraude de afiliados no iGaming.

A CAPI de um clique da Meta e os postbacks do tracker

A documentação da Meta diz que, se você tem um Pixel, pode configurar a Conversions API com a Meta para eventos do site em um clique, sem código, sem configuração e sem taxas de implementação. Ela é construída sobre o seu Pixel e cobre apenas eventos do site. Para uma loja com checkout próprio, isso é o funil inteiro; para um afiliado, é a landing page, e os cadastros e depósitos no domínio do operador continuam vindo só dos postbacks do tracker.

O risco é a sobreposição. A Meta só mescla eventos pelas regras acima, então um evento do tracker com o próprio event_id não vai se mesclar com uma cópia baseada no Pixel da mesma ação. Antes de ativá-la ao lado de uma integração de tracker, dê a cada ação um nome e um ID compartilhado e depois compare o tracker com o Ads Manager por alguns dias.

Event Match Quality

A Event Match Quality (EMQ) é uma pontuação de até 10 que a Meta mostra por evento no Events Manager. Ela indica o quanto as informações do cliente dos seus eventos de servidor são úteis para o match, e atualmente cobre só eventos web. A Meta diz que enviar mais parâmetros de informações do cliente pode aumentá-la e cita como exemplos e-mail, endereço IP, nome e número de telefone.

Para um afiliado, os parâmetros utilizáveis são:

• fbc, montado a partir do fbclid armazenado. A chave mais diretamente ligada ao clique no anúncio.

• fbp, o cookie de navegador do Pixel, se a sua landing page o define e o tracker o captura.

• Endereço IP e user agent do clique. O user agent é obrigatório para eventos do site.

• E-mail e telefone, só se o operador os repassar e os seus termos permitirem.

A página de parâmetros de informações do cliente da Meta define as regras de tratamento. Normalize os dados de contato (e-mail sem espaços e em minúsculas, telefone em dígitos com o código do país) e depois gere o hash com SHA-256. IP, user agent, fbc e fbp vão sem hash. Dados de contato com hash continuam sendo dados pessoais, então envie só o que a sua política de privacidade e os termos do programa permitem compartilhar.

Anúncios de jogos de azar: o que a CAPI não muda

A política Online Gambling and Games da Meta só permite anúncios de jogos de azar e de jogos quando a conta de anúncios tem a autorização da Meta. Isso inclui anúncios cujas landing pages promovem jogos de azar sem oferecê-los, e a política cita sites de afiliados e agregadores como exemplos.

Os anunciantes pedem a autorização na aba Authorizations and Verifications do Meta Business Suite, com provas de que a atividade é licenciada ou legal de outra forma onde querem segmentar. Antes de segmentar uma nova jurisdição pela primeira vez, precisam declarar essa intenção. Anúncios autorizados não podem segmentar menores de 18 anos nem os mercados que a Meta lista como não suportados. Para campanhas nos EUA, a legalidade varia de estado para estado, como mostra nosso panorama sobre jogos de azar online nos EUA.

O tracking do lado do servidor mede resultados; ele não autoriza anúncios. Este é um resumo da política publicada pela Meta em outubro de 2026, não aconselhamento jurídico.

Checklist antes do lançamento

Antes do lançamento, confirme que cada evento chega à Meta uma vez, com os dados do clique, um nome próprio e um ID compartilhado:

• Todas as contas de anúncios que otimizam estão conectadas ao dataset.

• O token fica só no tracker.

• Cada evento leva fbc, IP e user agent do clique, além de action_source.

• Cada ação tem o seu próprio nome de evento. Onde o Pixel e o tracker a reportam, os dois enviam o mesmo nome e o mesmo event_id.

• O tracker envia um evento por tipo por clique, em tempo real.

• event_source_url aponta para o seu domínio de landing page.

• Um evento de teste chegou e teve match, e há uma comparação regular entre o tracker e o Ads Manager agendada.

Perguntas frequentes

O que é a Meta Conversions API (CAPI)?

A Conversions API é a API da Meta para enviar eventos de conversão dos seus próprios sistemas, como um servidor, tracker ou CRM, diretamente para a Meta. A Facebook Conversions API é o mesmo produto com o nome anterior.

Como rastrear conversões de anúncios da Meta sem um pixel na oferta?

O seu tracker armazena o fbclid de cada clique no anúncio, passa o seu click ID para o operador como sub-ID e encaminha o postback do operador para a Conversions API com os dados do clique armazenados.

Posso usar só a CAPI, sem o Pixel?

A CAPI funciona sem o Pixel, e para os eventos do lado do operador é isso que você faz de qualquer jeito. Mesmo assim, mantenha o Pixel na sua landing page: sem ele não existe o cookie fbp para os seus eventos de servidor levarem como chave de match, e a Meta recomenda usar os dois.

A Meta tem uma API, e a Conversions API é gratuita?

Sim: a Conversions API faz parte da Marketing API da Meta. A Meta descreve a opção de um clique como livre de taxas de implementação. Uma integração direta custa o que custar o seu tracker, servidor ou ferramenta de parceiro.

O que acontece se eu ativar a CAPI de um clique além dos postbacks do tracker?

A CAPI de um clique cobre eventos do site ligados ao seu Pixel, não conversões no site do operador. A contagem dupla aparece quando o Pixel e o tracker reportam a mesma ação com IDs ou nomes diferentes; alinhe isso primeiro e depois compare o tracker com o Ads Manager.

O que é Event Match Quality e por que ela importa?

A Event Match Quality é a pontuação de até 10 da Meta para o quanto os dados do cliente dos seus eventos de servidor podem ser associados a pessoas. Eventos que não podem ser associados têm pouco peso nos relatórios e na otimização.

Fontes

• Meta, Conversions API overview

• Meta, Get started with the Conversions API

• Meta, Deduplicate Pixel and server events

• Meta, Server event parameters

• Meta, Customer information parameters

• Meta, Conversions API best practices

• Meta, Conversions API Gateway

• Meta Business Help Center, Set up and install the Meta Pixel

• Meta Transparency Center, Online Gambling and Games (checked October 28, 2026)

• Meta Business Help Center, Apply for permission to promote online gaming or gambling