コンテンツにスキップ

WebView データモニタリング

アプリ側設定

まず 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 ページの初期化

上記のアプリ側設定を完了したら、ページ初期化 に進み、WebView データ検証 に従って送信を確認します。

セッションリプレイが必要な場合、アプリ側の設定は React Native セッションリプレイ を、ページ側は Web セッションリプレイ を参照してください。

WebView ログ

SDK 0.4.3 以降でサポートされます。

FTLogConfig.enableWebViewLog を有効にすると、WebView ページ内で Browser Logs SDK が生成するログを受信できます。デフォルトは無効です。ページ側では引き続き Browser Logs SDK を統合して初期化する必要があります。Native 設定を有効にするだけでは、Web ページにログ 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 を参照してください。

フィードバック

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