功能说明
用于发送页面上按钮等交互元素被触发时的事件统计请求。如视频的“播放、暂停、调整音量”,页面上的“返回顶部”、“赞”、“收藏”等。
在元素被触发时调用_trackEvent()方法,则访客使用这些元素的情况就可以被CNZZ统计到,并展现到报表中供您查看。每个事件允许您从多种维度来命名、标记,查看数据时也会根据不同维度汇总数据,并且提供了“值”位,可用于计算一些与“金额”、“评分”等相关的数据。
常见应用场景
-
■页面上交互元素的统计,如:返回顶部、赞、收藏、打分、展开收起隐藏层、TAB切换。
-
■播放器的交互统计,如:加载、播放、暂停、调整音量。
-
-
■Flash事件统计,如Flash游戏中:开始游戏、购买内购道具。(需要嵌入Flash时,允许Flash与页面上的JS进行通信,即allowscriptaccess的值不为never)
-
■Flash页面加载时间、数据加载时间等。
-
其实本API的使用方法并不局限于对交互元素的统计,您可以任意发挥想象力,灵活应用此API,去完成各种希望统计发生次数的情况。
部署前准备
在部署该API之前,需要您:
1)拥有CNZZ统计帐号。
2)在网站上部署了CNZZ统计的JS统计代码。
3)在页面上部署
预配置代码。
具体流程可参考
代码部署流程。
代码语法及参数说明
在按钮等被点击触发的时候,调用_trackEvent()方法,语法如下:
_czc.push(["_trackEvent",category,action,label,value,nodeid]);
//本代码仅为语法范例,请勿直接粘贴使用。部署时需要您替换参数值。
各参数含义如下:
category:事件类别,必填项,表示事件发生在谁身上,如“视频”、“小说”、“轮显层”等等。
action:事件操作,必填项,表示访客跟元素交互的行为动作,如"播放"、"收藏"、"翻层"等等。
label:事件标签,选填项,用于更详细的描述事件,从各个方面都可以,比如具体是哪个视频,哪部小说,翻到了第几层等等。
value:事件值,选填项,整数型,用于填写打分型事件的分值,加载时间型事件的时长,订单型事件的价格等等。
nodeid:div元素id,选填项,填写网页中的div元素id值,用于在“用户视点”功能上重绘元素的事件发生情况。
查看API详细说明
使用小工具生成代码
调用范例:
<a href="#" onclick="_czc.push(['_trackEvent', '小说', '打分', '达芬奇密码','5','dafen']);">打分</a>
部署方案的设计
在让开发人员做部署之前,建议由查看数据的人整理部署方案,以便获得更易读的数据报告(点此查看
“事件分析报告说明”,了解各参数与报告的对应关系)。
部署方案中需要包括:
1、哪些事件需要统计。
2、每个事件的category、action、label、value怎么定义。
举例说明:
某网站,拥有“达芬奇密码”、“天使与魔鬼”等小说,提供收藏、打分功能。需要统计各操作的发生次数。
部署方案如下:
事件编号 |
category |
action |
label |
value |
nodeid |
1 |
小说 |
打分 |
达芬奇密码 |
具体分值 |
由技术填写 |
2 |
小说 |
收藏 |
达芬奇密码 |
|
由技术填写 |
3 |
小说 |
打分 |
天使与魔鬼 |
具体分值 |
由技术填写 |
4 |
小说 |
收藏 |
天使与魔鬼 |
|
由技术填写 |
此处有几个方案设计原则供参考:
1、category、action、label的值,对于同一项内容,尽量用词相同,比如都是“小说”,那尽量不要出现“小说”、“novel”、“书”等多个同义词。以避免在报告中将本应合并的数据分散。
2、action的值尽量表意明确,最好不要用“点击按钮”、“按键”、“确定”等没有实际业务含义的词。建议使用“播放”、“确认注册”这种表意更清晰的词。
3、当需要统计的内容形式比较单一,或不需要分类看数据的时候,可以直接将具体描述写到category中。如统计注册按钮,该按钮只在首页导航中有出现,不存在其他情况,则category的值可以直接为“首页”。
常见事件应用范例
登录网站
_czc.push(["_trackEvent","头部登录层,"登录网站",,,"
登录按钮id"]);
//其中灰色的为选填项
查看报告方式
开放计算平台-事件(每个事件的统计)
提供每一个具体事件的统计数据,事件的名称将表示为category+action+label的形式,如“小说+收藏+达芬奇密码”。
开放计算平台-事件类别、事件操作、事件标签(每类事件的统计)
针对category、action和label三个参数,将对参数值相同的事件提供合并统计结果。
例如达芬奇密码和盗墓笔记都属于“小说”,则将看到一条为“小说”的记录,它对应所有category为“小说”的事件发生次数总和。
开放计算平台-发生页面
提供发生了事件的受访页面列表,及相关统计数据,帮助您了解哪些页面的事件被触发的更多。如果事件为flash事件,不直接从页面触发,那发生页面会记录为flash所在的页面。
开放计算平台-事件明细
提供最近7天的事件发生全明细表,精确了解每一个事件的发生情况,了解访客操作交互元素的顺序特点。
用户视点-事件视点
在用户视点功能中,增加了事件视点,在原始只标注链接热度的基础上,标注出交互元素的操作热度,更直观。
另外,查看事件视点的功能目前仅能提供于全景统计。
注意事项
1、报表中将展现事件发生次数在前1000名的事件、事件类别、操作、标签及发生页面。
2、事件个数建议不超过10000,即事件类别、操作、标签三项的多样性乘积不应超过10000。
3、除onclick()外,onfocus()、onload()、onkeydown()等JS事件、ActionScript事件均可调用本方法,点此链接查看所有JavaScript事件
http://www.w3school.com.cn/js/jsref_events.asp。
4、value值仅支持整数,如果您使用浮点数调用,系统将自动取整,去除小数点。