總覽

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

簡介

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

即時報表 API 的用途如下:

  • 顯示活躍的頁面檢視者,營造迫切感,讓使用者在查看商品有限的廣告空間時感到急迫。
  • 顯示最熱門的內容,例如前 10 大活躍網頁。
  • 建立並顯示即時資訊主頁。

Google Analytics (分析) 超級 Proxy

您可以使用 Google Analytics SuperProxy 處理許多與 Google Analytics (分析) API 搭配使用的實作詳細資料,以便驗證、快取及將 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 的運作方式,即可開始使用: