Conversions API (CAPI) para afiliado Shopee: como funciona

Guia · atualizado em 26/09/2026

O pixel do Meta aprende com as compras que recebe. Para o afiliado da Shopee, ele não recebe nenhuma: a compra acontece numa página que não é sua e, muitas vezes, dentro do app. A Conversions API (CAPI) resolve pelo outro lado: em vez de esperar o navegador do comprador disparar a compra, um servidor avisa o Meta que ela aconteceu. Este guia mostra quais eventos o Pixel do Afiliado envia, em que momento, e como conferir que estão chegando.

Por que o pixel do navegador não vê a venda

O pixel comum é um código que roda na página. Ele dispara "Purchase" quando a pessoa chega na tela de pedido concluído, e essa tela é da Shopee. Você não coloca código ali, e o comprador que fecha no app nem passa por um navegador. Os detalhes estão em por que o pixel do Meta não rastreia a Shopee.

O que você tem é o clique (passa pelo seu link) e o relatório de conversões da Shopee (chega um dia depois, com a comissão). A CAPI é o canal para juntar os dois e entregar ao Meta uma compra que ele consiga ligar ao anúncio.

O que o Pixel do Afiliado envia ao seu pixel

São três eventos, todos enviados pelo Pixel do Afiliado para o pixel que você escolheu na conexão com o Meta.

1. LinkClick, na hora do clique

Quando alguém toca no anúncio e passa pelo link rastreado, o Pixel envia na mesma hora um evento personalizado LinkClick. Ele leva os sinais que o Meta usa para reconhecer quem clicou no anúncio, como o fbclid que o próprio Meta acrescenta ao link, além da campanha, do conjunto, do anúncio e do posicionamento.

2. Purchase, quando a Shopee publica a venda

O Pixel acompanha o relatório de conversões da Shopee ao longo do dia. Cada venda que veio de um clique rastreado é ligada a esse clique, e aí sai um Purchase com:

• value = a sua comissão, em reais, somando os itens do pedido. Não é o preço do produto.
• Os sinais do clique que trouxe a venda, que é o que permite ao Meta ligar a compra a quem clicou.
• Os produtos do pedido e a quantidade, com o nome e a categoria do produto quando a Shopee informa.

Com a primeira venda da tabela abaixo: o pedido do Sérum facial vitamina C de 24/09 teve 2 unidades de R$ 49,90 com 15% de comissão. O Purchase sai com value 14,97, currency BRL e num_items 2, e não com os R$ 99,80 do pedido. A conta é 2 × R$ 49,90 × 15% = R$ 14,97.

Mandar a comissão como valor deixa o valor de conversão do Gerenciador na mesma unidade do ROAS do Pixel: reais que você recebe. É a conta do guia como calcular o ROAS do afiliado Shopee.

3. Refund, se o pedido cair

Se um pedido já enviado como Purchase é cancelado ou marcado como fraude, o Pixel manda um Refund daquela compra para o Meta.

Quando o Purchase é enviado: a janela de 7 dias

O Meta não aceita evento com mais de 7 dias. Na Shopee, um pedido leva de 8 a 15 dias ou mais para passar a "concluído", por causa da entrega e da confirmação. Se o Pixel esperasse a conclusão, o Purchase chegaria sempre fora do prazo.

Por isso ele envia quando o pedido está pendente, ou seja, pago e aguardando conclusão. Pedido não pago nunca dispara. Cancelou depois, sai o Refund. Com a Shopee publicando o relatório cerca de um dia depois, a compra chega ao Meta dentro da janela.

Deduplicação: por que a venda não conta duas vezes

Deduplicação costuma ser explicada como "pixel e CAPI mandam a mesma compra, o event_id igual evita contar duas vezes". No afiliado da Shopee não existe Purchase do navegador para duplicar. O risco é outro: a mesma venda muda de status várias vezes no relatório da Shopee até ser concluída.

O Pixel identifica cada compra de forma única, então o Meta trata qualquer reenvio como a mesma compra, e a venda já aceita pelo Meta não é enviada de novo.

Passo a passo para ligar a CAPI

1. Escolha o pixel. Em Conexões, no cartão Meta Ads, clique em Gerenciar, selecione a conta de anúncios, o Pixel (obrigatório p/ CAPI) e a página, e clique em Salvar conta & pixel. Sem pixel escolhido não há para onde enviar.
2. Use só link rastreado no anúncio. É o link que preserva o clique do anúncio. Venda que não veio de um clique rastreado não gera Purchase, porque o Meta não teria como ligá-la a ninguém. O tutorial como criar um link rastreado e colocar no anúncio mostra onde vai cada valor.
3. Teste sem esperar venda. No Events Manager do Meta, abra o pixel, vá na aba "Eventos de teste" e copie o código. No mesmo diálogo do Pixel do Afiliado, cole o código e clique em Enviar evento de teste. O tutorial evento de teste da CAPI detalha cada tela.

O evento de teste é um Purchase que aparece só na aba de testes e não entra nos seus dados reais. O código colado vale para aquele envio e não fica gravado na conexão.

Erros comuns

• Nenhum pixel escolhido na conexão. Os cliques e as vendas aparecem nas telas do Pixel, mas nada chega ao Meta. Em Conexões, o Gerenciar do Meta Ads mostra qual pixel está salvo.
• Anúncio com link de afiliado comum. A venda entra no painel da Shopee, mas sem clique rastreado não há Purchase. Troque o destino pelo link rastreado.
• Procurar a venda no Gerenciador no mesmo dia. O Purchase só sai depois que a Shopee publica a venda, cerca de um dia depois. O que chega na hora é o LinkClick.
• Comparar o valor de conversão com o faturamento da loja. O value é a comissão. Um valor de conversão bem menor que o preço dos produtos é o esperado.

A CAPI é a última etapa do rastreamento. Se você ainda está montando a parte do link, comece por como rastrear vendas da Shopee no Meta Ads por anúncio.