本文档说明了 Google Analytics(分析)Reporting API v4。有关这一 API 的详细参考,请参阅参考指南。
简介
Google Analytics(分析)Reporting API v4 是访问 Google Analytics(分析)报告数据的最先进程序化方法。借助于 Google Analytics(分析)Reporting API,您可以:
- 构建自定义信息中心,以展示 Google Analytics(分析)数据。
- 自动完成复杂的报告任务,从而节约时间。
- 将 Google Analytics(分析)数据与其他业务应用集成。
功能
Google Analytics(分析)构建在功能强大的数据报告的基础设施上。Google Analytics(分析)Reporting API v4 可供您使用 Google Analytics(分析)平台的强大功能。API 提供以下关键功能:
指标表达式
该 API 不仅允许您请求内置指标,还有数学运算中表达的指标组合。例如,您可以使用表达式
ga:goal1completions/ga:sessions
请求根据会话次数的目标达成次数。多个日期范围
该 API 允许您在一个请求中获得两个日期范围的数据。
同类群组和生命周期价值
该 API 拥有丰富的词汇来请求同类群组和生命周期价值报告。
多个细分
该 API 允许您通过一个请求中获取多个细分。
选择使用哪个版本的 Analytics Reporting API
构建新的应用:
使用 Analytics Reporting API v4 的原因是:
- API v4 的功能集更丰富,如生命周期价值、同类群组以及高级细分报告。
- 所有的新功能开发均将支持使用 API v4。
将现有的应用迁移为使用 API v4:
- 如果您在应用中使用 Core Reporting API v3,将其迁移到 API v4,以利用 v4 的新功能。
- 从 API V3 迁移到 API V4 非常简单,原因是 V4 支持 V3 的细分和过滤条件语法。
继续使用这一 API 的 v3 或更早的版本:
- 该 Analytics Reporting API v4 独立于其他 v3 API(如 Management API、Metadata API 等等),且需要单独的客户端库。如果您所构建的应用(即移动应用)空间有限,这可能会成为继续使用 API v3 的一个因素。
- 我们将继续支持早期版本的 API,但新功能将面向 API v4 进行开发。
- 对 API v3 支持进行的所有更改都将在变更日志中发布。
后续步骤
快速入门指南
下表提供了一套快速入门指南,帮助您快速上手。您需要选择语言和应用类型:
服务应用 | 安装版应用 | 网络应用 |
---|---|---|
Java | Java | — |
Python | Python | — |
PHP | — | PHP |
— | — | JavaScript |
要更好地了解如何使用 Analytics Reporting API v4,请参阅创建报告。