콘텐츠로 이동

React Native 세션 리플레이

사전 요구 사항

  • @cloudcare/react-native-mobile RUM 구성 설정 및 초기화를 완료하고 View 모니터링 수집을 활성화했는지 확인합니다.
  • React Native 세션 리플레이에는 @cloudcare/react-native-mobile@0.4.0 이상 버전이 필요합니다.
  • @cloudcare/react-native-mobile@0.4.1부터 세션 리플레이 기능은 @cloudcare/react-native-session-replay에서 제공됩니다. @cloudcare/react-native-mobile과 @cloudcare/react-native-session-replay를 함께 설치하고 두 라이브러리의 버전 번호를 동일하게 유지하세요.

  • 문서 상단 배지에 표시된 공식 안정 버전을 우선 사용하는 것이 좋으며, alpha, beta 등 사전 릴리스 버전은 사용하지 않는 것이 좋습니다.

  • 새로운 기능을 먼저 경험하고 최신 기능을 확인하거나 아직 공식 릴리스되지 않은 변경 사항을 따라가려면 GitHub에서 React Native SDK 저장소 및 관련 변경 로그를 팔로우할 수 있습니다: GuanceCloud/datakit-react-native.

구성

npm install @cloudcare/react-native-mobile@last_version @cloudcare/react-native-session-replay@last_version
# 또는
yarn add @cloudcare/react-native-mobile@last_version @cloudcare/react-native-session-replay@last_version

코드 호출

다음 예제는 0.4.1 이상 버전에 적용됩니다. 세션 리플레이 관련 API는 @cloudcare/react-native-session-replay에서 가져옵니다.

import {
  FTReactNativeSessionReplay,
  FTSessionReplayConfig,
  TextAndInputPrivacyLevel,
} from '@cloudcare/react-native-session-replay';
 let sessionReplayConfig: FTSessionReplayConfig = {
-  sampleRate: 1,
+  sessionReplaySamplingRate: 100, // SDK 0.4.3부터 지원
   textAndInputPrivacy: TextAndInputPrivacyLevel.MASK_SENSITIVE_INPUTS,
 };
 await FTReactNativeSessionReplay.sessionReplayConfig(sessionReplayConfig);
