Google Analytics Real Time Reporting API Changelog

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.

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.

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 a badRequest reason and a message stating OR operator not supported for a hit level filter. Visit the Real Time Reporting API Developer Guide for more details on query constraints.

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.

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 - Use rt:userType instead.
  • Metric - rt:activeVisitors - Use rt:activeUsers instead.

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.

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.