Como validar a CAPI com um evento de teste

Primeiros passos · atualizado em 26/09/2026

O evento de teste confirma, em menos de um minuto, que o Pixel do Afiliado consegue entregar conversões ao seu pixel do Meta pela API de Conversões (CAPI). Sem ele, a primeira prova seria esperar uma venda real acontecer, ser atribuída e ser enviada.

Antes de começar

• Plano: qualquer plano. O evento de teste não depende do plano.
• Meta Ads conectado e pixel salvo: a seção do teste só aparece depois que a conexão está ativa e você escolheu o Pixel (obrigatório p/ CAPI) e clicou em Salvar conta & pixel. Veja como conectar o Meta Ads.
• Papel na organização: só o dono ou um administrador envia o evento.
• Shopee não é necessária: o teste não usa nenhuma venda real.

Passo a passo

1. Copie o código de teste no Events Manager

No Events Manager do Meta, abra o pixel — o mesmo que aparece em Pixel (obrigatório p/ CAPI) no Pixel do Afiliado — e vá na aba "Eventos de teste". Copie o código de teste que ela mostra, no formato TEST12345. Deixe essa aba aberta: é nela que o evento vai aparecer.

2. Abra o cartão Meta Ads

No Pixel do Afiliado, clique em Conexões no menu lateral e depois em Gerenciar no cartão Meta Ads. Confira que Pixel (obrigatório p/ CAPI) mostra o pixel certo. Logo abaixo fica a seção Evento de teste no pixel.

3. Cole o código e envie

Cole o código no campo (as letras viram maiúsculas sozinhas) e clique em Enviar evento de teste. O botão só fica ativo com o campo preenchido e mostra Enviando… enquanto o Meta responde.

O Pixel manda um Purchase de teste com valor de R$ 1,00, marcado com o seu código. Por causa do código, o Meta mostra esse evento só na aba de teste: ele não entra nos seus dados reais, não conta para a otimização das campanhas e não aparece em Conversões enviadas ao Meta (CAPI) no Dashboard.

4. Confira no Events Manager

Com o envio aceito, a tela mostra "Evento de teste enviado! Abra o Events Manager → seu pixel → aba "Eventos de teste" — o Purchase aparece em segundos.", seguido de um código fbtrace. Volte à aba de teste do Events Manager e procure o Purchase.

Guarde o código fbtrace se algo não bater: é o identificador do envio no Meta, e o suporte usa ele para achar a requisição.

Depois do teste, as conversões reais seguem sozinhas: cada venda da Shopee casada com um clique do seu link rastreado é enviada como Purchase ao pixel no passo Conversões → pixel da sincronização.

O que pode dar errado

• A seção Evento de teste no pixel não aparece. A conexão com o Meta não está ativa ou nenhum pixel foi salvo. Escolha o Pixel (obrigatório p/ CAPI) e clique em Salvar conta & pixel.
• "Muitos testes de evento. Aguarde um minuto." Há um limite de envios de teste por minuto em cada organização. Espere um minuto e envie de novo.
• "Conexão Meta ausente ou incompleta." O Pixel não achou a conexão, o pixel ou o token do Meta. Abra o cartão Meta Ads, clique em Reconectar Meta e salve a conta e o pixel de novo.
• O Meta recusou o evento. A tela mostra a resposta do Meta como veio, no formato code=… subcode=… seguido da mensagem dele (ou "O Meta recusou o evento." quando não há detalhe). Se a mensagem fala de token ou permissão, use Reconectar Meta; se fala do pixel, confira se o código de teste é do mesmo pixel salvo.
• A mensagem de sucesso apareceu, mas nada chega na aba de teste. Confira se o código veio do mesmo pixel: compare o pixel aberto no Events Manager com o de Pixel (obrigatório p/ CAPI), copie o código do pixel certo e envie de novo.
• "Sem permissão na organização." O seu usuário não é dono nem administrador da organização.

Tutoriais relacionados

• Como conectar o Meta Ads: conta, pixel e página
• Como criar um link rastreado e colocar no anúncio
• Dashboard e Relatórios: o que cada número significa