TrueTrackedTrueTracked

Google Analytics 4 Setup

Connect Google Analytics 4 to TrueSignal to send server-side purchase events via the GA4 Measurement Protocol. Server-side events fill the gaps left by ad blockers and browser limitations, giving you complete, accurate conversion data in your GA4 reports.

Prerequisites:

  • A GA4 property with a Web data stream
  • Your Measurement ID (e.g. G-XXXXXXXXXX)
  • A Measurement Protocol API secret
  • TrueTracked pixel installed on your site

Step 1: Get Your Measurement ID and API Secret

  1. In GA4, click Admin (the gear icon, bottom-left)
  2. Go to Data collection and modification > Data streams and select your Web stream
  3. Copy the Measurement ID shown at the top right (format G-XXXXXXXXXX)
  4. Scroll to Measurement Protocol API secrets and click Create
  5. Give the secret a nickname (e.g. "TrueTracked") and copy the generated Secret value

Note: The API secret is required — GA4 won't accept server-side events without it. Treat it like a password and don't expose it publicly.

Step 2: Connect in TrueTracked

  1. Go to Settings > TrueSignal in your TrueTracked dashboard
  2. Click Connect on the Google Analytics 4 card
  3. Enter your Measurement ID
  4. Enter your API Secret
  5. Optionally give the connection a Name
  6. Click Connect

Step 3: Register Custom Dimensions

TrueTracked sends a few extra parameters on the server-side purchase event. GA4 collects them automatically, but they only appear in your reports once you register them as event-scoped custom dimensions.

  1. In GA4, go to Admin > Data display > Custom definitions
  2. On the Custom dimensions tab, click Create custom dimension
  3. Fill in the fields below, set Scope to Event, and click Save
Dimension nameEvent parameterDescription
Customer Typecustomer_typeNew vs returning customer at purchase

Important: The Event parameter must match exactly (lowercase, underscores) — customer_type. If it isn't in the dropdown yet (no events collected), just type it in. Custom dimensions are not retroactive — they only populate from the moment you create them, and can take 24–48 hours to appear in standard reports.

Step 4: Verify

  1. Trigger a test purchase on your site
  2. In GA4, open Reports > Realtime and look for the purchase event
  3. To inspect the full payload, enable Debug mode on the TrueSignal connection, then watch Admin > DebugView in GA4
  4. Allow 24–48 hours for the custom dimensions to populate in standard reports and explorations

Troubleshooting

  • No events appearing: Double-check your Measurement ID starts with G- and that the API Secret was copied in full. A wrong or missing secret silently drops events.
  • customer_type not in reports: Confirm you created it as an event-scoped custom dimension with the exact parameter name, then allow 24–48 hours. Custom dimensions are not retroactive.
  • Want to confirm delivery now: Enable Debug mode on the TrueSignal connection and check Admin > DebugView — events show within seconds there even before they reach standard reports.
← TikTok SetupTracking Parameters →