全部产品
云市场
云游戏

配置通用埋点

更新时间:2020-05-19 15:00:28

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

关于此任务

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

操作步骤

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

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

  1. - `bizScenario`:渠道来源,默认为空,选填。
  2. - `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容器或浏览器端,配置项为

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

示例如下:

  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>

mTracker 初始化

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

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

后续操作

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