WebView 데이터 모니터링¶
App 측 설정¶
먼저 SDK 초기화 및 RUM 설정을 완료한 다음, 아래 WebView 수집 스위치와 host 설정을 확인합니다.
RUM 설정의 FTRUMConfig.enableTraceWebView를 통해 WebView RUM 수집을 제어하며, 기본값은 true입니다. WebView 로그는 FTLogConfig.enableWebViewLog에서 별도로 제어됩니다.
WebView host 설정¶
SDK 0.4.3부터 지원됩니다.
SDK 초기화 시 FTMobileConfig.allowWebViewHost를 통해 WebView host 허용 목록을 설정하며, WebView RUM과 로그에 동시에 적용됩니다. 이전 버전의 RUM 설정 진입점은 호환성을 위해 유지되며, 다음과 같은 방식으로 마이그레이션할 것을 권장합니다:
const config: FTMobileConfig = {
datakitUrl: 'http://10.0.0.1:9529',
+ allowWebViewHost: ['example.com'],
};
await FTMobileReactNative.sdkConfig(config);
const rumConfig: FTRUMConfig = {
androidAppId: Config.ANDROID_APP_ID,
iOSAppId: Config.IOS_APP_ID,
- allowWebViewHost: ['example.com'],
};
await FTReactNativeRUM.setConfig(rumConfig);
null은 모든 host를 허용하고 []는 모든 host를 금지합니다. FTMobileConfig.allowWebViewHost를 설정하지 않은 경우 FTRUMConfig.allowWebViewHost를 따릅니다. 두 곳 모두 설정하지 않으면 모든 host를 허용합니다. 기본 설정을 명시적으로 지정한 경우(null 또는 [] 포함)에는 기본 설정이 우선 적용됩니다.
원격 설정을 활성화한 후에는 rumAllowWebViewHost가 로컬 설정보다 우선 적용되며, 필드 이름은 그대로 유지됩니다. 자세한 내용은 원격 설정 필드를 참고하세요.
Web 페이지 초기화¶
위의 App 측 설정을 완료한 후 페이지 초기화를 계속 진행하고, 그다음 WebView 데이터 검증에 따라 데이터 보고 상태를 확인합니다.
세션 리플레이가 필요한 경우 App 측 설정은 React Native 세션 리플레이를, 페이지 측은 Web 세션 리플레이를 참고하세요.
WebView 로그¶
SDK 0.4.3부터 지원됩니다.
FTLogConfig.enableWebViewLog를 통해 WebView 페이지에서 Browser Logs SDK가 생성하는 로그를 수신할 수 있으며, 기본값은 비활성화입니다. 페이지 측에서는 여전히 Browser Logs SDK를 통합하고 초기화해야 하며, Native 설정만 활성화해도 웹페이지에 로그 SDK가 자동으로 설치되지는 않습니다.
const logConfig: FTLogConfig = {
enableWebViewLog: true,
logSamplingRate: 100,
enableLinkRumData: true,
};
await FTReactNativeLog.logConfig(logConfig);
enableWebViewLog는 Native 사용자 정의 로그를 제어하는 enableCustomLog 및 WebView RUM을 제어하는 enableTraceWebView와 독립적이며, WebView host 허용 목록의 제한을 받습니다.
원격 설정을 활성화한 후에는 logEnableWebViewLog를 통해 로컬 스위치를 재정의할 수 있습니다. 원격 설정 재정의 규칙의 override.logEnableWebViewLog도 true 또는 false로 설정할 수 있으며, 생략하면 서버 측 값을 유지합니다. 자세한 내용은 원격 설정 필드를 참고하세요.
Native RUM을 연결해야 하는 경우 먼저 RUM을 초기화하고 유효한 View를 생성해야 하며, 로그 샘플링과 레벨 필터링은 계속 Log 설정에서 제어합니다. Android 측에서는 ft-plugin의 WebView 연동 설정을 완료해야 합니다.
Native와 WebView 간 방문자 식별자 공유 설정은 방문자 식별자 Visitor ID를 참고하세요.