Ferramentas de desenvolvedor · Codificador e decodificador URL
Por que & e = não codificados em valores UTM corrompem silenciosamente seus relatórios de campanha
· Por que é importante
codificação de URL rastreamento utm análise
Um nome de campanha contendo & ou = parece adequado no link, mas é dividido em dois parâmetros por todas as ferramentas analíticas. Esta postagem mostra o que acontece, como codificar valores com segurança e como verificar um link antes de ser enviado.
Quando os parâmetros UTM são divididos em caracteres de E comercial não codificados
Um nome de campanha contendo & ou = parece bom quando digitado em um link, mas todo sistema analítico o divide no E comercial e trata o restante como um novo parâmetro. Primavera e Verão tornam-se dois valores de campanha separados nos relatórios. O sinal de igual dentro de um valor cria uma quebra semelhante: utm_campaign=2024=best corrompe silenciosamente o par chave-valor. Esses caracteres são reservados na sintaxe da consulta para estrutura, não para conteúdo, portanto, toda ferramenta que analisa URLs os lê como delimitadores.
O analisador URL não tem como saber que você os considerou dados. Codificá-los como %26 e %3D os preserva como caracteres literais dentro de valores. Sem codificação, seu painel analítico recebe nomes de campanha incompletos ou corrompidos e divide o tráfego em segmentos não intencionais. Um único link compartilhado pode gerar meia dúzia de campanhas fantasmas se o nome contiver vários caracteres especiais.
Como as strings de consulta são analisadas — & separa pares e = separa a chave do valor, sem escape, a menos que você o forneça
A forma como as strings de consulta são analisadas revela por que o "e" comercial e igual é perigoso em valores. O e comercial separa pares chave=valor independentes: ?utm_source=email&utm_campaign=sale significa dois parâmetros separados. Dentro de um valor, o E comercial sem escape termina o par atual e inicia um novo. O sinal de igual separa as chaves dos valores: se utm_campaign=Q3&2024, o analisador vê utm_campaign=Q3 e o parâmetro "2024" órfão sem valor.
Essa análise acontece em várias camadas: o navegador lê URL, o servidor recebe a solicitação e sua plataforma analítica decodifica a string de consulta novamente. Cada camada aplica as mesmas regras e chega à mesma conclusão sobre onde os parâmetros começam e terminam. Você não pode avisar os consumidores posteriores de que seu E comercial é especial; A estrutura URL é determinística e inequívoca.
Quais caracteres precisam de codificação em um valor UTM - &, =, #, ?, espaços e não ASCII, e por que # é o mais sorrateiro
Os caracteres que requerem codificação em valores UTM incluem e comercial, igual, hash, ponto de interrogação, espaços e quaisquer letras ou símbolos não ASCII. O caractere hash é o mais sorrateiro: #anything é tratado como um identificador de fragmento, que o navegador nunca envia ao servidor. O nome da campanha que termina com hash perde tudo antes mesmo que a solicitação saia do seu navegador. Os espaços devem se tornar %20 pelo mesmo motivo estrutural: não são válidos em URLs sem codificação.
Não-ASCII como e acentuado ou caracteres chineses codificados como UTF-8 bytes e depois com escape percentual: e acentuado torna-se %C3%A9. Crie seus links com cuidado ou use um formulário que codifique para você. Ferramentas que permitem colar o nome da campanha e gerar o link completo geralmente realizam essa etapa automaticamente, mas a fórmula da planilha ou a concatenação manual tornam isso de sua responsabilidade.
Exemplo resolvido: codificação de 'Venda e lançamento do terceiro trimestre' como utm_campaign - antes e depois e como o relatório lê cada versão
Exemplo resolvido: codificar "Venda e lançamento no terceiro trimestre" como utm_campaign mostra o problema claramente. Sem codificação, URL termina com E comercial: ?utm_campaign=Q3 Sale &. Rest desaparece ou torna-se um novo parâmetro malformado. Codificado corretamente, %26 substitui o E comercial: ?utm_campaign=Q3%20Sale%20%26%20Launch. O espaço também é codificado como %20. Agora a string inteira chega intacta à sua plataforma de análise e gera relatórios como uma única campanha.
Cole a versão não codificada e a versão codificada em decodificadores URL separados e observe como eles diferem. O formulário codificado decodifica de volta ao texto original com todos os caracteres especiais preservados. Use o codificador URL para verificar qualquer link UTM antes de compartilhá-lo com membros da equipe ou publicá-lo em campanhas de e-mail ou plataformas de mídia social.
Fórmulas de planilhas e construtores de links – onde a codificação acontece ou falha em fluxos de trabalho comuns, descritos de forma geral
Fórmulas de planilhas e construtores de links personalizados geralmente falham porque concatenam strings sem codificação. Uma fórmula CONCATENATE construindo URL pode produzir um texto de aparência perfeitamente válida que quebra quando aberto como link. A codificação deve acontecer dentro da fórmula, não depois. Muitos serviços de encurtamento de links e plataformas de rastreamento de e-mail codificam para você automaticamente, portanto, teste o link gerado em vez de presumir que a construção manual é segura.
Os criadores de campanhas de arrastar e soltar no Google Analytics, HubSpot e plataformas semelhantes lidam com a codificação internamente. Se você estiver criando links manualmente em uma planilha ou colando-os no Slack, presuma que eles não serão codificados automaticamente. Execute o URL final através do decodificador para verificar se todos os caracteres especiais estão representados como %XX antes de distribuir o link.
Erros comuns — codificar URL inteiro e misturar + e %20 para que uma campanha se torne duas
Erros comuns incluem a codificação de URL inteiro, que quebra sua estrutura codificando dois pontos e barras em https://. Outro erro mistura mais e %20 para espaços: alguns sistemas usam mais (codificação de formato legado) enquanto o padrão moderno usa %20. Se um valor de campanha usar mais e outro usar %20, eles aparecerão como campanhas diferentes, embora representem o mesmo texto. Mantenha a consistência e use %20 para componentes URL.
A codificação dupla também acontece quando o construtor de links codifica uma vez e você codifica novamente, produzindo %2526 em vez de %26. Depois de decodificar uma vez, você obtém %26 em vez de E comercial. O caractere torna-se uma string literal de porcentagem dois-seis em vez de e comercial. Verifique as etapas intermediárias em seu processo de construção para garantir que a codificação aconteça exatamente uma vez por valor.
O que isso não cobre: configuração da plataforma analítica e modelos de atribuição
A configuração do Analytics e a modelagem de atribuição dependem inteiramente da obtenção de dados de campanha precisos e consistentes. Se seus valores UTM chegarem distorcidos ou divididos, os relatórios não poderão corresponder às campanhas corretamente e os modelos de atribuição multitoque não conseguirão atribuir crédito com precisão. O erro de codificação único se propaga em todos os relatórios que usam parâmetros, distorcendo significativamente as comparações mês a mês ou de campanha para campanha.
Teste os links da sua campanha antes do lançamento completo. Cole-os no decodificador URL e confirme se cada caractere especial no nome da campanha está codificado corretamente. O codificador URL mostra os formulários codificados e decodificados lado a lado, para que você possa verificar se a codificação ocorreu e a decodificação recupera exatamente o texto original.
Conclusão: codifique cada valor uma vez - como o codificador e decodificador URL produz um valor de consulta seguro a partir de qualquer nome de campanha
A conclusão é simples: codifique cada valor uma vez usando regras de codificação percentual adequadas. O sinal comercial ou de igual dentro do parâmetro UTM deve se tornar %26 ou %3D antes que URL seja finalizado e publicado. O codificador URL no modo de valor único faz essa codificação de forma automática e confiável para você. Cole o nome da sua campanha, selecione o modo Valor e copie o resultado codificado em seu modelo de link.
Cada ferramenta de análise que processa URLs aplica as mesmas regras de análise. Não há como contornar isso e nenhuma ferramenta que possa adivinhar sua intenção ou intenções. A etapa de codificação não é opcional; é a única maneira de preservar caracteres especiais dentro dos valores da string de consulta. Verifique se seus links funcionam conforme o esperado antes de compartilhá-los com as partes interessadas ou publicá-los em campanhas.