This topic will show you how to setup Google Tag Manager and send data to Google Analytics. After you’re done, the Google Tag Manager API will be running on your Discourse site, so you could in theory send arbitrary events to any service that integrates with Tag Manager. Analytics is only the beginning.
This guide covers setting up Google Tag Manager, if you only want to enable Google Analytics for your site, simply set the G-Tag in the
ga universal tracking code
site setting. Our settings may still refer to all analytics asuniversal
. This is simply legacy field naming artifacts. The following instructions use, and work for, Google Tags.
Google Analytics
First you’ll need to create an Analytics account. If you’re signed in with a Google account, then simply visiting https://analytics.google.com will guide you through creating an account.
Once in your account, create a property:
From here you’ll work your way through 4 screens. The first is Property creation
:
Then Business details
:
Then Business objectives
.
Selecting the four sections will most closely match the reports Analytics has typically provided:
And finally, Data collection
. Here you’ll select Web
as the platform:
Now set up a data stream by entering your site url and a stream name:
After successfully creating your web stream, you’ll get a Web Stream Details page. Make note of your Management ID on this page. You’ll need this later when setting up your GTM Tag.
We’re done with the property setup in Analytics!
Tag Manager
Visit https://tagmanager.google.com and let Google set you up. Once you’re in, you’ll be prompted to create your first “Account” and “Container”. When asked where the container will be used, choose “Web”.
Now that your container has been created, we need to create the events we’ll send through the Tag Manager API to Google Analytics.
Variables
Go to the Variables tab on the left. Click the “New” button in the User-Defined Variables section at the bottom. You’ll need to create two data layer variables:
Title: DL - page title
Type: Data Layer Variable
Data Layer Variable Name: page.title
Data Layer Version: 2
Title: DL - page url
Type: Data Layer Variable
Data Layer Variable Name: page.url
Data Layer Version: 2
As an example, choose the variable type:
Then configure the variable:
Triggers
Now let’s create a trigger that does something when those variables arrive from the API. Click the “Triggers” tab on the left and click New. Choose “Page View” as the type, click save, and name the trigger virtualPageView
.
Your trigger should look like this once it’s been saved.
Tags
Finally…we’re ready to connect GTM to Analytics. Click the Tags tab on the left and create a New tag. Then Choose Tag Type Google Analytics: Google Tag
- Configure Tag:
- Measurement ID: enter your Measurement ID from your Analytics Web Stream
- Required Fields to Set:
- name:
cookieDomain
, value:auto
- name:
title
, value:{{DL - page title}}
(can be chosen from a dropdown) - name:
page
, value:{{DL - page url}}
(can be chosen from a dropdown) - name:
send_page_view
, value:true
(this is a remnant from GA4 setups, so for the time being we’re including it)
- name:
When finished it should look like this (note that the userID
field is optional):
-
Triggering:
- Choose
virtualPageView
- Choose
-
Save and Name Tag
We’re almost done!
Publish
None of your work is live until you click the Publish button on the top right of the page. It will be red if there are changes that haven’t been published.
If your Discourse site is reporting 404 errors from googletagmanager.com, it’s probably because you didn’t publish your changes.
Discourse
GTM is waiting for data, so let’s add it to our Discourse site. Go to the Settings tab of admin and search for gtm container id
and enter your Tag Manager id (GTM-XXXXXXXX
). It should always be displayed on the top navigation bar of the Tag Manager UI.
Be sure to remove your Analytics tracking code from the
ga universal tracking code
andga tracking code
settings.
Reload the page and data should be flowing through GTM to Analytics. Watch the real-time content view to see traffic and url’s of your site visitors.
More?
Now that you have pageview data going into tag manager, you could add more Tags that receive the events. Google DFP, AdWords, LinkedIn, and others are in the list.
Related Links:
- Use nonces in Google Tag Manager scripts
- Push custom events to Google Tag Manager and Analytics
- Add Google Auto Ads to Discourse via Google Tag Manager
*Last Updated by @MarkDoerr on 2024-05-03T07:00:00Z