Universal Analytics to Google Analytics 4 dimensions and metrics equivalence

This document contains a mapping of Universal Analytics API dimensions and metrics to equivalent Google Analytics 4 dimensions and metrics. Only the Universal Analytics fields mentioned in this chart currently have an equivalent in Google Analytics 4.

User

Metrics

Field name UA Name GA4 equivalent name
Users ga:users totalUsers
New Users ga:newUsers newUsers
1 Day Active Users ga:1dayUsers active1DayUsers
7 Day Active Users ga:7dayUsers active7DayUsers
28 Day Active Users ga:28dayUsers active28DayUsers
Number of Sessions per User ga:sessionsPerUser sessionsPerUser

Session

Metrics

Field name UA Name GA4 equivalent name
Sessions ga:sessions sessions
Session Duration ga:sessionDuration userEngagementDuration
Hits ga:hits eventCount

Traffic Sources

Dimensions

Field name UA Name GA4 equivalent name
Full Referrer ga:fullReferrer pageReferrer
Campaign ga:campaign sessionCampaignName
Source ga:source sessionSource
Medium ga:medium sessionMedium
Campaign Code ga:campaignCode sessionCampaignId

Adwords

Dimensions

Field name UA Name GA4 equivalent name
Ad Format ga:adFormat adFormat, in combination with adSourceName
Google Ads: Ad Group ga:adGroup sessionGoogleAdsAdGroupName
Ad Distribution Network ga:adDistributionNetwork sessionGoogleAdsAdNetworkType
Search Query ga:adMatchedQuery sessionGoogleAdsQuery
Google Ads Campaign ID ga:adwordsCampaignID sessionCampaignId
Google Ads Ad Group ID ga:adwordsAdGroupID sessionGoogleAdsAdGroupId
Google Ads Creative ID ga:adwordsCreativeID sessionGoogleAdsCreativeId

Metrics

Field name UA Name GA4 equivalent name
Advertiser ad clicks ga:adClicks advertiserAdClicks
Advertiser ad impressions ga:impressions advertiserAdImpressions
Advertiser ad cost ga:adCost adveristerAdCost

Platform or Device

Dimensions

Field name UA Name GA4 equivalent name
Browser ga:browser browser
Operating System ga:operatingSystem operatingSystem
Operating System Version ga:operatingSystemVersion operatingSystemVersion
Mobile Device Branding ga:mobileDeviceBranding mobileDeviceBranding
Mobile Device Model ga:mobileDeviceModel mobileDeviceModel
Device Category ga:deviceCategory deviceCategory
Data Source ga:dataSource platform

Geo Network

Dimensions

Field name UA Name GA4 equivalent name
Country ga:country country
Region ga:region region
City ga:city city
City ID ga:cityId cityId
Country ISO Code ga:countryIsoCode countryId

System

Dimensions

Field name UA Name GA4 equivalent name
Language ga:language language
Screen Resolution ga:screenResolution screenResolution

Page Tracking

Dimensions

Field name UA Name GA4 equivalent name
Hostname ga:hostname hostName
Page ga:pagePath pagePathPlusQueryString
Page Title ga:pageTitle pageTitle

Metrics

Field name UA Name GA4 equivalent name
Pageviews ga:pageviews screenPageViews
Time on Page ga:timeOnPage userEngagementDuration

App Tracking

Dimensions

Field name UA Name GA4 equivalent name
App Version ga:appVersion appVersion
Screen Name ga:screenName unifiedScreenName

Metrics

Field name UA Name GA4 equivalent name
Screen Views ga:screenviews screenPageViews

Event Tracking

Dimensions

Field name UA Name GA4 equivalent name
Event Label ga:eventLabel eventName

Metrics

Field name UA Name GA4 equivalent name
Total Events ga:totalEvents eventCount
Event Value ga:eventValue eventValue

Ecommerce

Dimensions

Field name UA Name GA4 equivalent name
Item Brand ga:productBrand itemBrand
Item Category ga:productCategory itemCategory
Item Category (Enhanced Ecommerce) ga:productCategoryHierarchy itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5
Item ID ga:productSku itemId
Item list name ga:productListName itemListName
Item name ga:productName itemName
Item promotion creative name ga:internalPromotionCreative itemPromotionCreativeName
Item promotion ID ga:internalPromotionId itemPromotionId
Item promotion name ga:internalPromotionName itemPromotionName
Order Coupon Code ga:orderCouponCode orderCoupon
Transaction ID ga:transactionId transactionId

Metrics

Field name UA Name GA4 equivalent name
Add-to-carts ga:productAddsToCart addToCarts
Cart-to-view rate ga:cartToDetailRate cartToViewRate
Checkouts ga:productCheckouts checkouts
Ecommerce purchases ga:uniquePurchases ecommercePurchases
Item list click through rate ga:productListCTR itemListClickThroughRate
Item list clicks ga:productListClicks itemListClicks
Item list views ga:productListViews itemListViews
Item promotion click through rate ga:internalPromotionCTR itemPromotionClickThroughRate
Item promotion clicks ga:internalPromotionClicks itemPromotionClicks
Item promotion views ga:internalPromotionViews itemPromotionViews
Item purchase quantity ga:itemQuantity itemPurchaseQuantity
Item revenue ga:itemRevenue itemRevenue
Item views ga:productDetailViews itemViews

Time

Dimensions

Field name UA Name GA4 equivalent name
Date ga:date date
Year ga:year year
Month of the year ga:month month
Week of the Year ga:week week
Day of the month ga:day day
Hour ga:hour hour
Minute ga:minute minute
Month Index ga:nthMonth nthMonth
Week Index ga:nthWeek nthWeek
Day Index ga:nthDay nthDay
Minute Index ga:nthMinute nthMinute
Day of Week ga:dayOfWeek dayOfWeek
Hour of Day ga:dateHour dateHour
Date Hour and Minute ga:dateHourMinute dateHourMinute
Hour Index ga:nthHour nthHour

Audience

Dimensions

Field name UA Name GA4 equivalent name
Age ga:userAgeBracket userAgeBracket
Gender ga:userGender userGender
In-Market Segment ga:interestInMarketCategory brandingInterest

Lifetime Value and Cohorts

Dimensions

Field name UA Name GA4 equivalent name
Acquisition Campaign ga:acquisitionCampaign firstUserCampaignName
Acquisition Medium ga:acquisitionMedium firstUserMedium
Acquisition Source ga:acquisitionSource firstUserSource
Cohort ga:cohort cohort
Day ga:cohortNthDay cohortNthDay
Month ga:cohortNthMonth cohortNthMonth
Week ga:cohortNthWeek cohortNthWeek

Metrics

Field name UA Name GA4 equivalent name
Users ga:cohortActiveUsers cohortActiveUsers
Total Users ga:cohortTotalUsers cohortTotalUsers

Channel Grouping

Dimensions

Field name UA Name GA4 equivalent name
Default Channel Grouping ga:channelGrouping sessionDefaultChannelGrouping