基础知识储备
基础概念
SPM
SPM,全称超级位置模型(Super Position Model).
SPM是Web端Aplus日志体系和APP端Usertrack日志体系下,共同使用的的重要规范。- SPM规范
阿里的SPM位置编码由A.B.C.D四段构成, 各分段分别代表 A:站点/业务, B:页面, C:页面区块, D:区块内点位. 如下图所示:
- SPM的实现原理
SPM的原理可简单解释图例如下:
SCM
scm编码是用来跟踪内容的编码。 与业务内容一起下发的埋点数据,用来唯一标识一块内容。 客户端打点时,将scm编码作为埋点的参数上传给UT服务器。
SCM规范
scm编码也采用a.b.c.d的格式,其中,一般来说,
- a标识投放系统ID,用来标识不同的内容投放方,比如商城的阿拉丁系统,对应的投放系统ID为1003。
- b标识投放算法ID,用来标识投放系统产生不同内容的投放算法。
- c标识投放算法版本ID,用来标识投放算法的不同版本。
- d标识投放人群ID,用来标识不同的投放人群,或者对接profile。
如何接入SCM
使用快门查看数据报表
SCM多维度汇总数据
SCM+BC维度汇总 tbbi.ads_tb_scm_bc_pv_1d
SCM+一级类目汇总 tbbi.ads_tb_scm_cate_pv_1d
SCM+一级类目+BC汇总 tbbi.ads_tb_scm_bc_cate_pv_1d
A+
A+, APlus, 是基于Acookie和Atpanel日志整合而成的新日志系统,A代表(Alibaba、Acookie、Atpanel),plus代表相加、整合之意。
页面访问日志
每个页面装载head部分的时候,下载一个js,这个js将发送一个请求到日志服务器,请求中包含了同步在淘宝cookie的本地cookie信息,也包含了refer/url/要获取的header参数/session的信息,由此完成pv/uv的默认计算.
url中包含spm信息,可以完成页面来源去向的计算。页面交互日志
用户在页面上某个行为触发一个异步请求,按照约定的格式向日志服务器发送请求,展现、点击、等待、报错等等都可以作为交互行为,黄金令箭就是实现这个.
黄金令箭
事件定义
- 常用UT事件
EventID | 用途 | page | arg1 | arg2 | arg3 | args | 备注 |
---|---|---|---|---|---|---|---|
2001 | 页面离开 | 当前页面 | 上一个页面 | - | 停留时长 | - | - |
2101 | 控件点击 | 当前页面 | 控件名 | - | - | 业务参数 | - |
2201 | 曝光事件 | 当前页面 | 控件名 | - | 无(或曝光时长) | 业务参数 | ViewTrackerSDK支持的曝光事件arg3为时长,args中exposureIndex为曝光次数 |
2202 | 资源币曝光 | 当前页面 | 控件名 | - | - | 业务参数 | - |
5002 | 分享 | Page_share | bizName | 分享途径 | 分享链接 | - | - |
5004 | 回流 | Page_Extend | url(tmall://) | - | - | - | - |
9001 | 钻展 | Page_Extend | - | - | - | 业务参数 | - |
9002 | 钻展 | Page_Extend | - | - | - | 业务参数 | - |
19999 | 自定义事件 | UT或当期页面 | 注册事件名 | - | 时长 | 业务自定义参数 | 自定义事件包括普通自定义事件和时长自定义事件 |
- 黄金令箭
- goldlog.record(logkey, gmkey, gokey, chksum)
参数定义
UT参数定义
UT各事件依据eventid不同其arg1、arg2、arg3、args的含义各不相同。
黄金令箭
goldlog.record()接口定义如下:
void record(logkey, gmkey, gokey, chksum)
各参数含义及入参格式如下:
logkey {String} : 以 / 开头的字符串,如上例中的 "/52taobao.chongzhi.myclick"
gmkey {String} : 关键业务类型. 目前的约定的元值有五个
- 如果请求是点击类操作触发的, 请传入 "CLK" - 如果请求是元素曝光类事件触发的, 请传入 "EXP" - 如果请求是滑动滑屏类事件触发的, 请传入 "SLD" - 如果是其它事件, 请传入 "OTHER" - 本参数可以为空值, 但不建议留空. 此值为空的请求将在日志流量大时被优先降级
gokey {String} : 附加的自定义kv对
- key=value 形式,不同的键值对之间使用 & 分隔,如 click_type=chongzhi&fee=200 - 如果 key 或 value 中有特殊字符,需要先使用 encodeURLComponent 编码
chksum {String} : 校验码。如果此串错误或留空,将无法发送请求。校验码可以从黄金令箭申请中心拿到