이벤트 및 속성 자동 캡처

이 참조는 브라우저 SDK 2를 사용할 때 웹에 사용할 자동 캡처 이벤트 유형과 이벤트 속성 이름을 나열합니다. 이 참조를 사용하여 Amplitude가 자동으로 캡처하는 항목을 이해하고, 추적 계획을 구성하며, 파이프라인 및 유효성 검사를 설정하십시오.

이 페이지의 기계가 읽을 수 있는 버전을 보려면 웹 자동 캡처 스키마로 이동하십시오. 네이티브 iOS 및 Android 자동 캡처 이벤트 속성을 보려면 모바일 자동 캡처 스키마로 이동하십시오.

공유 규칙

볼드체로 표시된 속성 이름(예: 페이지 URL)은 해당 속성이 Amplitude에 어떻게 표시되는지를 나타냅니다.
자동 캡처는 일부 속성에 접두사를 붙입니다[Amplitude]. Amplitude는 이러한 정보를 자동으로 생성하고 읽기 전용으로 표시합니다.
브라우저 SDK 2에서 AutocaptureOptionsAmplitude가 캡처하는 이벤트를 설정하세요.

세션

세션 시작됨

첫 페이지가 로드될 때 또는 일정 기간 동안 비활성 상태가 된 후 사용자 세션이 시작되는 시점을 캡처합니다.

속성 이름	설명
수집된 속성 없음

세션 종료

비활성 상태이거나 브라우저 탭을 닫아 사용자 세션이 종료되는 경우를 캡처합니다.

속성 이름	설명
수집된 속성 없음

페이지 뷰 수

페이지 조회됨

단일 페이지 앱 경로 변경 사항을 포함하여 사용자가 페이지를 로드하거나 탐색할 때마다 캡처합니다.

속성 이름	설명
페이지 도메인	현재 웹 주소의 전체 호스트 이름(예: `www`또는 `app`와 같은 하위 도메인 포함).
페이지 위치	전체 URL 검색 매개 변수를 포함한 현재 페이지의 전체 URL입니다.
페이지 경로	현재 페이지의 경로 이름. 이것은 전체 URL 검색 매개 변수 및 URL 조각을 제외합니다.
페이지 제목	페이지의 제목입니다.
페이지 URL	URL 검색 매개 변수를 제외한 페이지의 URL입니다.

파일 다운로드

사용자가 파일 다운로드를 트리거하는 링크를 클릭할 때 캡처합니다.

속성 이름	설명
파일 확장자	다운로드한 파일의 확장자입니다. 예를 들어 .pdf, .docx, .zip 등을 사용할 수 있습니다.
파일 이름	다운로드된 파일의 전체 경로 이름입니다. 여기에는 단순히 파일의 파일 이름 이상의 정보가 포함될 수 있습니다.
링크 ID	링크 요소의 ID입니다.
링크 텍스트	링크 요소의 텍스트 콘텐츠입니다.
링크 URL	파일 다운로드의 링크 주소입니다.

양식 상호작용

자동 캡처는 <form>태그를 사용하는 양식을 캡처합니다.

양식 시작됨

텍스트 입력, 라디오 버튼 또는 드롭다운에 대한 수정 사항을 포함하여 사용자가 처음으로 양식 요소와 상호 작용할 때를 캡처합니다.

속성 이름	설명
양식 목적지	form 요소의 action 속성입니다. 예를 들어 `<form action="/subscribe">`의 경우 값은 `/subscribe`입니다.
양식 ID	양식 요소의 ID입니다.
양식 이름	form 요소의 이름 속성입니다.

양식 제출됨

사용자가 양식을 제출할 때 캡처됩니다.

속성 이름	설명
양식 목적지	form 요소의 action 속성입니다. 예를 들어 `<form action="/subscribe">`의 경우 값은 `/subscribe`입니다.
양식 ID	양식 요소의 ID입니다.
양식 이름	form 요소의 이름 속성입니다.

요소 상호 작용

클릭된 요소

페이지 요소에 대한 클릭을 캡처합니다.

기본 구성은 페이지의 대화형 요소와 사용자 상호 작용을 캡처합니다. 기본값은 텍스트를 강조표시하기 위한 클릭 및 공백 클릭과 같은 이벤트 노이즈를 제거합니다. 기본값은 다음을 캡처합니다.

