GA4 (Google Analytics 4)

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.

A new property card expands underneath with three fields - Friendly name (optional, anything that helps you tell properties apart), Measurement ID, and API Secret.

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.

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.

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.

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).

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.

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.

Step 2 - Click Create

The API secrets list opens. Click the highlighted blue Create button on the right.

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.

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.

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.

You can add as many GA4 properties as you want by clicking Add property again - each event is sent to every active property automatically.

Event mapping

TrueMetriks standard events map to GA4 recommended events automatically:

Custom events without a mapping fire as snake_case of the event name (e.g. WatchDemo becomes watch_demo). You can configure per-property custom event mappings by expanding the property card.

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.

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.

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.

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.

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.