Enviar suas conversões para o Meta Ads
Encaminhe ao Meta Ads, pela API de Conversões, os leads que a CodeQR registra, para as campanhas otimizarem com o que o pixel do navegador não vê.

O pixel da Meta enxerga o que acontece no navegador. Ele não enxerga o cadastro que o seu servidor confirmou uma hora depois, nem a venda fechada em outro aparelho. A API de Conversões existe para isso, e a CodeQR consegue mandar para lá os leads que ela já registra.
Disponibilidade
- Plano: Pro ou superior, ou o teste de 14 dias, já que depende do monitoramento de conversão.
- Onde: Configurações → Integrações → Meta Ads, em Analytics.
Antes de começar
- Monitoramento de conversão ligado nos links que você anuncia, e leads chegando à CodeQR — Enviar eventos de lead e venda pelo seu servidor. A CodeQR só encaminha o que tem.
- Uma conta empresarial da Meta com acesso à conta de anúncios e ao conjunto de dados que vai receber os eventos.
Passos
- Abra Configurações → Integrações.
- Em Analytics, selecione Meta Ads e conecte a conta.
- Escolha a conta de anúncios e o conjunto de dados que recebe os eventos.
- Anuncie seus links da CodeQR normalmente. Cada lead registrado é encaminhado.
As telas de permissão do passo 2 são da Meta, então o texto exato acompanha a sua conta de negócios e os acessos que ela já concede. O que a CodeQR pede é a conta de anúncios e o conjunto de dados.
Pixel ou API de Conversões
Não são alternativas, são dois caminhos para o mesmo evento, e a Meta espera os dois.
- O pixel dispara no navegador e é barrado por bloqueadores, por proteções de rastreamento e por quem recusa cookies.
- A API de Conversões é uma chamada de servidor para servidor e sobrevive aos três.
Mandar pelos dois é a configuração recomendada. A Meta deduplica pelo nome do evento junto com o ID do evento, então a mesma conversão contada por dois caminhos continua sendo uma — desde que ambos levem os mesmos identificadores.
TikTok Ads
O mesmo padrão de integração existe para o TikTok Ads, também em Analytics, e ele encaminha leads e vendas. A conexão é igual.
O que a Meta faz com isso
Evento de conversão é o que alimenta a otimização de campanha. Um conjunto de anúncios otimizando para "Lead" precisa de leads que ele consiga ver; se o único sinal é um pixel de navegador que metade do público bloqueia, o otimizador aprende com metade dos dados.
Verifique se funcionou
Abra o Gerenciador de Eventos da Meta, selecione o conjunto de dados e veja a atividade recente dos eventos que chegam pelo servidor. Um lead registrado na CodeQR deve aparecer em minutos, marcado como vindo da API, e não do navegador.
Na CodeQR, o mesmo lead aparece em Clientes — se ele não estiver lá, nada foi encaminhado, e o problema está antes da Meta.
Solução de problemas
Nenhum evento chega à Meta
Confira a CodeQR primeiro. Abra Clientes e veja se o lead existe. Nada que a CodeQR não registrou é encaminhado.
Seu pixel da Meta não está ativo
Essa mensagem é sobre o pixel do navegador no seu site, não sobre a API de Conversões. Os dois são configurados separadamente, e a API continua funcionando com o pixel mal configurado.
Os números da Meta não batem com os da CodeQR
Nunca vão bater exatamente. A Meta atribui ao anúncio com a janela e o modelo dela; a CodeQR atribui ao clique no seu link. Veja Como a CodeQR decide qual clique recebe a venda.
Os eventos parecem duplicados
A deduplicação precisa do mesmo ID de evento nos dois caminhos. Se o seu pixel envia um ID que a CodeQR desconhece, a Meta vê dois eventos distintos.