WebView 모니터링¶

WebView 데이터 모니터링¶

WebView 데이터 모니터링을 사용하려면 WebView 액세스 페이지에 웹 모니터링 SDK를 통합해야 합니다.

데스크톱 브라우저의 웹 애플리케이션 수집도 동시에 지원해야 하는 경우 데스크톱 애플리케이션 권장 구성으로 연동할 것을 권장합니다.

수집 범위가 App 내 WebView로 제한되고 데스크톱 브라우저의 웹 애플리케이션을 지원할 필요가 없는 경우, Web SDK 기본 연동 구성을 완료한 후 임의의 applicationId를 사용하여 초기화할 수 있습니다.

정상적으로 초기화되면 App 내 WebView의 수집 데이터는 기본적으로 App 측에서 통합 관리합니다.

WebView 수집을 비활성화하거나 host 기준으로 수집 범위를 필터링해야 하는 경우 다음 구성 설명을 참조하세요.

FTRUMConfig.setAllowWebViewHost는 더 이상 사용되지 않습니다. 업그레이드 후에는 FTSDKConfig.setAllowWebViewHost를 사용하여 WebView RUM과 Log의 host 범위를 통합 제어하세요.

ft-sdk >= 1.7.5에서는 FTWebViewJavascriptBridge를 통해 WebView 내 Browser SDK에서 생성된 로그를 수신하고, Android SDK에서 로그 레벨 필터링, 샘플링, 캐싱 및 업로드를 처리하도록 지원합니다.

이 기능을 활성화하려면 먼저 WebView 페이지에 웹 모니터링 SDK를 통합하고 Android Log를 초기화해야 합니다.

JavaKotlin

FTSdk.initLogWithConfig(new FTLoggerConfig()
    .setEnableWebViewLog(true)
    .setEnableLinkRumData(true));

FTSdk.initLogWithConfig(
    FTLoggerConfig()
        .setEnableWebViewLog(true)
        .setEnableLinkRumData(true)
)

setEnableWebViewLog(true)는 Browser SDK Log 수집만 활성화하며, 네이티브 로그의 setEnableCustomLog 또는 setEnableConsoleLog에 의존하지 않습니다.
setEnableLinkRumData(true)를 활성화하면 WebView Log가 Android RUM의 Application, Session 등 컨텍스트와 연결됩니다. 비활성화하면 RUM 관련 필드가 제거됩니다.
FTSDKConfig.setAllowWebViewHost는 WebView RUM 및 Log의 host 범위를 통합 제한하는 데 사용됩니다. null은 모든 host를 허용함을 의미하며, 빈 배열은 Bridge를 자동으로 사용하지 않음을 의미합니다. 구성된 host는 해당 하위 도메인도 함께 일치합니다. 이 구성은 Bridge 선택을 위한 것이며 페이지 출처 보안 검증 메커니즘으로 사용해서는 안 됩니다.
WebView Log는 FTLoggerConfig.setSamplingRate, setLogLevelFilters 및 로그 캐싱 정책의 적용을 받으며, 원격 구성을 통해 동적으로 활성화 또는 비활성화할 수 있습니다.