40 New Data Points In Google Analytics API
July 9th, 2013 | Published in Google Analytics
Over the past year we’ve added many new features to Google Analytics. Today we are releasing all of this data in the Core Reporting API!
Custom Dimensions and Metrics
We're most excited about the ability to query for custom dimensions and metrics using the API.
Developers can use custom dimensions to send unique IDs into Google Analytics, and then use the core reporting API to retrieve these IDs along with other Google Analytics data.
For example, your content management system can pass a content ID as a custom dimension using the Google Analytics tracking code. Developers can then use the API to get a list of the most popular content by ID and display the list of most popular content on their website.
Mobile Dimensions and Metrics
We've added more mobile dimensions and metrics, including those found in the Mobile App Analytics reports:
- ga:appId
- ga:appVersion
- ga:appName
- ga:appInstallerId
- ga:landingScreenName
- ga:screenDepth
- ga:screenName
- ga:exitScreenName
- ga:timeOnScreen
- ga:avgScreenviewDuration
- ga:deviceCategory
- ga:isTablet
- ga:mobileDeviceMarketingName
- ga:exceptionDescription
- ga:exceptionsPerScreenview
- ga:fatalExceptionsPerScreenview
Some examples of questions this new data can answer are:
- What is the behavior (e.g. avg time on site) of tablet vs. non-tablet visits?
- Which versions of my app are getting the most usage?
- Which screens are generating the most exceptions, and for which app version and OS combination?
Local Currency Metrics
If you are sending Google Analytics multiple currencies, you now have the ability to access the local currency of the transactions with this new data:
- ga:currencyCode
- ga:localItemRevenue
- ga:localTransactionRevenue
- ga:localTransactionShipping
- ga:localTransactionTax
Time Dimensions
We also added new time based dimensions to simplify working with reporting data:
- ga:dayOfWeekName
- ga:dateHour
- ga:isoWeek
- ga:yearMonth
- ga:yearWeek
Sample queries:
- Visits by day of the week
- Visits and pageviews by ISO week
Traffic Source Dimensions
Finally, we've added two new traffic source dimensions, including one to return the full URL of the referral.
- ga:fullReferrer
- ga:sourceMedium
Sample query: the top 10 referrers based on visits (using full referrer).
For a complete list of the new data, take a look at the Core Reporting API changelog.
For all the data definitions, check the Core Reporting API Dimensions and Metrics explorer.
As always, you can check out this new data directly within our Query Explorer tool.
We’re very excited to release this data and thrilled to see what developers build next!
Posted by Srinivasan Kannan & Pete Frisella, Google Analytics API Team