配置通用埋点

PC 端和移动端 H5 页面可以使用统一的 H5 埋点方案。通过配置埋点,您可以实现统一的 H5 埋点。

关于此任务

基于不同的业务场景,使用不同的 H5 通用埋点类型。要了解具体的业务场景及对应的埋点类型,查看 通用埋点类型

操作步骤

  1. 引入 H5 埋点 JS。直接引入 CDN 版本的 mTracker。引入 mTracker 后,会在全局 window 中注入 Tracker 对象。
  2. 初始化配置。手动注入以下信息:

    • 集成了 mPaaS 的 H5 容器的 App 中,不需要初始化操作,可配置项为:

      • bizScenario:渠道来源,默认为空,选填。
      • mtrDebug:是否开启 mTracker 的 debug 模式,在 debug 模式下会打印上报的日志,默认为 false 不开启。

      示例如下:

      1. <script>
      2. window._to = {
      3. bizScenario: 'alipay', // 选填,默认为空
      4. mtrDebug: false, // 选填,默认为 false
      5. };
      6. </script>
      7. <script src="https://gw.alipayobjects.com/os/lib/alipay/mpaas-mtracker/1.1.3/dist/index.min.js"></script>
    • 未集成 mPaaS 的 H5 容器或浏览器端,配置项为:

      • server:接受埋点的服务地址。
      • appId:App 唯一标识。
      • workspaceId:环境标识。
      • h5version:客户端 App 版本或 H5 页面版本。
      • userId:用户 ID,选填。
      • bizScenario:渠道来源,默认为空,选填。
      • autoStart:是否自动启用 mTracker,选填,默认为 true。设置为 false 之后需调用 Tracker.start() 才能使用 mtracker 上报功能,同时会上报当前页面的 PV 事件。
      • mtrDebug:是否开启 mTracker 的 debug 模式,在 debug 模式下会打印上报的日志,默认为 false 不开启。

      示例如下:

      1. <script>
      2. window._to = {
      3. server: 'https://cn-hangzhou-mas-log.cloud.alipay.com/loggw/webLog.do',
      4. appId: 'xxxxxxxxxx',
      5. workspaceId: 'test',
      6. h5version: '0.1.1.1',
      7. userId: '12312323', // 选填, 默认为空
      8. bizScenario: 'alipay', // 选填,默认为空
      9. mtrDebug: false, // 选填,默认为 false
      10. };
      11. </script>
      12. <script src="https://gw.alipayobjects.com/os/lib/alipay/mpaas-mtracker/1.1.3/dist/index.min.js"></script>
  3. 初始化 mTracker 对象。

    默认情况下,mTracker 在引入 JS 文件后会自动初始化并注入到 window 对象中。如某些场景中需要手动初始化,需按照下列步骤进行:

    1. 在引入 JS 文件的位置前加入如下代码,禁止自动初始化。
      1. window.notInitTrackerOnStart = true;
    2. 添加初始化代码。
      1. window.initTracker();

后续操作

登录 移动分析 控制台,通过自定义分析页面,分析 mTracker 上报的 H5 通用埋点。具体操作步骤,请参见 分析通用埋点