blog
Infraestrutura web

Link com UTM ou _gl pode furar o cache: como decidir cada parâmetro

Cada parâmetro da URL precisa ser classificado: ou o cache ignora, ou ele gera uma versão própria da página. O cabeçalho X-LiteSpeed-Cache mostra se a sua escolha funcionou, inclusive para o _gl do GA4.

JR · · 9 min de leitura · 1 tabela · 2 blocos de código

Resposta curta: o cache do LiteSpeed usa a URL inteira como chave, então cada valor de um parâmetro que não esteja em Drop Query String vira uma página nova e chega como MISS. Instalações recentes do plugin costumam já trazer utm*, gclid e fbclid nesse campo; o que normalmente falta é o _gl do GA4.

Neste artigo
  1. Por que um link com UTM pode chegar como MISS
  2. Ignorar ou gerar versão própria: o que decidir para cada parâmetro
  3. Onde cai cada parâmetro comum: ignorar ou manter
  4. Onde colocar cada parâmetro no campo Drop Query String
  5. O cabeçalho de resposta é a prova da decisão
  6. Por que o MISS continua mesmo com a lista certa

O cache de página guarda uma cópia pronta do HTML e a entrega sem rodar o PHP do WordPress. Para saber se já tem essa cópia, ele procura por uma chave de cache. No LiteSpeed, essa chave é montada a partir da URL, e a URL inclui a parte depois do ?, a chamada query string.

Na prática, para o cache estas três URLs são três páginas diferentes:

O HTML das três é idêntico. O parâmetro utm_source só existe para o Google Analytics ler no navegador. O servidor não muda nada por causa dele. Mesmo assim, se o parâmetro não estiver na lista de descarte, a primeira visita de cada combinação vira um MISS: o WordPress gera a página do zero, o cache guarda mais uma cópia e só a próxima visita com exatamente a mesma URL recebe o HIT.

Campanha de e-mail ou anúncio costuma mandar muita gente de uma vez, com parâmetros que variam por peça. O resultado é o pior cenário: o pico de tráfego cai justamente na versão que não está em cache. A página LSCache Tips é a documentação oficial da LiteSpeed com dicas de configuração do LSCache e o lugar para conferir esse comportamento na sua versão.

Ignorar ou gerar versão própria: o que decidir para cada parâmetro

Quase todo parâmetro que aparece nas suas URLs cai em uma de duas categorias. A exceção é o parâmetro ligado a conteúdo personalizado, em que a saída certa é uma terceira: excluir a URL do cache (veja o identificador de sessão, mais abaixo).

  1. Ignorar (descartar da chave): o parâmetro não altera o HTML que o servidor devolve. Ele é lido só pelo JavaScript no navegador, ou não é lido por ninguém. O cache deve tratá-lo como se não existisse.
  2. Gerar versão própria (manter na chave): o parâmetro muda o conteúdo da página. Uma busca, um filtro de produto, uma paginação. Se você descartar esse parâmetro, o visitante recebe a página errada.

O critério é uma pergunta só: abrindo a URL com e sem o parâmetro, o HTML que chega do servidor é o mesmo? Se for, ignore. Se não for, mantenha.

O erro de descartar um parâmetro que muda o conteúdo é mais grave que o erro contrário. Deixar um UTM na chave custa desempenho. Descartar um filtro de loja entrega para um cliente a lista de produtos que outro cliente filtrou.

Decidir cada parâmetro antes de mexer no cacheO parâmetro muda o HTML do servidor?Não: ignorar, descartar da chaveSim: manter na chaveConteúdo personalizado: excluir a URL

Onde cai cada parâmetro comum: ignorar ou manter

A tabela abaixo é um ponto de partida para um WordPress típico. Confira no seu site antes de aplicar, porque um plugin pode usar um nome parecido para outra função.

Parâmetro Quem coloca Muda o HTML do servidor? Decisão
utm_source, utm_medium, utm_campaign, utm_term, utm_content Você, em links de campanha Não Ignorar (use utm*)
_gl Google Analytics 4 / gtag, na vinculação entre domínios Não Ignorar
_ga Versões antigas da vinculação entre domínios Não Ignorar
gclid Google Ads Não Ignorar
fbclid Links clicados no Facebook e Instagram Não Ignorar
s Busca nativa do WordPress Sim Manter
orderby, filter_*, min_price WooCommerce e plugins de filtro Sim Manter
lang Alguns plugins de tradução Sim Manter
Identificador de sessão na URL (ex.: sid) Plugins antigos ou sistemas externos Depende Ignorar ou excluir a URL do cache (ver abaixo)

Por que o `_gl` não pode ficar de fora

Quando você configura a vinculação entre domínios no GA4 (por exemplo, site em um domínio e checkout em outro), o gtag acrescenta _gl=... aos links que cruzam os domínios. O valor muda a cada clique, porque carrega dados do visitante. Se _gl ficar na chave de cache, cada visita vinda do outro domínio gera uma URL nova e, portanto, um MISS. Configurar só os utm* e esquecer o _gl deixa exatamente esse tráfego sem cache.

Quando um identificador de sessão na URL exige excluir a página do cache

Aqui a decisão exige olhar o que o parâmetro faz. Se ele só serve para um sistema externo rastrear a visita, ignore. Se o WordPress usa esse valor para montar um conteúdo personalizado (carrinho, área logada), a página não deveria estar em cache de forma pública. Nesse caso, o caminho certo é excluir aquela URL do cache, não descartar o parâmetro.

Onde colocar cada parâmetro no campo Drop Query String

