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 分鐘內,每個國家/地區的 iOS 應用程式有多少活躍使用者?

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

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

快速入門指南

只須加入幾行程式碼,呼叫 API 即可建立第一份報表。 請參閱 快速入門:使用用戶端程式庫。Java、Python、Node.js 和其他語言都有用戶端程式庫,可簡化導入作業。

可用方法

  • runReport:這個方法會傳回您 Google Analytics (分析) 事件資料的自訂報表,也是簡易報表查詢的首選方法。
  • batchRunReporting:這是 runReport 方法的批次版本,可使用單一 API 呼叫產生多份報告。
  • runPivotReport:這個方法會傳回 Google Analytics (分析) 事件資料的自訂資料透視報表。資料透視報表比一般報表更進階,更易於閱讀。每個資料透視表都會說明報表回應中可見的維度欄和列。
  • batchRunPivotReporting。這是 runPivotReport 方法的批次版本,可讓您透過單一 API 呼叫產生多份報告。
  • getMetadata 此方法會傳回報表方法中可用的維度和指標。用來探索維度和指標。這個方法的回應也會納入特定 GA4 屬性可用的自訂維度和指標。
  • runRealtimeReport:這個方法會傳回資源的即時事件資料報表。事件傳送至 Google Analytics (分析) 後幾秒內就會顯示在即時報表中。即時報表會顯示從現在到 30 分鐘前 (Google Analytics (分析) 360 資源最多 60 分鐘) 範圍內的事件和使用資料。
  • runFunnelReport (早期預覽) 這個方法會傳回您 Google Analytics (分析) 事件資料的自訂程序報表。您可以透過「程序探索」將使用者完成某件事時採取的步驟化為圖表,迅速瞭解使用者完成或不完成各個步驟的情況

支援的維度和指標

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