コンテンツにスキップ

WebView データモニタリング

WebView RUM データモニタリング

先に SDK の初期化 と RUM 設定 を完了してから、以下の WebView 収集スイッチと host 設定を確認してください。

ネイティブ RUM は FTRumConfig.enableTraceWebView で制御され、デフォルトは YES です。アプリでは引き続き RUM を初期化する必要があります。SDK 1.6.8 以降、WebView ログと RUM は個別に制御され、FTSDKConfig.allowWebViewHost を共有します。

host ホワイトリスト

SDK 1.6.8+ 対応

基本 SDK の初期化前にホワイトリストを設定します。エントリには host を入力し、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 host を制限せず、すべて許可
空の配列 @[] / [] どの host も許可しない
空でない配列 一致した host とサブドメインのみ許可

このホワイトリストは、自動 WebView Bridge の RUM、Log、ネイティブ Visitor ID へのアクセスを制御します。各機能は引き続き個別に有効化する必要があります。これは Web SDK 自体の初期化、ログ、またはリクエスト収集の設定を代替するものではありません。

有効な設定の優先順位は、リモートの rumAllowWebViewHost > 明示的に設定した FTSDKConfig.allowWebViewHost(明示的な nil と空配列を含む)> 旧 FTRumConfig.allowWebViewHost > デフォルトの無制限です。

SDK 1.6.8 以降、旧 RUM host 設定は非推奨ですが、互換性のためのフォールバックは維持されます。新規導入では FTSDKConfig で統一的に設定してください。リモートフィールドは引き続き rum プレフィックスを持ちますが、1.6.8 では共有ブリッジに適用されます。複数の設定入口で異なる範囲を同時に設定しないでください。

Web ページの初期化

上記の App 側の設定を完了したら、ページの初期化 に進み、WebView データの検証 に従ってレポートを確認してください。

WebView ページを録画する場合は、iOS WebView セッションリプレイ を参照してください。

WebView ログ

SDK 1.6.8+ 対応

Web ページでは、ネイティブブリッジをサポートする ブラウザログ SDK も統合する必要があります。Web RUM のみを統合しても、Browser Logger のログは自動生成されません。

ネイティブ設定

FTLoggerConfig *loggerConfig = [[FTLoggerConfig alloc] init];
loggerConfig.enableWebViewLog = YES;
loggerConfig.logSamplingRate = 100;
loggerConfig.enableLinkRumData = YES; // 必要に応じてネイティブ RUM を関連付ける
[[FTSDKAgent sharedInstance] startLoggerWithConfigOptions:loggerConfig];
let loggerConfig = FTLoggerConfig()
loggerConfig.enableWebViewLog = true
loggerConfig.logSamplingRate = 100
loggerConfig.enableLinkRumData = true
FTSDKAgent.sharedInstance().startLogger(withConfigOptions: loggerConfig)

enableWebViewLog のデフォルトは NO で、ネイティブのカスタムログを制御する enableCustomLog とは独立しており、RUM の enableTraceWebView とも独立しています。Log のサンプリング、レベルフィルタリング、RUM 関連付けの設定は、引き続き必要に応じて行う必要があります。ネイティブ 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 エラーの収集はそのエラー収集設定に依存します。ネイティブ SDK が WebView コンソールを読み取って Web ログ SDK の代わりに動作することはありません。

リモート設定では logEnableWebViewLog を使用してネイティブの受信を動的に制御できます。詳細は リモート設定フィールド を参照してください。ネイティブの受信を無効にすること、または host を禁止することは、Web SDK 自体の動作を無効にすることではありません。ページの独立したレポート戦略は、引き続き Web SDK の設定によって決まります。

ネイティブ Visitor ID の共有

訪問者識別子 Visitor ID に従って有効な FTRumConfig.visitorIDConfig を設定すると、この機能をサポートする Web SDK はネイティブブリッジ経由で現在の識別子を読み取れます。「Visitor ID を共有」スイッチを別途追加する必要はありません。

  • 現在のページでブリッジを確立できる必要があります。アクセスは上記の共有 host ホワイトリストによって制御されます。
  • ネイティブの識別子はメインフレームにのみ提供されます。拒否された場合、または有効化されていない場合、ネイティブ Visitor ID は返されません。
  • TTL の有効期限が切れた場合、または FTSDKAgent.resetVisitorID の呼び出し後は、以降の読み取りで新しい現在の識別子が使用されます。Web 側で古い値を永続的にキャッシュしないでください。
  • Visitor ID の URL ルールは URLSession リクエストヘッダーの注入を制御し、ID の読み取りを許可する WebView host の範囲とは別に設定されます。

フィードバック

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