자동 캡처를 사용하여 신속한 인사이트 확보

Amplitude 아카데미

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

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

시작하기

자동 캡처는 최소한의 설정으로 Amplitude 브라우저, iOS, Android 및 Flutter SDK에서 페이지 뷰, 세션, 클릭 및 양식 상호 작용과 같은 일반적인 상호 작용을 자동으로 수집합니다. 이 페이지에서는 각 플랫폼에서 자동 캡처를 활성화하는 방법을 보여줍니다. Autocapture가 수집하는 이벤트 및 속성의 전체 목록은 Autocapture 참조를 참조하십시오.

웹용 자동 캡처

버전 2.10.0부터 Amplitude Browser SDK에는 사이트의 이벤트, 상호 작용 및 어트리뷰션을 캡처할 수 있도록 도와주는 자동 캡처가 포함되어 있습니다.

브라우저 SDK 설치

Data region
HTML
<script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
<script>
window.amplitude.add(window.sessionReplay.plugin({sampleRate: 1}));
window.amplitude.init('AMPLITUDE_API_KEY', {"fetchRemoteConfig":true,"autocapture":{"attribution":true,"fileDownloads":true,"formInteractions":true,"pageViews":true,"sessions":true,"elementInteractions":true,"networkTracking":true,"webVitals":true,"frustrationInteractions":true}});
</script>

SDK 초기화

브라우저 SDK 2.10.0 이상에는 요소 클릭 및 변경 추적이 포함되어 있어 Amplitude 첫 사용 후 시각적 라벨링을 가능하게 합니다. 이를 활성화하려면 SDK를 초기화할 때 config.autocapture.elementInteractions을(를) true로 설정하십시오.

추가 초기화 필요 없음.

콘텐츠 보안 정책(CSP)

웹 앱이 엄격한 콘텐츠 보안 정책(CSP)을 구성한 경우 정책을 조정하여 Amplitude 도메인을 허용하세요.

  • https://*.amplitude.com을 script-src에 추가하십시오.
  • https://*.amplitude.com을 connect-src에 추가하십시오.

이벤트

자세한 내용은 브라우저 SDK 2 문서의 자동 캡처를 참조하십시오.

기본 이벤트 접두사

Amplitude는 자동 캡처 이벤트 앞에 Amplitude 로고를 접두사로 붙입니다.

마케팅 어트리뷰션

다음 속성을 캡처합니다.

사용자 속성

Amplitude는 비활성화되어 있지 않은 경우 모든 Autocapture 이벤트에 사용자 속성을 연결합니다.

웹용 시각적 라벨링

Amplitude의 시각적 라벨링 도구를 사용하면 페이지에서 추적할 개별 요소를 식별하고 선택할 수 있습니다. 예를 들어 가입 버튼을 클릭한 사용자 수를 추적하려면 시각적 라벨링을 통해 버튼을 선택합니다. 그런 다음 Amplitude는 해당 특정 요소를 대상으로 하는 이벤트를 생성합니다.

시각적 라벨링을 사용하여 추가한 이벤트는 소급적으로 작동합니다. 왜냐하면 Amplitude는 계측기가 실행 중일 때부터 시작되는 모든 양식 관련 이벤트를 캡처하기 때문입니다.

자세한 내용은 시각적 레이블링을 참조하십시오.

iOS용 자동 캡처

Amplitude의 iOS SDK 최신 버전에는 자동 캡처 기능이 포함되어 있습니다.

SDK 설치

iOS-Swift SDK 문서의 지침에 따라 SDK를 설치합니다.

자동 캡처를 활성화한 상태에서 SDK 초기화

기본적으로 iOS SDK는 세션 추적을 활성화하고 애플리케이션 생애주기 분석, 화면 보기 및 요소 상호 작용 추적을 비활성화합니다. 모든 자동 캡처 기능을 활성화하려면 다음 스니펫을 사용하여 SDK를 초기화하십시오.

let amplitude = Amplitude(configuration: Configuration(
    apiKey: "API_KEY",
    autocapture: [.sessions, .appLifecycles, .screenViews, .networkTracking]
))

이벤트 자동 캡처

사용자 속성

Amplitude는 비활성화되어 있지 않은 경우 모든 Autocapture 이벤트에 사용자 속성을 연결합니다.

Android용 자동 캡처

Amplitude의 Android SDK 최신 버전에는 자동 캡처 기능이 포함되어 있습니다.

SDK 설치

Android-Kotlin SDK 문서의 지침에 따라 SDK를 설치합니다.

자동 캡처를 활성화한 상태에서 SDK 초기화

기본적으로 Android-Kotlin SDK는 세션 추적을 활성화하고 애플리케이션 생애주기 분석, 화면 보기, 딥링크 및 요소 상호 작용 추적을 비활성화합니다. 모든 자동 캡처 기능을 활성화하려면 다음 스니펫을 사용하여 SDK를 초기화하십시오.

