` (E.g. "\_ga\_SE92QCQ4Q1", without quotes and the initial string "G-"). If the cookie is not provided or with App "Data streams", you can pass the session identifier using the property `ga_session_id` : this is useful when implementing the [gtag GET API](https://developers.google.com/tag-platform/gtagjs/reference#get), on the client-side, as you can retrieve the value with the API and then pass it into `ga_session_id` . When none of the above is set, 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](https://support.google.com/analytics/answer/9191807).
## Mappings for GA4 events
This destination provides automatic mapping between our [Events reference](https://community.commandersact.com/platform-x/developers/tracking/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.
{% hint style="info" %}
More details on GA4 standard events are available following this [LINK](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events).\
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](https://support.google.com/analytics/answer/10075209).
{% endhint %}
### 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.
{% hint style="info" %}
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](https://support.google.com/analytics/answer/10085872).\
The following properties are automatically attached to the event.
{% endhint %}
| 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
{% hint style="info" %}
Google Analytics "Measurement Protocol" supports consent signals. More details are available following this [LINK](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#payload_consent).
{% endhint %}
| 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](https://developers.google.com/analytics/devguides/collection/ga4/uid-data?hl=en).
{% hint style="warning" %}
When [Proxy Mode](https://community.commandersact.com/platform-x/features/destinations/destinations-catalog/google/google-analytics-4/google-analytics-4-proxy-mode) is enabled, ensure the `User Id` field is set to `None` as its value must be present.
{% endhint %}
{% hint style="info" %}
Google properties are set starting from the path `user_data`. The property `user_id` is set in the base path.
{% endhint %}
| 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] |
{% hint style="info" %}
> **\*** 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.
> {% endhint %}
## Geographical information
{% hint style="info" %}
The following properties set in `user_location` :
* `city`
* `region_id`
* `country_id`
* `subcontinent_id`
* `continent_id`
and `ip_override` provide geographic information. `user_location` properties take precedence over `ip_override` . When setting `user_location` provide as many properties as possible. Google recommends `country_id` and `region_id` at a base minimum. If you set `ip_override` Google Analytics derives geo information from the provided IP address. If you include at least one property in `user_location` Google Analytics ignores `ip_override` . If you don't include any property in `user_location` or `ip_override`, Google Analytics derives geo information from tagging events using `client_id` .\
Google Analytics applies the property's [granular location data settings](https://support.google.com/analytics/answer/12002752) to the request, regardless of the geographic information sent. More details are available following this [LINK](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag\&hl=en#payload_geo_info).
{% endhint %}
| Commanders Act Properties | Google Properties |
|---|
Client Id Cookie Name | client_id |
context.device.ip | ip_override |
user.current_location_city | city [1] |
user.current_location_region | region_id [1] |
user.current_location_country | country_id [1] |
user.current_location_subcontinent | subcontinent_id [1] |
user.current_location_continent | continent_id [1] |
{% hint style="info" %}
> **1.** Property set starting from the path `user_location` .
> {% endhint %}
## Limitations
Depending on your licence (standard or 360), sending events to GA4 has some different limitations:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.commandersact.com/features/destinations/destinations-catalog/google/google-analytics-4.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.