React Native 세션 리플레이¶
사전 요구 사항¶
@cloudcare/react-native-mobileRUM 구성 설정 및 초기화를 완료하고 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?: TextAndInputPrivacyLevelimagePrivacy?: ImagePrivacyLeveltouchPrivacy?: TouchPrivacyLevelhide?: 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 초기화를 완료한 후 녹화를 시작합니다:
WebView의 경우 Web 측 SDK의 개인정보 보호 구성을 사용해 페이지 내 콘텐츠를 관리하는 것이 좋습니다. React Native 측의 뷰 개인정보 보호 재정의는 주로 네이티브 뷰 트리에 적용됩니다.