Open navigation

Important: Upcoming changes to Google Analytics 4

What's happening

On December 1, 2022, updates to Google Analytics 4 will introduce incompatibility between a range of dimensions and metrics. Queries that use these fields together after December 1 will stop working — read this article to learn about the changes you'll need to make before then.


What you need to do

Google's update impacts three dimension types: item-scoped, attribution, and query string. Any queries that use these dimensions — including any Supermetrics Custom Fields based on them — must be updated.


Learn about changes you need to make for each dimension type below, or see the full list of impacted fields.


Item-scoped dimensions

Remove any item-scoped dimensions that will become incompatible with the event-scoped metrics listed below.


You don't need to make any changes to queries that combine item-scoped dimensions with fields other than event-scoped metrics.


Attribution dimensions

The update switches Google Analytics 4 from a generic, event-based attribution model to a model with two alternatives:

  • "First user" source: The first source of contact of a user
  • "Session" source: The last source of contact before a session


If your queries use the attribution dimensions and metrics listed below, replace them with either their "First user" or "Session" equivalent before December 1.


Query string dimensions

Starting December 1, it'll no longer be possible to get a full URL with a query string (for example, example.com/store/contact-us?query_string=A) with the file combinations listed below.

If you use any of these, replace them with the "Page path without query string" dimension. This will return the page path without the query string (for example, example.com/store/contact-us).


If you're using a data warehouse

We've updated the Standard schema to remove all fields impacted by this change.


The older version of the schema has been renamed STANDARD_ARCHIVED20221201. Switch from this to the Standard schema to keep your queries running.


See a full list of all tables in the Standard schema.



Incompatible fields

Starting December 1, the following fields will become incompatible. Any queries that use them together will stop working. Find a full description for any field in our technical documentation.


Item-scoped dimensions with event-scoped metrics

The dimensions in the table below — including any Custom Fields based on them — will become incompatible with the metrics in the table that follows.


IDDisplay Name
itemAffiliationItem affiliation
itemBrandItem brand
itemCategoryItem category
itemCategory2Item category 2
itemCategory3Item category 3
itemCategory4Item category 4
itemCategory5Item category 5
itemIDItem ID
itemListIDItem list ID
itemListNameItem list name
itemNameItem name
itemPromotionCreativeNameItem promotion creative name
itemPromotionIDItem promotion ID
itemPromotionNameItem promotion name
itemVariantItem variant


The dimensions above will be incompatible with the following metrics as of December 1:


ID
Display Name
adUnitExposureAd unit exposure
addToCartsAdd-to-carts
averagePurchaseRevenueAverage purchase revenue
checkoutsCheckouts
conversionsConversions
ecommercePurchasesPurchases
eventCountEvent count
eventsPerUserEvents per user
eventValueEvent value
eventsPerSessionEvents per session
firstTimePurchasersPerNewUserFirst-time purchasers per new user
itemListClicksItem list clicks
itemListViewsItem list views
itemViewsItem views
newUsersNew users
itemPromotionClicksItem promotion clicks
itemPromotionViewsItem promotion views
publisherAdClicksPublisher ad clicks
publisherAdImpressionsPublisher ad impressions
purchaseRevenuePurchase revenue
screenPageViewsViews
sceenPageViewsPerSessionViews per session
shippingAmountShipping amount
taxAmountTax amount
transactionsTransactions
transactionsPerPurchaserTransactions per purchaser
userEngagmentDurationTotal user engagement duration (sec)
Attribution dimensions with event-scoped metrics

The dimensions in the table below — including any Custom Fields based on them — will become incompatible with the metrics in the table that follows.


IDDisplay Name
campaignIdEvent campaign ID
campaignNameEvent campaign name
defaultChannelGrouping
Conversion default channel grouping
googleAdsAccountNameEvent Google Ads account name
googleAdsAdGroupIdGoogle Ads ad group ID
googleAdsAdGroupNameGoogle Ads ad group name
googleAdsAdNetworkTypeEvent ad network type
googleAdsCampaignIDGoogle Ads campaign ID
googleAdsCampaignNameGoogle Ads campaign name
googleAdsCampaignTypeGoogle Ads campaign type
googleAdsCreativeIdGoogle Ads creative ID
googleAdsCustomerIdGoogle Ads customer ID
googleAdsKeywordGoogle Ads keyword text
googleAdsQueryGoogle Ads query
mediumEvent medium
sourceEvent source
sourcePlatformSource platform


The dimensions above will be incompatible with the following metrics as of December 1:


IDDisplay Name
adUnitExposureAd unit exposure
addToCartsAdd-to-carts
averagePurchaseRevenueAverage purchase revenue
checkoutsCheckouts
ecommercePurchasesPurchases
eventCountEvent count
eventsPerUserEvents per user
eventsPerSessionEvents per session
firstTimePurchasersPerNewUserFirst-time purchasers per new user
itemListClicksItem list clicks
itemListViewsItem list views
itemViewsItem views
newUsersNew users
itemPromotionClicksItem promotion clicks
itemPromotionViewsItem promotion views
publisherAdClicksPublisher ad clicks
publisherAdImpressionsPublisher ad impressions
screenPageViewsViews
screenPageViewsPerSessionViews per session
shippingAmountShipping amount
taxAmountTax amount
transactionsTransactions
transactionsPerPurchaserTransactions per purchaser
userEngagmentDurationTotal user engagement duration (sec)
Query string dimensions

The dimensions in the table below — including any Custom Fields based on them — will only be available with the metrics in the table that follows.


IDDisplay Name
pagePathPage path
unifiedPageScreenPage path, query string, and screen class
pageLocationPage location
fullPageUrlFull page URL


The dimensions above will only be available with the following metrics as of December 1:


IDDisplay Name
activeUsersActive users
conversionsConversions
countryCountry
countryIsoCodeCountry code
dateDate
engagedSessionsEngaged sessions
eventCountEvent count
eventNameEvent name
fullPageUrlFull page URL
hostNameHost name
pageLocationPage location
pagePathPage path
pageTitlePage title
platformPlatform
screenPageViewsViews
sessionsSessions
totalUsersTotal users
unifiedPageScreenPage path, query string, and screen class
userEngagementDurationToal user engagement duration (sec)

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.