이 페이지에서

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.

자동 캡처

Amplitude 아카데미

자동 캡처 및 시각적 라벨링을 사용하여 웹사이트 클릭 추적

자동 캡처 및 시각적 라벨링을 사용하여 웹사이트 클릭 이벤트를 정의하는 방법을 배우면 Amplitude 구현을 단순화하고 제품 사용 인사이트를 빠르게 나타낼 수 있습니다.

시작하기

Autocapture는 이벤트별 계측이 아닌 하나의 SDK 스니펫을 사용하여 웹사이트 또는 앱에서 미리 정의된 일련의 사용자 상호 작용을 수집합니다. 웹에서는 브라우저 SDK를 통해 세션, 페이지 뷰, 클릭, 양식 상호 작용, 파일 다운로드, 마케팅 어트리뷰션 및 페이지 URL 보강을 캡처하며, iOS 및 Android에서는 iOS Swift SDK 및 Android-Kotlin SDK를 통해 설치, 업그레이드, 세션 및 화면 뷰를 캡처합니다. 사용자 지정 이벤트 트래킹의 범위를 지정하기 전에 기준 프로덕트 분석을 신속하게 수행해야 할 때 이 기능을 설정하십시오.

계측 작업 없이 즉시 광범위한 기준선 범위를 원할 때 자동 캡처를 사용하십시오. 구매나 기능별 동작과 같은 특정 비즈니스 논리에 연결된 사용자 지정 이벤트나 속성이 필요한 경우 정밀한 추적을 사용하십시오. 이 두 가지는 함께 작동하므로 대부분의 팀은 두 가지 모두를 운영합니다.

웹에서는 시각적 레이블링을 사용하여 사이트를 탐색하고 클릭 정보로부터 새 이벤트를 생성할 수도 있습니다.

자동 캡처 및 정밀 추적

Amplitude는 이벤트를 캡처하는 두 가지 주요 방법을 제공합니다.

  • 자동 캡처는 Amplitude SDK를 사용하여 표준화된 택소노미에서 사전 정의된 일련의 이벤트와 속성을 자동으로 수집합니다.
  • 비즈니스 요구와 분석에 맞춰 이벤트와 속성을 정밀하게 계측합니다.

사용자가 SDK를 설치하는 순간부터 Amplitude는 자동으로 데이터를 수집하여 기능 사용량, 퍼널 전환율 및 웹에서의 클릭 분석에 대한 인사이트를 제공합니다. 또한 브라우저 SDK는 이전 페이지 추적 및 페이지 유형 분류를 비롯한 페이지 URL 정보로 모든 이벤트를 보강합니다. 자동 캡처는 설정 시간을 최소화하므로 분석에 바로 착수할 수 있습니다.

애플리케이션에서 추가 메타데이터가 필요한 특정 작업을 조사하거나 구매 이벤트와 같은 비즈니스의 핵심 요소를 추적하려면 정밀 추적을 사용하십시오. 코드의 정밀한 추적은 심층적인 분석을 위해 강력한 속성 세트와 함께 이러한 이벤트를 전송합니다.

예를 들어 새로운 기능을 출시하려고 하는데 정밀한 추적을 구현할 시간이 없다고 가정해 보십시오. 자동 캡처는 기준 지표를 수집하고 참여 질문에 답변하기 위한 안전망 역할을 할 수 있습니다. 이러한 인사이트를 얻고 더 깊이 연구하고 싶다면 팀과 협력하여 정확하게 추적된 이벤트를 구현하고 두 가지 접근 방식의 장점을 활용하십시오.

이벤트 볼륨 최적화

Autocapture는 고객의 요구에 맞게 구현을 조정할 수 있도록 여러 가지 구성 옵션을 제공합니다. 필요에 따라 개별 자동 캡처 이벤트를 켜거나 끌 수 있으며 이러한 이벤트를 추가로 조정하여 이벤트 볼륨을 최적화할 수 있습니다.

기본 구성은 중요한 이벤트를 자동으로 캡처하는 동시에 중요하지 않은 이벤트를 제외하는 적절한 균형을 유지합니다. 이 균형은 클릭을 캡처할 때 매우 중요합니다. 기본적으로 Amplitude는 대화형 요소(예: 링크, 텍스트 필드, 드롭다운 및 기타 양식 요소)에 대한 클릭을 캡처합니다. 또한 Amplitude는 페이지의 변경(예: 새 시각적 요소)이나 새 페이지로의 탐색을 초래하는 요소에 대한 클릭을 캡처합니다. 이 구성은 빈 영역에 대한 클릭, 텍스트 강조 표시 및 유사한 작업을 제외하여 가치가 낮은 사용자 행동에 대해 비용을 지불하지 않도록 합니다.

