GA4 Ecommerce Dimensions to BigQuery Mapping

You can access detailed information about individual products within BigQuery by mapping GA4 Ecommerce Dimensions to BigQuery fields, including the product ID, name, variant, category, price, and more. 

GA4 ecommerce dimensions to BigQuery mapping allows you to identify top-selling products, analyze product performance across categories, and understand user behaviour related to specific items within BigQuery.

Here’s a breakdown of GA4 Ecommerce dimensions and their corresponding BigQuery fields:

GA4 Ecommerce DimensionsWhat it isBigQuery Field Name (Formula)
CurrencyThe type of currency used in a transaction.MAX(ecommerce.currency) AS currency
Item affiliationIdentifies the affiliate or partner associated with an item sold.MAX(items.affiliation) AS item_affiliation
Item brandIndicates the brand associated with a specific item.MAX(items.item_brand) AS item_brand
Item categoryThe primary category under which an item is classified.MAX(items.category) AS item_category
Item category 2The secondary category for classifying an item.MAX(items.category2) AS item_category2
Item category 3The third level in an item’s hierarchical category structure.MAX(items.category3) AS item_category3
Item category 4Represents the fourth tier in an item’s classification.MAX(items.category4) AS item_category4
Item category 5The fifth and most specific classification tier for an item.MAX(items.category5) AS item_category5
Item couponThe coupon code used for purchasing an item.MAX(items.promotion_id) AS item_coupon
Item IDA unique identifier assigned to an item.MAX(items.item_id) AS item_id
Item list IDA unique identifier given to a list of items.MAX(items.item_list_id) AS item_list_id
Item list nameThe name given to a list of items.MAX(items.item_list_name) AS item_list_name
Item list positionSpecifies the position of an item within a list.MAX(items.item_list_position) AS item_list_position
Item location IDAn identifier for where an item or promotion is located.MAX(items.location_id) AS item_location_id
Item nameThe official name of an item.MAX(items.item_name) AS item_name
Item promotion creative nameThe designated name for a creative aspect of a promotion.MAX(items.promotion_creative_name) AS item_promotion_creative_name
Item promotion creative slotIdentifies the specific placement or slot of a promotional creative.MAX(items.promotion_creative_slot) AS item_promotion_creative_slot
Item promotion IDA unique identifier for a promotional campaign or offer.MAX(items.promotion_id) AS item_promotion_id
Item promotion nameThe name associated with a specific promotion.MAX(items.promotion_name) AS item_promotion_name
Item variantDescribes variations of an item, such as size or color.MAX(items.item_variant) AS item_variant
Local item priceThe price of an item adjusted for local currency.MAX(items.price) AS local_item_price
Order couponA coupon code associated with a specific order.MAX(purchase.coupon) AS order_coupon
Shipping tierThe level of shipping service chosen for delivering an item.MAX(purchase.shipping_tier) AS shipping_tier
Transaction IDAn identifier used to track and manage transactions within ecommerce platforms.MAX(transaction_id) AS transaction_id

Points to Consider:

item_coupon: While ‘MAX(items.promotion_id)’ might capture the ID of a promotion associated with an item, it might not directly represent the coupon code used by the customer. Consider using ‘CASE WHEN’ statements or exploring other fields within ‘ecommerce.promotions’ schema if you specifically need the coupon code.

local_item_price: There might not be a dedicated field for “local item price” within the standard GA4 ecommerce schema. You might need to perform calculations based on ‘price’ and currency conversion rates if you want to analyze price in a specific local currency.

order_coupon: The ‘purchase.coupon’ field likely captures the order-level coupon code, which might differ from an item-specific coupon (‘item_coupon’).

Transaction ID: While ‘MAX(transaction_id)’ retrieves a transaction ID, it might not necessarily be unique across your entire BigQuery dataset. Consider using appropriate filters or concatenating with other identifiers for uniqueness.

Consider using ‘CASE WHEN’ statements within your BigQuery queries to handle scenarios where a single field might not perfectly capture the desired data element.

My best selling books on Digital Analytics and Conversion Optimization

Maths and Stats for Web Analytics and Conversion Optimization
This expert guide will teach you how to leverage the knowledge of maths and statistics in order to accurately interpret data and take actions, which can quickly improve the bottom-line of your online business.

Master the Essentials of Email Marketing Analytics
This book focuses solely on the ‘analytics’ that power your email marketing optimization program and will help you dramatically reduce your cost per acquisition and increase marketing ROI by tracking the performance of the various KPIs and metrics used for email marketing.

Attribution Modelling in Google Analytics and BeyondSECOND EDITION OUT NOW!
Attribution modelling is the process of determining the most effective marketing channels for investment. This book has been written to help you implement attribution modelling. It will teach you how to leverage the knowledge of attribution modelling in order to allocate marketing budget and understand buying behaviour.

Attribution Modelling in Google Ads and Facebook
This book has been written to help you implement attribution modelling in Google Ads (Google AdWords) and Facebook. It will teach you, how to leverage the knowledge of attribution modelling in order to understand the customer purchasing journey and determine the most effective marketing channels for investment.

About the Author

Himanshu Sharma

  • Founder, OptimizeSmart.com
  • Over 15 years of experience in digital analytics and marketing
  • Author of four best-selling books on digital analytics and conversion optimization
  • Nominated for Digital Analytics Association Awards for Excellence
  • Runs one of the most popular blogs in the world on digital analytics
  • Consultant to countless small and big businesses over the decade