브라우저 설치 선택
Amplitude를 웹사이트에 추가하는 방법은 네 가지입니다. 방법은 포함되는 제품과 SDK 버전을 제어하는 사람이 다릅니다. 페이지당 하나의 방법을 사용하십시오. 동일한 페이지에 두 개의 Amplitude 엔트리 포인트가 생성되며, 이는 이벤트를 두 번 전송할 수 있는 두 개의 인스턴스를 생성합니다.
설치 방법 선택
| 메서드 | 제품 | 버전 관리 | 최적의 용도 |
|---|---|---|---|
| 브라우저 SDK 2(npm 또는 스크립트 로더) | 분석. 다른 제품을 별도의 패키지로 추가하십시오. | 사용자 | 분석 또는 가장 작은 번들만 필요한 팀 |
| Browser Unified SDK (npm) | 분석, 세션 리플레이, 기능 실험, 가이드 및 설문조사 | 사용자 | JavaScript를 번들링하고 재현 가능한 빌드가 필요한 팀 |
| 통합 스크립트(CDN) | 분석, 세션 리플레이, 웹 실험 | Amplitude | 자동 업데이트를 통한 빠른 설정 |
| 구글 태그 관리자 템플릿 | 분석, 선택적 세션 리플레이, 가이드 및 설문조사 포함 | 템플릿 버전 | Google Tag Manager에서 태그를 관리하는 팀 |
설치 방법별 제품 지원
| 제품 | 브라우저 SDK 2 | 통합 SDK(npm) | 통합 스크립트(CDN) | GTM 템플릿 |
|---|---|---|---|---|
분석(@amplitude/analytics-browser) | ✅ 포함됨 | ✅ 포함됨 | ✅ 포함됨 | ✅ 포함됨 |
| 세션 리플레이 | ➕ 별도 패키지 | ✅ 포함됨 | ✅ 포함됨 | ✅ 선택 사항(확인란) |
| 가이드 및 설문조사 | ➕ 별도 패키지 | ✅ 포함됨 | ⚠ 별도의 스크립트 | ✅ 선택 사항(확인란) |
웹 실험(@amplitude/experiment-tag) | ➕ 별도의 스크립트 | ❌ 포함되지 않음 | ✅ 포함됨 | ❌ 지원되지 않음 |
기능 실험(@amplitude/experiment-js-client) | ➕ 별도 패키지 | ✅ 포함됨 | ❌ 포함되지 않음 | ❌ 지원되지 않음 |
웹 실험과 기능 실험 비교
- 웹 실험: 웹 페이지에서 코드 없는 A/B 테스트를 위해 시각적 편집을 사용합니다. 통합 스크립트에 포함됩니다.
- 기능 실험: 실험 JavaScript SDK와 함께 코드 기반 기능 플래그를 사용합니다. 통합 SDK에 포함되어 있습니다.
각 연동 표면에 맞는 실험 패키지를 선택하려면 실험 JavaScript SDK 문서에서 설치로 이동하십시오.
Browser SDK 2와 Unified SDK 중에서 선택
Unified SDK(@amplitude/unified)는 Browser SDK 2(@amplitude/analytics-browser)를 번들로 제공하므로 추적, ID 및 자동 캡처는 두 가지 모두 동일하게 작동합니다. 필요한 제품별로 선택하십시오.
- 분석 전용 또는 소규모 번들: Browser SDK 2를 설치합니다. 필요에 따라 제품을 하나씩 추가하십시오:
- 하나의 호출로 구성된 두 개 이상의 제품: Unified SDK 설치.
통합 스크립트(CDN)
Unified Script는 Amplitude의 CDN에서 Amplitude 브라우저 제품을 로드하는 하나의 스크립트 태그입니다. Amplitude는 기본 SDK의 버전을 제어하므로 팀의 릴리즈 없이 버그를 패치하거나 성능을 개선할 수 있습니다.
- 기능 실험이 아닌 웹 실험(시각적 편집기)을 포함합니다.
- 기본 설정으로 세션 리플레이 및 웹 실험을 켜줍니다.
- 가이드 및 설문조사 코드가 크기 때문에 가이드 및 설문조사에 별도의 스크립트가 필요합니다.
통합 스크립트 설치
이 스크립트 태그를 사이트의 <head>에 AMPLITUDE_API_KEY추가하고 프로젝트의 API 키로 바꿉니다.
<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
코드에서 옵션을 설정하려면 스크립트 뒤에 직접 호출하십시오init().
<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 옵션입니다.
통합 스크립트에 가이드 및 설문조사 추가
통합 스크립트 뒤에 가이드 및 설문조사 스크립트를 추가합니다:
<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 버전을 결정합니다.
- 이 템플릿은 분석, 세션 리플레이, 가이드 및 설문조사를 지원합니다. 이 템플릿은 웹 실험 또는 기능 실험을 지원하지 않습니다.
- 세션 리플레이와 가이드 및 설문조사는 기본적으로 꺼져 있습니다.
세션 리플레이와 가이드 및 설문조사를 켜려면:
- GTM에서 Amplitude 태그를 엽니다.
- 태그 구성에서 세션 리플레이를 선택합니다.
- 가이드 및 설문조사를 선택합니다.
- 변경 사항을 저장하고 게시합니다.
구성 옵션을 보려면 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.