Google Analytics (分析) - 所有 API 變更記錄

本頁面說明對所有 Google Analytics (分析) API 和 SDK 所做的變更。當中包含所有集合、報表和設定的變更記錄。建議您定期查看這份清單，掌握最新的公告。您也可以透過下方訂閱部分下方的動態饋給訂閱變更。

訂閱相關變更記錄

所有 Google Analytics (分析) API 變更記錄
–
訂閱 rss

包含所有 Collection、Configuration 和 Reporting API。

這是 User Activity API 的初始版本

  • User Activity API 可讓您擷取特定日期範圍內與單一 Client-ID 或 User ID 相關的所有資料。這項工具主要用於支援資源擁有者，方便系統直接向該使用者自動存取使用者資料。詳情請參閱 User Activity API 指南。

Management API 中的使用者資料保留設定

您現在可以透過程式化的方式，使用WebProperty 資源內新增的「datakeepTtl」和「datareservationResetOnNewActivity」欄位，以程式輔助方式調整使用者資料保留設定。

這是 User Deletion API 的初始版本：

  • User Deletion API 可讓 Google Analytics (分析) 客戶從專案或網站資源中刪除特定使用者的資料。您可以透過 Firebase 專案或 Google Analytics (分析) 資源提出使用者刪除要求。詳情請參閱「User Deletion API 總覽」一文。

Management API 中的寫入作業

針對網站資源、資料檢視 (設定檔) 和目標資源，使用 Management API 的寫入作業 (例如建立、更新、刪除、修補) 不再需要加入許可清單。Management API 中所有寫入作業的預設每日限制為每天 50 次寫入作業。詳情請參閱「限制與配額」頁面。

這個版本推出後，所有 Analytics (分析) 360 (Premium) 客戶都可以使用 Google Analytics Reporting API v4 的資源型配額系統。

這個版本導入了 Analytics Real Time API 配額與限制的異動。

Analytics (分析) Real Time Reporting API 呼叫促成的單次資料檢視 (設定檔) 每日呼叫數量上限，與其他 Analytics (分析) API 呼叫相比。現在，Analytics (分析) Real Time Reporting API 呼叫會分開計算。也就是說，您可以使用 Analytics (分析) Real Time Reporting API，每天呼叫 10,000 次呼叫，同時使用任何其他 Analytics (分析) API，每天再呼叫 10,000 次。詳情請參閱限制與配額頁面。

這項變更提供更精細且安全失敗的配額管理方式，因此使用 Analytics Real Time Reporting API 經常發出的呼叫不會意外封鎖在當天剩餘時間內，其他所有的 Analytics (分析) API 呼叫。

這個版本會提高 Analytics Reporting API v4 結果集傳回的列數上限。

Analytics Reporting API v4 ReportData 物件中傳回的列數上限已從 10,000 增加到 100,000 列。

這個版本為 Google Analytics Reporting API v4 新增資源型配額系統預先發布版，可為 Analytics (分析) 360 (Premium) 客戶使用更高的取樣門檻。

已新增「android-app://」網址，做為有效的參照連結網址來源。

這個版本淘汰了「相關產品」功能以及相關維度和指標；如需完整的定義清單，請參閱維度和指標參考資料。參閱資料淘汰政策，進一步瞭解資料移除作業：

這個版本淘汰了下列維度和指標：

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

這個版本在 API 中新增了維度；如需完整的定義清單，請參閱維度和指標參考資料。這個版本也移除了數個已淘汰的維度和指標；請參閱 Google Analytics (分析) API 資料淘汰政策，瞭解完整的資料移除程序。

時間

  • 新維度 ga:dateHourMinute，結合了 ga:date、ga:hour 和 ga:minute。

資料移除

這個版本移除下列已淘汰的維度和指標：

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

這個版本會更新 API 中的現有指標和維度。如需完整的定義清單，請參閱維度和指標參考資料。

使用者指標

我們更新了「使用者」和「活躍使用者」指標的計算方式，以便提高使用者人數的計算效率。您可能會發現指標有些微變化。詳情請參閱使用者指標識別使用者的方式一文。

受計算更新影響的使用者指標：

  • ga:users：指定時間範圍內的使用者總數。
  • ga:1dayusers - 在指定的時間範圍內，每天的 1 天活躍使用者總數。
  • ga:7dayusers - 在指定的時間範圍內，每天的 7 天活躍使用者總數。
  • ga:14dayusers - 在指定的時間範圍內，每天的 14 天活躍使用者總數。
  • ga:30dayusers - 在指定的時間範圍內，每天的 30 天活躍使用者總數。

不重複事件

我們即將結束 ga:uniqueEvents 的淘汰時間。2017 年 3 月 26 日後，系統會更新 ga:uniqueEvents 的定義，並將不公開的 ga:uniqueEventsTemporary 指標從 API 中移除。詳情請參閱不重複事件說明文件。

這個版本在 API 中加入了新維度、改善錯誤訊息，並開始實施先前公告的 AdSense 維度和指標異動。

使用者維度

  • 維度 - ga:userBucket：對於任何特定使用者，「使用者區間」維度 (值 1 到 100) 代表使用者獲派的值區。詳情請參閱「測試再行銷廣告活動」一文。

錯誤訊息

先前 API 在要求包含不符合條件的資料時，會傳回錯誤錯誤訊息 (Unknown dimension(s): 或 Unknown metric(s):)，API 現在會傳回以下訊息：Restricted metric(s): ... can only be queried under certain conditions.

AdSense 維度和指標

未連結 AdSense 的資料檢視將會限制查詢 AdSense 維度和指標。使用非 AdSense 已連結的資料檢視查詢這些維度和指標時，會導致錯誤。

自訂指標

這個版本修正了錯誤，修正在未設定 min_value 的情況下，建立 TIME 類型的自訂指標會失敗。不含 min_value 的要求現在會建立自訂指標，並將 min_value 預設為 0。

這個版本修正了 AdSense 維度和指標的問題，並公告這些維度和指標的近期異動。

AdSense 維度和指標

這個版本修正了自 2017 年 1 月 7 日起發生的問題；如果在未連結 AdSense 的資料檢視上查詢 AdSense 維度和指標，系統會傳回「不明指標」錯誤。

近期異動

自 2017 年 1 月 31 日起，非 AdSense 已連結的資料檢視將無法查詢 AdSense 維度和指標。使用非 AdSense 已連結的資料檢視查詢這些維度和指標時，會導致錯誤。

這個版本在 API 中加入下列新指標。如需完整的定義清單，請參閱維度和指標參考資料。

計算指標

這個版本新增計算指標支援功能。

  • 指標 - ga:calcMetric_ - 要求的計算指標值，其中 是指使用者定義的計算指標名稱。請注意，ga:calcMetric_ 的資料類型可以是 FLOAT、INTEGER、CURRENCY、TIME 或 PERCENT。詳情請參閱關於計算指標一文。

這個版本在 API 中加入新指標。此外，現有指標也會淘汰。如需完整的定義清單，請參閱維度和指標參考資料。

事件追蹤

ga:uniqueEvents 的定義將更準確地反映不重複事件的數量。為了影響這項異動，我們將根據資料淘汰政策，嚴格淘汰目前的「ga:uniqueEvents」指標。如果您想要試用新的定義，可以參考私人指標 ga:uniqueEventsTemporary，這會更準確地計算不重複事件的數量。我們也將推出新的指標 ga:uniqueDimensionCombinations，保留 ga:uniqueEvents 目前的定義。適當的淘汰期 (約 6 個月) 後，系統會移除私人指標「ga:uniqueEventsTemporary」，原始指標「ga:uniqueEvents」將正確反映不重複事件的數量。詳情請參閱不重複事件說明文件。

不重複事件

  • 指標 - ga:uniqueEvents - ga:uniqueEvents 的定義不久後將有異動，以更準確地反映不重複事件的數量。如要保留現有的定義，請改用 ga:uniqueDimensionCombinations。詳情請參閱不重複事件說明文件。
  • 指標 - ga:uniqueDimensionCombinations - 不重複維度組合會計算報表中每個維度的不重複維度/值組合數量。這麼做可讓您在後續處理建立組合 (串連的) 維度後，就更靈活地製作報表，而不需要更新追蹤導入項目或使用其他自訂維度版位。詳情請參閱不重複事件說明文件。

轉換測試 - 私人

  • 指標 - ga:uniqueEventsTemporary：不重複事件數量，這是 ga:uniqueEvents 的新定義。在異動生效前，您可以利用這項指標瞭解新的定義。請注意，這項指標是私人指標，不會顯示在維度和指標參考資料中。

這個版本包含：

Google Analytics (分析)

  • 修正 iOS 10 相容性及修正錯誤。

這個版本包含：

Google Analytics (分析)

  • 修正當機問題。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

