세그먼트용 세션 리플레이 플러그인

Amplitude는 세그먼트와 Amplitude의 세션 리플레이 사이의 단일 라인 연동을 가능하게 하는 플러그인을 제공합니다.

플러그인 설치

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

npm install @amplitude/segment-session-replay-plugin --save

사용

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

import { AnalyticsBrowser } from "@segment/analytics-next";
import { createSegmentActionsPlugin } from "@amplitude/segment-session-replay-plugin";
export const segmentAnalytics = AnalyticsBrowser.load({
  writeKey: SEGMENT_API_KEY,
});
const segmentActionsPlugin = createSegmentActionsPlugin({
  segmentInstance: segmentAnalytics,
  amplitudeApiKey: AMPLITUDE_API_KEY,
  sessionReplayOptions: {
    logLevel: 4,
    sampleRate: 1,
    debugMode: true,
  },
});
segmentAnalytics.register(segmentActionsPlugin);

세그먼트 플러그인 아키텍처

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

사용자 ID와 장치 ID 간의 매핑

세그먼트의 문서에 따라 플러그인은 세그먼트 사용자 ID를 Amplitude 장치 ID에 매핑합니다. 리플레이 캡처에 사용할 장치 ID를 찾기 위해 플러그인은 userId가 설정되어 있는지 확인하며, 설정되어 있지 않은 경우 플러그인은 anonymousId를 사용합니다.

세션 리플레이 ID는 <deviceId>/<sessionId> 형식을 사용합니다. 세션 리플레이는 /를 구분 기호로 사용하므로 장치 ID 값에는 /를 포함할 수 없습니다. 허용되는 문자: a-z A-Z 0-9 _ - . | @ : =. Segment의 userId 및 anonymousId 값은 UUID이며, 이는 항상 이러한 요구 사항을 준수합니다. 추가 캐릭터가 필요하면 Amplitude 지원팀에 문의하십시오.

문제 해결

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