本文說明 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 回應。
報表、使用者和資料檢視 (設定檔)
您必須先完成下列作業,使用者才能使用應用程式要求資料檢視 (設定檔) 的報表資料:
- 啟用 Google Analytics (分析) API。
- 為您的應用程式建立 憑證以存取 API。
- 將憑證放入應用程式中。
使用應用程式要求報表資料時,使用者必須授權讓應用程式代表使用者存取資料。
資料檢視 (設定檔) 是以資料檢視 (設定檔) 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 的運作方式,即可開始使用: