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, com que dados, em que momento, e como conferir que está 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 do servidor 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 a pessoa: o fbc (montado a partir do fbclid que o Meta acrescenta ao link), o fbp (cookie que o link grava quando ainda não existe), o IP e o navegador. Também leva a campanha, o conjunto, o anúncio e o posicionamento. Acessos de robô, como o leitor de prévia do próprio Meta, não viram evento.

2. Purchase, quando a Shopee publica a venda

O Pixel lê o relatório de conversões da Shopee três vezes por dia. Cada venda que traz o id de um clique rastreado é casada com 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.
• user_data copiado do clique casado (fbc, fbp, IP e navegador), que é o que permite ao Meta ligar a compra a quem clicou.
• content_ids, contents, num_items e order_id, com o nome e a categoria do produto quando a Shopee informa.
• event_id = o id da conversão na Shopee.

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 com o mesmo event_id. O Meta distingue os dois pelo nome do evento.

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. Se uma venda for publicada muito tarde, o evento sai com o horário mais antigo que o Meta ainda aceita, em vez de ser recusado.

Deduplicação: por que o event_id importa aqui

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: o Pixel relê os últimos 30 dias do relatório da Shopee a cada rodada para pegar mudanças de status, então a mesma venda aparece dezenas de vezes.

O event_id igual ao id da conversão faz o Meta tratar qualquer reenvio como a mesma compra. Do lado do Pixel, cada venda aceita pelo Meta fica registrada e 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 captura o fbclid. Venda que chega sem o id 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á fbc nem 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.