Como a CodeQR decide qual clique recebe a venda
A regra de atribuição da CodeQR — a janela de trinta dias, qual clique ganha o crédito e por que os totais não batem com Meta e Google Analytics.
Atribuição é uma regra, não um fato, e cada ferramenta escolhe a sua. Saber qual regra a CodeQR aplica é o que permite explicar um relatório em vez de defendê-lo.
Disponibilidade
- Plano: Pro ou superior, já que descreve o monitoramento de conversão.
- Onde: não há nada a configurar — é assim que os dados são produzidos.
A regra
A venda vai para o clique cujo ID estava no navegador quando a conversão aconteceu.
Daí saem três consequências:
- A janela é de trinta dias para links com monitoramento de conversão ligado. Clique mais antigo que isso já saiu do navegador e não pode ser creditado.
- Sem o monitoramento, a janela é de uma hora, o que basta para uma compra imediata e para nada além disso.
- O clique mais antigo dentro da janela ganha. O ID é gravado quando a pessoa chega e não é substituído por cliques posteriores no mesmo link, então, dentro da janela, a CodeQR credita o clique que iniciou a relação.
Onde o ID do clique fica
Em dois lugares, de propósito:
- A URL de destino recebe
?cq_id=…, para o seu site ler já na primeira requisição. - Um cookie chamado
cq_id, definido pelo próprio redirecionamento, comPathrestrito àquele link.
O cookie é gravado pela resposta do servidor, não por um script. Essa diferença importa mais do que parece: as regras de proteção contra rastreamento que limitam a sete dias os cookies escritos por script não se aplicam da mesma forma a este.
Quando não há o que atribuir
- Sem ID de clique e sem cliente conhecido — o evento é aceito e descartado. Nada é registrado e nenhum erro aparece.
- ID de clique inexistente ou expirado — a chamada é recusada com 404.
- Conversão num aparelho que nunca clicou — a pessoa navega no celular e compra no computador. Nada liga os dois, e a venda fica sem atribuição.
- Robô — tráfego de robô não vira clique, então não vira lead.
Por que os totais diferem de Meta e Google Analytics
Eles medem coisas diferentes com regras diferentes, e as diferenças se acumulam:
- Janelas diferentes. Meta e Google aplicam as delas, por campanha.
- Âncoras diferentes. A CodeQR atribui ao clique no seu link; a Meta, à impressão ou ao clique no anúncio; o GA4, a uma sessão.
- Sobrevivência diferente. Um pixel de navegador é barrado por bloqueadores e por proteção de rastreamento; uma conversão informada pelo servidor, não.
- Deduplicação diferente. Cada plataforma decide sozinha o que conta como um evento.
Espere divergência grande e use cada um para o que serve: a CodeQR para saber qual link trouxe o dinheiro, a plataforma de anúncios para otimizar a campanha.
Verifique se funcionou
Dá para ver a regra acontecendo. Abra um link rastreado e repare no ID que ele acrescenta:
curl -sSI https://go.example.com/verao
HTTP/2 302 location: https://example.com/checkout?cq_id=qcdyQHsX1oajEock set-cookie: cq_id=qcdyQHsX1oajEock; Path=/verao; Max-Age=2592000
Max-Age=2592000 é trinta dias. Registre um lead com esse ID e a linha do tempo da pessoa em Clientes mostra o clique na base — é ele que vai carregar qualquer venda posterior.
Solução de problemas
Uma venda que eu esperava não apareceu
Algo interrompeu a cadeia: o cookie foi apagado, a compra aconteceu em outro aparelho, a janela passou, ou o ID do clique não chegou ao checkout. Corrigir conversões que não estão sendo registradas percorre cada caso.
A campanha errada levou o crédito
Dentro da janela, o primeiro clique fica com o crédito. Quem clicou na sua newsletter em março e no seu anúncio em abril é creditado a março.
Quero outra janela de atribuição
Não é configurável hoje.
Minha taxa de conversão parece impossivelmente baixa
Compare coisas comparáveis: cliques são contados pela CodeQR para todo mundo, enquanto conversões dependem do seu servidor informar. Todo visitante que bloqueia scripts, recusa cookies ou compra em outro aparelho é um clique sem conversão.