세션 리플레이 React Native Segment 연동

이 문서에서는 세션 리플레이 React Native Segment 플러그인을 사용하여 세션 리플레이를 설치하는 방법을 설명합니다. React Native 앱이 이미 Segment의 분석 React Native 라이브러리와 Amplitude(액션) 목적지를 사용하고 있는 경우, 이 옵션을 사용하세요.

Amplitude React Native SDK를 사용하여 앱을 구현하는 경우, 세션 리플레이 React Native SDK 플러그인을 사용하세요.

세그먼트를 다른 옵션과 함께 사용하는 경우 독립형 구현을 사용하십시오.

시작하기 전에

위의 0.0.1-beta.2 최신 버전의 세션 리플레이 React Native Segment 플러그인을 사용하십시오.

세션 리플레이 React Native Segment 플러그인은 다음을 요구합니다:

1. 여러분은 React Native를 사용하여 애플리케이션을 구축합니다.
2. 수집을 위해 Segment의 분석 React Native 라이브러리를 사용합니다.
3. Segment의 Amplitude (Actions) 목적지를 사용합니다.
4. 세그먼트의 Amplitude Session Plugin을 사용하여 세션 ID를 추출합니다.

빠른 시작

플러그인 및 해당 종속성을 설치합니다.

npm install @amplitude/segment-session-replay-plugin-react-native
npm install @amplitude/session-replay-react-native @segment/analytics-react-native

애플리케이션 코드를 구성합니다.

import { createSegmentSessionReplayPlugin } from '@amplitude/segment-session-replay-plugin-react-native';
import { createClient } from '@segment/analytics-react-native';
import { AmplitudeSessionPlugin } from '@segment/analytics-react-native-plugin-amplitude-session';
// Initialize Segment client
const segmentClient = createClient({
  writeKey: 'YOUR_SEGMENT_WRITE_KEY',
});
// Configure session replay plugin
const sessionReplayConfig = {
  apiKey: 'YOUR_AMPLITUDE_API_KEY',
  deviceId: 'YOUR_DEVICE_ID'
};
// Add the Amplitude session plugin first (required for session ID extraction)
await segmentClient.add({ plugin: new AmplitudeSessionPlugin() });
// Add the session replay plugin to Segment
await segmentClient.add({ plugin: createSegmentSessionReplayPlugin(sessionReplayConfig) });

구성

플러그인은 다음 옵션이 있는 SessionReplayConfig 객체를 허용합니다.

작동 방식

Segment 세션 리플레이 플러그인은 자동으로 다음과 같은 작업을 수행합니다.

1. 세션 리플레이 초기화: 플러그인을 Segment에 추가할 때 설정으로 Amplitude 세션 리플레이를 설정합니다.
2. 세션 데이터 동기화: 이벤트 속성 또는 Amplitude 연동 데이터에서 추출하여 각 Segment 이벤트의 세션 ID 및 장치 ID를 업데이트합니다.
3. 이벤트 강화: 세션 리플레이 속성을 track 및 screen 이벤트에 추가하여 Segment로 전송합니다.
4. 생애주기 분석 관리: 플러그인 생애주기 분석에 따라 세션 리플레이의 시작 및 중지 작업을 처리합니다.

이벤트 처리

플러그인은 다음과 같은 세그먼트 이벤트 유형을 처리합니다.

• TrackEvent: track 이벤트에 세션 리플레이 속성을 추가합니다.
• ScreenEvent: 세션 리플레이 속성을 화면 이벤트에 추가합니다.

이러한 이벤트에 대해 플러그인은 다음을 수행합니다.

• 이벤트 속성 또는 Amplitude 연동 데이터에서 세션 ID를 추출합니다.
• 이벤트 컨텍스트 또는 익명 ID에서 장치 ID를 추출합니다.
• 이벤트를 세그먼트로 전송하기 전에 이벤트에 세션 리플레이 속성을 추가합니다.

세션 ID 추출

플러그인은 다음 우선 순위 순서로 세션 ID를 추출합니다.

1. Amplitude 연동 데이터에서: event.integrations['Actions Amplitude'].session_id.
2. 이벤트 속성에서: event.properties.session_id.
3. Amplitude가 세션 ID를 찾지 못할 경우 -1 기본값으로 지정됩니다.

장치 ID 추출

플러그인은 다음 우선 순위 순서로 장치 ID를 추출합니다.

1. 이벤트 컨텍스트에서: event.context.device.id.
2. 익명 ID: event.anonymousId.
3. Amplitude가 기기 ID를 찾지 못할 경우 null이(가) 기본값으로 사용됩니다.

고급옵션 항목

이 섹션에서는 보다 고급옵션 사용 사례에 대한 예시를 제공합니다.

수동 제어

초기화 후 세션 리플레이 플러그인을 수동으로 제어합니다.

import { createSegmentSessionReplayPlugin } from '@amplitude/segment-session-replay-plugin-react-native';
// Create the plugin
const sessionReplayPlugin = createSegmentSessionReplayPlugin(sessionReplayConfig);
// Add to Segment
await segmentClient.add(sessionReplayPlugin);
// Later, manually control recording
await sessionReplayPlugin.start();
await sessionReplayPlugin.stop();

사용자 지정 구성

더 고급옵션 구성을 위해 추가 세션 리플레이 옵션을 전달하십시오.

const sessionReplayConfig = {
  apiKey: 'YOUR_AMPLITUDE_API_KEY',
  sampleRate: 0.1, // Sample 10% of sessions
  enableRemoteConfig: true,
  logLevel: 4, // Debug level
  autoStart: false, // Don't start automatically
};
const sessionReplayPlugin = createSegmentSessionReplayPlugin(sessionReplayConfig);

문제 해결

세션 리플레이 속성이 추가되지 않았습니다.

플러그인이 이벤트에 세션 리플레이 속성을 추가하지 않는 경우:

1. Amplitude Session 플러그인이 세션 리플레이 플러그인 앞에 나타나는지 확인하십시오.
2. 세그먼트 이벤트 유형이 track 또는 screen인지 확인하십시오.
3. 세션 리플레이 플러그인이 초기화되는지 확인하십시오.

세션 ID를 찾을 수 없습니다.

플러그인이 세션 ID를 추출할 수 없는 경우:

1. Amplitude Session Plugin을 올바르게 구성했는지 확인하십시오.
2. Segment Amplitude 목적지를 올바르게 구성했는지 확인하십시오.
3. 이벤트에 필요한 Amplitude 연동 데이터가 포함되어 있는지 확인합니다.

장치 ID 문제

장치 ID 추출이 실패한 경우:

1. Segment 이벤트에 컨텍스트의 장치 정보가 포함되어 있는지 확인하십시오.
2. 세그먼트에 익명 ID가 설정되어 있는지 확인합니다.
3. 플러그인 구성에서 장치 ID를 수동으로 설정하는 것을 고려하십시오.

추가 문제 해결을 위해서는 세션 리플레이 React Native SDK 플러그인 문제 해결 가이드를 참조하세요.