GA4 Event Property | Supported | Type | Corresponding Fueled Property | BigCommerce Object/Property | Description |
---|---|---|---|---|---|
item_list_id | ❌ | String | N/A | N/A | The ID of the list or category page in which an item is presented to the user. |
item_list_name | ❌ | String | N/A | N/A | The name of the list or category page in which an item is presented to the user. |
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.\n\nIf set, event-level location_id is ignored.\nIf 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. |