Google 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 应用在上周的日活跃用户数是多少?
  • 我网站的前 10 个网页网址在过去 28 天内获得的网页浏览量分别是多少?
  • 我的 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 架构文档列出了 Google Analytics(分析)Data API 当前支持的维度和指标。