속성 타입 필수 설명
sessionReplaySamplingRate number 아니요 세션 리플레이 샘플링 비율로, 범위는 [0,100]이며 소수를 지원하고 기본값은 100입니다. RUM 샘플링을 기반으로 한 샘플링 비율이며 sampleRate보다 우선합니다. SDK 0.4.3부터 지원됩니다.
sessionReplayOnErrorSamplingRate number 아니요 일반 리플레이 샘플링에서 선택되지 않은 경우의 오류 리플레이 샘플링 비율로, 범위는 [0,100]이며 소수를 지원하고 기본값은 0이며 sessionReplayOnErrorSampleRate보다 우선합니다. SDK 0.4.3부터 지원됩니다.
sampleRate number 아니요 SDK 0.4.3부터 폐기되었으며 호환성을 위해 유지됩니다. sessionReplaySamplingRate 사용을 권장합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. 이 샘플링 비율은 RUM 샘플링을 기반으로 한 샘플링 비율입니다.
sessionReplayOnErrorSampleRate number 아니요 SDK 0.4.3부터 폐기되었으며 호환성을 위해 유지됩니다. sessionReplayOnErrorSamplingRate 사용을 권장합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다.
privacy SessionReplayPrivacy 아니요 세션 리플레이에서 콘텐츠 마스킹의 개인정보 보호 수준을 설정합니다. 이 매개변수는 폐기되었으며 이전 버전과의 호환성을 위해 유지됩니다. 세밀한 개인정보 보호 설정에는 touchPrivacy, textAndInputPrivacy, imagePrivacy를 우선 사용하는 것이 좋습니다.
SessionReplayPrivacy.ALLOW: 비밀번호 입력란과 같은 민감한 입력 컨트롤 외에는 개인정보 데이터를 마스킹하지 않습니다.
SessionReplayPrivacy.MASK_USER_INPUT: 입력란의 텍스트, Switch 등을 포함하여 사용자 입력의 일부 데이터를 마스킹합니다.
SessionReplayPrivacy.MASK: 텍스트, Switch 등을 포함한 개인정보 데이터를 마스킹합니다. 곧 폐기될 예정이며 호환성을 위해 사용할 수 있습니다. 개인정보 보호 설정에는 touchPrivacy, textAndInputPrivacy, imagePrivacy를 우선 사용하는 것이 좋습니다.
touchPrivacy TouchPrivacyLevel 아니요 세션 리플레이에서 터치 동작의 개인정보 보호 수준을 설정합니다.
TouchPrivacyLevel.SHOW: 터치 동작을 표시합니다.
TouchPrivacyLevel.HIDE: 터치 동작을 숨깁니다. 설정 시 privacy 설정을 재정의합니다. SDK 0.4.1 이상에서 지원됩니다.
textAndInputPrivacy TextAndInputPrivacyLevel 아니요 세션 리플레이에서 텍스트 및 입력 내용의 개인정보 보호 수준을 설정합니다.
TextAndInputPrivacyLevel.MASK_SENSITIVE_INPUTS: 민감한 입력만 마스킹합니다.
TextAndInputPrivacyLevel.MASK_ALL_INPUTS: 모든 입력 내용을 마스킹합니다.
TextAndInputPrivacyLevel.MASK_ALL: 모든 텍스트 및 입력 내용을 마스킹합니다. 설정 시 privacy 설정을 재정의합니다. SDK 0.4.1 이상에서 지원됩니다.
imagePrivacy ImagePrivacyLevel 아니요 세션 리플레이에서 이미지 콘텐츠의 개인정보 보호 수준을 설정합니다.
ImagePrivacyLevel.MASK_NON_BUNDLED_ONLY: 번들에 포함되지 않은 이미지만 마스킹합니다.
ImagePrivacyLevel.MASK_ALL: 모든 이미지를 마스킹합니다.
ImagePrivacyLevel.MASK_NONE: 이미지를 마스킹하지 않습니다. 설정 시 privacy 설정을 재정의합니다. SDK 0.4.1 이상에서 지원됩니다.

뷰 개인정보 보호 재정의

SDK 0.4.1 이상에서 지원됩니다.

FTSessionReplayView는 특정 뷰 트리에 세션 리플레이 개인정보 보호 재정의를 설정하는 데 사용됩니다. 이 컴포넌트는 React Native View와 동일하게 동작하며, 개별 개인정보 보호 정책을 설정해야 하는 컴포넌트를 감싸는 데 사용할 수 있고 기존 View를 직접 대체할 수도 있습니다. 개인정보 보호 재정의는 하위 뷰에 적용되며, 여러 계층의 재정의가 있는 경우 하위 뷰는 가장 가까운 상위 수준의 개인정보 보호 구성을 사용합니다.

import {
  FTSessionReplayView,
  ImagePrivacyLevel,
  TextAndInputPrivacyLevel,
  TouchPrivacyLevel,
} from '@cloudcare/react-native-session-replay';
컴포넌트 역할 속성
FTSessionReplayView.Privacy 하위 뷰의 텍스트, 입력, 이미지, 터치 개인정보 보호 수준을 사용자 지정하며, 하위 뷰 전체를 숨길 수도 있습니다. textAndInputPrivacy?: TextAndInputPrivacyLevel
imagePrivacy?: ImagePrivacyLevel
touchPrivacy?: TouchPrivacyLevel
hide?: boolean
FTSessionReplayView.MaskAll 하위 뷰에 가장 엄격한 마스킹 정책을 적용하여 텍스트, 입력 및 이미지를 마스킹합니다. showTouch?: boolean, true로 설정하면 터치 동작을 표시합니다.
FTSessionReplayView.MaskNone 하위 뷰에 완화된 마스킹 정책을 적용하며, 민감하지 않은 콘텐츠와 이미지는 최대한 원래대로 표시됩니다. 추가 속성이 없습니다.
FTSessionReplayView.Hide 세션 리플레이에서 하위 뷰 콘텐츠를 완전히 숨깁니다. 추가 속성이 없습니다.

