# 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.

> 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.

João Rizzon · 2026-11-14 · Infraestrutura web

---

## 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=instagram`
- `https://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](https://docs.litespeedtech.com/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`, `fbclid` e `_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-cache` em **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 `_gl` está 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 `hit` na 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](https://docs.litespeedtech.com/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.

