By default, Google Analytics 4 (GA4) tracks basic metrics on your site such as pageviews, bounce rate, and session data. But if you want to track specific user interactions – file downloads, link clicks, form submissions, or video views – you need to implement custom event tracking.
In GA4, Events are user interactions that capture specific actions beyond pageviews. They are the core building blocks for all tracking. This event-based model gives you more flexibility and granularity when measuring user behavior.
This post covers events in Google Analytics 4, where events are not structured as “Hits” (as in the legacy Universal Analytics) but as independent interactions within an event-driven model.
Anatomy of Events in GA4
In GA4, every event can include parameters that provide context about the action. You can create custom events or use the predefined ones that GA4 provides. The two key components of every event are:
- Event Name – Identifies the specific user interaction (e.g.,
video_play,form_submit). - Parameters – Additional details about the event, such as the video title, form name, or page URL.
For example, to track when a user clicks the play button on a video, you’d create an event with:
- Event Name:
video_play - Parameter: “Video Title” (e.g., “Introduction to GA4”)

Let’s explore the primary components of GA4 events in more detail:
1. Event Name
The Event Name is the core identifier of each interaction. Names like click, video_play, or form_submit define what action occurred, making it easier to analyze specific interactions in GA4 reports.
Google recommends using snake_case for event names (e.g.,
add_to_cart,download_pdf) and keeping them descriptive and consistent across your site.
2. Parameters
Parameters let you add specific context to each event. They’re flexible and can represent anything related to the interaction. Here are some common parameters:
- Page Location – The URL where the event occurred, helping you identify which page triggered the interaction.
- Item ID or Item Name – Useful for tracking specific products or content items, such as a product ID in an e-commerce store.
- Click Text – The text of a clicked button or link, showing which CTAs perform well.
- Video Title and Duration – Details about which video was played and for how long.
When defining parameters, focus on the data that provides the most value in your reports. Adding too many parameters makes tracking unnecessarily complex.
Here’s an example of tracking a video_play event with parameters:
gtag('event', 'video_play', {
'video_title': 'Introduction to GA4',
'video_duration': '3:45'
});And here’s a contact_form_submit event capturing the form title and page location:
gtag('event', 'contact_form_submit', {
'form_title': 'Newsletter Signup',
'page_location': window.location.href,
'submission_time': new Date().toISOString()
});In the first example, video_title and video_duration help you analyze engagement for specific videos. In the second:
form_titleidentifies which form was submitted, enabling cross-form performance tracking.page_locationrecords where the event happened, ensuring accuracy when forms appear on multiple pages.submission_timecaptures the exact submission time, useful for identifying peak activity periods.
3. Custom Dimensions and Metrics
GA4 lets you define custom dimensions and metrics to add unique context to events. This is useful for tailoring tracking to specific business needs.
For example, if you run a membership site, you could add a custom dimension for “Membership Level” to segment event data by user type. This enables deeper analysis in your reports.
To register a custom dimension, go to Admin > Custom Definitions > Create custom dimension, set the scope (event or user), and map it to the parameter name you’re sending with your events.
Marking Events as Conversions
Once you’ve set up custom events, you can mark the most important ones as conversions. Conversions in GA4 are essential actions you want users to take – purchases, form submissions, signups, and similar high-value interactions.
To mark an event as a conversion, navigate to Admin > Events, find the event you want to track, and toggle “Mark as key event.” GA4 will then treat this action as a key performance indicator in your reports.
In GA4, what was previously called “Conversions” has been renamed to “Key Events” (as of March 2024). The functionality is the same, but the terminology in the interface may differ depending on when you access it.
Best Practices for Events and Conversions
- Use descriptive event names – Keep names consistent and clear across your site. Use snake_case (e.g.,
add_to_cart, notaddToCart). - Add meaningful parameters – Include parameters like
button_text,product_id, orform_nameto give events useful context. - Plan your key events – Focus on actions that directly align with business objectives, such as purchases or form completions.
- Use Google Tag Manager – For complex tracking setups, GTM makes it easier to manage events without editing site code directly.
FAQs
Common questions about events in Google Analytics 4:
page_view event is automatically tracked, while other events (like button clicks or form submissions) need to be set up manually or through enhanced measurement settings.page_view, session_start, first_visit, and user_engagement without any additional setup. Enhanced measurement adds events like scroll, click (outbound), file_download, and video_start.gtag() function in your site's JavaScript code. However, Google Tag Manager provides a visual interface for managing events without editing code, and makes it easier to maintain and update tracking over time.Summary
GA4’s event-based model lets you go beyond pageviews and track specific user interactions on your WordPress site. By setting up custom events, adding meaningful parameters, and marking critical actions as key events, you can align your analytics with your business goals and make data-driven decisions.
For more on setting up events and key events in GA4, see Google’s official documentation.

