Analytics Data API 概览

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

借助 Google Analytics(分析)Data API v1,您可以通过编程的方式访问 Google Analytics(分析)4 (GA4) 报告数据。Google Analytics(分析)4 可帮助您了解用户如何使用您的 Web、iOS 或 Android 应用。详细了解 Google Analytics(分析)4 媒体资源

借助 Google Analytics(分析)Data API v1,您可以创建报告来回答以下问题:

  • 过去一周内我的 Android 应用每日有多少活跃用户?
  • 在过去 28 天内,我网站在 10 个热门网页网址中分别获得了多少次网页浏览?
  • 我的 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 媒体资源的自定义维度和指标。
  • runRealtimeReport:此方法会返回自定义的实时事件数据报告。事件在发送到 Google Analytics(分析)几秒钟后,就会出现在实时报告中。实时报告会显示从当前时刻到 30 分钟前(Google Analytics 360 媒体资源最多 60 分钟)内的事件和使用情况数据。
  • runFunnelReport(早期预览)此方法会返回 Google Analytics(分析)事件数据的自定义漏斗报告。借助漏斗探索,您可以直观呈现用户为完成任务而采取的步骤,并快速查看用户在每个步骤上的成功或失败情况。

支持的维度和指标

API 架构文档列出了 Analytics Data API 目前支持的维度和指标。