Mobile Platform as a Service：配置通用埋點

關於此任務

基於不同的業務情境，使用不同的 H5 通用埋點類型。要瞭解具體的業務情境及對應的埋點類型，查看 通用埋點類型。

操作步驟

1. 引入 CDN 版本的 mtracker。引入 mtracker 後，會在全域 window 中注入 Tracker 對象。

   針對下載的 mtracker 埋點 JS 檔案中文出現亂碼的情況，正常使用該 JS 檔案即可，不會影響埋點配置。該中文亂碼問題應該是因檔案編碼格式與瀏覽器解釋的編碼格式不同所導致。

2. 初始化配置。根據不同情境，在 H5 埋點 JS 檔案中注入相應的資訊。

   • mPaaS 容器內，即 App 整合了 mPaaS H5 容器。

     程式碼範例：

     <script>
     window._to = {
       bizScenario: 'alipay',   // 選填，渠道來源，預設為空白
       mtrDebug: true,         // 選填，預設為 false
     };
     </script>

     參數	描述
     bizScenario	渠道來源，預設為空白，選填。
     mtrDebug	是否開啟 mtracker 的 debug 模式，在 debug 模式下會列印上報的日誌，預設為 false 不開啟。

   • mPaaS 容器外，即 App 未整合 mPaaS H5 容器或瀏覽器端。

     程式碼範例：

     <script>
     window._to = {
       server: 'https://cn-hangzhou-mas-log.cloud.alipay.com/loggw/webLog.do', // 必填，接受埋點的服務地址
       appId: 'xxxxxxxxxx', // 必填，App 唯一標識
       workspaceId: 'default', // 必填，環境標識
       h5version: '1.0.0',    // 必填，用戶端 App/H5 頁面版本
       userId: '1234567890',      // 選填, 預設為空白
       bizScenario: 'alipay',   // 選填，渠道來源，預設為空白
       mtrDebug: true,         // 選填，預設為 false
       extendParams: { test: 111 } // 選填，全域擴充參數，預設為空白，mtracker 1.2.0 版本以上支援
     };
     </script>

     參數	描述
     server	接受埋點的服務地址。
     appId	App 唯一標識。
     workspaceId	環境標識。
     h5version	用戶端 App 版本或 H5 頁面版本。
     userId	使用者識別碼，選填
     bizScenario	渠道來源，預設為空白，選填。
     mtrDebug	是否開啟 mtracker 的 debug 模式，在 debug 模式下會列印上報的日誌，預設為 false 不開啟。
     extendParams	全域擴充參數，預設為空白，mtracker 1.2.0 及以上版本支援。

3. 初始化 mtracker 對象。

   預設情況下，mtracker 在引入 JS 檔案後會自動初始化並注入到 window 對象中。如某些情境中需要手動初始化，需按照下列步驟進行：

   1. 在引入 JS 檔案的位置前加入如下代碼，禁止自動初始化。

      window.notInitTrackerOnStart = true;

   2. 添加初始化代碼。

      window.initTracker();

可根據需要修改全域擴充參數。通過在 window._to 中設定 extendParams 參數，可實現在之後的埋點上報中一直添加設定的擴充參數。若在 click 或 expo 方法中設定的 ext 值中，有重複屬性名稱，傳遞的值以 click 或 expo 方法中的為準。

可調用以下代碼改變已設定的 extendParams，新設定的對象將覆蓋以往設定的 extendParams 所有值。

window.changeTrackerExtendParams({ newValue: 11111 });

後續操作

登入移動分析控制台，通過自訂分析頁面，分析 mtracker 上報的 H5 通用埋點。具體操作步驟，請參見 分析通用埋點。