Configuration: Google Analytics 4
Setup Checklist
GOOGLE ANALYTICS TASKS |
|
---|---|
| detailed status |
Detailed Setup Guide
NOTE: Aspenware Commerce has added the ability to load Adobe Analytics credentials for resort customers who use both reporting platforms. Including these credentials will enable Adobe Analytics to connect and pull data from the same tags that GA4 will leverage. In essence, users of both platforms will have access to two reporting interfaces.
1. Set Up Google Analytics
If you are currently using Universal Analytics, and have not created a GA4 Property, you must create a new GA4 Property. See Add Google Analytics 4 property.
If you are a brand new user of Google Analytics, you must create an account and a new GA4 property. See Set up Analytics for a website and/or app.
2. Set Up Google Tag Manager
Current UA (Universal Analytics) users do not need to create a new GTM Container, as you will use your existing one. See Add a Google Analytics 4 property to a site that already has analytics.
Users new to Google Tag Manager will create a GTM Container. See Setup and install Tag Manager.
3. Hardcode Currency in Google Tag Manager
Google Analytics 4 requires a defined currency to report revenue accurately. Currency can be defined in multiple places, but hardcoding the currency in the GTM container is the best way to ensure that your revenue is reported correctly.
IMPORTANT: This task must be completed by an admin or user with publish permissions in Google Tag Manager, and should take less than 2 minutes to complete. Be sure to complete this for every container (every site) you monitor, in both test and production.
The requirement references how currency is defined and reported in your site, and requires a 3-digit code to be entered. The most common codes for Aspenware resorts are:
US Dollar: USD
Canadian Dollar: CAD
Australian Dollar: AUD
New Zealand Dollar: NZD
Please make a note of the currency for your site(s), and follow the instruction below to configure:
Log in to the Google Tag Manager Account
In the sidebar, select Tags
Locate the Purchase Event in the tag list, and select.
Identify the variable you are using for the currency parameter and make a note of it (e.g. {{GA4-Ecommerce Currency}} in the example below).
Close the tag and select Variables in the sidebar. Select the ecommerce variable you identified in the previous step.
Change the Variable Type from Data Layer Variable to Constant.
Enter your currency code in the Value field. Currency code entries are 3 characters:
USD (US Dollar)
CAD (Canadian Dollar)
AUD (Australian Dollar)
NZD (New Zealand Dollar)
If your Variable is already defined as Constant, simply update the Value from 000 to the correct currency code.
Save your changes and click Submit in the upper right.
Publish the container. We suggest including “Hardcode Currency…” or some other identifier in the version name field.
4. Import Triggers/Tags
Import the GA4 Setup Container, which contains tags, triggers and variables. See Container export and import.
In the article (above), scroll down to and follow the “Import” instructions using the Aspenware GA4 Import Tags File.json below.
IMPORTANT: Which file should I import?
There are multiple Tags and Triggers json files available for import.
8.22.22 Tags and Triggers File
The file dated 8.22.22 contains the standard events and tags suggested by Google for initial GA4 deployment.
3.7.23 Tags and Triggers File
The second file, dated 3.7.23, includes additional tags and events, including events that capture account creation and login activities.
6.9.23 Tags and Triggers File
The file dated 6.9.23 is stripped of all the Universal Analytics tags.
Which file should you import?
If you are configuring your GTM account for the first time, select the most current version of our tags and triggers file.
If you already imported a previous tags and triggers file, and have not added any customization, import the most current version of our Tags and Triggers json file.
If you have customized your tags and triggers file, importing our latest json file will overwrite your customization. Instead, use the most current file to compare your existing json to our new file, and add any new events/tags manually, using the same process you did when you customized the file.
The GA4 Configuration & Page View tag may vary depending on setup. Use preview mode in GTM to test the integration and make sure you are collecting the correct page view data.
The GA4 Configuration & Page View tag may not be needed if you already have the tag in your GTM container. Multiple GA4 Configuration & Page View tags could cause duplicate page views and events.
File Date | JSON File |
---|---|
6.9.23 |
|
4.6.23 |
|
3.1.23 |
|
8.2.22 |
|
Edit Variables
After the import is complete, go to Variables (left nav).
Select GA4 Measurement ID from the list.
Edit Value. Replace with your GA4 Measurement ID.
Preview and Publish your container.
For Preview instructions, see Preview and debug containers - Tag Manager Help
For Publish instructions, see Publishing, versions, and approvals - Tag Manager Help
The tags are now reporting to your GA4 dashboard.