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 :

gtag('config', 'G-XXXXXXXXXX', {
    ...    
    send_page_view: false
    ...
});

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:

• [GA4] Set up Analytics for a website and/or app
• Add a Google Analytics 4 property (to a site that already has Analytics)

Configuration

App related fields are enabled by flagging Enable App Tracking . The properties context.app.name and context.device.type are required for app tracking. More details on these fields are available by following this LINK.

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
Web API Secret	Required for Web Data Streams An API Secret that is generated through the Google Analytics UI for a "Web Data Stream". To create this value, navigate in the Google Analytics interface following: Admin ➜ Data Streams ➜ Choose your stream ➜ Measurement Protocol API secret ➜ Create .
Measurement Id	Required for Web Data Streams The Measurement Id for a "Web Data Stream". Found in the Google Analytics interface following: Admin ➜ Data Streams ➜ Choose your stream ➜ Measurement Id . E.g. "G-XXXXXXXXXX".
Android API Secret	Required for App Android Data Streams An API Secret that is generated through the Google Analytics UI for an "App Android Data Stream". To create this value, navigate in the Google Analytics interface following: Admin ➜ Data Streams ➜ Choose your stream ➜ Measurement Protocol API secrets ➜ Create . [1]
Android Firebase App ID	Required for App Android Data Streams The Android Firebase App ID for a "App Android Data Stream". Found in the Google Analytics interface following: Admin ➜ Data Streams ➜ Choose your stream ➜ FIREBASE APP ID , or in Firebase console following: Project Settings ➜ General ➜ Your Apps ➜ App ID . [1]
iOS API Secret	Required for App iOS Data Streams An API Secret that is generated through the Google Analytics UI for an "App Android Data Stream". To create this value, navigate in the Google Analytics interface following: Admin ➜ Data Streams ➜ Choose your stream ➜ Measurement Protocol API secrets ➜ Create . [1]
iOS Firebase App ID	Required for App iOS Data Streams The iOS Firebase App ID for an "App iOS Data Stream". Found in the Google Analytics interface following: Admin ➜ Data Streams ➜ Choose your stream ➜ FIREBASE APP ID, or in Firebase console following: Project Settings ➜ General ➜ Your Apps ➜ App ID . [1]
App Instance ID Field	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: device.sdk_id or user.tcId , in this order. [1]
Send All Properties	When activating this option all your custom properties are also sent to GA4 in the params object. Properties with child/sub properties are converted into a single one using the underscore character "_" as separator (E.g. device_lifecycle_last_session_start). More details are available following this LINK.
Custom Event Properties	Map your custom event properties by setting their field names in GA4 property name and adding the field name holding the value in Your event property . E.g. if you inputsizein the GA4 property name anditems.0.product.size in Your event property , you will have a custom event property in GA4 called size with a value based on the content of the field items.0.product.size . In the column Your event property path you should keep the default value Default (root) as it better fits most scenarios. In case you select either In "items" {items.X} or In "product" {items.X.product} this destination will look for the input event property starting from the items or product level respectively and add its values as a custom item property. To ensure that custom event properties are picked up by GA4, you must create event-scoped dimensions first. You can find more details by following this link: [GA4] Custom dimensions and metrics.
Custom User Properties	Map your custom user properties by setting their field names in GA4 property name and adding the field name holding the value in Your event property . E.g. if you input customer_zipcode in GA4 property name and user.zipcode in Your event property , you will have a custom user property in GA4 called customer_zipcode with a value based on the content of the field user.zipcode . 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.
Enable Enhanced Conversions	Flag this option to enable Enhanced Conversions. See our dedicated section following this LINK.
Enable Proxy Mode	Flag this option to anonymize data before sending it to Google. See our dedicated page following this LINK.
Client Id Cookie Name	Cookie name holding the Google Analytics Client Id that uniquely identifies a user instance of a web client. You can change its default value _ga . If this cookie is not found, user.consistent_anonymous_id is used. 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".
Engagement Time in Milliseconds	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.
Enable debug mode	Following Advanced settings → Debug, you can flag this option to enable GA4 Debug Mode monitoring feature, sending the field debug_mode set to true on each event.
Send events for validation only	Following Advanced settings → Debug, you can flag this option to send your events to the Measurement Protocol Validation Server and inspect properties through our Event Inspector. Important: when this is flagged, events ARE NOT tracked by GA4.

