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.
← ChatGPT Ads SetupTracking Parameters →