| GA4 Event Property | Supported | Type | Corresponding Fueled Property | BigCommerce Object/Property | Description |
|---|---|---|---|---|---|
currency | ✅ | String | currency is not included in Fueled’s top-level Cart Viewed event schema. It is calculated from the currency values passed as part of the items array. | currency is not available within the BigCommerce Storefront API product object. Therefore, it is calculated when needed. | 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 | value is not included in Fueled’s top-level Cart Viewed event schema. It is calculated from the individual products in Fueled’s product array (which is the equivalent of GA4’s items array). | Calculated, based upon the subtotal of the items being added to the cart (ie, price minus discounts, not including shipping or taxes). | The monetary value of the event. Value is typically required for meaningful reporting.
Note: By default, Google Analytics recommends that the value of conversion events is equal to the subtotal value of a cart, checkout, purchase, and so forth, where subtotal includes discounts, but not shipping or taxes.
Fueled supports setting the value of carts, checkouts, and orders to total_price, which includes shipping and taxes. |
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 | cartItemsJson[i].id (Note: rather than pull from a BigCommerce theme variable. On the cart page, we pull this value from the Cart JSON object.) | The ID of the item. |
items.$.item_name | ✅ | String | products.$.name | cartItemsJson[i].title (Note: rather than pull from a BigCommerce theme variable. On the cart page, we pull this value from the Cart JSON object.) | 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 | cartItemsJson[i].vendor (Note: rather than pull from a BigCommerce theme variable. On the cart page, we pull this value from the Cart JSON object.) | The brand of the item. |
items.$.item_category | ❌ | String | products.$.categories (An array) | N/A | 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 | cartItemsJson[i].variant_id.toString() (Note: rather than pull from a BigCommerce theme variable. On the cart page, we pull this value from the Cart JSON object.) | 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 | cartItemsJson[i].final_price / 100 (Note: rather than pull from a BigCommerce theme variable. On the cart page, we pull this value from the Cart JSON object.) | 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. |
items.$.quantity | ✅ | Number | products.$.quantity | cartItemsJson[i].quantity (Note: rather than pull from a BigCommerce theme variable. On the cart page, we pull this value from the Cart JSON object.) | Item quantity added to a cart, an order, etc. |