[1] Field available after flagging the Enable App Tracking checkbox.

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	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Coupon	Type: String Coupon code applied.	coupon	coupon
Payment Method	Type: String The payment method.	payment_type	payment_method
Revenue	Type: Number The revenue of the event.	revenue	revenue
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

add_shipping_info

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Coupon	Type: String Coupon code applied.	coupon	coupon
Shipping Tier	Type: String The shipping tier (E.g. Next-day) selected for delivery of the item.	shipping_tier	shipping_tier
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

add_to_cart

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

add_to_wishlist

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

begin_checkout

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Coupon	Type: String Coupon code applied.	coupon	coupon
Revenue	Type: Number The revenue of the event.	revenue	revenue
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

generate_lead

Currency	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Transaction Id	Type: String The transaction identifier.	id	id

login

Property	Description	Field	Mapped with
Method	Type: String The login method.	method	method

page_view

Property	Description	GA4 field	Mapped with
Page Location	Type: String The current page URL.	page_location	url
Page Referrer	Type: String The previous page URL.	page_referrer	referrer
Page Title	Type: String The current page title.	page_title	title
Page Name	Type: String The current page name.	page_name	page_name
Page Type	Type: String The current page type.	page_type	page_type
Page Path	Type: String The current page path.	page_path	path

purchase

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Transaction Id	Required Type: String The transaction identifier.	id	id
Affiliation	Type: String Affiliation information.	affiliation	affiliation
Coupon	Type: String Coupon code applied.	coupon	coupon
Shipping	Type: Number Shipping cost.	shipping	shipping_amount
Tax	Type: Number Tax amount.	tax	tax_amount
Revenue	Type: Number The revenue of the event.	revenue	revenue
Conversion Type	Type: String The conversion type.	conversion_type	type
Conversion Status	Type: String The conversion status.	conversion_status	status
Conversion Url	Type: String The conversion status.	conversion_url	url
Payment Method	Type: String The payment method.	payment_type	payment_method
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

refund

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Transaction Id	Required Type: String The transaction identifier.	id	id
Affiliation	Type: String Affiliation information.	affiliation	affiliation
Coupon	Type: String Coupon code applied.	coupon	coupon
Shipping	Type: Number Shipping cost.	shipping	shipping_amount
Tax	Type: Number Tax amount.	tax	tax_amount
Revenue	Type: Number The revenue of the event.	revenue	revenue
Conversion Type	Type: String The conversion type.	conversion_type	type
Conversion Status	Type: String The conversion status.	conversion_status	status
Conversion Url	Type: String The conversion url.	conversion_url	url
Payment Method	Type: String The payment method.	payment_type	payment_method
Items	Required for partial refunds Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

remove_from_cart

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

search

Property	Description	Field	Mapped with
Search Term	Required Type: String The term that was searched for.	search_term	search_term

select_content

Property	Description	Field	Mapped with
Content Type	Type: String The term that was searched for.	content_type	content_type
Item Id	Type: String An identifier for the item that was selected.	item_id	item_id

select_item

Property	Description	Field	Mapped with
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	item_list_name
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

sign_up

Property	Description	Field	Mapped with
Method	Type: String The method used for sign up.	method	method

view_cart

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

view_item

Property	Description	Field	Mapped with
Currency	Required Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Required Type: Number The value of the event.	value	value
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

view_item_list

Property	Description	Field	Mapped with
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	item_list_name
Items	Required Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Required Type: String The ID of the item.	item_id	items.X.id
Item Name	Required Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	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
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	currency
Value	Type: Number The value of the event.	value	value
Transaction Id	Type: String The transaction identifier.	id	id
Content Type	Type: String The transaction identifier.	content_type	content_type
Conversion Type	Type: String The conversion type.	conversion_type	type
Conversion Status	Type: String The conversion status.	conversion_status	status
Conversion Url	Type: String The conversion url.	conversion_url	url
Coupon	Type: String Coupon code applied.	coupon	coupon
Item Id	Type: String An identifier for the item that was selected.	item_id	item_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	item_list_name
Method	Type: String Method used.	method	method
Page Location	Type: String The current page URL.	page_location	url
Page Referrer	Type: String The previous page URL.	page_referrer	referrer
Page Title	Type: String The current page title.	page_title	title
Page Name	Type: String The current page name.	page_name	page_name
Page Type	Type: String The current page type.	page_type	page_type
Page Path	Type: String The current page type.	page_path	path
Payment Method	Type: String The payment method.	payment_type	payment_method
Revenue	Type: Number The revenue of the event.	revenue	revenue
Search Term	Type: String The term that was searched for.	search_term	search_term
Shipping Tier	Type: String The shipping tier (E.g. Next-day) selected for delivery of the item.	shipping_tier	shipping_tier
Shipping	Type: Number Shipping cost.	shipping	shipping_amount
Tax	Type: Number Tax amount.	tax	tax_amount
Items	Type: Array The list of products of the event.	items	items

