ioZen Docs

Google Ads

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

Send server-side conversion events to Google Analytics 4 (GA4) using the Measurement Protocol. These events can be imported into Google Ads for conversion tracking.

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 AdminData 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 → SettingsMarketing & Attribution
  2. Toggle Google Ads on
  3. Paste your Measurement ID and API Secret
  4. The settings auto-save

Step 4: Test the Connection

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

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.

Best Practices

  • Link GA4 to Google Ads — To use these conversions for Google Ads bidding, link your GA4 property to Google Ads and import the conversions.
  • Use debug mode for testing — ioZen's test connection uses Google's debug endpoint which returns detailed validation messages.

On this page