모바일 자동 캡처 스키마
이 참조는 iOS Swift SDK, Android-Kotlin SDK 및 React Native SDK의 Autocapture 이벤트 유형과 이벤트 속성 이름을 나열합니다. 파이프라인, 파트너 또는 검증에 대한 안정적인 계약이 필요한 경우 이를 사용하십시오.
React Native
React Native Autocapture는 @amplitude/analytics-react-native에 포함됩니다. React Native 섹션은 이벤트 유형을 나열합니다.
자동 캡처 설정 단계를 보려면 자동 캡처로 이동하십시오. 웹 자동 캡처 이벤트 속성에 대해서는 자동 캡처 이벤트 및 속성으로 이동하십시오. 기계 판독형 웹 스키마를 보려면 웹 오토캡처 스키마로 이동하십시오.
기계 판독 가능한 스키마
{
"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를 통해 옵션을 활성화합니다. 구성 옵션을 보려면 Autocapture(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를 통해 옵션을 활성화합니다. 구성 옵션을 보려면 Autocapture(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 | 클릭 가능한 보기 또는 작성 | [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가 필요합니다. 요소 상호 작용에는 ampCapture또는 Babel 플러그인으로 래핑된 autocapture.elementInteractions및 핸들러가 필요합니다. Frustration 상호 작용에는 autocapture.frustrationInteractions와 동일한 래핑된 핸들러가 필요합니다.
| 이벤트 유형 | 발생할 때 | 일반적인 이벤트 속성 |
|---|---|---|
session_start | 세션 시작 | 사용자 속성(사용자 속성 수집을 활성화한 경우). |
session_end | 세션 종료 | 사용자 속성(사용자 속성 수집을 활성화한 경우). |
[Amplitude] Application Opened | init 시 앱이 활성화되어 있을 때 콜드 시작, 또는 백그라운드에서 반환 | 없음. |
[Amplitude] Application Backgrounded | AppState이(가) background(으)로 변경 | 없음. |
[Amplitude] Screen Viewed | 화면 보기 헬퍼 실행 | [Amplitude] Screen Name. |
[Amplitude] Element Pressed | Wrapped handler 실행 | [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, Plus 및 [Amplitude] Element Pressed에 있는 요소 [Amplitude] Screen Name속성. |
[Amplitude] Error Click | 누르기 또는 길게 누르기 후 2초 내에 처리되지 않은 오류 발생 | [Amplitude] Kind, [Amplitude] Message, [Amplitude] Stack, [Amplitude] Filename, [Amplitude] Line Number, [Amplitude] Column Number, Plus [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.