Google Analytics (分析) 網頁追蹤 (ga.js) 變更記錄

我們會定期更新 Google Analytics (分析) JavaScript 追蹤程式碼 (ga.js),以便提供新功能及修復先前版本中發現的瑕疵。

本頁面記錄 ga.js 追蹤程式碼的所有變更。建議您定期查看這份清單,掌握最新的公告。您也可以透過下方訂閱部分下方的動態消息訂閱變更。

請注意,您和使用者可能無法立即看到新版 ga.js 追蹤程式碼,原因如下:

  • 相關變更會在數天內逐步在 Google 的全球資料中心基礎架構中發布。
  • 您網站的使用者可能已經在瀏覽器中快取舊版 JavaScript。

訂閱相關變更記錄

包含所有 Collection、Configuration 和 Reporting API。

包括 Web 追蹤 (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」和「incresearch.com」這所有原本是「incredimail.com」

下列變更已推送至最新版的追蹤程式碼:

  • 自訂變數的長度上限已從 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 要求傳送,但某些瀏覽器和 Proxy 的長度上限為 2048 個字元。系統已捨棄超出這個上限的要求,且資料從未達到 Google Analytics (分析)。從這個版本開始,系統將透過 HTTP POST 傳送超過 2048 個字元的要求,但不適用上述限制。追蹤程式碼現在支援最多 8192 個字元的信標。

這個版本修正了下列錯誤。

  • 修正導致 _addIgnoredOrganic_addIgnoredRef 無法在首次造訪網站時正常運作的錯誤。
  • 修正在多個 iframe 中執行追蹤程式碼的相關問題。

這個版本包含定期維護,包括錯誤修正和重構。公用 API 或功能將維持不變。

這個版本包含錯誤修正並清除 API。

  • 修正錯誤:

    • 修正事件追蹤錯誤。不必再先呼叫 _initData_trackPageview 即可撥打 _trackEvent
    • 更新非同步程式碼片段,使其可以順利放置在任何網頁上,而不會造成 IE 6 和 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 逾時的新函式。此外,我們還推出了非同步 Google Analytics (分析) 程式碼片段,以縮短 ga.js 延遲對網頁的影響。

  • 更新預設搜尋引擎清單

    • 新增 Naver、Eniro 和 Daum 搜尋引擎。
    • 已將 Looksmart、Gigablast、 Club-internet、Netsprint、Intera、Nostrum 和 Ilse 從清單中移除。
  • 新增函式,用於控制所有已儲存 Cookie 的 Cookie 到期時間。淘汰了現有的 Cookie 逾時函式。詳情請參閱 JS API 說明文件

    • _setVisitorCookieTimeout(cookieTimeoutMillis) 會取代 _setCookiePersistence 函式。
    • _setSessionCookieTimeout(cookieTimeoutMillis) 會取代 _setSessionTimeout 函式。
    • _setCampaignCookieTimeout(cookieTimeoutMillis) 會取代 _setCookieTimeout 函式。
  • 推出非同步 Google Analytics (分析) 程式碼片段。請參閱說明文件,瞭解如何試用這項工具。

  • _setVar 函式已淘汰。自訂變數功能取代了 _setVar。詳情請參閱說明文件

這個版本包含:

  • 新增函式,用於擷取訪客層級自訂變數。詳情請參閱函式說明文件

    • _getVisitorCustomVar(index)
  • 網站內重疊廣告內容會在執行 ga.js 時立即載入,而不會等待 window.onload。

這個版本包含新功能:

  • _addOrganic 函式中加入選用的布林值參數,指定是否要將新的自然來源加到自然來源清單的開頭或尾端。詳情請參閱說明文件

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

這個版本包含定期維護,以提升效能及重構。公用 API 或功能將維持不變。

這個版本修正了多項錯誤並提升執行效能:

  • 針對自然搜尋的搜尋字詞、網頁路徑資訊 (utmp) 和使用者定義的值 (例如 _link_linkByPost 函式) 進行正確的編碼。
  • 隨機搜尋清單中新增了搜尋引擎 Rambler
  • 修正搜尋引擎 http://kvasir.no 的自然搜尋剖析
  • 使用者定義的新自然搜尋引擎現在會列在清單頂端
  • 已移除淘汰的 _trackEvent(action, label, value) 函式,並替換為 _trackEvent(category, action, label, value)
  • 儲存推薦連結來源網址時,區分其大小寫;舉例來說,系統回報的 www.domain.com/PaGe.HtMl 中會包含大小寫資訊。
  • 限制 GASO 權杖大小最多可為 1200 個字元
  • 新增函式,允許覆寫 Cookie 的預設逾時設定:_setCookiePersistence(timeout)