Pular para o conteúdo
Documentação API Reference FAQ Changelog Status
Cache e Índices Magento 2 Adobe Commerce

Normalização de Parâmetros de Rastreamento no Cache

PDF

Configure o recurso que evita que parâmetros de rastreamento de links (como srsltid e utm) deixem o cache da sua loja mais lento.

D Daniel Valiati 19/06/2026 6 min de leitura
  • Recurso que evita que os parâmetros de rastreamento dos links (aqueles códigos que o Google e outras plataformas adicionam ao endereço, como srsltid, gclid e utm) deixem o cache da sua loja mais lento.
  • Sem ele, cada clique vindo do Google chega com um código diferente no link e a loja precisa montar a página do zero a cada visita, em vez de entregar a versão pronta que já está guardada (o cache).
  • Atua nos bastidores: o cliente não vê nada diferente, a URL não muda e a navegação continua igual. O ganho é a loja ficar mais rápida para quem chega por esses links.
  • Disponível para lojas Magento 2 que usam o cache interno da plataforma.

Passo a Passo por Escrito

1. Acesse as configurações de cache da loja

No painel administrativo, vá em Stores → Configuration → Advanced → System → Full Page Cache.

As opções deste recurso ficam dentro do bloco de configurações de cache que a sua loja já tem — não há um menu separado para procurar.

Estas opções são globais (valem para a loja inteira). Por isso, no seletor de escopo no canto superior esquerdo, mantenha em Padrão (Default Config). Em uma visão de loja específica os campos aparecem bloqueados com a opção "Usar valor do sistema" — isso é normal.

Resultado esperado: o bloco Full Page Cache é exibido, com as opções de normalização de parâmetros disponíveis.


2. Confirme que o recurso está ativado

Localize o campo Normalizar Query Strings de Rastreamento e deixe em Sim.

Este recurso já vem ativado por padrão. Em geral, você só precisa abrir esta tela se quiser conferir, ajustar a lista de parâmetros ou desativá-lo.

Resultado esperado: o campo Normalizar Query Strings de Rastreamento exibe a opção Sim selecionada.


3. Revise a lista de parâmetros (opcional)

No campo Parâmetros a Normalizar, você define quais parâmetros de rastreamento devem ser ignorados pelo cache. A lista já vem preenchida com os mais comuns: srsltid, gclid, fbclid, utm_source, utm_medium, entre outros.

Para incluir um novo, basta escrevê-lo em uma nova linha.

Inclua apenas parâmetros de rastreamento (que não alteram o conteúdo da página). Nunca adicione parâmetros usados na navegação, como paginação, busca ou filtros de categoria — isso faria a loja exibir a página errada a partir do cache.

Resultado esperado: a lista exibe os parâmetros que serão ignorados pelo cache, um por linha.


4. Ative o registro de diagnóstico (opcional)

O campo Log de Depuração serve para a equipe técnica acompanhar o comportamento do recurso quando há alguma dúvida. Deixe em Não no dia a dia e use Sim apenas durante uma verificação.

Não deixe o Log de Depuração ligado por muito tempo: ele gera um registro a cada acesso e o arquivo cresce rápido. Volte para Não assim que terminar a verificação.

Resultado esperado: o campo Log de Depuração fica em Não (uso normal) ou em Sim (apenas durante um diagnóstico).


5. Salve e limpe o cache

Clique em Save Config no canto superior direito.

Em seguida, vá em System → Cache Management, clique em Flush Magento Cache e aguarde a confirmação.

A limpeza do cache é necessária para que a alteração entre em vigor e para descartar as páginas que já estavam guardadas com os parâmetros antigos.

Resultado esperado: uma mensagem de "You saved the configuration" é exibida e, após a limpeza, o cache passa a aplicar a normalização.


Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Acesso por um link de rastreamento

Ação: abra a sua loja por um link que contenha um parâmetro de rastreamento (por exemplo, um link de resultado do Google que termina com ?srsltid=...).

Resultado esperado: a página abre normalmente, com o mesmo conteúdo da versão sem o parâmetro no endereço.


Teste 2 — Navegação normal preservada

Ação: navegue pela loja usando paginação de categoria, busca por um produto e filtros (navegação por características).

Resultado esperado: tudo funciona como antes — esses recursos não são afetados, pois só os parâmetros de rastreamento são ignorados.


Teste 3 — Velocidade em acessos repetidos

Ação: acesse a mesma página duas vezes seguidas, usando links com parâmetros de rastreamento diferentes.

Resultado esperado: a partir do primeiro acesso, a página passa a ser entregue rapidamente do cache, mesmo com o parâmetro de rastreamento diferente.


Se não funcionar, verifique:

  • O campo Normalizar Query Strings de Rastreamento está em Sim.
  • A configuração foi salva no escopo Padrão (Default Config), e não em uma visão de loja específica.
  • O cache foi limpo em System → Cache Management após salvar.
  • A lista de parâmetros contém apenas parâmetros de rastreamento (sem paginação, busca ou filtros).

Pronto! Dessa forma realizamos a configuração da Normalização de Parâmetros de Rastreamento no Cache em sua loja virtual Magento 2.


Observações Importantes

  • Já vem ativado: o recurso é entregue ligado por padrão, com a lista de parâmetros de rastreamento mais comuns preenchida. Você só precisa mexer se quiser ajustar.
  • Configuração global: vale para a loja inteira, não há ajuste por visão de loja separada.
  • Invisível para o cliente: a URL, os links e o que o cliente vê continuam exatamente iguais. Os códigos de rastreamento continuam chegando normalmente para suas ferramentas de análise — só o cache passa a ignorá-los.
  • Só afeta o que está na lista: parâmetros fora da lista continuam sendo tratados normalmente. Por isso, mantenha na lista apenas parâmetros de rastreamento.

Este recurso funciona com o cache interno da loja. Se a sua loja usa um sistema de cache externo (Varnish), a normalização é feita por lá e este recurso não se aplica.


Referências e Relacionados

  • Gerenciamento de cache da loja: sempre que você alterar uma configuração, é preciso limpar o cache para que a mudança entre em vigor. Entenda como gerenciar e limpar o cache da sua loja.
  • Configurações de Full Page Cache: visão geral das opções de cache de página cheia do Magento, a mesma tela onde este recurso fica.
  • Parâmetros de rastreamento e campanhas (UTM, Google): entenda o que são os códigos adicionados aos links das suas campanhas e como eles aparecem nos endereços da loja.

Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br

Copiar para usar com IA

Este artigo foi útil?

Obrigado pelo seu feedback!