Google Analytics(分析)网络跟踪 (ga.js) 变更日志

为了提供新功能和修复以前版本中发现的缺陷,我们会定期更新 Google Analytics(分析)JavaScript 跟踪代码 (ga.js)。

本页记录了对 ga.js 跟踪代码所做的任何变更。我们建议您定期查看此列表,及时掌握最新信息。您还可以通过下文订阅一节中列出的 Feed 订阅变更内容。

请注意,您和您的用户可能无法立即看到经过更新的 ga.js 跟踪代码,因为:

  • 变更会在数天的时间里通过 Google 的全球数据中心基础架构逐步推出。
  • 您网站的用户可能会在浏览器中缓存旧版 JavaScript。

订阅相关更新日志

包括所有数据收集、配置和报告 API。

包括网络跟踪(ga.js 和 analytics.js)、Android SDK、iOS SDK 和 Measurement Protocol。

  • 现已弃用所有不包含有效跟踪 ID 的匹配。
  • 现已正确地将 Yahoo 安全搜索归类为自然来源。
  • 新增了对于不带前缀的预呈现 API 的支持。除了 Chrome 之外,现在也可以在 IE11 中使用预呈现。
  • 维护版本。

以下更改已推送至最新版的跟踪代码:

  • 新增了对采用 _set 指定本地货币的支持,例如 gaq.push(['_set', 'currencyCode', 'EUR'])

以下更改已推送至最新版的跟踪代码:

  • 允许的网站速度采样率上限 (_setSiteSpeedSampleRate) 已从 10% 增加至 100%。
  • _setAccount 方法现在会去除开头和结尾的所有空格。

以下更改已推送至最新版的跟踪代码:

  • 更新了默认检测到的自然搜索引擎列表。新增了“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”。

以下更改已推送至最新版的跟踪代码:

  • 自定义变量长度的上限已从 64 个字符增加至 128 个字符。此外,现在需要先检查变量长度,然后再进行网址编码。
  • 放宽了事件命中的速率限制。您现在每秒可以发送 10 次命中,还有 1 次额外的命中(以前限制为每 5 秒 1 次命中)。请注意,每次会话 500 次命中这一限制仍然适用。
  • __utmv Cookie 现在采用其他变量分隔符(脱字符号,而非英文逗号)进行编写,以便与 RFC 兼容。这应该可以解决一些与客户遇到的 Cookie 编码问题相关的问题。

网站速度数据收集方面的更改:

  • 现在,系统会以 1% 的采样率自动收集所有网络媒体资源的网站速度数据。现已弃用 _trackPageLoadTime 函数,此前需要选择该函数才可以收集网站速度数据。
  • 新增了可调整默认采样率的 _setSiteSpeedSampleRate 函数。
  • 如果 _trackPageview 调用中使用了虚拟路径,则现在还可以将该路径与从该页面中收集的任何网站速度数据关联起来。

此版本新增了以下功能:

  • 通过将 _trackEvent() 方法的新 opt_noninteraction 参数设置为 true,可以将事件标记为非互动。将事件标记为非互动意味着,来自该标记事件的点击将不会影响跳出率。如需了解详情,请参阅 ga.js 参考

此版本修复了以下问题:

  • 修复了通过内部网站链接传递 AdWords gclid 网址参数可能导致付费访问次数虚增的问题。

此版本修复了可能导致一些网站的访问次数虚增和/或新访客数量减少的问题。访问次数虚增影响的主要是具有与特定用户行为相关的自然流量的网站,而新访客数量减少只会影响那些使用不受支持的、拥有多个跟踪器的跟踪配置的网站。

会话计算方面的变化:

  • 每个会话一个广告系列:如果在现有会话期间启动了新广告系列,那么现在的跟踪脚本将自动启动新会话。更改以下任一字段都会触发新的广告系列:广告系列 ID、名称、来源、媒介、字词、内容或 gclid。
  • 如果用户关闭浏览器,则跟踪脚本不再启动新的会话。

跨网域跟踪方面的变化:

  • 配置跨网域跟踪时,不再需要调用 _setAllowHash(false)。已包含 _setAllowHash(false) 调用的页面将继续正常显示,但在设置新网站时不再需要进行调用。
  • 跟踪脚本现在会尝试修复被 HTTP 重定向器和浏览器损坏的链接器参数。在当前由于重定向器和浏览器引入的编码变化而被废弃的链接器值中,跟踪脚本应该可以修复成功并接受其中大约 85% 的值。

此版本新增了一项功能:

  • 跟踪代码现在会推迟相关预呈现页面的命中,直到用户查看这些页面。如果用户一直没有查看预呈现页面,则不发送命中。此功能仅面向使用异步跟踪脚本的网站提供。您可以通过 Google 网站站长中心博客详细了解预呈现。

此版本修复了各种问题并进行了重构,还新增了一项功能:

此版本修复了以下问题:

  • 修复了跨网域跟踪中的一个问题,该问题在一些情况下会导致广告系列数据出现错误的编码。
  • 修复了跨网域跟踪中的一个问题,该问题会导致系统多次从网址中加载 Cookie,在一些情况下这会导致出现不正确的 Cookie。
  • 修复了自定义变量中的一个问题,该问题会导致对报告中的一些值进行编码。

此版本进行了一些常规维护,包括修复了几个问题和进行重构。公开 API 或功能没有变化。

此版本进行了一些更新,并新增了一项功能。

  • POST 支持:

    • 跟踪代码现在可以发送更大的跟踪信标。信标一直以来都是通过 HTTP GET 请求发送的,一些浏览器和代理会将请求限制在 2048 个字符以内。超出此限制的请求将被丢弃,因此相关数据永远不会到达 Google Analytics(分析)。从此版本开始,超过 2048 个字符的请求将通过 HTTP POST 发送,因此没有这种限制了。跟踪代码现在支持最多 8192 个字符的信标。

此版本修复了以下问题:

  • 修复了在第一次访问网站时阻止 _addIgnoredOrganic_addIgnoredRef 正常工作的问题。
  • 修复了一个与跨多个 iframe 运行的跟踪代码有关的问题。

此版本进行了一些常规维护,包括修复了几个问题和进行重构。公开 API 或功能没有变化。

此版本修复了几个问题,并进行了 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 的变化,请参阅跟踪器参考

此版本更新了默认的搜索引擎列表,并新增了控制 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。如需了解详情,请参阅这份文档

在此版本中:

  • 新增了一个函数,用于检索访问者一级的自定义变量。如需了解详情,请参阅这份函数文档

    • _getVisitorCustomVar(index)
  • 执行 ga.js 时将立即加载网站内点击量分布图内容,而不是等待 window.onload。

此版本新增了一项功能:

  • _addOrganic 函数中新增了可选的布尔值参数,以指定自然来源列表的开头和结尾是否添加了新的自然来源。如需了解详情,请参阅这份文档

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

此版本进行了一些性能改进和重构方面的常规维护。公开 API 或功能没有变化。

此版本修复了多个问题并改进了性能:

  • 在与链接器功能(即:_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)