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
- Go to Google Analytics
- Navigate to Admin → Data Streams
- Click on your web data stream
- Copy the Measurement ID (starts with
G-, e.g.,G-XXXXXXXXXX)
Step 2: Create an API Secret
- In the same data stream settings, scroll down to Measurement Protocol API secrets
- Click Create
- Give it a name (e.g., "ioZen Server Events")
- Copy the generated API Secret
Step 3: Configure in ioZen
- Open your Intake Bot → Settings → Marketing
- Toggle Google Analytics on
- Paste your Measurement ID and API Secret
- Enable On Submission
- Choose
generate_leadfor a general inquiry or sales case, orsign_upfor a completed account or registration - 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
| Error | Cause | Fix |
|---|---|---|
| Invalid Measurement ID | ID format is wrong | Must start with G-. Copy from GA4 → Admin → Data Streams. |
| Invalid API secret | Secret is incorrect or expired | Create a new secret in GA4 → Admin → Data Streams → Measurement Protocol API secrets. |
| Validation errors | Event payload has invalid fields | Check the error details for which field is invalid. Contact hello@iozen.ai if the issue persists. |