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 結構定義文件。