How to View Event Parameters in Google Analytics 4
Setting up custom event parameters in Google Analytics 4 is a great first step, but actually finding and using that precious data in your reports can feel like a maze. Unlike in Universal Analytics, your new event parameters don't just magically appear everywhere. This article will guide you through exactly where to find your event parameter data, how to make it usable in GA4 reports, and how to use it for real analysis.
First Things First: What Are GA4 Event Parameters?
Think of an event parameter as an extra piece of information that gives context to an event. An "event" is any interaction you track, like a button click, a purchase, or a video view. The parameter is the detail that describes that interaction.
For example, if you have a contact_form_submit event, it’s helpful to know it happened. It’s more helpful to know which specific form was submitted. You could send a parameter like form_name with a value of "Request a Demo Form" to add that context.
A few common examples include:
- Event:
purchase→ Parameters:value,currency,coupon_code - Event:
view_item→ Parameters:item_name,item_category,price - Event:
button_click→ Parameters:button_text,button_location,page_url
This model is far more flexible than the old Category, Action, and Label system in Universal Analytics. Instead of being stuck with those three fields, you can now define and send dozens of custom parameters that are tailored specifically to your business and your measurement goals.
The Critical Step: Registering Parameters as Custom Dimensions
Here’s the step that trips up almost everyone. By default, GA4 collects your custom parameter data, but it doesn't make it available in your standard reports. You can see it in real-time views and with advanced analysis methods (which we'll cover later), but to see your parameter as a selectable dimension in reports — like "Browser" or "Country" — you must register it as a "custom dimension."
If you don't do this, you won't be able to easily compare, filter, or break down data by that parameter in the GA4 interface. Think of it as telling Google Analytics, "Hey, I sent this piece of data called form_name. I want you to treat it as a filterable dimension I can use in my reporting."
How to Create a Custom Dimension
Setting this up is straightforward. Just follow these steps:
1. Navigate to the Admin Section
Click on the gear icon ('Admin') in the bottom-left corner of your GA4 dashboard.
2. Find "Custom definitions"
In the 'Property' column, look for the 'Data display' section and click on 'Custom definitions.'
3. Click "Create custom dimensions"
On the Custom definitions page, you'll see a blue button. Click on it.
4. Fill Out the Details
You'll see a few fields you need to complete. This part is crucial, so be precise.
- Dimension name: This is the friendly, readable name that will appear in your reports. If your parameter is named
button_text, you might name this "Button Text." - Scope: This tells GA4 what the dimension is associated with. For parameters sent with events, you will almost always choose "Event" scope. The other option, "User," is for user properties (user-level attributes like
account_tier). - Description: This is an optional field to help you and your team remember what this dimension is for.
- Event parameter: This is the most important field. You must enter the parameter name exactly as it is sent from your website or app. It's case-sensitive! If your code sends
button_text, you must enterbutton_texthere, notButton_textorButton Text. The best practice is to copy and paste it from your code or Google Tag Manager tag to avoid typos.
An Example
Let's say you want to track which call-to-action buttons users are clicking. You set up a button_click event that sends a parameter called cta_type with values like "Sign up" or "Learn more."
Your custom dimension configuration would look like this:
- Dimension name: CTA Type
- Scope: Event
- Description: The text on the call-to-action button that was clicked.
- Event parameter:
cta_type
Once you save this, you're done! Now, you just have to wait.
Very Important Note: It can take up to 48 hours for data to start populating in reports for a newly created custom dimension. This change is not retroactive, it will only apply to data collected from that point forward. Double-check for typos before saving, because you cannot edit the Event parameter field after creation.
Viewing Parameter Data in Standard Reports
Once your custom dimension is registered and has had some time to collect data, you can start finding it in the standard GA4 reports.
The primary location to view data for a specific event is the Events deep-dive report.
- Navigate to Reports > Engagement > Events.
- This will show you a table of all your events. Click on the name of the event you're interested in (e.g.,
button_click). - This takes you to a summary page for that individual event. If your custom dimension is collecting data, you will see a new card on this page matching the 'Dimension Name' you created.
This card gives you a quick overview of the values collected for that parameter for that specific event. For our cta_type example, this is where you'd see a list of button types ("Sign up," "Learn more") and how many times each was clicked.
You can also use your new custom dimension as a secondary dimension in many other standard reports. In any report table, click the small blue '+' icon next to the primary dimension header to add a secondary dimension. You can then search for your custom dimension by its friendly 'Dimension Name' to break down the primary data further.
Deeper Analysis Using Explorations
Standard reports are great for high-level summaries, but to really dig into your custom parameter data, you need to use the Explore section. Explorations allow you to build fully custom reports, tables, and funnels using any combination of dimensions and metrics.
Let's build a simple free-form report to see how many users clicked each of our CTA buttons.
- Go to the Explore Tab
- Import Your Variables
- Build the Report
- Apply a Filter
The table will now update to show you the exact data you want: a list of every value for your cta_type parameter, along with the total counts and user counts associated with each. This level of detail is exactly why you took the time to set up event parameters in the first place.
For Immediate Checks: Use DebugView
Sometimes you can't wait 48 hours to know if your new tag is working correctly. You need to verify that your events and parameters are firing as expected right now. For this, DebugView is the perfect tool.
DebugView gives you a real-time stream of the events, parameters, and user properties being sent from your development device to GA4.
How to Enable and Use DebugView
- First, you need to enable debug mode for your browser. The easiest way is to install the official Google Analytics Debugger Chrome extension. Once installed, click its icon to turn it 'ON.' You can also enable this state by using Preview mode in Google Tag Manager.
- In GA4, navigate to Admin > DebugView (under 'Data display').
- Open your website in the browser where debug mode is enabled and perform the actions you want to track (e.g., click a specific button).
Final Thoughts
Mastering event parameters may take some practice, but it's where the most valuable insights in GA4 live. The workflow is simple: send custom parameters with your events, register them as custom dimensions to make them usable in the UI, and then analyze your data using a mix of standard reports and focused Explorations. Always remember to validate your setup with DebugView to save yourself time and headaches.
When you start combining GA4 event insights with data from other sources like your ad platforms or CRM, reporting can get complicated again. At Graphed, we solve this by simplifying the whole process. Just connect your GA4 account and other data sources securely, then ask questions in simple language to get live, automated dashboards in seconds. For instance, rather than building three separate reports, you could simply ask, "show me which of my GA4 traffic sources have the highest conversion rates from new users who submitted our main contact form this month," and get an instant, real-time report that never needs to be manually refreshed.
Related Articles
What SEO Tools Work with Google Analytics?
Discover which SEO tools integrate seamlessly with Google Analytics to provide a comprehensive view of your site's performance. Optimize your SEO strategy now!
Looker Studio vs Metabase: Which BI Tool Actually Fits Your Team?
Looker Studio and Metabase both help you turn raw data into dashboards, but they take completely different approaches. This guide breaks down where each tool fits, what they are good at, and which one matches your actual workflow.
How to Create a Photo Album in Meta Business Suite
How to create a photo album in Meta Business Suite — step-by-step guide to organizing Facebook and Instagram photos into albums for your business page.