logo
Análises•

Filtre o Analytics por link, tag e período

Restrinja o Analytics da CodeQR a um link, QR code, tag, domínio, país ou aparelho, escolha um período pronto ou personalizado e veja o que seu plano abre.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Ao final deste guia você vai conseguir olhar um link, um QR code, uma tag ou um país no Analytics, escolher o período que importa e saber quais períodos o seu plano abre.

Disponibilidade

  • Plano: todos os planos filtram. O período é limitado pelo plano: Free até 30 dias, Starter até 90 dias, Pro até 1 ano, Business e acima sem limite no app. Períodos bloqueados mostram um cadeado e uma dica Upgrade to ….
  • Onde: Análise → Filter e o botão de período (24h por padrão). Os mesmos filtros funcionam em Eventos e na aba Relatório UTM.

Antes de começar

  • Os filtros se combinam com E: País = Brazil mais Dispositivo = Mobile mostra só cliques de celular vindos do Brasil.
  • O período usa o fuso horário do seu navegador. Um colega em outro fuso pode ver um clique em outro dia; a API usa UTC, a menos que você passe timezone.
  • Os filtros ficam na URL da página (por exemplo ?country=BR&interval=7d), então você pode salvar uma visão nos favoritos ou colar a URL para alguém da equipe com acesso ao workspace.

Passos

  1. Abra Análise e clique em Filter.
  2. Escolha uma dimensão. A lista é Domínio, Link, QR Code, Tipo de Link, Tag, Disparador, País, Cidade, Continente, Dispositivo, Navegador, Sistema Operacional, Referenciador, URL do Referenciador e UTM Origem, UTM Meio, UTM Campanha, UTM Conteúdo, UTM Termo. Digite para buscar dentro de uma dimensão.

Filter menu open on the Analytics page listing every dimension from Domain to UTM Term

  1. Escolha um valor. O filtro vira um chip ao lado de Filter; adicione outros do mesmo jeito, ou clique numa linha dentro de qualquer cartão (um país, um dispositivo, um referenciador, um valor UTM) para adicioná-la como filtro. Clear filters remove todos.
  2. Para focar num link ou QR code sem abrir o menu, clique no selo N clicks ou N scans dele na lista de Links ou QR Codes. O Analytics abre com o chip Link ou QR Code já definido, e o cartão Links ganha uma aba URLs com os destinos daquele link.
  3. Disparador separa o tipo de evento: Clique no link, Scan de QR ou Visita à página. Ele restringe os cartões (países, dispositivos, referenciadores, UTM); os contadores do topo já separam Cliques, Scans e Views sozinhos.
  4. Tag mostra juntos todos os links e QR codes com aquela tag — o jeito mais rápido de ler uma campanha espalhada em vários links. Veja Como usar tags na CodeQR.
  5. Clique no botão de período (24h) para mudar o intervalo. Os atalhos são Última hora, 24h, 7 dias, 30 dias, 3 meses, Este ano, Últimos 12 meses e Todo o Tempo, cada um com uma tecla (H, D, W, M, T, Y, L, A). Os que o seu plano não abre mostram um cadeado.

Date range menu with the presets Última hora, 24h, 7 dias, 30 dias and the locked 3 meses, Este ano, Últimos 12 meses and Todo o Tempo on a Free workspace

  1. Para um período personalizado, clique no primeiro e no último dia no calendário de dois meses à esquerda do mesmo menu. A data final não pode estar no futuro.
  2. Recarregue mais tarde com a mesma URL para voltar à mesma visão.

Até quando dá para olhar

  • Free: 30 dias (24h, 7 dias, 30 dias, personalizado até 31 dias).
  • Starter: 90 dias (ganha 3 meses).
  • Pro: 1 ano (ganha Este ano e Últimos 12 meses).
  • Business e acima: Todo o Tempo e qualquer período personalizado no app. A página de preços indica 2 anos no Business e 5 anos no Scale como retenção garantida.

Se você fizer downgrade, o histórico que consegue abrir encolhe para a janela do plano novo; o app avisa antes de confirmar.

O mesmo pela API

Todo filtro é um parâmetro de GET https://api.codeqr.io/analytics: linkId, qrcodeId, domain + key + type, tagIds, country, city, continent, device, browser, os, referer, url, utm_source … utm_term, mais interval (24h, 7d, 30d, 90d, ytd, 1y, all) ou start e end com timezone. Exemplo: GET https://api.codeqr.io/analytics?event=clicks&groupBy=count&interval=7d&tagIds=tag_xxxxxxxxxxxxxxxxxxxxxxxx&country=BR. Um período acima do seu plano devolve 403 com uma mensagem dizendo qual plano é preciso. Veja Leia suas métricas pela API, MCP e webhooks.

Confira se funciona

  1. Filtre por País → seu país e por Dispositivo → Mobile.
  2. Abra seu link curto no celular e espere dois ou três minutos.
  3. Cliques sobe um, e a lista de chips continua mostrando os dois filtros. Remova o chip Dispositivo: a contagem não muda, a menos que alguém tenha clicado de um computador no mesmo período.

Solução de problemas

O período que eu quero está bloqueado

A janela do seu plano é menor que aquele atalho. Passe o mouse no item para ver qual plano o abre, ou escolha um período personalizado dentro da sua janela. O upgrade abre dados antigos que a CodeQR já guarda; nada é apagado enquanto você está abaixo da janela.

Escolhi Última hora e o gráfico ficou vazio

Os contadores e os cartões atualizam para a última hora, mas o gráfico ainda não renderiza nessa granularidade. Use 24h: o gráfico é por hora e o último ponto é a hora atual.

Os contadores não mudam quando escolho um disparador

Disparador filtra os cartões. Os contadores já mostram Cliques, Scans e Views separados — leia o que corresponde ao disparador.

Um clique feito às 23h aparece no dia seguinte

O painel agrupa pelo fuso do seu navegador; a API e as exportações usam UTC, a menos que você passe timezone. Compare com o mesmo fuso dos dois lados. Veja Cliques não aparecem ou números não batem.

Artigos relacionados