The Google Analytics 4 Connector sends your Tracklution-tracked events to Google Analytics 4 through the Tracking Pixel and the GA4 Measurement Protocol (API). New connectors use the latest version, GA4 v2. The legacy GA4 v1 is also available; see Connector versions below.
Before you start
Get these two values from Google Analytics:
- Measurement ID. In GA4, go to Admin > Data Streams and open your web data stream. The Measurement ID is at the top right and looks like
G-XXXXXXXXXX.
- API Secret value. In the same data stream, open Measurement Protocol API secrets, click Create if you do not have one yet, and copy the Secret Value.
Setting up the connector
In the Tracklution dashboard click "add" or "edit" on the GA4 Connector, then work through the settings from top to bottom.
1. Enter your GA4 details. Paste your Measurement ID and API Secret value into their fields.
2. Verify your DNS settings. The connector needs first-party mode active on your domain. If you have not set it up yet, open your container's First-Party Mode tab and add the DNS record shown there to your own DNS settings. Once it is in place, click Verify DNS Installation, and the connector confirms with DNS installation verified.
3. Choose your Consent Mode option. Pick the option that matches how your consent banner works with the Tracklution script:
- I use Advanced Consent Mode if the Tracklution script loads on every visit and updates once the visitor accepts.
- Tracklution only loads after consent is given if your banner blocks the script until the visitor consents.
- I don't use Consent Mode for sites where consent requirements do not apply, such as outside the EU/EEA.
A selection is required to run GA4 v2, and the connector uses v2 by default once you have chosen.
:::Info
You consent settings here applies to your whole container, not only the GA4 connector.
:::
4. Set the connector live. Toggle the connector on to start sending data to GA4. You can also save your details now and switch it on later.
:::Warning
If you already track GA4 through your site, GTM, or another integration, make sure it is not sending the same events to the same GA4 property, or they will be counted twice. Sending to a different GA4 property is fine, for example when testing alongside your current setup.
:::
Checking your data
To confirm GA4 is receiving events, browse your site and watch them arrive under Reports > Realtime in GA4.
Connector versions
You can see which version a connector uses from the badge under Setup (for example GA4 v2).
GA4 v2 is the current version and the default for new connectors. It runs Google's tag directly on your site, so Google Analytics behaves as it does with a standard installation: normal sessions and attribution, and GA4's automatic Enhanced Measurement (scroll, clicks, site search, and more). It also keeps collecting events the browser would otherwise miss, such as purchases and hits blocked by ad blockers, by sending them from Tracklution's servers.
GA4 v1 is the legacy version. It runs entirely separately from your site and adds nothing to the page, delivering your tracked events to GA4 on its own. This keeps it fully independent of everything else running on your site. Because it does not run on the page, GA4's on-page features such as Enhanced Measurement are not included.
To switch versions, open Show advanced settings and use the Use legacy GA4 v1 delivery toggle.
Troubleshooting
Having issues? Visit our Troubleshooting and FAQ article for answers to the most common questions.
