콘텐츠로 이동

WebView 페이지 연동

App 구성 → 웹 페이지 초기화 → 데이터 검증 순서로 연동을 완료합니다. App 측 구성을 이미 완료한 프로젝트는 페이지 초기화부터 바로 시작할 수 있습니다.

1. App 구성

먼저 호스트 플랫폼에 따라 SDK, RUM 및 WebView Bridge 구성을 완료하고 대상 페이지의 host가 Bridge를 사용할 수 있도록 허용합니다:

호스트 플랫폼 App 측 구성
Android WebView 모니터링
iOS WebView 데이터 모니터링
Flutter WebView 데이터 모니터링
React Native WebView 데이터 모니터링
HarmonyOS WebView 데이터 모니터링
UniApp WebView 데이터 모니터링

완료한 후 아래 페이지 초기화를 계속 진행합니다.

2. 웹 페이지 초기화

페이지 사용 범위에 따라 구성 방법 하나를 선택합니다. 페이지에 이미 Web SDK가 연동되어 있는 경우 기존 로드 방식을 재사용하고 초기화는 한 번만 유지합니다.

페이지 사용 범위 초기화 방식
브라우저에서 독립적으로 수집해야 하거나 브라우저와 App WebView에서 동시에 실행되는 경우 일반 연동(권장)
App 내에서만 사용하며 모든 데이터를 App SDK가 처리하도록 하는 경우 App 내장 페이지 전용

일반 연동(권장)

Web SDK 초기화 구성이 이미 있는 페이지는 기존 구성을 계속 사용할 수 있습니다. 최초 연동 시에는 웹 수동 연동에 따라 보고 구성을 준비한 후 NPM 또는 CDN을 선택해 SDK를 로드합니다.

페이지가 브라우저에서 실행될 때는 Web SDK 구성에 따라 독립적으로 보고합니다. App WebView에서 실행되고 Bridge가 활성화된 경우 RUM 데이터는 FTWebViewJavascriptBridge를 통해 App SDK로 인계됩니다. 초기화를 완료한 후 데이터 검증을 계속 진행합니다.

App 내장 페이지 전용(특수 시나리오)

이 방식은 호스트가 페이지 초기화 전에 Bridge를 활성화하고 현재 페이지에서 사용할 수 있도록 허용해야 합니다. Bridge 모드에서는 applicationId가 자동으로 설정되므로 별도의 웹 애플리케이션을 생성할 필요가 없습니다.

HTTP/HTTPS 페이지 최소 초기화 예시

다음 예시는 SDK 로드와 RUM 초기화를 포함하며, 아직 Web SDK를 연동하지 않은 페이지에서 사용할 수 있습니다.

<script src="https://static.guance.com/browser-sdk/v3/dataflux-rum.js"></script>
<script>
  if (window.DATAFLUX_RUM) {
    window.DATAFLUX_RUM.init({
      // 초기화 검증을 충족하며, RUM 데이터는 네이티브 Bridge를 통해 보고됩니다.
      datakitOrigin: window.location.origin,
    })
  }
</script>

완료한 후 데이터 검증을 계속 진행합니다.

3. 데이터 검증

  1. App에서 연동된 WebView 페이지를 열고 페이지 조회, 클릭 또는 네트워크 요청을 트리거합니다.
  2. 실제 사용자 모니터링(RUM)에서 해당 App 애플리케이션을 선택하고 WebView 페이지의 RUM 데이터가 수신되는지 확인합니다. Bridge 모드에서는 App SDK가 보고하므로 브라우저 Network에 /v1/write/rum 요청이 표시될 필요는 없습니다.

데이터를 수신하지 못한 경우 먼저 Web SDK가 로드되었는지, App RUM이 초기화되었는지, 페이지 초기화 시 Bridge를 사용할 수 있었고 현재 host가 허용되었는지 확인합니다. 플랫폼 구성과 트러블슈팅 방법은 App 측 구성을 참조하세요.

페이지가 일반 브라우저에서도 독립적으로 실행되는 경우 브라우저 시나리오는 웹 연동 검증에 따라 확인합니다.

선택 사항: 세션 리플레이

RUM 데이터 검증을 통과한 후 호스트 플랫폼에 따라 세션 리플레이 구성을 확인합니다.

호스트 플랫폼 구성 진입점
Android WebView 세션 리플레이
iOS WebView 세션 리플레이
Flutter 세션 리플레이 초기화
React Native 세션 리플레이 초기화
UniApp 세션 리플레이 초기화

Android 및 iOS의 WebView 전용 섹션에는 페이지 녹화 활성화 방법이 포함되어 있습니다. 크로스플랫폼 프레임워크에서 세션 리플레이 초기화를 완료한 후 페이지 녹화 방법은 웹 세션 리플레이를 참조하세요. 지원 범위와 파라미터 설명은 각 플랫폼 문서를 기준으로 합니다.

문서 평가

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