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

本頁面說明對所有 Google Analytics (分析) API 和 SDK 所做的變更。其中涵蓋所有收集、回報和設定的變更記錄。 建議您定期查看這份清單，確認是否有新的公告。您也可以透過下方「訂閱」部分列出的動態饋給訂閱變更。

訂閱相關變更記錄

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

包含所有集合、設定和 Reporting API。

這是 User Activity API 的初始版本

  • User Activity API 可讓您擷取指定日期範圍內單一用戶端 ID 或 User-ID 的所有相關資料。如果資源擁有者想為使用者提供自動存取使用者資料的功能，主要是做得到的支援。詳情請參閱 User Activity API 指南。

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

現在可以使用在 WebProperty 資源中新增的「dataKeepTtl」和「dataKeepResetOnNewActivity」欄位，以程式輔助的方式設定使用者資料保留設定。

這是 User Deletion API 的初始版本：

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

在 Management API 中寫入作業

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

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

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

使用 Analytics (分析) Real Time Reporting API 呼叫，每個資料檢視 (設定檔) 每日呼叫 10,000 次，與其他 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://」網址新增為有效的參照連結網址來源。

這個版本會新增新的 customTask 工作。

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

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

  • 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 點擊名稱 (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickAdvertiserId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 ID (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickCreativeId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 ID (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickExchange - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊名稱 (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickExchangeId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 ID (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickInsertionOrder - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊在 DBM 廣告訂單名稱 (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickInsertionOrderId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 ID (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickLineItem - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊名稱 (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickLineItemId - 與 Google Analytics (分析) 工作階段相符的 DBM 點擊 ID 的 DBM 委刊項 ID (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickSite - 顯示與 Google Analytics (分析) 工作階段相符的 DBM 點擊和點擊的 DBM 網站名稱 (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmClickSiteId - DBM 網站 ID (用於顯示與 Google Analytics (分析) 工作階段相符的 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 - DBM 網站名稱，在與 Google Analytics (分析) 工作階段相關的最後一個 DBM 事件 (在 DBM 回溯期內曝光或點擊) 會顯示並獲得點擊 (僅限 Analytics (分析) 360，需要與 DBM 整合)。
  • 維度 - ga:dbmLastEventSiteId - DBM 網站 ID (用於與 Google Analytics (分析) 工作階段相關聯的最後一個 DBM 事件 (在 DBM 回溯期內曝光或點擊) 顯示並獲得點擊) (僅限 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 - 廣告客戶對每次點擊付費 (僅限 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 - 購物車內購物交易的交易 ID。

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

地理位置網路

  • 維度 - ga:continentId - 使用者洲別 ID，衍生自使用者的 IP 位址或地理區域 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 個維度。
  • 針對請求中允許的維度總數，資料透視維度是限制的一部分。
  • 針對請求中允許的指標總數，資料透視指標是上限的一部分。

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

地理位置網路

  • 維度 - ga:metroId - 引導流量的 3 位數指定行銷區域 (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 - 候補廣告曝光次數是指透過 Ad Manager 當做候補廣告放送的所有 AdSense 或廣告供應商廣告曝光次數的總和。每次廣告顯示在網站上，系統就會記錄一次廣告曝光。舉例來說，如果網頁上有兩個廣告單元，而使用者瀏覽了該網頁一次，系統就會列出兩次曝光 (已啟用 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 - 有效千次曝光出價。這是每 1,000 次網頁瀏覽的 DFP 候補廣告收益。如果 AdSense 和 Ad Exchange 都提供了候補廣告，這個指標就是兩個候補廣告帳戶的總和 (已啟用 DFP 連結，且「隱藏 DFP 收益」。)

這是一個錯誤修正版本，修正了區隔和取樣的問題。

區隔

這個版本修正了一項問題：在「Core Reporting API V3」中，會導致「所有使用者」區隔 (gaid::-1) 的部分要求在計數中不足，並在 Analytics Reporting API V4 中分為兩個區隔。

取樣

這個版本修正了自訂資料表中的部分要求會傳回取樣資料的問題。

這個版本新增屬性 addedInApiVersion。

已新增至 API 版本

  • addedInApiVersion 是數值屬性，可用於檢查特定資料欄的報表 API 是否可使用這個資料欄；詳情請參閱 Metadata API - 開發人員指南。

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

主要功能

Google Analytics (分析) 建立於強大的資料報表基礎架構上，這個 API 可讓開發人員存取 Google Analytics (分析) 平台的強大功能。Analytics Reporting API V4 中的主要功能包括：

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

開始使用

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

配額政策

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

遷移

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

維度和指標

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

  • 維度 - ga:cohort - 使用者同類群組的同類群組名稱 (取決於同類群組定義)。視同類群組的定義方式而定，使用者可能同時屬於多個同類群組。

  • 維度 - ga:cohortNthDay - 相較於同類群組定義日期的 0 天偏移。舉例來說，如果同類群組定義的是第一個造訪日期：2015-09-01，那麼 2015-09-04 當天，ga:cohortNthDay 就會是 3。

  • ga:cohortNthMonth - 以同類群組定義日期為準的每月偏移值 0。

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

  • 維度 - ga:acquisitionTrafficChannel - 開發使用者時使用的流量管道。從使用者的第一個工作階段擷取。系統會依據使用者開發時的預設管道分組規則 (包括資料檢視層級，如有) 計算流量管道。

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

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

  • 維度 - ga:acquisitionSourceMedium - ga:user 客戶開發來源和 ga:客戶開發媒介的合併值。

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

  • 指標 - ga:cohortActiveUsers - 這項指標與以 0 為基礎的偏移維度 (ga:cohortNthDay、ga:cohortNthWeek 或 ga:cohortNthMonth) 有關。這個指標代表同類群組在第 9 天/每週/每月對應的時間範圍內有活躍使用者人數。例如，以 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 - 在社交資料中心合作夥伴網路分享或提及內容網址的活動總數。

主演

這個版本會將 starred 資源加入「帳戶摘要」、「帳戶」、「網站資源」和「資料檢視 (設定檔)」。

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

平台或裝置

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

未取樣報表

未取樣報表 API 不再每天有 100 份報表。這個 API 與透過網頁介面建立未取樣報表時採用的每項資源、每日權杖系統相同。

未取樣報表

目前使用者無法存取的未取樣報表將不再透過 Management API 回應訊息顯示下載連結。這個行為現在與使用者介面資訊主頁功能一致，只有報表擁有者能夠查看所產生文件的下載連結。

瀏覽 (設定檔)

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

未取樣報表

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

這個版本包含下列更新：

Google Analytics (分析)

  • 沒有變動。

Google 代碼管理工具

  • 修正執行單元測試時會導致當機的問題。

區隔

這是錯誤修正版本。這個版本修正了呼叫區隔清單方法時，會造成定義值中含有區隔的區隔無法正確顯示的問題。

這個版本將新的參數新增至 API。

包含空白列

  • 這個版本會新增新的選用參數 include-empty-rows，若設為 false 列資料 (不含資料)，就會忽略回應。預設值為 true，這是非破壞性變更，因此無須更新程式碼。詳情請參閱 Core Reporting API 參考說明文件。

這個版本包含下列更新：

Google Analytics (分析)

  • 新增對中間碼的支援。

Google 代碼管理工具

  • 新增對中間碼的支援。

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

使用者

  • 指標 - ga:1dayUsers - 在要求的時間範圍內，每天的每日活躍使用者總數。必須指定 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 - 有效千次曝光出價。也就是每 1000 次網頁瀏覽的 AdX 收益。
  • 指標 - ga:adxImpressions - 每當您的網站上出現個別廣告，系統就會記錄一次 AdX 廣告曝光。舉例來說，如果網頁上有兩個廣告單元，而使用者瀏覽了該網頁一次，系統就會記下兩次廣告單元曝光。
  • 指標 - ga:adxImpressionsPerSession - AdX 廣告曝光與 Analytics (分析) 工作階段數的比率 (廣告曝光次數/Analytics (分析) 工作階段數)。
  • 指標 - ga:adxMonetizedPageviews - 營利網頁瀏覽量評估的是來自資源的 AdX 帳戶，在資源中顯示的總瀏覽量。注意：一個網頁可以有多個廣告單元。
  • 指標 - ga:adxRevenue - AdX 廣告的預估總收益。
  • 指標 - ga:adxRevenuePer1000Sessions - 每 1000 個 Analytics (分析) 工作階段的 AdX 廣告帶來的預估總收益。請注意，這個指標的計算方式是依照網站的工作階段，而不是廣告曝光。
  • 指標 - ga:adxViewableImpressionsPercent - 取得的廣告曝光百分比。使用者有可能在瀏覽器中看到的曝光，就算是可見曝光。

這個版本會將額外的參數新增至 佈建 API 服務條款網址：

  • 新增了網址參數 provisioningSignup=false，修正了在沒有 Google Analytics (分析) 帳戶的情況下為使用者佈建 Google Analytics (分析) 帳戶時發生的問題。開發人員應更新程式碼，將這個參數新增至 TOS 網址。

批次處理

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

瀏覽 (設定檔)

在這個版本中，若在 insert 作業期間未設定，則 View (Profile) currency 屬性將預設為 USD。此外，get 和 list 作業會針對先前沒有 currency 屬性的 View (設定檔) 傳回 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 (分析) 記錄器/LogLevel。Analytics (分析) 現已改用 Android Logging。如要啟用偵錯記錄功能，請執行 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 架構。
  • 為 appview 命中類型新增淘汰警告。
  • sqlite3 現在是必要的程式庫。

Google 代碼管理工具

  • 修正 TAGDispatcher 中的 nil 字串異常終止問題。

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

運輸

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

其他異動

  • 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 開發人員指南。

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

資料來源

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

資料來源

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

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

地理位置覆寫

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

電子商務

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

使用者

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

地理位置網路

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

DoubleClick Campaign Manager

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

已淘汰的指標

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

所有集合的 list 方法回應現在包含 items 屬性的空白清單，其中集合不含資源。先前，系統會從回應中省略 items 屬性。如需 Google Analytics (分析) 設定資料查詢和回應的完整詳情，請參閱 API 參考資料。

這個版本為 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。在 UI8Delegate 生命週期的某些階段呼叫 get 時，在 iOS8 上使用這個 API 會導致錯誤。
  • 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 - 可視的曝光次數百分比。

這個版本包含下列更新：

Google Analytics (分析)

  • 修正小錯誤。

Google 代碼管理工具

這個版本將新的維度和指標新增至 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 - 顯示與 Google Analytics (分析) 轉換相符的 DCM 事件 (曝光或點擊) 的 DCM 廣告素材名稱。
  • 維度 - mcf:dcmSitePath - 由 DCM 網站表示路徑上的互動的轉換路徑。
  • 指標 - mcf:firstImpressionConversions - 在 DCM 廣告活動曝光中，30 天回溯期內的第一次轉換互動次數。這個維度包含目標達成數和交易次數。
  • 指標 - mcf:firstImpressionValue - 在 DCM 廣告活動曝光中，轉換價值在 30 天回溯期內的第一次轉換互動。這個維度包含目標達成數和交易次數。
  • 指標 - mcf:impressionAssistedConversions - 在轉換路徑中，Campaign Manager 廣告活動曝光未帶來轉換，但並非最終轉換互動的轉換次數。這個維度包含目標達成數和交易次數。
  • 指標 - mcf:impressionAssistedValue - 轉換路徑上發生 DCM 廣告活動曝光，但不是最終轉換互動的轉換價值。這個維度包含目標達成數和交易次數。

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

維度和指標

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

Session

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

流量來源

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

DoubleClick Campaign Manager

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

這個版本包含下列更新：

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 就會收集廣告識別碼和廣告客戶追蹤啟用的旗標。
  • 新增加強型電子商務支援功能。
  • 已新增畫面瀏覽命中類型來取代 Appview 命中類型。
  • 命中 ID 參數現已加到每次命中中。每次產生應用程式瀏覽、畫面瀏覽或網頁瀏覽命中時，系統就會變更這個值。
  • 每當廣告識別碼值變更時，系統就會重設 ClientId。只有在追蹤程式中收集廣告識別碼時，才會發生這種情形。
  • 新的 dispatchWithCompletionHandler 方法已新增至 GAI 類別。
  • 修正 SDK 無法在沒有 clientId 或空白的 clientId 的情況下傳送信標的問題。

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-04-16 版本有錯誤；如果您查詢已淘汰的維度或指標，API 會傳回採用取代維度或指標的欄標題。現在，可正確傳回與請求中相同的維度或指標名稱。

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

變更 UIuiName

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

這是 Embed API 的初始版本：

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

這是 佈建 API 的初始版本：

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

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

篩選器

未取樣報表：Management API

Management API 會新增一項資源，稱為「未取樣報表」。未取樣報表是利用未取樣資料產生的 Google Analytics (分析) (GA) 報表。「未取樣報表」目前僅適用於 Google Analytics (分析) 進階版使用者。

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

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

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

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

這個版本包含下列更新：

Google Analytics (分析)

  • 已新增使用者 ID 欄位。

Google 代碼管理工具

  • 已修正廣告巨集 ID 的錯誤，以便正確傳回廣告客戶 (IDFA) 的 ID。
  • 修正問題，使用者可以將 NSNumber 用於電子商務資料。

這個版本已淘汰 appUiName 屬性。請參閱資料淘汰政策，進一步瞭解屬性移除程序：

淘汰 appappiName

  • appUiName 已淘汰。Metadata API 已不再適用於 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。

Session

  • 維度 - 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

  • appview 命中類型 已替換為 screenview。請盡快更新應用程式追蹤程式碼，改用 screenview (而不是 appview)。

新參數

重新命名參數

  • 內容說明已重新命名為畫面名稱。查詢參數名稱 (cd) 將保持不變。

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

更換 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:: 前置字串已淘汰。建議您盡快遷移新的語法。

區隔：管理 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 廣告的總收益。

新帳戶摘要

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 中以不同縮放等級瀏覽網域時，不會再忽略連接器參數。
  • 修正特定網址無法載入網頁內分析的問題。
  • 改善偵錯模式輸出。
  • 維護版本。

這個版本包含下列更新：* 已不再需要 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 Charts 視覺化功能更輕鬆呈現 Google Analytics (分析) 資料，API 可選擇在回應中傳回資料表格物件。

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

新的維度和指標

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

時間

  • 維度 - ga:minute - 傳回該小時的分鐘。可能的值介於 00 和 59 之間。
  • 維度 - ga:nthMinute - 在指定日期範圍內的每分鐘指數。日期範圍第一天的第一分鐘索引 (即開始日期) 為 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」。區隔的名稱是「行動流量」，而定義是 ga:deviceCategory==mobile。
  • 維護版本。

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

AdSense

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

    • 我 - ga:adsenseRevenue - AdSense 廣告帶來的總收益。
    • 中期 - 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 - 每千次曝光的預估費用。也就是每 1000 次網頁曝光的 AdSense 收益。(ga:adsenseRevenue/(ga:adsensePageImpression/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 參考資料和取樣。

這個版本包含：*第六版。* 必須變更，以避免指定 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 中顯示的維度和指標相關資訊。傳回的中繼資料包括 UI 名稱、說明、進階區隔支援等屬性。使用 Metadata API 後，您的應用程式就能自動取得報表查詢可用的維度和指標最新資料。詳情請參閱 Metadata API 總覽。

這個版本包含下列更新：* 3.0 版的第一個版本 * SDK API 異動，配合 analytics.js。移除了 track 和 send 方法。改用 send 和 GAIDictionaryBuilder 建構方法。* 已移除 GAITracker 通訊協定中的大多數屬性。針對不同欄位改用 set。* 系統會保留使用 set 方法設定的所有參數。先前，為下一次傳送/追蹤呼叫設定多個參數。* GAILogger 通訊協定適用於想導入 SDK 自訂記錄的使用者。* 最低系統需求。詳情請參閱 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 回應代碼重試命中。

這是 Beta 版限定 Beta 版 Real Time Reporting API 的初始版本：

  • Real Time Reporting API 可讓你針對資源目前發生的活動製作報表。您可以使用 Real Time Reporting API 查詢維度和指標，建立以客戶為主的網站小工具和資訊主頁。詳情請參閱 Real Time Reporting API 總覽。

修正錯誤

  • ga:adwordsCustomerID 現在可正確傳回與 AdWords API AccountInfo.customerId 對應的 10 位數 AdWords 客戶 ID。這項修正可讓多個 AdWords 帳戶合併 Analytics (分析) 資料。

在推出新區隔中，我們會對 Core Reporting API 推出下列異動。

  • segment 參數現在支援自訂進階區隔的新英數字元 ID，這個 ID 會在 Management API 區隔集合中傳回。
  • 自訂區隔目前的數值 ID 現已淘汰。這些舊版 ID 將用於 6 個月。建議您將儲存使用者區隔 ID 的應用程式改成改用新的英數字元 ID。淘汰期結束後，任何使用舊數字 ID 的查詢都會傳回錯誤。
  • 目前，只有透過網頁介面建立的造訪層級區隔，才能透過 segment 參數查詢。
  • 現有的預設區隔 (含負數 ID) 不會受到影響。但目前不支援新的預設區隔。

在推出新區隔中，我們即將推出區隔集合功能異動：

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

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

應用程式追蹤

  • 您可以在應用程式設定檔報表中找到這項資料：
    • 調暗 - ga:appId - 應用程式的 ID。
    • 調暗 - ga:appInstallerId - 安裝程式 ID (例如Google Play 商店) 下載應用程式的來源。根據預設，系統會根據 PackageManager#getInstallerPackageName 方法設定應用程式安裝工具 ID。
    • 調暗 - ga:appName - 應用程式名稱。
    • 調暗 - 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

電子商務

  • Di- - ga:currencyCode - 交易的當地幣別代碼，以 ISO 4217 標準為依據。
  • 中期 - ga:localItemRevenue - 產品收益 (當地幣別)。
  • Met - ga:localTransactionRevenue - 交易收益，以當地幣別計算。
  • 步行 - ga:localTransactionShipping - 交易運費 (以當地幣別計算)。
  • 加值稅 - ga:localTransactionTax - 以當地幣別計算的交易稅。

例外狀況

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

目標轉換次數

  • 摘要 - ga:goalCompletionLocation - 與任何到達網頁類型目標達成的網頁路徑或畫面名稱。
  • 摘要 - ga:goalPreviousStep1 - 與任何目標類型目標相符的網頁路徑或畫面名稱，比目標達成位置前一步。
  • 摘要 - ga:goalPreviousStep2 - 與任何目標類型目標相符的網頁路徑或畫面名稱，比目標達成位置前兩個步驟。
  • 摘要 - ga:goalPreviousStep3 - 符合任何目標類型目標前 3 個步驟的網頁路徑或畫面名稱。

說明文件變更

下列目標轉換維度和指標已重新命名。這只是一份說明文件異動，不需要更新查詢。

  • 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 使用者代理程式字串。

    • 調暗 - 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 的合併值。

流量來源

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

這個版本為網站資源資源新增了 2 項新資源：

  • profileCount - 傳回房源的設定檔計數。這樣一來，您就能篩選不含任何設定檔的屬性 (例如 profileCount = 0)。
  • industryVertical - 傳回為資源選取的產業類別/類別。

修正錯誤：

  • 個人資料資源的 eCommerceTracking 屬性現在與網頁介面管理部分中的「電子商務設定」一致。啟用電子商務追蹤功能時會傳回 true，如未啟用，則傳回 false。
  • 網站資源資源現在包含 level 資源，表示網站資源是 PREMIUM 還是 STANDARD。

這個版本包含：*第 5 個 Beta 版本。* 修正 EasyTracker 例外狀況剖析錯誤。設定 ga_reportUncaughtExceptions 旗標時，我們並未初始化例外狀況剖析器，因此不會剖析未擷取的例外狀況位置。透過這項修正，在 ga_reportUncaughtExceptions 設為 True 時，當機報告和例外狀況報告會回報未擷取的例外狀況位置。

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

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

  • 支援透過 _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。
  • 追蹤方法已變更為「Send」(例如 trackView，現已改名為「sendView」)。
  • 修正一些小錯誤。

這個版本包含下列更新：*第 4 個 Beta 版本。* SDK 現在會遵循取樣率設定。如果先前將取樣率設為 100%，但你會看到部分 Analytics (分析) 指標比 Beta 3 相對減少。* 變更傳送的追蹤方法 (例如：trackView，現稱為 sendView)。* 透過 Transaction.setCurrencyCode 新增支援當地幣別 * 預設使用 HTTPS，而非 HTTP。* 沒有網路連線時，SDK 不會嘗試傳送命中資料。* 嘗試在處理安裝廣告活動資料時避免 ANR。* 已從 SDK 中移除 TrackedActivity 類別。* 將 SDK 初始化從主 UI 執行緒移出。* 提高 SDK 從毀損的 SQLite 資料庫復原的能力。* 修正另外幾項當機和錯誤。

這個版本包含下列更新：

  • 在 libGoogleAnalytics.a 中加入 armv7s 架構。
  • 從 libGoogleAnalytics.a 移除 armv6 架構

這個版本將新的維度和指標新增至 API。請參閱維度和指標參考資料，瞭解定義。

應用程式追蹤

  • 您可以在行動應用程式追蹤 SDK 報表中查看這項資料：
    • 符合 - ga:uniqueAppviews - 每個工作階段的應用程式瀏覽次數。
    • 符合 - ga:appviews - 應用程式的總瀏覽次數。
    • 符合 - ga:appviewsPerVisit - 每個工作階段的平均應用程式瀏覽次數。

流量來源

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

社交活動

  • 這項資料來自從社群網路資料中心合作夥伴匯入的站外活動。
    • Di- - ga:socialActivityDisplayName - 如果是社群媒體資料中心，這個字串代表社群網路使用者張貼的社交活動標題。
    • 摘要 - ga:socialActivityEndorsingUrl：如果是社交資料中心活動，這個字串代表社交活動的網址 (例如 Google+ 訊息網址、網誌留言網址等)
    • 摘要 - ga:socialActivityPost - 就社交資料中心活動而言，這個字串代表社群網路使用者張貼的社交活動內容 (例如 Google+ 訊息的訊息內容)
    • Di- - ga:socialActivityTimestamp - 用於社群媒體的資料中心活動，這個字串代表社交活動在社交網路上發生的時間。
    • Di- - ga:socialActivityUserPhotoUrl - 如果是社群媒體資料中心，這個字串代表與社群網路個人資料相關聯的相片網址。
    • Di- - ga:socialActivityUserProfileUrl - 如果是社群媒體資料中心，這個字串代表相關聯使用者的社交網路個人資料網址。
    • Di- - ga:socialActivityContentUrl - 如果是社群媒體資料中心，這個字串代表相關社交網路使用者分享的網址。
    • 摘要 - ga:socialActivityTagsSummary - 為社交資料中心活動，這是與社交活動相關的一組逗號分隔標記標記。
    • 摘要 - ga:socialActivityUserHandle - 針對社交資料中心，這個字串代表啟動社交活動的使用者社群帳號 (亦即名稱)。
    • Di- - ga:socialActivityAction - 如果是社交資料中心活動，這個字串代表與活動相關的社交動作類型 (例如投票、評論、+1 等)。
    • Di- - ga:socialActivityNetworkAction - 用於社群媒體的資料中心活動，這個字串代表社交動作的類型以及活動的來源。
    • Met - ga:socialActivities - 在社交資料中心夥伴網路上分享/提及內容網址的活動數量。

社交互動

  • 這項資料來自站上社交互動追蹤。
    • 調暗 - ga:socialInteractionAction - 適用於社交互動，代表要追蹤的社交動作字串 (例如 +1、喜歡、書籤)
    • 調暗 - ga:socialInteractionNetwork - 適用於社交互動，代表目前追蹤的社群字串 (例如 Google、Facebook、Twitter、LinkedIn)
    • 調暗 - 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 中第 4 階層中的所有 pagePath。所有 pagepage 階層中的所有其他層級也會納入這個維度。

例外狀況追蹤

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

    • 符合 - ga:exceptions - 傳送到 Google Analytics (分析) 的例外狀況數量。
    • 符合 - ga:fatalExceptions - isFatal 設為 true 的例外狀況數量。

使用者載入時間

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

    • 調暗 - ga:userTimingCategory - 用來將所有使用者時間變數分類至邏輯字串的字串，方便您製作報表。
    • 數字 - ga:userTimingLabel - 用於表示資源追蹤動作名稱的字串。
    • Dim - ga:userTimingVariable - 可用來在報表中以視覺化方式呈現使用者時間的彈性字串。
    • 調暗 - ga:userTimingValue 傳送至 Google Analytics (分析) 的經過毫秒數。
    • Met - 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。

這個版本包含下列更新：

  • 已更新為最新的電匯格式。
  • 「sampleRate」已變更為雙精度浮點值。
  • 過度追蹤過多。
  • 如果選擇停用，系統就會刪除未分派的追蹤資訊。
  • 系統會刪除 30 天前未分派的追蹤資訊。
  • 強化調度工具功能
  • 調度工具會在連線中斷時透過觸及率服務 API 傳送通知，而非定期重試。
  • 已更新範例應用程式。
  • 其他錯誤修正和強化功能。

這個版本包含下列更新：

  • 簡化的 EasyTracker 介面。
  • 已將分派作業移至新類別：GAServiceManager。
  • 已更新為最新的電匯格式。
  • sampleRate已變更為雙倍。
  • 過度追蹤過多。
  • 如果選擇停用，系統就會刪除未分派的追蹤資訊。
  • 系統會刪除 30 天前未分派的追蹤資訊。
  • 其他錯誤修正和強化功能。

修正錯誤

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

這個版本包含下列更新：

  • 已新增未偵測到的例外狀況處理設施。
  • 已從 GAI 中移除 dispatchEnabled 屬性。
  • 已將 defaultTracker 屬性新增至 GAI。
  • 將 close 方法新增至 GAITracker。
  • 已在 GAITracker 中新增時間追蹤方法。
  • 新增 trackView 方法至 GAITracker，但不含引數。
  • 交易項目欄位名稱已更新。
  • 已更新為最新的電匯格式。
  • 事件值解讀為 64 位元整數。
  • ARMV6 程式碼產生功能已從 THUMB 改為 ARM。

這個版本包含下列更新：

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

這個版本可讓 Google Analytics (分析) 進階版帳戶存取最多 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」和「incredimail.com」

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

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

  • API 錯誤回應的內文中加入新的錯誤代碼、原因和說明。用於管理 API 版本 (2.4 版和 3.0 版) 的所有程式碼。

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

  • 自訂變數長度限制已從 64 個半形字元增加到 128 個半形字元。此外，系統也會檢查網址編碼前的長度。
  • 提高事件命中頻率限制。您現在可以傳送每秒 10 次命中，並額外取得 1 次命中 (先前為每 5 秒有 1 次命中)。請注意，每個工作階段的 500 次命中仍然適用。
  • __utmv Cookie 現已以不同的變數分隔符 (插入點而非半形逗號) 寫入，以便與 RFC 相容。這樣應該可以改善客戶看到的 Cookie 編碼問題。

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

3.0 版本

  • Core Reporting API 3.0 版是最新的 API 主要版本，並非回溯相容。日後的 API 開發作業一律會在這個版本中完成。

  • 新功能

  • 更新

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

2.4 版本

  • Core Reporting API 2.4 版是次要版本升級，大部分與舊版 Data Export API 2.3 版相容。

  • 更新

    • 要提出要求的新網址：https://www.googleapis.com/analytics/v2.4/data…
    • 需要註冊和開發人員權杖。
    • XML 輸出版本與 2.3 版一致，因此其他現有的 Google Data 用戶端程式庫仍會繼續運作。
    • 配額錯誤的錯誤代碼已從 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 版，並即將停止支援 Data Export API 中的「帳戶動態饋給」。在 6 個月內：

    • 針對 2.3 版 XML 資料動態饋給的要求會轉送至 2.4 版，並傳回 2.4 版的回應。屆時，所有 2.4 版配額政策都會套用至 2.3 版要求。

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

    • 在 Data Export API 中向「帳戶動態饋給」提出的要求傳回 404 Not Found 狀態碼。所有設定資料的要求都必須透過 Management API 完成。

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

新資料

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

異動項目

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

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

修正錯誤

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

這個版本包含下列更新：

  • 說明文件：

    • ReadMe.txt 已更新為指向網站，使其指向說明文件。

這個版本包含下列更新：

  • 修正問題:
    • 已修正 Google Play 中自動追蹤到達網頁網址的方式。
    • 允許對 setReferrer 的參照網址進行網址編碼。

變更網站速度資料收集：

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

這個版本包含下列更新：

  • 修正問題:
    • 將資料庫位置從「Documents」目錄變更為「Library」目錄。
    • 針對 SQLite 資料庫錯誤，SDK 不再擲回 NSAsserts。
    • 已修正使用空白字串呼叫 trackPageview 時發生的當機問題。
    • 已修正在呼叫 stopTracker 後呼叫各種 GANTracker 方法的當機問題。
    • 修正多個記憶體流失，包括呼叫一次開頭為「/」的 pageURL。
  • 新功能：
    • 新增了 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:impressions 要求 ga:adGroup 或 ga:adContent 的 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 Data 用戶端程式庫仍會繼續運作。

淘汰

  • 我們宣布要淘汰舊版 Management API 2.3 版。這個 API 會繼續運作兩個月，之後所有 2.3 版要求都會傳回 2.4 版回應。

這個版本修正了一項錯誤，導致部分網站造訪次數大幅增加，且/或新網站的訪客數量減少。第一項影響主要是針對自然流量和特定使用者行為的網站。第二種情況是，網站使用的追蹤設定含有多個追蹤器。

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

已修正無效指標/維度組合

  • 我們上個月宣布了幾項 API 近期異動，禁止資料動態饋給中未傳回任何資料的無效查詢。我們現已對 API 進行這些變更，以下組合現已無效：

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

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

工作階段計算變更：

  • 每個工作階段一個廣告活動：如果在現有的工作階段中開始了新的廣告活動，追蹤指令碼現在會自動啟動新的工作階段。針對下列任一欄位所做的變更，就會觸發新的廣告活動：廣告活動 ID、名稱、來源、媒介、字詞、內容或 gclid。
  • 追蹤指令碼一旦使用者關閉瀏覽器，就不會再啟動新的工作階段。

跨網域追蹤異動：

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

這個版本包含下列更新：

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

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

  • 追蹤程式碼現在會將預先轉譯網頁的命中延後，直到使用者查看這些網頁為止。如果系統從未瀏覽過預錄網頁，則不會傳送任何命中。這項功能僅適用於使用非同步追蹤指令碼的網站。如要進一步瞭解預先轉譯，請參閱 Google 網站管理員中心網誌。

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

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

淘汰信賴區間

  • 如果您尚未執行這項操作，請停止使用指標的信賴區間值。在此版本中，Data Export API 資料動態饋給會針對所有信賴區間值傳回 0.0。在一個月左右，我們會從所有指標元素中完全移除這項屬性。

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

這個版本包含下列更新：

  • 修正問題:
    • 已修正使用自訂變數時的當機問題。
    • 已修正使用自訂變數時的記憶體流失問題。
  • 新功能：
    • 新增電子商務命中支援。
    • 已新增 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 或功能沒有任何異動。

此版本包含更新及 1 項新功能。

  • POST 支援：

    • 追蹤程式碼現在可大幅傳送追蹤信標。一般來說，信標是透過 HTTP GET 要求傳送，部分瀏覽器和 Proxy 最多只能傳送 2048 個字元。超過此上限的要求將會遭到捨棄，且資料也未傳送至 Google Analytics (分析)。從這個版本開始，超過 2048 個字元的要求將透過 HTTP POST 傳送，但沒有任何限制。追蹤程式碼現在支援最多 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 個錯誤：

修正錯誤

  • 先前使用維度 (例如ga:keyword==store,ga:keyword==bar)。這個問題現已修正，使用 OR 運算子現在會傳回一致的值。

  • 部分無效篩選器的 API 錯誤訊息已更新為「非」，包括是造成錯誤的維度或指標篩選器 (但系統會繼續傳回實際的違規篩選器運算式)。

這是 Google Analytics Management API 的 Beta 版！

新動態饋給

更新的用戶端程式庫

  • Management API 與 Google Analytics (分析) Data Export 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 清理功能。

  • 修正錯誤：

    • 已修正事件追蹤錯誤。呼叫 _trackEvent 無需先呼叫 _initData 或 _trackPageview。
    • 更新非同步程式碼片段，可將其放在任何網頁的頭部，以免對 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。第三方程式庫可能尚未更新。

    • 系統可能會要求在每個帳戶或資料動態饋給要求中新增標頭 GData-Version: 2，藉此要求版本 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 搜尋引擎。
    • 已從 Looker 清單中移除 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

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

  • 與自然連結功能相關的搜尋字詞、正確屬性 (例如 _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 (分析) Data Export 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:平均頁面時間長度
    • ga:平均網頁瀏覽
    • ga:平均工作階段時間
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenue 單次造訪
    • ga:leaveedFunnels1
    • ga:leaveedFunnels2
    • ga:stopedFunnels3
    • ga:放棄程序 4
    • ga:goal 轉換率
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit

  • 下列維度和指標已重新命名。舊名稱將會失效。請確認您在說明文件中使用正式名稱：http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    維度 * ga:subContinentRegion ...[ ga:subContinent * ga:organization 斷言 ga:networkLocation * ga:domain FALSE ga:networkDomain * ga:visitNumber * ga:countOfvisits * ga:platform FALSE ga . ga : ga <課程名稱> + g : 「實名原始項目」

    「」