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 を導入していないページで使用できます:
完了したら、データの検証 に進みます。
3. データの検証¶
- App で導入済みの WebView ページを開き、ページビュー、クリック、またはネットワークリクエストを発生させます。
- リアルユーザーモニタリング(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 セッションリプレイ を参照してください。サポート範囲とパラメーターの説明は各プラットフォームのドキュメントに準拠します。