Amplitude는 변경 사항을 적용할 때 이벤트 볼륨을 모니터링하여(설정 > 플랜 및 결제로 이동) 해당 볼륨이 귀하의 기대치와 일치하는지 확인할 것을 권장합니다. 특정 요소(또는 특정 클래스를 가진 요소)에 대한 클릭만을 캡처하거나, 특정 페이지에 대한 클릭만을 추적하거나, 페이지 뷰 및 세션과 같은 다른 자동 캡처 데이터를 계속 사용하는 동안 클릭 추적을 해제하도록 구성을 변경할 수 있습니다.

자동 캡처를 사용한 택소노미

택소노미를 깨끗하고 체계적으로 유지하면 사용자가 필요한 정보를 찾을 수 있습니다. 자동 캡처를 활성화하면 수집을 위해 사전 정의된 이벤트 및 속성 유형 세트를 얻을 수 있습니다. 예를 들어 SDK는 불필요한 사용자 상호 작용의 스트림이 아닌, 사전 정의된 속성 세트를 가진 두 개의 이벤트("Element Clicked" 및 "Element Changed")로 클릭 상호작용을 캡처합니다.

시각적 레이블링을 사용하면 조직의 사용자가 UI에서 직접 이벤트를 생성할 수 있습니다. 택소노미를 계획할 때 다음 사항을 고려하십시오.

  • 각 사용자에 대해 올바른 권한 관리를 설정하십시오. 멤버 역할을 가진 사용자는 레이블이 지정된 이벤트를 만들 수 있습니다.
  • 이름 지정 규칙을 레이블이 지정된 이벤트에 대한 기존 택소노미와 일치시킵니다.
  • 레이블이 지정된 이벤트에 설명을 추가하여 다른 사용자가 해당 이벤트의 목적을 이해할 수 있도록 하십시오.

레이블이 지정된 이벤트에 대한 추가 세부 정보:

  • 레이블이 지정된 이벤트는 데이터 > 이벤트에 별도의 탭을 갖추어 원시 수집된 이벤트와는 다르게 관리할 수 있습니다. 이 탭에는 레이블이 지정된 이벤트를 생성한 사람과 각 이벤트의 생성 날짜가 표시됩니다.
  • 레이블이 지정된 이벤트는 이벤트 드롭다운에 다른 아이콘을 표시하므로 귀하와 사용자가 이를 다른 이벤트와 구별할 수 있습니다.

개인정보 보호 및 보안

많은 조직에서 데이터 개인정보 보호, 보안 및 개인 식별 정보(PII)는 데이터 수집을 설정할 때 중요한 요소입니다. 비즈니스 요구, 디지털 제품의 목적, 컴플라이언스 요건은 관할권마다 다를 수 있습니다. 모든 상황에 맞는 한 가지 솔루션은 없습니다.

Autocapture는 유연한 구성 옵션을 제공하므로 귀사의 개인 정보 보호 및 보안 정책과 요구 사항을 준수할 수 있습니다. Amplitude의 사용이 귀하의 데이터 개인정보 보호 정책 및 요구 사항을 준수하는지 확인하는 것은 귀하의 책임이지만, 이러한 설정은 귀하가 컴플라이언스에 도달하는 데 도움이 됩니다.

기본 자동 캡처 보호 기능

자동 캡처가 수집하여 Amplitude 플랫폼으로 전송하는 정보를 제어할 수 있습니다. 자동 캡처가 Amplitude로 전송하는 이벤트를 업데이트하려면 브라우저 SDK | 자동 캡처 비활성화를 참조하십시오.

