浙政钉实现埋点(浙政钉-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
(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'] });
基础埋点
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', // 一般日志(如点击和曝光)接
文章版权声明:除非注明,否则均为主机测评原创文章,转载或复制请以超链接形式并注明出处。