DocumentaçãoKCS da Experience Cloud

Parâmetros de consulta perdidos durante o redirecionamento do Adobe Experience Manager pelo CDN ou Dispatcher

Última atualização: 22 de junho de 2026

No Adobe Experience Manager as a Cloud Service, parâmetros de consulta como utm, gclid e fbclid são removidos durante os redirecionamentos. Esse comportamento afeta a lógica de redirecionamento e o rastreamento quando o CDN remove parâmetros ou redirecionamentos ignoram a sequência de consulta. Para corrigir esse problema, atualize a configuração da CDN e use as regras de redirecionamento corretas.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service

Ativo do Adobe Experience Manager

Problema/Sintomas

  • Parâmetros UTM como utm_source, utm_campaign ou gclid desaparecem após um redirecionamento.
  • As regras de redirecionamento do Dispatcher que dependem do %{QUERY_STRING} não são executadas.
  • Os redirecionamentos no nível de CDN removem todos os parâmetros de consulta ao usar reqProperty: path.
  • Os redirecionamentos funcionam localmente ou no AMS, mas falham em ambientes na nuvem.

Resolução resolution

Para corrigir esse problema, siga estas etapas:

  1. Identifique se os parâmetros de consulta estão ausentes antes de chegar à Dispatcher ou se foram perdidos apenas durante os redirecionamentos.

  2. Crie ou atualize o arquivo cdn.yaml em seu repositório usando a seguinte estrutura:

    code language-none 
    kind: "CDN"
version: "1"
metadata:
  envTypes: [ "dev", "stage", "prod"]
data:
  requestTransformations:
    removeMarketingParams: false
    rules: [ ]

  3. Se a validação falhar com uma propriedade rules ausente, adicione uma entrada rules: [ ] vazia em requestTransformations.

  4. Teste novamente e confirme se os parâmetros da consulta foram preservados.

  5. Verifique se há regras de redirecionamento conflitantes nas configurações do cdn.yaml e do Dispatcher.

  6. Se estiver usando redirecionamentos CDN, defina reqProperty: url em vez de reqProperty: path.

  7. Confirme se as regras de correspondência e transformação se aplicam aos URLs que incluem parâmetros de consulta.

  8. Atualize as regras de redirecionamento do Dispatcher para preservar os parâmetros de consulta usando QSA:

    code language-none 
    RewriteRule /path$ /target [ R=301,L,QSA]

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles