GA4 Event Property | Supported | Type | Corresponding Fueled Property | Shopify Object/Property | Description |
---|---|---|---|---|---|
currency | ✅ | String | 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 | 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. | ||
coupon | ❌ | String | The coupon name/code associated with the event. Event-level and item-level coupon parameters are independent. | ||
items | ✅ | Array | products | An array of product objects, exposed through the Shopify Admin 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 | Shopify 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.$.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. |