logo
Análises•

Descubra de onde vêm seus cliques e leituras

Leia os cartões Países, Dispositivos, Referenciadores e URLs do Analytics da CodeQR: o que é (direct), a precisão da cidade e que planos abrem cada cartão.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Ao final deste guia você vai ler os cartões de detalhamento do Analytics com a confiança certa: de que país e cidade veio um clique, em que aparelho e navegador, de que site ou app, e para qual destino ele foi.

Disponibilidade

  • Plano: Países / Cidades / Continentes em todos os planos (o Free mostra só as primeiras linhas e desfoca o resto); Dispositivos / Navegadores / OS e Referenciadores / URLs de Referência a partir do Starter; o cartão de UTM a partir do Pro. Cartões bloqueados dizem Feature unavailable — Upgrade to Starter to access detailed analytics.
  • Onde: Análise → Visão Geral, abaixo do gráfico. Os mesmos dados ficam na página pública de métricas de um link e na API (groupBy=countries, cities, continents, devices, browsers, os, referers, referer_urls, top_urls).

Locked Devices card on a Free workspace: Feature unavailable, Upgrade to Starter to access detailed analytics

Antes de começar

  • Todo cartão conta eventos, não pessoas. Dez aberturas por dez celulares no Brasil e dez aberturas por um celular a cada 6 minutos leem igual: Brazil 10.
  • Os cartões mostram todos os tipos de evento juntos — cliques, leituras de QR e visitas a páginas — a menos que você restrinja com Filter → Disparador. Os contadores do topo já separam.
  • Localização e dispositivo vêm da requisição que chegou ao link curto: o endereço de rede do visitante decide a localização, o user agent do navegador decide dispositivo, navegador e sistema operacional. Nenhum dos dois é armazenado; só os valores derivados.

Passos

  1. Abra Análise, defina o período e role até os cartões. Eles carregam quando entram na tela.
  2. Países / Cidades / Continentes — uma linha por lugar, com bandeira, contagem e barra. País é confiável; cidade é aproximada (redes móveis e VPNs costumam cair numa cidade vizinha ou no hub da operadora). Clique numa linha para filtrar a página por aquele lugar.

Countries card with Brazil 87 and Devices card with Desktop 44, Mobile 42 and Tablet 1

  1. Dispositivos / Navegadores / OS — Desktop, Mobile ou Tablet; navegadores como Chrome, Mobile Safari, Safari; sistemas como iOS, Android, Windows, Mac OS. Leituras de QR são quase sempre Mobile; uma leitura que aparece como Desktop normalmente veio de um verificador de links ou de alguém que abriu o link curto num computador.
  2. Referenciadores / URLs de Referência — o site de onde o visitante veio (instagram.com, t.co, mail.google.com) e, na segunda aba, a URL completa da página quando o navegador a enviou. (direct) significa que nenhum referenciador foi enviado: leituras de QR, links abertos de apps (WhatsApp, Telegram, apps de e-mail), links colados ou digitados e algumas passagens de HTTPS para HTTP aparecem como (direct). Apps sociais costumam mandar l.instagram.com, lm.facebook.com ou t.co — seus encapsuladores de link — em vez do nome do app.

Referrers card with (direct) 81, instagram.com 3, t.co 1, mail.google.com 1 and l.instagram.com 1

  1. Links / QR Codes / URLs — o cartão de cima lista quais links e códigos receberam os eventos. Selecione um link (clique no selo dele na lista ou use Filter → Link) e aparece a aba URLs com os destinos para onde ele mandou as pessoas. É onde você lê o resultado das Smart Rules: o destino de cada regra é uma linha separada. Destinos definidos com os campos iOS, Android ou país do construtor de links são gravados sob o destino padrão.
  2. Origem / Meio / Campanha / Conteúdo / Termo — valores UTM dos links, a partir do Pro. Veja Meça campanhas UTM em links e QR codes.
  3. Combine: clique em Mobile em Dispositivos e depois olhe Referenciadores — agora você vê de onde vieram os cliques de celular. Remova o chip para voltar.

O mesmo pela API

GET https://api.codeqr.io/analytics?event=clicks&groupBy=countries&interval=24h&linkId=<id> devolve [{"country":"BR","clicks":9}]; groupBy=cities acrescenta "city":"São Paulo"; groupBy=devices devolve [{"device":"Mobile","clicks":7,…},{"device":"Desktop","clicks":2,…}]; groupBy=referers devolve [{"referer":"(direct)","clicks":7,…},{"referer":"instagram.com","clicks":1,…}]; groupBy=top_urls&linkId=<id> devolve os destinos. Acrescente types=qrcode ou types=link para ficar só com leituras ou só com cliques. A API devolve todos os cartões em todos os planos; os cadeados existem só no app.

Confira se funciona

  1. Abra seu link curto no celular a partir de uma mensagem que você mandou para si mesmo no WhatsApp.
  2. Espere dois ou três minutos.
  3. Países mostra seu país, Dispositivos mostra Mobile, OS mostra iOS ou Android e Referenciadores mostra (direct) — apps não mandam referenciador. Agora cole o link num post e abra a partir do Instagram: o referenciador aparece como l.instagram.com ou instagram.com.

Solução de problemas

Aparece uma cidade em que eu nunca anunciei

A cidade vem do endereço de rede, que operadoras de celular e VPNs muitas vezes roteiam por outra cidade. Leia país como confiável e cidade como pista. Algumas leituras de um lugar distante normalmente são a gráfica, um colega ou um verificador de links.

Está tudo (direct)

Esperado para QR codes e para links compartilhados em apps de mensagem e e-mail: nada manda referenciador. Para atribuir esses canais, coloque parâmetros UTM no destino e leia o cartão de UTM.

O cartão mostra mais eventos do que o contador Cliques

Os cartões somam cliques, leituras e visitas a páginas. Defina Filter → Disparador → Clique no link para ver só cliques, ou leia os contadores.

Um dispositivo aparece como Desktop num QR code

Alguém abriu o link curto num computador (por exemplo, a partir de um PDF), ou um verificador automático requisitou o link. Robôs que se identificam não contam; um navegador comum ou uma requisição HEAD contam.

Artigos relacionados