O plugin LiteSpeed Cache para WordPress tem um campo próprio para listar parâmetros que devem ser ignorados na chave. Ele se chama Drop Query String (em português, algo como Descartar Query String). Os caminhos de menu, os valores padrão e o uso do curinga descritos abaixo são observação do painel do plugin, não parâmetro documentado na fonte citada; nomes e posições podem mudar entre versões.

Exporte as configurações antes de mexer

A alteração é de baixo risco, mas faça uma cópia antes. No painel do WordPress, entre em LiteSpeed Cache > Toolbox (Ferramentas) > Import / Export e clique em Export para baixar um arquivo com todas as configurações do plugin. Se algo der errado, você importa esse arquivo de volta na mesma tela.

Como adicionar os parâmetros na lista, passo a passo

  1. No menu lateral, abra LiteSpeed Cache > Cache.
  2. Clique na aba Advanced (Avançado).
  3. Localize o campo Drop Query String. Nas instalações recentes que observamos, ele já vinha com alguns valores preenchidos, como utm*, gclid, fbclid e _ga. Confira o que está lá no seu site.
  4. Acrescente, um por linha, os parâmetros que você classificou como ignorar e que ainda não estão na lista. O mais comum de faltar é o _gl.
  5. Clique em Save Changes (Salvar alterações).
  6. (Opcional) Purgue o cache: na barra superior do WordPress, passe o mouse no ícone do LiteSpeed e escolha Purge All (Limpar tudo). O descarte já vale na próxima requisição; o purge só limpa as cópias antigas guardadas com o parâmetro na chave.

No painel, o asterisco funciona como curinga (comportamento observado; confira o texto de ajuda abaixo do campo): utm* cobre utm_source, utm_medium e qualquer outro que comece com utm. Não use curinga curto demais, como s*, porque ele pegaria o parâmetro de busca s e quebraria a busca do site.

Um exemplo de como o campo pode ficar (exemplo, não lista oficial):

utm*
gclid
fbclid
_ga
_gl

Como desfazer se a busca ou um filtro passar a mostrar conteúdo errado

Se a busca, um filtro ou a tradução passar a mostrar conteúdo errado depois da mudança, apague do campo a última linha que você adicionou, salve e rode Purge All de novo. Se não souber qual linha causou o problema, importe o arquivo exportado no começo.

O cabeçalho de resposta é a prova da decisão

Não confie na configuração sem conferir. O LiteSpeed devolve um cabeçalho chamado X-LiteSpeed-Cache em cada resposta. O valor hit indica que a página veio do cache. O valor miss indica que o WordPress gerou a página naquela requisição. Esse cabeçalho é a evidência de que o parâmetro foi de fato descartado da chave.

Como ver o cabeçalho X-LiteSpeed-Cache pelo navegador

  1. Abra uma janela anônima (para não estar logado no WordPress, já que usuário logado normalmente não recebe cache público).
  2. Pressione F12 e vá na aba Network (Rede).
  3. Acesse https://seusite.com.br/?utm_source=teste1.
  4. Clique na primeira linha da lista (o documento HTML) e procure x-litespeed-cache em Response Headers.
  5. Agora acesse https://seusite.com.br/?utm_source=teste2, com um valor que você nunca usou.

Se o descarte está funcionando, a segunda URL já chega com hit, porque para o cache ela é a mesma página da primeira. Se chega miss, o parâmetro ainda está na chave.

Como conferir o cabeçalho com curl no terminal

Se você tem um terminal à mão, o teste é copiar e colar. No Mac e no Linux, use os comandos como estão. No Windows, rode no Prompt de Comando (cmd) ou, no PowerShell, troque curl por curl.exe. No Windows PowerShell 5.1, que é o padrão, curl é um apelido do comando Invoke-WebRequest, e curl -I termina com uma mensagem de erro em vermelho que começa com Invoke-WebRequest. Se vir isso, repita com curl.exe -I.

curl -I "https://seusite.com.br/?_gl=teste123"
curl -I "https://seusite.com.br/?_gl=outrovalor456"

O -I pede só os cabeçalhos, sem baixar a página. Troque seusite.com.br pelo seu domínio. Na saída, procure a linha x-litespeed-cache. O esperado, com _gl na lista de descarte, é a segunda linha de comando mostrar x-litespeed-cache: hit. Se aparecer miss nas duas, purgar não resolve: confira se o campo foi salvo, se o teste não foi feito logado, se há um CDN na frente e se a página não está excluída do cache (veja a lista de erros no fim).

Como provar que a busca continua gerando versão própria

Faça a mesma verificação com um parâmetro que deve gerar versão própria, como a busca: ?s=camiseta e depois ?s=sapato. Aqui o esperado é o oposto: a primeira visita de cada termo vem como miss e os resultados mostrados são diferentes. Se a segunda busca devolver os resultados da primeira, algum curinga está largo demais.

Sequência para aplicar e validar o descarteExportar configuraçõesBackup antes de qualquer mudançaAdicionar parâmetrosUm por linha, na aba AdvancedSalvar alteraçõesConfirmar que a lista ficou gravadaTestar X-LiteSpeed-CacheEsperar hit na segunda URL

Por que o MISS continua mesmo com a lista certa

Mesmo com a lista certa, alguns detalhes mantêm o cache sem efeito:

A documentação LSCache Tips é a referência oficial para esses ajustes e vale ser consultada quando o servidor não for o LiteSpeed padrão de hospedagem compartilhada, porque a forma de configurar pode mudar conforme a edição do servidor.

Referências

  1. Documentação oficial (litespeed) — LSCache Tips. Consultado em 2026-11-12.
Leia também