브라우저 설치 선택

Amplitude를 웹사이트에 추가하는 방법은 네 가지입니다. 방법은 포함되는 제품과 SDK 버전을 제어하는 사람이 다릅니다. 페이지당 하나의 방법을 사용하십시오. 동일한 페이지에 두 개의 Amplitude 엔트리 포인트가 생성되며, 이는 이벤트를 두 번 전송할 수 있는 두 개의 인스턴스를 생성합니다.

설치 방법 선택

설치 방법별 제품 지원

웹 실험과 기능 실험 비교

  • 웹 실험: 웹 페이지에서 코드 없는 A/B 테스트를 위해 시각적 편집을 사용합니다. 통합 스크립트에 포함됩니다.
  • 기능 실험: 실험 JavaScript SDK와 함께 코드 기반 기능 플래그를 사용합니다. 통합 SDK에 포함되어 있습니다.

각 연동 표면에 맞는 실험 패키지를 선택하려면 실험 JavaScript SDK 문서에서 설치로 이동하십시오.

Browser SDK 2와 Unified SDK 중에서 선택

Unified SDK(@amplitude/unified)는 Browser SDK 2(@amplitude/analytics-browser)를 번들로 제공하므로 추적, ID 및 자동 캡처는 두 가지 모두 동일하게 작동합니다. 필요한 제품별로 선택하십시오.

통합 스크립트(CDN)

Unified Script는 Amplitude의 CDN에서 Amplitude 브라우저 제품을 로드하는 하나의 스크립트 태그입니다. Amplitude는 기본 SDK의 버전을 제어하므로 팀의 릴리즈 없이 버그를 패치하거나 성능을 개선할 수 있습니다.

  • 기능 실험이 아닌 웹 실험(시각적 편집기)을 포함합니다.
  • 기본 설정으로 세션 리플레이 및 웹 실험을 켜줍니다.
  • 가이드 및 설문조사 코드가 크기 때문에 가이드 및 설문조사에 별도의 스크립트가 필요합니다.

통합 스크립트 설치

이 스크립트 태그를 사이트의 <head>에 AMPLITUDE_API_KEY추가하고 프로젝트의 API 키로 바꿉니다.

html
<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>

코드에서 옵션을 설정하려면 스크립트 뒤에 직접 호출하십시오init().

html
<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
<script>
  window.amplitude.init("AMPLITUDE_API_KEY", {
    autocapture: true,
    fetchRemoteConfig: true,
  });
  // sampleRate: 1 records every session for testing. Lower it before production. The default, 0, records nothing.
  window.amplitude.add(window.sessionReplay.plugin({ sampleRate: 1 }));
</script>

window.amplitude 는 브라우저 SDK 2이므로 해당 옵션은 브라우저 SDK 2 옵션입니다.

통합 스크립트에 가이드 및 설문조사 추가

통합 스크립트 뒤에 가이드 및 설문조사 스크립트를 추가합니다:

html
<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.engagement.js"></script>
<script>
  window.amplitude.add(window.engagement.plugin());
  window.amplitude.init("AMPLITUDE_API_KEY", {
    fetchRemoteConfig: true,
    autocapture: true,
  });
</script>

구성 옵션을 보려면 가이드 및 설문조사 SDK 문서를 참조하십시오.

구글 태그 관리자

Amplitude GTM 템플릿은 브라우저 SDK 2(@amplitude/analytics-browser)를 직접 감싸줍니다. Unified SDK 또는 Unified 스크립트를 사용하지 않습니다.

  • 템플릿 버전은 SDK 버전을 결정합니다.
  • 이 템플릿은 분석, 세션 리플레이, 가이드 및 설문조사를 지원합니다. 이 템플릿은 웹 실험 또는 기능 실험을 지원하지 않습니다.
  • 세션 리플레이와 가이드 및 설문조사는 기본적으로 꺼져 있습니다.

세션 리플레이와 가이드 및 설문조사를 켜려면:

  1. GTM에서 Amplitude 태그를 엽니다.
  2. 태그 구성에서 세션 리플레이를 선택합니다.
  3. 가이드 및 설문조사를 선택합니다.
  4. 변경 사항을 저장하고 게시합니다.

구성 옵션을 보려면 Google Tag Manager 문서를 참조하십시오.

이 내용이 도움이 되었나요?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

이 페이지에서