Rudderstack용 세션 리플레이 래퍼

Amplitude는 Rudderstack과 Amplitude의 세션 리플레이를 연동하기 위한 래퍼를 제공합니다.

래퍼 설치

npm 또는 yarn을 사용하여 패키지를 설치하십시오. 여기에는 Amplitude 세션 리플레이 SDK가 포함되어 있습니다.

npm install @amplitude/session-replay-browser --save

Rudderstack을 사용하여 세션 리플레이 초기화

sessionReplayOptions에 대한 자세한 내용은 세션 리플레이 독립형 SDK 구성 섹션을 참조하십시오.

import * as sessionReplay from "@amplitude/session-replay-browser";
amplitude.init(AMPLITUDE_API_KEY, user_id, config).promise.then(() => {
  window.rudderAnalytics.ready(function () {
    const rudderAnonymousId = rudderAnalytics.getAnonymousId();
    sessionReplay.init(AMPLITUDE_API_KEY, {
      deviceId: rudderAnonymousId,
      sessionId: rudderAnalytics.getSessionId(),
      sampleRate: 0.1, // 10% of sessions will be captured
    }).promise;
    sessionReplay.set(rudderAnalytics.getSessionId());
  });
});

Amplitude가 리플레이를 Rudderstack 이벤트에 연결하는 방법

Amplitude는 세션 리플레이가 세션을 캡처할 때 자동으로 [Amplitude] Replay Captured 이벤트를 생성합니다. Amplitude는 이 이벤트를 직접 전송하여 재생을 분석 데이터와 연결합니다. Amplitude에서 이 이벤트를 볼 수 없다면 Amplitude 서포트에 문의하십시오.

필수 필드 매핑

Amplitude는 Rudderstack Anonymous ID를 Amplitude 장치 ID에 매핑하고, Rudderstack 세션 ID를 Amplitude 세션 ID에 매핑합니다. 장치 ID에 다른 필드를 사용하는 경우 Amplitude 서포트에 문의하십시오.

세션 리플레이 ID의 형식은 <deviceId>/<sessionId>입니다. 세션 리플레이는 /를 구분 기호로 사용하므로, deviceId 값에는 /를 포함할 수 없습니다. 허용되는 문자: a-z A-Z 0-9 _ - . | @ : =. Rudderstack의 익명 ID는 UUID이며, 이는 항상 이러한 요구 사항을 준수합니다. deviceId에 대해 사용자 정의 값을 사용하는 경우 허용되는 문자 집합을 따르는지 확인하십시오. 추가 캐릭터가 필요하면 Amplitude 지원팀에 문의하십시오.

문제 해결

문제 해결 정보는 세션 리플레이 독립형 SDK | 문제 해결을 참조하십시오.