すべてのプロダクト
Search

このプロダクト

    Quick Tracking:アプリ内 H5 データレポート

    ドキュメントセンター

    Quick Tracking:アプリ内 H5 データレポート

    最終更新日:Jun 20, 2025

    1 H5 ブリッジングシナリオ

    1.1 H5 データを H5 アプリとアプリに同時にレポートする方法

    シナリオ例：

    「春の日の活動」 H5 は、複数のアプリ端末に埋め込まれており、現在のモードで動作して、次の分析要件を満たします。

    • アプリ操作では、顧客がアプリで H5 アクティビティに参加する前後の完全なリンクデータを確認する必要があります。

    • H5 アクティビティ操作では、すべてのアプリ端末で H5 のアクティビティデータを確認する必要があります。

    操作手順：

    1. 2 つのアプリケーションを作成します。

    • 独自の Appkey_app を持つアプリ アプリケーション

    • 独自の Appkey_h5 を持つ Web/H5 アプリケーション

    1. アプリで attach インターフェイスを呼び出して、H5 ブリッジングを実行します

    レポートログ：

    1. アプリがログをレポートします。

      1. Appkey は、アプリの「Appkey_app」です

      2. ユーザーアカウントは、アプリのユーザーアカウントです

      3. デバイス ID は、アプリのデバイス ID です

      4. システムプロパティは、アプリのシステムプロパティです

      5. グローバル属性は、アプリのトラッキングポイントのグローバル属性です

      6. イベントコードとイベント属性は、H5 のトラッキングポイントです

    2. H5 がログをレポートします。

      1. Appkey は、H5 の「Appkey_h5」です

      2. ユーザーアカウントが H5 のユーザーアカウント

      3. デバイス ID が H5 のデバイス ID

      4. H5 のシステムプロパティ

      5. グローバル属性は、H5 のトラッキングポイントのグローバル属性です

      6. イベントコードとイベント属性は、H5 のトラッキングポイントです

    1.2 H5 データを固有のアプリ アプリケーションのみにレポートする方法

    シナリオ例：

    技術アーキテクチャのため、一部のページは H5 技術構造です。現在のモードで動作すると、次の分析要件を満たすことができます。

    • アプリのビジネス、運用、および PD は、アプリデータで完全なフルリンクデータを確認できます。

    操作手順：

    1. Appkey_app が 1 つだけのアプリを作成します

    2. アプリで attach インターフェイスを呼び出して、H5 ブリッジングを実行します

    3. H5 Appkey は null に設定され、呼び出し aplus-jsbridge-only は true に等しくなり、H5 データレポートが無効になります

    レポートログ：

    1. アプリのみがログをレポートします。

      1. Appkey は、アプリの「Appkey_app」です

      2. ユーザーアカウントは、アプリのユーザーアカウントです

      3. デバイス ID は、アプリのデバイス ID です

      4. システムプロパティは、アプリのシステムプロパティです

      5. グローバル属性は、アプリのトラッキングポイントのグローバル属性です

      6. イベントコードとイベント属性は、H5 のトラッキングポイントです

    1.3 H5 データが H5 アプリケーションのみにレポートされる場合

    シナリオ例：

    1. アプリのビジネス、運用、および PD は、アプリで H5 データを確認したくありません

    操作手順：

    1. 2 つのアプリケーションを作成します。

    • 独自の Appkey_app を持つアプリ アプリケーション

    • 独自の Appkey_h5 を持つ Web/H5 アプリケーション

    1. API 呼び出しなし

    レポートログ：

    1. H5 のみ 1 つのログをレポートします。

      1. Appkey は、H5 の「Appkey_h5」です

      2. ユーザーアカウントが H5 のユーザーアカウント

      3. デバイス ID が H5 のデバイス ID

      4. H5 のシステムプロパティ

      5. グローバル属性は、H5 のトラッキングポイントのグローバル属性です

      6. イベントコードとイベント属性は、H5 のトラッキングポイントです

    2 H5 ブリッジングの原則

    yuque_diagram (2)

    上記の方法の前提は次のとおりです。

    1. アプリ統合 QuickTrackingApp SDK

    2. およびアプリ内での H5 統合 QuickTracking H5 SDK

    次の図は、ユーザーがアプリの h5 ページで button2 をトリガーすると、2 つのログが同時にレポートされることを示しています。

    1. App SDK を介したレポート：レポートされたログでは、appkey はアプリの appkey、グローバル属性はアプリのグローバル属性、イベントコードとイベント属性は h5 のトラッキングポイントのコードと属性です。（図の緑色の矢印）

    2. H5 SDK を介したレポート：レポートされたログでは、appkey は h5 の appkey、グローバル属性は h5 のグローバル属性、イベントコードとイベント属性は h5 の埋め込みポイントのコードと属性です。（図の黄色の矢印）

    3 アプリブリッジ H5 スイッチ

    macOS：デフォルトでは無効になっています。初期化パラメータを設定することによってのみ有効にすることができます。

    // H5 ブリッジスイッチ
@property (nonatomic) BOOL enableJSBridge;

    例

    QTSDKConfig *sdkConfig = [[QTSDKConfig alloc] initWithAppkey:@"test_appkey"
                                                  trackDomain:@"https://xxxx.com"
                                                launchOptions:nil];
// H5 ブリッジングを有効にします。
sdkConfig.enableJSBridge = YES;
[QuickTrackingSDK launchWithConfig:sdkConfig];

    4 H5 SDK ログレポートスイッチ

    黄色の矢印リンクを制御するスイッチ API：

    H5 SDK API：

    SDK パラメータ

    aplus-jsbridge-only

    true

    H5 ログ送信を無効にする（黄色の矢印）

    false (デフォルト値: false)

    H5 ログ送信をオンにする（黄色の矢印）

    aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['aplus-jsbridge-only', true]
});
    警告

    注： aplus-jsbridge-only パラメータを true に設定すると、Web リンクの utm パラメータはチャネルパラメータとして自動的に認識されません。グローバル属性を使用してパラメータを設定する必要があります。

    5 H5 グローバル属性同期 API

    H5 で次の API 操作を無効にすると、H5 の aplus.appendMetaInfo または aplus.setMetaInfo で globalproperty パラメータを使用して設定されたグローバルプロパティは、ネイティブアプリでは有効になりません。（このインターフェイスのデフォルトは true です。）

    このインターフェイスは qt_web_v2.0.12 でサポートされています。

    aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['Disable aplus-globalproperty-sync-enable, false] // 同期を無効にする
});

    たとえば、デフォルトでは、アプリでグローバル属性「現在の都市：北京」を設定し、アプリ H5 でグローバル属性「現在の都市：上海」を設定すると、H5 およびアプリネイティブでトリガーされるイベントのグローバル属性は「現在の都市：上海」になります。このスイッチをオフにすると、H5 で設定されたグローバルプロパティはネイティブアプリに同期されません。