콘텐츠로 이동

WebView 데이터 모니터링

WebView RUM 데이터 모니터링

먼저 SDK 초기화 및 RUM 구성을 완료한 다음, 아래의 WebView 수집 스위치와 호스트 구성을 확인하세요.

Native RUM은 FTRumConfig.enableTraceWebView로 제어되며 기본값은 YES입니다. 애플리케이션은 여전히 RUM을 초기화해야 합니다. SDK 1.6.8부터 WebView 로그와 RUM은 각각 제어되며 FTSDKConfig.allowWebViewHost를 공유합니다.

호스트 허용 목록

SDK 1.6.8+ 지원

기본 SDK 초기화 전에 허용 목록을 설정하며, 항목에는 호스트를 입력하고 scheme, 포트 또는 경로는 포함하지 않습니다. example.com은 해당 도메인 및 하위 도메인을 허용합니다.

FTSDKConfig *config = [[FTSDKConfig alloc] initWithDatakitUrl:datakitUrl];
config.allowWebViewHost = @[@"example.com", @"checkout.example.net"];
[FTSDKAgent startWithConfigOptions:config];
let config = FTSDKConfig(datakitUrl: datakitUrl)
config.allowWebViewHost = ["example.com", "checkout.example.net"]
FTSDKAgent.start(withConfigOptions: config)
설정 의미
nil 호스트를 제한하지 않으며 모두 허용
빈 배열 @[] / [] 어떤 호스트도 허용하지 않음
비어 있지 않은 배열 일치하는 호스트 및 하위 도메인만 허용

이 허용 목록은 자동 WebView Bridge의 RUM, Log 및 Native Visitor ID 액세스를 제어합니다. 기능별로 여전히 각각 활성화해야 하며, Web SDK 자체의 초기화, 로그 또는 요청 수집 구성을 대체하지 않습니다.

유효한 구성 우선순위는 원격 rumAllowWebViewHost > 명시적으로 설정된 FTSDKConfig.allowWebViewHost(명시적 nil 및 빈 배열 포함) > 이전 FTRumConfig.allowWebViewHost > 기본값(제한 없음)입니다.

SDK 1.6.8부터 이전 RUM 호스트 구성은 사용 중단되었지만 호환성 폴백으로 유지됩니다. 신규 연동은 FTSDKConfig에서 일괄 설정하세요. 원격 필드는 여전히 rum 접두사를 포함하지만 1.6.8에서는 공유 Bridge에 적용됩니다. 여러 구성 진입점에서 서로 다른 범위를 동시에 설정하지 마세요.

Web 페이지 초기화

위 App 측 구성을 완료한 후 페이지 초기화를 진행하고, WebView 데이터 검증에 따라 보고를 확인하세요.

WebView 페이지 녹화가 필요한 경우 iOS WebView 세션 리플레이를 참고하세요.

WebView 로그

SDK 1.6.8+ 지원

Web 페이지에는 Native Bridge를 지원하는 브라우저 로그 SDK도 통합해야 하며, Web RUM만 통합해서는 Browser Logger 로그가 자동으로 생성되지 않습니다.

Native 구성

FTLoggerConfig *loggerConfig = [[FTLoggerConfig alloc] init];
loggerConfig.enableWebViewLog = YES;
loggerConfig.logSamplingRate = 100;
loggerConfig.enableLinkRumData = YES; // 필요 시 Native RUM 연결
[[FTSDKAgent sharedInstance] startLoggerWithConfigOptions:loggerConfig];
let loggerConfig = FTLoggerConfig()
loggerConfig.enableWebViewLog = true
loggerConfig.logSamplingRate = 100
loggerConfig.enableLinkRumData = true
FTSDKAgent.sharedInstance().startLogger(withConfigOptions: loggerConfig)

enableWebViewLog의 기본값은 NO이며, Native 사용자 정의 로그를 제어하는 enableCustomLog와 별개이고 RUM의 enableTraceWebView와도 별개입니다. Log의 샘플링, 레벨 필터링 및 RUM 연결 구성은 여전히 필요에 따라 설정해야 합니다. Native RUM과 연결하려면 RUM을 초기화하고 유효한 View를 생성해야 합니다.

Web 구성 및 로그 호출

import { datafluxLogs } from '@cloudcare/browser-logs'


datafluxLogs.init({
  datakitOrigin: 'https://datakit.example.com', // Web 로그 SDK 구성에 따라 입력
  service: 'app-webview',
  env: 'prod',
  sessionSampleRate: 100,
  forwardErrorsToLogs: true,
  forwardConsoleLogs: ['log', 'info', 'warn', 'error'],
})

datafluxLogs.logger.info('checkout opened', { page: 'checkout' })
console.info('checkout ready')

logger.info 등의 호출은 Browser Logger 로그를 직접 생성합니다. Console 수집은 Web 로그 SDK의 forwardConsoleLogs에 의존하며, JS 오류 수집은 해당 오류 수집 구성에 의존합니다. Native SDK는 Web 로그 SDK를 대신하기 위해 WebView 콘솔을 읽지 않습니다.

원격 구성에서는 logEnableWebViewLog를 사용해 Native 수신을 동적으로 제어할 수 있습니다. 자세한 내용은 원격 구성 필드를 참고하세요. Native 수신을 끄거나 호스트를 금지하는 것은 Web SDK 자체의 동작을 끄는 것과 같지 않으며, 페이지의 독립적 보고 정책은 여전히 Web SDK 구성에 따라 결정됩니다.

Native 방문자 식별자(Visitor ID) 공유

방문자 식별자 Visitor ID에 따라 유효한 FTRumConfig.visitorIDConfig를 구성하면, 이 기능을 지원하는 Web SDK가 Native Bridge를 통해 현재 식별자를 읽을 수 있으며 별도의 ‘Visitor ID 공유’ 스위치를 추가할 필요가 없습니다.

  • 현재 페이지에서 Bridge를 설정할 수 있어야 하며, 액세스는 위의 공유 호스트 허용 목록에 의해 제어됩니다.
  • Native 식별자는 메인 프레임에만 제공되며, 거부되었거나 활성화되지 않은 경우에는 Native Visitor ID를 반환하지 않습니다.
  • TTL이 만료되거나 FTSDKAgent.resetVisitorID를 호출한 후에는 이후 읽기에서 새로운 현재 식별자를 사용하며, Web 측에 이전 값을 영구적으로 캐시해서는 안 됩니다.
  • Visitor ID의 URL 규칙은 URLSession 요청 헤더 주입을 제어하며, ID 읽기를 허용하는 WebView 호스트 범위와는 별도로 설정됩니다.

문서 평가

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