總覽

本文將說明 Google Analytics Real Time Reporting API。如需 API 的詳細參考資料,請參閱 API 參考資料

引言

您可以運用 Real Time Reporting API,向已驗證使用者要求即時資料,例如資源的即時活動。

你可以使用 Real Time Reporting API 來:

  • 顯示網頁的活躍檢視者,營造迫切感,讓使用者在查看商品有限的商品時做好準備。
  • 顯示最熱門的內容,例如前 10 個活躍網頁。
  • 建立並顯示即時資訊主頁。

Google Analytics (分析) 超級 Proxy

使用 Google Analytics (分析) SuperProxy 處理在驗證、快取及轉換 API 回應至直接與視覺化程式庫和圖表程式庫搭配使用時,適用的許多導入細節。

概念總覽

Real Time Reporting API 的基礎概念如下:

  • 報表與使用者和資料檢視 (設定檔) 之間的關係。
  • 報表的結構和查詢建立方式。
  • 使用 API 回應。

報表、使用者和資料檢視 (設定檔)

您必須先完成下列事項,使用者才能使用您的應用程式向資料檢視 (設定檔) 要求報表資料:

  1. 啟用 Google Analytics (分析) API。
  2. 為應用程式建立 憑證以存取 API。
  3. 將憑證置入應用程式。

使用應用程式要求報表資料時,使用者必須授權應用程式代為存取資料。

資料檢視 (設定檔) 會以資料檢視 (設定檔) ID 識別。資料檢視 (設定檔) 以及其他實體都是 Google Analytics (分析) 帳戶階層、使用者、資源和資料檢視的一部分。應用程式可以使用 Management API 掃遍這個階層,並取得資料檢視 (設定檔)。

查詢維度和指標

您會查詢 API 來取得 Google Analytics (分析) 報表資料,該資料由維度和指標組成。「指標」是各種使用者活動的評估方式,例如目前資源中的活躍使用者人數。維度會根據流量來源、地理位置、網頁資訊等一些常見條件細分指標。

請參閱 維度和指標參考指南,探索 API 提供的所有維度和指標。此外,請參閱 Real Time Reporting API 參考指南,瞭解如何在 API 查詢中指定維度和指標。

使用報表

API 傳回的資料可以視為含有標頭和列清單的資料表。每個 API 回應都包含一個標頭,用來說明每個資料欄的名稱和資料類型。回應也包含資料列清單,其中每列都是一份儲存格清單,其中所含資料的順序與標頭相同。如要進一步瞭解 API 回應,請參閱 Real Time Reporting API 參考指南

配額政策

Real Time Reporting API 可處理數百萬筆資料查詢作業。我們採用的配額系統是為了防止系統收到的作業數量超出系統所能處理的量,並確保系統資源能以公平的方式發布。詳情請參閱 限制與配額指南。

後續步驟

現在您已瞭解 API 的運作方式,不妨開始使用: