すべてのプロダクト
Search

このプロダクト

    Mobile Platform as a Service:HTML5 コンテナーの自動トラッキング

    ドキュメントセンター

    Mobile Platform as a Service:HTML5 コンテナーの自動トラッキング

    最終更新日:Apr 24, 2025

    mPaaS が提供する Nebula コンテナーを使用して HTML5 ページを読み込むと、Nebula コンテナーはページ読み込みアクションとパフォーマンスの統計を自動的に収集し、例外をキャプチャして HTML5 ページ読み込みに関するデータの追跡を支援します。このトピックでは、Nebula コンテナーの自動トラッキング機能を統合し、トラッキングデータを表示する方法について説明します。

    前提条件

    mPaaS が提供する自動 HTML5 コンテナー トラッキング機能を統合するには、以下を確認してください。

    • mPaaS コンソールでアプリを作成済みであること。

    • SDK を追加する 手順を完了し、クライアント プロジェクトに NebulaLogging.framework が統合されていること。

    手順

    構成の初期化

    1. Nebula コンテナーの自動トラッキング機能を統合するには、コンテナーの初期化中に HTML5 トラッキング監視を有効にします。

      // 監視の委任。HTML5 コンテナーの自動トラッキングを追加します。
 NBLogConfigurationGet().shouldInjectSPMJS=YES;
 #ifdef DEBUG
 NBLogConfigurationGet().enableConsoleLog = YES;
 #endif
 [NBLogServiceGet() start];
 [[NBMonitor defaultMonitor] setDelegate:NBLogServiceGet()];

    2. HTML5 トラッキング監視が有効になった後、Nebula コンテナーを使用して HTML5 ページを読み込むと、コンテナーはページ読み込みアクション、パフォーマンス、および例外の統計を自動的に収集します。トラッキングデータの表示シナリオに基づいて、2 つの方法があります。

      • クライアントログの表示: クライアントのローカル トラッキング データを表示します。このモードは、アプリ開発フェーズでのトラブルシューティングに適用されます。クライアントログの表示 を参照してください。

      • サーバーログの表示: オンライン ユーザーに対して生成された実際のトラッキング データを表示します。このモードは、アプリがオンラインでリリースされた後のオンライン トラブルシューティングに適用されます。サーバーログの表示 を参照してください。

    クライアントログの表示

    HTML5 ページが読み込まれた後、Xcode コンソールでキーワード [h5log] を検索して、次の図に示すように、ページの読み込みに関連するトラッキングデータの主要な情報を表示します。

    client logs

    次の表に、Xcode コンソールによって出力される HTML5 コンテナー トラッキング データに含まれる主要な情報を示します。

    SeedId

    例

    説明

    bizType

    webapp

    ログ タイプ。ローカル ログ ファイルのファイル名に書き込まれます。

    seedId

    H5_AL_SESSION_FROM_NATIVE

    一意のトラッキング ID。詳細な説明については、

    HTML5 コンテナー トラッキング セット を参照してください。

    head

    HD-VM

    ログ モデル。パフォーマンストラッキング を参照してください。

    params

    https://www.baidu.com

    現在のページの URL。

    currentTimestamp=1553072784000

    タイムスタンプやページの読み込みステータスなどのカスタム パラメーター。

    -

    ページ要素の位置などのカスタム パラメーター。

    ^url=https://www.baidu.com^referer=MPH5DemoVC^viewId

    =MPH5DemoVC^refviewId=MPHomeViewController^token=

    A994169ddd50640fa262dbc2dfebb2bb3^h5SessionToken=

    db4db9cfd83521aa2bc31a2e5a6df30e/td>

    トラッキング情報:

    オフライン パッケージ アプリ ID、オフライン パッケージ バージョン番号、

    現在の HTML5 ページによって読み込まれた URL、VC クラス名、

    および現在のページのトークンが含まれます。

    formatter

    header = "HD-VM"

    head フィールドの説明と同じです。

    Xcode コンソールでログ レコードの完全なコンテンツを表示するには、サンドボックス内の Library/log ディレクトリにある、名前が bizType で始まるファイルを見つけ、キーワード seedId で検索します。

    client logs

    サーバーログの表示

    オンライン ユーザーの HTML5 コンテナー トラッキング データを表示するには、mPaaS コンソールで ログ リプレイ を使用してデータを検索します。

    server log

    HTML5 コンテナー トラッキング セット

    HTML5 コンテナーによって測定された自動トラッキング データは、seedId によって一意に識別されます。HTML5 ページの読み込み方法に基づいて、3 つのタイプのトラッキング セットがあります。

    • オンライン URL を開くことに関するトラッキング セット

    SeedId

    説明

    H5_AL_SESSION_FROM_NATIVE

    コンテナーが起動されました。

    H5_AL_PAGE_START

    ページの読み込みが開始されます。

    H5_AL_NETWORK_START

    ページがネットワーク リクエストの送信を開始します。

    H5_OPEN_PAGE_FINISH

    ページの読み込みが完了しました。

    H5_AL_PAGE_APPEAR

    ページが初めて表示されます。

    H5_AL_JSAPI_SENDEVENT

    ページが JSAPI を呼び出します。

    H5_AL_JSAPI_NOTFOUND

    HTML5 ページでの JSAPI 呼び出しに失敗しました。

    H5_TITLEBAR_BACK_BT

    ナビゲーションバーの戻るボタンがタップされました。

    H5_PAGE_PERFORMANCE

    ページの読み込みパフォーマンスが測定されます。

    • オフライン パッケージ ページを開くことに関するトラッキング セット

    SeedId

    説明

    H5_APP_REQUEST

    オフライン パッケージ情報をリクエストします。

    H5_APP_LOAD_DATASOURCE

    オフライン パッケージ情報を読み込みます。

    H5_AL_SESSION_FROM_NATIVE

    コンテナーが起動されました。

    H5_APP_DOWNLOAD

    オフライン パッケージをダウンロードします。

    H5_APP_UNZIP

    オフライン パッケージを解凍します。

    H5_APP_POOL

    パッケージ管理情報プールで操作を実行します。プールの情報の追加、削除、変更などが含まれます。

    H5_APP_VERIFY

    オフライン パッケージの署名検証を実行します。

    H5_AL_SESSION_VERIFYTAR_FAIL

    オフライン パッケージの署名検証に失敗しました。

    H5_AL_PAGE_START

    ページの読み込みが開始されます。

    H5_AL_SESSION_MAP_SUCCESS

    ローカル オフライン パッケージが正常に読み込まれました。

    H5_AL_SESSION_FALLBACK

    ローカル オフライン パッケージの読み込みに失敗しました。フォールバック機能が実行され、オンライン ページがリクエストされます。

    H5_OPEN_PAGE_FINISH

    ページの読み込みが完了しました。

    H5_AL_PAGE_APPEAR

    ページが初めて表示されます。

    • 例外トラッキング セット

    seedId

    説明

    H5_AL_NETWORK_PERFORMANCE_ERROR

    リソース リクエストの例外。

    H5_PAGE_ABNORMAL

    ページの例外。

    H5_AL_PAGE_JSERROR

    JS の例外。

    H5_AL_JSAPI_RESULT_ERROR

    JSAPI の例外。