DoubleClick Bid Manager

  • 維度 - ga:dbmClickAdvertiser - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告主名稱 (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickAdvertiserId - DBM 點擊與 Google Analytics (分析) 工作階段相符的 DBM 廣告主 ID (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickCreativeId - DBM 點擊與 Google Analytics (分析) 工作階段相符的 DBM 廣告素材 ID (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickExchange - 與 Google Analytics (分析) 工作階段相符之 DBM 點擊的 DBM 廣告交易平台名稱 (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickExchangeId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊的 DBM 廣告交易平台 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmClickInsertionOrder - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告訂單名稱 (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickInsertionOrderId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 DBM 廣告訂單 ID (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickLineItem - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊的 DBM 委刊項名稱 (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickLineItemId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊的 DBM 委刊項 ID (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickSite：在與 Google Analytics (分析) 工作階段相符的 DBM 點擊上，顯示並點擊 DBM 廣告素材的 DBM 網站名稱 (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmClickSiteId：與 Google Analytics (分析) 工作階段相符的 DBM 點擊，顯示並點擊 DBM 廣告素材的 DBM 網站 ID (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventAdvertiser - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告主名稱 (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventAdvertiserId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告主 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventCreativeId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告素材 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventExchange - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告交易平台名稱 (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventExchangeId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告交易平台 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventInsertionOrder - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告訂單名稱 (僅限 Analytics (分析) 360，必須與 DBM 整合)。
  • 維度 - ga:dbmLastEventInsertionOrderId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 廣告訂單 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventLineItem - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 委刊項名稱 (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventLineItemId - 與 Google Analytics (分析) 工作階段相關聯的最終 DBM 事件 (亦即 DBM 回溯期內曝光或點擊) 的 DBM 委刊項 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventSite：針對與 Google Analytics (分析) 工作階段相關聯的最後一個 DBM 事件 (亦即 DBM 回溯期內的曝光或點擊)，顯示並點擊 DBM 廣告素材的 DBM 網站名稱 (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 維度 - ga:dbmLastEventSiteId：與 Google Analytics (分析) 工作階段相關聯的最後一個 DBM 事件 (亦即 DBM 回溯期內的曝光或點擊)，且顯示並點擊 DBM 廣告素材的 DBM 網站 ID (僅限 Analytics (分析) 360，須與 DBM 整合)。
  • 指標 - ga:dbmCPA - DBM 有效每次獲益成本收益 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmCPC - DBM 有效單次點擊出價收益 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmCPM - DBM 有效千次曝光出價收益 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmCTR - DBM 點閱率 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmClicks - DBM 點擊總數 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmConversions - DBM 轉換總數 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmCost - DBM 費用 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmImpressions - DBM 曝光總數 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 指標 - ga:dbmROAS - DBM 廣告投資報酬率 (僅限 Analytics (分析) 360，需與 DBM 整合)。
  • 維度 - ga:dsAdGroup - DS 廣告群組 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsAdGroupId - DS 廣告群組 ID (僅適用於 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsAdvertiser - DS 廣告主 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsAdvertiserId - DS 廣告主 ID (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsAgency - DS 代理商 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsAgencyId - DS 代理商 ID (僅適用於 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsCampaign - DS 廣告活動 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsCampaignId - DS 廣告活動 ID (僅適用於 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsEngineAccount - DS 引擎帳戶 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsEngineAccountId - DS 引擎帳戶 ID (僅適用於 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsKeyword - DS 關鍵字 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • 維度 - ga:dsKeywordId - DS 關鍵字 ID (僅適用於 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsCPC - DS 點擊向廣告客戶的費用 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsCTR - DS 點閱率 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsClicks - DS 點擊 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsCost - DS 費用 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsImpressions - DS 曝光 (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsProfit - DS Profie (僅限 Analytics (分析) 360，必須與 DS 整合)。
  • ga:dsReturnOnAdSpend - DS 廣告投資報酬率 (僅限 Analytics (分析) 360，需與 DS 整合)。
  • ga:dsRevenuePerClick - DS 單次點擊收益 (僅限 Analytics (分析) 360，必須與 DS 整合)。

這個版本在 API 中加入新維度。如需完整的定義清單，請參閱維度和指標參考資料。

交易 ID

  • 維度 - mcf:transactionId：購物車中的購物交易編號 (由電子商務追蹤方式提供)。

這個版本在 API 中加入新維度。這個版本也會針對可一起評估的維度組合新增特定限制。如需完整的定義清單，請參閱維度和指標參考資料。

地理位置網路

  • 維度 - ga:continentId - 衍生自使用者的 IP 位址或地理區域 ID 的使用者洲別 ID。

限制

無法使用其他群組中的維度查詢下列群組中的下列維度：

  • 前往購物資訊群組
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO 實驗群組
    • ga:experimentVariant
    • ga:experimentId
  • 興趣群組
    • ga:interestOtherCategory
  • 潛在目標消費者興趣群組
    • ga:interestInMarketCategory
  • 內部促銷活動群組：
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • 品牌興趣群組：
    • ga:interestAffinityCategory

這個版本加入了新的限制和配額。詳情請參閱限制與配額說明文件。

回報錯誤

這個版本開始對失敗 (5XX) 的檢舉要求強制執行限制。

  • 每個專案每小時每個設定檔 10 個失敗的要求。
  • 每個專案每天每個設定檔 50 個失敗的要求。

資料透視限制

這個版本開始強制執行資料透視要求的限制：

  • 報表要求現在最多可有 2 個資料透視。
  • 資料透視最多可以有 4 個維度。
  • 資料透視維度是要求中允許的維度總數限制的一部分。
  • 資料透視metrics是要求中允許的指標總數限制的一部分。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

地理位置網路

  • 維度 - ga:metroId - 帶來流量的來源三位數「指定行銷區域」(DMA) 代碼，衍生自使用者的 IP 位址或地理區域 ID。

DoubleClick for Publishers

  • 指標 - ga:dfpImpressions - 每當網站上出現個別廣告，系統就會回報一次 DFP 廣告曝光。舉例來說，如果網頁上有兩個廣告單元，且檢視一次，系統就會顯示兩次曝光 (已啟用 DFP 連結，並隱藏未啟用 DFP 收益)。
  • 指標 - ga:dfpCoverage - 涵蓋率是指有多少百分比的廣告請求傳回了至少一則廣告。一般來說，涵蓋率有助於找出 DFP 帳戶無法放送指定廣告的網站。(廣告曝光次數 / 廣告請求總數) * 100 (已啟用 DFP 連結，並隱藏未啟用 DFP 的收益)。
  • 指標 - ga:dfpMonetizedPageviews - 這一欄會針對已連結 DFP 帳戶中的廣告，評估其資源網頁瀏覽量。請注意，單一網頁可包含多個廣告單元 (已啟用 DFP 連結，並隱藏未啟用 DFP 收益)。
  • 指標 - ga:dfpImpressionsPerSession - DFP 廣告曝光次數與 Analytics (分析) 工作階段數的比率 (廣告曝光次數 / Analytics (分析) 工作階段數) (已啟用 DFP 連結，並隱藏未啟用 DFP 的收益)。
  • 指標 - ga:dfpViewableImpressionsPercent - 可視廣告曝光的百分比。如果曝光出現在使用者的瀏覽器內，且有機會看見，就算一次可視曝光 (已啟用 DFP 連結和隱藏 DFP 收益)。
  • 指標 - ga:dfpClicks - 網站上 DFP 廣告獲得點擊的次數 (已啟用 DFP 連結，並隱藏 DFP 收益未啟用)。
  • 指標 - ga:dfpCTR - 引發點擊 DFP 廣告的網頁網頁瀏覽量百分比 (已啟用 DFP 連結，並隱藏 DFP 收益)。
  • 指標 - ga:dfpRevenue - DFP 收益是根據放送的曝光次數 (已啟用 DFP 連結和隱藏 DFP 收益功能) 估算的廣告收益總額。」
  • 指標 - ga:dfpRevenuePer1000Sessions - 每 1,000 個 Analytics (分析) 工作階段的 DFP 廣告帶來的預估總收益。請注意，這個指標是依據網站的工作階段來計算，而不是廣告曝光 (已啟用 DFP 連結，並隱藏 DFP 收益)。
  • 指標 - ga:dfpECPM - 每千次網頁瀏覽量的有效費用。而是每 1,000 次網頁瀏覽的 DFP 收益 (已啟用 DFP 連結，並隱藏 DFP 收益)。
  • 指標 - ga:backfillImpressions - 補充曝光次數是指透過 DFP 放送候補廣告的所有 AdSense 或廣告 Exchance 廣告曝光總和。每當網站上出現個別廣告，系統就會記錄一次廣告曝光。舉例來說，如果網頁上有兩個廣告單元，且檢視一次，系統就會顯示兩次曝光 (已啟用 DFP 連結，並隱藏未啟用 DFP 收益)。
  • 指標 - ga:backfillCoverage - 候補廣告涵蓋率是指傳回至少一則廣告的候補廣告廣告請求百分比。一般來說，涵蓋率有助於找出發布商帳戶無法放送指定廣告的網站。(廣告曝光次數 / 廣告請求總數) * 100。如果 AdSense 和 Ad Exchange 都提供候補廣告，這項指標是兩個候補廣告帳戶 (已啟用 DFP 連結，未啟用 DFP 收益) 的加權平均值。
  • 指標 - ga:backfillMonetizedPageviews - 這是指資源上出現至少一則來自已連結候補廣告帳戶中的廣告時，該資源上的網頁瀏覽量總次數。請注意，一次營利網頁瀏覽可能會包含多個廣告曝光 (已啟用 DFP 連結，並隱藏未啟用 DFP 收益)。
  • 指標 - ga:backfillImpressionsPerSession：候補廣告曝光次數與 Analytics (分析) 工作階段的比率 (廣告曝光次數 / Analytics (分析) 工作階段數)。如果 AdSense 和 Ad Exchange 都提供候補廣告，則這項指標是兩個候補廣告帳戶 (已啟用 DFP 連結，未啟用 DFP 收益) 的總和。」
  • 指標 - ga:backfillViewableImpressionsPercent - 可見的候補廣告曝光次數百分比。使用者可能在瀏覽器中看到的曝光，就算是可視曝光。如果 AdSense 和 Ad Exchange 都同時提供候補廣告，則這項指標是兩個候補廣告帳戶 (已啟用 DFP 連結，未啟用 DFP 收益) 的加權平均值。
  • 指標 - ga:backfillClicks - 候補廣告網站上獲得點擊的次數。如果 AdSense 和 Ad Exchange 都提供候補廣告，則這項指標是兩個候補廣告帳戶的總和 (已啟用 DFP 連結，而「隱藏未啟用 DFP 收益」指標)。
  • 指標 - ga:backfillCTR：促成廣告點擊的候補廣告曝光次數百分比。如果 AdSense 和 Ad Exchange 都同時提供候補廣告，則這項指標是兩個候補廣告帳戶 (已啟用 DFP 連結，未啟用 DFP 收益) 的加權平均值。
  • 指標 - ga:backfillRevenue - 候補廣告的總預估收益。如果 AdSense 和 Ad Exchange 都提供候補廣告，則這項指標是兩個候補廣告帳戶的總和 (已啟用 DFP 連結，而「隱藏未啟用 DFP 收益」指標)。
  • 指標 - ga:backfillRevenuePer1000Sessions：每 1,000 個 Analytics (分析) 工作階段，候補廣告產生的總收益。請注意，這個指標是以網站的工作階段 (而非廣告曝光) 為依據。如果 AdSense 和 Ad Exchange 都提供候補廣告，則這項指標是兩個候補廣告帳戶 (已啟用 DFP 連結，未啟用 DFP 收益) 的總和。」
  • 指標 - ga:backfillECPM - 每千次網頁瀏覽量的有效費用。這就是「 DFP 候補廣告收益」，也就是每 1,000 次網頁瀏覽的收益。如果 AdSense 和 Ad Exchange 都提供候補廣告，則這項指標是兩個候補廣告帳戶 (已啟用 DFP 連結，未啟用 DFP 收益) 的總和。」

這個版本新增 addedInApiVersion 屬性。

已新增至 API 版本

這個版本宣布了新版 API，即 Analytics Reporting API V4。這個新的 API 是最先進的程式輔助方法，可在 Google Analytics (分析) 中存取報表資料。

主要功能

Google Analytics (分析) 是功能強大的資料報表基礎架構，開發人員可以透過這個 API 使用 Google Analytics (分析) 平台的強大功能。Analytics Reporting API 第 4 版的部分主要功能如下：

  • 指標運算式 - 這個 API 不僅可讓您要求內建指標，也可以要求數學的指標運算式。舉例來說，單次工作階段的目標達成數可在要求中以 ga:goal1completions/ga:sessions 表示。
  • 多個日期範圍 - 支援要求兩個日期範圍，方便您比較單一要求中兩個時段的資料。
  • 同類群組和生命週期價值 - 這個 API 提供豐富的詞彙，可用於要求「同類群組」和「生命週期價值」報表。
  • 多個區隔 - 現在您可以在單次要求中要求多個區隔。

入門課程

如需開始使用 API 的所有詳細資訊，請參閱開發人員文件。

配額政策

Analytics Reporting API 4 有專屬的配額與限制；由於這是新的 API，這些限制和配額可能隨時會有變動。

遷移

除了遷移指南外，我們也在 GitHub 上提供了 Python 相容性程式庫。

維度和指標

這個版本也加入了一組 Analytics Reporting API 第 4 版專用的維度和指標。如需完整清單，請參閱維度和指標多層檢視。

  • 維度 - ga:cohort：使用者所屬的同類群組名稱 (以同類群組定義為依據)。視同類群組的定義方式而定，使用者可同時屬於多個同類群組，類似使用者屬於多個區隔的方式。

  • 維度 - ga:cohortNthDay - 相對於同類群組定義日期的 0 天偏移。舉例來說，如果同類群組是將首次造訪日期定義為 2015 年 9 月 1 日，則 2015-09-04 當天的 ga:cohortNthDay 就是 3。

  • ga:cohortNthMonth - 相對於同類群組定義日期，在 0 個月內偏移。

  • 維度 - ga:cohortNthWeek - 相對於同類群組定義日期的 0 週前差。

  • 維度 - ga:acquisitionTrafficChannel - 招攬到使用者的流量管道。這個 ID 擷取自使用者的第一個工作階段擷取，流量管道的計算依據為獲取新客時的預設管道分組規則 (如適用，如適用)。

  • 維度 - ga:acquisitionSource - 招攬到使用者的來源。從使用者的第一個工作階段衍生。

  • 維度 - ga:acquisitionMedium - 招攬到使用者的媒介。從使用者的第一個工作階段衍生。

  • 維度 - ga:acquisitionSourceMedium - ga:userAcquisitionSource 和 ga:AcquisitionMedium 的總值。

  • 維度 - ga:acquisitionCampaign 招攬到使用者的廣告活動。從使用者的第一個工作階段衍生。

  • 指標 - ga:cohortActiveUsers - 這項指標與 0 個以偏移量維度 (ga:cohortNthDay、ga:cohortNthWeek 或 ga:cohortNthMonth) 為依據的偏移維度相關，代表該同類群組的第 n 天/週/月落在同類群組中的活躍使用者人數。舉例來說，如果是 ga:cohortNthWeek = 1，則第二週的活躍使用者 (同類群組中) 的人數。如果要求不含 ga:cohortNthDay、ga:cohortNthWeek 或 ga:cohortNthMonth 中任一值，這項指標的值就會與 ga:cohortTotalUsers 相同。

  • 指標 - ga:cohortTotalUsers - 屬於同類群組的使用者人數 (也稱為同類群組大小)。

  • 指標 - ga:cohortAppviewsPerUser - 同類群組中每位使用者的應用程式觀看次數。

  • 指標 - ga:cohortGoalCompletionsPerUser - 同類群組中每位使用者的目標達成數。

  • 指標 - ga:cohortPageviewsPerUser - 同類群組中每位使用者的網頁瀏覽量。

  • 指標 - ga:cohortRetentionRate - 同類群組留存率。

  • 指標 - ga:cohortRevenuePerUser - 同類群組每位使用者的收益。

  • 指標 - ga:cohortVisitDurationPerUser - 同類群組中每位使用者的工作階段持續時間。

  • 指標 - ga:cohortSessionsPerUser - 同類群組中每位使用者的工作階段數。

  • 指標 - ga:cohortTotalUsersWithLifetimeCriteria - 這適用於具有 ga:acquisitionTrafficChannel、ga:acquisitionSource、ga:acquisitionMedium 或 ga:acquisitionCampaign 維度的要求。而是透過目前管道、來源、媒介或廣告活動招攬到的同類群組使用者人數。舉例來說，如果是 ga:acquisitionTrafficChannel=Direct，代表同類群組中直接招攬到的使用者人數。如果上述維度都不存在，則其值等於 ga:cohortTotalUsers。

  • 指標 - ga:cohortAppviewsPerUserWithLifetimeCriteria - 同類群組的獲客維度每位使用者的應用程式觀看次數。

  • 指標 - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria：同類群組的獲客維度每位使用者的目標達成數。

  • 指標 - ga:cohortPageviewsPerUserWithLifetimeCriteria - 同類群組的獲客維度每位使用者的網頁瀏覽量。

  • 指標 - ga:cohortRevenuePerUserWithLifetimeCriteria：同類群組的獲客維度每位使用者的收益。

  • 指標 - ga:cohortSessionsPerUserWithLifetimeCriteria：同類群組客戶開發維度中每位使用者的工作階段持續時間。

社交資料中心維度和指標已淘汰，只會回報 2016 年 4 月 30 日之後的歷來資料，因此不會提供任何新資料。根據資料淘汰政策，這些維度和指標將在 2016 年 9 月 30 日後移除。

如需完整的定義清單，請參閱維度和指標參考資料。

社交活動

這些維度和指標已淘汰，並將在 2016 年 9 月 30 日後移除。參閱資料淘汰政策，進一步瞭解資料移除作業：

  • 維度 - ga:socialActivityEndorsingUrl：如果是社交資料中心活動，這是指社交活動的網址 (例如 Google+ 貼文網址、網誌留言網址等)。
  • 維度 - ga:socialActivityDisplayName：如果是社交資料中心活動，這是指社群網路使用者張貼的社交活動標題。
  • 維度 - ga:socialActivityPost：如果是社交資料中心活動，這是指社交網路使用者發布的社交活動內容 (例如 Google+ 中張貼的訊息內容)。
  • 維度 - ga:socialActivityTimestamp：如果是社交資料中心活動，這是指社交活動在社群網路上的時間。
  • 維度 - ga:socialActivityUserHandle：如果是社交資料中心活動，這是指發起社交活動使用者的社群網路帳號代碼 (例如名稱或 ID)。
  • 維度 - ga:socialActivityUserPhotoUrl：如果是社交資料中心活動，此為與使用者社交網路個人資料相關聯的相片網址。
  • 維度 - ga:socialActivityUserProfileUrl：如果是社交資料中心活動，這是指相關使用者的社交網路個人資料網址。
  • 維度 - ga:socialActivityTagsSummary：如果是社交資料中心活動，這是與社交活動相關的一組代碼，以半形逗號分隔。」
  • 維度 - ga:socialActivityAction：如果是社交資料中心活動，代表與活動相關的社交動作類型 (例如投票、留言、+1 等)。
  • 維度 - ga:socialActivityNetworkAction：如果是社交資料中心活動，這是指社交動作和帶來活動的社群網路。
  • 維度 - ga:socialActivityContentUrl：如果是社交資料中心活動，這是指相關社交網路使用者分享的網址。
  • 指標 - ga:socialActivities：在社交資料中心夥伴聯播網上分享或提及內容網址的活動總數。

這個版本在 API 中加入新維度。如需完整的定義清單，請參閱維度和指標參考資料。

平台或裝置

  • 維度 - ga:browserSize - 使用者瀏覽器的可視區域大小。瀏覽器大小是一種以工作階段為範圍的維度，會擷取可視區域的初始尺寸 (以像素為單位)，並採用「X 高度」的格式。例如 1920x960。

未取樣報表

未取樣報表 API 不再有每日 100 份報表的限制。API 會使用與透過網頁介面建立未取樣報表時一樣，使用「每個資源每日」的權杖系統。

未取樣報表

目前使用者無法存取的未取樣報表，管理 API 回應訊息中不會再出現下載連結。這項行為與 UI 資訊主頁功能一致，因此只有報表擁有者可以查看所產生文件的下載連結。

資料檢視 (設定檔)

這個版本會將 botFilteringEnabled 屬性新增至資料檢視 (設定檔) 資源。這個屬性指出是否已啟用資料檢視 (設定檔) 的漫遊器篩選功能。詳情請參閱查看 (設定檔) 參考資料文件。

未取樣報表

這個版本會將 delete 方法加入未取樣報表。詳情請參閱未取樣報表刪除參考文件。

這個版本包含：

Google Analytics (分析)

  • 沒有變更

Google 代碼管理工具

  • 修正在執行單元測試時會導致異常終止的問題。

路段

本版本用意為修正錯誤。這個版本修正了在呼叫區隔清單方法時，定義中含貨幣值的區隔無法正確顯示的問題。

這個版本在 API 中新增參數。

包括空白列

  • 這個版本新增選用參數 include-empty-rows；如果將這個參數設為 false 列，且不含資料，回應會略過該參數。預設值為 true，這是非破壞性變更，因此不應要求更新程式碼。詳情請參閱 Core Reporting API 參考說明文件。

這個版本包含：

Google Analytics (分析)

  • 已新增位元碼支援。

Google 代碼管理工具

  • 已新增位元碼支援。

這個版本在 API 中加入新指標。如需完整的定義清單，請參閱維度和指標參考資料。

使用者

  • 指標 - ga:1dayUsers - 在指定的時間範圍內，每天的 1 天活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度，才能查詢這個指標。在指定日期內，傳回的值會是截至指定日期為止 1 天內的不重複使用者總數。
  • 指標 - ga:7dayUsers - 在指定的時間範圍內，每天的 7 天活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度，才能查詢這個指標。在指定日期內，傳回的值會是截至指定日期為止 7 天內的不重複使用者總數。
  • 指標 - ga:14dayUsers - 在指定的時間範圍內，每天的 14 天活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度，才能查詢這個指標。在指定日期內，傳回的值會是截至指定日期為止 14 天內的不重複使用者總數。
  • 指標 - ga:30dayUsers - 在指定的時間範圍內，每天的 30 天活躍使用者總數。您必須至少指定一個 ga:nthDay、ga:date 或 ga:day 做為維度，才能查詢這個指標。在指定日期內，傳回的值會是截至指定日期為止 30 天內的不重複使用者總數。

路段

本版本用意為修正錯誤。這個版本修正了一項問題，會導致將私人區隔固定在多個資料檢視 (設定檔) 的使用者呼叫區隔清單方法時收到 500 錯誤回應。

這個版本在 API 中加入新指標。如需完整的定義清單，請參閱維度和指標參考資料。

DoubleClick Ad Exchange (AdX)

  • 指標 - ga:adxCTR - 帶來 AdX 廣告點擊的網頁瀏覽量百分比。
  • 指標 - ga:adxClicks - AdX 廣告在您網站上獲得的點擊次數。
  • 指標 - ga:adxCoverage - 涵蓋率是指有多少百分比的廣告請求傳回了至少一則廣告。一般來說，涵蓋率有助於找出 AdX 帳戶無法放送相關廣告的網站。(廣告曝光次數 / 廣告請求總數) * 100
  • 指標 - ga:adxECPM - 每千次網頁瀏覽量的有效費用。也就是每 1,000 次網頁瀏覽的 AdX 收益。
  • 指標 - ga:adxImpressions - 每次有廣告在您的網站上顯示，系統就會記錄一次 AdX 廣告曝光。舉例來說，當網頁上有兩個廣告單元時，如果使用者檢視該網頁一次，系統就會顯示兩次曝光。
  • 指標 - ga:adxImpressionsPerSession：AdX 廣告曝光次數與 Analytics (分析) 工作階段數的比率 (廣告曝光次數 / Analytics (分析) 工作階段數)。
  • 指標 - ga:adxMonetizedPageviews - 「營利網頁瀏覽」評估的是資源上出現來自已連結 AdX 帳戶的廣告的總網頁瀏覽量。注意：同一個網頁可以有多個廣告單元。
  • 指標 - ga:adxRevenue - AdX 廣告帶來的預估總收益。
  • 指標 - ga:adxRevenuePer1000Sessions：每 1000 個 Analytics (分析) 工作階段的 AdX 廣告總預估收益。請注意，這個指標的計算方式是依照網站的工作階段，而不是廣告曝光。
  • 指標 - ga:adxViewableImpressionsPercent - 可見廣告曝光的百分比。使用者有可能在瀏覽器中看到的曝光，就算是可見曝光。

這個版本會在 Provisioning API TOS 網址新增一個參數：

  • 新增網址參數 provisioningSignup=false，修正了為沒有 Google Analytics (分析) 帳戶的使用者佈建 Google Analytics (分析) 帳戶時會發生的問題。開發人員應更新程式碼，將這個參數加入服務條款網址。

批次處理

在這個版本中，除了一般的批次支援外，我們也為 User Permissions API 新增了特別支援。批次使用者權限要求會大幅提升效能，並降低配額用量。

資料檢視 (設定檔)

這個版本推出後，如果在 insert 作業期間未設定資料檢視 (設定檔) currency 資源，現在會預設為 USD。此外，get 和 list 作業也會針對先前在沒有 currency 資源的情況下建立的資料檢視 (設定檔)，傳回 USD。

這個版本淘汰了現有的維度或指標。如需完整的定義清單，請參閱維度和指標參考資料。

已淘汰的維度

這些維度已淘汰。參閱資料淘汰政策，進一步瞭解資料移除作業：

  • 維度 - ga:adSlotPosition - 改用 ga:adSlot。
  • 維度 - ga:nextPagePath - 改用 ga:pagePath。
  • 維度 - ga:nextContentGroupXX - 改用 ga:contentGroupXX。

這個版本包含：

Google Analytics (分析)

  • 修正使用 setCampaignParametersFromUrl 時會導致當機的問題。問題 636。

Google 代碼管理工具

  • 沒有變更

濾鏡

這個版本將移除淘汰的篩選器欄位 IS_MOBILE 和 IS_TABLET，應替換為 DEVICE_CATEGORY=mobile 和 DEVICE_CATEGORY=tablet。插入、更新及修補要求 (將篩選器欄位設為使用 IS_MOBILE 和 IS_TABLET) 將傳回錯誤。

這個版本包含：

Google Analytics (分析)

  • 沒有變更

Google 代碼管理工具

這個版本在 API 中加入新維度。如需維度和指標的完整清單，請參閱「維度和指標參考資料」一文。

AdWords

  • 維度 - ga:adQueryWordCount：搜尋查詢中的字詞數量。

濾鏡

這個版本支援在所有篩選器詳細資料部分中加入 fieldIndex 屬性，以便將自訂維度用於篩選器欄位。舉例來說，現在可以使用 "field": "CUSTOM_DIMENSION" 和 "fieldIndex": "1" 設定篩選器運算式，讓篩選器在第一個自訂維度上運作。

目標

此版本也修正了使用 "comparisonValue": "0" 建立目標時會失敗的問題。

這個版本包含：

Google Analytics (分析)

  • 新增對非 Google Play 裝置的背景分派支援功能。
  • 已淘汰 Analytics Logger/LogLevel。Analytics (分析) 現在改用 Android 記錄功能。如要啟用偵錯記錄，請執行 adb shell setprop log.tag.GAv4 DEBUG。
  • 進行重構以改善資料提供和安裝廣告活動歸因。
  • 修正廣告活動剖析錯誤。問題 596。
  • Analytics (分析) 初始化作業的第一秒未處理的應用程式例外狀況會正確回報。問題 443。

Google 代碼管理工具

  • 無變更。

這個版本包含：

Google Analytics (分析)

  • 在 iOS 8.0 以上版本中使用 nativeBounds 回報螢幕解析度。以解決 504 問題。
  • 新增對點擊相關廣告活動參數的支援。
  • 回報裝置 OS 版本和 iOS 硬體型號。以解決 408 問題。
  • 回報 iOS 7.1 以上版本的 iAd 安裝歸因資料。這需要 iAd 架構。
  • 針對應用程式檢視畫面命中類型新增淘汰警告。
  • sqlite3 現在是必要的程式庫。

Google 代碼管理工具

  • 修正 TAGDispatcher 中 nil 字串當機的問題。

這個版本包含新增欄位。如需完整的欄位清單，請參閱欄位參考資料。

運輸

  • 傳輸欄位可讓您設定用來傳送命中的機制。

其他異動

  • useBeacon 選項已淘汰。
  • 修正錯誤

這個版本將標示最終終止，並移除 dailyUpload 資源。dailyUpload 資源已於 2014 年 6 月 20 日正式淘汰，現在所有費用資料都應使用上傳資源完成。

這個版本在 API 中加入新維度。如需維度和指標的完整清單，請參閱「維度和指標參考資料」一文。

平台或裝置

  • 維度 - ga:dataSource - 命中的資料來源。從 ga.js 和 analytics.js 傳送的命中會記錄為「網站」，從行動 SDK 傳送的命中則會記錄為「應用程式」。這些值可以覆寫。
  • 維度 - ga:searchAfterDestinationPage - 使用者在網站上執行內部搜尋後造訪的網頁。

這個版本修正了以下錯誤：

  • 這個版本修正了 Real Time Reporting API 查詢中強制執行篩選限制條件的問題。如果要求含有 rt:activeUsers 且依據事件層級維度進行篩選，就會產生錯誤並顯示 badRequest 原因和指出 OR operator not supported for a hit level filter 的訊息。如要進一步瞭解查詢限制，請參閱 Real Time Reporting API 開發人員指南。

這個版本加入了新的命中參數，如需完整的參數清單，請參閱參數參考資料。

資料來源

  • ds 資料來源參數可用來設定命中的資料來源。

這個版本包含新增欄位。如需完整的欄位清單，請參閱欄位參考資料。

資料來源

  • 「資料來源」欄位可讓您設定命中的資料來源。

這個版本加入了新的命中參數，如需完整的參數清單，請參閱參數參考資料。

地理位置覆寫

  • geoid 的「地理覆寫」可讓您明確設定使用者的地理位置。

這個版本在 API 中加入新的維度和指標，並淘汰了兩項現有指標，如需完整的定義清單，請參閱維度和指標參考資料。

ECommerce

  • 指標 - ga:transactionsPerUser：交易總數除以使用者總人數。
  • 指標 - ga:revenuePerUser：交易中提供的總銷售收益 (不含運費和稅金) 除以使用者總人數。

使用者

  • 指標 - ga:sessionsPerUser - 工作階段總數除以使用者總數。

地理位置網路

  • 維度 - ga:cityId - 使用者的城市 ID (取自 IP 位址或地理區域 ID)。
  • 維度 - ga:countryIsoCode - 使用者的國家/地區 ISO 代碼 (由 IP 位址或地理區域 ID 衍生)。值會以 ISO-3166-1 alpha-2 代碼表示。
  • 維度 - ga:regionId - 使用者的區域 ID (由 IP 位址或地理區域 ID 推測)。在美國，區域係指州，例如紐約州。　　
  • 維度 - ga:regionIsoCode - 使用者的區域 ISO 代碼，由 IP 位址或地理區域 ID 衍生。值會以 ISO-3166-2 代碼表示。
  • 維度 - ga:subContinentCode - 使用者的子洲別代碼，由 IP 位址或地理區域 ID 衍生。例如波里尼西亞或北歐。值會指定為 UN M.49 代碼。

DoubleClick Campaign Manager

  • 指標 - ga:dcmROAS - DCM 廣告投資報酬率 (ROAS) (僅限 Premium)。

已淘汰的指標

這些指標已淘汰。詳閱資料淘汰政策，進一步瞭解資料移除作業：+ 指標 - ga:dcmROI - 改用 ga:dcmROAS。+ 指標 - ga:dcmMargen - 請改用 ga:dcmROAS。

如果集合不包含任何資源，則所有集合的 list 方法回應現在會包含 items 屬性的空白清單。過去，回應會省略 items 屬性。請參閱 API 參考資料，瞭解 Google Analytics (分析) 設定資料查詢與回應的完整詳情。

這個版本推出 Google Analytics Management API 的新範圍。- analytics.manage.users.readonly - 查看 Google Analytics (分析) 使用者權限。

新增了 DEVICE_CATEGORY 篩選器欄位，IS_MOBILE 和 IS_TABLET 現已淘汰。使用 DEVICE_CATEGORY=mobile 和 DEVICE_CATEGORY=tablet。

這個版本包含：

Google Analytics (分析)

  • 修正分派信標時無法傳送所有信標的問題。
  • 更新 CuteAnimals 範例應用程式，示範如何在應用程式於背景執行時進行調度。
  • 新增對其他加強型電子商務欄位的支援。
  • 移除針對 iOS SDK 8.0 進行編譯時缺少 GAIHit 和 GAIProperty 類別的警告訊息，且已移除這些類別。
  • 調度信標現已更有效率，可透過單一 HTTPS 要求分派多個信標。
  • 在某些情況下，要求會經過壓縮以節省數據方案用量。

Google 代碼管理工具

  • 淘汰以 TAGContainerFuture 為基礎的 openContainerWithId。在 iOS8 上使用這個 API，如果在 UIAppDelegate 生命週期的某些階段呼叫 get，則會導致系統發生錯誤。
  • 在 Google 通用 Analytics (分析) 代碼的加強型電子商務中，新增自訂指標和自訂維度的支援。
  • 修正加強型電子商務動作包含選用產品的必要產品的錯誤。
  • 支援 Google 通用 Analytics (分析) 代碼的廣告 ID 功能。
  • 更新 CuteAnimals 範例應用程式，示範如何在應用程式於背景執行時傳送資料。

資料檢視 (設定檔) 資源現在包含enhancedECommerceTracking資源，指出「加強型電子商務」是啟用 (true) 還是停用 (false)。

這個版本在 API 中加入新指標，並淘汰兩項現有指標。如需完整的定義清單，請參閱維度和指標參考資料。

AdWords

  • 指標 - ga:ROAS：廣告投資報酬率 (ROAS) 是將總交易收益和目標價值除以衍生廣告費用所得的結果。

已淘汰的維度和指標

這些維度和指標已淘汰。詳閱資料淘汰政策，進一步瞭解資料移除作業：+ 指標 - ga:ROI - 改用 ga:ROAS。+ 指標 - ga:margin - 請改用 ga:ROAS。

這個版本包含新維度。如需完整的定義清單，請參閱維度和指標參考資料。

時間

  • 維度 - rt:minutesAgo：命中發生前的分鐘數。

這個版本在 API 中加入新指標。如需完整的定義清單，請參閱維度和指標參考資料。

AdSense

  • 指標 - ga:adsenseCoverage：傳回至少一則廣告的廣告請求百分比。
  • 指標 - ga:adsenseViewableImpressionPercent - 可見曝光次數的百分比。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

轉換路徑

  • 維度 - mcf:dcmAd - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告名稱。
  • 維度 - mcf:dcmAdPath：以 DCM 廣告表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmAdType - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告類型名稱。
  • 維度 - mcf:dcmAdvertiser - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告主名稱。
  • 維度 - mcf:dcmAdvertiserPath：以 DCM 廣告主表示互動的轉換路徑。
  • 維度 - mcf:dcmCampaign - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告活動名稱。
  • 維度 - mcf:dcmCampaignPath：以 DCM 廣告活動表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmCreative - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告素材名稱。
  • 維度 - mcf:dcmCreativePath：以 DCM 廣告素材表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmCreativeVersion - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告素材版本。
  • 維度 - mcf:dcmCreativeVersionPath：以 DCM 廣告素材版本表示路徑上互動的轉換路徑。
  • 維度 - mcf:dcmNetwork - 使用的聯播網。
  • 維度 - mcf:dcmPlacement - 與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 網站刊登位置名稱。
  • 維度 - mcf:dcmPlacementPath：以 DCM 刊登位置表示互動的轉換路徑。
  • 維度 - mcf:dcmSite：代表 DCM 廣告素材，且與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 所在的 DCM 網站名稱。
  • 維度 - mcf:dcmSitePath：以 DCM 網站表示路徑上互動的轉換路徑。
  • 指標 - mcf:firstImpressionConversions：在 30 天的回溯期內，DCM 廣告活動曝光是最初轉換互動的轉換次數。這個維度包括目標達成數和交易次數。
  • 指標 - mcf:firstImpressionValue：在 30 天的回溯期內，DCM 廣告活動曝光是最初轉換互動的轉換價值。這個維度包括目標達成數和交易次數。
  • 指標 - mcf:impressionAssistedConversions：在轉換路徑中出現 DCM 廣告活動曝光，但並非最終轉換互動的轉換次數。這個維度包括目標達成數和交易次數。
  • 指標 - mcf:impressionAssistedValue：在轉換路徑中出現 DCM 廣告活動曝光，但不是最終轉換互動時的轉換價值。這個維度包括目標達成數和交易次數。

這個版本加入了新的工作階段指標、新的流量來源維度，以及新的 DoubleClick Campaign Manager 維度和指標。

維度和指標

如需完整的定義清單，請參閱維度和指標參考資料。

議程

  • 指標 - ga:hits - 傳送到 Google Analytics (分析) 的命中總數。這項指標會加總所有命中類型 (例如網頁瀏覽、事件、時間等)

流量來源

  • 維度 - ga:campaignCode：使用手動廣告活動追蹤時，utm_id 廣告活動追蹤參數值。

DoubleClick Campaign Manager

  • 維度 - ga:dcmClickAd - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告名稱 (僅限進階版)。
  • 維度 - ga:dcmClickAdId - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告 ID (僅限進階版)。
  • 維度 - ga:dcmClickAdType - 與 Google Analytics (分析) 工作階段相符之 DCM 點擊的 DCM 廣告類型名稱 (僅限進階版)。
  • 維度 - ga:dcmClickAdTypeId - 與 Google Analytics (分析) 工作階段相符之 DCM 點擊的 DCM 廣告類型 ID (僅限進階版)。
  • 維度 - ga:dcmClickAdvertiser - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告主名稱 (僅限進階版)。
  • 維度 - ga:dcmClickAdvertiserId - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告主 ID (僅限進階版)。
  • 維度 - ga:dcmClickCampaign - 與 Google Analytics (分析) 工作階段相符之 DCM 點擊的 DCM 廣告活動名稱 (僅限進階版)。
  • 維度 - ga:dcmClickCampaignId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相符的 DCM 點擊 DCM 廣告活動 ID。
  • 維度 - ga:dcmClickCreative - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告素材名稱 (僅限進階版)。
  • 維度 - ga:dcmClickCreativeId - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告素材 ID (僅限進階版)。
  • 維度 - ga:dcmClickCreativeType - 與 Google Analytics (分析) 工作階段相符之 DCM 點擊的 DCM 廣告素材類型名稱 (僅限進階版)。
  • 維度 - ga:dcmClickCreativeTypeId - 與 Google Analytics (分析) 工作階段相符之 DCM 點擊的 DCM 廣告素材類型 ID (僅限進階版)。
  • 維度 - ga:dcmClickCreativeVersion - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 廣告素材版本 (僅限進階版)。
  • 維度 - ga:dcmClickRenderingId - 與 Google Analytics (分析) 工作階段相符之 DCM 點擊的 DCM 顯示 ID (僅限進階版)。
  • 維度 - ga:dcmClickSite：針對與 Google Analytics (分析) 工作階段相符的 DCM 點擊，顯示並點擊 DCM 廣告素材的網站名稱 (僅限進階版)。
  • 維度 - ga:dcmClickSiteId：當 DCM 點擊與 Google Analytics (分析) 工作階段相符的 DCM 點擊時，顯示並點擊 DCM 網站 ID (僅限進階版)。
  • 維度 - ga:dcmClickSitePlacement - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 網站刊登位置名稱 (僅限進階版)。
  • 維度 - ga:dcmClickSitePlacementId - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM 網站刊登位置 ID (僅限進階版)。
  • 維度 - ga:dcmClickSpotId - 與 Google Analytics (分析) 工作階段相符的 DCM 點擊 DCM Floodlight 設定 ID (僅限進階版)。
  • 維度 - ga:dcmFloodlightActivity - 與 Floodlight 轉換 (僅限進階版) 相關聯的 DCM Floodlight 活動名稱。
  • 維度 - ga:dcmFloodlightActivityAndGroup - 與 Floodlight 轉換相關聯的 DCM Floodlight 活動名稱和群組名稱 (僅限進階版)。
  • 維度 - ga:dcmFloodlightActivityGroup - 與 Floodlight 轉換 (僅限進階版) 相關聯的 DCM Floodlight 活動群組名稱。
  • 維度 - ga:dcmFloodlightActivityGroupId - 與 Floodlight 轉換 (僅限進階版) 相關聯的 DCM Floodlight 活動群組 ID。
  • 維度 - ga:dcmFloodlightActivityId - 與 Floodlight 轉換 (僅限進階版) 相關聯的 DCM Floodlight 活動 ID。
  • 維度 - ga:dcmFloodlightAdvertiserId - 與 Floodlight 轉換 (僅限進階版) 相關聯的 DCM Floodlight 廣告主 ID。
  • 維度 - ga:dcmFloodlightSpotId - 與 Floodlight 轉換 (僅限進階版) 相關聯的 DCM Floodlight 設定 ID。
  • 維度 - ga:dcmLastEventAd - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告名稱。
  • 維度 - ga:dcmLastEventAdId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM 廣告 ID。
  • 維度 - ga:dcmLastEventAdType - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告類型名稱。
  • 維度 - ga:dcmLastEventAdTypeId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告類型 ID。
  • 維度 - ga:dcmLastEventAdvertiser - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告主名稱。
  • 維度 - ga:dcmLastEventAdvertiserId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM 廣告主 ID。
  • 維度 - ga:dcmLastEventAttributionType - 有兩種可能的值 (ClickThrough 和 ViewThrough)。如果與 Google Analytics (分析) 工作階段相關聯的最後一個 DCM 事件是點擊，值就會是 ClickThrough。如果與 Google Analytics (分析) 工作階段相關聯的最後一個 DCM 事件是廣告曝光，則這個值會是 ViewThrough (僅限 Premium)。
  • 維度 - ga:dcmLastEventCampaign - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM 廣告活動名稱。
  • 維度 - ga:dcmLastEventCampaignId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM 廣告活動 ID。
  • 維度 - ga:dcmLastEventCreative - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材名稱。
  • 維度 - ga:dcmLastEventCreativeId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM 廣告素材 ID。
  • 維度 - ga:dcmLastEventCreativeType - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材類型名稱。
  • 維度 - ga:dcmLastEventCreativeTypeId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 廣告素材類型 ID。
  • 維度 - ga:dcmLastEventCreativeVersion - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM 廣告素材版本。
  • 維度 - ga:dcmLastEventRenderingId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 顯示 ID。
  • 維度 - ga:dcmLastEventSite：針對與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (僅限 DCM 回溯期內的曝光或點擊)，顯示並點擊 DCM 廣告素材的網站名稱。
  • 維度 - ga:dcmLastEventSiteId：這是指與 Google Analytics (分析) 工作階段 (僅限 Premium) 相關聯的最後一個 DCM 事件 (也就是 DCM 回溯期內的曝光或點擊)，顯示並獲得點擊的 DCM 網站 ID。
  • 維度 - ga:dcmLastEventSitePlacement - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 網站刊登位置名稱。
  • 維度 - ga:dcmLastEventSitePlacementId - 與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (亦即 DCM 回溯期內的曝光或點擊) 的 DCM 網站刊登位置 ID。
  • 維度 - ga:dcmLastEventSpotId：與 Google Analytics (分析) 工作階段 (僅限進階版) 相關聯的最終 DCM 事件 (曝光或點擊在 DCM 回溯期內) 的 DCM Floodlight 設定 ID。
  • 指標 - ga:dcmFloodlightQuantity：DCM Floodlight 轉換次數 (僅限進階版)。
  • 指標 - dcmFloodlightRevenue - DCM Floodlight 收益 (僅限進階版)。

這個版本包含：

Google Analytics (分析)

  • 無變更。

Google 代碼管理工具

  • Google 通用 Analytics (分析) 代碼中新增了加強型電子商務支援。
  • TAGManager 類別已加入新的 dispatch 和 dispatchWithCompletionHandler 方法。

這個版本加入了新的內容分類維度和指標，

維度和指標

如需完整的定義清單，請參閱維度和指標參考資料。

內容分類

  • 維度 - ga:landingContentGroupXX - 使用者工作階段中的第一個相符內容群組。
  • 維度 - ga:nextContentGroupXX - 是指使用者在另一個內容群組後造訪的內容群組。
  • 維度 - ga:contentGroupXX - 資源上的內容群組。內容群組是一組提供邏輯結構的內容 (可透過追蹤程式碼、網頁標題/網址規則運算式比對或預先定義的規則來決定)。
  • 維度 - ga:previousContentGroupXX - 是指使用者先前瀏覽過其他內容群組的內容群組。
  • 指標 - ga:contentGroupUniqueViewsXX：指定內容群組在一個工作階段中不同 (不重複) 的網頁數量。系統會同時將 pagePath 和 pageTitle 納入考量，判斷是否不重複。

這個版本包含：

Google Analytics (分析)

  • 已新增加強型電子商務支援功能。詳情請參閱「加強型電子商務開發人員指南」。
  • 現在每次變更廣告 ID 時，用戶端 ID 都會重設。
  • 廣告 ID 收集功能預設為關閉。
  • 新增用於回報例外狀況的程式輔助 API。
  • 修正說明文件中的錯誤。
  • 修正小錯誤。

Google 代碼管理工具

  • Google 代碼管理工具沒有任何異動。

這個版本包含：

Google Analytics (分析)

  • 現在，如果應用程式包含程式庫 libAdIdAccess.a (以 SDK 的一部分提供)，且追蹤程式上的 allowIDFACollection 屬性設為 true，SDK 就會收集廣告識別碼和廣告客戶追蹤功能啟用標記。
  • 已新增加強型電子商務的支援。
  • 已新增畫面瀏覽命中類型，以取代應用程式檢視畫面命中類型。
  • 現在，每個命中都會加入命中 ID 參數。每次產生應用程式瀏覽、畫面瀏覽或網頁瀏覽點擊時，值就會改變。
  • 現在每次 IDFA 值變更時，ClientId 都會重設。在追蹤程式中收集廣告識別碼時，才會發生這個問題。
  • 將新的 dispatchWithCompletionHandler 方法新增至 GAI 類別。
  • 修正 SDK 可在沒有 clientId 或無用戶端 ID 的情況下傳送信標的問題。

Google 代碼管理工具

  • 沒有變更
  • 不含有效追蹤 ID 的命中現在會遭到捨棄。

這個版本包含新的資料匯入類型和淘汰 dailyUpload 資源。

資料匯入

若要進一步瞭解如何使用 Management API 將資料匯入 Google Analytics (分析) 帳戶，請參閱資料匯入開發人員指南。

上傳內容

  • upload 資源現在支援下列上傳類型：
    • 廣告活動資料
    • 內容資料
    • 費用資料
    • 產品資料
    • 退款資料
    • 使用者資料
  • upload 資源採用新的 migrateDataImport 方法，可遷移現有的費用資料 customDataSources。

每日上傳淘汰項目

  • dailyUpload 資源現已淘汰！如要進一步瞭解如何改用「資料匯入」功能，請參閱遷移指南。
  • dailyUpload 資源會繼續運作六個月，之後任何 uploadType 屬性設為 analytics#dailyUploads 的 customDataSources 都會自動遷移，並且僅適用於 upload 資源。
  • dailyUpload 資源的現有使用者應盡快更新程式碼並遷移至上傳資源。

這個版本加入了新的區隔 dateOfSession 條件，並新增加強型電子商務維度和指標。

路段

區隔現已支援新的 dateOfSession 條件，可將區隔限制為在特定日期範圍內開始工作階段的使用者群組。詳情請參閱區隔開發人員指南。

維度和指標

如需加強型電子商務的完整定義清單，請參閱維度和指標參考資料。

加強型電子商務

  • 維度 - ga:internalPromotionCreative：專為促銷活動設計的廣告素材內容。
  • 維度 - ga:internalPromotionId：促銷活動所使用的 ID。
  • 維度 - ga:internalPromotionName - 促銷活動的名稱。
  • 維度 - ga:internalPromotionPosition - 促銷活動在網頁或應用程式畫面上的位置。
  • 維度 - ga:orderCouponCode - 訂單層級優待券的代碼。
  • 維度 - ga:productBrand - 售出產品的品牌名稱。
  • 維度 - ga:productCategoryHierarchy - 產品的分類階層類別 (「加強型電子商務」)。
  • 維度 - ga:productCategoryLevelXX - 在產品類別階層中的層級 (1-5)，由上至下。
  • 維度 - ga:productCouponCode - 產品層級優待券的代碼。
  • 維度 - ga:productListName - 顯示產品所屬的產品清單名稱。
  • 維度 - ga:productListPosition - 產品在產品清單中的位置。
  • 維度 - ga:productVariant - 產品的特定子類，例如XS、S、M、L 等尺寸，或紅色、藍色、綠色、黑色等顏色。
  • 維度 - ga:checkoutOptions - 在結帳程序中指定的使用者選項，例如FedEx、DHL、UPS 配送選項，或 Visa、MasterCard 和 AmEx 付款方式。這項維度應與購物階段搭配使用。
  • 維度 - ga:shoppingStage - 使用者在工作階段中完成的各種購物體驗階段，例如「PRODUCT_VIEW」、「ADD_TO_CART」、「CHECKOUT」等
  • 指標 - ga:internalPromotionCTR：使用者點按查看內部宣傳活動的次數 (點擊次數除以促銷活動顯示次數)。
  • 指標 - ga:internalPromotionClicks - 內部宣傳活動的點擊次數。
  • 指標 - ga:internalPromotionViews：內部宣傳活動的觀看次數。
  • 指標 - ga:localProductRefundAmount - 特定產品的退款金額 (以當地幣別計算)。
  • 指標 - ga:localRefundAmount：以當地幣別計算的交易退款總金額。
  • 指標 - ga:productAddsToCart：產品加入購物車的次數。
  • 指標 - ga:productCheckouts：產品在結帳流程中納入的次數。
  • 指標 - ga:productDetailViews：使用者瀏覽產品詳細資料網頁的次數。
  • 指標 - ga:productListClicks：產品出現在產品清單時，使用者點擊產品的次數。
  • 指標 - ga:productListViews：產品在產品清單中出現的次數。
  • 指標 - ga:productListCTR - 使用者在產品清單中點擊產品的比率。
  • 指標 - ga:productRefunds：產品退款的次數。
  • 指標 - ga:productRefundAmount - 與產品相關聯的退款總金額。
  • 指標 - ga:productRemovesFromCart：產品從購物車中移除的次數。
  • 指標 - ga:productRevenuePerPurchase：每筆購買的平均產品收益 (通常與產品優待券代碼搭配使用)。
  • 指標 - ga:buyToDetailRate：不重複購買次數除以產品詳細資料頁面的瀏覽次數。
  • 指標 - ga:cartToDetailRate - 產品新增數除以產品詳細資料的瀏覽次數。
  • 指標 - ga:quantityAddedToCart - 加入購物車的產品單位數量。
  • 指標 - ga:quantityCheckedOut：結帳包含的產品單位數量。
  • 指標 - ga:quantityRefunded - 退款的產品單位數量。
  • 指標 - ga:quantityRemovedFromCart：從購物車中移除的產品單位數量。
  • 指標 - ga:refundAmount：交易的退款幣別金額。
  • 指標 - ga:totalRefunds - 已核發退款的次數。

這個版本修正了欄標題名稱的錯誤，以及新增的維度和指標。

維度和指標

如需完整的定義清單，請參閱維度和指標參考資料。

系統

  • 維度 - ga:sourcePropertyDisplayName - 綜覽資源的來源資源顯示名稱。這僅適用於綜覽資源。
  • 維度 - ga:sourcePropertyTrackingId - 綜覽資源的來源資源追蹤 ID。這僅適用於綜覽資源

管道分組

  • 維度 - ga:channelGrouping - 在資料檢視 (設定檔) 中共用的預設管道分組。
  • 維度 - ga:correlationModelId - 相關產品的相關模型 ID。
  • 維度 - ga:queryProductId - 所查詢產品的 ID。
  • 維度 - ga:queryProductName - 查詢的產品名稱。
  • 維度 - ga:queryProductVariation - 查詢產品的變化版本。
  • 維度 - ga:relatedProductId - 相關產品的 ID。
  • 維度 - ga:relatedProductName - 相關產品的名稱。
  • 維度 - ga:relatedProductVariation - 相關產品的變化版本。
  • 指標 - ga:correlationScore - 相關產品的相關分數。
  • 指標 - ga:queryProductQuantity - 查詢的產品數量。
  • 指標 - ga:relatedProductQuantity - 相關產品的數量。

標題欄名稱修正

  • 在 2014 年 4 月 16 日版本中發生錯誤；如果您查詢已淘汰的維度或指標，API 會傳回包含替換維度或指標的欄標題。現在，它能正確傳回請求中使用的維度或指標名稱。

這個版本包含 uiName 屬性的命名慣例變更。

uiName 變更

  • 範本化資料欄的 uiName 屬性現在使用 XX 代表數字索引，而非 1。舉例來說，Goal 1 Value 現在是 Goal XX Value。

這是 Embed API 的初始版本：

  • Google Analytics (分析) Embed API 是一個 JavaScript 程式庫，可讓您輕鬆地在幾分鐘內輕鬆建立資訊主頁並嵌入第三方網站。詳情請參閱 Embed API 總覽。
  • 包含元件：驗證、檢視選取器、資料和資料圖表。

這是 Provisioning API 的初始版本：

  • Provisioning API 可讓您透過程式輔助方式建立新的 Google Analytics (分析) 帳戶。這個 API 僅限受邀者使用，適用於合格的服務供應商和大型合作夥伴。詳情請參閱「Provisioning API 總覽」。

這個版本新增兩個新的設定 API。

濾鏡

未取樣報表： Management API

我們即將在 Management API 中新增一項名為「未取樣報表」的資源。未取樣報表是指透過未取樣資料產生的 Google Analytics (分析) (GA) 報表。「未取樣報表」目前僅供 Google Analytics Premium 使用者使用。

  • 更新支援的自然來源清單。

    • 已移除：Netscape、About、Mamma、Voila、Live、Wirtulana Polska、Yam、Ozu。
    • 已新增/更新：百度、DOCOMO、Onet、Centrum、Sogou、Tut.By、Globo、Ukr.net、So.com、au1。

  • 更新支援的自然來源清單。

    • 已移除：Netscape、About、Mamma、Voila、Live、Wirtulana Polska、Yam、Ozu。
    • 已新增/更新：百度、DOCOMO、Onet、Centrum、Sogou、Tut.By、Globo、Ukr.net、So.com、au1。

這個版本包含：

Google Analytics (分析)

  • 新增了使用者 ID 欄位。

Google 代碼管理工具

  • 修正廣告巨集 ID 中的錯誤，使其可以正確傳回廣告客戶識別碼 (IDFA)。
  • 修正問題：使用者能夠將 NSNumber 用於電子商務資料。

這個版本包含淘汰 appUiName 屬性。請參閱資料淘汰政策，進一步瞭解移除屬性的相關資訊：

appUiName 淘汰項目

  • appUiName 已淘汰。因為網頁和應用程式資料檢視 (設定檔) 的使用者介面名稱已統一，因此 Metadata API 中已不再需要此名稱。您應移除所有使用 appUiName 屬性的程式碼，且只使用 uiName 屬性。

這個版本包括重新命名維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

已重新命名的維度和指標

下列維度和指標已重新命名。參閱資料淘汰政策，進一步瞭解資料重新命名：

使用者

  • 維度 - rt:visitorType - 改用 rt:userType。
  • 指標 - rt:activeVisitors - 請改用 rt:activeUsers。

這個版本包含新增及重新命名維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

新的維度和指標

Core Reporting API 已新增下列維度：

AdWords

  • 維度 - ga:isTrueViewVideoAd - Yes 或 No - 表示廣告是否為 AdWords TrueView 影片廣告。

時間

  • 維度 - ga:nthHour - 指定日期範圍內每小時的索引。在日期範圍內第一天的第一小時 (亦即開始日期) 的索引是 0，下個小時的 1，依此類推。

已重新命名的維度和指標

所有「訪客」和「造訪」的維度和指標都已重新命名，改為分別使用「使用者」和「工作階段」。

下列維度和指標已重新命名。參閱資料淘汰政策，進一步瞭解資料重新命名：

觀眾

  • 維度 - ga:visitorAgeBracket - 改用 ga:userAgeBracket。
  • 維度 - ga:visitorGender - 改用 ga:userGender。

電子商務

  • 指標 - ga:transactionRevenuePerVisit - 請改用 ga:transactionRevenuePerSession。
  • 指標 - ga:transactionsPerVisit - 請改用 ga:transactionsPerSession。

事件追蹤

  • 指標 - ga:eventsPerVisitWithEvent - 請改用 ga:eventsPerSessionWithEvent。
  • 指標 - ga:visitsWithEvent - 請改用 ga:sessionsWithEvent。

目標轉換次數

  • 指標 - ga:goalValuePerVisit - 請改用 ga:goalValuePerSession。
  • 指標 - ga:percentVisitsWithSearch - 請改用 ga:percentSessionsWithSearch。
  • 指標 - ga:searchVisits - 請改用 ga:searchSessions。

網頁追蹤

  • 指標 - ga:pageviewsPerVisit - 請改用 ga:pageviewsPerSession。

議程

  • 維度 - ga:visitLength - 改用 ga:sessionDurationBucket。
  • 指標 - ga:avgTimeOnSite - 請改用 ga:avgSessionDuration。
  • 指標 - ga:timeOnSite - 請改用 ga:sessionDuration。
  • 指標 - ga:visitBounceRate - 請改用 ga:bounceRate。
  • 指標 - ga:visits - 請改用 ga:sessions。

社交互動

  • 維度 - ga:socialInteractionNetworkActionVisit - 改用 ga:socialInteractionNetworkActionSession。
  • 指標 - ga:socialInteractionsPerVisit - 請改用 ga:socialInteractionsPerSession。

使用者

  • 維度 - ga:daysSinceLastVisit - 改用 ga:daysSinceLastSession。
  • 維度 - ga:visitCount - 改用 ga:sessionCount。
  • 維度 - ga:visitorType - 改用 ga:userType。
  • 維度 - ga:visitsToTransaction - 改用 ga:sessionsToTransaction。
  • 指標 - ga:newVisits - 請改用 ga:newUsers。
  • 指標 - ga:percentNewVisits - 請改用 ga:percentNewSessions。
  • 指標 - ga:visitors - 請改用 ga:users。

這個版本包含取代 appview 命中類型，以及新增和重新命名參數。如需完整的參數清單，請參閱參數參考資料。

取代應用程式檢視畫面

  • appview 命中類型已替換為 screenview。盡快更新應用程式追蹤程式碼，以使用 screenview 取代 appview。

新增參數

重新命名參數

  • 「內容說明」已重新命名為「畫面名稱」。查詢參數名稱「cd」會維持不變。

這個版本包含取代 appview 命中類型並新增欄位。如需完整的欄位清單，請參閱欄位參考資料。

取代應用程式檢視畫面

  • appview 命中類型已替換為 screenview。盡快更新應用程式追蹤程式碼，以使用 screenview 取代 appview。

新欄位

其他異動

  • 改善偵錯輸出內容。
  • 修正各種預先算繪錯誤。
  • 新增對無前置字串的預先算繪 API 的支援。除了 Chrome 以外，預先算繪功能現在也支援 IE11。
  • 修正連結器支援中的其他小錯誤。
  • 現在，Yahoo 安全搜尋已正確歸類為自然來源。
  • 新增對無前置字串的預先算繪 API 的支援。除了 Chrome 以外，預先算繪功能現在也支援 IE11。

區隔：Core Reporting API 2.4 和 3.0 版

Core Reporting API 支援新的區隔。

  • segment 參數現在支援使用者和序列區隔。您可以使用 segment 參數查詢在網頁介面中建立的「使用者層級」和「工作階段層級」區隔。
  • 動態區隔的新語法可與 segment 參數搭配使用。詳情請參閱區隔開發指南
  • dynamic:: 前置字串已淘汰。建議您盡快migrate至新語法。

區隔： Management API 2.4 版和 3.0 版

我們對區隔集合進行了以下變更：

  • API 現已支援使用者和序列區隔。
  • 「區隔集合」現在會傳回所有內建和自訂的工作階段層級以及使用者層級區隔。
  • 區隔的 definition 屬性將使用新的區隔語法。這包括現有工作階段層級區隔的定義，該區隔將從 definition: "" 變更為 definition: "sessions::condition::"。
  • 在 Segment 資源中加入新的 type 資源，以指出區隔是 CUSTOM (也就是使用者在網頁介面中建立) 還是 BUILT_IN (由 Google Analytics (分析) 提供)。

實驗

您現在可以使用下列 AdSense 指標做為最佳化目標：

  • ga:adsenseAdsClicks：您網站上的 AdSense 廣告點擊次數。
  • ga:adsenseAdsViewed：AdSense 廣告獲得的觀看次數。一個廣告單元中可以顯示多個廣告。
  • ga:adsenseRevenue：AdSense 廣告的總收益。

新帳戶摘要收集

  • Management API 已新增 AccountSummaries 集合。透過一個快速要求，獲得授權的使用者可存取各個帳戶、資源和資料檢視 (設定檔) 的資訊摘要。詳情請參閱《帳戶摘要開發人員指南》。

ga: 已淘汰前置字元

所有即時維度和指標的 ga: 前置字元已不適用，並由新的 rt: 前置字元取代。使用 ga: 前置字串的 API 要求可繼續使用 6 個月，之後就會傳回錯誤。

新的維度和指標

這項更新會在 Real Time Reporting API 中加入新的維度和指標。如需完整清單，請參閱維度和指標參考資料。

事件追蹤

  • 維度 - rt:eventAction - 事件的動作。
  • 維度 - rt:eventCategory：事件類別。
  • 維度 - rt:eventLabel - 事件的標籤。
  • 維度 - rt:totalEvents - 設定檔中在所有類別中的事件總數。

目標追蹤

  • 維度 - rt:goalId - 與目標 ID 對應的字串。
  • 指標 - rt:goalXXValue - 所請求目標編號的總數值，其中 XX 是介於 1 到 20 之間的數字。
  • 指標 - rt:goalValueAll - 您為設定檔定義的所有目標的總數值。
  • 指標 - rt:goalXXCompletions - 所請求目標號碼的完成總數，其中 XX 是介於 1 到 20 之間的數字。
  • 指標 - rt:goalCompletionsAll - 您為設定檔定義的所有目標達成總數。

網頁追蹤

  • 指標 - rt:pageViews - 網頁瀏覽量的總數。

應用程式追蹤

  • 指標 - rt:screenViews - 畫面瀏覽總次數。

這個版本包含：

Google Analytics (分析)

  • SDK 現在預設會填入應用程式 ID 參數 (&aid)。

Google 代碼管理工具

  • 新增對 Google Analytics (分析) 內容實驗巨集的支援。

這個版本包含：

Google Analytics (分析)

  • Google Analytics (分析) 沒有任何異動。

Google 代碼管理工具

  • 新增對 Google Analytics (分析) 內容實驗巨集的支援。

這個版本包含：

Google Analytics (分析)

  • 系統不會直接對 Google Analytics (分析) 進行任何變更。Google Analytics (分析) 使用者應注意，根據預設，Google 代碼管理工具不再依附於 AdSupport.framework。這可能有助於解決問題 387。

Google 代碼管理工具

  • 呼叫 AdSupport.framework API 的函式可細分為獨立的程式庫 libAdIdAccess.a。應用程式必須連結至該程式庫，才能存取廣告 ID (IDFA) 字串和已啟用廣告客戶追蹤功能的標記。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

轉換路徑

  • 維度 - mcf:adwordsCustomerIDPath - 轉換路徑中的 AdWords 客戶 ID 順序。

互動

  • 維度 - mcf:adwordsCustomerID - 對應 AdWords API Customer.id。
  • 在 Firefox 中以不同縮放等級瀏覽不同網域時，系統不會再忽略 Linker 參數。
  • 修正特定網址無法載入網頁活動分析的問題。
  • 改善偵錯模式輸出內容。
  • 維護版本。

這個版本包含：* 已移除 AdSupport.framework 的需求。* 移除了用不到的程式碼。

此版本包含：* 新增對 64 位元 iOS 7.0 SDK 的支援。* 已移除 libGoogleAnalytics_debug.a，它是 libGoogleAnalyticsServices.a 程式庫的一部分。* 清理 Google Analytics (分析) 的 CuteAnimals 建立檔案。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

轉換路徑

  • 維度 - mcf:adwordsAdGroupIDPath - 轉換路徑中的 AdWords 廣告群組 ID 序列。
  • 維度 - mcf:adwordsCampaignIDPath - 轉換路徑上的 AdWords 廣告活動 ID 序列。
  • 維度 - mcf:adwordsCreativeIDPath - 轉換路徑中的 AdWords 廣告素材 ID 序列。
  • 維度 - mcf:adwordsCriteriaIDPath - 轉換路徑中的 AdWords 條件 ID 序列。

互動

  • 維度 - mcf:adwordsAdGroupID - 對應 AdWords API AdGroup.id。
  • 維度 - mcf:adwordsCampaignID - 對應 AdWords API Campaign.id。
  • 維度 - mcf:adwordsCreativeID - 對應 AdWords API Ad.id。
  • 維度 - mcf:adwordsCriteriaID - 對應 AdWords API Criterion.id。

這個版本包含新的資料表回應格式，以及加入和淘汰維度和指標 (如需完整的定義清單，請參閱維度和指標參考資料)。

資料表輸出

為了輕鬆使用 Google 圖表視覺化呈現 Google Analytics (分析) 資料，API 可以選擇在回應中傳回資料表物件。

  • 在 API 中新增了選用的 output 查詢參數，可用來在回應中選取 Analytics (分析) 資料的輸出格式 (預設為 JSON)。如果設為 datatable，則回應中包含包含資料表物件的 dataTable 屬性。這個物件可以直接與 Google Charts 搭配使用。詳情請參閱 Core Reporting API 參考資料。

新的維度和指標

Core Reporting API 已新增下列維度和指標：

時間

  • 維度 - ga:minute - 傳回一小時內的分鐘。可能的值介於 00 和 59 之間。
  • 維度 - ga:nthMinute - 指定日期範圍內每分鐘的索引。在日期範圍內第 1 分鐘的索引 (也就是開始日期) 為 0，後續分鐘的 1 等。

觀眾

  • 維度 - ga:visitorAgeBracket - 訪客的年齡層。
  • 維度 - ga:visitorGender - 訪客的性別。
  • 維度 - ga:interestAffinityCategory - 表示使用者較有可能想瞭解指定類別。
  • 維度 - ga:interestInMarketCategory - 表示使用者較有可能購買指定類別中的產品或服務。
  • 維度 - ga:interestOtherCategory - 表示使用者較有可能想瞭解指定類別，且較有可能準備購物。

區隔中允許的維度和指標

您現在可以在區隔中使用下列維度和指標：

  • 維度 - ga:sourceMedium - 合併 ga:source 和 ga:medium 的值。
  • 指標 - ga:localItemRevenue - 以當地幣別計算的產品收益。

已淘汰的維度和指標

這些維度和指標已淘汰。參閱資料淘汰政策，進一步瞭解資料移除作業：

  • 維度 - ga:isMobile - 請改用 ga:deviceCategory (例如ga:deviceCategory==mobile).
  • 維度 - ga:isTablet - 請改用 ga:deviceCategory (例如ga:deviceCategory==tablet).
  • 指標 - ga:entranceBounceRate - 請改用 ga:visitBounceRate。

基於 ga:isMobile 和 ga:isTablet 維度的淘汰，我們已對預設區隔進行以下變更：

  • 區隔 gaid::-11 已從「行動裝置流量」重新命名為「行動裝置和平板電腦流量」。這個區隔的定義已從「ga:isMobile==Yes」變更為「ga:deviceCategory==mobile,ga:deviceCategory==tablet」。請注意，ga:isMobile 包含平板電腦流量，因此會反映在新的定義中。如果您只想獲得行動流量 (排除平板電腦)，請改用新的「行動裝置流量」區隔 (gaid::-14)。
  • 區隔「gaid::-13」的定義已從「ga:isTablet==Yes」變更為「ga:deviceCategory==tablet」。如此會繼續代表「平板電腦流量」。
  • 已新增區隔「gaid::-14」。區隔的名稱為「Mobile Traffic」，定義則為 ga:deviceCategory==mobile。
  • 維護版本。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

AdSense

  • 已新增 AdSense 資料的存取權：

    • Met - ga:adsenseRevenue - AdSense 廣告帶來的總收益。
    • Met - ga:adsenseAdUnitsViewed - 瀏覽的 AdSense 廣告單元數量。廣告單元是指在網站內安插一段 AdSense 廣告程式碼後所顯示的一組廣告，詳情：https://support.google.com/adsense/answer/32715。
    • 都會 - ga:adsenseAdsViewed - AdSense 廣告獲得的觀看次數。一個廣告單元中可以顯示多個廣告。
    • 都會 - ga:adsenseAdsClicks - 您網站上 AdSense 廣告的點擊次數。
    • 結算 - ga:adsensePageImpressions - 顯示 AdSense 廣告時的網頁瀏覽量。一次網頁曝光可以包含多個廣告單元。
    • 行動裝置 - ga:adsenseCTR - 促成 AdSense 廣告的網頁曝光次數百分比。(ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • 總曝光次數 - ga:adsenseECPM - 每千次網頁曝光的預估費用。這是您每 1,000 次網頁曝光的「AdSense 收益」。(ga:adsenseRevenue/(ga:adsensePageImpressions/1000)。
    • 每次都算 - ga:adsenseExits：因為使用者按下 AdSense 廣告而結束的工作階段數。

時間

  • 烘焙 - ga:isoYear - 造訪的 ISO 年分。詳細資料：http://en.wikipedia.org/wiki/ISO_week_date。ga:isoYear 只能與 ga:isoWeek 搭配使用，因為 ga:week 代表公曆。
  • 調暗 - ga:isoYearIsoWeek - ga:isoYear 和 ga:isoWeek 的合併值。

AdWords

  • 下列資料位於 AdWords 報表內：

    • 「調暗」- ga:adKeywordMatchType - 關鍵字套用的比對類型 (詞組比對、完全比對、廣泛比對)。詳細說明：解讀搜尋字詞報表。

修正錯誤：

  • 已修正資料檢視 (設定檔) 的時區資訊。詳細資訊：在修正這個問題之前，在某些情況下，系統在 Management API 中列出資料檢視 (設定檔) 時，系統會傳回不正確的時區資訊 (設定檔)。資料檢視 (設定檔) 的時區資訊會與 Google Analytics (分析) 管理員介面中設定的時區資訊一致。

這個版本包含：* 已修正與通訊協定緩衝區 SDK 的衝突。* 修正啟用程式碼清除功能時發生的連結器錯誤。

新的樣本大小控制項與相對日期功能

相對日期
  • MCF Reporting API 已新增相對日期的支援。today、yesterday 和 NdaysAgo 現已成為 start-date 和 end-date 查詢參數的有效值。
  • 使用這些值，即可根據查詢時的目前日期，以及查詢中指定的資料檢視 (設定檔) 時區，自動判斷日期範圍。詳情請參閱 API 參考資料。
取樣層級
  • 我們推出了新的參數 samplingLevel，可讓您設定報表查詢的取樣層級 (例如用來計算結果的造訪次數)。允許的值包括：DEFAULT、FASTER 和 HIGHER_PRECISION。
  • API 回應新增了 2 個欄位：sampleSize 和 sampleSpace。您可以利用這些值，計算取樣回應所使用的造訪次數百分比。
  • 詳情請參閱 API 參考資料和取樣。

新的樣本大小控制項與相對日期功能

相對日期
  • Core Reporting API 已新增相對日期的支援。today、yesterday 和 NdaysAgo 現已成為 start-date 和 end-date 查詢參數的有效值。
  • 使用這些值，即可根據查詢時的目前日期，以及查詢中指定的資料檢視 (設定檔) 時區，自動判斷日期範圍。詳情請參閱 API 參考資料。
取樣層級
  • 我們推出了新的參數 samplingLevel，可讓您設定報表查詢的取樣層級 (例如用來計算結果的造訪次數)。允許的值包括：DEFAULT、FASTER 和 HIGHER_PRECISION。
  • API 回應新增了 2 個欄位：sampleSize 和 sampleSpace。您可以利用這些值，計算取樣回應所使用的造訪次數百分比。
  • 詳情請參閱 API 參考資料和取樣。

此版本包含：* 第六版 Beta 版。* 完成必要變更，避免指定 KitKat (API 級別 19) 的應用程式使用 SDK 時發生執行階段例外狀況。

此版本包含：* 第 3.0 版的第二個版本。* 完成必要變更，避免指定 KitKat (API 級別 19) 的應用程式使用 SDK 時發生執行階段例外狀況。

這個版本推出適用於網站資源、資料檢視 (設定檔) 和目標資源的寫入作業，以及一組 3 項啟用使用者權限管理功能的新資源。

帳戶設定和設定 API

  • 您現在可以建立、更新、修補及刪除資料檢視 (設定檔)。如要進一步瞭解這些新方法，請參閱資料檢視 (設定檔) 參考資料。
  • 現在，您可以建立、更新及修補網站資源和目標。如要進一步瞭解這些新方法，請參閱網站資源參考資料和目標參考資料。
  • 現在可以使用 get 方法請求單一網站資源、資料檢視 (設定檔) 或目標。
  • 這些功能目前是開發人員預覽版的 Beta 版，如果您有意申請使用，請申請試用 Beta 版。

Management API 中的使用者權限

這個版本包含：

  • 修正指定 iOS 7.0 時發生的連結錯誤。

這是 Metadata API 的初始版本：

  • Metadata API 會傳回在 Google Analytics (分析) Reporting API 中公開的維度和指標相關資訊。傳回的中繼資料包括使用者介面名稱、說明、支援進階區隔等屬性。只要使用 Metadata API，應用程式就能自動取得報表查詢適用的維度和指標最新資料。詳情請參閱「Metadata API 總覽」。

這個版本包含：* 3.0 版首次發布的 SDK API 變更，以便與 analytics.js 保持一致。已移除 track 和 send 方法。請改用 send 和 GAIDictionaryBuilder 建構方法。* GAITracker 通訊協定的大多數屬性都已移除。請改為在各種欄位中使用 set。* 系統會保留所有使用 set 方法設定的參數。以往，您只能為下一次傳送/追蹤呼叫設定多個參數。* 如果您想為 SDK 實作自訂記錄功能，可以使用 GAILogger 通訊協定。* 最低系統需求已變更。詳情請參閱 Readme.txt。* 所有 SDK 活動 (資料庫和網路存取權) 現在都是透過另一個執行緒完成。* 現在可以讀取 clientId 了。呼叫 [tracker get:kGAIClientId]。請注意，這項呼叫會封鎖，直到可以從資料庫讀取 clientId 為止。* 除非命中資料超過 2000 個位元組，否則 SDK 不會再使用 POST。改用 GET。* SDK 不會再依據 HTTP 回應代碼重新傳送命中。

此版本包含：* 3.0 版首次發布 * SDK API 重新編寫，使其與 analytics.js 更一致。詳情請參閱 javadoc 和 /analytics/devguides/collection/android/v3/。* 已移除所有 track 和 send 方法。您可以改為使用傳送方法和 MapBuilder 類別中的對應建構方法傳送命中。請參閱 Fields 類別，瞭解可用於使用 set 和 send 建構命中的常數清單。* 許多各種屬性也已移除，包括 useHttps、anonymizeIp 等。您可以使用 set 指令設定/重設這些屬性。* EasyTracker 現在擴充 Tracker。不需要呼叫 EasyTracker.getTracker 即可直接追蹤來電。* SDK 不會再設定在啟動時啟動工作階段控制標記。開發人員現在必須負責判斷是否需要新工作階段。請注意，EasyTracker 仍可照常處理工作階段管理。* SDK 現在支援自訂記錄類別。詳情請參閱 javadoc 中的 Logger。* 已新增dryRun模式，* 現在可以讀取 clientId 了。只要呼叫 tracker.get(Fields.CLIENT_ID) 即可。系統會封鎖這項呼叫，直到從永久存放區載入 clientId 為止。* SDK 不會再依據 HTTP 回應代碼重試命中。

以下是 Real Time Reporting API 的初始版本，限定 Beta 版：

  • 您可以透過 Real Time Reporting API，針對資源當下發生的活動製作報表。您可以使用 Real Time Reporting API 查詢維度和指標，建立提供給客戶的網頁小工具和資訊主頁。詳情請參閱「Real Time Reporting API 總覽」。

修正錯誤

  • ga:adwordsCustomerID 現在可正確傳回與 AdWords API AccountInfo.customerId 相對應的 10 位數 AdWords 客戶 ID。有鑑於此，我們可將 Analytics (分析) 資料與多個 AdWords 帳戶合併。

隨著新版區隔推出，我們將針對 Core Reporting API 推出下列變更。

  • segment 參數現在支援自訂進階區隔的新英數字元 ID，這個 ID 會顯示在 Management API 區隔集合中。
  • 自訂區隔目前的數字 ID 現已淘汰。舊版 ID 將繼續使用 6 個月。我們建議應用程式儲存使用者區隔 ID，以便改用新的英數字元 ID。淘汰期結束後，凡是使用舊數字 ID 的查詢都會傳回錯誤。
  • 目前，您只能透過 segment 參數查詢在網頁介面中建立的造訪層級區隔。
  • 包含排除數字 ID 的現有預設區隔不會受到影響。但目前不支援新的預設區隔。

隨著新區隔推出，我們將針對區隔集合推出下列變更：

  • 所有區隔 ID 都會從正整數變更為英數字元字串。如果您已儲存使用者的區隔 ID，建議您將其更新為使用新的 ID。
  • 「區隔集合」只會傳回現有的造訪層級區隔。API 目前不支援新訪客、同類群組和序列區隔。
  • 「區隔集合」將繼續傳回具有相同負數 ID 的現有預設區隔，但系統目前不支援新的預設區隔。

這個版本在 API 中加入新的維度和指標。如需完整的定義清單，請參閱維度和指標參考資料。

應用程式追蹤

  • 應用程式設定檔報表會顯示下列資料：
    • Dim - ga:appId - 應用程式 ID。
    • 調暗 - ga:appInstallerId - 安裝程式的 ID (例如Google Play 商店) 的應用程式下載來源。根據預設，應用程式安裝工具 ID 是根據 PackageManager#getInstallerPackageName 方法設定。
    • Dim - ga:appName - 應用程式名稱。
    • Dim - ga:appVersion - 應用程式版本。
    • 調暗 - ga:exitScreenName - 使用者退出應用程式的畫面名稱。
    • 調暗 - ga:landingScreenName - 查看的第一個畫面名稱。
    • 「調暗 - ga:screenDepth」：以字串的形式記錄的單次工作階段畫面瀏覽次數。可用於長條圖。
    • 調暗 - ga:screenName - 畫面的名稱。
    • 完全 - ga:avgScreenviewDuration：使用者的平均畫面停留時間，以秒為單位。
    • 我知道了 - ga:timeOnScreen - 查看目前畫面所花費的時間。
    • 全部 - ga:screenviews：畫面瀏覽總次數。使用這個項目，而非 ga:appviews。
    • 全部 - ga:uniqueScreenviews：工作階段中不同 (不重複) ga:screenviews 的數量。使用這個項目，而非 ga:uniqueAppviews。
    • 我知道了 - ga:screenviewsPerSession：每個工作階段的平均ga:screenviews數量。使用這個項目，而非 ga:appviewsPerVisit。

已淘汰

下列指標已淘汰。請改用新指標名稱。

  • 我記得 - ga:appviews - 請改用 ga:screenviews。
  • 我記得 - ga:uniqueAppviews - 請改用 ga:uniqueScreenviews。
  • 我記得 - ga:appviewsPerVisit - 請改用 ga:screenviewsPerSession。

自訂變數或自訂欄

  • 自訂維度和指標的存取權：

    • 灰色 - ga:dimensionXX - 要求的自訂維度名稱，其中 XX 是指自訂維度的編號/索引。
    • 重要 - ga:metricXX - 要求的自訂指標名稱，XX 是指自訂指標的數值/索引。

說明文件變更

下列自訂變數維度和指標已重新命名。本說明文件僅更動，您不需要更新查詢。

  • ga:customVarName(n) → ga:customVarNameXX
  • ga:customVarValue(n) → ga:customVarValueXX

電子商務

  • 灰色 - ga:currencyCode：交易的當地幣別代碼 (以 ISO 4217 標準為依據)。
  • 全部 - ga:localItemRevenue - 以當地幣別計算的產品收益。
  • 全部 - ga:localTransactionRevenue - 以當地幣別計算的交易收益。
  • 交易運費 - ga:localTransactionShipping - 以當地幣別計算的交易運費。
  • 收到 - ga:localTransactionTax - 以當地幣別計算的交易稅。

例外狀況

  • 這項資料來自例外狀況追蹤。
    • 「調暗 - ga:exceptionDescription」：例外狀況的說明。
    • 全部 - ga:exceptionsPerScreenview：擲回的例外狀況數量除以畫面瀏覽次數。
    • 最終 - ga:fatalExceptionsPerScreenview：擲回的嚴重例外狀況數量除以畫面瀏覽次數。

目標轉換次數

  • 灰色 - ga:goalCompletionLocation - 與任何目的地類型目標達成相符的網頁路徑或畫面名稱。
  • 灰色 - ga:goalPreviousStep1 - 與任何目的地類型目標相符的網頁路徑或畫面名稱，也就是目標達成位置前一個步驟。
  • 灰色 - ga:goalPreviousStep2 - 與任何目的地類型目標相符的網頁路徑或畫面名稱，在目標達成位置前兩個步驟。
  • 灰色 - ga:goalPreviousStep3 - 與任何目的地類型目標相符的網頁路徑或畫面名稱，也就是目標達成位置前三個步驟。

說明文件變更

下列「目標轉換」維度和指標已重新命名。本說明文件僅更動，您不需要更新查詢。

  • ga:goal(n)AbandonRate → ga:goalXXAbandonRate
  • ga:goal(n)Abandons → ga:goalXXAbandons
  • ga:goal(n)Completions → ga:goalXXCompletions
  • ga:goal(n)ConversionRate → ga:goalXXConversionRate
  • ga:goal(n)Starts → ga:goalXXStarts
  • ga:goal(n)Value → ga:goalXXValue
  • ga:searchGoal(n)ConversionRate → ga:searchGoalXXConversionRate
  • 這段期間 - ga:percentSearchRefinements：在一個工作階段內，修正 (即移轉) 在內部搜尋關鍵字之間發生的次數百分比。

網頁追蹤

  • 全部 - ga:pageValue - 這個網頁或一組網頁的平均值。「網頁價值」((交易收益 + 目標總價值) 除以網頁或一組網頁的不重複網頁瀏覽量。

平台或裝置

  • 這項資料衍生自 HTTP User-Agent 字串。

    • 調暗 - ga:deviceCategory - 裝置類型：桌機、平板電腦或手機。
    • 調暗 - ga:isTablet - 表示平板電腦訪客。可能的值包括 Yes 或 No。
    • 調暗 - ga:mobileDeviceMarketingName - 用於行動裝置的行銷名稱。

社交互動

  • 這項資料來自站內社交互動追蹤。

    • 調暗 - ga:socialEngagementType - 參與類型。可能的值為 Socially Engaged 或 Not Socially Engaged。

時間

  • 調暗 - ga:dateHour - ga:date 和 ga:hour 的合併值。
  • 「調暗」- ga:dayOfWeekName - 星期幾的名稱 (英文)。
  • 灰色 - ga:isoWeek - ISO 週數，每週都會以星期一開始。詳細資料：http://en.wikipedia.org/wiki/ISO_week_date。
  • 調暗 - ga:yearMonth - ga:year 和 ga:month 的合併值。
  • 調暗 - ga:yearWeek - ga:year 和 ga:week 的合併值。

流量來源

  • 灰色 - ga:fullReferrer - 完整的參照網址，包括主機名稱和路徑。
  • 調暗 - ga:sourceMedium - ga:source 和 ga:medium 的加總值。

這個版本在網站資源資源中加入 2 項新資源：

  • profileCount - 傳回資源的設定檔數量。這可讓您篩選沒有任何設定檔 (即 profileCount = 0) 的資源。
  • industryVertical - 傳回為資源選取的產業產業/類別。

修正錯誤：

  • 設定檔資源的 eCommerceTracking 資源現在與網頁介面「管理」區段中的「電子商務」設定一致。啟用電子商務追蹤功能時，會傳回 true，否則會傳回 false。
  • 網站資源現在包含 level 資源，用於指出網站資源是 PREMIUM 還是 STANDARD。

此版本包含：* 第五個 Beta 版。* 修正 EasyTracker 例外狀況剖析錯誤。設定 ga_reportUncaughtExceptions 旗標時，系統不會初始化例外狀況剖析器，也因此不會剖析未擷取例外狀況的位置。修正此問題後，當 ga_reportUncaughtExceptions 設為 True 時，當機和例外狀況報告就會回報未偵測到的例外狀況位置。

  • 這個版本新增 2 個新的實驗指標：- ga:experimentId - ga:experimentVariant
  • Management API v3 新增了端點，以便存取及修改 Experiments 資源。

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

  • 新增使用 _set 指定當地幣別的支援功能，例如 gaq.push(['_set', 'currencyCode', 'EUR'])
  • 這個版本新增 5 項網站速度指標：
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • 這個版本新增「平板電腦流量」的預設區隔 gaid::-13。
  • 設定檔資源現在包含 type 屬性，可識別是否為網站或應用程式設定的設定檔。可能的值包括：WEB 或 APP。

這個版本包含：

  • 將預設 appVersion 變更為 CFBundleShortVersionString 中的值，而非 CFBundleVersionKey。
  • 使用 HTTPS 做為預設通訊協定，而非 HTTP。
  • 追蹤方法已變更為「傳送」(例如 trackView 現已改名為 sendView)。
  • 修正一些小錯誤。

此版本包含：* 第 4 個 Beta 版本。* SDK 現在會採用取樣率設定。如果您先前將取樣率設為 100% 以上，會發現某些 Analytics (分析) 指標相較於 Beta 版 3 也相對下降。* 變更了要傳送的曲目方法 (例如，trackView 現在稱為 sendView)。* 透過 Transaction.setCurrencyCode 新增對當地幣別的支援 * 預設使用 HTTPS，而非 HTTP。* 在沒有網路連線時，SDK 不會嘗試分派命中。* 在嘗試處理安裝廣告活動資料時避免 ANR。* 已從 SDK 中移除 TrackedActivity 類別。* 將 SDK 初始化移出主要 UI 執行緒。* 改善 SDK 從損毀的 SQLite 資料庫復原的能力。* 修正其他多項當機和錯誤。

這個版本包含：

  • 將 armv7s 架構新增至 libGoogleAnalytics.a。
  • 已從 libGoogleAnalytics.a 中移除 armv6 架構。

這個版本在 API 中加入新的維度和指標。請參閱維度和指標參考資料瞭解定義。

應用程式追蹤

  • 「行動應用程式追蹤 SDK」報表會顯示下列資料：
    • 全部 - ga:uniqueAppviews - 每個工作階段的應用程式瀏覽次數。
    • 全部 - ga:appviews - 應用程式瀏覽的總次數。
    • 平均 - ga:appviewsPerVisit：每個工作階段的平均應用程式瀏覽次數。

流量來源

  • 調暗 - ga:socialNetwork - 代表社交網路名稱的字串。這可能與流量來源的推薦社群網路有關，也可能與社交資料中心活動的社群網路有關。例如 Google+、Blogger、Reddit 等。
  • 灰色 - ga:hasSocialSourceReferral - 表示透過社交來源 (例如 Google+、Facebook、Twitter 等社群網路) 抵達網站的造訪次數。可能的值為「是」或「否」，而且第一個字母必須為大寫。

社交活動

  • 這項資料來自從社交資料中心合作夥伴匯入的站外活動。
    • 調暗 - ga:socialActivityDisplayName - 如果是社交資料中心活動，這個字串代表社群網路使用者張貼的社交活動名稱。
    • 調暗 - ga:socialActivityEndorsingUrl - 如果是社交資料中心活動，這個字串代表社交活動的網址 (例如 Google+ 貼文網址、網誌留言網址等)。
    • 調暗 - ga:socialActivityPost - 對於社交資料中心活動，這個字串代表社群網路使用者張貼的社交活動內容 (例如 Google+ 訊息的訊息內容)
    • 灰色 - ga:socialActivityTimestamp - 如果是社交資料中心活動，此字串代表社交活動在社群網路上發生的時間。
    • 調暗 - ga:socialActivityUserPhotoUrl - 如果是社交資料中心活動，這個字串代表與使用者社交網路個人資料相關聯的相片網址。
    • 調暗 - ga:socialActivityUserProfileUrl - 如果是社交資料中心活動，這個字串代表相關使用者的社群網路個人資料網址。
    • 調暗 - ga:socialActivityContentUrl - 如果是社交資料中心活動，這個字串代表相關社交網路使用者分享的網址。
    • 調暗 - ga:socialActivityTagsSummary - 以社交資料中心活動來說，此為一組以半形逗號分隔的代碼，與社交活動相關。
    • 調暗 - ga:socialActivityUserHandle - 針對社交資料中心活動，這個字串代表發起社交活動的使用者所在社群網路帳號代碼 (也就是名稱)。
    • 調暗 - ga:socialActivityAction - 如果是社交資料中心活動，此字串代表與活動相關的社交動作類型 (例如投票、留言、+1 等)。
    • 灰色 - ga:socialActivityNetworkAction - 如果是社交資料中心活動，此字串代表社交動作的類型和來源的社群網路。
    • 全部 - ga:socialActivities：在社交資料中心夥伴網路上分享/提及內容網址的活動次數。

社交互動

  • 這項資料來自站內社交互動追蹤。
    • 調暗 - ga:socialInteractionAction - 用於社交互動字串，代表所追蹤的社交動作 (例如 +1、喜歡、加入書籤)
    • Dim - ga:socialInteractionNetwork - 用於社交互動的字串，代表目前追蹤的社群網路 (例如 Google、Facebook、Twitter、LinkedIn)
    • Dim - ga:socialInteractionNetworkAction - 用於社交互動的字串，代表目前追蹤的 ga:socialInteractionNetwork 和 ga:socialInteractionAction 串連 (例如 Google：+1、Facebook：喜歡)
    • 暗灰色 - ga:socialInteractionTarget - 用於社交互動的字串，代表收到社交網路動作的網址 (或資源)。
    • 交涉 - ga:socialInteractions - 您網站上的社交互動總數。
    • 交涉 - ga:uniqueSocialInteractions：你網站上的不重複社交互動總數。根據 ga:socialInteractionNetwork 和 ga:socialInteractionAction 值組合
    • 我找到 - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions。您網站每次造訪的平均社交互動次數。

地理區域 / 聯播網

  • 顏色 - ga:metro：流量來源的指定行銷區域 (DMA)。

網頁追蹤

  • 灰色 - ga:pagePathLevel1 - 這個維度會累計 pagePath 中第一個階層層級的所有 pagePath。
  • 灰色 - ga:pagePathLevel2 - 這個維度會累計 pagePath 中第二個階層層級的所有 pagePath。
  • 灰色 - ga:pagePathLevel3 - 這個維度會累計 pagePath 中第三階層層級的所有 pagePath。
  • 灰色 - ga:pagePathLevel4 - 這個維度會累計 pagePath 第四個階層層級的所有 pagePath。pagePath 階層中的所有額外層級也會累計到這個維度中。

例外狀況追蹤

  • 這項資料來自例外狀況追蹤資料。

    • 達成 - ga:exceptions：已傳送至 Google Analytics (分析) 的例外狀況次數。
    • Met - ga:fatalExceptions：isFatal 設為 true 的例外狀況數量。

使用者載入時間

  • 這項資料來自使用者時間資料。

    • 調暗 - ga:userTimingCategory - 將所有使用者時間變數分類到邏輯群組的字串，以便製作報表。
    • Dim - ga:userTimingLabel - 表示所追蹤資源動作名稱的字串。
    • 暗灰色 - ga:userTimingVariable - 在報表中以視覺化方式呈現使用者時間的彈性字串。
    • 調暗 - ga:userTimingValue 傳送至 Google Analytics (分析) 的經過時間毫秒數。
    • 確實 - ga:userTimingSample：傳送的樣本數量。
    • 總和 - ga:avgUserTimingValue - 平均使用者載入時間值。ga:userTimiingValue / ga:userTimiingSample。

裝置 / 平台

  • 這項資料來自所收集資料的使用者代理程式。
    • 灰色 - ga:mobileDeviceBranding - 行動裝置製造商或品牌名稱 (例如 Samsung、HTC、Verizon、T-Mobile)。
    • 調暗 - ga:mobileDeviceModel - 行動裝置型號 (例如：Nexus S)
    • 調暗 - ga:mobileInputSelector - 行動裝置使用的選取器 (例如：觸控螢幕、搖桿、點按式轉盤、觸控筆)
    • Dim - ga:mobileDeviceInfo - 用來識別行動裝置的品牌、型號和行銷名稱。

這個版本包含：

  • 修正錯誤：

    • 移除 NoThumb 版本的程式庫。
    • 停止支援 armv6。

  • 新功能：

    • 新增 armv7s 支援 (適用於 iPhone5)。

這個版本包含：

  • 修正錯誤：
    • 修正從 1.5 以下版本的 SDK CV 遷移至 1.5 SDK 自訂變數的問題。
    • 遵循使用者的背景資料限制設定。

這個版本包含：

  • 修正錯誤：
    • GANTrackerDelegate 通訊協定方法現在是選用項目。
    • 事件現在包含上次追蹤的網頁瀏覽 (utmp)。
  • 新功能：
    • 支援最多 50 個自訂變數 (注意：這項功能僅適用於 Google Analytics Premium 使用者)。
    • 更新 BasicExample 範例應用程式。

這個版本包含：

  • 修正錯誤：

    • 修正記憶體流失問題。
    • 事件現在包含上次追蹤的網頁瀏覽 (utmp)。

  • 新功能：

    • 支援 50 個自訂變數 (注意：這項功能僅適用於 Google Analytics Premium 使用者)。

這個版本包含：

  • 在 GAITracker 中加入社交追蹤方法：
    • trackSocial:withAction:withTarget:
  • 時間方法簽章已變更為：
    • trackTiming:withValue:withName:withLabel:
  • 在 GAITracker 中新增手動建構和分派方法：
    • set:value:
    • get:
    • send:params:
  • 在 GAITracker 中新增自訂維度 setter 方法：
    • setCustom:dimension:
    • setCustom:metric:
  • 重構資料儲存庫的架構，以防止回報的 CoreData 問題。

這個版本包含：

  • 新增對自訂維度和指標的支援。
  • 新增對社交互動追蹤的支援。
  • 已將StandardExceptionParser的課程設為公開
  • 修正 SDK 初始化期間偶爾當機的問題。
  • 修正了部分裝置上忽略的 INSTALL_REFERRER 廣播訊息。
  • 已修正 GoogleTracker 類別中的 ConcurrentModificationExceptions。
  • 其他錯誤修正和改善項目

這是 Multi-ChannelFunnel Reporting API 的初始版本：

  • 使用這個新的 API，即可要求已驗證使用者的多管道漏斗資料。資料擷取自轉換路徑資料，其中會顯示使用者在完成轉換前，與多種流量來源的互動情形。進而分析多個行銷管道在一段時間內對轉換的影響。如要進一步瞭解該 API 提供哪些資料及 API 的使用方式，請參閱「Multi-ChannelFunnel Reporting API」。

這個版本包含：

  • 已更新為最新的線路格式。
  • sampleRate 已變更為雙精度浮點值。
  • 追蹤過多的次數受到限制。
  • 如果啟用選擇不採用，系統就會刪除未分派的追蹤資訊。
  • 系統將刪除超過 30 天的未分派追蹤資訊。
  • 強化功能來達到調度工具。
  • 調度工具會在連線中斷時使用 Reachability API，在連線恢復後接收通知，而不是定期重試。
  • 已更新範例應用程式。
  • 其他錯誤修正和強化功能。

這個版本包含：

  • 簡化的 EasyTracker 介面。
  • 分派的控制項已移至新類別 GAServiceManager。
  • 已更新為最新的線路格式。
  • sampleRate已變更為雙精度浮點值。
  • 追蹤過多的次數受到限制。
  • 如果啟用選擇不採用，系統就會刪除未分派的追蹤資訊。
  • 系統將刪除超過 30 天的未分派追蹤資訊。
  • 其他錯誤修正和強化功能。

修正錯誤

  • API 現在可正確處理篩選器或動態區隔中的 UTF-8 字元。

這個版本包含：

  • 新增未偵測到的例外狀況處理功能。
  • 已從 GAI 中移除 dispatchEnabled 資源。
  • 在 GAI 中新增 defaultTracker 屬性。
  • 已將 close 方法新增至 GAITracker
  • 已將時間追蹤方法新增至 GAITracker。
  • 已將 trackView 方法新增至沒有引數的 GAITracker。
  • 交易項目欄位名稱已更新。
  • 已更新為最新的線路格式。
  • 系統會將事件值解讀為 64 位元整數。
  • ARMV6 程式碼產生方式已從 THUMB 切換為 ARM。

這個版本包含：

  • 移除了 startSession 方法。改用 setStartSession。
  • 已將 ga_sessionTimeout 參數新增至 EasyTracker。
  • 已實作省電模式。
  • 已將 trackView 方法新增至沒有引數的 GAITracker。
  • 修正導致命中時無法傳送例外狀況參數的錯誤。
  • 無法讀取資料庫中的命中資料會遭到捨棄，而非永久封鎖所有命中資料，因此無法分派。
  • 已更新為最新的線路格式。
  • 已導入時間命中類型。
  • 已導入的電子商務命中類型 (交易和項目)。

這個版本可讓 Google Analytics Premium 帳戶存取最多 50 個自訂變數。

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

  • 允許的網站速度取樣率上限 (_setSiteSpeedSampleRate) 已從 10% 調高為 100%。
  • _setAccount 方法現在可移除開頭和結尾的空格。

這個版本修正了 2 項錯誤：

修正錯誤

  • 包含規則運算式中的特殊字元的查詢篩選器不會再傳回伺服器錯誤。

  • 合併指標篩選器與進階區隔不會再傳回錯誤。

這個版本在 API 中加入新的網站速度指標。

新指標

  • 新增下列網站速度指標：
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

請參閱維度和指標參考資料瞭解定義。

API 2.3 版淘汰提醒

  • Data Export API 的 2.3 版已淘汰 2 個月。我們將於大約 4 個月後關閉這項服務，而且只支援新的 Core Reporting API 3.0 版和2.4 版。

  • 我們強烈建議您將應用程式遷移至 3.0 版。

  • 在 4 個月內，系統會將傳送至舊版 2.3 XML 資料動態饋給的要求轉送至 2.4 版，並傳回 2.4 版的 XML 回應。屆時，所有 2.4 版本的配額政策，都適用於 2.3 版要求。

  • 凡是有關 2.3 JSON 版本或使用 2.3 JSON 輸出版本的 Google Data JavaScript 用戶端程式庫要求，都會傳回 404 狀態碼。

  • 如要取得完整配額，無論使用 3.0 版和 2.4 版，您必須在 Google API 控制台註冊應用程式，並在每次要求中使用 API 金鑰 (或 OAuth 2.0 權杖)。

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

  • 更新系統預設偵測到的自然搜尋引擎清單。新增了「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」

我們修正了 ga:visitLength 的小錯誤。這個維度現在會傳回正確的資料。

這個版本為 Management API 新增實用的錯誤回應。

  • API 錯誤回應內文已新增錯誤代碼、原因和說明。所有程式碼都已記錄在 Management API 2.4 版和版本 3.0 等版本中。

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

  • 自訂變數的長度上限已從 64 個半形字元提高為 128 個半形字元。此外，現在系統會在網址編碼前檢查長度。
  • 已放寬事件命中的頻率限制。您現在可以傳送 10 筆命中，以及每秒額外 1 次命中 (先前限制為每 5 秒命中 1 次)。請注意，「單次工作階段命中」上限為 500 次命中。
  • __utmv Cookie 現在會用不同的變數分隔符 (脫字符號而非半形逗號) 編寫，以便與 RFC 相容。這應該能修正部分有關客戶所見 Cookie 編碼問題的問題。

這個版本會影響所有 Google Analytics (分析) API 開發人員。它會宣布兩個新的 API 版本，要求應用程式註冊新的配額政策，並將其 API 名稱變更為 Core Reporting API。最後，此版本將淘汰現有的 Data Export API 2.3 版。

3.0 版

  • Core Reporting API 3.0 版是 API 的最新主要版本，無法回溯相容。日後所有開發 API 都將透過這個版本完成。

  • 新功能

    • 以新的 JSON 為基礎的輸出內容，可將先前 XML 輸出內容的回應大小縮減約 10 倍。
    • 新增支援 Java、JavaScript、Python、PHP、Ruby 和 .Net 的 Google API 用戶端程式庫。
    • 支援 Google Discovery API。
    • 支援 OAuth 2.0，這是我們推薦的新使用者授權方式。

  • 更新

    • 用於提出要求的新網址：https://www.googleapis.com/analytics/v3/data/ga…。
    • 必須提供註冊和開發人員權杖。
    • 所有設定資料要求都應透過 Management API 完成。

2.4 版

  • Core Reporting API 2.4 版是次要版本，與現有資料匯出 API 2.3 版大致相容。

  • 更新

    • 要提出要求的新網址：https://www.googleapis.com/analytics/v2.4/data…
    • 必須提供註冊和開發人員權杖。
    • XML 輸出內容與 2.3 版一致，因此其他現有的 Google 資料用戶端程式庫將繼續運作。
    • 配額錯誤的錯誤代碼已從「503」變更為「403」
    • 不支援 JSON 回應。
    • 不支援 Google Data JavaScript 用戶端程式庫。
    • 沒有帳戶動態饋給。所有設定資料要求都應透過 Management API 完成。

註冊

  • 凡是使用 Google Analytics (分析) API 建構的應用程式，都必須透過 Google API 控制台註冊為專案。

  • 每個對 API 提出的要求都必須包含 API 金鑰或 OAuth 2.0，用戶端 ID 和用戶端密鑰。

配額政策

  • 下列配額同時適用於 Anlaytics API (Management API 和 Data Export API)

    • 每個專案每日 50,000 個要求
    • 每個 IP 位址每秒 10 次查詢 (QPS)

  • 下列配額適用於 Data Export API

    • 每個設定檔每天 10,000 個要求
    • 每個設定檔 10 個並行要求

  • 對於未註冊的應用程式，我們提供極低的寬限期配額，用意是讓少量的測試能夠順利進行。

淘汰項目

  • 此外，這個版本也宣布淘汰 2.3 版，並將近期停用資料匯出 API 中的帳戶動態饋給。6 個月後：

    • 系統會將傳送至 2.3 版 XML 資料動態饋給的要求轉送至 2.4 版，並傳回 2.4 版回應。屆時，所有 2.4 版本的配額政策，都適用於 2.3 版要求。

    • 2.4 版回應不支援對 2.3 版 JSON 輸出的要求，且會回傳 404 Not Found 狀態碼。如需 JSON 回應，請升級至 3.0 版。

    • 針對資料匯出 API 中帳戶動態饋給發出的要求會傳回 404 Not Found 狀態碼。所有設定資料要求都應透過 Management API 完成。

此版本新增資料、變更現有功能並修正錯誤。

新資料

  • 進階區隔集合現在包含 segmentId 欄位，可用於資料匯出 API 區隔參數。

異動

  • 「max-results」的資料類型已變更為「integer」。

  • max-results 的預設值和最大值已變更為 1000。

修正錯誤

  • 「Google 網站最佳化工具」實驗的帳戶、網站資源和設定檔不再包含在相應的集合中。

這個版本包含：

  • 說明文件：

    • ReadMe.txt 已更新，現在可指向網站查看說明文件。

這個版本包含：

  • 修正錯誤：
    • 修正 Google Play 到達網頁網址自動追蹤的處理方式。
    • 允許 setReferrer 的參照網址參數進行網址編碼。

網站速度資料收集功能異動：

  • 系統現在會自動為所有網站資源收集網站速度資料，取樣率為 1%。_trackPageLoadTime 函式 (先前選擇採用網站速度資料收集功能) 現已淘汰。
  • 您可以使用新的 _setSiteSpeedSampleRate 函式調整預設取樣率。
  • 如果 _trackPageview 呼叫中使用了虛擬路徑，該路徑現在也會與從該網頁收集的所有網站速度資料建立關聯。

這個版本包含：

  • 修正錯誤：
    • 已將資料庫的位置從「文件」目錄變更為「程式庫」目錄。
    • 針對 SQLite 資料庫錯誤，SDK 不會再擲回 NSAsserts。
    • 修正在使用空字串呼叫 trackPageview 時異常終止的問題。
    • 修正了在呼叫 stopTracker 後呼叫各種 GANTracker 方法時發生的當機問題。
    • 修正多項記憶體流失問題，包括一個使用開頭為「/」的 pageURL 呼叫 trackPageview。
  • 新功能：
    • 新增了 dispatchSynchronously 方法。
    • 揭露了幾個實用的常數 (請參閱 GANTracker.h)。

這個版本包含：

  • 修正錯誤：
    • 綁定和處理多個 SQLiteExceptions。
    • 修正了在呼叫 startNewSession 之前呼叫 stopSession 中的 NullPointerException。
    • 修正 HTC Thunderbolt 和 Motorola Droid Bionic 裝置上的記憶體不足錯誤。
    • 清除分派方法中不必要的資料庫存取權。

這個版本包含下列新功能：

  • 只要將 _trackEvent() 方法的新 opt_noninteraction 參數設為 true，即可將事件標示為非互動。事件一旦被標記為非互動，所產生的點擊就不會影響跳出率。詳情請參閱 ga.js 參考資料。

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

  • 修正問題：將 AdWords gclid 網址參數加進內部網站連結，可能會導致付費造訪次數增加。

這個版本新增了更即時的 AdWords 資料，並提供更多 AdWords 維度和指標的組合。

  • AdWords 資料現在會在 1 小時內更新。資料每日更新前。

  • 我們已放寬 AdWords 資料的一些有效組合限制。

我們已在幾週前進行變更，禁止要求以 ga:adGroup 或 ga:adContent 要求 ga:impressions 的 API 查詢，因為該組合傳回 0。經過這項變更，此組合現已恢復，且已經傳回正確的資料。

這個版本包含：

  • 修正錯誤：
    • 修正了嘗試在啟動追蹤器之前設定 dryRun 旗標時發生的匯流錯誤。
    • 修正了嘗試傳遞 NULL 以發生錯誤時發生的公車錯誤。
    • 請在 HTTP 標頭中使用正確的語言。
  • 新功能：
    • 已新增 anonymizeIp 旗標。
    • 新增了 sampleRate 參數。
    • 新增對廣告活動參照連結網址的支援。

這個版本包含：

  • 修正錯誤：
    • 修正一般廣告活動參照連結網址追蹤的錯誤。
    • 修正 anonymizeIp 標記幹擾廣告活動追蹤的問題。

這個版本新增兩個包含許多新功能的新版 API，但已淘汰舊版本。這些變更會影響您向 API 要求和處理資料的方式。

3.0 版

  • 這是最新的 API 主要版本，無法回溯相容。日後所有開發 API 都將透過這個版本完成。

  • 新資料

    • 事件目標的完整呈現
    • 內部網站資源 ID，可用來深層連結到 Google Analytics (分析) 使用者介面
    • 預設網頁和網站搜尋查詢參數的設定檔設定

  • 異動

2.4 版

  • 這是次要版本升級，大部分與現有的 2.3 版回溯相容。

  • 異動

    • 新的配額政策
    • 與 Google API 控制台整合，管理 API 存取權及要求提高配額
    • 持續支援現有授權機制和 OAuth 2.0
    • 要提出要求的新網址：https://www.googleapis.com/analytics/v2.4/management/…
    • 僅限 XML 中的回應
    • 不支援 Google Data JavaScript 用戶端程式庫
    • XML 輸出內容與 2.3 版一致，因此其他現有的 Google 資料用戶端程式庫將繼續運作。

淘汰

  • 我們宣布淘汰 Management API 舊版 2.3 版。該指令碼會繼續運作兩個月，之後所有 v2.3 要求都會傳回 v2.4 回應。

此版本修正了一項錯誤，該錯誤會造成某些網站的造訪次數偏高和/或減少新訪客數。第一項影響主要是影響網站自然流量和特定使用者行為的網站。第二種影響只有在網站採用不支援的追蹤設定，而具有多個追蹤器才能運作。

這個版本修正了部分無效的維度和指標組合

修正無效指標/維度組合

  • 我們上個月公布了幾項 API 的近期變更，禁止資料動態饋給中部分不傳回任何資料的無效查詢。我們已經對 API 進行此類變更，因此下列組合現已失效：

    • 產品維度無法與交易指標合併使用。
    • ga:adContent 或 ga:adGroup 無法與 ga:impressions 合併。

    現在 API 不會傳回傳回 0 的結果，而是對要求這些組合的所有查詢傳回 400 錯誤代碼。

工作階段計算功能異動：

  • 每個工作階段各有一個廣告活動：如果新廣告活動在現有工作階段期間開始放送，追蹤指令碼現在會自動開啟新的工作階段。下列欄位的任何變更都會觸發新的廣告活動：廣告活動 ID、名稱、來源、媒介、字詞、內容或 gclid。
  • 即使使用者關閉瀏覽器，追蹤指令碼也不會再啟動新的工作階段。

跨網域追蹤異動：

  • 設定跨網域追蹤時，不再需要呼叫 _setAllowHash(false)。已包含呼叫 _setAllowHash(false) 的網頁會繼續運作，但設定新網站時已不再需要。
  • 追蹤指令碼現在會嘗試修復遭到 HTTP 重新導向器和瀏覽器破壞的連結器參數。目前因為重新導向器和瀏覽器造成編碼改變而被捨棄的連結器值，現在大約有 85% 應可成功復原，且可用於追蹤指令碼。

這個版本包含：

  • 修正錯誤：
    • 修正資料庫處理的幾個問題。
    • 修正使用自訂變數時發生的例外狀況。
    • 保留應用程式結構定義，而非傳入的內容。
    • 移除意外建立慈善工作階段的功能。
  • 新功能：
    • 新增隨時設定廣告活動參照連結網址的功能
    • 已新增sampleRate標記
    • 已新增anonymizeIp標記

這個版本包含一個新功能：

  • 追蹤程式碼現在會延遲預先算繪網頁的命中，直到使用者瀏覽這些網頁。如果使用者從未查看預先算繪頁面，系統就不會傳送任何命中。這項功能只提供給使用非同步追蹤指令碼的網站使用。如要進一步瞭解預先算繪功能，請參閱 Google 網站管理員中心網誌。

這個版本包含各種錯誤修正和重構，以及一項新功能：

這個版本已淘汰指標中的信賴區間值。

淘汰信賴區間

  • 如果您尚未這麼做，請停止在指標中使用信賴區間值。這個版本推出後，資料匯出 API 資料動態饋給會針對所有信賴區間值傳回 0.0。大約在一個月左右，我們會將這個屬性從所有指標元素中徹底移除。

    如要判斷回應是否已取樣，請使用回應中的 includeSampledData 欄位。

這個版本包含：

  • 修正錯誤：
    • 修正使用自訂變數時發生的當機問題。
    • 修正使用自訂變數時發生的記憶體流失問題。
  • 新功能：
    • 開始支援電子商務命中。
    • 已新增 Debug 旗標。
    • 已新增 DryRun 旗標。
    • 針對 SQLite3 失敗提供更多描述性的錯誤資訊

這個版本包含：

  • 修正錯誤：

    • 已修正格式錯誤的 userAgent 字串。

  • 新功能：

    • 開始支援電子商務追蹤
    • 已新增debug標記
    • 已新增dryRun標記

這個版本新增 3 個指標，並更新兩個指標的傳回值。

最新資料更新

  • 我們在 API 中新增了 3 項用來處理網站速度成效的指標：
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

指標更新

  • 若要在篩選器中指定貨幣值，您必須指定從追蹤程式碼傳送的實際值 (例如，現在 1 個單位會指定為 1)。

  • ga:CTR 現在會傳回實際的百分比 (例如，2% 的值會傳回 2)。

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

  • 修正跨網域追蹤中會導致在某些情況下廣告活動資料編碼不正確的錯誤。
  • 修正跨網域追蹤錯誤，此錯誤會導致系統從網址重複載入 Cookie，在某些情況下會造成 Cookie 不正確。
  • 修正自訂變數中會導致部分值在報表中編碼的錯誤。

這個版本包含：

  • 修正錯誤：

    • 修正空格編碼錯誤。
    • SQLiteExceptions 不會再導致應用程式當機。

  • 新功能：

    • 新增對自訂變數的支援

此版本改善了資料動態饋給效能並新增新資料：

效能提升

  • 這個版本讓資料動態饋給的延遲時間減少 30 至 35%。

最新資料更新

  • 我們更新了「進階區隔」允許的維度和指標清單，請參閱更新後的清單，確認您的要求有效。

近期異動

  • 目前，必須以微量單位來指定貨幣篩選器值 (例如 1 個貨幣單位指定為 1000000)。在不久的將來，您必須指定從追蹤程式碼傳送的實際值 (例如，現在有 1 個單位會指定為 1)。

  • ga:CTR 目前是 percent，並傳回 0.02 值。在不久的未來，這項變更將傳回實際百分比 (例如 2)。

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

這個版本包含更新和一項新功能。

  • 「POST」支援：

    • 追蹤程式碼現在可以傳送更大的追蹤信標。過去，信標是透過 HTTP GET 要求傳送，但某些瀏覽器和 Proxy 的長度上限為 2048 個字元。系統已捨棄超出這個上限的要求，且資料從未達到 Google Analytics (分析)。從這個版本開始，系統將透過 HTTP POST 傳送超過 2048 個字元的要求，但不適用上述限制。追蹤程式碼現在支援最多 8192 個字元的信標。

這個版本會在資料動態饋給中加入更多資料：

最新資料更新

  • 已新增下列時間維度：ga:dayOfWeek

  • 已新增下列內部搜尋指標：ga:percentVisitsWithSearch

  • 已新增下列「事件追蹤」指標：

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

近期異動

API 目前會針對各種授權問題傳回 401 狀態碼。在接下來幾週內，401 狀態將只用於無效權杖，讓開發人員能處理此特定例外狀況。

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

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

這個版本包含：

  • 新功能：
    • 新增對自訂變數的支援。
    • 新增了 NoThumb 程式庫版本。

這個版本為資料動態饋給新增了大量資料：

最新資料更新

  • ga:visitors 的計算方式已變更，以傳回日期範圍內的不重複訪客人數，且現在支援更多維度和指標組合。

  • 已新增 10 個 AdWords 維度：ga:adDistributionNetwork、ga:adMatchType、ga:adMatchedQuery、ga:adPlacementDomain、ga:adPlacementUrl、ga:adFormat、ga:adTargetingType、ga:adTargetingOption、ga:adDisplayUrl、ga:adDestinationUrl。

  • 已將指標「ga:organicSearches」新增至廣告活動群組。

  • 已將指標「ga:searchResultViews」新增至內部網站搜尋群組。

  • 已新增 3 個以時間為準的維度：ga:nthDay、ga:nthWeek、ga:nthMonth。

  • 維度和指標的分組方式經過調整，以更準確地反映它們所代表的功能。

新的計算指標

下列計算指標是根據基本指標計算而得。注意：每個含有 (n) 的名稱支援值 1 到 20。

  • 目標導向：ga:costPerConversion、ga:costPerGoalConversion、ga:costPerTransaction、ga:goal(n)AbandonRate、ga:goal(n)Abandons、ga:goal(n)ConversionRate、ga:goalAbandonRateAll、ga:goalAbandonsAll、ga:goalConversionRateAll、ga:goalValueAllPerSearch、ga:goalValuePerVisit。

  • 內容根據：ga:entranceBounceRate、ga:visitBounceRate、ga:entranceRate、ga:exitRate、ga:pageviewsPerVisit、ga:avgTimeOnPage、ga:avgTimeOnSite、ga:avgEventValue。

  • 內部網站搜尋：ga:avgSearchDepth、ga:avgSearchDuration、ga:avgSearchResultViews、ga:searchGoalConversionRateAll、ga:searchGoal(n)ConversionRate、ga:searchExitRate。

  • 電子商務型：ga:itemsPerPurchase、ga:margin、ga:percentNewVisits、ga:revenuePerItem、ga:revenuePerTransaction、ga:ROI、ga:RPC、ga:totalValue、ga:transactionRevenuePerVisit、ga:transactionsPerVisit。

這個版本為資料動態饋給新增功能：

新功能

  • 新增 XML 元素，可讓使用者瞭解資料是否已取樣。true。這個元素一律會傳回資料是否已使用 true 或 false 取樣。Java 和 JavaScript 程式庫也已更新，加入輔助方法來存取此元素。

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

這個版本包含：

  • 新功能：

    • 開始支援 iOS4

這個版本修正了 2 項錯誤：

修正錯誤

  • 先前在包含維度的篩選器運算式中加入 OR 運算子 (即ga:keyword==store,ga:keyword==bar) 結果可能會與分別套用到多項查詢時產生不同的值，我們已修復這個問題，現在使用 OR 運算子會傳回一致的值。

  • 部分無效篩選器的 API 錯誤訊息已更新為「不包含」是導致錯誤的維度或指標篩選器 (但仍會傳回實際的違規篩選器運算式)。

這是 Google Analytics Management API 的 Beta 版！

新動態饋給

已更新的用戶端程式庫

  • Management API 發布在與 Google Analytics (分析) 資料匯出 API 相同的程式庫中。Google Data Java 和 JavaScript 程式庫都已更新。如要存取每個動態饋給，請為 getManagementFeed() 方法指定適當的動態饋給 URI。

新增說明文件

  • 我們新增了 Google Analytics (分析) 開發人員文件章節，說明新版 Management API 的運作方式。

這個版本修正了 3 項錯誤：

修正錯誤

  • 修正 JavaScript 用戶端程式庫的編碼問題。Analytics (分析) Issue Tracker

  • 先前因目標名稱、目標路徑、目標比較值或目標比較類型設定錯誤而導致帳戶動態饋給無法傳回的錯誤現已修正。

  • 在資料動態饋給查詢篩選器參數中，維度和指標無效。例如：ga:source==google,ga:visits>5。這項無效查詢的錯誤訊息已更新為：Cannot OR dimension filter(s) with metric filter。

此版本新增資料並修正錯誤：

新功能

  • 新類別 D8. Adwords 中新增了下列 5 個維度：

修正錯誤

  • 我們修正了「帳戶動態饋給」在其中一個設定檔的目標或步驟設定錯誤時未傳回資料的問題。

這個版本包含錯誤修正並清除 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 變更，請參閱追蹤器參考資料。

此版本新增許多功能並修正錯誤：

新功能

  • iPhone 預設區隔 (gaid::-11) 已經過改良，現在可記錄所有行動裝置的資料。ID 與先前相同 (-11)，但區隔名稱現在為：Mobile Traffic。

  • 現在 API 使用的取樣率與網頁介面相同。如此一來，取樣報表的資料就會內嵌於網頁介面，同時提高兩者之間的一致性。

  • 我們更新了配額政策，確保所有使用者都能享有平等的資源存取權。詳情請參閱配額政策說明文件。新政策如下：

    • 一個網站資源每 24 小時最多可提出 10,000 個請求。
    • 應用程式在任何指定的 1 秒內只能提出 10 個要求。
    • 每個應用程式一次最多只能有 4 個待處理的要求。

  • 我們已經放寬部分維度和指標組合的限制。ga:nextPagePath和ga:previousPagePath現已加入「D3. Content」群組。D8. Custom Variable 群組現已改名為 D6. Custom Variable 群組。請參閱更新版參考指南，瞭解這些新組合。

修正錯誤

  • 我們修正了 API 回報指標 confidenceInterval 值的方式錯誤。先前信賴區間的值可能是 INF，或是介於 0 到 1 之間的數字。現在，所有信賴區間的值都會是 INF 或大於或等於 0 的數字。

  • ga:itemQuantity 和 ga:uniquePurchases 先前已交換並傳回彼此的值。現在這些程式碼已經修正，以便傳回正確的資料。

淘汰維度和指標的提醒

  • 如果您尚未使用已淘汰的維度和指標，請予以停止

此版本新增許多功能：

這個版本會將主要版本號碼遞增為 2

  • 部分功能需要使用最新版用戶端程式庫。我們正式支援 Java 和 JavaScript。第三方程式庫可能尚未更新。

    • 如要申請第 2 版，您可以在每個帳戶或資料動態饋給要求中加入標頭 GData-Version: 2。詳情請參閱說明文件。
    • 同時在帳戶和資料動態饋給中加入了新的 XML 命名空間：
      xmlns:ga='http://schemas.google.com/ga/2009'

  • API 現已支援 Google Data 通訊協定第 2 版。

進階區隔支援

  • 動態區隔查詢參數：

    • ...&segment=dynamic::運算式
    • 可讓您「隨時」建立進階區隔。
    • 運算式可以是任何維度或指標，且語法應與篩選器相同。

  • 預設和自訂區隔查詢參數：

    • ...&segment=gaid::數字
    • 其中數字是 Google Analytics (分析) 網頁介面中定義的進階區隔 ID。
    • ID 可在帳戶動態饋給中找到。

  • 帳戶動態饋給會透過下列 XML 元素和屬性來區隔資料：

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>

  • 資料動態饋給也會提供 XML 元素，指出 API 要求中是否套用了區段。

  • 如要進一步瞭解進階區隔，請參閱說明文件。

有新的目標資料可供查看

  • 帳戶動態饋給中可用的到達網頁和參與度類型目標：

    • <ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
    • <ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
    • <ga:step number="1" name="Login" path="/login.html"></ga:step>
    • <ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>

  • 目標 5 到 20 皆已新增 48 個新的目標指標，這些指標皆遵循 goal(n)Completions 慣例，其中 (n) 代表介於 1 到 20 之間的數字。

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value

  • 為配合新目標資料，GoalCompletionAll、GoalStartsAll和GoalValueAll已更新。

新增自訂變數資料

  • 在帳戶動態饋給中，每個設定檔收集的所有自訂變數都已新增為帳戶動態饋給的新 XML 元素：

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>

  • 已為自訂變數新增 10 個維度。這些變數會遵循 customVar(n) 慣例，其中 (n) 可以是介於 1 到 5 之間的數字。

    • ga:customVarName(n)
    • ga:customVarValue(n)

已淘汰的維度和指標即將移除！

  • 如果您尚未使用已淘汰的維度和指標，請予以停止。我們將於近期內移除這些事件，並會在收到要求時從我們的 API 傳回錯誤。

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • 下列維度已重新命名：

    • ga:countOfVisits 現在是 ga:visitCount
    • ga:countOfVisitsToATransaction 現在是 ga:visitsToTransaction

這個版本包含預設搜尋引擎清單更新，以及控制 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 或功能將維持不變。

此版本新增功能並淘汰了部分舊功能：

  • 以下維度和指標現已淘汰。並將於一個月內從 API 中永久移除。請務必更新您的程式碼，以免應用程式中斷：

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • 下列維度已重新命名：

    • ga:countOfVisits 現在是 ga:visitCount
    • ga:countOfVisitsToATransaction 現已改為 ga:visitsToTransaction

  • 所有事件追蹤資料現在都會顯示為 2 個新群組：

    D7：事件 (維度) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7：事件 (指標) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • 整體網站導覽資料現在會透過下列維度顯示：

    D6：導覽 * ga:previousPagePath * ga:nextPagePath

  • 到達網頁瀏覽方式現在可透過下列維度顯示：

    D3：內容 * ga:landingPagePath * ga:secondPagePath

  • 資料動態饋給篩選器查詢參數中的規則運算式長度上限已從 32 個字元提高為 128 個字元。

  • 「造訪時間長度」報表 (在使用者介面的「訪客」->「訪客忠誠度」下) 現在會使用新的維度顯示：

    • ga:visitLength

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

  • 針對自然搜尋的搜尋字詞、網頁路徑資訊 (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)

這個版本更新了 Google Analytics (分析) 資料匯出 API，如下所示：

  • 我們已經放寬部分維度和指標組合的限制。您現在可以同時查詢大部分內容和訪客層級維度，例如 ga:pagePath 和 ga:source 現已成為有效組合。請參閱新版的參考指南，瞭解這些新組合：http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • 單一要求中可要求的資料列總數已增加到 10,000 列。預設傳回的資料列數量仍為 1,000 列，但現在只要設定 max-results 查詢參數，就能增加資料列數量。

  • 帳戶動態饋給現在為每個表格 ID (貨幣和時區) 傳回兩個新的資料元素。
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

  • 現在我們將強制執行資料查詢，至少需包含一個有效指標。

  • 先前所有的淘汰變更都已生效。

這個版本移除了非公開 Beta 版中已淘汰的功能：

  • 帳戶動態饋給要求不再支援使用者名稱。而是只接受以下格式的要求：
    https://www.google.com/analytics/feeds/accounts/default

  • 下列指標即將移除，將無法再運作。不過，我們在以下網址提供瞭如何計算這些值的指示：http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga：已放棄漏斗 1
    • ga：已放棄漏斗 2
    • ga:nnedFunnels3
    • ga:資源的放棄程序 4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit

  • 下列維度和指標已重新命名。舊名稱將會失效。請前往以下網頁，確認文件使用的是正式名稱：http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    Dimensions * ga:subContinentRegion 在 Ъ ga:subContinent * ga:organization 恭喜 ga:networkLocation * ga:domain YOU ga:networkDomain * ga:visitNumber 資料庫 ga:countOfVisits * ga:operatingSystem * ga:platformVersion Keyword: 錯失搜尋，在

    指標 * ga:new 曾經瀏覽 天前：在 ꛭ 的定義：在 的定義中 * 下列資訊 提供的服務 * 一台 欄位中輸入 1 影音 的定義： 在 的定義中 * 的定義： 以下內容 zh: 從 受到影響 1 的定義中 * 的定義：在 的定義中：** 第 1 次 成功**