BETA NOTICE: If you're interested in using this beta feature and you're on the Enterprise plan, please reach out to your success manager, who will activate this for you.
As new features are added to the product new events are added as well. To track these events in Google Analytics the tracking configuration needs to be updated in Google Tag Manager. In this article you can find instructions on how to update the Universal Analytics tracking configuration in Google Tag Manager.
In this article:
- When to update your tracking configuration
- Find out if your configuration is still up to date
- Import the latest settings into Google Tag Manager
- Updates that require manual changes
When to update your tracking configuration
After completing the steps in Setting up Universal Analytics tracking via Google Tag Manager (Beta) all important data is tracked in Google Analytics. If you're planning to use a new feature in Publitas which has been released after the time you last installed or updated Universal Analytics in your Google Tag Manager, then we recommend to consider update the configuration.
The process below is designed to overwrite the variables, trigger and tags only when changes are present. For this process to work, the names of the imported Variables, Triggers and Tags should remain the same as when the configuration was first installed.
The following settings are not included in the update process:
- UA - PageView - virtualPageView > This tag does not need to be updated in order to track new features.
- CS - UA Property > This variable does not need to be updated in order to track new features.
- UA - Google Analytics Settings > To avoid overwriting any custom changes or settings you applied to this variable, it is not included in the updating process. In case changes are required to this variable we will list them at Updates requiring manual changes.
Find out if your configuration is still up to date
The easiest way to find out if your configuration is still up to date is to process the steps below and before confirming the changes at step 8, have a look at the detected changes that are listed in the colored blocks at the bottom. You can also click View Detailed Changes for more details.
Importing the latest updates and identifying any changes:
TIP: If you know the date you installed Universal Analytics or the last date you completed the steps below you can also look at the modification date found in the filename of the attached container settings (YYYYMMDD).
Import the latest settings into Google Tag Manager
Before you proceed, please note the following:
- If you have modified any of the settings involved in the Universal Analytics configuration yourself, other than the exceptions listed above, select Rename conflicting tags, triggers, and variables at step 7 instead. The conflicting settings will appear in the lists with _import_1 added at the end. Compare your version with the imported version to locate and copy over the changes.
- If you have added exceptions to the tag UA - Event - publitasEvents, make sure to put these back if the tag has been updated as a result of the process below.
Processing the latest changes to your Universal Analytics configuration in Google Tag Manager:
- Download the settings attached to this article
- Go to the Admin section of Google Tag Manager
- Select Import Container
- Select the file to import
- Select Existing workspace and select the default workspace (or select the one you prefer to add the changes to)
- Select to Merge the selected workspace with content of imported container
- Select Overwrite conflicting tags, triggers, and variables
- Click Confirm
- Publish the changes
Updates that require manual changes
None at this point.