Google Analytics(分析)Real Time Reporting API 变更日志

为了提供新功能并修复以前版本中发现的缺陷,我们会定期对 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。

此版本引入了对 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 调用。

这是一个问题修复版本:

  • 此版本修复了在 Real Time Reporting API 查询中强制执行过滤限制时出现的问题。发出 rt:activeUsers 请求并对事件一级维度进行过滤会导致错误,并返回 badRequest 原因和显示 OR operator not supported for a hit level filter 的消息。如需详细了解查询限制,请参阅 Real Time Reporting API 开发者指南

此版本新增了一个维度。如需查看完整的定义列表,请参阅维度和指标参考

时间

  • 维度 - rt:minutesAgo - 命中发生后经过的分钟数。

此版本重命名了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

重命名的维度和指标

重命名了以下维度和指标。如需详细了解数据重命名,请查看数据弃用政策

用户

  • 维度 - rt:visitorType - 请改用 rt:userType
  • 指标 - rt:activeVisitors - 请改用 rt:activeUsers

弃用了 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 - 屏幕浏览总量。

这是 Real Time Reporting API 的初始版本(处于小范围测试阶段):

  • 借助 Real Time Reporting API,您可以针对媒体资源上当前发生的活动生成报告。您可以使用 Real Time reporting API 来查询维度和指标,从而创建面向客户的网页微件和信息中心。如需了解详情,请参阅 Real Time Reporting API 概览