Google Analytics 4

​

What this is

​

Prerequisites

​

Configure the GA4 property and Data Stream

1. In your Google Analytics 4 account, open Admin and select Create Property. Enter a Property Name, click Next, complete the Business information section as per your business requirement, then click Create. The GA4 property is created.
   
2. Inside the new property, open Data Streams, choose Web, enter the Website URL you want to track and a Stream Name, then click Create Stream.
3. Open the Data Stream. A details panel opens on the right. Copy the Measurement ID — you paste it into Zeotap in a later step.
   
4. In the same panel, scroll down and open Measurement Protocol API secrets. Click Create, then copy the resulting API Secret.
   

​

Create the two required Custom Dimensions

1. In GA4, open Configure → Custom Definitions → Create Custom Dimensions.
2. Create the first Custom Dimension:
   • Dimension Name: Audience Name
   • Scope: Event
   • Description: as per your requirement
   • Event Parameter: audience_name
3. Create the second Custom Dimension:
   • Dimension Name: Zeotap Event Type
   • Scope: Event
   • Description: as per your requirement
   • Event Parameter: zeotap_event_type
   

​

Create the GA4 destination in Zeotap

1. Log into the Zeotap CDP App and open the Destinations application.
2. Click + Create Destination.
   
3. Under All Destinations, search for Google Analytics 4 and open it. The right pane shows the fields the integration needs.
   
4. Enter a Destination Name, paste the Measurement ID and API Secret you copied from GA4, review your entries, then click Next.
   
5. On the mapping screen, under Choose your Action select Send identifiers to Google Analytics 4. Under Map the Fields, map an output identifier to GA Client ID. You can edit, add, or remove identifier rows using the mapping controls — see Destinations — mapping for the full reference.
   
6. Click Create Destination. The destination now appears in the Audiences application, ready to attach to an audience.

​

Link an audience to the destination

​

What Zeotap sends to GA4

{
  "client_id": "1220954604.1657797468",
  "events": [
    {
      "name": "zeotap_event",
      "params": {
        "audience_name": "high_value_customers",
        "zeotap_event_type": "add"
      }
    }
  ]
}

• If the profile is part of the audience in the current refresh, zeotap_event_type is add.
• If the profile was in the audience in an earlier refresh and has dropped out in the current one, zeotap_event_type is remove. This drives the user disqualification flow described below.

​

Verify the integration

1. In GA4, open the property’s Realtime or DebugView report and confirm events named zeotap_event appear from your Data Stream.
2. Open one such event and confirm both parameters audience_name and zeotap_event_type are populated, with audience_name matching the Zeotap audience name you activated.
3. In GA4, open Configure → Custom Definitions and confirm both Custom Dimensions are listed with Event Parameter values audience_name and zeotap_event_type.
4. In GA4, open Configure → Audiences, build the audience described in Build a GA4 audience from the zeotap_event below, and confirm the audience size grows as GA4 processes events. GA4 processing latency depends on your account tier — see Google’s data-processing documentation.

​

Troubleshoot common errors

​

Build a GA4 audience from the zeotap_event

1. In GA4, open Configure → Audiences → New Audience → Create a Custom Audience.
2. Under Include users, click Add new condition and configure:
   • Choose Events → zeotap_event from the drop-down.
   • Click ADD PARAMETER and under Custom, select Audience Name → audience_name and choose the relevant Zeotap audience name from the drop-down.
   • Add a second parameter: Zeotap Event Type → zeotap_event_type and choose add.
3. Under ADD GROUP TO EXCLUDE, click Add new condition to exclude users removed from the audience in a later refresh:
   • Choose Events → zeotap_event.
   • Audience Name → audience_name matches the same Zeotap audience name.
   • Zeotap Event Type → zeotap_event_type equals remove.
4. Click Save.

​

User disqualification from audiences

• When a profile no longer qualifies for a Zeotap audience — because it fails the audience criteria, consent requirements, or another condition set on the audience — Zeotap issues a deletion request in the next refresh cycle for that audience-destination pair.
• The disqualified profile is excluded from the audience based on the audience’s configured refresh frequency.
• Disqualification is programmatic. You do not configure anything to trigger it — Zeotap emits zeotap_event_type: remove for the profile, and the GA4 audience built with the remove exclusion condition drops the profile on the next GA4 audience evaluation.

​

FAQ

​

Next steps

• Explore the Google Universal Analytics integration →
• Explore Google Analytics Hub for BigQuery-based data sharing →
• Explore GA4 configuration inside the Zeotap Collect Tag (GTM) →
• Explore how to link an audience to any destination →
• Explore identifier extension for destinations →