ブラウザのインストールを選択します
Amplitudeをウェブサイトに追加するには、4つの方法があります。 これらの方法は、含まれる製品と SDKバージョンを制御するユーザーによって異なります。 ページごとに1つのメソッドを使用します。 同じページ上の2つのAmplitudeエントリポイントは、イベントを2回送信できる2つのインスタンスを作成します。
インストール方法を選択する
| メソッド | 製品 | バージョン管理 | 最適な用途 |
|---|---|---|---|
| Browser SDK 2(npm または script loader) | 分析。他の製品を個別のパッケージとして追加します。 | あなた | 分析のみが必要なチーム、または最小限のバンドルが必要なチーム |
| Browser Unified SDK(npm) | 分析、セッションリプレイ、機能実験、ガイドとサーベイ | あなた | JavaScriptをバンドルしており、再現可能なビルドが必要なチーム |
| 統合スクリプト (CDN) | 分析、セッションリプレイ、Web実験 | Amplitude | 自動更新による迅速なセットアップ |
| Google タグマネージャーテンプレート | 分析、オプションのセッションリプレイ、ガイドとサーベイ。 | テンプレートのバージョン | Google Tag Managerでタグを管理するチーム |
インストール方法別のプロダクトサポート
| プロダクト | ブラウザ SDK 2 | 統合SDK(npm) | 統合スクリプト (CDN) | GTMテンプレート |
|---|---|---|---|---|
アナリティクス (@amplitude/analytics-browser) | ✅ 込み | ✅ 込み | ✅ 込み | ✅ 込み |
| セッションリプレイ | ➕ 別のパッケージ | ✅ 込み | ✅ 込み | ✅ オプション(チェックボックス) |
| ガイドとサーベイ | ➕ 別のパッケージ | ✅ 込み | ⚠ 個別のスクリプト | ✅ オプション(チェックボックス) |
ウェブ実験 (@amplitude/experiment-tag) | ➕ 個別のスクリプト | ❌ 含まれていません | ✅ 込み | ❌ 非対応 |
機能実験 (@amplitude/experiment-js-client) | ➕ 別のパッケージ | ✅ 込み | ❌ 含まれていません | ❌ 非対応 |
Web 実験と機能実験の比較
- ウェブ実験:ウェブページ上でノーコードのA/Bテストを行うためにビジュアル編集を使用します。 Unified Scriptにはこれが含まれています。
- 機能実験: 実験 JavaScript SDK でコードベースの機能フラグを使用します。 Unified SDKにはこれが含まれています。
各連携サーフェスに適切な実験パッケージを選択するには、実験 JavaScript SDKドキュメントのInstallに移動してください。
Browser SDK 2とUnified SDKのいずれかを選択してください。
Unified SDK(@amplitude/unified)はBrowser SDK 2(@amplitude/analytics-browser)をバンドルしているため、tracking、identity、autocaptureは両方で同じように機能します。 必要な製品で選択してください。
- 分析のみ、または小規模なバンドル: Browser SDK 2をインストールします。必要に応じて製品を1つずつ追加します。
- 1つの呼び出しで設定された2つ以上の製品:Unified SDKをインストールしてください。
統合スクリプト (CDN)
Unified Scriptは、AmplitudeのCDNからAmplitudeブラウザ製品をロードする1つのスクリプトタグです。 Amplitudeは基盤となるSDKのバージョンを制御しているため、Amplitudeはチームからのリリースなしでバグにパッチを適用したり、パフォーマンスを向上させることができます。
- Web Experiment(ビジュアルエディタ)が含まれます(Feature Experimentは含まれません)。
- セッションリプレイとウェブ実験をデフォルト設定でオンにします。
- ガイドとサーベイのコードは大きいため、ガイドとサーベイの場合は別のスクリプトが必要です。
統合スクリプトをインストールする
このスクリプトタグを<head>サイトのに追加し、プロジェクトのAPIキーにAMPLITUDE_API_KEY置き換えます:
<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 はBrowser SDK 2であるため、そのオプションはBrowser 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ドキュメントを参照してください。
Googleタグマネージャー
Amplitude GTMテンプレートは、Browser SDK 2 (@amplitude/analytics-browser)を直接ラップします。Unified SDKやUnified Scriptは使用しません。
- テンプレートのバージョンによって、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.