A primeira vez que executei um lançamento adequado - um lançamento do WP Adminify, lista de discussão mais algumas postagens de parceiros mais um push do Product Hunt - fiz a marcação manualmente em uma planilha à 1h. Duas semanas depois, abri o relatório analítico para descobrir qual canal realmente funcionou e metade do tráfego estava em um balde chamado não atribuído. Não "email", não "referência" não atribuído. Os links funcionaram. As pessoas compraram. Eu simplesmente não conseguia dizer de onde qualquer um deles tinha vindo.
A causa foi embaraçosamente pequena. Nos links do boletim que eu escrevi utm_medium=Email com um E maiúsculo. Nos links dos parceiros que escrevi utm_medium=partner, o que parece sensato e não significa nada para o Google Analytics. E em um lote eu colei o url depois que ele já carregava um ?ref=hn string de consulta, então meu ?utm_source= Começou um segundo ponto de interrogação e tudo desmoronou em alguns clientes de e-mail.
Nenhum desses problemas são analíticos. Eles são problemas de montagem de strings, e o conjunto de strings é exatamente o tipo de coisa que você nunca deve fazer manualmente à 1 da manhã. Por isso construí o Construtor UTM em Toolz.dev: ele reúne os parâmetros corretamente, normaliza os valores e - a parte que realmente me interessa - informa em qual canal GA4 seu par fonte/médio irá pousar antes Você envia o e-mail.
tl;dr: Um URL marcado com UTM é sua página de destino e uma string de consulta
utm_source,utm_mediumeutm_campaign(com opcionalutm_term,utm_contenteutm_id). A fonte é De onde veio o clique, o meio é que tipo de marketing era. GA4 constrói seus relatórios de canal a partir do meio e reconhece apenas um vocabulário fixo -cpc,organic,social,referral,affiliate,displayE mais alguns. qualquer outra coisa, incluindo o muito tentadorutm_medium=facebook, é arquivado em Unsigned. Mantenha todos os valores minúsculos e hifenizados, nunca marque links internos e deixe o Construtor UTM Monte a corda.
O que são parâmetros UTM?
Os parâmetros UTM são pares de valores-chave de string de consulta comuns anexados a uma URL. O nome é um fóssil: Urchin Tracking Module, da Urchin Software, a empresa de análise que o Google comprou em 2005 e transformou no Google Analytics Os parâmetros sobreviveram a cada reescrita desde então, e é por isso que uma convenção projetada para um produto que não existe mais ainda é a língua franca do rastreamento de campanhas em 2026 - e por que Matomo, Plausible, Fathom, Adobe Analytics e todas as plataformas de e-mail os leram também.
Um URL marcado é assim:
https://toolz.dev/tools/utm-builder?utm_source=newsletter&utm_medium=email&utm_campaign=july-tool-roundup
Seu servidor web ignora a string de consulta inteiramente - a página renderiza exatamente como faria sem ele O script de análise na página lê os parâmetros fora da barra de endereço, armazena-os contra a sessão, e seus relatórios ganham uma linha dizendo que esta visita veio do boletim de julho.
Existem seis parâmetros de uso comum:
| parâmetro | O que ele responde | exemplo | necessário? |
|---|---|---|---|
utm_source |
Quem enviou o clique | newsletter, producthunt, github |
Sim - GA não atribuirá uma campanha sem ela |
utm_medium |
que tipo de marketing era | email, cpc, social, referral |
Efetivamente sim - não médio significa não canal |
utm_campaign |
A qual campanha pertence | july-tool-roundup, black-friday-2026 |
Efetivamente sim - caso contrário, os relatórios mostram o & quot; (não definido) & quot; |
utm_term |
A palavra-chave paga | utm builder |
Opcional, somente pesquisa paga |
utm_content |
Qual variante ou colocação | header-cta, footer-link, variant-b |
Opcional, útil para testes A/B |
utm_id |
O ID da campanha da plataforma de anúncios | q3-2026-001 |
Opcional, usado para unir dados de custo |
A distinção que as pessoas erram é fonte versus média, então vale a pena ser franco sobre isso. Fonte é um nome próprio. O meio é uma categoria. facebook é uma fonte. social é o meio a que pertence. newsletter é uma fonte; email é o seu meio. Se você se encontrar digitando uma marca em utm_medium, você os trocou.
Por que minha campanha aparece sem atribuição no GA4?
Esta é a falha de marcação mais comum e quase sempre é o meio.
O GA4 não inventa os canais dos seus dados. Possui um conjunto fixo de Grupos de canais padrão- Pesquisa Direta, Orgânica, Pesquisa Paga, Social Orgânica, Social Paga, Email, Afiliados, Referência, Exibição, Vídeo Orgânico, Outro Pago e um punhado a mais - e atribui cada sessão a uma por correspondência de padrões da fonte e do meio contra regras que o Google publica em sua documentação de Ajuda do Analytics A regra para Email, por exemplo, corresponde a sessões onde a fonte ou o meio contém email. A regra para o social orgânico combina com um conjunto de meios sociais, como social, social-network, social-media e sm. A pesquisa paga corresponde a uma fonte de pesquisa reconhecida e um meio que parece pago - o cp*/ppc/paid* Família.
Quando nada combina, a sessão cai para não atribuído. Não é um estado de erro sobre o qual você é avisado; é um bucket silencioso no qual sua campanha desaparece.
As formas clássicas de terminar aí:
- Uma marca no meio.
utm_medium=facebookCorresponde a nenhuma regra. você queriautm_source=facebook&utm_medium=social. - um meio inventado.
utm_medium=partner,utm_medium=blog,utm_medium=newsletter- todo inglês razoável, tudo invisível às regras do canal Usarreferral,referral, eemailrespectivamente. - Nenhum meio. um URL com apenas
utm_sourceDá uma fonte à GA, mas nada para categorizá-la. - capitais.
Emaileemailsão strings diferentes e GA4 diferencia maiúsculas de minúsculas. Algumas regras de canal são escritas para não diferenciarem maiúsculas de minúsculas e alguns de seus relatórios não serão, o que significa que sua campanha aparecerá como duas linhas com metade dos números cada.
O UTM Builder verifica o par fonte/médio em relação aos mesmos formatos de regras e imprime o canal que espera - E-mail, Pesquisa Paga, Social Orgânico, Referência, Afiliados, Exibição ou um vermelho alto não atribuído. É uma verificação de dois segundos que detecta um erro que você descobriria apenas após o término da campanha, quando os dados já estão errados e não podem ser preenchidos.
Como faço para construir um link UTM corretamente?
Mecanicamente, quatro decisões e uma corda.
Etapa 1: comece pelo URL da página de destino limpa
Use o URL final canônico - aquele com o qual seu site realmente serve https://, sem redirecionamento na frente dele. Isso importa mais do que parece. Se você marcar http://example.com/pricing e seu servidor 301s para https://example.com/pricing, a maioria dos servidores e CDNs preservam a string de consulta, mas nem todas as regras de redirecionamento o fazem, e uma regra que reescreva o caminho com um destino codificado irá descartar tudo silenciosamente após o ?. Redirecionamento de cadeias por meio de encurtadores de links e rastreadores de e-mail adicionam mais lugares para que isso aconteça. Marque o destino, não um trampolim.
Se o URL já tiver uma string de consulta (?plan=pro) ou um fragmento (#features), guarde-os. Um construtor correto anexa &utm_source=… em vez de um segundo ?, e deixa o #fragment bem no final, onde as especificações o colocam - RFC 3986 define a ordem como scheme://authority/path?query#fragment, e um fragmento colocado antes da consulta não é um fragmento, é um URL quebrado.
Etapa 2: preencha a fonte, o meio, a campanha
Escreva-os como se um estranho lesse o relatório em seis meses, porque é isso que acontece. utm_campaign=july-tool-roundup É um nome que você pode decodificar um ano depois. utm_campaign=c3 não é.
Passo 3: normalize os valores
Minúsculas tudo Substituir espaços - quer com hífens (july-tool-roundup) ou deixando o codificador transformá-los em %20. Ambos funcionam; apenas um é legível em um relatório. A codificação por cento não é opcional aqui: um espaço literal em um URL é ilegal por RFC 3986 e, embora os navegadores sejam rescritos, e-mail para clientes e aplicativos de mensagens que dão uma ligação de texto truncarão o link no espaço e entregarão um 404 aos seus usuários.
Passo 4: Envie a corda inteira
Copie o URL finalizado Não edite à mão depois - é aí que está o segundo ? é apresentado.
Para um lançamento com uma dúzia de canais, o modo em lote faz tudo isso em uma única passagem: colar source,medium Um por linha, mantenha o nome da campanha compartilhado entre todos eles e exporte o conjunto como CSV direto para qualquer planilha que você esteja usando para rastrear o lançamento.
Quais convenções uma equipe deve concordar?
Os valores de UTM são texto livre, o que significa que a única coisa que está entre você e trinta variações da mesma campanha é uma convenção que todos seguem. A nossa tem quatro regras:
- minúsculas sempre. Sem exceções, sem chamadas de julgamento.
- Hífens, não sublinhados ou espaços.
black-friday-2026. - O meio vem de uma lista fixa.
email,cpc,social,paid-social,organic,referral,affiliate,display,sms,qr. Se um novo posicionamento não se encaixa em um desses, quase certamente se encaixareferral. - Os nomes das campanhas têm uma data ou uma versão.
launch-v3-2026-07, nãolaunch. Você irá executar a mesma campanha novamente.
A regra do hífen tem uma segunda vida além do UTM: é a mesma regra que governa caminhos de URL legíveis, e é por isso que o gerador de slug e o UTM Builder normaliza o texto da mesma maneira. O Google trata um hífen como um separador de palavras e um sublinhado como um marceneiro - esse é um comportamento documentado para URLs, e aplicá-lo consistentemente aos nomes das campanhas não custa nada.
Se você quiser ser rigoroso sobre isso, escreva a convenção em um documento compartilhado e coloque o Construtor UTM Link no topo. A maioria da derivação de marcação vem de alguém criando um link copiando um antigo e editando-o na barra de endereços.
Onde você nunca deve colocar os parâmetros UTM?
em links internos. Esta é a regra que na maioria das vezes é quebrada com boas intenções.
Marcando um link de sua própria postagem no blog para sua própria página de preços - utm_source=blog&utm_medium=internal- parece que ele vai dizer quais postagens direcionam visualizações de preços O que ele realmente faz no GA4 é iniciar a novo Sessão com uma nova fonte de aquisição. O visitante que chegou do seu boletim informativo, leu uma postagem e clicou em preços para... seu blog. A conversão do boletim informativo desaparece. Você substituiu a resposta à pergunta que estava tentando fazer.
Se você quiser saber quais links internos são clicados, é para isso que serve o rastreamento de eventos ou um relatório de clique de link. UTMs são para o limite - o momento em que alguém cruza de outro lugar para o seu site.
Os outros dois lugares para evitá-los:
- Resultados da pesquisa orgânica. Você não controla esses URLs e, se você marcar uma página e o Google indexar a variante marcada, criou uma duplicata.
- Tudo o que você espera que seja compartilhado. Um link marcado para um fórum é copiado para o Slack, para um boletim informativo, para um tweet, e cada uma dessas visitas agora afirma ser da campanha original. Não está errado, exatamente, mas infla uma linha e deixa as outras desfazer.
Os parâmetros UTM prejudicam o SEO?
Eles criam variantes de URL e variantes de URL podem criar conteúdo duplicado - mas este é um problema resolvido e a solução é uma linha de HTML.
Cada página deve levar um Tag canônica auto-referenciada Apontando para o seu URL limpo:
<link rel="canonical" href="https://toolz.dev/tools/utm-builder" />
Com isso em vigor, ?utm_source=newsletter e ?utm_source=x E o URL simples se consolida em uma página canônica. Os mecanismos de pesquisa indexam a versão limpa, os sinais de classificação se acumulam em um URL em vez de se fragmentarem em vinte, e as variantes marcadas ficam fora do índice. A documentação do próprio Google sobre canonização é explícita de que é para isso que os canônicos servem.
Duas notas práticas Primeiro, verifique se o canônico está realmente lá e realmente se auto-referenciando - um número surpreendente de temas emitem um canônico apontando para a página inicial em cada página, o que é pior do que nenhum canônico em tudo Você pode verificar o que uma página está emitindo com o Gerador de meta tags Como referência para o que parece um bloco de cabeça correto. Em segundo lugar, não bloqueie os parâmetros UTM em robots.txt. O bloqueio de rastreamento não remove os URLs do índice; apenas impede que o Google veja a tag canônica que resolveria a duplicação. o Gerador de Robôs.txt É para controlar caminhos de rastreamento, não para limpar as strings de consulta.
Como os UTMs interagem com códigos QR e canais offline?
É aqui que a marcação de campanha ganha seu sustento, porque offline não tem nenhum referenciador Um cartaz, um crachá de conferência, um adesivo em um laptop, o último slide de uma palestra - uma pessoa digitalizando esse código QR chega ao seu site como puro tráfego direto, indistinguível de alguém digitando o URL A menos que você o tenha marcado.
Marque o URL antes Você gera o código:
https://toolz.dev/tools/utm-builder?utm_source=wordcamp-dhaka&utm_medium=qr&utm_campaign=talk-2026
Em seguida, alimente isso no Gerador de código QR. Duas coisas para assistir URLs longos fazem códigos QR densos - cada caractere extra empurra o símbolo para uma versão mais alta com mais módulos, o que significa que ele precisa ser impresso maior ou digitalizado mais perto Mantenha o URL marcado tão curto quanto a marcação permitir: solte utm_content e utm_term A menos que você realmente precise deles e mantenha os nomes das campanhas concisos. E use um alto nível de correção de erros para qualquer coisa que seja impressa e possa ser arranhada, ao custo de um símbolo um pouco mais denso.
A mesma lógica se aplica a qualquer canal onde o referenciador seja perdido: documentos PDF, assinaturas de e-mail, notas de exibição de podcast lidas em voz alta, links no aplicativo de aplicativos para dispositivos móveis nativos.
Comparação: como os seis parâmetros se comportam
| parâmetro | Sensível a maiúsculas e minúsculas em GA4 | Afeta o agrupamento de canais | Seguro para omitir | erro típico |
|---|---|---|---|---|
utm_source |
sim | Sim (com médio) | não | Usando um valor médio como social como fonte |
utm_medium |
sim | Sim - este é o tal | Tecnicamente, mas não | Colocando uma marca aqui |
utm_campaign |
sim | não | Tecnicamente, mas não | Reutilizando um nome entre os trimestres |
utm_term |
sim | não | sim | Preenchendo para tráfego não pago |
utm_content |
sim | não | sim | Usá-lo como um segundo campo de campanha |
utm_id |
sim | não | sim | confundindo com utm_campaign |
Casos de uso comuns
Um lançamento de um produto em vários canais
Você tem um boletim informativo, três blogs de parceiros, Product Hunt, X, LinkedIn e uma comunidade Slack. Cada um deles precisa de sua própria fonte, o meio certo e o mesmo nome da campanha para que eles se juntem no relatório. É um trabalho de planilha ou trinta segundos de modo de lote: campanha compartilhada, uma linha por canal, saída do CSV. Então você pode responder "qual canal gerou inscrições" em uma consulta em vez de apertar os olhos em um relatório de referência.
Auditoria links que outra pessoa construiu
Agências, parceiros e afiliados enviarão URLs marcados para você, e eles estarão errados. Cole o link no campo de auditoria e o construtor o decompõe de volta em seus parâmetros para que você possa ver o que realmente será registrado. Nove em cada dez vezes, o meio é uma marca e tudo estava indo para o Unsosigned.
Campanhas de e-mail
Cada link em uma transmissão deve ter a mesma fonte e meio (fonte e meio).newsletter / email), a mesma campanha e uma diferente utm_content- hero-cta, body-link, footer-unsubscribe-adjacent. É assim que você aprende onde as pessoas do e-mail realmente clicam, que é a única maneira confiável de melhorar o próximo.
Anúncios pagos
A maioria das plataformas de anúncios pode injetar valores automaticamente - o Google Ads tem marcação automática com o gclid parâmetro, que faz o seu próprio e não necessita de UTMs. Mas se você estiver vendo anúncios em qualquer lugar sem marcação automática, marque-os manualmente: utm_medium=cpc, a verdadeira plataforma em utm_source, e utm_id Defina como o ID da campanha na conta do anúncio para que você possa ingressar em Click Data para custar dados posteriormente.
FAQ
O que é um construtor UTM?
Um construtor UTM é uma ferramenta que monta uma URL marcada por campanha a partir de uma página de destino e os parâmetros UTM que você deseja rastrear Ele lida com as partes mecânicas que você de outra forma erraria à mão - anexando a string de consulta corretamente quando a URL já tem um, valores de codificação por cento, mantendo o fragmento no final - e produz um link que você pode colar em um e-mail, um anúncio ou um código QR.
Quais parâmetros UTM são necessários?
utm_source É o único que o Google Analytics exige estritamente para atribuir uma campanha, mas na prática você deseja utm_source, utm_medium e utm_campaign em cada link. Sem um meio, o GA4 não tem nada para igualar as regras do canal e a sessão geralmente chega sem designação. Sem o nome de uma campanha, seus relatórios agrupam o tráfego em "(não definido)" utm_term e utm_content são refinamentos opcionais.
Qual é a diferença entre utm_source e UTM_MEDIUM?
Fonte é a origem específica do clique - um site, publicação ou lista nomeado, como newsletter, github ou producthunt. O meio é o canal de marketing ao qual a origem pertence, como email, cpc, social ou referral. Fonte é um nome próprio, médio é uma categoria. Se você estiver digitando uma marca no campo médio, as duas foram trocadas.
Os parâmetros UTM são sensíveis a maiúsculas e minúsculas?
Sim. Google Analytics 4 Tratamentos Email, email e EMAIL como três valores distintos, o que divide uma única campanha em três linhas com um terço dos números cada. Mantenha todos os valores em minúsculas e hifenizados de todos os valores em minúsculas e hifenizadas como uma regra rígida O UTM Builder minúsculas valores por padrão e avisa quando sua entrada contém maiúsculas.
Por que meu tráfego UTM está sendo exibido como não atribuído?
quase sempre porque utm_medium está faltando ou detém um valor GA4 não mapeia para um canal GA4 constrói seus grupos de canais padrão a partir de um vocabulário fixo de meios - email, organic, cpc, social, referral, affiliate, display e mais alguns - então utm_medium=facebook ou utm_medium=partner Não corresponde a nada e cai para sem atribuição. usar utm_source=facebook por utm_medium=social em vez disso.
Devo colocar parâmetros UTM em links internos?
não Marcar um link entre duas páginas do seu próprio site inicia uma nova sessão e sobrescreve a fonte de aquisição original, então um visitante que chegou do seu boletim de notícias de repente parece ter vindo do seu próprio blog. Use UTMs apenas em links que apontam para o seu site de outro lugar e use o rastreamento de eventos para medir cliques internos.
Os parâmetros UTM prejudicam o SEO?
Eles criam URLs duplicados para a mesma página, e é por isso que toda página marcada deve carregar uma tag canônica de auto-referência apontando para a URL limpa Com um canônico correto no lugar, os mecanismos de busca consolidam os sinais e as variantes marcadas não são indexadas separadamente Não bloqueie os parâmetros UTM em robots.txt - que impede os rastreadores de ver o canônico que teria corrigido o problema.
Posso construir muitos URLs de campanha de uma só vez?
Sim. O modo em lote leva uma colocação por linha - source, source,medium ou source,medium,content- aplica os valores de campanha compartilhados a cada linha e produz uma URL marcada para cada. Você pode copiar todo o conjunto ou exportá-lo como CSV com o canal previsto incluído, que é a maneira mais rápida de preparar um lançamento ou entregar uma folha de link a um parceiro.
Ferramentas relacionadas: Construtor UTM · gerador de slug · codificador de url · Gerador de código QR · Gerador de meta tags · Gerador de Robôs.txt
Leitura relacionada: O kit de ferramentas do desenvolvedor web · Privacidade de dados e ferramentas online