개별 컴포넌트 감싸기

import { TextInput, View } from 'react-native';
import { FTSessionReplayView } from '@cloudcare/react-native-session-replay';
export function UserForm() {
  return (
    <View>
      <FTSessionReplayView.MaskAll showTouch={true}>
        <TextInput placeholder="First Name" value="Data" />
        <TextInput placeholder="Last Name" value="Flux" />
      </FTSessionReplayView.MaskAll>
    </View>
  );
}

기존 View 대체

FTSessionReplayView는 React Native View의 속성을 상속하므로 기존 View의 style을 그대로 전달할 수 있습니다.

import { StyleSheet, Text, TextInput } from 'react-native';
import { FTSessionReplayView } from '@cloudcare/react-native-session-replay';
export function ProfileCard() {
  return (
    <FTSessionReplayView.MaskNone style={styles.card}>
      <Text>Public display name</Text>
      <TextInput placeholder="Email" value="user@example.com" />
    </FTSessionReplayView.MaskNone>
  );
}

const styles = StyleSheet.create({
  card: {
    padding: 12,
    borderRadius: 8,
    backgroundColor: '#FFFFFF',
  },
});

서로 다른 개인정보 보호 정책 조합

import {
  FTSessionReplayView,
  ImagePrivacyLevel,
  TextAndInputPrivacyLevel,
  TouchPrivacyLevel,
} from '@cloudcare/react-native-session-replay';
export function Checkout() {
  return (
    <FTSessionReplayView.Privacy
      textAndInputPrivacy={TextAndInputPrivacyLevel.MASK_SENSITIVE_INPUTS}
      imagePrivacy={ImagePrivacyLevel.MASK_NONE}
      touchPrivacy={TouchPrivacyLevel.SHOW}>
      {/* 일반 콘텐츠 */}
      <FTSessionReplayView.MaskAll showTouch={true}>
        {/* 강한 마스킹이 필요한 폼 콘텐츠 */}
      </FTSessionReplayView.MaskAll>
      <FTSessionReplayView.Hide>
        {/* 리플레이에서 표시하지 않으려는 콘텐츠 */}
      </FTSessionReplayView.Hide>
    </FTSessionReplayView.Privacy>
  );
}

FTSessionReplayView.Hide를 사용하면 하위 뷰가 세션 리플레이에서 숨겨집니다.

WebView 세션 리플레이

SDK 0.4.1부터 지원되며 Android 및 iOS에 적용됩니다.

React Native WebView로 웹 페이지를 로드할 때는 먼저 React Native RUM 및 이 페이지의 세션 리플레이 구성을 완료하고 View 모니터링 수집을 활성화해야 합니다. Android의 경우 Plugin 가져오기에 따라 ft-plugin 구성을 완료하고, 앱 메인 모듈에 해당 플러그인을 적용한 뒤 앱을 다시 빌드하고 설치해야 합니다.

WebView 데이터 모니터링에 따라 앱 측 구성을 완료하고, FTRUMConfig.enableTraceWebView가 true(기본값)인지, WebView host 구성이 대상 페이지 수집을 허용하는지 확인합니다. 앱 측 초기화가 완료된 후 WebView를 로드하고, WebView 페이지 초기화에 따라 페이지를 연동합니다.

WebView에서 로드한 페이지에서는 Web SDK RUM 초기화를 완료한 후 녹화를 시작합니다:

window.DATAFLUX_RUM.startSessionReplayRecording();

WebView의 경우 Web 측 SDK의 개인정보 보호 구성을 사용해 페이지 내 콘텐츠를 관리하는 것이 좋습니다. React Native 측의 뷰 개인정보 보호 재정의는 주로 네이티브 뷰 트리에 적용됩니다.

코드 및 구성 참조

문서 평가

이 페이지가 도움이 되었나요?