GA4 Event-scoped dimensions explained

Event-scope means the value of the dimension is calculated and sent for each event

GA4 Event-scoped dimensions provide insights into the context surrounding a specific user event (e.g., purchase, video play). They capture details specific to user actions (events) on your website or app.

For example:

  • Product category for a purchase event
  • Video title for a video play event
  • Button text for a click event. etc

Event-scoped dimensions apply only to the event they are associated with, not to the entire session.

There are two categories of GA4 event-scoped dimensions:

#1 GA4 Built-in event-scoped dimensions – These are ready-to-use dimensions available in the GA4 reporting interface or data API.

#2 GA4 custom event-scoped dimensions – These are user-defined event-scoped dimensions.

GA4 Built-in event-scoped dimensions

The following table provides a brief description of the various GA4 Built-in event-scoped dimensions:

GA4 Built-in event-scoped dimensionsWhat it is
Campaign / Campaign IDRepresents the name and ID of a promotion or marketing campaign that led to a key event.
Default channel groupChannel groupings are rule-based definitions of your traffic sources.
Manual campaign IDDisplays the ID of a specific campaign or promotion from the click URL or campaign_details event.
Manual campaign nameShows the specific campaign or promotion name from the click URL or campaign_details event.
Manual ad contentIndicates the creative content used from the click URL or campaign_details event.
Manual mediumRepresents the marketing medium from the click URL or campaign_details event.
Manual sourceIdentifies the referrer from the click URL or campaign_details event.
Manual source / mediumCombines the source and medium from the click URL or campaign_details event.
Manual source platformShows the source platform, noted as ‘Manual’, from the click URL or campaign_details event.
Manual termDisplays the paid keyword from the click URL or campaign_details event.
MediumDescribes the method of acquiring users.
SourceA representation of where traffic originates.
Source / mediumDetails the source and medium that led a user to your website or application.
Source platformIdentifies the platform managing buying activity.

Do you want expert help in setting up/fixing GA4 and GTM?

If you are not sure whether your GA4 property is setup correctly or you want expert help migrating to GA4 then contact us. We can fix your website tracking issues.

GA4 custom event-scoped dimensions

The custom event-scoped dimensions are user-defined dimensions.

custom event scoped dimensions are user defined dimensions
GA4 custom event scoped dimensions

If a built-in event-scoped dimension does not capture the detail relevant to your business, create its corresponding custom event-scoped dimension.

Let’s say you run an e-commerce website and want to track clicks on a “Subscribe” button to understand how often users engage with this call to action. 

GA4 does not have a built-in event-scoped dimension specifically for tracking “Subscribe” button clicks. 

Therefore, you need to create a custom event-scoped dimension to capture this detail.

How to identify event-scoped dimensions in GA4?

GA4 Event-scoped dimensions do not have a prefix (like ‘source/medium’).

That’s how you know they are event-scoped:

GA4 Event scoped dimensions

Note: The source and medium for non-key events in GA4 are “(not set)”.

GA4 Event-scoped dimensions vs Attribution.

For event-scoped dimensions, by default, GA4 assigns conversion credit using data driven attribution model.

Event-scoped dimensions are affected by changes to the reporting attribution model (you select under Data Display > Attribution Settings):

Attribution Settings ga4

However, it is important to clarify that event-scoped dimensions themselves do not use the reporting attribution model.

This is because the values of event-scoped dimensions do not change based on user behaviour or the attribution model you choose.

Consider the following user journey:

#1 Clicks a Facebook ad: The user clicks a social media ad on Facebook, directing them to your website. This interaction is captured by the session-scoped dimension “Session Source/Medium” with the value “facebook / referral.”

#2 Browses “clothing” category: While browsing the website, the user specifically interacts with the “clothing” category. This detail is captured by the event-scoped custom dimension “product_category” with the value set to “clothing” for the specific event of browsing that category.

#3 Signs up for newsletter: The user completes a key event by signing up for your newsletter.

The value “clothing” remains constant, reflecting the product category the user browsed, regardless of the user’s prior actions or the attribution model chosen.

Even though the user arrived through a Facebook ad, the attribution model you’ve selected (e.g., last click, data-driven) determines how credit for the newsletter signup (key event) is ultimately assigned.

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