Google Analytics (分析) 4 Data API 總覽

您可以使用 Data API,透過程式輔助方式存取 Google Analytics (分析) 4 (GA4) 報表資料。這個 API 與舊版通用 Analytics (分析) 資源不相容。

進一步瞭解 Google Analytics (分析) 4 資源

以下提供幾個使用 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 這個方法會傳回報表方法中可用的維度和指標中繼資料。用於探索維度和指標。這個方法的回應也包含指定 GA4 資源可用的自訂維度和指標。
  • checkCompatibility 這個方法會列出可加入報表要求的維度和指標,並維持相容性。
  • runRealtimeReport 這個方法會傳回資源的自訂即時事件資料報表。事件傳送到 Google Analytics (分析) 後幾秒內,即時報表就會列出。即時報表會顯示過去到 30 分鐘 (Google Analytics (分析) 360 資源最長為 60 分鐘) 的事件和使用資料。
  • properties.audienceExports 一組可讓您產生目標對象匯出項目的方法,包含目標對像中使用者的數據匯報。
  • properties.recurringAudienceLists (早期預先發布版) 用於管理週期性目標對象匯出的一組方法。週期性目標對象匯出作業每天都會產生新的目標對象名單。
  • runFunnelReport (早期預先發布版) 這個方法會傳回 Google Analytics (分析) 事件資料的自訂漏斗報表。「漏斗探索」可將使用者完成工作所採取的步驟化為圖表,迅速瞭解使用者完成或不完成各個步驟的情況。

支援的維度和指標

如需 Data API 支援的所有維度與指標清單,請參閱 API 結構定義說明文件