预配置代码
预配置代码部署
1、每个需要调用API的页面,都首先需要安装有CNZZ统计的JS统计代码。2、正式开始部署“虚拟PV跟踪”、“事件跟踪”等API代码之前,需要先在页面的之前添加如下代码
只有添加了这段代码,本平台提供的API代码才能正常执行。
“var _czc = _czc || [];”,用来声明_czc对象,API代码中都会使用到这个对象。
“_czc.push([“_setAccount”, “XXXXXXXX”]);”用来指定需要哪个网站代码(siteid)来接受API发送的请求。”XXXXXXXX”表示您网站上添加的CNZZ统计代码所对应的siteid,请用您的siteid替换此部分。
添加好预配置代码后,就可以开始部署虚拟PV、事件跟踪等代码了。
工具:https://open.cnzz.com/a/tool/
trackEvent
功能说明
用于发送页面上按钮等交互元素被触发时的事件统计请求。如视频的“播放、暂停、调整音量”,页面上的“返回顶部”、“赞”、“收藏”等。也可用于发送Flash事件统计请求。
代码语法
_czc.push(["_trackEvent",category,action,label,value,nodeid]);
例子:
<script type="text/javascript">document.write(unescape("%3Cspan id='cnzz_stat_icon_1278701268'%3E%3C/span%3E%3Cscript src='https://s4.cnzz.com/z_stat.php%3Fid%3D1278701268%26show%3Dpic' type='text/javascript'%3E%3C/script%3E"));
$('a').click(function(){ _czc.push(["_trackEvent", "电话统计", "点击", "400电话", "", "bgs4"]); })
$(document).delegate('a','click',function(){
_czc.push(['_trackEvent', '百度', '在线咨询', '右侧点击','5','newBridge']);
})
参数说明
参数 | 必填/选填 | 类型 | 功能 | 备注 |
---|---|---|---|---|
category | 必填 | string | 表示事件发生在谁身上,如“视频”、“小说”、“轮显层”等等。 | |
action | 必填 | string | 表示访客跟元素交互的行为动作,如"播放"、"收藏"、"翻层"等等。 | |
label | 选填 | string | 用于更详细的描述事件,如具体是哪个视频,哪部小说。 | |
value | 选填 | int | 用于填写打分型事件的分值,加载时间型事件的时长,订单型事件的价格。 | 请填写整数数值,如果填写为其他形式,系统将按0处理。若填写为浮点小数,系统会自动取整,去掉小数点。 |
nodeid | 选填 | string | 填写事件元素的div元素id。 | 请填写class id,暂不支持name。 |
注意事项
各参数含义如下:category:事件类别,必填项,表示事件发生在谁身上,如“视频”、“小说”、“轮显层”等等。action:事件操作,必填项,表示访客跟元素交互的行为动作,如”播放”、”收藏”、”翻层”等等。label:事件标签,选填项,用于更详细的描述事件,从各个方面都可以,比如具体是哪个视频,哪部小说,翻到了第几层等等。value:事件值,选填项,整数型,用于填写打分型事件的分值,加载时间型事件的时长,订单型事件的价格等等。nodeid:div元素id,选填项,填写网页中的div元素id值,用于在“用户视点”功能上重绘元素的事件发生情况。
除onclick()外,onfocus()、onload()、onkeydown()等JS事件、ActionScript事件均可调用本方法,点此链接查看所有JavaScript事件http://www.w3school.com.cn/js/jsref_events.asp。
-
- category:要监控的目标的类型名称,通常是同一组目标的名字,比如"视频"、"音乐"、"软件"、"游戏"等等。该项必填,不填、填"-"的事件会被抛弃。
- action:用户跟目标交互的行为,如"播放"、"暂停"、"下载"等等。该项必填,不填、填"-"的事件会被抛弃。
- opt_label:事件的一些额外信息,通常可以是歌曲的名称、软件的名称、链接的名称等等。该项选填,不填、填"-"代表此项为空。
- opt_value:事件的一些数值信息,比如权重、时长、价格等等,在报表中可以看到其平均值等数据。该项可选。
- 查看"事件跟踪"报告,在报告中就能看到指定事件的数据了。
举例
-
例如我们可以使用_trackEvent来对某种类型的链接进行监控:
<a onclick="_hmt.push(['_trackEvent', 'nav', 'click', 'literature'])" href="http://www.example.com/literature">文学</a>
这样就可以在百度统计的"事件跟踪"报告中查看首页导航栏中,采用点击操作、且是关于文学内容链接的点击次数了
-
例如用户点击播放按钮会播放"Hey Jude"这首歌,那么在对应的事件处理函数中可以这样来监控播放或暂停事件:
_hmt.push(['_trackEvent', 'video', 'play', 'Hey Jude']); _hmt.push(['_trackEvent', 'video', 'pause', 'Hey Jude']);
在"事件跟踪"报告中就能看到播放/暂停等事件的对应数据了
-
例如页面上有一个"千千静听"的下载链接,那么可以这样来监控下载事件:
<a id="download" onclick="_hmt.push(['_trackEvent', 'software', 'download', 'ttplayer']);" href="http://www.example.com/download/ttpsetup.exe" target="_blank">下载</a>
然后在"事件跟踪"报告中就能看到下载事件的对应数据了