自動キャプチャを使用して迅速な洞察を得る

Amplitude Academy

Use Autocapture and Visual Labeling to Track Website Clicks

Simplify your Amplitude implementation and surface your product usage insights fast by learning how to use Autocapture and visual labeling to define your website click events.

Get started

自動キャプチャは、Amplitudeブラウザ、iOS、Android SDKから、ページビュー、セッション、クリック、フォームのインタラクションなどの一般的なインタラクションを最小限の設定で自動的に収集します。このページでは、各プラットフォームで自動キャプチャを有効にする方法について説明します。自動キャプチャが収集するイベントとプロパティの完全なリストについては、自動キャプチャリファレンスを参照してください。

ウェブ向けの自動キャプチャ

バージョン2.10.0以降、Amplitude Browser SDKには自動キャプチャ機能が搭載されており、サイト上のイベント、インタラクション、アトリビューションをキャプチャできます。

ブラウザSDKのインストール

AutocaptureSession Replay

Data region

HTML

<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
<script>
window.amplitude.add(window.sessionReplay.plugin({sampleRate: 1}));
window.amplitude.init('AMPLITUDE_API_KEY', {"fetchRemoteConfig":true,"autocapture":{"attribution":true,"fileDownloads":true,"formInteractions":true,"pageViews":true,"sessions":true,"elementInteractions":true,"networkTracking":true,"webVitals":true,"frustrationInteractions":true}});
</script>

SDKの初期化

ブラウザSDK 2.10.0以降には、エレメントのクリックと変更の追跡機能が含まれており、これによりAmplitude内で視覚的なラベル付けが可能になります。この機能を有効にするには、SDKを初期化するときにconfig.autocapture.elementInteractionsをtrueに設定します。

追加の初期化は必要ありません。

コンテンツセキュリティポリシー（CSP）

ウェブアプリが厳格なコンテンツセキュリティポリシー（CSP）を設定している場合は、Amplitudeドメインを許可リストに登録するようにポリシーを調整してください。

https://*.amplitude.comをscript-srcに追加してください。
https://*.amplitude.comをconnect-srcに追加してください。

イベント

イベント	概要	プロパティ
ページの閲覧	ユーザーがサイト上のページを読み込んだときにキャプチャされます。	ページカウンタ、ページドメイン、ページの場所、ページパス、ページタイトル、ページURL、セッションリプレイID（有効な場合）、リファラー、アトリビューション、ユーザープロパティ。
セッションの開始	ユーザーがサイトでセッションを開始したときにキャプチャされます。	セッションリプレイID（有効な場合）、ユーザープロパティ。
セッションの終了	ユーザーがサイトでのセッションを終了したときにキャプチャされます。	ユーザープロパティ。
フォームの開始	ユーザーがサイト上のフォームとやり取りしたときに収集します。	フォームの送信先、セッションリプレイID（有効な場合）、ユーザープロパティ。
フォームの送信	ユーザーがサイトでフォームを送信したときに収集されます。	フォームの送信先、セッションリプレイID（有効な場合）、ユーザープロパティ。
ファイルのダウンロード	ユーザーがサイトからファイルをダウンロードしたときにキャプチャします。	ファイル拡張子、ファイル名、リンクテキスト、リンクURL、セッションリプレイID（有効な場合）、
エレメントのクリック	ユーザーがページ上のエレメントをクリックしたときにキャプチャされます。	エレメントAriaラベル、エレメントクラス、エレメント階層、エレメントHref、エレメントID、エレメント親ラベル、エレメント位置左、エレメント位置上、エレメントセレクタ、エレメントタグ、エレメントテキスト、ページタイトル、ページURL、セッションリプレイID、ビューポートの高さ、ビューポートの幅。
エレメントの変更	ドロップダウンの変更やテキストボックスへのテキスト入力など、フォームエレメントの相互作用をキャプチャします。	エレメントクラス、エレメント階層、エレメントID、エレメント親ラベル、エレメント位置左、エレメント位置上、エレメントタグ、ページタイトル、ページURL、セッションリプレイID、ビューポートの高さ、ビューポートの幅。
ネットワークリクエスト	アプリケーションがネットワーク要求を行ったときにキャプチャします。	URL、リクエストメソッド、ステータスコード、期間、リクエスト本文サイズ、レスポンス本文サイズ、セッションリプレイID（有効な場合）。
ウェブバイタル	ブラウザのタブが非表示になった場合に、Core Web Vitals のパフォーマンス指標をキャプチャします。	ページドメイン、ページ場所、ページパス、ページタイトル、ページURL、LCP、FCP、INP、CLS、TTFBの指標とパフォーマンス評価とタイミングデータ。

詳細については、ブラウザ SDK 2 のドキュメントにある Autocapture を参照してください。

デフォルトのイベントプレフィックス

Amplitudeは、自動キャプチャイベントにAmplitudeロゴをプレフィックスとして付加します。

マーケティングアトリビューション

次のプロパティのキャプチャ:

UTMパラメータ（utm_source、utm_medium、utm_campaign、utm_term、utm_content）。
リファラーパラメータ（referrer、referring_domain）。
Google、Facebook、Kochava、Microsoft、TikTok、X（Twitter）、LinkedIn、Redditのクリック識別子です。
ファーストタッチとマルチタッチのアトリビューション機能。アトリビューションの詳細については、「セッション、チャネル、アトリビューションを使用してマーケティング分析を推進する」を参照してください。

