ioZen Docs

Google Analytics

Set up Google Analytics 4 Measurement Protocol to send server-side analytics events from ioZen.

Send server-side analytics events to Google Analytics 4 (GA4) using the Measurement Protocol. This is not Google Ads conversion import. GA4 MP has no gclid field, so a captured Google click does not reach Google Ads through this path.

For counted Google Ads conversions, use the Google Ads integration. If both are enabled on the same bot, only Google Ads receives the conversion.

Prerequisites

  • A Google Analytics 4 property
  • Admin access to the GA4 property
  • A web data stream configured

Step 1: Get Your Measurement ID

  1. Go to Google Analytics
  2. Navigate to Admin → Data Streams
  3. Click on your web data stream
  4. Copy the Measurement ID (starts with G-, e.g., G-XXXXXXXXXX)

Step 2: Create an API Secret

  1. In the same data stream settings, scroll down to Measurement Protocol API secrets
  2. Click Create
  3. Give it a name (e.g., "ioZen Server Events")
  4. Copy the generated API Secret

Step 3: Configure in ioZen

  1. Open your Intake Bot → Settings → Marketing
  2. Toggle Google Analytics on
  3. Paste your Measurement ID and API Secret
  4. Enable On Submission
  5. Choose generate_lead for a general inquiry or sales case, or sign_up for a completed account or registration
  6. The settings auto-save

Use the exact recommended event name in GA4 reports and key-event configuration. Field-level conversions inherit the same event. Measurement Protocol supplements browser tagging and does not replace it.

Step 4: Test the Connection

Click Test Connection. Google's debug endpoint validates the event structure and returns any validation errors.

A production MP 2xx means the hit was posted, not that Google Ads counted a conversion.

Troubleshooting

ErrorCauseFix
Invalid Measurement IDID format is wrongMust start with G-. Copy from GA4 → Admin → Data Streams.
Invalid API secretSecret is incorrect or expiredCreate a new secret in GA4 → Admin → Data Streams → Measurement Protocol API secrets.
Validation errorsEvent payload has invalid fieldsCheck the error details for which field is invalid. Contact hello@iozen.ai if the issue persists.

On this page