다음 목록은 페이지 요소의 클릭 및 변경 사항을 캡처하기 위한 자동 캡처의 기본 설정('클릭된 요소' 및 '변경된 요소' 이벤트)에 대해 설명합니다. 이 목록에는 다음과 같은 개인 정보 보호 및 보안 고려 사항도 포함되어 있습니다. 이러한 보호 기능을 활성화하기 위해 아무 것도 할 필요가 없습니다. 그들은 항상 활동적입니다.

  • 최종 사용자 텍스트 입력, 선택 항목, 텍스트 영역 요소 및 속성으로 사용되는 모든 HTML 요소와 같은 민감한 요소의 경우 SDK는 클래스 이름과 유형 속성만 수집합니다. contenteditable="true"자동 캡처는 최종 사용자가 입력한 전체 텍스트를 제외합니다.
  • 자동 캡처의 기본 설정은 비밀번호나 숨겨진 속성이 있는 양식 필드와 같은 중요한 입력 필드의 수집을 더욱 제한하며 클래스 및 유형 속성 값만 캡처합니다. 자동 캡처는 최종 사용자가 입력 필드에 입력한 전체 콘텐츠를 포함하여 이러한 요소에 대한 다른 세부 정보를 캡처하지 않습니다.
  • 자동 캡처는 웹사이트 또는 앱에 표시되는 텍스트를 캡처합니다. 예를 들어 클릭된 요소의 콘텐츠와 해당 자식이 textContent있습니다. Amplitude는 민감한 정보가 포함되어 있을 수 있는 페이지에서 자동 캡처의 요소 상호 작용 추적을 사용하지 않는 것을 권장합니다. Amplitude는 패턴 매칭을 사용하여 신용카드 번호, 주민등록번호 또는 이메일 주소와 유사한 모든 텍스트 콘텐츠를 자동으로 마스크합니다.
  • 이러한 속성 수집 규칙의 예외는 요소에 접두사 가 붙은 명시적 속성이 추가된 경우입니다data-amp-track-. 이 예외를 사용하면 이러한 속성의 데이터가 의도적으로 Amplitude로 다시 전달됩니다.
  • Autocapture는 값, 이벤트 처리기, 스타일, react 속성을 자동으로 제거합니다.
  • <title>속성을 요소에 추가하여 페이지 보기 이벤트에서 data-amp-mask페이지 제목을 마스크 처리하십시오. 이렇게 하면 실제 제목이 마스킹된 값으로 바뀌어 민감한 정보를 보호할 수 있습니다. 구현 세부 정보는 브라우저 SDK 페이지 제목 마스킹을 참조하십시오.

수동 자동 캡처 보호 기능

Amplitude는 다음과 같은 자동 캡처 보호 기능을 제공합니다(구현하기로 선택한 경우). 기본적으로 Amplitude는 이러한 기능을 활성화하지 않습니다. 아래에 나열된 보호 기능의 전부 또는 일부를 활성화할 수 있습니다.

이러한 보호 기능 중 일부를 위해서는 요소에 속성을 추가해야 합니다. 이러한 보호 기능 중 일부는 데이터 설정 > 자동 캡처 페이지를 통해 활성화할 수 있습니다. 각 보호 기능에 대한 문서는 이를 활성화하는 방법을 설명합니다.

정밀한 텍스트 마스킹

정밀한 텍스트 마스킹은 페이지의 특정 요소에서 캡처된 텍스트를 수정합니다. 이 속성은 해당 요소에 표시된 텍스트를 마스킹하는 동안 클릭을 추적합니다.

요소의 텍스트를 마스크하려면 요소에 속성을 추가하십시오data-amp-mask. 예를 들어, 버튼에 다음과 같은 내용이 있는 경우:

html
<div data-amp-mask>John Doe</div>

자동 캡처는 여전히 div 요소에 대한 클릭을 추적합니다. 그러나 텍스트 콘텐츠 "John Doe"는 자동 캡처 데이터에 *****나타납니다. 이 제외는 SDK 수준에서 작동합니다.

정밀한 텍스트 마스킹은 재귀적으로 작동하므로 자동 캡처는 요소에 포함된 모든 텍스트를 마스킹합니다. 예를 들면 다음과 같습니다.

html
<div data-amp-mask>
  John Doe
  <div>Jane Doe</div>
</div>

이 예제에서 자동 캡처는 두 이름을 모두 *****로 마스킹합니다.

정밀한 속성 마스킹

정확한 속성 마스킹은 캡처할 때 특정 HTML 속성을 교정합니다. 마스크할 속성을 정의하면 자동캡처는 HTML에서 해당 속성을 수정하는 동안 클릭을 추적합니다. 요소에 속성을 지정하면 모든 하위 요소에 대한 해당 속성도 마스킹됩니다.

예를 들어 다음과 같은 속성을 포함할 경우

html
<div data-amp-mask-attributes="name">
     <span name="John D">Account</span>
</div>

버튼이나 링크에서 Autocapture는 "John D"라는 이름을 *****로 마스킹합니다.

또한 목록을 사용하여 마스크할 속성을 둘 이상 지정할 수도 있습니다. 목록을 사용할 때는 마스킹 속성의 형식을 data-amp-mask-attributes="name,ssn"로 지정하십시오.

ID 및 클래스 속성은 시각적 레이블링에 중요하기 때문에 정보를 마스킹할 수 없습니다.

패턴(RegEx) 마스킹

