Google Analytics Data API 總覽

您可以使用 Data API： 以程式輔助方式存取 Google Analytics 報表資料。這個 API 與舊版通用 Analytics 資源不相容。

進一步瞭解 Google Analytics 資源

以下提供幾個使用 Google Analytics Data API v1 報表的範例：

  • 過去一週內，您 Android 應用程式的每日活躍使用人數。
  • 過去 28 天內，你網站上前 10 名網頁的網頁瀏覽次數。
  • 您的 iOS 應用程式過去 30 分鐘內在每個國家/地區的活躍使用者人數。

您也可以使用 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 結構定義說明文件。