이 페이지에서

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.

Targeted Replay Capture

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가 캡처하는 세션과 각 조건이 사용하는 할당량의 양을 제어하려면 조건마다 다른 샘플링 속도를 설정하십시오.

활용 사례

  • 오류가 발생하거나 중요한 지점에서 중단된 사용자를 위해서만 재생을 캡처합니다.
  • 가치가 높은 사용자 세그먼트나 중요한 제품 흐름에 집중하십시오.
  • 체크아웃이나 온보딩과 같은 특정 페이지 또는 흐름에서 세션을 캡처합니다.
  • 불필요한 재생 캡처를 방지하여 노이즈와 비용을 줄입니다.

타겟 재생 캡처 구성

TRC를 사용하려면 세션 리플레이 브라우저 SDK 플러그인 버전 @amplitude/plugin-session-replay-browser@1.22.0이상과 세션 리플레이 설정을 관리할 수 있는 권한 관리이 필요합니다. URL 일치를 위해서는 플러그인 버전 1.26.2+ 또는 독립형 SDK @amplitude/session-replay-browser@1.32.2+가 필요합니다. 플러그인을 아직 설치하지 않았다면 먼저 설치하세요.

프로젝트별로 TRC 구성:

  1. 설정 > 조직 설정 > 세션 리플레이 설정으로 이동합니다. 자세한 내용은 세션 리플레이 설정 페이지를 참조하십시오.
  2. 구성하려는 프로젝트를 선택합니다.
  3. 샘플링 섹션에서 조건 추가를 선택하여 새 타겟팅 조건을 생성합니다.
  4. 조건에 대한 타겟팅 기준을 정의하십시오.

여러 조건을 추가하고 이를 OR 논리와 결합합니다. 각 조건에는 다음이 포함될 수 있습니다.

  • 이벤트 유형입니다.
  • 이벤트 속성.
  • 사용자 속성.
  • 페이지 URL입니다.

이벤트 기반 및 속성 기반 타겟팅 조건이 작동하려면 세션 다음 기간동안 이벤트, 이벤트 속성 및 사용자 속성을 캡처하여 Amplitude로 전송해야 합니다. 페이지 URL 조건은 사용자의 현재 URL을 직접 평가하며 일치하는 이벤트를 필요로 하지 않습니다.

페이지 URL 타겟팅

페이지 URL 타겟팅은 사용자가 특정 페이지나 URL 패턴을 방문했을 때만 재생을 캡처합니다. 이 기능은 웹 세션 리플레이를 위한 베타 버전입니다.

페이지 URL 타겟팅을 위해서는 다음 SDK 버전 중 하나가 필요합니다.

  • 플러그인: @amplitude/plugin-session-replay-browser@1.26.2 이상.
  • 독립형 SDK: @amplitude/session-replay-browser@1.32.2 또는 그 이상.

페이지 URL 조건을 추가하려면 다음과 같이 하십시오.

  1. 샘플링 섹션에서 조건 추가를 선택하고 조건 편집기를 엽니다.
  2. 페이지 URL 조건을 추가합니다.
  3. 연산자를 선택하고 URL 또는 패턴을 입력합니다.
  4. 조건에 대한 샘플링 속도를 설정하고 저장합니다.

지원되는 연산자:

페이지 URL 타겟팅을 사용하면 모든 세션을 캡처하지 않고도 체크아웃, 온보딩 또는 계정 설정과 같은 가치가 높은 흐름에 리플레이 캡처를 집중할 수 있습니다.

페이지 URL 타겟팅의 평가 방법

세션 리플레이 SDK는 사용자의 현재 브라우저 URL에 대해 페이지 URL 조건을 평가합니다. 단일 페이지 애플리케이션의 경우 SDK는 URL이 변경될 때 타겟팅을 재평가합니다. 세션이 타겟팅 조건을 충족하면 나머지 세션 기간 동안 캡처가 계속됩니다.

페이지 URL에 대한 캡처 타이밍.

페이지 URL 조건의 경우, 재생 캡처는 사용자의 URL이 조건과 일치할 때 시작됩니다. 재생에는 URL 일치 이전의 활동이 포함되지 않습니다.

SDK 지원

TRC를 사용하려면 @amplitude/plugin-session-replay-browser@1.22.0 버전 이상의 세션 리플레이 브라우저 SDK 플러그인이 포함된 Amplitude 브라우저 분석 SDK가 필요합니다. TRC를 사용하려면 Amplitude Browser 분석 SDK와 세션 리플레이 플러그인을 모두 설정에 통합하십시오.

URL 일치 지원에는 다음 중 하나가 필요합니다.

  • 플러그인: @amplitude/plugin-session-replay-browser@1.26.2 이상.
  • 독립형 SDK: @amplitude/session-replay-browser@1.32.2 또는 그 이상.

독립형 SDK의 제한 사항

독립형 SDK는 페이지 URL 타겟팅만 지원합니다. 이벤트, 속성 및 사용자 기반 TRC 조건을 사용하려면 Amplitude Browser 분석 SDK와 함께 세션 리플레이 Browser SDK 플러그인이 필요합니다.

평가 시기

SDK는 세션 시작 시 타겟팅 구성을 가져옵니다. 이벤트, 속성 및 사용자 기반 조건의 경우 SDK는 전체 세션에 대해 해당 구성을 사용합니다. 세션의 이후 시점에 일치하는 이벤트가 발생하면 SDK는 세션 시작 시 활성화되었던 설정과 비교하여 이를 평가합니다. 타겟팅 규칙에 대한 업데이트는 새 세션에만 적용됩니다.

페이지 URL 조건의 경우 SDK는 단일 페이지 앱 탐색 중과 같이 세션 다음 기간동안 URL이 변경될 때도 재평가합니다.

캡처 타이밍

세션 리플레이 캡처는 타겟팅 조건이 트리거된 후에만 시작됩니다. TRC에는 ‘조회’ 기간이 없습니다. 재생은 조건이 트리거되기 전의 활동을 캡처하지 않습니다. 이벤트 기반 조건의 경우 일치하는 이벤트가 발생할 때 캡처가 시작됩니다. 페이지 URL 조건의 경우 사용자의 URL이 일치할 때 캡처가 시작됩니다.

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