We periodically update the Google Analytics Real Time Reporting API in order to deliver new features and to repair defects discovered in previous versions. In most cases, these changes will be transparent to API developers. However, occasionally we need to make changes that require developers to modify their existing applications.
This page documents any changes made to the Google Analytics Real Time Reporting API that might affect your application. We recommend that API developers periodically check this list for any new announcements. You can also subscribe to changes via the feeds listed under the Subscribe section below.
Subscribe To Related Changelogs
Includes all Collection, Configuration, and Reporting APIs.
Includes Core Reporting API, Multi-Channel Funnels Reporting API, and Real Time Reporting API.
Release 2017-11-29 (November 29, 2017)
This release introduces changes to the Analytics Real Time API quotas and limits.
Analytics Real Time Reporting API calls used to contribute to the 10,000 calls per view (profile) per day limit on par with other Analytics API calls. Now, Analytics Real Time Reporting API calls are accounted separately, which means it is possible to make 10,000 calls per day per view (profile) using the Analytics Real Time Reporting API AND make another 10,000 calls per day per view (profile) using any other Analytics APIs. See the Limits and Quotas page for more info.
This change provides more granular and fail-safe approach to managing quotas, so that frequent calls using the Analytics Real Time Reporting API would not accidentally block all other Analytics API calls for the rest of the day for an individual profile.
Release 2015-02-12 (February 12, 2015)
This is a bug fix release:
- This release fixes an issue in enforcing the filtering constraints in the Real Time Reporting API query. Requests with
rt:activeUsers
and a filter on an event level dimension would result in a error with abadRequest
reason and a message statingOR operator not supported for a hit level filter
. Visit the Real Time Reporting API Developer Guide for more details on query constraints.
Release 2014-10-01 (October 1, 2014)
This release includes a new dimension. Review the Dimensions and Metrics Reference for the complete list of definitions.
Time
- Dimension -
rt:minutesAgo
- The number of minutes ago a hit occurred.
Release 2014-04-16 (April 16, 2014)
This release includes the renaming of dimensions and metrics. Review the Dimensions and Metrics Reference for the complete list of definitions.
Renamed Dimensions and Metrics
The following dimensions and metrics have been renamed. Review the Data Deprecation Policy for details on data renaming:
User
- Dimension -
rt:visitorType
- Usert:userType
instead. - Metric -
rt:activeVisitors
- Usert:activeUsers
instead.
Release 2014-03 (March 20, 2014)
ga:
Prefix Deprecated
The ga:
prefix has been deprecated for all Real Time Dimensions and Metrics and has been replaced by the new rt:
prefix. API requests that use the ga:
prefix will continue to work for 6 months, after which an error will be returned.
New Dimensions and Metrics
This update adds new dimensions and metrics to the Real Time Reporting API. Check the Dimensions and Metrics Reference for the complete list.
Event Tracking
- Dimension -
rt:eventAction
- the action of the event. - Dimension -
rt:eventCategory
- the category of the event. - Dimension -
rt:eventLabel
- the label of the event. - Dimension -
rt:totalEvents
- the total number of events for the profile, across all categories.
Goal Tracking
- Dimension -
rt:goalId
- a string corresponding to the goal ID. - Metric -
rt:goalXXValue
- the total numeric value for the requested goal number, where XX is a number between 1 and 20. - Metric -
rt:goalValueAll
- the total numeric value for all goals defined for your profile. - Metric -
rt:goalXXCompletions
- the total number of completions for the requested goal number, where XX is a number between 1 and 20. - Metric -
rt:goalCompletionsAll
- the total number of completions for all goals defined for your profile.
Page Tracking
- Metric -
rt:pageViews
- the total number of page views.
App Tracking
- Metric -
rt:screenViews
- the total number of screen views.
Release 2013-08 (August 1, 2013)
This is the initial release of the Real Time Reporting API in limited beta:
- The Real Time Reporting API allows you to report on activity occurring on your property right now. You can use the Real Time reporting API to query for dimensions and metrics in order to build customer facing web widgets and dashboards. Visit the Real Time Reporting API Overview for more details.