trackEvent说明

优质
小牛编辑
131浏览
2023-12-01
使用指南 - 数据报告 - JSApi - trackEvent说明

API介绍

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

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

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

适用的场景

  1. AJAX页面元素的点击

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

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

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

设置步骤

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

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

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

    • category:要监控的目标的类型名称,通常是同一组目标的名字,比如”视频”、”音乐”、”软件”、”游戏”等等。该项必选。

    • action:用户跟目标交互的行为,如”播放”、”暂停”、”下载”等等。该项必选。

    • opt_label:事件的一些额外信息,通常可以是歌曲的名称、软件的名称、链接的名称等等。该项可选。

    • opt_value:事件的一些数值信息,比如权重、时长、价格等等,在报表中可以看到其平均值等数据。该项可选。

  3. 查看”事件跟踪”报告,在报告中就能看到指定事件的数据了。

举例

  1. 例如我们可以使用_trackEvent来对某种类型的链接进行监控:

    <a onclick="_hmt.push(['_trackEvent', 'nav', 'click', 'literature'])"
    href="http://www.example.com/literature">文学</a>

    这样就可以在百度统计的”事件跟踪”报告中查看首页导航栏中,采用点击操作、且是关于文学内容链接的点击次数了

  2. 例如用户点击播放按钮会播放”Hey Jude”这首歌,那么在对应的事件处理函数中可以这样来监控播放或暂停事件:

    _hmt.push(['_trackEvent', 'video', 'play', 'Hey Jude']);
    _hmt.push(['_trackEvent', 'video', 'pause', 'Hey Jude']);

    这样在”事件跟踪”报告中就能看到播放/暂停等事件的对应数据了

  3. 例如页面上有一个”千千静听”的下载链接,那么可以这样来监控下载事件:

    <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跟事件相关的数值

使用限制和常见问题

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

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

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

    _hmt.push(['_trackEvent', 'document', 'PDF', 'Market Requirements
    Document']);