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.
웹 자동 캡처 스키마
이 참조는 브라우저 SDK 2를 사용할 때 웹에 사용할 자동 캡처 이벤트 유형과 이벤트 속성 이름을 나열합니다. 파이프라인, 파트너 또는 검증에 대한 안정적인 계약이 필요한 경우 이 참조를 사용하십시오.
자동 캡처 설정 단계를 보려면 자동 캡처로 이동하십시오. 예제와 함께 전체 속성 설명을 보려면 Autocapture events and properties로 이동하십시오. 네이티브 iOS 및 Android 자동 캡처 이벤트 속성을 보려면 모바일 자동 캡처 스키마로 이동하십시오.
공유 규칙
- 이벤트 유형 값은 Amplitude가 저장하는 값과
event_type일치합니다(예:Page viewed). - 웹 이벤트 유형은
[Amplitude] Network Request를 제외하고[Amplitude]접두사를 사용하지 않습니다. - 속성 이름은 여기에 나열된 것과 정확히 같이 Amplitude에 표시됩니다.
- 세션 이벤트는 표준 사용자 및 세션 컨텍스트 외에 추가 속성을 지니지 않습니다.
기계 판독 가능한 스키마
json
{
"description": "Web Autocapture event types and event property names for the Amplitude Browser SDK 2.",
"documentation": "/docs/data/web-autocapture-schema",
"web": {
"sdk": "Browser SDK 2",
"events": {
"Session Started": { "properties": [] },
"Session Ended": { "properties": [] },
"Page viewed": {
"properties": ["Page Domain", "Page Location", "Page Path", "Page Title", "Page URL"]
},
"File Downloaded": {
"properties": ["File Extension", "File Name", "Link ID", "Link Text", "Link URL"]
},
"Form Started": {
"properties": ["Form Destination", "Form ID", "Form Name"]
},
"Form Submitted": {
"properties": ["Form Destination", "Form ID", "Form Name"]
},
"Element Clicked": {
"properties": [
"Element ID",
"Element Class",
"Element Tag",
"Element Text",
"Element Href",
"Element Position Left",
"Element Position Top",
"Viewport Height",
"Viewport Width",
"Page URL",
"Page Title",
"Element Hierarchy",
"Element Attributes",
"Element Aria Label",
"Element Parent Label"
]
},
"Element Changed": {
"properties": [
"Element ID",
"Element Class",
"Element Tag",
"Element Position Left",
"Element Position Top",
"Viewport Height",
"Viewport Width",
"Page URL",
"Page Title",
"Element Hierarchy",
"Element Attributes",
"Element Aria Label",
"Element Parent Label"
]
},
"[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"
]
},
"Web Vitals": {
"properties": [
"Page Domain",
"Page Location",
"Page Path",
"Page Title",
"Page URL",
"LCP (Largest Contentful Paint)",
"FCP (First Contentful Paint)",
"INP (Interaction to Next Paint)",
"CLS (Cumulative Layout Shift)",
"TTFB (Time to First Byte)"
]
}
}
}
}
웹(브라우저 SDK 2)
Browser SDK 2에서 AutocaptureOptions를 사용하여 Amplitude가 캡처할 이벤트를 설정하십시오 구성 옵션은 자동 캡처(브라우저SDK 2)에서 확인하십시오.
| 이벤트 유형 | 이벤트가 발생할 때 | 일반적인 이벤트 속성 |
|---|---|---|
Session Started | 세션은 첫 페이지가 로드될 때 또는 비활성 상태 이후에 시작됩니다. | 없음. |
Session Ended | 비활성 상태가 되거나 브라우저 탭을 닫으면 세션이 종료됩니다. | 없음. |
Page viewed | 사용자가 단일 페이지 앱 경로 변경을 포함하여 페이지를 로드하거나 탐색합니다. | Page Domain, Page Location, Page Path, Page Title, Page URL. |
File Downloaded | 사용자가 파일 다운로드를 트리거하는 링크를 클릭합니다. | File Extension, File Name, Link ID, Link Text, Link URL. |
Form Started | 사용자는 처음에 양식 요소(텍스트 입력, 라디오 버튼 또는 드롭다운)와 상호작용합니다. | Form Destination, Form ID, Form Name. |
Form Submitted | 사용자가 양식을 제출합니다. | Form Destination, Form ID, Form Name. |
Element Clicked | 사용자가 대화형 페이지 요소를 클릭합니다. | Element ID, Element Class, Element Tag, Element Text, Element Href, Element Position Left, Element Position Top, Viewport Height, Viewport Width, Page URL, Page Title, Element Hierarchy, Element Attributes, Element Aria Label, Element Parent Label. |
Element Changed | 사용자가 드롭다운 또는 텍스트 입력과 같은 양식 요소를 변경합니다. | Element ID, Element Class, Element Tag, Element Position Left, Element Position Top, Viewport Height, Viewport Width, Page URL, Page Title, Element Hierarchy, Element Attributes, Element Aria Label, Element Parent Label. |
[Amplitude] Network Request | 애플리케이션은 추적된 HTTP 요청을 생성합니다(기본적으로 응답 코드는 500–599입니다). | [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. |
Web Vitals | 브라우저 탭은 숨겨지지만 Amplitude는 핵심 웹 바이탈을 수집합니다. | Page Domain, Page Location, Page Path, Page Title, Page URL, LCP (Largest Contentful Paint), FCP (First Contentful Paint), INP (Interaction to Next Paint), CLS (Cumulative Layout Shift), TTFB (Time to First Byte). |
이 내용이 도움이 되었나요?