コンテンツにスキップ

WebView モニタリング

WebView データモニタリング

WebView データモニタリングでは、WebView でアクセスするページに Web モニタリング SDK を統合する必要があります。

デスクトップブラウザの Web アプリケーションの収集も同時にサポートする場合は、デスクトップアプリケーションの推奨設定に従って接続することをお勧めします。

収集シナリオがアプリ内の WebView に限定され、デスクトップブラウザの Web アプリケーションをサポートする必要がない場合は、Web SDK の基本接続設定を完了した後、任意の applicationId を使用して初期化できます。

ネイティブ側で RUM の初期化を完了し、FTWebViewHandler を介して JavaScript Bridge を確立すると、アプリ内 WebView の収集データはアプリ側で一元的に管理されます。

WebView の収集を無効にする場合、または Host で収集範囲をフィルタリングする場合は、以下の設定説明を参照してください:

FTRUMConfig.setAllowWebViewHost は非推奨です。アップグレード後は FTSDKConfig.setAllowWebViewHost を使用して、WebView RUM と Replay の Host 範囲を一元的に制御してください。

コード呼び出し

アプリケーションのエントリポイントで SDK と RUM を初期化し、WebView データ収集を有効にします:

import { FTSDK, FTSDKConfig, FTRUMConfig } from '@guancecloud/ft_sdk/Index';

const sdkConfig = FTSDKConfig.builder('YOUR_DATAKIT_URL')
  .setAllowWebViewHost(['example.com']);
FTSDK.install(sdkConfig, this.context);

FTSDK.installRUMConfig(new FTRUMConfig()
  .setRumAppId('your-rum-app-id')
  .setEnableTraceWebView(true));

ページライフサイクルでのバインディング

import { FTWebViewHandler } from '@guancecloud/ft_sdk/Index';
import { webview } from '@kit.ArkWeb';

@Component
export struct MyWebViewPage {
  @State webController: webview.WebviewController = new webview.WebviewController();
  private webViewHandler: FTWebViewHandler = new FTWebViewHandler();

  aboutToAppear() {
    this.webViewHandler.setWebView(this.webController);
  }

  aboutToDisappear() {
    this.webViewHandler.clearWebController();
  }

  build() {
    Web({
      src: 'https://example.com',
      controller: this.webController
    })
    .javaScriptAccess(true)
    .javaScriptProxy(this.webViewHandler.getJavaScriptProxy(this.webController))
  }
}

Web controller の準備完了後にバインド

onControllerAttached(...) を使用して、Web コンポーネントと controller のバインド完了後に setWebView(...) を呼び出すこともできます:

Web({
  src: 'https://example.com',
  controller: this.webController
})
.javaScriptAccess(true)
.javaScriptProxy(this.webViewHandler.getJavaScriptProxy(this.webController))
.onControllerAttached(() => {
  this.webViewHandler.setWebView(this.webController);
})

2 つの記述方法のいずれかを使用します。onControllerAttached(...) を使用する場合は、上記の例で aboutToAppear() のバインディング呼び出しを削除し、aboutToDisappear() 内の clearWebController() によるクリーンアップ処理は残してください。

説明:

  • view_path_name が含まれていない場合、SDK はこのフィールドを補完しません。含まれている場合はその値を保持します。view_referrer が含まれていない場合は、現在のネイティブ View にフォールバックします。
  • WebView データの sdk_version はネイティブ SDK を基準とします。Browser SDK のバージョン情報は sdk_pkg_info に保持されます。

よくあるトラブルシューティングの入口

  • WebView データが送信されない場合は、該当する収集スイッチ、Host ホワイトリスト、および FTWebViewHandler のバインディングを確認してください。診断ログの有効化方法については、トラブルシューティング を参照してください。
  • WebView のセッションリプレイを収集する必要がある場合は、先にネイティブ Replay を開始して FTWebViewHandler のバインディングを完了し、その後で Web ページの Browser SDK をロードすることをお勧めします。詳細は HarmonyOS セッションリプレイ(実験的) を参照してください。

フィードバック

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