양식 요소에 대한 모든 클릭: <a>, 버튼, 입력, 선택, 텍스트 영역, 레이블 및 요소(속성이 contentEditable값으로 설정됨true).
비디오 및 오디오 요소에 대한 모든 클릭.
페이지에 변화가 발생하거나 다른 페이지로 이동하는 결과를 가져오는 선택된 요소를 클릭합니다(예: 모달 표시). 이러한 요소에는 div, span 및 헤더가 포함됩니다.
속성 또는 클래스가 amp-default-track인 요소에 대한 모든 클릭data-amp-default-track.
이 구성을 사용자 정의하여 선택기를 추가하거나 제거할 수 있습니다. Amplitude가 항상 이러한 선택기를 추적할지 아니면 클릭으로 인해 페이지가 변경될 때만 추적할지 선택할 수 있습니다.

속성 이름	설명
요소 ID	HTML 요소의 `id`속성입니다. 예를 들어, `myID`가 있는 요소는 값을 `id="myID"`생성합니다.
요소 클래스	HTML 요소의 `class`속성입니다. 예를 들어, `myClass`가 있는 요소는 값을 `class="myClass"`생성합니다.
요소 태그	HTML 요소의 태그 이름입니다. 예를 들어, `<a>`요소는 값을 생성합니다`a`.
요소 텍스트	HTML 요소의 텍스트 콘텐츠(`innerText`)입니다. 요소 클릭됨 이벤트에만 적용됩니다. 예를 들어 텍스트 "홈"이 포함된 링크는 `Home`값을 생성합니다.
요소 Href	HTML 요소의 `href`속성입니다. 요소 클릭됨 이벤트의 `<a>`태그에만 적용됩니다. Amplitude는 128바이트보다 긴 값을 자릅니다.
요소 위치 왼쪽	화면 뷰의 왼쪽에서 요소까지의 거리(픽셀 단위)입니다. 예를 들어 값이 `600`인 경우 요소가 왼쪽에서 600픽셀 떨어져 있음을 의미합니다.
요소 위치 맨 위	화면 뷰의 맨 위에서 요소까지의 거리(픽셀 단위)입니다. 예를 들어 값이 `400`인 경우 요소가 맨 위에서 400픽셀 떨어져 있음을 의미합니다.
뷰포트 높이	요소를 클릭했을 때의 뷰포트의 높이(픽셀 단위)입니다. 예를 들어 값이 `900`인 경우 뷰포트의 높이가 900픽셀임을 의미합니다.
뷰포트 폭	요소를 클릭했을 때의 뷰포트의 폭(픽셀 단위)입니다. 예를 들어, 값이 `1200`인 경우 뷰포트의 너비가 1200픽셀임을 의미합니다.
페이지 URL	요소가 클릭된 페이지의 URL입니다.
페이지 제목	요소가 클릭된 페이지의 페이지 제목입니다.
요소 계층 구조	DOM 요소와 클릭된 요소의 속성, 그리고 그 상위 또는 형제 요소입니다. Amplitude는 이를 시각적 레이블링에 사용합니다.
요소 선택기	요소 계층 구조로 대체되어 더 이상 사용되지 않습니다. 요소의 고유 CSS 선택기입니다. 예를 들어, `#myID`가 있는 요소는 값을 `id="myID"`생성합니다.
요소 속성	`dataAttributePrefix`설정을 통해 클릭 이벤트와 연관된 고유 속성입니다. 예를 들어, 속성이 있는 요소는 값이 `feature-start`인 `id="feature-start"`속성을 생성합니다`[Amplitude] Element Attributes.id`.
요소 Aria 레이블	요소의 `aria-label` 이며, 텍스트가 표시되지 않는 대화형 요소에 사용됩니다. 예를 들어, `Close`가 있는 요소는 값을 `aria-label="Close"`생성합니다.
요소 상위 레이블	요소의 부모 요소(또는 한 수준의 부모에서 발견되지 않은 경우 상위 조상)에 있는 텍스트 레이블입니다.

요소 변경됨

드롭다운 변경 사항이나 텍스트 상자에 텍스트 입력과 같은 양식 요소 상호 작용을 캡처합니다.

속성 이름	설명
요소 ID	HTML 요소의 `id`속성입니다.
요소 클래스	HTML 요소의 `class`속성입니다.
요소 태그	HTML 요소의 태그 이름입니다.
요소 위치 왼쪽	화면 뷰의 왼쪽에서 요소까지의 거리(픽셀 단위)입니다.
요소 위치 맨 위	화면 뷰의 맨 위에서 요소까지의 거리(픽셀 단위)입니다.
뷰포트 높이	요소가 변경되었을 때 뷰포트의 높이(픽셀 단위)입니다.
뷰포트 폭	요소가 변경되었을 때의 뷰포트의 폭(픽셀 단위)입니다.
페이지 URL	요소가 변경된 페이지의 URL입니다.
페이지 제목	요소가 변경된 페이지의 페이지 제목입니다.
요소 계층 구조	DOM 요소와 해당 요소의 속성, 그리고 상위 또는 형제 요소가 변경된 경우. Amplitude는 이를 시각적 레이블링에 사용합니다.
요소 선택기	요소 계층 구조로 대체되어 더 이상 사용되지 않습니다. 요소의 고유 CSS 선택기입니다.
요소 속성	`dataAttributePrefix`설정을 통해 변경 이벤트와 연관된 고유 속성입니다.
요소 Aria 레이블	요소의 `aria-label` 이며, 텍스트가 표시되지 않는 대화형 요소에 사용됩니다.
요소 상위 레이블	요소의 부모 요소(또는 한 수준의 부모에서 발견되지 않은 경우 상위 조상)에 있는 텍스트 레이블입니다.

