浙政钉-H5&小程序应用采集开发手册

浙政钉-H5&小程序应用采集开发手册

埋点代码分为：稳定性监控代码（Emas）和流量分析代码(A+)。稳定性监控代码（Emas）只需要在首页加入。流量分析代码(A+)每个页面都需要加入，但是可以写通用js，在其他页面引入。

适用范围

• 本文档适用于浙政钉业务web（H5）或小程序应用。
• 不适用App端native页面。

采集流程

埋点开发主要步骤如下：

• 采集首先需要引用SDK，SDK引用方式分为web（Hs5）和小程序两种方式；
• 完成SDK引用后，可设置用户信息进行用户信息埋点；
• 可通过上报日志API对埋点信息实现上报；
  开发者可根据实际情况分别参考下文进行采集埋点开发。

1、web（H5）引用SDK方式

在页面head内引用aplusJS

web（h5）通用采集SDK：浙政钉直接进行埋点。

注意：域名修改为 alog-api.ding.zj.gov.cn

<script>
  (function(w, d, s, q, i) {
    w[q] = w[q] || [];
    var f = d.getElementsByTagName(s)[0],j = d.createElement(s);
    j.async = true;
    j.id = 'beacon-aplus';
    j.src = 'https://alidt.alicdn.com/alilog/mlog/aplus_cloud.js';
    f.parentNode.insertBefore(j, f);
  })(window, document, 'script', 'aplus_queue');

  aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['aplus-rhost-v', 'alog-api.ding.zj.gov.cn']
  });
  aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['aplus-rhost-g', 'alog-api.ding.zj.gov.cn']
  });

      var u = navigator.userAgent
      var isAndroid = u.indexOf('Android') > -1
      var isIOS = !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/)

      aplus_queue.push({
        action: 'aplus.setMetaInfo',
        arguments: ['appId', isAndroid ? '28302650' : isIOS ? '28328447' : '47130293']
      });
</script>

基础埋点

web（h5）普通页面的PV日志是自动采集的，如果你的应用为单页应用，或者需要在PV日志里加上特定的埋点参数，可以这样埋点（如无这方面需求略过）：

// 单页应用 或 “单个页面”需异步补充PV日志参数还需进行如下埋点：
aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['aplus-waiting', 'MAN']
});
// 单页应用路由切换后 或 在异步获取到pv日志所需的参数后再执行sendPV：
aplus_queue.push({
  'action':'aplus.sendPV',
  'arguments':[{
  	is_auto: false
  }, {

    // 自定义PV参数key-value键值对（只能是这种平铺的json，不能做多层嵌套），如：
    x: 111,
    y: 222
  }]
})

说明：

如对sendPV这个API有疑问可以参考 上报日志-sendPV API说明 查阅其详细用法。

用户信息埋点

// 如采集用户信息是异步行为需要先执行这个BLOCK埋点
aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['_hold', 'BLOCK']
});
// 设置用户ID，用户设备ID可不做上报，若上报可使用开放平台JSAPI获取UUID
//用户id需要埋政钉用户真实信息，用户ID必须用accountId，可通过开放平台“获取用户详情”接口获取。
aplus_queue.push({
  action: "aplus.setMetaInfo",
  arguments: ["_user_id", "当前用户ID"]
});
aplus_queue.push({
  action: "aplus.setMetaInfo",
  arguments: ["_dev_id", "当前用户设备ID"]
});

// 如采集用户信息是异步行为，需要先设置完用户信息后再执行这个START埋点
// 此时被block住的日志会携带上用户信息逐条发出
aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['_hold', 'START']
});

注意事项：

如果需要采集用户信息，那么上述单页应用的sendPV调用也需要置于 _hold:BLOCK 和 _hold:START配置之间。

2、小程序引用SDK方式

下载小程序通用采集SDK：??aplus_mini_202951027.js

基础配置

1.准备config内容如下：

// 如私有云日志服务端域名类似于：quickaplus-web-api.xxx.com.cn
{	
  'metaInfo': {
    'appId':ptf=='ANDROID'?'28302650':ptf=='IOS'?'28328447':'47130293',
    // PV日志接收日志域名，必须按实际情况填写
    'aplus-rhost-v': 'alog-api.ding.zj.gov.cn',
		// 一般日志（如点击和曝光）接