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 個網頁網址個別獲得多少網頁瀏覽量？
- 我的 iOS 應用程式在過去 30 分鐘內，各國家/地區有多少活躍使用者？
Google Analytics (分析) Data API v1 也可用來：
- 建立自訂資訊主頁以顯示 Google Analytics (分析) 資料。
- 自動執行複雜的報表工作，節省寶貴時間。
- 整合 Google Analytics (分析) 資料與其他商業應用程式。
快速入門指南
只要加入幾行程式碼，就能呼叫 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 目前支援的維度和指標。