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.

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
- Por que um link com UTM pode chegar como MISS
- Ignorar ou gerar versão própria: o que decidir para cada parâmetro
- Onde cai cada parâmetro comum: ignorar ou manter
- Onde colocar cada parâmetro no campo Drop Query String
- O cabeçalho de resposta é a prova da decisão
- Por que o MISS continua mesmo com a lista certa
Por que um link com UTM pode chegar como MISS
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:
https://exemplo.com.br/promocao/https://exemplo.com.br/promocao/?utm_source=instagramhttps://exemplo.com.br/promocao/?utm_source=newsletter&utm_campaign=marco
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).
- 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.
- 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.
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
- No menu lateral, abra LiteSpeed Cache > Cache.
- Clique na aba Advanced (Avançado).
- Localize o campo Drop Query String. Nas instalações recentes que observamos, ele já vinha com alguns valores preenchidos, como
utm*,gclid,fbclide_ga. Confira o que está lá no seu site. - 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. - Clique em Save Changes (Salvar alterações).
- (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
- Abra uma janela anônima (para não estar logado no WordPress, já que usuário logado normalmente não recebe cache público).
- Pressione F12 e vá na aba Network (Rede).
- Acesse
https://seusite.com.br/?utm_source=teste1. - Clique na primeira linha da lista (o documento HTML) e procure
x-litespeed-cacheem Response Headers. - 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.
Por que o MISS continua mesmo com a lista certa
Mesmo com a lista certa, alguns detalhes mantêm o cache sem efeito:
- Campo não salvo: se você saiu da tela sem clicar em Save Changes, a lista antiga continua valendo. Reabra a aba Advanced e confira se o
_glestá lá. O purge não é necessário para o descarte funcionar; ele só remove cópias antigas. - Teste feito logado: com sessão do WordPress aberta, o plugin pode servir a página sem cache público. Use janela anônima ou o
curl. - Cache de CDN na frente: se o site passa por um CDN com cache próprio, ele tem sua chave separada. O cabeçalho do LiteSpeed pode dar
hitna origem enquanto o CDN trata cada UTM como página nova. Configure o descarte nos dois lugares. - Página excluída do cache: carrinho, checkout e minha conta normalmente ficam fora do cache de propósito. O MISS ali é esperado e não tem relação com parâmetros.
- Parâmetro com nome diferente do esperado: ferramentas de e-mail marketing e encurtadores às vezes acrescentam parâmetros próprios. Abra um link real da campanha, copie a URL que chegou no navegador e confira cada item depois do
?contra a tabela.
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
- Documentação oficial (litespeed) — LSCache Tips. Consultado em 2026-11-12.