GA4 User-Scoped Traffic Dimensions to BigQuery Mapping

Here’s a breakdown of GA4 User-Scoped Traffic Dimensions and their corresponding BigQuery fields:

GA4 User-Scoped Traffic DimensionsWhat it isBigQuery Field Name (Formula)
First user campaignThe initial campaign that led to the acquisition of a user.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_campaign') AS first_user_campaign
First user campaign IDThe ID associated with the campaign that first acquired the user.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_campaign_id') AS first_user_campaign_id
First user default channel groupThe default channel group responsible for acquiring the user initially.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_default_channel_group') AS first_user_default_channel_group
First user manual ad contentThe ad content associated with the user’s first acquisition.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_ad_content') AS first_user_manual_ad_content
First user manual campaign IDThe ID of the campaign used for the user’s initial acquisition.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_campaign_id') AS first_user_manual_campaign_id
First user manual campaign nameThe campaign used for acquiring the user initially.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_campaign_name') AS first_user_manual_campaign_name
First user manual mediumThe medium associated with the start of the user’s first session.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_medium') AS first_user_manual_medium
First user manual sourceThe source associated with the start of the user’s first session.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_source') AS first_user_manual_source
First user manual source / mediumThe source and medium associated with the start of the user’s first session.CONCAT((SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_source'), ' / ', (SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_medium')) AS first_user_manual_source_medium
First user manual source platformThe platform used to first acquire the user.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_source_platform') AS first_user_manual_source_platform
First user manual termThe term associated with the user’s first acquisition, typically from a search or marketing campaign.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_manual_term') AS first_user_manual_term
First user mediumThe medium by which the user was first acquired.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_medium') AS first_user_medium
First user sourceThe source by which the user was first acquired.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_source') AS first_user_source
First user source / mediumThe source and medium that initially acquired the user.CONCAT((SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_source'), ' / ', (SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_medium')) AS first_user_source_medium
First user source platformThe platform responsible for initially acquiring the user.(SELECT value.string_value FROM UNNEST(user_properties) WHERE key = 'first_user_source_platform') AS first_user_source_platform

This approach ensures that each dimension is correctly extracted from the user_properties array, assuming these properties are being tracked and named as specified in your GA4 configuration.

Adjust the dataset and table references based on your specific setup.

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