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

Amplitude アカデミー

自動キャプチャとビジュアルラベル付けを使用してウェブサイトのクリックを追跡

自動キャプチャとビジュアルラベル付けを使用してウェブサイトのクリックイベントを定義する方法を学び、Amplitudeの実装を簡素化して、プロダクトの使用状況に関するインサイトを迅速に引き出しましょう。

今すぐ始める

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

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

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

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

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

イベント

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

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

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

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

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

ユーザープロパティ

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

Autocapture for React Native

@amplitude/analytics-react-native1.6.8以降で利用できます。 React Native SDKには、セッション、アプリケーションのライフサイクル、画面ビュー、要素のインタラクション、フラストレーションのインタラクションに対するAutocaptureが含まれています。設定の詳細については、React Native SDK | Autocaptureを参照してください。

SDKをインストールする

React Native SDKの指示に従って、SDKをインストールします。

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

すべての自動キャプチャ機能を有効にするには、autocapture: trueを設定します:

ts
import { init } from "@amplitude/analytics-react-native";
init("API_KEY", undefined, {
  autocapture: true,
});

一部の自動キャプチャ機能のみを有効にするには、autocaptureをAutocapture Optionsオブジェクトとして設定します。

ts
import { init } from "@amplitude/analytics-react-native";
init("API_KEY", undefined, {
  autocapture: {
    sessions: true,
    appLifecycles: false,
    elementInteractions: true,
    frustrationInteractions: true,
    screenViews: false,
  },
});

画面ビューでは、trackScreenViewを呼び出すか、React NavigationにtrackScreenViewOnNavigationStateChangeを配線する必要があります。画面ビューの追跡を参照してください。

要素のインタラクションについては、autocapture.elementInteractionsを有効にし、ハンドラをampCaptureでラップするか、Babel transpileプラグインを追加して、Metroがコンパイル時にラップするようにします。要素間のインタラクションの追跡を参照してください。

フラストレーションのインタラクションについては、autocapture.frustrationInteractionsを有効にします。Rageクリックとエラークリックでは、これらの同じラップされたハンドラを使用します。RageクリックではSDK1.11.0以降が必要です。エラークリックでは1.12.0以降が必要です。フラストレーションのインタラクションの追跡を参照してください。

自動キャプチャイベント

Autocapture for Flutter

AmplitudeのFlutter SDKの最新バージョンには、iOS、Android、Web用のAutocaptureが含まれています。

SDKをインストールする

Flutter SDK 4ドキュメントの指示に従って、SDKをインストールします。 ウェブの場合は、web/index.htmlAmplitude Browser SDKスニペットもロードしてください。

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

デフォルトでは、Flutter SDKはセッション追跡を有効にします。 Web では、マーケティング アトリビューションも有効にします。画面ビュー、ページビュー、および DOM ベースのウェブオプション(要素の相互作用、フォームの相互作用、ファイルのダウンロード)は、デフォルトではオフになっています。 すべての自動キャプチャ機能を有効にするには、SDKをAutocaptureEnabled()で初期化し、画面表示用にAmplitudeNavigatorObserverをアタッチします:

dart
import 'package:amplitude_flutter/amplitude.dart';
import 'package:amplitude_flutter/configuration.dart';
import 'package:amplitude_flutter/autocapture/autocapture.dart';
import 'package:amplitude_flutter/observers/amplitude_navigator_observer.dart';
final Amplitude analytics = Amplitude(
  Configuration(
    apiKey: 'YOUR-API-KEY',
    autocapture: AutocaptureEnabled(),
  ),
);
MaterialApp(
  navigatorObservers: [AmplitudeNavigatorObserver(analytics)],
  // ...
);

Web DOMベースのキャプチャ(クリック、フォーム、ファイルのダウンロード)の場合は、Flutterのアクセシビリティ・セマンティクスツリーを有効にします。Flutter SDK 4リファレンスのFlutter Web DOMキャプチャを参照してください。

自動キャプチャイベント

設定オプションとプラットフォームの詳細については、Flutter SDK 4のAutocaptureを参照してください。

ユーザープロパティ

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

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

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.

このページでは