사용자가 지정한 패턴(정규식 또는 RegEx)을 기반으로 정보를 마스킹할 수 있습니다. 정규표현식에 익숙하지 않은 경우 이 페이지에서 정규표현식에 대해 살펴보십시오.

Autocapture에서 마스킹할 정보 패턴을 지정합니다. 이 구성은 SDK에서 발생하며 Amplitude가 이메일, 신용카드, 사회보장번호를 마스킹하는 데 사용하는 기본 패턴에 대한 추가 보호 계층을 제공합니다. RegEx 필터는 이 데이터가 나타날 수 있는 전체 필드의 값을 마스킹하며, 여기에는 페이지의 표시되는 필드와 숨겨진 속성이 모두 포함됩니다.

예를 들어 정규표현식 패턴을 설정하여 ****-**** **** 1234와 같은 신용카드 번호를 필터링할 수 있습니다. 이 예제에서는 마지막 4자리를 포함한 신용카드 정보를 완전히 마스킹하려고 합니다. RegEx 필터 /(?i)ends\s*in\s*[0-9]{4}/를 추가합니다. Amplitude가 패턴과 일치하는 신용카드 정보를 발견하면 자동 캡처는 해당 번호를 *****로 마스킹합니다.

데이터 설정 > 자동 캡처 > 요소 상호 작용 페이지를 통해 이 기능을 활성화하십시오.

페이지 URL 제외 및 허용 목록

페이지 URL 제외 및 허용 목록을 사용하여 자동 캡처에서 제외하거나 포함할 고유 URL 패턴을 지정할 수 있습니다. 조직에서 더 강력한 제한 또는 보호 장치가 필요하거나 웹사이트 또는 앱에 금융 서비스, 의료 및 의료 기술 분야와 같이 매우 민감한 데이터가 포함된 페이지가 포함되어 있을 수 있는 경우 이러한 기능을 사용하십시오.

예를 들어 사용자의 계정 설정 또는 테스트 데이터만 포함된 URL과 같은 URL의 특정 하위 도메인에서 사용자 활동을 제외할 수 있습니다.

.com및 .co.uk과 같은 여러 도메인에서 사이트를 호스팅하는 경우 해당 .co.uk 도메인의 데이터만 포함하도록 지정하십시오.

예제

위의 .com및 .co.uk의 예를 사용하여 제외 및 허용 목록의 예제가 다음과 같습니다.

제외 목록

  • 제외 목록에 glob 패턴으로 https://example.co.uk/account/*추가합니다. 이 패턴은 계정 섹션을 제외한 .co.uk도메인에 있는 모든 것을 캡처합니다.

허용 목록

  • 허용 목록에 글로브 패턴으로 https://example.co.uk/*추가하십시오. Amplitude는 .co.uk도메인에서 데이터만 캡처합니다. Amplitude는 .com도메인에서 데이터를 캡처하지 않습니다.

제외 목록은 항상 허용 목록보다 우선합니다. 이 우선 순위는 원하지 않는 데이터가 캡처되는 것을 막아줍니다. 제외 및 허용 목록 모두에 동일한 패턴을 포함하면 자동 캡처에서 해당 패턴을 제외합니다.

데이터 설정 > 자동 캡처 > 요소 상호 작용 페이지를 통해 이 기능을 활성화하십시오.

클릭 추적 제한

시각적 레이블링을 지원하기 위해 자동 캡처는 클릭되거나 변경된 요소에 대한 상호 작용 정보와 HTML 구조에서 요소의 상위 항목에 대한 정보를 캡처합니다. 사이트의 구조에 따라 다음과 같은 작업을 수행할 수 있습니다.

  • 클릭 및 변경 추적에 허용되는 요소를 구체화합니다. cssSelectorAllowlist 및 actionClickAllowlist 옵션을 구성하여 Autocapture가 추적할 수 있는 요소 목록을 변경합니다. 모든 일반적인 HTML 요소를 제거하고 특정 클래스를 가진 요소로 제한할 수 있습니다.

데이터 설정 > 자동 캡처 > 요소 상호 작용 페이지를 통해 이 기능을 활성화하십시오.

Autocapture 이벤트 해제

자동 캡처를 완전히 해제하고 데이터 수집을 위해 정밀 추적을 사용할 수 있습니다. Amplitude에는 사용자 지정 택소노미의 계획 및 구현을 지원하는 강력한 데이터 관리 도구와 워크플로우가 포함되어 있습니다.

SDK 구성을 통해 전체 또는 모든 자동 캡처 이벤트를 해제하십시오.

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