We periodically update the Google Analytics Data Export 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 Data Export API that may effect your application. We recommend that API developers periodically check this list for any new announcements. Changes will also be announced via this page's Atom feed and the Google Analytics API notify group.
This release adds a number of new features:
Some features require the use of the latest client libraries. We officially support: Java & Javascript. 3rd party libraries might not be updated yet.
GData-Version: 2 to each account or data feed request Read the documentation for more details.xmlns:ga='http://schemas.google.com/ga/2009'The API now supports the Google Data protocol version 2.
Dynamic segments query parameter:
...&segment=dynamic::expressionDefault and custom segments query parameter:
...&segment=gaid::numberThe account feed describes segment data through the following XML elements and attributes:
<dxp:segment id='gaid::-3' name='Returning Visitors'><dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>The data feed also provides an XML element indicating whether a segment was applied in the API request.
More details on advanced segments in our documentation.
Destination and engagement type goals available in the account feed:
<ga:goal active='true' name='Completing Order' number='1' value='10.0'><ga:destination expression='/purchaseComplete.html' matchType='regex'
step1Required='false' caseSensitive='false'><ga:step number='1' name='Login' path='/login.html'/><ga:engagement comparison='>' thresholdValue='300' type='timeOnSite'/>48 new goal metrics have been added for goals 5-20 which all follow the convention goal(n)Completions, where (n) is a number between 1 and 20.
ga:goal(n)Completionsga:goal(n)Startsga:goal(n)ValueGoalCompletionAll, GoalStartsAll and GoalValueAll have been updated to account for the new goal data.
All custom variables ever collected by each profile have been added as a new XML element to the account feed:
<ga:customVariable index='1' name='category' scope='visitor'>10 new dimensions have been added for custom variables. They follow the convention customVar(n) where (n) can be a number between 1 and 5.
ga:customVarName(n)ga:customVarValue(n)If you haven’t done so already, please stop using the previously deprecated dimensions and metrics. They will be removed soon and will return errors from our API if requested.
ga:countOfVisitsga:countOfVisitsToATransactionga:sourceMediumga:percentNewVisitsThe following dimensions have been renamed:
ga:countOfVisits is now ga:visitCountga:countOfVisitsToATransaction is now ga:visitsToTransactionThis release adds new features and deprecates some old functionality:
The following dimensions and metrics are now deprecated. We’ll be permanently removing them from our API in one month. Please make sure to update your code so your applications don’t break:
The following Dimensions have been renamed:
All Event Tracking data is now exposed as 2 new groups:
D7. Events (Dimensions)
M7. Events (Metrics)
Overall site navigation data is is now exposed through the following dimensions:
D6. Navigation
Landing page navigation is now exposed through the following dimensions:
D3. Content
The maximum length of regular expressions in the Data Feed’s filter query parameter has been raised from 32 to 128 characters.
The Length of Visit report (found through the UI under Visitors -> Visitor Loyalty) is now exposed through the new dimension:
This release updates the Google Analytics Data Export API as follows:
Some restrictions on dimension and metric combinations have been relaxed. You can now query most content and visitor level dimensions together, for example ga:pagePath and ga:source is now a valid combination. Please see the updated reference guide for these new combinations: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html
The total number of rows that can be asked for in one request has been increased to 10,000. The default number of rows returned is still 1,000, but can now be increased by setting the max-results query parameter.
The Account Feed now returns two new data elements for each Table ID (currency and timezone).
<dxp:property name='ga:currency' value='USD'/>
<dxp:property name='ga:timezone' value='America/Los_Angeles'/>
We’re now enforcing that data queries must include at least one valid metric.
All previous deprecation changes have taken effect.
This release removes deprecated features from our private beta:
The account feed requests will no longer support a username in them. Instead, it will only accept requests in the following format:https://www.google.com/analytics/feeds/accounts/default
The following metrics are being removed and will no longer work. Instead, we have provided instructions on how to calculate these values here: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html
The following dimensions and metrics have been renamed. The old names will no longer work. Please verify you are using the official names in our documentation here: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html
Dimensions
Metrics