为了提供新功能并修复以前版本中发现的缺陷,我们会定期对 Google Analytics(分析)Real Time Reporting API 进行更新。大多数情况下,这些更改将对 API 开发者公开。不过,有时我们所做的更改也需要开发者修改其现有应用。
本页记录了对 Google Analytics(分析)Real Time Reporting API 所做的更改,这些更改可能会影响您的应用。我们建议 API 开发者定期查看此列表,及时了解最新信息。您还可以通过下文订阅部分中列出的 Feed 订阅变更通知。
订阅相关变更日志
包括所有数据收集、配置和报告 API。
包括 Core Reporting API、Multi-Channel Funnels Reporting API 和 Real Time Reporting API。
发行版本 2017-11-29(发行日期:2017 年 11 月 29 日)
此版本引入了对 Google Analytics(分析)Real Time API 配额和限制所做的变更。
使用 Google Analytics(分析)Real Time Reporting API 调用,每个数据视图(配置文件)每天可执行 1 万次调用,与其他 Google Analytics(分析)API 调用数量限制相当。现在,Google Analytics(分析)Real Time Reporting API 调用是单独统计的,这意味着使用 Google Analytics(分析)Real Time Reporting API,每个数据视图(配置文件)每天可执行 1 万次调用,并且使用其他 Google Analytics(分析)API,每个数据视图(配置文件)每天可再执行 1 万次调用。如需了解详情,请参阅限制和配额页面。
此变更提供了一种更为精细且支持故障安全的配额管理方法,因此,在使用 Google Analytics(分析)Real Time Reporting API 进行频繁调用时,不会在当天剩余时间内意外阻止单个配置文件的所有其他 Google Analytics(分析)API 调用。
发行版本 2015-02-12(发行日期:2015 年 2 月 12 日)
这是一个问题修复版本:
- 此版本修复了在 Real Time Reporting API 查询中强制执行过滤限制时出现的问题。发出
rt:activeUsers
请求并对事件一级维度进行过滤会导致错误,并返回badRequest
原因和显示OR operator not supported for a hit level filter
的消息。如需详细了解查询限制,请参阅 Real Time Reporting API 开发者指南。
发行版本 2014-10-01(发行日期:2014 年 10 月 1 日)
此版本新增了一个维度。如需查看完整的定义列表,请参阅维度和指标参考。
时间
- 维度 -
rt:minutesAgo
- 命中发生后经过的分钟数。
发行版本 2014-04-16(发行日期:2014 年 4 月 16 日)
此版本重命名了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考。
重命名的维度和指标
重命名了以下维度和指标。如需详细了解数据重命名,请查看数据弃用政策:
用户
- 维度 -
rt:visitorType
- 请改用rt:userType
。 - 指标 -
rt:activeVisitors
- 请改用rt:activeUsers
。
发行版本 2014-03(发行日期:2014 年 3 月 20 日)
弃用了 ga:
前缀
所有实时维度和指标现已弃用 ga:
前缀,并替换为新的 rt:
前缀。ga:
前缀将于 6 个月后停用,之后使用该前缀发出 API 请求将返回错误。
新维度和指标
此更新为 Real Time Reporting API 新增了一些维度和指标。如需查看完整的列表,请参阅维度和指标参考。
事件跟踪
- 维度 -
rt:eventAction
- 事件的操作。 - 维度 -
rt:eventCategory
- 事件的类别。 - 维度 -
rt:eventLabel
- 事件的标签。 - 维度 -
rt:totalEvents
- 配置文件的事件总数(针对所有类别)。
目标跟踪
- 维度 -
rt:goalId
- 与目标 ID 相对应的字符串。 - 指标 -
rt:goalXXValue
- 所请求目标数的总数值,其中 XX 为介于 1 到 20 之间的数字。 - 指标 -
rt:goalValueAll
- 为您的配置文件指定的所有目标的总数值。 - 指标 -
rt:goalXXCompletions
- 所请求目标数的总达成次数,其中 XX 为介于 1 到 20 之间的数字。 - 指标 -
rt:goalCompletionsAll
- 为您的配置文件指定的所有目标的总达成次数。
网页跟踪
- 指标 -
rt:pageViews
- 网页浏览总量。
应用跟踪
- 指标 -
rt:screenViews
- 屏幕浏览总量。
发行版本 2013-08(发行日期:2013 年 8 月 1 日)
这是 Real Time Reporting API 的初始版本(处于小范围测试阶段):
- 借助 Real Time Reporting API,您可以针对媒体资源上当前发生的活动生成报告。您可以使用 Real Time reporting API 来查询维度和指标,从而创建面向客户的网页微件和信息中心。如需了解详情,请参阅 Real Time Reporting API 概览。