Google Analytics 4 Measurement Protocol Connector Setup Guide
This article describes how to set up the Google Analytics 4 Measurement Protocol connector.
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 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.
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. |
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. |
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. |
This page was last updated: May 2, 2023