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 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:

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.