全部产品

配置通用埋点

更新时间:2020-11-16 18:14:59

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.1/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.1/dist/index.min.js"></script>
  3. 初始化 mTracker 对象。

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

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

后续操作

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