ユーザープロパティ

Amplitudeは、無効になっていない限り、すべての自動キャプチャイベントにユーザープロパティを関連付けます。

Web用のビジュアルラベル作成

Amplitudeのビジュアルラベル作成ツールを使用すると、ページ上の個々のエレメントを識別して選択してトラッキングできます。たとえば、登録ボタンをクリックしたユーザー数を追跡するには、ビジュアルラベリングを使用してボタンを選択します。次に、Amplitudeはその特定のエレメントをターゲットとするイベントを作成します。

ビジュアルラベル付けを使用して追加したイベントは遡及的に機能します。これは、Amplitudeがインストルメンテーションを稼働させた時点からすべてのフォーム関連イベントをキャプチャするためです。

詳細については、「ビジュアルラベル付け」を参照してください。

iOS用自動キャプチャ

AmplitudeのiOS SDKの最新バージョンには自動キャプチャ機能が含まれています。

SDK をインストールする

iOS-Swift SDKのドキュメントの指示に従ってSDKをインストールします。

自動キャプチャを有効にしてSDKを初期化する

デフォルトでは、iOS SDKはセッション追跡を有効にし、アプリケーションのライフサイクル、画面表示、およびエレメントの相互作用追跡を無効にします。すべての自動キャプチャ機能を有効にするには、次のスニペットを使用して SDK を初期化します。

let amplitude = Amplitude(configuration: Configuration(
    apiKey: "API_KEY",
    autocapture: [.sessions, .appLifecycles, .screenViews, .networkTracking]
))

自動キャプチャイベント

イベント	概要	プロパティ
セッションの開始	ユーザーがアプリでセッションを開始したときにキャプチャします。	ユーザープロパティ。
セッションの終了	ユーザーがアプリ内のセッションを終了したときにキャプチャします。	ユーザープロパティ。
アプリケーションのインストール	ユーザーがアプリをインストールした後初めてアプリを開いた時点をキャプチャします。
アプリケーションの更新	ユーザーがアプリをアップデートした後に初めてアプリを開いた時点をキャプチャします。
アプリケーションの起動	ユーザーがアプリを初めて開いた後に起動またはフォアグラウンドしたタイミングをキャプチャします。
アプリケーションのバックグラウンドへの移行	ユーザーがアプリケーションをバックグラウンドに移行したときにキャプチャします。
表示された画面	ユーザーがアプリ内の画面を閲覧したときにキャプチャします。	画面名
操作されたエレメント	ユーザーがアプリ内のUIエレメントを操作したときにキャプチャします。	エレメントのプロパティ
ネットワークリクエスト	アプリがネットワーク要求を行ったときにキャプチャします。	URL、リクエスト方法、ステータスコードなど

ユーザープロパティ

Amplitudeは、無効になっていない限り、すべての自動キャプチャイベントにユーザープロパティを関連付けます。

Android用自動キャプチャ

AmplitudeのAndroid SDKの最新バージョンには自動キャプチャ機能が含まれています。

SDK をインストールする

Android-Kotlin SDKのドキュメントの指示に従ってSDKをインストールします。

自動キャプチャを有効にしてSDKを初期化する

デフォルトでは、Android-Kotlin SDKはセッション追跡を有効にし、アプリケーションライフサイクル、画面表示、ディープリンク、およびエレメントの相互作用追跡を無効にします。すべての自動キャプチャ機能を有効にするには、次のスニペットを使用して SDK を初期化します。

Amplitude(
	Configuration(
	 apiKey = AMPLITUDE_API_KEY,
		context = applicationContext,
		autocapture = autocaptureOptions {
          +sessions               // or `+Autocapture.SESSIONS` [tl! ~~]
          +appLifecycles          // or `+Autocapture.APP_LIFECYCLES` [tl! ~~]
          +deepLinks              // or `+Autocapture.DEEP_LINKS` [tl! ~~]
          +screenViews            // or `+Autocapture.SCREEN_VIEWS` [tl! ~~]
    	}
	)
)

自動キャプチャイベント

イベント	概要	プロパティ
セッションの開始	ユーザーがアプリでセッションを開始したときにキャプチャします。	ユーザープロパティ。
セッションの終了	ユーザーがアプリ内のセッションを終了したときにキャプチャします。	ユーザープロパティ。
アプリケーションのインストール	ユーザーがアプリをインストールした後初めてアプリを開いた時点をキャプチャします。
アプリケーションの更新	ユーザーがアプリをアップデートした後に初めてアプリを開いた時点をキャプチャします。
アプリケーションの起動	ユーザーがアプリを初めて開いた後に起動またはフォアグラウンドしたタイミングをキャプチャします。
アプリケーションのバックグラウンドへの移行	ユーザーがアプリケーションをバックグラウンドに移行したときにキャプチャします。
表示された画面	ユーザーがアプリ内の画面を閲覧したときにキャプチャします。	画面名
開かれたディープリンク	ユーザーがアプリでディープリンクを開いたときにキャプチャされます。	URL とリファラー情報
操作されたエレメント	ユーザーがアプリ内のUIエレメントを操作したときにキャプチャします。	エレメントのプロパティ

ユーザープロパティ

Amplitudeは、無効になっていない限り、すべての自動キャプチャイベントにユーザープロパティを関連付けます。

Was this helpful?