설명서Experience Cloud KCS

CDN 또는 Dispatcher가 Adobe Experience Manager을 리디렉션하는 동안 쿼리 매개 변수가 손실됨

마지막 업데이트: 2026년 6월 22일

Adobe Experience Manager as a Cloud Service에서 utm, gclid 및 fbclid와 같은 쿼리 매개 변수는 리디렉션 중에 제거됩니다. CDN이 매개 변수를 삭제하거나 리디렉션이 쿼리 문자열을 무시하면 이 동작은 리디렉션 논리 및 추적에 영향을 줍니다. 이 문제를 해결하려면 CDN 구성을 업데이트하고 올바른 리디렉션 규칙을 사용합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service

Adobe Experience Manager 자산

문제/증상

  • utm_source, utm_campaign 또는 gclid와 같은 UTM 매개 변수는 리디렉션 후 사라집니다.
  • %{QUERY_STRING}에 따른 Dispatcher 리디렉션 규칙은 실행되지 않습니다.
  • CDN 수준 리디렉션은 reqProperty: path을(를) 사용할 때 모든 쿼리 매개 변수를 삭제합니다.
  • 리디렉션은 로컬 또는 AMS에서 작동하지만 클라우드 환경에서는 작동하지 않습니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. Dispatcher에 도달하기 전에 쿼리 매개 변수가 누락되었는지 또는 리디렉션 중에만 손실되었는지 식별합니다.

  2. 다음 구조를 사용하여 저장소에서 cdn.yaml 파일을 만들거나 업데이트합니다.

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

  3. 누락된 rules 속성으로 유효성 검사가 실패하면 requestTransformations 아래에 빈 rules: [ ] 항목을 추가하십시오.

  4. 쿼리 매개 변수가 유지되는지 다시 테스트하고 확인합니다.

  5. cdn.yaml과(와) Dispatcher 구성 모두에서 충돌하는 리디렉션 규칙을 확인하십시오.

  6. CDN 리디렉션을 사용하는 경우 reqProperty: path 대신 reqProperty: url을(를) 설정하십시오.

  7. 일치 및 변형 규칙이 쿼리 매개 변수를 포함하는 URL에 적용되는지 확인합니다.

  8. QSA을(를) 사용하여 쿼리 매개 변수를 보존하도록 Dispatcher 리디렉션 규칙 업데이트:

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

관련 읽기

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