Google Analytics Data API 總覽

您可以使用 Data API,透過程式輔助方式存取 Google Analytics 報表資料。這項 API 不適用於舊版通用 Analytics 資源。

進一步瞭解 Google Analytics 資源

API 傳回的資料與 Google Analytics 使用者介面中顯示的資料一致,且完全符合為 Google Analytics 資源設定的報表識別資訊設定 (例如混合、觀察或以裝置為準)。

以下列出幾個可使用 Google Analytics Data API v1 產生的報表範例:

  • 過去一週內,您的 Android 應用程式有多少每日活躍使用者。
  • 過去 28 天內,網站上點擊次數前 10 名的網頁,有多少網頁瀏覽次數。
  • 過去 30 分鐘內,您的 iOS 應用程式在每個國家/地區有多少活躍使用者。

您也可以使用 Google Analytics Data API v1 執行下列操作:

  • 建立自訂資訊主頁顯示 Google Analytics 資料。
  • 自動化複雜的報表作業,節省時間。
  • 將 Google Analytics 資料與其他商業應用程式整合。

資料一致性和報表識別資訊

Google Analytics Data API v1 存取的報表資料與 Google Analytics 介面相同。API 傳回的資料會完全遵守為 Google Analytics 資源設定的「報表識別資訊」,因此使用者人數、重複資料簡化和資料模型會與您在資源設定中選擇的識別資訊空間 (例如混合、觀測或以裝置為準) 一致。

如要進一步瞭解不同識別資訊空間對報表的影響,請參閱「報表識別資訊」。

開始使用

如要開始使用,請參閱用戶端程式庫快速入門指南。您可以使用 Java、Python、Node.js 和其他語言的用戶端程式庫,簡化實作程序。

可用的方法

以下列出 Data API 方法。詳情請參閱參考說明文件

  • runReport 這個方法會傳回 Google Analytics 事件資料的自訂報表,是簡單報表查詢的首選方法。
  • batchRunReports 這是 runReport 方法的批次版本,可讓您透過單一 API 呼叫產生多份報表。
  • runPivotReport這個方法會傳回 Google Analytics 事件資料的自訂樞紐分析表。樞紐分析表比一般報表更進階,也更具表現力。每個樞紐都會說明報表回應中顯示的維度資料欄和資料列。
  • batchRunPivotReports 這是 runPivotReport 方法的批次版本,可讓您使用單一 API 呼叫產生多份報表。
  • getMetadata 這個方法會傳回報表方法中可用維度和指標的中繼資料。用於探索維度和指標。這個方法的回應也包含指定 Google Analytics 資源可用的自訂維度和指標。
  • checkCompatibility 這個方法會列出可新增至報表要求並維持相容性的維度和指標。
  • runRealtimeReport 這個方法會傳回資源的即時事件資料自訂報表。事件傳送至 Google Analytics 後,會立即顯示在即時報表中。即時報表會顯示從當下到 30 分鐘前這段時間的事件和使用情況資料 (Google Analytics 360 資源最多可顯示 60 分鐘前的資料)。
  • properties.audienceExports 一組方法,可讓您產生目標對象匯出資料,其中包含目標對象中使用者快照。
  • properties.recurringAudienceLists (搶先版) 一組方法,可讓您管理週期性目標對象匯出作業。系統每天都會匯出新的目標對象名單。
  • runFunnelReport (搶先版) 這個方法會傳回 Google Analytics 事件資料的自訂漏斗報表。漏斗探索可將使用者完成某件事時採取的步驟化為圖表,讓您迅速瞭解使用者完成或不完成各個步驟的情況。

支援的維度和指標

如要查看 Data API 支援的所有維度和指標清單,請參閱 API 結構定義文件