- TLC Home Home
- Discussions & Ideas Discussions & Ideas
- Product Guides Product Guides
- Knowledge Base Knowledge Base
- Developer Docs Developer Docs
- Education Education
- Blog Blog
- Support Desk Support Desk
This article describes how to set up the Google Analytics 4 Measurement Protocol connector.
In this article:
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.
The Google Analytics 4 Measurement Protocol always returns a 2xx
status code if the HTTP request was received. The Protocol does not return an error code if the payload data was not formed correctly, the data in the payload was incorrect, or the payload data was not processed by Google Analytics.
Google lists the following limitations when using the Google Analytics 4 Measurement Protocol:
user_id
in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events.Action Name | AudienceStream | EventStream |
---|---|---|
Send PageView Event (gtag.js) | ✓ | ✓ |
Send Event (gtag.js) | ✓ | ✓ |
Send Firebase Event | ✓ | ✓ |
Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.
After adding the connector, configure the following settings:
Click Done when you are finished configuring the connector.
Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu.
The following section describes how to set up parameters and options for each action.
Parameter | Description |
---|---|
Client ID | (Required) A unique identifier for a client. |
API Secret Override | Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the configuration section. |
Measurement ID Override | The identifier for a Data Stream. This setting overrides Measurement ID used in the configuration section. |
User ID | If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. |
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 | |
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. Could be configured into the section "Templates". |
Item ID | Either Item ID or Item Name is required. |
Item Name | Either Item ID or Item Name is required. |
Affiliation | |
Coupon | |
Currency | |
Discount (number) | |
Index (number) | |
Item Brand | |
Item Category | |
Item Category 2 | |
Item Category 3 | |
Item Category 4 | |
Item Category 5 | |
Item List ID | |
Item List Name | |
Item Variant | |
Location ID | |
Price (number) | |
Quantity (number) | |
Template Variables | Provide template variables as data input for templates (see: Template Variables Guide). Name nested template variables with the dot notation (For example: items.name ).Nested template variables are typically built from data layer list attributes. |
Templates | Provide templates to be referenced in User Properties (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). |
Parameter | Description |
---|---|
Client ID | (Required) |
API Secret Override | Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the configuration section. |
Measurement ID Override | The identifier for a Data Stream. This setting overrides Measurement ID used in the configuration section. |
User ID | If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. |
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. |
Achievement ID | |
Affiliation | |
Character | |
Content Type | |
Coupon | |
Creative Name | |
Creative Slot | |
Currency | |
Custom Event Type | |
Group ID | |
Item ID | |
Item List ID | |
Item List Name | |
Item Name | |
Level (number) | |
Location ID | |
Method | |
Payment Type | |
Promotion ID | |
Promotion Name | |
Score (number) | |
Search Term | |
Shipping (number) | |
Shipping Tier | |
Tax (number) | |
Transaction ID | |
Value (number) | |
Virtual Currency Name | |
User Properties | User properties describe segments of user base, such as language preference or geographic location. Could be configured into the section "Templates". |
Item ID | Either Item ID or Item Name is required. |
Item Name | Either Item ID or Item Name is required. |
Affiliation | |
Coupon | |
Currency | |
Discount (number) | |
Index (number) | |
Item Brand | |
Item Category | |
Item Category 2 | |
Item Category 3 | |
Item Category 4 | |
Item Category 5 | |
Item List ID | |
Item List Name | |
Item Variant | |
Location ID | |
Price (number) | |
Quantity (number) | |
Template Variables | Provide template variables as data input for templates (see: Template Variables Guide). Name nested template variables with the dot notation (For example: items.name ).Nested template variables are typically built from data layer list attributes. |
Templates | Provide templates to be referenced in User Properties (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). |
Parameter | Description |
---|---|
Client ID | (Required) |
API Secret Override | Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the configuration section. |
Measurement ID Override | The identifier for a Data Stream. This setting overrides Measurement ID used in the configuration section. |
User ID | If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. |
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. |
Achievement ID | |
Affiliation | |
Character | |
Content Type | |
Coupon | |
Creative Name | |
Creative Slot | |
Currency | |
Custom Event Type | |
Group ID | |
Item ID | |
Item List ID | |
Item List Name | |
Item Name | |
Level (number) | |
Location ID | |
Method | |
Payment Type | |
Promotion ID | |
Promotion Name | |
Score (number) | |
Search Term | |
Shipping (number) | |
Shipping Tier | |
Tax (number) | |
Transaction ID | |
Value (number) | |
Virtual Currency Name | |
User Properties | User properties describe segments of user base, such as language preference or geographic location. Could be configured into the section "Templates". |
Item ID | Either Item ID or Item Name is required. |
Item Name | Either Item ID or Item Name is required. |
Affiliation | |
Coupon | |
Currency | |
Discount (number) | |
Index (number) | |
Item Brand | |
Item Category | |
Item Category 2 | |
Item Category 3 | |
Item Category 4 | |
Item Category 5 | |
Item List ID | |
Item List Name | |
Item Variant | |
Location ID | |
Price (number) | |
Quantity (number) | |
Template Variables | Provide template variables as data input for templates (see: Template Variables Guide). Name nested template variables with the dot notation (For example: items.name ).Nested template variables are typically built from data layer list attributes. |
Templates | Provide templates to be referenced in User Properties (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). |
Copyright All Rights Reserved © 2008-2022