logo
ConversõesComeçando•

Acompanhar leads e vendas dos links e QR codes

Ligue um clique no link ou QR code ao cadastro e à venda que ele gerou — o que a cadeia exige, qual plano e onde os resultados aparecem.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Contagem de cliques mostra qual link chamou atenção. Rastreamento de conversão mostra qual link foi pago. A CodeQR liga o clique à pessoa que se cadastrou e ao valor que ela gastou, então o relatório de campanha termina em receita, não em tráfego.

Disponibilidade

  • Plano: Pro ou superior. Há um teste de 14 dias, uma vez por espaço de trabalho, e alguns espaços mais antigos já vêm com o recurso ligado de uma versão anterior.
  • Onde: a chave Monitoramento de conversão no construtor de links e de QR codes, e Configurações → Conversion tracking.

Ligar sem o plano é recusado com o motivo exato, exibido em inglês: You can only use conversion tracking on a Pro plan and above. Upgrade to Pro to use this feature.

Os três eventos

Tudo se apoia em um identificador, o ID do clique, que a CodeQR emite quando alguém abre o seu link.

  • Clique — registrado pela CodeQR sozinha, sem trabalho seu.
  • Lead — alguém se identificou: cadastrou-se, preencheu um formulário, começou um teste. O seu servidor avisa, citando o ID do clique.
  • Venda — houve dinheiro. De novo o seu servidor, ou a integração com o Stripe.

A assimetria é o que precisa ficar claro antes de qualquer coisa: cliques são contados para você, leads e vendas são informados por você. É por isso que muita conta mostra vários cliques e nenhuma conversão — não há nada quebrado, a segunda metade nunca foi ligada.

O que muda ao ligar

A chave Monitoramento de conversão ligada no construtor de links

Com a chave ligada, o redirecionamento muda de duas formas:

  • A URL de destino recebe ?cq_id=…, então o seu site consegue ler o ID do clique antes mesmo de qualquer script rodar.
  • O cookie cq_id passa a durar 30 dias, em vez de uma hora.

As duas coisas são o que permite creditar a um clique de agosto uma compra feita em setembro.

O que você precisa configurar

  1. Ligue a chave nos links e QR codes que quer medir — Configurar o rastreamento de conversão no seu site.
  2. Instale o script no seu site, para o ID do clique ficar guardado no navegador. Mesmo artigo.
  3. Informe o lead e a venda — Enviar eventos de lead e venda pelo seu servidor, ou deixe a integração do Stripe fazer isso em Atribuir pagamentos do Stripe ao link certo.
  4. Leia os resultados em Ver quais links e QR codes geram vendas.

Onde os resultados aparecem

Clientes é a visão mais clara: cada pessoa, de onde veio e a linha do tempo do que ela fez.

The customer panel with lifetime value, sales count and a timeline of purchase, sign-up and click

Cada link e QR code também tem os contadores próprios — cliques, leads, vendas e receita —, que é o que transforma uma lista de campanhas num ranking por dinheiro.

Sobre a API

Conversão é a parte da CodeQR mais conduzida por código. Dois endpoints fazem o serviço:

curl -X POST https://api.codeqr.io/track/lead \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"clickId":"qcdyQHsX1oajEock","eventName":"Sign up","customerExternalId":"user_123"}'

Um assistente de IA conectado por MCP consegue ler os seus totais de conversão, mas não registra eventos — o registro fica com o seu servidor, de propósito.

Verifique se funcionou

Depois de uma volta completa, pergunte os contadores ao link:

curl -sS "https://api.codeqr.io/links/info?domain=go.example.com&key=verao" \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx"
{ "key": "verao", "trackConversion": true, "clicks": 1, "leads": 1, "sales": 1, "saleAmount": 4990 }

saleAmount vem em centavos, então 4990 é US$ 49,90.

Solução de problemas

Os cliques sobem e os leads ficam em zero

Nada está informando os leads. Cliques são registrados pela CodeQR; leads e vendas chegam do seu servidor. Veja Enviar eventos de lead e venda pelo seu servidor.

A chave está desabilitada num QR code estático

Um QR code estático leva o destino gravado no próprio desenho, então nenhum clique passa pela CodeQR e não há o que atribuir. Use um QR code dinâmico. A dica na tela diz: O rastreamento de conversão está disponível apenas para QR codes dinâmicos.

Liguei depois que a campanha começou

Só os cliques posteriores carregam o ID do clique de 30 dias. Os anteriores ficaram com o cookie de uma hora e dificilmente serão creditados.

A venda foi registrada e o link não mostra receita

Confira o valor enviado: amount vai na menor unidade da moeda, então 49.90 significa 49 centavos, não US$ 49,90.

Artigos relacionados