Google Analytics 4 Measurement Protocol Connector Setup Guide
This article describes how to set up the Google Analytics 4 Measurement Protocol connector.
Connector Actions
| Action Name | AudienceStream | EventStream |
|---|---|---|
| Send PageView Event (gtag.js) | ✓ | ✓ |
| Send Event (gtag.js) | ✓ | ✓ |
| Send Firebase Event | ✓ | ✓ |
The Google Analytics 4 Measurement Protocol supplies the following endpoint for validating events: https://google-analytics.com/debug/mp/collect?. The Tealium Google Analytics 4 Measurement Protocol connector uses this endpoint during Trace, giving you insights into the validation of the event data. You can view Google Analytics 4 Measurement Protocol validation messages in the HTTP Response Content of the API call within Trace.
Configure Settings
Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.
After adding the connector, configure the following settings:
- API Secret (Required)
An API Secret generated in the Google Analytics UI. To create a new secret, navigate to: Admin > Data Streams > choose your stream > Measurement Protocol > Create. - Measurement ID (Optional)
The measurement ID associated with a stream. Found in the Google Analytics UI under: Admin > Data Streams > choose your stream > Measurement ID. - Firebase App ID (Optional)
The Firebase App ID. The identifier for a Firebase app. Found in the Firebase console under: Project Settings > General > Your Apps > App ID.
Action Settings - parameters and options
Enter a name for the action and select the action type from the drop-down menu.
The following section describes how to set up parameters and options for each action.
Mapping client ID
Client ID is a required parameter for web-based events that uniquely identifies a user instance of a web client.
Google Analytics stores the client ID in a cookie named _ga. The format of this cookie is GA1.2.12349876.1500644855 where the client ID is 12349876.150064485. You should get the clientId value directly from the Google Analytics tracker.
For more information, see:
- Google Analytics > Getting the Client ID from the cookie.
- Google Analytics Measurement Protocol > Parameter Reference > Client ID.
Action - Send PageView Event (gtag.js)
Parameters
| Parameter | Description |
|---|---|
| Client ID | Required. A unique identifier for a client. |
| Measurement ID Override | Required. The identifier for a Data Stream. This setting overrides Measurement ID used in the Configuration section. |
| API Secret Override | Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the Configuration section. |
| User ID | A unique identifier for a user. |
| Timestamp Micros | A Unix timestamp (in microseconds) for the time to associate with the event. |
| Non Personalized Ads | Set to true to indicate these events should not be used for personalized ads. |
| Page Title | The title of the page. |
| Page Location | Required. The full URL to the page. |
| User Properties | User properties describe segments of user base, such as language preference or geographic location. |
| Item ID | The ID of the item. |
| Item Name | The name of the item. |
| Affiliation | A product affiliation to designate a supplying company or brick and mortar store location. |
| Coupon | The coupon name/code associated with the item. |
| Currency | The currency, in 3-letter ISO 4217 format. |
| Discount | The monetary discount value associated with the item. |
| Index | The index/position of the item in a list. |
| Item Brand | The brand of the item. |
| Item Category | The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category. |
| Item Category 2 | The second category hierarchy or additional taxonomy for the item. |
| Item Category 3 | The third category hierarchy or additional taxonomy for the item. |
| Item Category 4 | The fourth category hierarchy or additional taxonomy for the item. |
| Item Category 5 | The fifth category hierarchy or additional taxonomy for the item. |
| Item List ID | The ID of the list in which the item was presented to the user. |
| Item List Name | The name of the list in which the item was presented to the user. |
| Item Variant | The item variant or unique code or description for additional item details/options. |
| Location ID | The location associated with the item. It’s recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used. |
| Price | The monetary price of the item, in units of the specified currency parameter. |
| Quantity | Item quantity. |
| Debug | This connector uses the GA4 debug endpoint by default when using Trace. Map a boolean value to override this behavior. |
Action - Send Event (gtag.js)
Parameters
| Parameter | Description |
|---|---|
| Client ID | Required. A unique identifier for a client. |
| Measurement ID Override | Required. The identifier for a Data Stream. This setting overrides Measurement ID used in the Configuration section. |
| API Secret Override | Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the Configuration section. |
| User ID | A unique identifier for a user. |
| Timestamp Micros | A Unix timestamp (in microseconds) for the time to associate with the event. |
| Non Personalized Ads | Set to true to indicate these events should not be used for personalized ads. |
| Event Type | Select Event Type. For more information and a list of available events, see Events. |
| User Properties | User properties describe segments of user base, such as language preference or geographic location. |
| Item ID | The ID of the item. |
| Item Name | The name of the item. |
| Affiliation | A product affiliation to designate a supplying company or brick and mortar store location. |
| Coupon | The coupon name/code associated with the item. |
| Currency | The currency, in 3-letter ISO 4217 format. |
| Discount | The monetary discount value associated with the item. |
| Index | The index/position of the item in a list. |
| Item Brand | The brand of the item. |
| Item Category | The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category. |
| Item Category 2 | The second category hierarchy or additional taxonomy for the item. |
| Item Category 3 | The third category hierarchy or additional taxonomy for the item. |
| Item Category 4 | The fourth category hierarchy or additional taxonomy for the item. |
| Item Category 5 | The fifth category hierarchy or additional taxonomy for the item. |
| Item List ID | The ID of the list in which the item was presented to the user. |
| Item List Name | The name of the list in which the item was presented to the user. |
| Item Variant | The item variant or unique code or description for additional item details/options. |
| Location ID | The location associated with the item. It’s recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used. |
| Price | The monetary price of the item, in units of the specified currency parameter. |
| Quantity | Item quantity. |
| Debug | This connector uses the GA4 debug endpoint by default when using Trace. Map a boolean value to override this behavior. |
Action - Send Firebase Event
Parameters
| Parameter | Description |
|---|---|
| App Instance ID | Required. |
| Firebase App ID Override | Required. The identifier for a Firebase app. This setting overrides Firebase App ID used in the Configuration section. |
| User ID | A unique identifier for a user. |
| Timestamp Micros | A Unix timestamp (in microseconds) for the time to associate with the event. |
| Non Personalized Ads | Set to true to indicate these events should not be used for personalized ads. |
| Event Type | Select Event Type. For more information and a list of available events, see Events. |
| User Properties | User properties describe segments of user base, such as language preference or geographic location. |
| Item ID | The ID of the item. |
| Item Name | The name of the item. |
| Affiliation | A product affiliation to designate a supplying company or brick and mortar store location. |
| Coupon | The coupon name/code associated with the item. |
| Currency | The currency, in 3-letter ISO 4217 format. |
| Discount | The monetary discount value associated with the item. |
| Index | The index/position of the item in a list. |
| Item Brand | The brand of the item. |
| Item Category | The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category. |
| Item Category 2 | The second category hierarchy or additional taxonomy for the item. |
| Item Category 3 | The third category hierarchy or additional taxonomy for the item. |
| Item Category 4 | The fourth category hierarchy or additional taxonomy for the item. |
| Item Category 5 | The fifth category hierarchy or additional taxonomy for the item. |
| Item List ID | The ID of the list in which the item was presented to the user. |
| Item List Name | The name of the list in which the item was presented to the user. |
| Item Variant | The item variant or unique code or description for additional item details/options. |
| Location ID | The location associated with the item. It’s recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used. |
| Price | The monetary price of the item, in units of the specified currency parameter. |
| Quantity | Item quantity. |
| Debug | This connector uses the GA4 debug endpoint by default when using Trace. Map a boolean value to override this behavior. |
This page was last updated: September 7, 2023