Conversions API (CAPI) para afiliado Shopee: guia

Guia · atualizado em 15/06/2026

Se você roda tráfego pago no Meta para promover produtos da Shopee, provavelmente já sentiu que o Facebook "não enxerga" suas vendas. A Conversions API (CAPI) para afiliado Shopee existe exatamente para resolver isso: em vez de depender só do pixel no navegador do comprador, ela envia o evento de venda direto do servidor para o Meta, com os dados que o algoritmo precisa para otimizar suas campanhas. Neste guia você vai entender o que é a CAPI, por que o pixel sozinho não funciona no fluxo de afiliado, e como eventos server-side melhoram a entrega dos seus anúncios.

O que é a Conversions API (CAPI)?

A Conversions API é um canal do Meta que recebe eventos (como uma compra) diretamente de um servidor, e não do navegador do usuário. O pixel tradicional é um trecho de código que dispara eventos a partir do site que a pessoa está visitando. A CAPI faz o mesmo trabalho, mas pela "porta dos fundos": um servidor confiável avisa o Meta que uma conversão aconteceu.

Na prática, os dois trabalham juntos. O pixel cobre o que acontece no navegador (cliques, visualizações), e a CAPI garante que o evento mais importante — a venda — chegue ao Meta de forma estável, mesmo quando o navegador bloqueia rastreamento ou a compra acontece num app.

Por que isso importa tanto para afiliado?

Porque o seu negócio depende inteiramente de o Meta saber quais anúncios geram venda. Se o algoritmo recebe os eventos de compra certos, ele aprende a entregar seus anúncios para quem tem mais chance de comprar. Sem esse retorno, ele otimiza no escuro — e você paga mais por resultado.

Por que o pixel sozinho não basta para afiliado Shopee

O pixel foi feito para quem é dono da loja e controla o site inteiro, do anúncio até a página de "compra concluída". O afiliado Shopee está numa situação diferente: você manda tráfego para a Shopee, mas a venda acontece dentro do ambiente da Shopee, que é da Shopee — não seu. Você não consegue colar o seu pixel na página de checkout deles.

Isso cria três problemas concretos:

• A compra acontece fora do seu domínio. O pixel não tem como disparar um evento de Purchase no checkout da Shopee, porque você não controla aquela página.
• Boa parte da compra ocorre no aplicativo. Muita gente clica no anúncio, vai para o navegador e finaliza no app da Shopee. O pixel do navegador perde esse rastro.
• Navegadores e bloqueadores limitam o rastreamento client-side. Restrições de cookies e privacidade derrubam parte dos eventos que dependem só do navegador.

O resultado é o cenário clássico: você sabe que vendeu (a Shopee mostra a comissão), mas o Gerenciador de Anúncios marca pouca ou nenhuma conversão. Se você já passou por isso, vale a leitura do guia sobre por que o pixel do Meta não rastreia vendas da Shopee.

Como a CAPI resolve o problema com eventos server-side

A ideia é simples de explicar, ainda que tenha detalhes técnicos por trás. Em vez de esperar o navegador disparar a venda, um servidor recebe a confirmação de que a compra Shopee aconteceu e envia o evento Purchase para o Meta via Conversions API. Esse evento server-side carrega as informações que o algoritmo usa para otimizar.

O papel do fbclid e do Sub_ID

Para o Meta saber qual anúncio gerou a venda, o evento precisa de uma "pegada" do clique. Quando alguém clica no seu anúncio, o Meta adiciona um identificador chamado fbclid à URL. A peça-chave é capturar esse fbclid e amarrá-lo à venda Shopee.

É aqui que entra o Sub_ID da Shopee: ele permite carregar uma identificação junto do link de afiliado, de modo que, quando a venda for confirmada, dá para reconciliar aquela comissão com o clique original (e, portanto, com o anúncio, adset e campanha). Esse é o coração da atribuição. Se quiser se aprofundar, veja o guia de como usar o Sub_ID da Shopee para atribuição.

Com o fbclid amarrado à venda e enviado via CAPI, o evento Purchase deixa de ser anônimo: o Meta consegue conectar a conversão ao anúncio exato que a originou.

Deduplicação: o que é event_id e por que ele existe

Quando você usa pixel e CAPI ao mesmo tempo, surge um risco óbvio: o mesmo evento ser contado duas vezes. Imagine o pixel disparar um Purchase e a CAPI enviar outro Purchase da mesma venda — o Meta acharia que houve duas compras.

A solução é a deduplicação por event_id. Cada evento recebe um identificador único. Quando o pixel e a CAPI enviam o mesmo event_id, o Meta entende que se trata da mesma conversão e conta apenas uma vez. Em resumo:

• event_id igual nos dois canais = o Meta deduplica e conta uma única venda.
• Isso permite ter o melhor dos dois mundos: a cobertura do server-side sem inflar os números.

Para o afiliado Shopee, na prática, o canal mais confiável tende a ser o server-side, já que o pixel raramente consegue capturar a compra dentro da Shopee. A deduplicação garante que, se algum sinal client-side existir, ele não duplique a contagem.

A janela de 7 dias: por que o tempo importa

O Meta tem uma regra importante: eventos enviados via Conversions API devem chegar dentro de uma janela de 7 dias a partir de quando aconteceram para serem aproveitados na atribuição e otimização. Eventos muito atrasados perdem valor para o algoritmo.

Isso é especialmente relevante no fluxo de afiliado, porque a confirmação da venda Shopee nem sempre é instantânea. Por isso, o ideal é um processo que capture a venda e a envie ao Meta o mais rápido possível, sempre dentro dessa janela. Quanto mais fresco o dado, melhor o aprendizado da campanha.

Juntando tudo: o fluxo completo para o afiliado

Resumindo o caminho que um evento percorre, do clique à otimização:

1. O usuário clica no seu anúncio no Meta; o fbclid entra na URL.
2. Ele segue para a Shopee pelo seu link de afiliado, que carrega um Sub_ID.
3. A compra é concluída na Shopee (muitas vezes no app).
4. A venda é reconciliada ao clique original via Sub_ID + fbclid.
5. Um evento Purchase server-side é enviado ao Meta via CAPI, com event_id para deduplicação, dentro da janela de 7 dias.
6. O Meta atribui a venda ao anúncio/adset/campanha certos e otimiza a entrega.

Montar esse fluxo manualmente é trabalhoso e exige integração técnica. É justamente o que o Pixel do Afiliado automatiza: ele captura o clique, amarra a venda Shopee ao anúncio exato, envia o Purchase via Conversions API com deduplicação e ainda calcula o seu ROAS real — assunto do guia de como calcular o ROAS de afiliado Shopee.

Comece a enviar suas conversões via CAPI

Você não precisa programar nada nem montar servidor para usar a Conversions API no seu fluxo de afiliado Shopee. O Pixel do Afiliado faz a ponte entre a venda da Shopee e o seu pixel do Meta, com eventos server-side, deduplicação por event_id e atribuição até o anúncio. Tem 3 dias grátis para testar com as suas próprias campanhas. Crie sua conta e comece o teste grátis agora e veja seus anúncios sendo otimizados com dados de venda de verdade.