Google Analytics Core Reporting API 變更記錄

我們會定期更新 Google Analytics (分析) Core Reporting API，藉此提供新功能並修正先前版本中發現的瑕疵。在大多數情況下，API 開發人員將看到這些變更。然而，我們有時必須進行變更，需要開發人員修改現有應用程式。

本頁面說明可能影響應用程式的 Google Analytics Core Reporting API 是否有任何變更。我們建議 API 開發人員定期查看這份清單，檢查是否有任何新公告。您也可以透過下方「訂閱」部分列出的動態饋給訂閱異動內容。

訂閱相關變更記錄

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

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

所有 Reporting API 變更記錄
–
訂閱rss

其中包含 Core Reporting API、Multi-ChannelFunnel Reporting API 和 Real Time Reporting API。

Core Reporting API 變更記錄
–
訂閱rss

這是 User Activity API 的初始版本

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

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

這個版本增加了 Analytics (分析) Reporting API v4 結果中傳回的列數上限。

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

這個版本為 Google Analytics Reporting API v4 新增資源型配額系統的預覽畫面，讓您對 Analytics (分析) 360 (Premium) 客戶採用更高的取樣門檻。

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

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

  • 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 連結的資料檢視查詢這些維度和指標時，會導致錯誤發生。

此錯誤修正版本修正了 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 的新定義。您可以使用這項指標來瞭解變更前的新定義。請注意，這項指標是私人，且不會顯示在維度和指標參考資料中。

這個版本將新的維度和指標新增至 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 新增維度。這個版本也針對可一併查詢的維度組合加入特定限制。如需完整的定義清單，請參閱維度和指標參考資料。

地理位置網路

  • 維度 - 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 中分為兩個區隔。

取樣

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

這個版本宣布了新版 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 - 在社交資料中心合作夥伴網路分享或提及內容網址的活動總數。

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

平台或裝置

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

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

包含空白列

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

這個版本為 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 天內不重複使用者人數。

這個版本為 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 - 取得的廣告曝光百分比。使用者有可能在瀏覽器中看到的曝光，就算是可見曝光。

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

已淘汰的維度

這些維度已淘汰。請參閱資料淘汰政策，進一步瞭解資料移除的相關資訊：

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

這個版本為 API 新增維度。如需維度和指標的完整清單，請參閱這篇文章。

AdWords

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

這個版本為 API 新增維度。如需維度和指標的完整清單，請參閱這篇文章。

平台或裝置

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

這個版本為 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。

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

AdWords

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

已淘汰的維度和指標

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

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

AdSense

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

這個版本包括加入新的工作階段指標、新的流量來源維度，以及新的 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)。

這個版本包括了新的內容分類維度和指標。

維度和指標

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

內容分類

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

這個版本包含適用於區隔的全新 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 會傳回採用取代維度或指標的欄標題。現在，可正確傳回與請求中相同的維度或指標名稱。

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

新的維度和指標

下列維度已新增至 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。

區隔：Core Reporting API 2.4 版和 3.0 版

Core Reporting API 支援新的區隔。

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

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

資料表輸出

使用 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。

這個版本將新的維度和指標新增至 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 - 套用至關鍵字的比對類型 (詞組比對、完全比對、廣泛比對)。詳情：瞭解搜尋字詞報表。

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

相對日期
  • Core Reporting API 已支援相對日期，today、yesterday 和 NdaysAgo 現已成為 start-date 和 end-date 查詢參數的有效值。
  • 您可以使用這些值，根據查詢當下的目前日期以及查詢中指定的資料檢視 (設定檔) 時區，自動判斷日期範圍。詳情請參閱 API 參考資料。
取樣層級
  • 我們推出了新參數 samplingLevel，可讓您設定報表查詢的取樣層級 (也就是計算結果的造訪次數)。允許的值為 DEFAULT、FASTER 和 HIGHER_PRECISION。
  • API 回應中新增了 2 個欄位：sampleSize 和 sampleSpace。您可以利用這些值，計算取樣回應中使用的造訪百分比。
  • 詳情請參閱 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) 不會受到影響。但目前不支援新的預設區隔。

這個版本將新的維度和指標新增至 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 項實驗指標：- ga:experimentId - ga:experimentVariant
  • 這個版本新增了 5 個網站速度指標：
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • 這個版本為「平板電腦流量」新增了一個預設區隔：gaid::-13。

這個版本將新的維度和指標新增至 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 - 用來識別行動裝置的品牌、型號和行銷名稱。

修正錯誤

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

這個版本可讓 Google Analytics (分析) 進階版帳戶存取最多 50 個自訂變數。

這個版本修正了 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 權杖)。

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

這個版本會影響所有 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 完成。

這個版本加入了較新的 AdWords 資料，以及更多 AdWords 維度和指標組合。

  • AdWords 資料現在會在 1 小時內更新。先每天更新資料。

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

幾週前，我們提出了一項變更，禁止使用 ga:impressions 要求 ga:adGroup 或 ga:adContent 的 API 查詢，因為這個組合會傳回 0。經此變更後，此組合現已恢復並修正，以傳回正確的資料。

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

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

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

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

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

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

淘汰信賴區間

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

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

這個版本新增了 3 個指標，並更新兩個值。

新資料更新

  • 我們為 API 新增了 3 個處理網站速度效能的新指標：
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

指標更新

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

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

這個版本可提高資料動態饋給的成效並新增資料：

提升效能

  • 這個版本將資料動態饋給的延遲時間縮短 30% 至 35%。

新資料更新

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

近期異動內容

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

  • 目前，ga:CTR 是 percent，並傳回 0.02 值。在不久後將進行變更，以傳回實際百分比 (例如 2)。

這個版本會將更多資料新增至資料動態饋給：

新資料更新

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

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

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

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

近期異動內容

API 目前會針對多種授權問題傳回 401 狀態碼。在未來幾週內，401 狀態只會用於無效權杖，讓開發人員能夠處理錯誤。

這個版本將為資料動態饋給加入更多資料：

新資料更新

  • 計算「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 程式庫已更新，可使用輔助方法存取這個元素。

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

修正錯誤

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

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

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

修正錯誤

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

  • 修正錯誤：現在如果目標名稱、目標路徑、目標比較值或目標比較類型設定錯誤，帳戶動態饋給就不會傳回。

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

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

新功能

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

修正錯誤

  • 修正了當其中一個設定檔的目標設定或步驟錯誤時，帳戶動態饋給就不會傳回資料。

這個版本新增了一些功能並修正錯誤：

新功能

  • 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 元素和屬性描述區隔資料：

    • ga:visitorType==Returning Visitor

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

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

有新的目標資料

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

  • 目標 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 元素：

  • 已為自訂變數新增 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

這個版本新增功能並淘汰了一些舊功能：

  • 下列維度和指標現已淘汰。我們將在一個月內永久移除 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

這個版本更新 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 (貨幣和時區) 傳回兩個新的資料元素。

  • 我們正在強制執行資料查詢，至少須納入一項有效的指標。

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

這個版本已從私人 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 : 「實名原始項目」

    「」