API介绍

用于触发某个事件，如某个按钮的点击，或播放器的播放/停止，以及游戏的开始/暂停等。

事件跟踪的数据不会被记入到页面PV中，适合用来统计所有的不需要看做PV的页面事件点击。

已有数据的事件可以在设置中添加为事件转化，跟更多维度数据结合（如来源、入口页面等），进行转化分析。

适用的场景

AJAX页面元素的点击

播放器的播放/停止操作、web小游戏的开始/暂停操作等

Flash中所有的的事件都可以通过该接口来统计，只要在响应用户操作时，通过Flash调用JS接口就可以了

文件下载、咨询等重要按钮、事件元素的监控

设置步骤

申请帐号并在站点上安装百度统计访问分析代码。更多信息请查看帮助。

在响应点击/开始/停止/下载等事件时，在JS中调用事件跟踪代码。

_hmt.push(['_trackEvent', category, action, opt_label, opt_value]);

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>

然后在”事件跟踪”报告中就能看到下载事件的对应数据了

参数

名称 必选/可选 类型 功能

category 必选 String 要监控的目标的类型名称

action 必选 String 用户跟网页进行交互的动作名称

opt_label 可选 String 事件的一些额外信息

opt_value 可选 Number 跟事件相关的数值

使用限制和常见问题

百度统计目前针对_trackevent API 有多样性的限制，即在部署_trackevent API时，参数的多样性乘积不能超过10000，否则系统会自动抛弃超标的数据。

当您的多样性超标后，在报告中会出现提示，请修改代码，使得您代码中传递的参数符合要求。

“动作”参数有时也可以用来记录一些额外信息。比如当同时提供多种格式的文档供用户下载时，就可以用”动作”参数来保存文档格式，如”PDF”、”TXT”等等。

_hmt.push(['_trackEvent', 'document', 'PDF', 'Market Requirements 

Document']);