What is Universal Analytics?
Universal Analytics is a set of technological innovations that improve the way data is collected and processed in Google Analytics.
What is the Universal Analytics Upgrade?
The Universal Analytics Upgrade is a process you can follow to turn all of your classic Google Analytics properties into Universal Analytics properties.
Why should I upgrade?
How long does it take to upgrade?
It depends on the property you’re upgrading. There are two steps to complete the full process: 1) Transfer your property to Universal Analytics data processing technology, and 2) Implement the new Universal Analytics tracking code.
It should take you a few minutes to start the property transfer, but Google Analytics will take between 24 - 48 hours to complete the process. The time you need to implement the Universal Analytics tracking code depends on your development environment, and your data collection and reporting needs. Refer to the Upgrade Guide for details on the process.
Who should upgrade?
All classic Google Analytics properties should transfer to Universal Analytics via the Google Analytics Admin page once the option is available and you are ready to do so. After the transfer is complete, all classic tracking should be replaced with a version of the Universal Analytics tracking code: analytics.js for web tracking, the Google Analytics SDK v2.x or higher for native mobile app tracking, or the Measurement Protocol. Use the Upgrade Guide for step-by-step upgrade instructions.
If you’re already using a Universal Analytics property and have already implemented one of the above Universal Analytics tracking libraries, you don’t need to upgrade.
Users with Edit permission can transfer properties to Universal Analytics in their accounts. A developer or someone with technical knowledge should implement the new Universal Analytics tracking code.
How can I tell if I have Universal Analytics or classic Google Analytics?
There are two components that could be using either classic Google Analytics or Universal Analytics: 1) an account property and 2) the tracking code implemented on a website, mobile app, or other digital device.
Check both components to find out if you’re partially or completely using Universal Analytics.
In your account
For web properties: To find out if a web property is using Universal Analytics, sign in to your account and go to the Admin page. Select a property from the Property dropdown. A classic Google Analytics account will have an item in this column called Tracking Code. A Universal Analytics account will have an option called Tracking Info that includes sub-components called Tracking Code, Session Settings, Organic Search Sources, etc.
For app properties: All app properties operate using Universal Analytics. If you’re looking at an app property, it’s already using Universal Analytics.
In your tracking code
There are different versions of the tracking code for Universal Analytics designed for different platforms:
- Mobile apps: Mobile SDKs v2.x or higher for Android and iOS apps
- Other digital devices: Measurement Protocol
Check your tracking code, or consult with your developer, to find out if you’re using any of these collection methods. If you’re using something else that’s not listed above, like ga.js on a website, then you are using classic Google Analytics.
Do I lose any data when I upgrade?
No. When you upgrade, you can access and analyze all of your historical data using the same reports and tools you use now, but you’ll also get access to features that are only available through Universal Analytics.
Do I have to upgrade each property separately?
Yes. Because data is collected and processed at the property level in Google Analytics, each property must be upgraded individually. If you have a lot of properties in a Google Analytics account, you must follow the upgrade process for each one.
Do I have to upgrade existing Universal Analytics properties?
You don’t need to transfer properties that were created using Universal Analytics, but you might have to implement the new tracking code.
Why don't I see an option to upgrade to Universal Analytics?
You will not see an option to upgrade your property if:
- Your property has already been transferred to Universal Analytics. Learn how to determine whether you have already transferred to Universal Analytics.
What happens if I don’t upgrade to Universal Analytics?
If you don't complete Step 1 of the upgrade process, your property will be auto-transfered to Universal Analytics in the future. If you don't complete Step 2 of the upgrade process, you will continue to send data to Google Analytics from a non-Universal Analytics collection method. This data will continue to be processed for up to two years after Universal Analytics has become the new operating standard, at which time all non-Universal Analytics collection methods will be deprecated and no longer work. If you continue to send data using a non-Univesal Analytics collection method after they have been deprecated, your data will not be processed. Refer to the Upgrade Guide for details on the upgrade process, and refer to the Upgrade Phases for timeline details.
What happens if I start, and don’t finish the upgrade process?
Different things can happen, depending on where you stop the process:
If you transfer a property to Universal Analytics, all data you collect and send to that property will be processed using Universal Analytics. However, if you’ve set session and campaign timeouts in your classic Google Analytics tracking code and do not configure these settings to match in Universal Analytics while the upgrade is in process, your timeouts will revert to the default settings. This might result in corrupt or incomplete data. For sessions, you’ll see either an increase or decrease in session count. For campaigns, you’ll see an increase or decrease in the frequency of the direct traffic that appears in your reports.
Also note that any data sent from a Universal Analytics collection method to a property that has not be transfered to Universal Analytics cannot be processed.
Why am I not seeing any new data in my reports after upgrading my code?
If you transferred your property and upgraded your code but are not seeing new data in your reports, check the Real-Time reports for your upgraded property to make sure that hits are being sent from your site or app. If you do see hits in real-time, but not in your standard reports, the data has not been processed yet and will appear in reports when processing is complete, usually within 48 hours.
If you don't see hits from your site or app in real-time reports, there may be an issue with the code you upgraded that is affecting data collection. Compare your implementation to the tagging reference guides for analytics.js, Mobile SDKs, or Google Tag Manger to make sure it's correct.
What will happen to Custom Variable data when I upgrade to Universal Analytics?
Custom Variables have been replaced with Custom Dimensions in Universal Analytics. This means that after you update your tracking code, you must also set up and use Custom Dimensions in place of the Custom Variables to collect any new data.
Your historic Custom Variable data will continue to appear in your reports after you update your tracking code and set up Custom Dimensions, but Custom Variable and Custom Dimension data can’t be combined in the same report. You must use one report to analyze your Custom Variable data and another to analyze your Custom Dimension data. To analyze Custom Variable and Custom Dimension data together, export both data sets and combine them outside of Google Analytics. A tool that can help you with this is the Google Analytics Spreadsheet Add-on.
Why is there a decline in the Avg. Session Duration for my property after the upgrade?
Why does the behavior of setting campaign timeout to 0 in analytics.js differ from that in ga.js?
In classic analytics (ga.js), if you call
to set campaign timout to 0, the campaign will persist as long as the current
session or for the period the browser is open. Analytics.js does not use
campaign cookies, so this feature will not work.