타겟 세션 캡처
TRC(Targeted Replay Capture)는 모든 세션을 캡처하거나 무작위 샘플링에 의존하지 않고 이벤트, 이벤트 속성, 사용자 속성 또는 페이지 URL 등과 같이 사용자가 정의한 기준과 일치하는 세션에 세션 리플레이 할당량을 집중시킵니다. 특정 동작이나 고가치 세그먼트를 관찰해야 할 경우 TRC를 사용하십시오. 광범위한 세션 범위만 필요한 경우 대신 글로벌 샘플링 속도를 구성하십시오.
프로젝트의 세션 리플레이 설정에서 샘플링 컨트롤에 조건을 추가하여 TRC를 구성합니다. 각 조건은 이벤트, 이벤트 속성, 사용자 속성 또는 페이지 URL과 일치할 수 있으며 조건을 OR 논리와 결합할 수 있습니다. 세션 리플레이 SDK는 원격 구성 서비스에서 타겟팅 구성을 가져오고 런타임에 이를 평가하여 세션을 캡처할지 여부를 결정합니다.
주요 기능
TRC는 Amplitude가 세션을 캡처할지 여부를 결정하기 위해 사용하는 기준을 정의하며, 사용자가 세션 리플레이 할당량을 보다 효율적으로 관리할 수 있도록 도와줍니다.
사용자 정의 캡처 기준
다음을 기준으로 재생을 캡처하는 규칙을 정의합니다.
- 특정 이벤트: 예를 들어,
Checkout Started. - 이벤트 속성: 예를 들어,
plan = Pro. - 사용자 속성: 예를 들어,
country = US. - 페이지 URL: 예를 들어,
/checkout또는 패턴과 일치하는 URL의 세션만 캡처합니다. - 조합: 이러한 기준을
OR논리와 결합합니다.
구성 및 할당량 관리
샘플링 컨트롤에 조건을 추가하여 세션 리플레이 설정 페이지를 통해 TRC를 관리할 수 있습니다. 각 프로젝트에 대한 타겟팅 조건을 추가, 편집 및 제거합니다. UI는 과거 트래픽을 기반으로 각 조건이 사용하는 할당량을 추정합니다. Amplitude가 캡처하는 세션과 각 조건이 사용하는 할당량의 양을 제어하려면 조건마다 다른 샘플링 속도를 설정하십시오.
활용 사례
- 오류가 발생하거나 중요한 지점에서 중단된 사용자를 위해서만 재생을 캡처합니다.
- 가치가 높은 사용자 세그먼트나 중요한 제품 흐름에 집중하십시오.
- 체크아웃이나 온보딩과 같은 특정 페이지 또는 흐름에서 세션을 캡처합니다.
- 불필요한 재생 캡처를 방지하여 노이즈와 비용을 줄입니다.
타겟 재생 캡처 구성
세션 리플레이 설정을 관리하기 위한 권한과 조건 유형을 지원하는 SDK가 필요합니다. 조건을 구성하기 전에 SDK 지원 매트릭스를 확인하십시오.
TRC 조건은 세션 리플레이 설정 UI에서 기본 샘플링 속도를 설정할 때까지 적용되지 않습니다. 기본 샘플링 속도를 설정할 때까지 세션 리플레이는 SDK에서 구성된 샘플링 속도와 설정을 사용합니다.
프로젝트별로 TRC 구성:
- _설정 > 조직 설정 > 세션 리플레이 설정_으로 이동합니다. 자세한 내용은 세션 리플레이 설정 페이지를 참조하십시오.
- 구성하려는 프로젝트를 선택합니다.
- 샘플링 섹션에서 조건 추가를 선택하여 새 타겟팅 조건을 생성합니다.
- 조건에 대한 타겟팅 기준을 정의하십시오.
여러 조건을 추가하고 이를 OR 논리와 결합합니다. 각 조건에는 다음이 포함될 수 있습니다.
- 이벤트 유형입니다.
- 이벤트 속성.
- 사용자 속성.
- 페이지 URL(웹에만 해당).
이벤트 기반 및 속성 기반 타겟팅 조건이 작동하려면 세션 다음 기간동안 이벤트, 이벤트 속성 및 사용자 속성을 캡처하여 Amplitude로 전송해야 합니다. 페이지 URL 조건은 사용자의 현재 URL을 직접 평가하며 일치하는 이벤트를 필요로 하지 않습니다.
페이지 URL 타겟팅
페이지 URL 타겟팅은 사용자가 특정 페이지나 URL 패턴을 방문했을 때만 재생을 캡처합니다. 이 기능은 웹 세션 리플레이를 위한 베타 버전입니다.
최소 플러그인 및 독립형 버전에 대해 SDK 지원을 확인하십시오.
페이지 URL 조건을 추가하려면 다음과 같이 하십시오.
- 샘플링 섹션에서 조건 추가를 선택하고 조건 편집기를 엽니다.
- 페이지 URL 조건을 추가합니다.
- 연산자를 선택하고 URL 또는 패턴을 입력합니다.
- 조건에 대한 샘플링 속도를 설정하고 저장합니다.
지원되는 연산자:
| 연산자 | 다음 조건 시 일치 |
|---|---|
| 같음 | 현재 페이지 URL은 입력한 값과 정확히 일치합니다. |
| 아닙니다 | 현재 페이지 URL은 입력한 값과 정확히 일치하지 않습니다. |
| 포함합니다 | 현재 페이지 URL에는 사용자가 입력한 텍스트가 포함되어 있습니다. |
| 포함하지 않습니다 | 현재 페이지 URL에는 사용자가 입력한 텍스트가 포함되어 있지 않습니다. |
| glob 매치 | 현재 페이지 URL이 glob 패턴과 일치합니다. 예를 들어 https://example.com/checkout/*은 모든 체크아웃 하위 경로와 일치합니다. |
페이지 URL 타겟팅을 사용하면 모든 세션을 캡처하지 않고도 체크아웃, 온보딩 또는 계정 설정과 같은 가치가 높은 흐름에 리플레이 캡처를 집중할 수 있습니다.
페이지 URL 타겟팅의 평가 방법
URL 평가 및 캡처 시작 동작을 보려면 평가 타이밍으로 이동하십시오.
SDK 지원
TRC는 웹 및 iOS 세션 리플레이 SDK와 함께 작동합니다. Android 지원이 곧 제공됩니다.
웹
| 조건 유형 | 브라우저 플러그인 | 브라우저 독립형 SDK |
|---|---|---|
| 이벤트, 이벤트 속성 및 사용자 속성 | @amplitude/plugin-session-replay-browser@1.22.0 이상, Amplitude 브라우저 분석 SDK 사용 | 지원되지 않음 |
| 페이지 URL입니다. | @amplitude/plugin-session-replay-browser@1.26.2 또는 이상 | @amplitude/session-replay-browser@1.32.2 또는 이상 |
이벤트 및 속성 기반 타겟팅을 사용하려면 Amplitude Browser 분석 SDK가 포함된 세션 리플레이 브라우저 SDK 플러그인이 필요합니다. 독립형 SDK는 페이지 URL 타겟팅만 지원합니다.
iOS
| 조건 유형 | iOS 플러그인 | iOS 독립형 SDK |
|---|---|---|
| 이벤트, 이벤트 속성 및 사용자 속성 | AmplitudeSessionReplay 0.15.0 이상, iOS Swift SDK 사용 | AmplitudeSessionReplay 0.15.0 이상; 앱이 이벤트 및 사용자 속성을 전달합니다. |
| 페이지 URL입니다. | 해당 없음 | 해당 없음 |
세션 리플레이 iOS 플러그인은 추가 코드 없이 각 이벤트와 사용자의 속성에 대해 조건을 평가합니다. 독립형 SDK를 사용하면 앱이 각 이벤트와 사용자의 속성을 세션 리플레이에 전달합니다.
Segment 플러그인, 세션 리플레이 iOS 미들웨어, Flutter 및 React Native는 아직 TRC 조건을 평가하지 않습니다. 프로젝트에 타겟팅 조건이 있는 경우 세션 리플레이는 이러한 연동에서 프로젝트의 샘플링 속도로만 세션을 캡처합니다.
평가 시기
웹에서 SDK는 세션 시작 시 타겟팅 구성을 가져옵니다. 이벤트, 속성 및 사용자 기반 조건은 나중에 일치하는 이벤트가 발생할 때를 포함하여 세션 전체에서 해당 구성을 사용합니다. 타겟팅 규칙에 대한 업데이트는 새 세션에만 적용됩니다.
SDK는 현재 브라우저 URL에 대해 페이지 URL 조건을 평가하고 단일 페이지 앱 탐색을 포함하여 URL이 변경되면 재평가합니다. 세션이 타겟팅 조건을 충족하면 캡처가 세션의 나머지 시간 동안 계속됩니다.
iOS에서 SDK는 초기화될 때와 새 세션이 시작될 때 타겟팅 구성을 가져옵니다. 구성이 도착할 때, 세션이 시작될 때, 각 이벤트에 대해, 그리고 사용자의 속성이 변경될 때 조건을 평가합니다. 구성 업데이트는 캡처를 시작하지 않은 세션에 적용되므로 변경 사항은 일반적으로 다음 세션에서 적용됩니다. iOS 플러그인을 사용하면 사용자 속성 조건은 현재 앱 시작 시 앱이 identify와 함께 설정한 속성을 사용합니다. 앱이 다시 시작된 후, 세션 리플레이는 앱이 사용자를 식별하면 다시 사용합니다.
캡처 타이밍
은 타겟팅 조건이 트리거될 때 시작됩니다. 이벤트 기반 조건의 경우 일치하는 이벤트가 발생할 때 캡처가 시작됩니다. 페이지 URL 조건의 경우 캡처는 URL이 일치할 때 시작됩니다. TRC에는 룩백 기간이 없습니다. 재생에는 조건이 트리거되기 전의 활동이 포함되지 않습니다.
이 내용이 도움이 되었나요?
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.