コンテンツにスキップ

WebView ページの導入

App の設定 → Web ページの初期化 → データの検証 の順に進めて導入を完了します。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 ページの初期化

ページのユースケースに応じて、いずれか 1 つの設定を選択します。ページに Web SDK がすでに導入されている場合は、既存の読み込み方式を再利用し、初期化は 1 回だけにします。

ページのユースケース 初期化方法
ブラウザで単独に収集する必要がある場合、またはブラウザと App WebView の両方で実行する場合 通常の統合(推奨)
App 内でのみ使用し、すべてのデータを App SDK に委ねる場合 App 内埋め込みページのみ

通常の統合(推奨)

既存の Web SDK 初期化設定があるページは、現在の設定を引き続き使用できます。初めて導入する場合は、Web の手動導入 に従ってレポート設定を準備し、NPM または CDN を選択して SDK を読み込みます。

ページがブラウザで実行される場合は、Web SDK の設定に従って個別にレポートします。App WebView 内で実行され、Bridge が有効な場合は、RUM データは FTWebViewJavascriptBridge を介して App SDK に引き継がれます。初期化が完了したら、データの検証 に進みます。

App 内埋め込みページのみ(特殊なケース)

この方式では、ページの初期化前にホスト側で Bridge を有効化し、現在のページで使用できるようにしておく必要があります。Bridge モードでは applicationId が自動的に設定されるため、Web アプリを別途作成する必要はありません。

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 側の設定 を参照してください。

ページが通常のブラウザでも単独で実行される場合は、ブラウザのシナリオについて Web の導入検証 を確認してください。

オプション:セッションリプレイ

RUM データの検証に合格したら、ホストプラットフォームに応じてセッションリプレイの設定を確認します:

ホストプラットフォーム 設定の入口
Android WebView Session Replay
iOS WebView Session Replay
Flutter セッションリプレイの初期化
React Native セッションリプレイの初期化
UniApp セッションリプレイの初期化

Android と iOS の WebView 専用セクションには、ページ録画を有効にする方法が記載されています。クロスプラットフォームフレームワークでセッションリプレイの初期化を完了した後、ページ録画の方法については Web セッションリプレイ を参照してください。サポート範囲とパラメーターの説明は各プラットフォームのドキュメントに準拠します。

フィードバック

このページは役に立ちましたか?