| GA4 Event Property | Supported | Type | Corresponding Fueled Property | BigCommerce Object/Property | Description |
|---|---|---|---|---|---|
currency | ❌ | String | N/A | N/A | Currency of the items associated with the event, in 3-letter ISO 4217 format. If set, item-level currency is ignored. If not set, currency from the first item in items is used. If you set value then currency is required for revenue metrics to be computed accurately. |
value | ❌ | Number | N/A | N/A | |
items | ✅ | Array | products | An array of product objects, exposed through the BigCommerce Storefront API. | An array of item objects, each with the properties described below. |
items.$.item_id | ✅ | String | products.$.id | product.id | The ID of the item. |
items.$.item_name | ✅ | String | products.$.name | product.title | The name of the item. |
items.$.affiliation | ❌ | String | N/A | N/A | BigCommerce doesn’t support affiliation at the individual product level. |
items.$.coupon | ❌ | String | products.$.coupon | N/A | The coupon name/code associated with the item. Event-level and item-level coupon parameters are independent. |
items.$.currency | ❌ | String | products.$.currency | N/A | The currency, in 3-letter ISO 4217 format. If set, event-level currency is ignored. Multiple currencies per event is not supported. Each item should set the same currency. |
items.$.discount | ❌ | Number | products.$.discount | N/A | The monetary discount value associated with the item. This discount value, has not been deducted from the item’s price property. |
items.$.index | ✅ | Number | products.$.position | The position of an item/product in a storefront collection, carousel, or cart is calculated. | The index/position of the item in a list. (If applicable.) |
items.$.item_brand | ✅ | String | products.$.brand | product.vendor | The brand of the item. |
items.$.item_category | ❌ | String | products.$.categories (An array) | product.collections | The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category. |
items.$.item_list_id | ❌ | String | N/A | N/A | The ID of the list in which the item was presented to the user. If set, event-level item_list_id is ignored. If not set, event-level item_list_id is used, if present. |
items.$.item_list_name | ❌ | String | N/A | N/A | The name of the list in which the item was presented to the user. If set, event-level item_list_name is ignored. If not set, event-level item_list_name is used, if present. |
items.$.item_variant | ✅ | String | products.$.variant | product.selected_or_first_available_variant.id | The item variant or unique code or description for additional item details/options. |
items.$.location_id | ❌ | String | N/A | N/A | The location associated with the item. It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used. If set, event-level location_id is ignored. If not set, event-level location_id is used, if present. |
items.$.price | ✅ | Number | products.$.price | product.price / 100 | The monetary price of the item, in units of the specified currency parameter. Note: This price does not include line-item discounts, taxes, or shipping. It is the sales price of the item at the time of purchase. |