Items

Property	Description	Field	Mapped with
Item Id	Type: String The ID of the item.	item_id	items.X.id
Item Name	Type: String The name of the item.	item_name	items.X.product.name
Affiliation	Type: String A product affiliation to designate a supplying company or brick and mortar store location.	affiliation	items.X.product.affiliation
Coupon	Type: String The coupon name/code associated with the item.	coupon	items.X.coupon
Currency	Type: String Currency, in 3-letter ISO 4217 format.	currency	items.X.product.currency
Discount	Type: Number The monetary discount value associated with the item.	discount	items.X.discount
Index	Type: Number The index/position of the item in a list.	index	items.X.list_position
Item Brand	Type: String The brand of the item.	item_brand	items.X.product.brand
Item Category	Type: String The category of the item.	item_category	items.X.product.category_1
Item Category 2	Type: String The second category hierarchy or additional taxonomy for the item.	item_category2	items.X.product.category_2
Item Category 3	Type: String The third category hierarchy or additional taxonomy for the item.	item_category3	items.X.product.category_3
Item Category 4	Type: String The fourth category hierarchy or additional taxonomy for the item.	item_category4	items.X.product.category_4
Item Category 5	Type: String The fifth category hierarchy or additional taxonomy for the item.	item_category5	items.X.product.category_5
Item List Id	Type: String The ID of the list in which the item was presented to the user.	item_list_id	items.X.product.list_id
Item List Name	Type: String The name of the list in which the item was presented to the user.	item_list_name	items.X.product.list_name
Item Variant	Type: String The item variant or unique code or description for additional item details/options.	item_variant	items.X.variant
Location Id	Type: String The location associated with the item.	location_id	items.X.product.location_id
Price	Type: Number The monetary price of the item, in units of the specified currency parameter.	price	items.X.product.price
Quantity	Type: Number Item quantity.	quantity	items.X.quantity

Event mapping

Commanders Act Events	GA4 Events
add_payment_info	add_payment_info
add_shipping_info	add_shipping_info
add_to_cart	add_to_cart
add_to_wishlist	add_to_wishlist
begin_checkout	begin_checkout
generate_lead	generate_lead
login	login
page_view	page_view
purchase	purchase
refund	refund
remove_from_cart	remove_from_cart
search	search
select_content	select_content
select_item	select_item
sign_up	sign_up
view_cart	view_cart
view_item	view_item
view_item_list	view_item_list
[Custom Event]	[Custom Event]

Consent signals

Google Analytics "Measurement Protocol" supports consent signals. More details are available following this LINK.

Commanders Act properties	GA4 properties
user.google_consent_mode.ad_user_data	consent.ad_user_data
user.google_consent_mode.ad_personalization	consent.ad_personalization

Enhanced conversions

When enabling this feature, you can send user-related data together with the user identifier. This can be used to improve behavior and conversion measurement. More details are available following this LINK.

When Proxy Mode is enabled, ensure the User Id field is set to None as its value must be present.

Google properties are set starting from the path user_data. The property user_id is set in the base path.

Commanders Act Properties	Google Properties
user.id	user_id [*]
user.email_sha256	sha256_email_address [1]
user.phone	sha256_phone_number [1]
user.firstname	sha256_first_name [1][2]
user.lastname	sha256_last_name [1][2]
user.street	sha256_street [1][2]
user.city	city [2][3]
user.state	region [2][3]
user.zipcode	postal_code [2][3]
user.country	country [2]

[*] Mandatory property. [1] Automatically normalized and hashed, if provided in clear text. [2] Property set starting from the path user_data.address . [3] Automatically normalized.

Limitations

Depending on your licence (standard or 360), sending events to GA4 has some different limitations: https://support.google.com/analytics/answer/11202874?sjid=10370297212042052180-EU