イベントとプロパティを自動キャプチャする

このリファレンスでは、ブラウザSDK 2を使用する場合のウェブ用の自動キャプチャイベントタイプとイベントプロパティ名について説明しています。このリファレンスを使用して、Amplitudeが自動的にキャプチャするものを理解したり、トラッキングプランを設定したり、パイプラインと検証を設定したりできます。

このページの機械可読バージョンについては、「Web自動キャプチャスキーマ」を参照してください。ネイティブのiOSおよびAndroid自動キャプチャイベントプロパティについては、モバイル自動キャプチャスキーマに移動してください。

共有規約

太字のプロパティ名（ページURLなど）は、Amplitudeでの表示方法を反映しています。
自動キャプチャでは、一部のプロパティに[Amplitude]が接頭辞として付けられています。Amplitudeはこれらを自動的に生成し、読み取り専用としてマークします。
Browser SDK 2のAutocaptureOptionsを通じてAmplitudeがキャプチャするイベントを設定します。

セッション

セッションが開始されました

ユーザーセッションが開始された時点（最初のページ読み込み時または一定期間の非アクティブ状態の後のいずれか）をキャプチャします。

プロパティ名	概要
収集されたプロパティはありません

セッションが終了しました

非アクティブまたはブラウザのタブが閉じられたためにユーザーセッションが終了したときにキャプチャされます。

プロパティ名	概要
収集されたプロパティはありません

ページビュー数

ページの閲覧

ユーザーがページをロードまたは移動するたびに記録します。これには単一ページのアプリルート変更が含まれます。

プロパティ名	概要
ページのドメイン	現在のWebアドレスの完全なホスト名。`www`や`app`などのサブドメインを含みます。
ページの位置	現在ページの完全なURL（すべてのURL検索パラメータを含む）。
ページパス	現在のページのパス名。これには、URL検索パラメータとURLフラグメントは含まれません。
ページタイトル	ページのタイトルです。
ページURL	URL検索パラメータを除いたページのURL。

ファイルのダウンロード

ユーザーがファイルのダウンロードをトリガーするリンクをクリックしたときにキャプチャされます。

プロパティ名	概要
ファイル拡張子	ダウンロードしたファイルの拡張子です。たとえば、.pdf、.docx、.zip などです。
ファイル名	ダウンロードしたファイルのフルパス名。これには、ファイルのファイル名だけでなく、その他のものが含まれます。
リンクID	リンク要素のID。
リンクテキスト	リンク要素のテキストコンテンツ。
リンクURL	ファイルのダウンロード用のリンクアドレスです。

フォームの操作

自動キャプチャは、<form>タグを使用するフォームをキャプチャします。

フォームの開始

ユーザーが最初にフォーム要素と対話した時点をキャプチャします。これには、テキスト入力、ラジオボタン、ドロップダウンへの変更が含まれます。

プロパティ名	概要
フォームの送信先	form要素のaction属性。たとえば、`<form action="/subscribe">` の場合、値は `/subscribe` です。
フォームID	フォーム要素のID。
フォーム名	form要素のname属性です。

フォームの送信

ユーザーがフォームを送信したときにキャプチャされます。

プロパティ名	概要
フォームの送信先	form要素のaction属性。たとえば、`<form action="/subscribe">` の場合、値は `/subscribe` です。
フォームID	フォーム要素のID。
フォーム名	form要素のname属性です。

要素のインタラクション

エレメントのクリック

ページ要素に対するクリックをキャプチャします。

デフォルト設定では、ページ上のインタラクティブ要素とのユーザーのやり取りが記録されます。デフォルトでは、テキストを強調表示するためのクリックや空白スペースのクリックなどのイベントノイズが排除されます。デフォルトでは、次の項目がキャプチャされます。

