Google Analytics Data API 概览

您可以使用 Data API 以编程方式访问 Google Analytics 报告数据。

详细了解 Google Analytics 媒体资源。

API 返回的数据与 Google Analytics 界面中显示的数据一致，并且完全遵循为 Google Analytics 媒体资源配置的报告中使用的 ID 设置（例如混合、观测或基于设备的 ID）。

以下是一些您可以使用 Google Analytics Data API v1 生成的报告示例：

  • 您的 Android 应用上周的日活跃用户数是多少。
  • 您网站上排名前 10 的网页在过去 28 天内的网页浏览量。
  • 您的 iOS 应用在过去 30 分钟内，在每个国家/地区有多少活跃用户。

您还可以使用 Google Analytics Data API v1 执行以下操作：

  • 构建自定义信息中心，以展示 Google Analytics 数据。
  • 自动完成复杂的报告任务，从而节约时间。
  • 将 Google Analytics 数据与其他业务应用集成。

数据一致性和在报告中使用的 ID

Google Analytics Data API v1 访问的报告数据与 Google Analytics 界面相同。API 返回的数据完全遵循为 Google Analytics 媒体资源配置的报告中使用的 ID 设置，因此用户数、去重和数据建模与媒体资源设置中选择的 ID 空间（例如混合、观测或基于设备的 ID）保持一致。

如需详细了解不同的身份空间如何影响报告，请参阅在报告中使用的 ID。

开始使用

如需开始使用，请参阅客户端库快速入门。我们提供了 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 事件数据的漏斗报告。借助漏斗探索，您可以直观呈现用户为完成某项任务而采取的各个步骤，并能快速看出用户在每个步骤的进展情况。
  • properties.chat （早期预览版）此方法以编程方式提供对 Google Analytics 中的 Ask Advisor 的对话式访问。您可以就事件数据提出自然语言问题、诊断性能变化，并获得结构化叙述和表格形式的分析洞见。

支持的维度和指标

如需查看 Data API 支持的所有维度和指标的列表，请参阅 API 架构文档。