[JavaScript SDK] CDN 이슈로 인한 문제 해결

1. 배경

2024년 5월 2일(목) 오전 9시부터 기존에 사용중인 CDN (cdn.jsdelivr.net) 의 인증서가 만료되어, HTML 스크립트 상에 핵클 SDK를 설치하여 사용하시는 경우에 'SDK 초기화'가 되지 않는 문제가 발생하게 되었습니다.

이에 변경된 CDN (fastly.jsdelivr.net) 을 사용하실 수 있도록 조치하였고 아래 코드를 적용해주시면 됩니다.

2. 해결방안

2.1. SDK 초기화

CDN 경로를 fastly.jsdelivr.net 으로 변경하였습니다.

<!-- 기존 코드 head 안에 추가 -->
<script src="https://fastly.jsdelivr.net/npm/@hackler/[email protected]/lib/index.browser.umd.min.js"></script>
<script>
  // YOUR_BROWSER_SDK_KEY로 초기화
  window.hackleClient = Hackle.createInstance("YOUR_BROWSER_SDK_KEY");
</script>

2.2. 사용자 탐색(DevTools) 기능을 사용중인 경우

'사용자 탐색(DevTools)' 기능을 사용중인 경우

CDN 경로를 fastly.jsdelivr.net 으로 변경하였습니다.

<script src="https://fastly.jsdelivr.net/npm/@hackler/javascript-devtools@[1.0.1 혹은 1.0.2]/lib/index.browser.umd.min.js"></script>
<script>
  const config = {
    devTool: HackleDevTools.default,
  };

  // YOUR_BROWSER_SDK_KEY로 초기화
  const hackleClient = Hackle.createInstance(YOUR_BROWSER_SDK_KEY, config);

  // 사용자 탐색을 나타내고 싶은 시점에 Trigger 되도록 해주세요.
  hackleClient.showUserExplorer()

  // 사용자 탐색 창을 닫고 싶을 경우에 Trigger 되도록 해주세요.
  hackleClient.hideUserExplorer()

</script>

2.3. GTM을 통해 이용중인 경우

https://tagmanager.google.com/ 의 해당 컨테이너에 접속합니다.
Templates 메뉴를 클릭합니다.
Hackle Browser SDK를 클릭합니다.
Code 메뉴를 클릭합니다.
9번째 라인의 cdn.jsdelivr.net 을 fastly.jsdelivr.net 으로 수정합니다.
1. cdn. 을 fastly. 으로 변경합니다.
Permission 메뉴를 클릭합니다.
Injects scripts 의 cdn. 을 fastly. 으로 수정합니다.
우측 상단의 'Save' 를 클릭하여 저장합니다.

Updated 8 months ago