GA4 (Google Analytics 4)
TrueMetriks sends all your events to GA4 so your analytics are complete. Here is how to set it up.
Set this up with AI
Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.
Add a GA4 property in TrueMetriks
Video guide
In the TrueMetriks dashboard, open Settings > Ad integrations, pick the GA4 tab, and click the highlighted Add property button.
Google Analytics 4 Not connected
Add unlimited GA4 properties. Each event is sent to every active property.
A new property card expands underneath with three fields - Friendly name (optional, anything that helps you tell properties apart), Measurement ID, and API Secret.
New property
ActiveFriendly name (optional)
Measurement ID
API Secret
Personalized Ads
When OFF, GA4 runs analytics-only (GDPR-friendly mode).
Debug mode 1h
Auto-disables 1h after toggle on. Verify events in GA4 DebugView.
Both the Measurement ID and the API Secret live inside GA4. The next two sections walk you through copying them.
Copy the Measurement ID from GA4
Open Google Analytics 4 in another tab and pick the property you want to send events to.
Step 1 - Click Admin in the left rail
In the GA4 left navigation, scroll to the bottom and click the highlighted Admin link.
- Home
- Reports
- Explore
- Advertising
- Tasks
- Admin
Step 2 - Click Data streams under "Data collection and modification"
On the Admin page, find the Data collection and modification card on the right side and click the highlighted Data streams row.
PROPERTY SETTINGS
Property
These settings affect your property
Data collection and modification
These settings control how data is collected and modified
Step 3 - Add a Web stream (only if you don't already have one)
If a web data stream already exists for this property, skip to Step 4. Otherwise, click Add stream and pick Web.
Data streams
GA4 walks you through a quick form - enter your site URL and a stream name, then click Create stream. The new stream appears in the list once it's created.
Step 4 - Click into the web stream
Back on the Data streams page, click the row for the web stream you just created (or your existing one).
Data streams
Demo Brand - WEB
https://demo-brand.example/
4659844823
Receiving traffic in past 48 hours.
Step 5 - Copy the Measurement ID
The Stream details panel opens. The Measurement ID is in the top-right corner of the Stream details card - it starts with G- (e.g. G-Q7ZQSRH9G7). Click the copy icon next to it.
Stream details
STREAM NAME
Demo Brand - WEB
STREAM URL
https://demo-brand.example/
STREAM ID
4659844823
MEASUREMENT ID
G-Q7ZQSRH9G7
Paste it into the Measurement ID field of your TrueMetriks property card.
Create an API Secret in GA4
Stay on the same Stream details page - the API Secret lives a little further down on the same page.
Step 1 - Scroll to Measurement Protocol API secrets
Scroll down to the Events block and click the highlighted Measurement Protocol API secrets row.
Events
Enhanced measurement
Automatically measure interactions and content on your sites in addition to standard page view measurement.
Modify events
Modify incoming events and parameters.
Create custom events
Create new events from existing events.
Measurement Protocol API secrets
Create an API secret to enable additional events to be sent into this stream through the Measurement Protocol.
Step 2 - Click Create
The API secrets list opens. Click the highlighted blue Create button on the right.
Measurement Protocol API secrets
Create a secret to enable additional events to be sent into this stream through the Measurement Protocol.
Step 3 - Give it a nickname and click Create
GA4 opens a small form. Enter any nickname (something like truemetriks is fine - it is just for your reference inside GA4) and click the highlighted Create button in the top-right.
Create new API secret
Nickname
Step 4 - Copy the secret value
The secret is created and appears in the list. Click the highlighted copy icon next to the Secret value column.
Create a secret to enable additional events to be sent into this stream through the Measurement Protocol.
Paste it into the API Secret field of your TrueMetriks property card.
Save the property in TrueMetriks
Back in TrueMetriks, both fields are now filled in. Click the highlighted Save GA4 settings button at the bottom of the card.
Main store
ActiveFriendly name (optional)
Measurement ID
API Secret
You can add as many GA4 properties as you want by clicking Add property again - each event is sent to every active property automatically.
Send hashed customer data
Turn this on and TrueMetriks sends your customer's email, phone and name to GA4 with each event from a known customer, so Google Ads can match more of them to the ads that earned them. This is what Google calls enhanced conversions for GA4.
TrueMetriks hashes email, phone, name and street address on its server before they leave.
City, region, postal code and country are sent as plain text, because Google requires them that way.
Step 1 - Check the requirements
Your site must have your visitors' consent to share this data with Google. Cover it in your cookie banner and privacy policy.
It is not allowed for GA4 properties in the Health category. Leave it off for those.
Step 2 - Turn on User-provided data collection in GA4
In GA4, go to Admin, then Data collection and modification, then Data collection. You need Editor access on the property.
Turn on User-provided data collection and accept the terms.
Data collection
Google signals data collection
Collect data from users who have turned on Ads Personalization.
User-provided data collection
Collect data that you send to Google, such as email addresses, for better conversion measurement and audiences.
Step 3 - Link GA4 to Google Ads
In GA4, go to Admin, then Product links, then Google Ads links, and link the Google Ads account that runs your ads. To connect that account to TrueMetriks, follow the Google Ads guide.
Step 4 - Turn it on in TrueMetriks
Open your GA4 property card and turn on Send hashed customer data. It needs Personalized Ads to be on. Then click Save GA4 settings.
G-Q7ZQSRH9G7
GIVE A NAME - GDPR-friendly mode off ActiveFriendly name (optional)
Measurement ID
API Secret
Personalized Ads
When OFF, GA4 runs analytics-only (GDPR-friendly mode).
Send hashed customer data
Sends hashed email, phone and name so Google Ads can match more conversions. Turn on User-provided data collection in GA4 first. Not allowed for Health properties
Debug mode 1h
Auto-disables 1h after toggle on. Verify events in GA4 DebugView.
Step 5 - Check that it works
In GA4, open Admin, then Data collection. It shows when user-provided data is being received.
Results can take up to a month to show in Google Ads.
Remove your old GA4 tracking
Once your GA4 property is saved, TrueMetriks sends every event for this site to GA4 from its server. Any other GA4 tracking makes GA4 count each visit and conversion twice. So remove it:
- The GA4 tag on your site. Delete the Google tag code with your Measurement ID (it starts with
G-) and anygtag(...)event code from your theme, page builder, and header and footer scripts. - GA4 tags in Google Tag Manager. Pause or delete the Google tag and GA4 event tags, then publish the container.
- GA4 in plugins and apps. Turn off GA4 tracking in tools such as Site Kit by Google, MonsterInsights or the Shopify Google & YouTube app.
Keep the GA4 property itself: TrueMetriks sends your events to it.
Event mapping
TrueMetriks standard events map to GA4 recommended events automatically:
| TrueMetriks event | GA4 event |
|---|---|
| PageView | page_view |
| ViewContent | view_item |
| AddToCart | add_to_cart |
| InitiateCheckout | begin_checkout |
| Lead | generate_lead |
| Schedule | schedule |
| Purchase | purchase |
Custom events without a mapping fire with the event name in lowercase (e.g. WatchDemo becomes watchdemo). A per-property custom event mapping renames a custom event for that one property. Expand the property card to add one.
How to verify events are flowing
There are two ways to confirm GA4 is receiving your TrueMetriks events. Either works on its own - pick whichever is more convenient.
Before either method works, the TrueMetriks tracker has to be installed on your platform (WordPress, Shopify, GoHighLevel, ClickFunnels, or a custom install) and connected to TrueMetriks. Follow the Test your integration guide if you have not done that yet.
Video guide
Method 1 - Realtime overview in GA4
The fastest check is GA4's built-in Realtime overview.
Step 1 - Open Reports > Realtime overview in GA4
In the GA4 left rail, click Reports, then click the highlighted Realtime overview.
Step 2 - Watch events arrive in real time
The Realtime overview page shows active users in the last 30 minutes, a per-minute bar chart, and Event count by Event name in the bottom-right card. Browse your live site in an incognito window and within ~30 seconds you should see page_view, begin_checkout, purchase, and any other events you triggered tick up.
ACTIVE USERS IN LAST 30 MINUTES
6
ACTIVE USERS IN LAST 5 MINUTES
3
ACTIVE USERS PER MINUTE
Active users by First user source
#1 -
No data available
Active users by Audience
#1 All Users
6
Views by Page title and screen name
#1 -
No data available
Event count by Event name
#1 page_view
24
Method 2 - GA4 DebugView
DebugView shows every event arriving for a debug device, with timestamps and parameters. It only shows events from properties with Debug mode turned on, so you toggle that in TrueMetriks first.
Step 1 - Turn on Debug mode in TrueMetriks
Back in your TrueMetriks property card, toggle Debug mode on. The sub-label flips to Active - expires in 60 min (Debug mode auto-disables after 1 hour so it never stays on accidentally). Click Save GA4 settings.
G-Q7ZQSRH9G7
GIVE A NAME - GDPR-friendly mode off ActiveFriendly name (optional)
Measurement ID
API Secret
Personalized Ads
When OFF, GA4 runs analytics-only (GDPR-friendly mode).
Send hashed customer data
Sends hashed email, phone and name so Google Ads can match more conversions. Turn on User-provided data collection in GA4 first. Not allowed for Health properties
Debug mode 1h
Active - expires in 60 min
Step 2 - Open Admin > DebugView in GA4
In GA4, click Admin in the left rail, scroll down to the Data display card at the bottom of the right column, and click the highlighted DebugView row.
Data display
These settings control how data is shown in your reports
Step 3 - Pick your debug device and watch events stream in
DebugView shows a Debug Device list on the left, a per-minute summary in the middle, and a live event stream on the right. Pick your debug device, then browse your site - within ~3 seconds every event TrueMetriks fires lands on the timeline.
Debug Device 4
- 10:57 AM
- 10:56 AM
- 10:55 AM
- 10:54 AM
- 10:53 AM
- 10:52 AM
page_view, begin_checkout, purchase, add_to_cart, and every other event you mapped will appear here as you trigger them. If you see them, the integration is fully wired up.
Frequently asked questions
What do I need to copy from GA4 to connect a property?
Two values, both inside GA4: the Measurement ID (starts with G-) from your web stream's details, and an API Secret you create under Measurement Protocol API secrets on the same stream.
Should I remove my old GA4 tag?
Yes. Once your GA4 property is saved in TrueMetriks, remove the GA4 tag from your site and Google Tag Manager, and turn off GA4 in any plugin or app, or every visit and conversion is counted twice. Keep the GA4 property itself: TrueMetriks sends your events to it.
Can I send events to more than one GA4 property?
Yes. Click Add property again for each one. Every event TrueMetriks tracks is sent to every active property automatically.
How do standard TrueMetriks events map to GA4?
Standard events map to GA4 recommended events automatically (for example Purchase becomes purchase, AddToCart becomes add_to_cart). Custom events without a mapping fire with the event name in lowercase.