logo
Análises•

Meça campanhas UTM em links e QR codes

Compare campanhas, origens e meios entre links e QR codes com o Relatório UTM da CodeQR, exporte o CSV e entenda como os valores UTM são atribuídos.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Ao final deste guia você vai ver cliques e leituras por campanha, origem e meio em todos os seus links e QR codes, exportar essa tabela e entender exatamente quais valores UTM a CodeQR atribui a cada evento.

Disponibilidade

  • Plano: o cartão de UTM e a aba Relatório UTM ficam completos a partir do Pro. Free e Starter veem uma prévia desfocada com um aviso Upgrade to Pro.
  • Onde: Análise → o cartão Origem / Meio / Campanha / Conteúdo / Termo e Análise → aba Relatório UTM. O botão Exportar CSV fica na aba Relatório UTM.

Antes de começar

  • Os parâmetros UTM pertencem à URL de destino do link ou QR code, por exemplo https://example.com/spring?utm_source=newsletter&utm_medium=email&utm_campaign=spring-2026. Adicione-os na seção de UTM do construtor de links ou cole uma URL que já os contenha; os valores são guardados com o link e aparecem como Origem, Meio, Campanha, Conteúdo e Termo.
  • Um link curto = um conjunto de valores UTM. Para comparar canais, crie um link por canal (ou um QR code por ponto de contato) e dê a cada um o seu utm_source / utm_medium. Use tags para lê-los juntos — veja Filtre o Analytics por link, tag e período.
  • Parâmetros anexados ao link curto na hora do clique (go.example.com/spring?utm_source=whatsapp) são repassados ao destino, mas não são o que o relatório UTM lê. Eles aparecem na aba URLs do link.

Passos

  1. Crie ou edite um link para que a URL de destino carregue os parâmetros UTM. Salve.
  2. Abra Análise e role até o cartão Origem / Meio / Campanha / Conteúdo / Termo. Cada aba lista os valores encontrados nos seus links com o número de eventos; (não definido) agrupa eventos de links sem aquele parâmetro. Clique num valor para filtrar a página por ele.

Links card and UTM card side by side: expol.ink/docs-analytics-utm 9, expol.ink/docs-analytics-plain 2; Source newsletter 9 and (not set) 7

  1. Clique na aba Relatório UTM para a tabela completa: uma linha por link, com Link Curto, Destino, Origem, Meio, Campanha, Conteúdo, Termo, Cliques, Escaneamentos e Total. Só links e QR codes com pelo menos um parâmetro UTM entram na lista. O período e os filtros da barra de ferramentas valem aqui também.

UTM Report tab with the search box, Group by set to None, the Export CSV button, one row for expol.ink/docs-analytics-utm with newsletter, email, august-2026 and 9 clicks, and the Totals footer

  1. Use Agrupar por para consolidar as linhas por Origem UTM, Meio UTM, Campanha UTM, Conteúdo UTM ou URL de Destino — por exemplo, para ver todos os cliques de utm_campaign=spring-2026 nos dez links que a carregam. Nenhum volta a uma linha por link.
  2. Digite na caixa de busca para achar um link ou valor específico. Clique no cabeçalho de uma coluna para ordenar.
  3. Leia o rodapé de totais: cliques, escaneamentos, total e número de links da tabela atual.
  4. Clique em Exportar CSV para baixar a tabela. O arquivo tem as mesmas colunas (Short Link, Destination, UTM Source, UTM Medium, UTM Campaign, UTM Content, UTM Term, Clicks, Scans, Total), uma linha por link, em UTF-8.

Como os valores UTM são atribuídos

  • O relatório lê os valores UTM guardados no link agora. Se você editar os parâmetros UTM de um link, todos os eventos passados dele passam para os valores novos — o histórico não fica congelado no momento do clique. Isso ajuda quando você corrige um erro de digitação, e é algo para lembrar quando reaproveitar um link numa campanha nova: crie um link novo.
  • Os valores diferenciam maiúsculas e são guardados como digitados: Newsletter e newsletter são duas linhas.
  • Leituras de QR code são atribuídas do mesmo jeito, pela URL de destino do código.

O mesmo pela API

GET https://api.codeqr.io/analytics?event=clicks&groupBy=utm_sources&interval=30d devolve [{"utm_source":"newsletter","clicks":9}]; groupBy=utm_mediums, utm_campaigns, utm_contents, utm_terms funcionam igual, e utm_source=newsletter (ou qualquer outro utm_*) funciona como filtro em todo groupBy. Ao criar links pela API, coloque os parâmetros na url; a resposta os devolve como utm_source, utm_medium, utm_campaign, utm_term, utm_content. Veja Leia suas métricas pela API, MCP e webhooks.

Confira se funciona

  1. Crie um link para https://example.com/spring?utm_source=newsletter&utm_medium=email&utm_campaign=spring-2026.
  2. Abra uma vez no celular e espere dois ou três minutos.
  3. No Analytics, a aba Origem mostra newsletter 1; o Relatório UTM lista o link com newsletter, email, spring-2026 e 1 clique; Exportar CSV contém a mesma linha.

Solução de problemas

Meu link não está no Relatório UTM

A URL de destino dele não tem parâmetro UTM. Edite o link e adicione pelo menos um; o link aparece no relatório com todos os eventos passados.

A aba Origem mostra (não definido) para um link que tem UTM no link curto

Parâmetros adicionados à URL curta na hora do clique são repassados ao destino, mas não são lidos pelo relatório. Coloque-os na URL de destino do link.

As contagens mudaram depois que editei os valores UTM de um link

Esperado: o relatório sempre reflete os valores atuais do link, inclusive para eventos antigos. Para preservar os números da campanha antiga, deixe o link antigo como está e crie um novo.

O cartão está desfocado

O cartão de UTM e o relatório ficam completos a partir do Pro. O Free mostra uma linha e o Starter três; o resto fica desfocado até o upgrade.

Artigos relacionados