Google Analytics 4
Google Analytics 4 (GA4) is the latest iteration of Google's analytics tool that helps you measure the traffic and engagement across your websites and apps. Using this destination, you can enhance your existing tracking implementation to match your data collection needs with GA4. Your data will be sent server-side taking advantage of the Google Measurement Protocol API and in form of events.
Google designed the Measurement Protocol with some limitations, especially it does not allow to manage session.
For session handling, you should currently setup a gtag config tag that will fire on the first page (only) of the user's session.
For this purpose you can use on your website the tag template "gtag - Config with options" as it comes with the additional configuration option to send the Google reserved event session_start
while avoid firing the event page_view
:
Key features
The Google Analytics 4 destination provides the following key features:
Events structure: our Events reference model fits Google's one, meaning that your data is properly bridged to the expected fields in an optimized way.
Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.
Refined data: you can freely push additional information based on your specific needs (E.g. adding custom events, custom event and user properties).
Support for multi-item data: information included in the item array is dispatched to GA4.
Send all properties option: send all your event properties to GA4 with a single click.
Destination setup
Before you get started with this destination, make sure you have a GA4 property in your Google Analytics account. You can find more information on this topic following these detailed articles:
Configuration
App related fields are enabled by flagging Enable App Tracking
.
The user identifier should be passed in both the client-side gtag and server-side. For more information, you can follow these links: [GA4] Measure activity across platforms with User-ID and [GA4] Reporting: deduplicate user counts.
When Google Signals is enabled, same device remarketing is supported. For cross-device remarketing, the user identifier is additionally required.
Settings | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
| Your property field holding the App Instance Id for your "App Data Streams". If this is not provided, the first 32 characters of the following SHA256 hashed standard properties are used: |
| When activating this option all your custom properties are also sent to GA4 in the |
| Map your custom event properties by setting their field names in |
| Map your custom user properties by setting their field names in To ensure that custom user properties are picked up by GA4, you must create user-scoped dimensions first. You can find more details by following this link: [GA4] Custom dimensions and metrics. |
| Flag this option to enable Enhanced Conversions. See our dedicated section following this LINK. |
| Flag this option to anonymize data before sending it to Google. See our dedicated page following this LINK. |
| Cookie name holding the Google Analytics Client Id that uniquely identifies a user instance of a web client. You can change its default value The "Client Id" is the right most string in the cookie, including a single dot. E.g. see the following blue highlighted string "GA1.1.XXXXXXXXXX.XXXXXXXXXX". |
| GA4 reports only show active users who engage with your site for a non-zero amount of time. To ensure users are included in reports, you can keep the default value to 1. If you track the actual engagement time with your events, you can set the Engagement Time in Milliseconds with a proper value. |
| Following |
| Following |
[1] Field available after flagging the Enable App Tracking
checkbox.
[2] Using "dots" (".") you can navigate deeper to the specific field you want to get the value of. See Events reference for more details on the standard field names by event. You can also freely set custom fields: there are no boundaries.
Session handling
When providing a Measurement Id
, the session identifier is retrieved from the cookie named _ga_<Measurement Id>
(E.g. "_ga_SE92QCQ4Q1", without quotes and the initial string "G-"). If the cookie is not provided or with App "Data streams", the default property context.device.lifecycle.session_id
is used. More details on how sessions work in Google Analytics 4 are available following this LINK.
Mappings for GA4 events
This destination provides automatic mapping between our Events reference model and GA4 events. In this section, you will learn what properties are set so you can expect to see those details in GA4 reporting.
More details on GA4 standard events are available following this LINK. To ensure that custom event properties are picked up by GA4, you must create event-scoped dimensions. You can find more details by following this link: [GA4] Custom dimensions and metrics.
add_payment_info
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Coupon | Type: | coupon | coupon |
Payment Method | Type: | payment_type | payment_method |
Revenue | Type: | revenue | revenue |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
add_shipping_info
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Coupon | Type: | coupon | coupon |
Shipping Tier | Type: | shipping_tier | shipping_tier |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
Type: | item_id | items.X.id |
Item Name |
Type: | item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
add_to_cart
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
add_to_wishlist
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
begin_checkout
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Coupon | Type: | coupon | coupon |
Revenue | Type: | revenue | revenue |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
generate_lead
Currency | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Transaction Id | Type: | id | id |
login
Property | Description | Field | Mapped with |
---|---|---|---|
Method | Type: | method | method |
page_view
Property | Description | GA4 field | Mapped with |
---|---|---|---|
Page Location | Type: The current page URL. | page_location | url |
Page Referrer | Type: | page_referrer | referrer |
Page Title | Type: | page_title | title |
Page Name | Type: | page_name | page_name |
Page Type | Type: | page_type | page_type |
Page Path | Type: | page_path | path |
purchase
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Transaction Id |
| id | id |
Affiliation | Type: | affiliation | affiliation |
Coupon | Type: | coupon | coupon |
Shipping | Type: | shipping | shipping_amount |
Tax | Type: | tax | tax_amount |
Revenue | Type: | revenue | revenue |
Conversion Type | Type: | conversion_type | type |
Conversion Status | Type: | conversion_status | status |
Conversion Url | Type: | conversion_url | url |
Payment Method | Type: | payment_type | payment_method |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
refund
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Transaction Id |
| id | id |
Affiliation | Type: | affiliation | affiliation |
Coupon | Type: | coupon | coupon |
Shipping | Type: | shipping | shipping_amount |
Tax | Type: | tax | tax_amount |
Revenue | Type: | revenue | revenue |
Conversion Type | Type: | conversion_type | type |
Conversion Status | Type: | conversion_status | status |
Conversion Url | Type: | conversion_url | url |
Payment Method | Type: | payment_type | payment_method |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
remove_from_cart
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
search
Property | Description | Field | Mapped with |
---|---|---|---|
Search Term |
| search_term | search_term |
select_content
Property | Description | Field | Mapped with |
---|---|---|---|
Content Type |
Type: | content_type | content_type |
Item Id | Type: | item_id | item_id |
select_item
Property | Description | Field | Mapped with |
---|---|---|---|
Item List Name | Type: | item_list_name | item_list_name |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
sign_up
Property | Description | Field | Mapped with |
---|---|---|---|
Method | Type: | method | method |
view_cart
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
view_item
Property | Description | Field | Mapped with |
---|---|---|---|
Currency |
| currency | currency |
Value |
| value | value |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
Type: | item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
view_item_list
Property | Description | Field | Mapped with |
---|---|---|---|
Item List Name | Type: | item_list_name | item_list_name |
Items |
| items | items |
Items
Property | Description | Field | Mapped with |
---|---|---|---|
Item Id |
| item_id | items.X.id |
Item Name |
| item_name | items.X.product.name |
Affiliation | Type: | affiliation | items.X.product.affiliation |
Coupon | Type: | coupon | items.X.coupon |
Currency | Type: | currency | items.X.product.currency |
Discount | Type: | discount | items.X.discount |
Index | Type: | index | items.X.list_position |
Item Brand | Type: | item_brand | items.X.product.brand |
Item Category | Type: | item_category | items.X.product.category_1 |
Item Category 2 | Type: | item_category2 | items.X.product.category_2 |
Item Category 3 | Type: | item_category3 | items.X.product.category_3 |
Item Category 4 | Type: | item_category4 | items.X.product.category_4 |
Item Category 5 | Type: | item_category5 | items.X.product.category_5 |
Item List Id | Type: | item_list_id | items.X.product.list_id |
Item List Name | Type: | item_list_name | items.X.product.list_name |
Item Variant | Type: | item_variant | items.X.variant |
Location Id | Type: | location_id | items.X.product.location_id |
Price | Type: | price | items.X.product.price |
Quantity | Type: | quantity | items.X.quantity |
[Custom Event]
You can send custom events to better fit your specific needs.
More details on how you can create and manage custom events are available following this link: [GA4] Modify and create events via the user interface. The following properties are automatically attached to the event.
Property | Description | Field | Mapped with |
---|---|---|---|