總覽

本文件說明 Google Analytics (分析) Real Time Reporting API。如需 API 的詳細說明,請參閱 API 參考資料

引言

即時報表 API 可讓您為經過驗證的使用者要求即時資料 (例如資源的即時活動)。

你可以使用 Real Time Reporting API 執行下列操作:

  • 顯示網頁的有效觀眾,並透過檢視中商品庫存有限的消費者營造迫切感。
  • 顯示最熱門的內容,例如前 10 名活躍網頁。
  • 建立並顯示即時資訊主頁。

Google Analytics (分析) SuperProxy

使用 Google Analytics (分析) SuperProxy 可處理許多有關 Google Analytics (分析) API 的實作詳細資料,以便用於驗證、快取,以及將 API 回應轉換為直接用於視覺化和圖表程式庫的格式。

概念總覽

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

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

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

使用者必須先使用資料檢視,從資料檢視 (設定檔) 要求報表資料,您才能:

  1. 啟用 Google Analytics API。
  2. 建立憑證,讓應用程式存取 API。
  3. 將憑證放到您的應用程式中。

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

資料檢視 (設定檔) 會以資料檢視 (設定檔) 來識別。資料檢視 (設定檔和其他實體) 屬於 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 的運作方式,請按照下列步驟開始使用: