Acompanhe cliques em links e leituras de QR code

Ao final deste guia você vai saber onde ver quantas pessoas clicaram num link curto ou leram um QR code, o que cada número do Analytics significa, o que a CodeQR conta como clique ou leitura e como conferir que um link novo está sendo medido.

Disponibilidade

• Plano: todos. O que muda com o plano é até quando você consegue olhar para trás e quais cartões ficam abertos: o Free guarda 30 dias e mostra só países; o Starter guarda 90 dias e abre dispositivos, navegadores e referenciadores; o Pro guarda 1 ano e abre o relatório UTM e a página Eventos; Business e acima não têm limite de período no app (preços).
• Cliques medidos por ciclo de cobrança: Free 1.000, Starter 6.000, Pro 30.000, Business 150.000, Scale 1.000.000 — os mesmos números valem para leituras de QR. Seus links continuam redirecionando depois do limite; o limite é sobre quantos eventos aparecem no Analytics.
• Onde: Análise na barra lateral, o selo N clicks no card de um link, o selo N scans no card de um QR code e Eventos para a lista evento a evento.

Antes de começar

• Todo link curto e todo QR code dinâmico é medido automaticamente. Não há nada para ligar.
• Um QR code estático não é medido: o conteúdo fica gravado na imagem e a leitura nunca passa pela CodeQR. Se você precisa contar leituras, use um código dinâmico — veja QR code dinâmico ou estático: qual usar.
• Os números não são instantâneos. Os dados ficam em cache por alguns minutos; o próprio app avisa: Os dados são armazenados em cache para otimização de desempenho. As análises atualizadas podem levar alguns minutos para aparecer.

Passos

1. Clique em Análise na barra lateral. A página abre na aba Visão Geral com 24h selecionado. O título da página aparece em inglês, Analytics.
2. Leia os seis contadores do topo: Total, Cliques, Scans, Views, Leads e Vendas. Cliques são cliques em links curtos, Scans são leituras de QR codes dinâmicos, Views são visitas às suas Pages e Total é a soma dos três. Leads e Vendas só preenchem quando o rastreamento de conversão está ligado. Clique num contador para o gráfico acompanhá-lo.

1. Olhe o gráfico. Em 24h cada ponto é uma hora; em 7 dias e 30 dias cada ponto é um dia; de três meses em diante cada ponto é um mês. Passe o mouse num ponto para ler o valor exato. Os ícones à direita alternam entre gráfico de linhas e gráfico de funil e abrem Eventos.
2. Role até os cartões. Cada cartão tem abas e lista valores com uma contagem e uma barra: - Links / QR Codes — quais links e códigos receberam os eventos. Com um link selecionado aparece uma terceira aba, URLs, com os destinos para onde ele mandou as pessoas. - Origem / Meio / Campanha / Conteúdo / Termo — parâmetros UTM dos seus links (Pro e acima). - Países / Cidades / Continentes, Dispositivos / Navegadores / OS e Referenciadores / URLs de Referência — de onde e como as pessoas clicaram. Veja Descubra de onde vêm seus cliques e leituras.

1. Clique em qualquer linha de um cartão para filtrar a página inteira por aquele valor — por exemplo Brazil em Países ou instagram.com em Referenciadores. Os filtros ativos aparecem ao lado do botão Filter; Clear filters remove todos. Veja Filtre o Analytics por link, tag e período.
2. Para olhar um link ou um QR code específico, clique no selo N clicks ou N scans dele na lista. O Analytics abre já filtrado por ele.

1. Para ver os eventos individuais (uma linha por clique ou leitura, com país, dispositivo e horário), abra Eventos na barra lateral (Pro e acima). Veja Veja cada clique e leitura no registro de Events.

O que conta como clique ou leitura

• Um clique é contado no momento em que a CodeQR redireciona o visitante para o destino — antes de a página de destino carregar. Uma leitura é o mesmo evento para um QR code dinâmico, porque o código codifica um link curto.
• O mesmo visitante conta uma vez a cada 5 minutos no mesmo link. A CodeQR grava um cookie (cq_id) no domínio curto; aberturas repetidas dentro dessa janela não contam de novo.
• Robôs e prévias de link não contam. Requisições cujo user agent se identifica como robô — WhatsApp, Facebook, Google, Bing e qualquer um contendo bot — são redirecionadas, mas não gravadas. Por isso enviar um link no WhatsApp não gera clique sozinho.
• Não contam: links expirados (com ou sem URL de expiração), a página de senha (o clique conta só depois da senha correta), links banidos, chaves inexistentes e qualquer requisição com ?codeqr-no-track=1 na URL — use isso ao testar seus próprios links.
• Contam mesmo que você não espere: uma requisição HEAD de um verificador de links ou monitor de disponibilidade e qualquer navegador que não se identifique como robô.
• Gravado em cada evento: URL de destino, país, cidade, continente, dispositivo, navegador, sistema operacional, referenciador e se foi clique em link, leitura de QR ou visita a página. Endereços IP não são armazenados.

Confira se funciona

1. Abra seu link curto no celular (ou rode curl -sI https://go.example.com/spring -A "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)" — a resposta é HTTP/2 302 com location: apontando para o seu destino e um cabeçalho set-cookie: cq_id=…).
2. Espere dois ou três minutos.
3. No Analytics, mantenha 24h e clique no selo do link, ou use Filter → Link. Cliques mostra 1; o gráfico mostra o ponto na hora atual; Países e Dispositivos mostram seu país e seu aparelho.
4. Pela API, a mesma conferência é GET https://api.codeqr.io/analytics?event=clicks&groupBy=count&interval=24h&linkId=<id> → {"clicks":1,"scans":0,"views":0,"leads":0,"sales":0,"saleAmount":0}.

Solução de problemas

Cliquei no meu link e o Analytics continua em 0

Espere alguns minutos e recarregue; contadores e gráfico atualizam em cerca de dois minutos, os cartões em cinco a dez. Se você abriu o link duas vezes do mesmo celular em menos de 5 minutos, é um clique só. Se usou ?codeqr-no-track=1, nada é gravado. Mais causas em Cliques não aparecem ou números não batem.

O QR code foi lido mas Scans não mudou

Só QR codes dinâmicos são medidos. Se o card mostra o selo Estático, a leitura nunca chegou à CodeQR. Se o código abre uma página de exibição (Wi-Fi, vCard, texto), a leitura conta quando a página abre; abrir a mesma página de novo do mesmo celular em menos de 5 minutos não conta.

Os contadores e os cartões mostram números diferentes

Os contadores separam Cliques, Scans e Views; os cartões abaixo somam os três, a menos que você defina Filter → Disparador. Leia os contadores para totais por tipo e os cartões para a distribuição.

Artigos relacionados

• Filtre o Analytics por link, tag e período
• Descubra de onde vêm seus cliques e leituras
• Meça campanhas UTM em links e QR codes
• Leia suas métricas pela API, MCP e webhooks