GA4 Setup

Step 1 — Add your Measurement ID

In your WordPress admin, go to Settings → SCOS → Analytics. Enter your GA4 Measurement ID in the field provided and save.

The Measurement ID format is G-XXXXXXXXXX. Make sure the Analytics module toggle is enabled — the module will not load if it is switched off.

Step 2 — Seed your events

Visit your site with ?seedEvents=true appended to any URL:

https://yoursite.com.au/?seedEvents=true

This triggers the event seeder, which fires each tracked event once so GA4 registers them automatically. You only need to do this once per site — or again if you add new event classes in future.

Events appear in GA4 under Reports → Engagement → Events within a few minutes. Some events may take up to 24 hours to appear in standard reports but will show immediately in Realtime.

The seeder only fires for logged-in admins or when ?seedEvents=true is present in the URL. It does not affect live visitor data. Admin and editor sessions are excluded from all tracking automatically — your own site visits will never appear in your GA4 reports.

Step 3 — Set up Custom Dimensions (recommended)

The Analytics module sends content strategy context with every event — cluster, intent, maturity, service pathway, and more. To use this data in GA4 reports, the dimensions need to be registered once in your GA4 property.

This is a one-time setup in the GA4 admin interface and takes around five minutes.

Set up Custom Dimensions →

Verifying it’s working

After setup, open GA4 and go to Reports → Realtime. Visit your site in a separate browser tab (logged out, or in an incognito window — admin sessions are excluded). You should see a page_view event appear within seconds.

Click a CTA or phone link on the site. The corresponding event should appear in Realtime within a few seconds.

Troubleshooting

No events appearing in Realtime

Check that the Measurement ID is entered correctly — it must start with G-. Confirm the Analytics module is toggled on in SCOS settings. Make sure you are testing in an incognito window or logged-out browser session, as admin tracking is suppressed by design.

Events appearing but no custom dimension data

Custom dimensions need to be registered in GA4 before they appear in reports. See the Custom Dimensions setup guide.

?seedEvents=true not triggering

You must be logged in as an admin for the seeder to fire. If you are logged in and it still does not trigger, check that the Analytics module is active and that no caching layer is stripping query parameters — temporarily bypass LiteSpeed cache for the test.