Mobile Platform as a Service:一般的なインストルメンテーションの設定

このタスクについて

ビジネスシナリオに基づいてインストルメンテーションタイプを選択してください。詳細については、一般的なインストルメンテーションタイプをご参照ください。

操作手順

1. CDN 版の mtracker をインポートします。これにより、Tracker オブジェクトがグローバル window オブジェクトに追加されます。

   ダウンロードした JS ファイル内の中国語文字が文字化けしている場合でも、そのまま使用できます。文字化けはエンコーディングの不一致が原因ですが、インストルメンテーションには影響しません。

2. シナリオに基づいて設定を初期化します。

   • mPaaS コンテナ内のアプリが mPaaS H5 コンテナを統合している場合。

     サンプルコード：

     <script>
     window._to = {
       bizScenario: 'alipay',   // 任意。チャネルソース。デフォルト：空。
       mtrDebug: true,         // 任意。デフォルト：false。
     };
     </script>

     パラメーター	説明
     bizScenario	任意。チャネルソース。デフォルト：空。
     mtrDebug	任意。mtracker のデバッグモードを有効にします。有効にすると、レポートされるログが出力されます。デフォルト：false。

   • mPaaS H5 コンテナを統合していないアプリ、またはブラウザーで実行されるページの場合：

     サンプルコード：

     <script>
     window._to = {
       server: 'https://cn-hangzhou-mas-log.cloud.alipay.com/loggw/webLog.do', // 必須。インストルメンテーションデータを受信するサービスエンドポイント。
       appId: 'xxxxxxxxxx', // 必須。アプリの一意の識別子。
       workspaceId: 'default', // 必須。環境識別子。
       h5version: '1.0.0',    // 必須。クライアントアプリまたは H5 ページのバージョン。
       userId: '1234567890',      // 任意。デフォルト：空。
       bizScenario: 'alipay',   // 任意。チャネルソース。デフォルト：空。
       mtrDebug: true,         // 任意。デフォルト：false。
       extendParams: { test: 111 } // 任意。グローバル拡張パラメーター。デフォルト：空。mtracker 1.2.0 以降でサポートされます。
     };
     </script>

     パラメーター	説明
     server	必須。インストルメンテーションデータを受信するサービスエンドポイント。
     appId	必須。アプリの一意の識別子。
     workspaceId	必須。環境識別子。
     h5version	必須。クライアントアプリまたは H5 ページのバージョン。
     userId	任意。ユーザー ID。デフォルト：空。
     bizScenario	任意。チャネルソース。デフォルト：空。
     mtrDebug	任意。mtracker のデバッグモードを有効にします。有効にすると、レポートされるログが出力されます。デフォルト：false。
     extendParams	任意。グローバル拡張パラメーター。デフォルト：空。mtracker 1.2.0 以降でサポートされます。

3. mtracker オブジェクトを初期化します。

   デフォルトでは、JS ファイルのインポート後に mtracker が自動初期化されます。手動で初期化するには：

   1. JS のインポート行の前に、次のコードを追加して自動初期化を無効にします。

      window.notInitTrackerOnStart = true;

   2. 初期化コードを追加します。

      window.initTracker();

window._to で extendParams を設定すると、以降のすべてのレポートに拡張パラメーターが含まれます。click または expo 呼び出しの ext パラメーター内のプロパティ名がグローバル拡張パラメーターと同じ場合は、メソッドレベルの値が優先されます。

実行時に extendParams を更新するには、次のコードを呼び出します。新しいオブジェクトは、以前の値をすべて上書きします。

window.changeTrackerExtendParams({ newValue: 11111 });

次の手順

モバイル分析コンソールのカスタム分析ページを使用して、H5 インストルメンテーションデータを確認してください。詳細については、一般的なインストルメンテーションの分析をご参照ください。