フォーム要素に対するすべてのクリック: <a>、button、input、select、text area、label、およびcontentEditableがtrueに設定されている要素。
ビデオおよびオーディオ要素に対するすべてのクリック。
ページ上の変更（モーダルの表示など）が発生する、または別のページに移動する特定の要素に対するクリック。これらの要素には、div、span、およびヘッダーが含まれます。
属性が data-amp-default-track であるか、クラスが amp-default-track である要素に対するすべてのクリック。
この設定をカスタマイズして、セレクタを追加または削除できます。 Amplitudeがこれらのセレクターを常に追跡するか、クリックの結果ページが変更された場合にのみ追跡するかを選択できます。

プロパティ名	概要
エレメント ID	HTML 要素の`id`属性。例えば、`myID`を持つ要素は`id="myID"`という値を生成します。
要素クラス	HTML 要素の`class`属性。例えば、`myClass`を持つ要素は`class="myClass"`という値を生成します。
要素タグ	HTML 要素のタグ名です。例えば、`<a>`要素は`a`という値を生成します。
要素テキスト	HTML 要素のテキストコンテンツ (`innerText`) です。これは、要素クリックイベントにのみ適用されます。たとえば、「Home」というテキストを含むリンクは、値 `Home` を生成します。
要素 Href	HTML 要素の`href`属性。これは、エレメントクリックイベントの`<a>`タグにのみ適用されます。 Amplitudeは、128バイトを超える値を切り捨てます。
左側の要素位置	画面ビューの左側から要素までの距離（ピクセル単位）。たとえば、`600`の値は、要素が左から600px離れたことを意味します。
エレメントの位置上部	画面ビューの上部から要素までの距離（ピクセル単位）。たとえば、`400` の値は、要素が上から400px離れていることを意味します。
ビューポートの高さ	要素がクリックされた時のビューポートの高さ（ピクセル単位）。たとえば、`900` の値はビューポートの高さが900ピクセルであることを意味します。
ビューポートの幅	要素がクリックされた時のビューポートの幅（ピクセル単位）。たとえば、`1200` の値はビューポートの幅が 1200 ピクセルであることを意味します。
ページURL	要素がクリックされたページの URL。
ページタイトル	要素がクリックされたページのページタイトル。
エレメント階層	クリックされた要素とその親または兄弟要素の DOM 要素と属性。 Amplitudeはこれを視覚的なラベル付けに使用しています。
エレメントセレクター	エレメント階層構造を採用するため、非推奨となっています。要素の一意のCSSセレクターです。例えば、`#myID`を持つ要素は`id="myID"`という値を生成します。
要素属性	`dataAttributePrefix`設定を通じてクリックイベントに関連付けられた固有の属性。たとえば、属性 `id="feature-start"` を持つ要素は、値 `feature-start` を持つプロパティ `[Amplitude] Element Attributes.id` を生成します。
要素アリアラベル	テキストが表示されない対話型要素に使用される、要素の `aria-label`。例えば、`Close`を持つ要素は`aria-label="Close"`という値を生成します。
要素の親ラベル	要素の親要素（または、1レベルの親要素に見つからない場合は上位の先祖要素）内のテキストラベル。

エレメントの変更

ドロップダウンへの変更やテキストボックスへのテキスト入力など、フォーム要素の相互作用をキャプチャします。

プロパティ名	概要
エレメント ID	HTML 要素の`id`属性です。
要素クラス	HTML 要素の`class`属性です。
要素タグ	HTML 要素のタグ名です。
左側の要素位置	画面ビューの左側から要素までの距離（ピクセル単位）。
エレメントの位置上部	画面ビューの上部から要素までの距離（ピクセル単位）。
ビューポートの高さ	要素が変更されたときのビューポートの高さ（ピクセル単位）。
ビューポートの幅	要素が変更されたときのビューポートの幅（ピクセル単位）。
ページURL	要素が変更されたページのURL。
ページタイトル	要素が変更されたページのページタイトル。
エレメント階層	変更された要素のDOM要素と属性、およびその親要素や兄弟要素。Amplitudeはこれを視覚的なラベル付けに使用しています。
エレメントセレクター	エレメント階層構造を採用するため、非推奨となっています。要素の一意の CSS セレクターです。
要素属性	`dataAttributePrefix`設定を通じて変更イベントに関連付けられた固有の属性。
要素アリアラベル	要素の `aria-label`。テキストが表示されない対話型要素に使用されます。
要素の親ラベル	要素の親要素（または、1レベルの親要素に見つからない場合は上位の先祖要素）内のテキストラベル。

