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

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

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

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

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

<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に追加してください。

イベント

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

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

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

• 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]
))

自動キャプチャイベント

ユーザープロパティ

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! ~~]
    	}
	)
)

自動キャプチャイベント

ユーザープロパティ

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