モバイル自動キャプチャスキーマ
このリファレンスでは、iOS Swift SDK、Android-Kotlin SDK、React Native SDKのAutocaptureイベントタイプとイベントプロパティ名について説明します。 パイプライン、パートナー、または検証に関する安定した契約が必要な場合に使用してください。
React Native
React Native Autocaptureは@amplitude/analytics-react-nativeに提供されています。React Nativeセクションには、React Nativeのイベントタイプが一覧表示されます。
自動キャプチャのセットアップ手順については、自動キャプチャを参照してください。Web 自動キャプチャ イベントのプロパティについては、「自動キャプチャ イベントとプロパティ」に移動します。 機械で読み取り可能な Web スキーマについては、「Web 自動キャプチャ スキーマ」を参照してください。
機械可読スキーマ
{
"description": "Autocapture event types and event property names for the Amplitude iOS Swift SDK, Android-Kotlin SDK, and React Native SDK.",
"documentation": "/docs/data/mobile-autocapture-schema",
"ios": {
"events": {
"[Amplitude] Start Session": { "properties": [] },
"[Amplitude] End Session": { "properties": [] },
"[Amplitude] Application Installed": {
"properties": ["[Amplitude] Version", "[Amplitude] Build"]
},
"[Amplitude] Application Updated": {
"properties": [
"[Amplitude] Version",
"[Amplitude] Build",
"[Amplitude] Previous Version",
"[Amplitude] Previous Build"
]
},
"[Amplitude] Application Opened": {
"properties": [
"[Amplitude] Version",
"[Amplitude] Build",
"[Amplitude] From Background"
]
},
"[Amplitude] Application Backgrounded": { "properties": [] },
"[Amplitude] Screen Viewed": {
"properties": ["[Amplitude] Screen Name"]
},
"[Amplitude] Deep Link Opened": {
"properties": ["[Amplitude] Link URL", "[Amplitude] Link Referrer"]
},
"[Amplitude] Network Request": {
"properties": [
"[Amplitude] URL",
"[Amplitude] URL Query",
"[Amplitude] URL Fragment",
"[Amplitude] Request Method",
"[Amplitude] Status Code",
"[Amplitude] Error Code",
"[Amplitude] Error Message",
"[Amplitude] Start Time",
"[Amplitude] Completion Time",
"[Amplitude] Duration",
"[Amplitude] Request Body Size",
"[Amplitude] Response Body Size",
"[Amplitude] Request Body",
"[Amplitude] Response Body",
"[Amplitude] Request Headers",
"[Amplitude] Response Headers"
]
},
"[Amplitude] Element Interacted": {
"properties": [
"[Amplitude] Action",
"[Amplitude] Target View Class",
"[Amplitude] Target Text",
"[Amplitude] Target Accessibility Label",
"[Amplitude] Target Accessibility Identifier",
"[Amplitude] Action Method",
"[Amplitude] Gesture Recognizer",
"[Amplitude] Hierarchy",
"[Amplitude] Screen Name"
]
},
"[Amplitude] Rage Click": {
"properties": [
"[Amplitude] Begin Time",
"[Amplitude] End Time",
"[Amplitude] Duration",
"[Amplitude] Click Count",
"[Amplitude] Clicks",
"[Amplitude] Action",
"[Amplitude] Target View Class",
"[Amplitude] Target Text"
]
},
"[Amplitude] Dead Click": {
"properties": [
"[Amplitude] Begin Time",
"[Amplitude] End Time",
"[Amplitude] Duration",
"[Amplitude] Action",
"[Amplitude] Target View Class",
"[Amplitude] Target Text"
]
}
}
},
"android": {
"events": {
"[Amplitude] Start Session": { "properties": [] },
"[Amplitude] End Session": { "properties": [] },
"[Amplitude] Application Installed": {
"properties": ["[Amplitude] Version", "[Amplitude] Build"]
},
"[Amplitude] Application Updated": {
"properties": [
"[Amplitude] Version",
"[Amplitude] Build",
"[Amplitude] Previous Version",
"[Amplitude] Previous Build"
]
},
"[Amplitude] Application Opened": {
"properties": [
"[Amplitude] Version",
"[Amplitude] Build",
"[Amplitude] From Background"
]
},
"[Amplitude] Application Backgrounded": { "properties": [] },
"[Amplitude] Screen Viewed": {
"properties": ["[Amplitude] Screen Name"]
},
"[Amplitude] Fragment Viewed": {
"properties": [
"[Amplitude] Screen Name",
"[Amplitude] Fragment Class",
"[Amplitude] Fragment Identifier",
"[Amplitude] Fragment Tag"
]
},
"[Amplitude] Deep Link Opened": {
"properties": ["[Amplitude] Link URL", "[Amplitude] Link Referrer"]
},
"[Amplitude] Network Request": {
"properties": [
"[Amplitude] URL",
"[Amplitude] URL Query",
"[Amplitude] URL Fragment",
"[Amplitude] Request Method",
"[Amplitude] Status Code",
"[Amplitude] Error Message",
"[Amplitude] Start Time",
"[Amplitude] Completion Time",
"[Amplitude] Duration",
"[Amplitude] Request Body Size",
"[Amplitude] Response Body Size"
]
},
"[Amplitude] Element Interacted": {
"properties": [
"[Amplitude] Action",
"[Amplitude] Target Class",
"[Amplitude] Target Resource",
"[Amplitude] Target Tag",
"[Amplitude] Target Text",
"[Amplitude] Target Source",
"[Amplitude] Hierarchy",
"[Amplitude] Screen Name"
]
},
"[Amplitude] Rage Click": { "properties": [] },
"[Amplitude] Dead Click": { "properties": [] }
}
},
"reactNative": {
"events": {
"session_start": { "properties": [] },
"session_end": { "properties": [] },
"[Amplitude] Application Opened": { "properties": [] },
"[Amplitude] Application Backgrounded": { "properties": [] },
"[Amplitude] Screen Viewed": {
"properties": ["[Amplitude] Screen Name"]
},
"[Amplitude] Element Pressed": {
"properties": [
"[Amplitude] Action",
"[Amplitude] Target Test ID",
"[Amplitude] Target Accessibility Label",
"[Amplitude] Target Component",
"[Amplitude] Target Element"
]
},
"[Amplitude] Rage Click": {
"properties": [
"[Amplitude] Begin Time",
"[Amplitude] End Time",
"[Amplitude] Duration",
"[Amplitude] Click Count",
"[Amplitude] Clicks",
"[Amplitude] Action",
"[Amplitude] Target Test ID",
"[Amplitude] Target Accessibility Label",
"[Amplitude] Target Component",
"[Amplitude] Target Element",
"[Amplitude] Screen Name"
]
},
"[Amplitude] Error Click": {
"properties": [
"[Amplitude] Kind",
"[Amplitude] Message",
"[Amplitude] Stack",
"[Amplitude] Filename",
"[Amplitude] Line Number",
"[Amplitude] Column Number",
"[Amplitude] Action",
"[Amplitude] Target Test ID",
"[Amplitude] Target Accessibility Label",
"[Amplitude] Target Component",
"[Amplitude] Target Element",
"[Amplitude] Screen Name"
]
}
}
}
}
共有の取り決め
- イベントタイプの値は、Amplitudeが
event_typeとして保存しているものと一致します(例:[Amplitude] Screen Viewed)。 - プロパティ名には、プロダクトおよびこのドキュメントの
[Amplitude] ...プレフィックスが使用されています。 - セッションイベントは通常、コードで追加しない限り、標準的なユーザーとセッションコンテキストのみを伝送します。
iOS(Swift SDK)
オプションを有効にするには、AutocaptureOptions を使用してください。 設定オプションについては、「自動キャプチャ(iOS)」に移動します。
| イベントタイプ | トリガーされた場合 | 一般的なイベントプロパティ |
|---|---|---|
[Amplitude] Start Session | セッション開始 | ユーザープロパティ(ユーザープロパティの収集を有効にした場合)。 |
[Amplitude] End Session | セッション終了 | ユーザープロパティ(ユーザープロパティの収集を有効にした場合)。 |
[Amplitude] Application Installed | インストール後に最初に開く | [Amplitude] Version、[Amplitude] Build。 |
[Amplitude] Application Updated | アップデート後に最初に開く | [Amplitude] Version、[Amplitude] Build、[Amplitude] Previous Version、[Amplitude] Previous Build。 |
[Amplitude] Application Opened | 初回起動後の起動またはフォアグラウンド | [Amplitude] Version、[Amplitude] Build、[Amplitude] From Background(該当する場合)。 |
[Amplitude] Application Backgrounded | アプリがバックグラウンドに入る | なし。 |
[Amplitude] Screen Viewed | UIKit画面が表示されます | [Amplitude] Screen Name。 |
[Amplitude] Deep Link Opened | ディープリンクが開く | [Amplitude] Link URL、[Amplitude] Link Referrer。 |
[Amplitude] Network Request | SDKはHTTPトラフィックをキャプチャします(SDKルールに従って) | [Amplitude] URL、[Amplitude] URL Query、[Amplitude] URL Fragment、[Amplitude] Request Method、[Amplitude] Status Code、[Amplitude] Error Code、[Amplitude] Error Message、[Amplitude] Start Time、[Amplitude] Completion Time、[Amplitude] Duration、[Amplitude] Request Body Size、[Amplitude] Response Body Size、および有効にした場合はオプションの実験的なボディとヘッダーのプロパティ。 |
[Amplitude] Element Interacted | UIControl / ジェスチャーによるインタラクション | [Amplitude] Action、[Amplitude] Target View Class、[Amplitude] Target Text、[Amplitude] Target Accessibility Label、[Amplitude] Target Accessibility Identifier、[Amplitude] Action Method、[Amplitude] Gesture Recognizer、[Amplitude] Hierarchy、[Amplitude] Screen Name。 |
[Amplitude] Rage Click | フラストレーション(レイジクリック) | 詳細については、「フラストレーションのやり取りを追跡」を参照してください。 |
[Amplitude] Dead Click | フラストレーション(デッドクリック) | Rage Clickと同じです。 |
Android(Kotlin SDK)
オプションを有効にするには、AutocaptureOption を使用してください。 設定オプションについては、自動キャプチャ(Android)」にアクセスしてください。
| イベントタイプ | トリガーされた場合 | 一般的なイベントプロパティ |
|---|---|---|
[Amplitude] Start Session | セッション開始 | ユーザープロパティ(ユーザープロパティの収集を有効にした場合)。 |
[Amplitude] End Session | セッション終了 | ユーザープロパティ(ユーザープロパティの収集を有効にした場合)。 |
[Amplitude] Application Installed | インストール後に最初に開く | [Amplitude] Version、[Amplitude] Build。 |
[Amplitude] Application Updated | アップデート後に最初に開く | [Amplitude] Version、[Amplitude] Build、[Amplitude] Previous Version、[Amplitude] Previous Build。 |
[Amplitude] Application Opened | 初回起動後の起動またはフォアグラウンド | [Amplitude] Version、[Amplitude] Build、[Amplitude] From Background(該当する場合)。 |
[Amplitude] Application Backgrounded | アプリの背景 | なし。 |
[Amplitude] Screen Viewed | アクティビティが表示されます | [Amplitude] Screen Name。 |
[Amplitude] Fragment Viewed | フラグメントが表示されます | [Amplitude] Screen Name、[Amplitude] Fragment Class、[Amplitude] Fragment Identifier、[Amplitude] Fragment Tag。 |
[Amplitude] Deep Link Opened | ディープリンクが開く | [Amplitude] Link URL、[Amplitude] Link Referrer。 |
[Amplitude] Network Request | SDKはHTTPトラフィックをキャプチャします(プラグイン) | [Amplitude] URL、[Amplitude] URL Query、[Amplitude] URL Fragment、[Amplitude] Request Method、[Amplitude] Status Code、[Amplitude] Error Message、[Amplitude] Start Time、[Amplitude] Completion Time、[Amplitude] Duration、[Amplitude] Request Body Size、[Amplitude] Response Body Size。 |
[Amplitude] Element Interacted | クリック可能なビューまたはCompose | [Amplitude] Action、[Amplitude] Target Class、[Amplitude] Target Resource、[Amplitude] Target Tag、[Amplitude] Target Text、[Amplitude] Target Source、[Amplitude] Hierarchy、[Amplitude] Screen Name。 |
[Amplitude] Rage Click | フラストレーション(オプション) | 詳細については、「フラストレーションのやり取りを追跡」を参照してください。 |
[Amplitude] Dead Click | フラストレーション(オプション) | Rage Clickと同じです。 |
React Native
autocaptureinitオプションを使用してオプションを有効にします。 設定オプションについては、Autocapture(React Native)にアクセスしてください。 スクリーンビューには、trackScreenViewまたはtrackScreenViewOnNavigationStateChangeが必要です。要素の相互作用には、autocapture.elementInteractionsおよびampCaptureまたはBabelプラグインでラップされたハンドラが必要です。フラストレーションのインタラクションには、autocapture.frustrationInteractionsおよび同じラップされたハンドラが必要です。
| イベントタイプ | トリガーされた場合 | 一般的なイベントプロパティ |
|---|---|---|
session_start | セッション開始 | ユーザープロパティ(ユーザープロパティの収集を有効にした場合)。 |
session_end | セッション終了 | ユーザープロパティ(ユーザープロパティの収集を有効にした場合)。 |
[Amplitude] Application Opened | コールドスタート(アプリの初期化時にアクティブな場合)、またはバックグラウンドからの復帰 | なし。 |
[Amplitude] Application Backgrounded | AppStateへの変更background | なし。 |
[Amplitude] Screen Viewed | ScreenViewヘルパーが実行されます | [Amplitude] Screen Name。 |
[Amplitude] Element Pressed | ラップされたハンドラーが実行されます | [Amplitude] Action, [Amplitude] Target Test ID, [Amplitude] Target Accessibility Label, [Amplitude] Target Component, [Amplitude] Target Element. |
[Amplitude] Rage Click | 50ピクセルの領域内で、1秒の期間内に4回以上押下 | [Amplitude] Begin Time, [Amplitude] End Time, [Amplitude] Duration, [Amplitude] Click Count, [Amplitude] Clicks、および[Amplitude] Element Pressedと[Amplitude] Screen Name上の要素プロパティ。 |
[Amplitude] Error Click | 押下または長押し後に2秒期間内に未処理のエラーが発生した場合 | [Amplitude] Kind, [Amplitude] Message, [Amplitude] Stack, [Amplitude] Filename, [Amplitude] Line Number, [Amplitude] Column Number, プラス[Amplitude] Element Pressedおよび[Amplitude] Screen Name上の要素プロパティ。 |
これは役に立ちましたか?
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.