설명서Experience Cloud KCS

Adobe Experience Manager에서 해시된 clientlib과 해시되지 않은 clientlib이 함께 로드됩니다

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

Adobe Experience Manager(AEM)에서 경험 조각을 Adobe Target으로 내보내면 동일한 클라이언트 라이브러리의 해시된 버전과 해시되지 않은 버전이 모두 페이지에 로드됩니다. 이 동작으로 인해 가시적인 오류 없이 JavaScript 실행이 중복됩니다. 이 문제를 해결하려면 해시된 클라이언트 라이브러리만 로드되도록 권장 클라이언트 라이브러리 오버레이를 구현합니다.

설명 description

환경

  • 제품: Adobe Experience Manager, Adobe Experience Manager as a Cloud Service(모든 버전)
  • 버전: 6.5
  • 인스턴스: Adobe Target으로 내보낸 경험 조각

문제/증상

  • 경험 조각을 Adobe Target으로 내보내고 Target 기반 페이지에서 전달하면 동일한 클라이언트 라이브러리의 두 버전이 로드됩니다.
  • Target 제공 페이지는 동일한 클라이언트 라이브러리의 두 버전을 로드합니다.
  • 파일 하나에 clientlibs/cws/clientlibs/clientlib-jpm/clientlib-site.min.<project-name>.js과(와) 같은 해시가 포함되어 있습니다.
  • 한 파일에서 해시되지 않은 파일 이름(예: clientlibs/cws/clientlibs/clientlib-jpm/clientlib-site.min.js)을 사용합니다.
  • 두 파일 모두 동일한 JavaScript 코드를 포함합니다.
  • 이 페이지는 오류 메시지를 표시하지 않고 중복 JavaScript을 실행합니다.

원인

기본적으로 AEM 페이지와 내보낸 경험 조각 모두에 동일한 클라이언트 라이브러리를 포함할 수 있으므로 중복 로드가 발생합니다. 오버레이는 의도되고 지원되는 비헤이비어인 페이지의 자체 해시된 클라이언트 라이브러리만 포함하도록 합니다.

해결 방법 resolution

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

  1. 경험 조각 통합 문서를 검토하고 클라이언트 라이브러리 오버레이가 설명된 대로 구현되었는지 확인하십시오.
  2. 오버레이를 적용한 후 해시된 클라이언트 라이브러리(예: clientlib-site.min.<project-name>.js)만 Target이 배달된 페이지에 로드되는지 확인합니다.
  3. 해시되지 않은 버전(clientlib-site.min.js)이 더 이상 페이지 소스에 없는지 확인합니다.
  4. 페이지를 테스트하여 중복된 JavaScript 실행이 없으며 모든 예상 기능이 있는지 확인합니다.

관련 읽기

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