Google Analytics (分析) Real Time Reporting API 變更記錄

我們會定期更新 Google Analytics (分析) Real Time Reporting API，提供新功能及修正先前版本中發現的瑕疵。在大多數情況下，API 開發人員都會知道這些變更。不過，我們偶爾會需要做出變更，要求開發人員修改現有應用程式。

本頁面說明對 Google Analytics (分析) Real Time Reporting API 的任何變更，且可能影響您的應用程式。我們建議 API 開發人員定期檢視此清單以掌握任何新公告。您也可以透過下方訂閱部分下方的動態饋給訂閱變更。

訂閱相關變更記錄

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

包含所有 Collection、Configuration 和 Reporting API。

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

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

Real Time Reporting API 變更記錄
–
訂閱 rss

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

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

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

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

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

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

時間

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

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

已重新命名的維度和指標

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

使用者

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

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 - 畫面瀏覽總次數。

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

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