Google Analytics 4 (Measurement Protocol)
Introduction
The Google Analytics 4 (GA4) Measurement Protocol is a set of rules that lets you send event data directly to GA4 from a server or backend system, rather than from a browser or app. It’s useful for tracking events that happen outside of a user’s device—like purchases from a third-party payment system or offline interactions. It complements client-side tracking and helps bridge gaps in your analytics data.
Getting started
You will need the relevant API Secret and Measurement ID of your Google Analytics property to connect this destination.
Obtain the API secret
An API SECRET generated in the Google Analytics UI. To create a new secret, navigate to: Admin > Data Streams > choose your stream > Measurement Protocol API Secrets > Create
Obtain the Measurement ID
The GA4 Measurement ID associated with a stream.
- For Web: Locate this in the Google Analytics UI under Admin > Data Streams > choose your stream > Measurement ID
- For Apps: Locate the the Firebase App ID, found in the Firebase console under Project Settings > General > Your Apps > App ID
Connecting to the Google Analytics 4 (Measurement Protocol) CDP destination
- Log into the Chord data platform.
- Navigate to the CDP.
- Click the "Add" button next to Destinations.
- Select Google Analytics 4 (Measurement Protocol) from the destination catalog.
- Enter in the destination name, API Secret, and the Measurement ID.
- Click "Create" to connect.
Chord events relevant for destination
Not all Chord Tracking events are used downstream in your configured destinations. The most relevant and important events in the Chord tracking plan are mapped within the CDP destination, relayed and then ingested in the destination. The Chord tracking plan events used by the Google Analytics 4 (Measurement Protocol) destination are:
Chord Tracking Event | Destination Event |
|---|---|
Cart Viewed | view_cart |
Checkout Started | begin_checkout |
Custom Events | snake_case name (direct) |
Generate Lead | generate_lead |
Order Completed | purchase |
Order Refunded | refund |
Page | page_view |
Payment Info Entered | add_payment_info |
Product Added | add_to_cart |
Product Added to Wishlist | add_to_wishlist |
Product Clicked | select_item |
Product List Viewed | view_item_list |
Product Removed | remove_from_Cart |
Product Viewed | view_item |
Products Searched | search |
Promotion Clicked | select_promotion |
Promotion Viewed | view_promotion |
Signed In | login |
Signed Up | sign_up |
Before connecting destinations in the Chord CDP, please verify with all Destination owners that all non-Chord CDP configured destinations are disabled. Running external destinations alongside configured Chord CDP destinations can result in duplicate events downstream.