네트워크 요청

애플리케이션이 네트워크 요청을 수행할 때 캡처합니다. 기본적으로 Amplitude는 응답 코드가 500~599인 네트워크 요청을 추적하며 모든 amplitude.com 도메인에 대한 요청을 제외합니다.

네트워크 요청 추적을 활성화하려면 SDK 구성에서 true을 config.autocapture.networkTracking으로 설정하십시오.

속성 이름	설명
[Amplitude] URL	민감한 정보가 마스크된 네트워크 요청의 URL입니다.
[Amplitude] URL 쿼리	URL의 쿼리 매개 변수입니다.
[Amplitude] URL 프래그먼트	URL의 프래그먼트 식별자입니다.
[Amplitude] 요청 방법	요청에 사용된 HTTP 메소드입니다(예: GET, POST, PUT 또는 DELETE).
[Amplitude] 상태 코드	응답의 HTTP 상태 코드입니다.
[Amplitude] 오류 코드	요청이 상태 코드 없이 실패한 경우의 로컬 오류 코드입니다.
[Amplitude] 오류 메시지	요청이 상태 코드 없이 실패한 경우 나타나는 로컬 오류 메시지입니다.
[Amplitude] 시작 시간	요청이 시작된 시점의 타임스탬프(Unix 에포크 날짜 이후 밀리초 단위)입니다.
[Amplitude] 완료 시간	요청이 완료된 시점의 타임스탬프(Unix 에포크 날짜 이후 밀리초 단위)입니다.
[Amplitude] 지속 시간	요청의 지속 시간(밀리초)입니다.
[Amplitude] 요청 본문 크기	요청 본문의 크기(바이트)입니다.
[Amplitude] 응답 본문 크기	응답 본문의 크기(바이트)입니다.
[Amplitude] 요청 본문	캡처된 JSON 요청 본문(`requestBody`캡처 규칙을 구성할 때).
[Amplitude] 응답 본문	캡처된 JSON 응답 본문(캡처 규칙을 구성할 경우)`responseBody`.

고급옵션 캡처 규칙 및 필터링 옵션을 비롯하여 네트워크 추적 구성에 대한 자세한 내용은 브라우저 SDK 2 문서의 네트워크 요청 추적을 참조하십시오.

웹 바이탈

브라우저 탭이 숨겨져 있을 때 Core Web Vitals 성능 지표를 캡처합니다.

속성 이름	설명
페이지 도메인	현재 웹 주소의 전체 호스트 이름(예: `www`또는 `app`와 같은 하위 도메인 포함).
페이지 위치	전체 URL 검색 매개 변수를 포함한 현재 페이지의 전체 URL입니다.
페이지 경로	현재 페이지의 경로 이름. 이것은 전체 URL 검색 매개 변수 및 URL 조각을 제외합니다.
페이지 제목	페이지의 제목입니다.
페이지 URL	URL 검색 매개 변수를 제외한 페이지의 URL입니다.
LCP(가장 큰 콘텐츠 페인트)	가장 큰 콘텐츠 요소가 뷰포트에 표시될 때까지 걸리는 시간입니다. 밀리초 단위로 측정됩니다.
FCP(최초 콘텐츠 페인트)	첫 번째 콘텐츠 요소가 화면에 페인팅되는 데 걸리는 시간입니다. 밀리초 단위로 측정됩니다.
INP(다음 페인트에 대한 상호작용)	사용자 상호 작용부터 다음 페인트칠까지의 시간입니다. 밀리초 단위로 측정됩니다.
CLS(누적 레이아웃 이동)	예기치 않은 레이아웃 변경에 대한 모든 개별 레이아웃 변경 점수의 합계입니다. 차원이 없는 값입니다.
TTFB (Time to First Byte)	탐색이 시작된 때부터 응답의 첫 번째 바이트를 수신할 때까지의 시간입니다. 밀리초 단위로 측정됩니다.

각 지표에는 Web Vitals 임계값 및 타이밍 데이터를 기반으로 한 성능 등급(양호함, 개선 필요성 또는 불량함)이 포함됩니다.

이 내용이 도움이 되었나요?