Analytics (分析) Data API 總覽

Google Analytics (分析) Data API v1 可讓您透過程式輔助方式存取 Google Analytics (分析) 4 (GA4) 報表資料。Google Analytics (分析) 4 有助您瞭解使用者如何使用您的網站、iOS 或 Android 應用程式。進一步瞭解 Google Analytics (分析) 4 資源

透過 Google Analytics (分析) Data API v1,您可以透過建立報表來解答下列問題:

  • 過去一週內,我的 Android 應用程式每日活躍使用者有多少人?
  • 過去 28 天內,我網站上前 10 大網頁網址的個別網頁瀏覽次數?
  • 過去 30 分鐘內,每個國家/地區有多少活躍使用者?

Google Analytics (分析) Data API v1 也可用來:

  • 建立自訂資訊主頁來顯示 Google Analytics (分析) 資料。
  • 自動執行複雜的報表工作,節省寶貴時間。
  • 將 Google Analytics (分析) 資料與其他商業應用程式整合。

快速入門指南

只要稍加幾行程式碼,即可透過 API 呼叫 API 建立第一份報表。請參閱快速入門指南,瞭解如何開始使用。有 Java、Python、Node.js 和其他語言的用戶端程式庫,可簡化實作程序。

可用方法

  • 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 (分析) 事件資料的自訂漏斗報表。您可以透過「漏斗探索」將使用者完成某件事時採取的步驟化為圖表,迅速瞭解使用者完成或不完成各個步驟的情況。

支援的維度和指標

API 結構定義說明文件列出 Analytics (分析) Data API 目前支援的維度和指標。