AEMaaCS의 백엔드 요청에 마케팅 쿼리 매개 변수가 누락됨
AEM as a Cloud Service에서 utm_*, cid 및 bid과(와) 같은 마케팅 쿼리 매개 변수는 백 엔드 서블릿 또는 서비스에 사용할 수 없습니다. CDN은 요청이 Dispatcher 또는 AEM에 도달하기 전에 이러한 매개 변수를 제거하며, 이는 비즈니스 처리에 CDN을 사용하는 서버측 논리에 영향을 줍니다. 이 문제를 해결하려면 마케팅 쿼리 매개 변수를 유지하도록 CDN 구성을 업데이트합니다.
설명 description
환경
- 제품: Adobe Experience Manager as a Cloud Service - 사이트
- 범위: 2023년 10월 이상에서 만들어진 환경(기본 동작)
문제/증상
utm_source,cid및bid과(와) 같은 마케팅 및 캠페인 관련 쿼리 매개 변수가 브라우저 요청에 표시됩니다.- 이러한 쿼리 매개 변수는 백엔드 서블릿 또는 서비스에 도달하지 않습니다.
- 서버측 로직이 마케팅 쿼리 매개 변수 값에 액세스할 수 없습니다.
해결 방법 resolution
이 문제를 해결하려면 다음 단계를 수행합니다.
- 영향을 받는 환경에 대한
cdn.yaml구성 파일을 엽니다. requestTransformations과(와) 관련된 섹션을 찾습니다.requestTransformations에서removeMarketingParams플래그를false(으)로 설정합니다.- 업데이트된 구성을 저장하고 저장소에 커밋합니다.
- 환경의 구성 파이프라인을 사용하여 업데이트된
cdn.yaml파일을 배포합니다. - 배포가 완료된 후 백엔드 서블릿 및 서비스가 마케팅 쿼리 매개 변수를 수신하는지 확인합니다.
참고:
- 이 동작은 기본적으로 2023년 10월 이후에 생성된 환경에만 적용됩니다. 이전 환경에서는 명시적으로 활성화해야 합니다.
- CDN 수준에서만 제거되므로 브라우저에서 실행되는 클라이언트측 스크립트는 마케팅 쿼리 매개 변수에 계속 액세스합니다.
- Adobe에서는 백엔드 처리에 마케팅 매개 변수가 필요할 때 클라이언트측에서 마케팅 매개 변수를 처리하거나 요청 본문 또는 사용자 지정 헤더를 전달하는 것을 권장합니다.
- 2023년 10월 이전에 생성된 환경에 대한 전역 적용 날짜가 없습니다. 필요한 경우 수동으로 이 동작을 활성화합니다.
experience-cloud-kcs-help-kbarticles