Google Analytics Data API 總覽

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

進一步瞭解 Google Analytics 資源

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

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

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

  • 建立自訂資訊主頁顯示 Google Analytics 資料。
  • 自動化複雜的報表作業,節省時間。
  • 將 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 結構定義文件