Amplitude(
	Configuration(
	 apiKey = AMPLITUDE_API_KEY,
		context = applicationContext,
		autocapture = autocaptureOptions {
          +sessions               // or `+Autocapture.SESSIONS` [tl! ~~]
          +appLifecycles          // or `+Autocapture.APP_LIFECYCLES` [tl! ~~]
          +deepLinks              // or `+Autocapture.DEEP_LINKS` [tl! ~~]
          +screenViews            // or `+Autocapture.SCREEN_VIEWS` [tl! ~~]
    	}
	)
)

이벤트 자동 캡처

사용자 속성

Amplitude는 비활성화되어 있지 않은 경우 모든 Autocapture 이벤트에 사용자 속성을 연결합니다.

React Native용 자동 캡처

@amplitude/analytics-react-native1.6.8 이상에서 사용할 수 있습니다. React Native SDK는 세션, 애플리케이션 라이프사이클, 화면 보기, 요소 상호 작용 및 프러스트레이션 상호 작용을 위한 자동 캡처를 포함합니다. 구성 세부 정보를 보려면 React Native SDK | Autocapture로 이동하세요.

SDK 설치

React Native SDK에서 지시된 대로 SDK를 설치합니다.

자동 캡처를 활성화한 상태에서 SDK 초기화

모든 자동 캡처 기능을 활성화하려면 autocapture: true를 설정합니다.

ts
import { init } from "@amplitude/analytics-react-native";
init("API_KEY", undefined, {
  autocapture: true,
});

일부 자동 캡처 기능을 활성화하고 다른 기능은 활성화하지 않으려면, 해당 설정을 자동 캡처 옵션 객체로 autocapture구성하십시오.

ts
import { init } from "@amplitude/analytics-react-native";
init("API_KEY", undefined, {
  autocapture: {
    sessions: true,
    appLifecycles: false,
    elementInteractions: true,
    frustrationInteractions: true,
    screenViews: false,
  },
});

화면 보기를 사용하려면 trackScreenView을 호출하거나 React Navigation에 trackScreenViewOnNavigationStateChange을 연결해야 합니다. 화면 뷰 추적을 참조하십시오.

요소 상호 작용의 경우, 을 활성화하고 autocapture.elementInteractions핸들러를 ampCapture으로 래핑하거나, Babel 트랜스파일 플러그인을 추가하여 Metro가 컴파일 시 래핑하도록 하십시오. 요소 상호 작용 추적을 참조하십시오.

프러스트레이션 상호 작용의 경우, autocapture.frustrationInteractions을 활성화하십시오. Rage 클릭 및 오류 클릭은 동일한 래핑된 핸들러를 사용합니다. Rage 클릭에는 SDK 1.11.0이상이 필요하며, 오류 클릭에는 1.12.0이상이 필요합니다. 불만 상호작용 추적을 참조하십시오.

이벤트 자동 캡처

Flutter용 자동 캡처

Amplitude의 Flutter SDK의 최신 버전은 iOS, Android 및 웹용 자동 캡처를 포함합니다.

SDK 설치

Flutter SDK 4 문서에 설명된 대로 SDK를 설치합니다. 웹의 경우에도 Amplitude Browser SDK 스니펫을 web/index.html로드합니다.

자동 캡처를 활성화한 상태에서 SDK 초기화

기본적으로 Flutter SDK는 세션 추적을 활성화합니다. 웹에서도 마케팅 기여를 활용할 수 있습니다. 화면 뷰, 페이지 보기 및 DOM 기반 웹 옵션(요소 상호 작용, 양식 상호 작용 및 파일 다운로드)은 기본적으로 꺼져 있습니다. 모든 자동 캡처 기능을 활성화하려면 SDK를 AutocaptureEnabled()로 초기화하고 화면 보기를 위해 AmplitudeNavigatorObserver를 연결하세요.

dart
import 'package:amplitude_flutter/amplitude.dart';
import 'package:amplitude_flutter/configuration.dart';
import 'package:amplitude_flutter/autocapture/autocapture.dart';
import 'package:amplitude_flutter/observers/amplitude_navigator_observer.dart';
final Amplitude analytics = Amplitude(
  Configuration(
    apiKey: 'YOUR-API-KEY',
    autocapture: AutocaptureEnabled(),
  ),
);
MaterialApp(
  navigatorObservers: [AmplitudeNavigatorObserver(analytics)],
  // ...
);

Web DOM 기반 캡처(클릭, 양식 및 파일 다운로드)의 경우, Flutter의 접근성 시맨틱 트리를 활성화하십시오. Flutter SDK 4 참조에서 Flutter 웹 DOM 캡처를 참조하십시오.

이벤트 자동 캡처

구성 옵션과 플랫폼 세부 정보는 Flutter SDK 4의 자동 캡처를 참조하십시오.

사용자 속성

Amplitude는 비활성화되어 있지 않은 경우 모든 Autocapture 이벤트에 사용자 속성을 연결합니다.

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

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.

이 페이지에서