Destinations Overview
Google Analytics 4
Forward events to GA4 using the Measurement Protocol.
Forwards events to GA4 using the Measurement Protocol.
Prerequisites
- A GA4 property
- Measurement Protocol API secret (see below)
Getting credentials
- In Google Analytics, go to Admin → Data Streams → your web stream
- Copy the Measurement ID (format:
G-XXXXXXXXXX) - Under Measurement Protocol API secrets, click Create and copy the secret
Connecting in the platform
- Go to Destinations → Add Destination → Google Analytics 4
- Enter Measurement ID and API Secret
- Click Save & Activate
Event mapping
The platform maps event eventName values to GA4 event names automatically:
Event eventName | GA4 event name |
|---|---|
page | page_view |
product_viewed | view_item |
product_added | add_to_cart |
product_removed | remove_from_cart |
checkout_started | begin_checkout |
payment_info_entered | add_payment_info |
order_completed | purchase |
order_refunded | refund |
signed_up | sign_up |
logged_in | login |
lead_submitted | generate_lead |
searched | search |
| (any non-reserved name) | custom event (as-is or overridden via mapping) |
To override a name, use Edit Mapping on the destination card.
Known limitations
- GA4 Measurement Protocol does not populate session-level metrics (session count, engagement rate) in the GA4 UI — those require the gtag.js client-side tag running in the browser.
- GA4 enforces a limit of 25 event parameters per event and a 40-character limit on parameter names.
- Real-time reports in GA4 may show a delay of a few minutes for server-side events.