ネットワーク要求

アプリケーションがネットワーク要求を行ったときにキャプチャします。デフォルトでは、Amplitudeは500～599の範囲のレスポンスコードを持つネットワークリクエストを追跡し、amplitude.comドメインに対して行われたリクエストを除外します。

ネットワークリクエストの追跡を有効にするには、SDK 設定でconfig.autocapture.networkTrackingをtrueに設定してください。

プロパティ名	概要
[Amplitude] URL	機密情報がマスクされているネットワーク要求のURL。
[Amplitude] URLクエリ	URLのクエリパラメータ。
[Amplitude] URL フラグメント	URL のフラグメント識別子です。
[Amplitude] リクエストメソッド	リクエストに使用されたHTTPメソッド（GET、POST、PUT、またはDELETEなど）。
[Amplitude]ステータスコード	レスポンスのHTTPステータスコード。
[Amplitude] エラーコード	要求がステータスコードなしで失敗した場合のローカルエラーコード。
[Amplitude] エラーメッセージ	要求がステータスコードなしで失敗した場合のローカルエラーメッセージ。
[Amplitude] 開始時間	要求が開始された時のタイムスタンプ（Unix時代からのミリ秒単位）。
[Amplitude] 完了時間	要求が完了した時のタイムスタンプ（Unix時代からのミリ秒単位）。
[Amplitude] 持続時間	リクエストの継続時間（ミリ秒単位）。
[Amplitude]リクエストボディサイズ	リクエストボディのサイズ（バイト単位）。
[Amplitude]レスポンスボディサイズ	レスポンスボディのサイズ（バイト単位）。
[Amplitude]リクエスト本文	キャプチャされた JSON リクエスト本文（`requestBody`キャプチャルールを設定した場合）。
[Amplitude] レスポンスボディ	キャプチャされた JSON レスポンス本文（`responseBody`キャプチャルールを設定した場合）。

高度なキャプチャルールやフィルタリングオプションなど、ネットワーク追跡の設定方法の詳細については、ブラウザSDK 2のドキュメントにある「ネットワーク要求の追跡」を参照してください。

Web Vitals

ブラウザのタブが非表示になったときに、Core Web Vitalsのパフォーマンス指標をキャプチャします。

プロパティ名	概要
ページのドメイン	現在のWebアドレスの完全なホスト名。`www`や`app`などのサブドメインを含みます。
ページの位置	現在ページの完全なURL（すべてのURL検索パラメータを含む）。
ページパス	現在のページのパス名。これには、URL検索パラメータとURLフラグメントは含まれません。
ページタイトル	ページのタイトルです。
ページURL	URL検索パラメータを除いたページのURL。
LCP (Largest Contentful Paint)	最大のコンテンツ要素がビューポートに表示されるまでにかかる時間。単位はミリ秒です。
FCP（ファースト・コンテントフル・ペイント）	最初のコンテンツ要素が画面上に描画されるまでにかかる時間。単位はミリ秒です。
INP（Interaction to Next Paint）	ユーザーの操作から次の描画までの時間。単位はミリ秒です。
CLS（累積レイアウトシフト）	予期しないレイアウト変更に対する個々のレイアウト変更スコアの合計。次元のない値です。
TTFB (Time to First Byte)	ナビゲーションが開始されてから応答の最初のバイトが受信されるまでの時間。単位はミリ秒です。

各メトリックには、Web Vitals のしきい値とデータに基づくパフォーマンス評価 (良好、改善が必要、または不良) が含まれています。

これは役に立ちましたか？