Browser Unified SDKイベントを確認します。
Browser Unified SDKは、バンドルされたBrowser SDK 2を通じて分析イベントを送信します。分析イベントは、Browser SDK 2と同じ4つの段階(キャプチャ、変換、送信、受信)を経ます。このページでは、初期化から始まるUnified SDK固有のチェックについて説明し、他の段階についてはBrowser SDK 2のステップへのリンクを説明します。
| ステージ | 質問 | どこを調べるか |
|---|---|---|
| 初期化済み | 使用しているすべてのプロダクトを設定しましたかinitAll()? | アクセサとブラウザのネットワークタブ |
| キャプチャ | SDKは呼び出しを受け入れましたか? | デバッグログ |
| 変換 | プラグインは何を追加、変更、削除しましたか? | 検査プラグイン |
| 送信済み | リクエストがブラウザを離れたか?また、どのようなペイロードで離れたか? | ブラウザのネットワークタブ |
| 受信済み | Amplitudeはイベントを受け入れ、保存しましたか? | アップロード結果とユーザー検索 |
すべてのAmplitude SDKに共通する問題については、「SDKのトラブルシューティングとデバッグ」を参照してください。バージョン間の変更点については、@amplitude/unifiedchangelogを参照してください。
デバッグログを有効にする
analytics内側logLevelに渡します。セッションリプレイは同じロガーを通じてログに記録されるため、そのメッセージはアナリティクスメッセージとともに表示されます。
amplitude.initAll("YOUR_API_KEY", {
analytics: { logLevel: amplitude.Types.LogLevel.Debug },
});
ログレベルと各メッセージの内容については、「Browser SDK 2でデバッグログを有効にする」を参照してください。リリースWarn前に元に戻してください。logLevel
各プロダクトが初期化されたことを確認してください
Await initAll()したら、そのアクセサを使用して各プロダクトを確認してください:
await amplitude.initAll("YOUR_API_KEY", {
sessionReplay: { sampleRate: 1 },
});
console.log(amplitude.sessionReplay()?.getSessionReplayProperties());
// { "[Amplitude] Session Replay ID": "..." } while recording; {} when not
console.log(typeof amplitude.experiment()?.fetch);
// "function"
ブラウザのネットワークタブで、絞り込みを行い、amplitude.com以下のリクエストを探します:
| プロダクト | リクエスト | いつ |
|---|---|---|
| セッションリプレイ | sr-client-cfg.amplitude.com/config/<API key> (sr-client-cfg.eu.amplitude.com EUの場合) | 期間中initAll() |
| セッションリプレイ | api-sr.amplitude.com/sessions/v2/track (api-sr.eu.amplitude.com EUの場合) | セッションの記録中、 |
| 機能実験 | api.lab.amplitude.com/sdk/v2/vardata (api.lab.eu.amplitude.com EUの場合) | fetch()を呼び出した後にのみ |
| ガイドとサーベイ | cdn.amplitude.com/engagement-browser/...、次にgs.amplitude.com/sdk/v1/... | 期間中initAll()、skip〜でない限り |
getSessionReplayProperties()が{}返されている場合、セッションリプレイは録画されていません。このメッセージのログを確認してください。次に、0以上sampleRateであることを確認します。Session ... not being captured due to capture being disabled for project or because the remote config could not be fetched.
SDKが送信した内容を確認する
api2.amplitude.com/2/httpapi(EU用)api.eu.amplitude.comのリクエストを見つけ、そのペイロードを開きます。各Unified SDKイベントのlibraryフィールドには、2つのバージョン番号が含まれています。
{
"event_type": "Sign Up Clicked",
"library": "amplitude-ts-unified/1.1.43-amplitude-ts/2.48.1"
}
最初のバージョンは@amplitude/unifiedです。 2つ目は、バンドルされているBrowser SDK 2です。Browser SDK 2のリリースノートと動作を比較する場合は、2番目のバージョンを使用してください。 ペイロードフィールドと圧縮については、Browser SDK 2でSDKが送信した内容を確認するを参照してください。
これは役に立ちましたか?
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.