为了提供新功能和修复以前版本中发现的缺陷,我们会定期更新 Google Analytics(分析)JavaScript 跟踪代码 (ga.js
)。
本页记录了对 ga.js
跟踪代码所做的任何变更。我们建议您定期查看此列表,及时掌握最新信息。您还可以通过下文订阅一节中列出的 Feed 订阅变更内容。
请注意,您和您的用户可能无法立即看到经过更新的 ga.js
跟踪代码,因为:
- 具体更改会在几天内通过 Google 的全球数据中心基础架构分阶段实施。
- 对于您网站的用户,其浏览器中可能缓存了旧版 JavaScript。
订阅相关变更日志
包括所有数据收集、配置和报告 API。
包括网络跟踪(ga.js 和 analytics.js)、Android SDK、iOS SDK 和 Measurement Protocol。
发行版本 2014-06-25(发行日期:2014 年 6 月 25 日)
- 现已弃用所有不包含有效跟踪 ID 的命中。
发行版本 2014-04-16(发行日期:2014 年 4 月 16 日)
- 现已正确地将 Yahoo 安全搜索归类为自然来源。
- 新增了对于不带前缀的预呈现 API 的支持。除了 Chrome 之外,现在也可以在 IE11 中使用预呈现。
发行版本 2014-02(发行日期:2014 年 2 月 11 日)
- 维护版本。
发行版本 2013-11(发行日期:2013 年 11 月 22 日)
- 经过改进,可在使用多个跟踪器的网站上支持 Universal Analytics 升级。
发行版本 2013-02(发行日期:2013 年 2 月 13 日)
以下更改已推送至最新版的跟踪代码:
- 新增了对采用
_set
指定本地货币的支持,例如gaq.push(['_set', 'currencyCode', 'EUR'])
发行版本 2012-02(发行日期:2012 年 2 月 24 日)
以下更改已推送至最新版的跟踪代码:
- 允许的网站速度采样率上限 (
_setSiteSpeedSampleRate
) 已从 10% 增加至 100%。 _setAccount
方法现在会去除开头和结尾的所有空格。
发行版本 2012-02(发行日期:2012 年 2 月 1 日)
以下更改已推送至最新版的跟踪代码:
- 更新了默认检测到的自然搜索引擎列表。新增了“startsiden.no”“rakuten.co.jp”“biglobe.ne.jp”和“goo.ne.jp”。移除了“search”并新增了“conduit.com”“babylon.com”“search-results.com”“avg.com”“comcast.net”和“incredimail.com”,以上这些之前都被归结为“search”。
发行版本 2012-01(发行日期:2012 年 1 月 26 日)
以下更改已推送至最新版的跟踪代码:
- 自定义变量长度的上限已从 64 个字符增加至 128 个字符。此外,现在需要先检查变量长度,然后再进行网址编码。
- 放宽了事件命中的速率限制。您现在每秒可以发送 10 次命中,还有 1 次额外的命中(以前限制为每 5 秒 1 次命中)。请注意,每次会话 500 次命中这一限制仍然适用。
__utmv
Cookie 现在采用其他变量分隔符(脱字符号,而非英文逗号)进行编写,以便与 RFC 兼容。这应该可以解决一些与客户遇到的 Cookie 编码问题相关的问题。
发行版本 2011-11(发行日期:2011 年 11 月 16 日)
网站速度数据收集方面的更改:
- 现在,系统会以 1% 的采样率自动收集所有网络媒体资源的网站速度数据。现已弃用
_trackPageLoadTime
函数,此前需要选择该函数才可以收集网站速度数据。 - 新增了可调整默认采样率的
_setSiteSpeedSampleRate
函数。 - 如果
_trackPageview
调用中使用了虚拟路径,则现在还可以将该路径与从该页面中收集的任何网站速度数据关联起来。
发行版本 2011-10(发行日期:2011 年 10 月 17 日)
此版本新增了以下功能:
- 通过将
_trackEvent()
方法的新opt_noninteraction
参数设置为true
,可以将事件标记为非互动。将事件标记为非互动意味着,来自该标记事件的点击将不会影响跳出率。如需了解详情,请参阅 ga.js 参考。
此版本修复了以下问题:
- 修复了通过内部网站链接传递 AdWords
gclid
网址参数可能导致付费访问次数虚增的问题。
发行版本 2011-08(发行日期:2011 年 8 月 16 日)
此版本修复了可能导致一些网站的访问次数虚增和/或新访客数量减少的问题。访问次数虚增影响的主要是具有与特定用户行为相关的自然流量的网站,而新访客数量减少只会影响那些使用不受支持的、拥有多个跟踪器的跟踪配置的网站。
发行版本 2011-08(发行日期:2011 年 8 月 11 日)
会话计算方面的变化:
- 每个会话一个广告系列:如果在现有会话期间启动了新广告系列,那么现在的跟踪脚本将自动启动新会话。更改以下任一字段都会触发新的广告系列:广告系列 ID、名称、来源、媒介、字词、内容或 gclid。
- 如果用户关闭浏览器,则跟踪脚本不再启动新的会话。
跨网域跟踪方面的变化:
- 配置跨网域跟踪时,不再需要调用
_setAllowHash(false)
。已包含_setAllowHash(false)
调用的页面将继续正常显示,但在设置新网站时不再需要进行调用。 - 跟踪脚本现在会尝试修复被 HTTP 重定向器和浏览器损坏的链接器参数。在当前由于重定向器和浏览器引入的编码变化而被废弃的链接器值中,跟踪脚本应该可以修复成功并接受其中大约 85% 的值。
发行版本 2011-07(发行日期:2011 年 7 月 26 日)
此版本新增了一项功能:
- 跟踪代码现在会推迟相关预呈现页面的命中,直到用户查看这些页面。如果用户一直没有查看预呈现页面,则不发送命中。此功能仅面向使用异步跟踪脚本的网站提供。您可以通过 Google 网站站长中心博客详细了解预呈现。
发行版本 2011-07(发行日期:2011 年 7 月 14 日)
此版本修复了各种问题并进行了重构,还新增了一项功能:
- 新增了社交跟踪支持 (_trackSocial)
发行版本 2011-05(发行日期:2011 年 5 月 18 日)
此版本修复了以下问题:
- 修复了跨网域跟踪中的一个问题,该问题在一些情况下会导致广告系列数据出现错误的编码。
- 修复了跨网域跟踪中的一个问题,该问题会导致系统多次从网址中加载 Cookie,在一些情况下这会导致出现不正确的 Cookie。
- 修复了自定义变量中的一个问题,该问题会导致对报告中的一些值进行编码。
发行版本 2011-04(发行日期:2011 年 4 月 14 日)
此版本进行了一些常规维护,包括修复了几个问题和进行重构。公开 API 或功能没有变化。
发行版本 2011-03(发行日期:2011 年 3 月 30 日)
此版本进行了一些更新,并新增了一项功能。
-
POST
支持:- 跟踪代码现在可以发送更大的跟踪信标。信标一直以来都是通过 HTTP
GET
请求发送的,一些浏览器和代理会将请求限制在 2048 个字符以内。超出此限制的请求将被丢弃,因此相关数据永远不会到达 Google Analytics(分析)。从此版本开始,超过 2048 个字符的请求将通过 HTTPPOST
发送,因此没有这种限制了。跟踪代码现在支持最多 8192 个字符的信标。
- 跟踪代码现在可以发送更大的跟踪信标。信标一直以来都是通过 HTTP
发行版本 2011-02(发行日期:2011 年 2 月 17 日)
此版本修复了以下问题:
- 修复了在第一次访问网站时阻止
_addIgnoredOrganic
和_addIgnoredRef
正常工作的问题。 - 修复了一个与跨多个 iframe 运行的跟踪代码有关的问题。
发行版本 2010-10(发行日期:2010 年 10 月 4 日)
此版本进行了一些常规维护,包括修复了几个问题和进行重构。公开 API 或功能没有变化。
发行版本 2010-04(发行日期:2010 年 4 月 20 日)
此版本修复了几个问题,并进行了 API 清理。
-
修复了以下问题:
- 修复了事件跟踪问题。调用
_trackEvent
时不再需要首先调用_initData
或_trackPageview
。 - 更新了异步代码段,使其可以置入任何页面的标头,而不会在 IE 6 和 IE 7 中引发问题。如需了解这一新的代码段,请参阅异步跟踪指南。此项更新的实施日期是 2010 年 3 月 22 日。
- 扩展了异步语法,使之支持调用
_gat
对象上的方法。
- 修复了事件跟踪问题。调用
-
更新了跟踪器初始化 API,使之与异步语法保持一致。还弃用了一些原有的函数。
- 新增了
_gat._createTracker(opt_account, opt_name)
函数。您可使用此函数命名跟踪器,并在稍后通过这些名称进行检索。建议使用此函数,而不是_gat._getTracker(account)
。 - 新增了
_gat._getTrackerByName(name)
。用于检索具有指定名称的跟踪器。 - 新增了
tracker._getName()
。用于返回创建跟踪器时指定的跟踪器名称。 - 弃用了
_gaq._createAsyncTracker(account, opt_name)
。请改用_gat._createTracker
。 - 弃用了
_gaq._getAsyncTracker(name)
。请改用_gat._getTrackerByName
。
- 新增了
-
如需详细了解这些 API 的变化,请参阅跟踪器参考。
发行版本 2009-12(发行日期:2009 年 12 月 1 日)
此版本更新了默认的搜索引擎列表,并新增了控制 Cookie 超时的函数。此外,还发布了异步 GA 代码段,可降低页面上的 ga.js 延时影响。
-
更新了默认的搜索引擎列表。
- 新增了 Naver、Eniro 和 Daum 搜索引擎。
- 从列表中移除了 Looksmart、Gigablast、Club-internet、Netsprint、Intera、Nostrum 和 Ilse。
-
新增了控制所有已存储 Cookie 的到期时间的函数。弃用了现有的 Cookie 超时函数。如需了解详情,请参阅 JS API 文档。
_setVisitorCookieTimeout(cookieTimeoutMillis)
替换了_setCookiePersistence
函数。_setSessionCookieTimeout(cookieTimeoutMillis)
替换了_setSessionTimeout
函数。_setCampaignCookieTimeout(cookieTimeoutMillis)
替换了_setCookieTimeout
函数。
-
发布了异步 GA 代码段。如需了解如何试用,请参阅这份文档。
-
_setVar
函数现已弃用。自定义变量功能替换了_setVar
。如需了解详情,请参阅这份文档。
发行版本 2009-11(发行日期:2009 年 11 月 4 日)
在此版本中:
-
新增了一个函数,用于检索访问者一级的自定义变量。如需了解详情,请参阅这份函数文档。
_getVisitorCustomVar(index)
-
执行 ga.js 时将立即加载网站内点击量分布图内容,而不是等待 window.onload。
发行版本 2009-10(发行日期:2009 年 10 月 14 日)
此版本新增了一项功能:
-
_addOrganic
函数中新增了可选的布尔值参数,以指定自然来源列表的开头和结尾是否添加了新的自然来源。如需了解详情,请参阅这份文档。_addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)
发行版本 2009-09(发行日期:2009 年 9 月 28 日)
此版本进行了一些性能改进和重构方面的常规维护。公开 API 或功能没有变化。
发行版本 2009-08(发行日期:2009 年 8 月 31 日)
此版本修复了多个问题并改进了性能:
- 在与链接器功能(即:
_link
和_linkByPost
函数)一起使用时,会对自然搜索的搜索字词、(utmp) 的网页路径信息以及用户指定的值进行正确的编码。 - 自然搜索列表中新增了搜索引擎 Rambler。
- 更正了搜索引擎 http://kvasir.no 的自然搜索解析。
- 现在会将用户定义的新自然搜索引擎添加到列表顶部。
- 移除了已弃用的
_trackEvent(action, label, value)
函数,取而代之的是_trackEvent(category, action, label, value)
。 - 现在保存引荐来源网址时将区分大小写。例如:www.domain.com/PaGe.HtMl 在报告时将包含大小写信息。
- 新增了 GASO 令牌大小不得超过 1200 个字符的限制。
- 新增了允许替换 Cookie 的默认超时的函数:
_setCookiePersistence(timeout)