Google Analytics Data API 概览

您可以使用 Data API 执行以下操作： 以编程方式访问 Google Analytics 报告数据。本次 API 与旧版 Universal Analytics 媒体资源不兼容。

详细了解 Google Analytics 属性。

下面是一些您可能针对 Google Analytics Data API v1 的使用报告的示例：

  • 过去一周内您的 Android 应用的日活跃用户数。
  • 您网站上排名前 10 的网页在过去 28 天内的网页浏览量。
  • 过去 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 方法的批处理版本，通过该方法，您可以生成 生成多份报告。
  • getMetadata 此方法会返回 报告方法中可用的维度和指标的元数据。习惯 您不妨探索一下维度和指标。此方法的响应还会 包括适用于指定 Google Analytics 媒体资源。
  • checkCompatibility 这 方法列出可添加到报告请求的维度和指标 并保持兼容性
  • runRealtimeReport 这 方法会返回自定义的实时事件数据报告 媒体资源事件发生数秒后，就会显示在实时报告中 已发送至 Google Analytics实时报告会显示事件和使用情况 从现在到 30 分钟时间段内的数据 （对于 Google Analytics 360 媒体资源，最长为 60 分钟）。
  • properties.audienceExports 一组可用于生成受众群体的方法 导出内容，其中包含 受众群体。
  • properties.recurringAudienceLists （早期预览版）一组方法，可让您管理周期性 受众群体导出。定期导出受众群体会生成新的受众群体名单 。
  • runFunnelReport （早期预览版）此方法会返回一个自定义漏斗 报告。漏斗探索 您可以直观了解用户为完成任务而采取的步骤， 看看他们在每个步骤上的状况。

支持的维度和指标

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