Unlock Deeper Insights: Setting Up Custom Event Parameters in GA4 with GTM

March 25, 2025
A stylized illustration of a person working on a laptop with a screen showing GA4 and Tag Manager. A gear icon and code tags are also visible. The Analyticsmates logo, a sailboat, is in the upper right corner.

Google Analytics 4 (GA4) is a powerful tool, but to get the most out of it, you need to go beyond just tracking basic events. That’s where custom event parameters come in. They give you a more granular interpretation of your site’s performance and  control over your data, allowing you to track specific user interactions that align to your business goals. Whether it’s capturing button clicks, downloading files, form submissions, or product views, custom parameters provide deeper insights that can help you make better decisions. Using Google Tag Manager (GTM) with Google Analytics 4, you can implement these custom parameters efficiently. In this blog post, we'll walk you through the process step by step, so you can confidently set up custom event parameters in GA4 using GTM.

What are Event Parameters?

Let us explain this in its simplest form:

Think of event parameters as extra details that help explain what happened when a specific action (event) took place on your website or app.

For example, if you track a "form_submission" event, you might want to know:

  • Was the submission successful? (success: "yes" or "no")
  • What page was the form submitted on? (page_location: "contact_us")
  • What type of form was submitted?(form_type: "newsletter_signup")
  • What resource has been downloaded? (Looker Dashboard, AI prompt)

Each of these details is stored as a key-value pair, meaning:

  • Key = the type of information being tracked (e.g., "success")
  • Value = the specific detail for that event (e.g., "yes")

Key Considerations Before Setting Up Event Parameters

Understand the difference between default (automatically collected) events and custom events. Since we won’t be diving into the details of creating custom events here, you can check out this list of our recent posts on custom events, for further guidance.

Aside from this, you'll need the right tools—primarily Google Analytics 4 (GA4) and Google Tag Manager (GTM). Google Looker Studio may also be useful for reporting, but for now, we’ll focus on GA4 and GTM.

Implementation

What's a better way to explain this, but through an example. We’re working on collecting additional event parameters for our forms in our Resources page.

website page with three product offerings in separate boxes. The middle box, with a red outline, displays a dashboard with various data points and the title "Technical SEO Audit Report (GSC + CrUX)". The Analyticsmates logo is at the top.

What we’re trying to do here  is to capture additional details about which specific resources are being downloaded. On our website right now, we offer a variety of free downloadable resources, but we only require users to sign up for our newsletter—without tracking which resources they access.
You might be wondering, why not assign separate events for each downloadable resource? While that’s possible, it can lead to a cluttered and inefficient setup—something we want to avoid. Instead, let’s explore a more streamlined approach.

Step 1: Check the elements you need and will use for the event 

1. Log in to your Google Tag Manager (GTM) account and open the container.

2.Click the Preview button,

A close-up screenshot of a web interface with the "Preview" button highlighted in an orange box. Other buttons labeled "Submit" and "Configure" are visible.

then enter the website URL where the event requiring the custom event parameter is located.

A modal window titled "Tag Assistant" with the "Connect Tag Assistant to your site" header. It shows a Google Tag Manager Preview Mode interface with a URL field and a "Connect" button. The URL field contains "  https://www.analyticsmates.com/resources/free-google-analytics-4-templates".

4. We'll test this form to identify the data layer values or elements we can use for tracking.

Resources page showcasing the "Technical SEO Audit Report" with data visuals and a map. An email address field and a "Download Now" button are highlighted in a red box. The Analyticsmates logo is at the top.

5. Go to Tag Assistant and identify the values available for the event parameter. In this example, the “Form ID” can be used as it has a unique value that sets it apart from other events. This helps ensure accurate data collection and prevents tracking inconsistencies.

Tag Assistant a debugging tool showing various data points and variables. The "Form ID" section is highlighted, displaying the string "Analytics-Mate-SEO-Report-Google-Search-Console-Chrome-UX-Datasource". The website address "analyticsmates.com" is visible at the top.

Step 2: GTM Tag and Trigger implementation

6. Now that we’ve identified the value using the Form ID, we can set up the GTM tag (if you haven’t created one yet).In our case, we created a single tag for all downloads and simply added triggers based on the specific resource being downloaded. Click on the tag.

Google Tag Manager interface, showing a list of tags. The "Gated Content Tag" is selected, with the type "Google Analytics: GA4 Event" and multiple firing triggers listed. The Analyticsmates website address is visible at the top.

On the Tag Configuration page, click the pencil icon.

Google Tag Manager interface, displaying the "Gated Content Tag" configuration. The "Triggering" section is shown with multiple firing triggers and a highlighted edit icon in the upper right corner.

7. Next, click the “+” icon to create a new trigger. On the Choose Trigger page, click the “+” icon in the top-right corner.

Google Tag Manager interface, showing the "Triggering" section with multiple firing triggers. A "+" button is highlighted in a circle at the top right of the trigger list.

8. On the next page, select a trigger type based on your site’s tracking setup. In this example, we’re using Form Submission, so we’ll choose that option.

9. Give your trigger a distinct name, such as "Technical SEO Audit Report (GSC + CrUX)".

10. Under This trigger fires on, select Some Forms and use the Form ID condition: Use the Form ID  (contains “Analytics-Mate-SEO-Report-Google-Search-Console-Chrome-UX-Datasource”)

Google Tag Manager trigger configuration for "Form Submission." The "Form ID" field is set to "contains" and the value "Analytics-Mate-SEO-Report-Google". The "Some Forms" radio button is selected.

11. Once done, click Save.

Step 3: Setting up the Event Parameter

12. Return to the Tag Configuration section and click on the Event Parameters section.

13. In this example (as shown in the screenshot below), we are passing the value of "gated_content" to GA4. Additionally, we are passing event parameters each time this event is triggered.

14. Pay close attention to the Event Parameter and Value fields. Ensure you enter a name for the event parameter, and for the value, dynamically pass the Form ID. The correct syntax for this is {} (curly braces).

Google Tag Manager interface, with the "Event Parameters" section highlighted in a red box. It shows a parameter named "am_gated_content" with the value "{ {Form ID} }".  The "Event Name" is "gated_content".

Step 4: Preview, Testing and DebugView

15. Once everything is set up, it's important to test whether the event parameter is being passed to GA4. Click the Preview button in Google Tag Manager.

16. Navigate to the resource and attempt to download it.

17. In the Tag Assistant section, confirm that the tag has successfully fired and check if the event parameter is included.

Details of a fired tag in Google Tag Manager. The "eventSettingsTable" and "Event Name" rows are highlighted, showing the parameter "am_gated_content" with the value "Form ID" and the event name "gated_content".

18. In GA4, go to Admin > Data Display > DebugView to verify that the event parameter is being recorded.

Google Analytics 4 debug view, highlighting the "am_gated_content" parameter with the value "Analytics-Mate-SEO-Report-Google-Search-Console-Chrome-UX-Datasource". The Analyticsmates website address is visible at the top.

Step 5: Mapping Event Parameter in GA4

To catch the event parameter value from GTM, you need to create a custom dimension. 

19. In GA4, navigate to Admin > Data Display > Custom Definitions.

20. Click the Create Custom Dimension button.

21. Enter the event parameter name exactly as it was set up in GTM. This step is crucial—if the names do not match, the value will not be recorded properly. In this example, we used am_gated_content as the event parameter name.

Google Analytics 4 interface, showing the "Edit custom dimension" popup. The "Event parameter" field is highlighted, displaying "am_gated_content". The Analyticsmates website address is visible at the top.

22. Click Save.

Note: It may take 48-72 hours before data starts appearing in your GA4 reports.

Step 6: Validating Event Parameter Data in Exploration Report 

The final step is to verify that the data is being collected correctly using an Exploration Report in GA4. 

23. In GA4, navigate to Explore > Exploration Report.

24. Add the following to your report:

  • Event Name
  • The Custom Dimension you recently created (e.g., Resources Gated Content).

25. Apply a filter to display only the relevant event name.

Google Analytics 4 Free Form report. A table is highlighted, showing the "Event name", "Resources Gated Content", and "Event count" columns. The "gated_content" event is listed with various resource names and corresponding counts. The Analyticsmates website address is visible at the top.

Best Practices for Custom Event Tracking

  • Use a Clear and Consistent Naming Convention – Follow GA4’s recommended event naming structure (e.g., snake_case).
  • Define Key Event Parameters – Identify which custom parameters are necessary for deeper analysis.
  • Leverage Built-in Variables in GTM – Use GTM’s built-in variables to capture dynamic data without extra coding.
  • Enable DebugView in GA4 – Test custom events in real-time using DebugView before deployment.
  • Use Google Tag Assistant and Preview Mode – Ensure events fire correctly before publishing changes in GTM.
  • Keep Events Aligned with Business Goals – Track actions that provide meaningful insights for decision-making.
  • Follow GA4’s Recommended Events When Possible – Use predefined events like purchase, sign_up, and add_to_cart where applicable.
  • Minimize Redundant Event Tracking – Avoid tracking unnecessary or duplicate events that can clutter reports.
  • Ensure Custom Parameters Are Registered in GA4 – Add parameters under the ‘Custom Definitions’ section for proper reporting.
  • Test Across Different Devices and Browsers – Ensure custom event tracking works consistently across all user environments.

Common Mistakes to Avoid

  • Not Naming Events Correctly – Avoid using spaces, special characters, or inconsistent casing in event names.
  • Forgetting to Configure Custom Parameters in GA4 – If parameters aren’t registered in GA4, they won’t appear in reports.
  • Not Using Preview Mode in GTM – Deploying changes without testing can lead to inaccurate or missing data.
  • Tracking Too Many Unnecessary Events – Overloading GA4 with unnecessary data makes reporting harder to analyze.
  • Not Mapping Variables Correctly in GTM – Using incorrect or missing variables can cause events to fail.
  • Sending Personally Identifiable Information (PII) – Avoid capturing email addresses, phone numbers, or other PII, as it violates Google’s policies.
  • Ignoring Data Layer Setup Issues – Ensure the Data Layer is structured correctly for custom event parameters to fire properly.
  • Not Using Consistent Event Names Across Platforms – Ensure event names are standardized across GA4, GTM, and other tools.
  • Missing Event Timing Issues – Events that fire too late or too early may not be recorded properly.
  • Not Regularly Auditing Event Tracking – Failing to check GA4 reports and debug errors can lead to broken tracking over time.

The Practical Use of Event Parameters

At Analytics Mates, we’re all about making data-driven decisions that maximize impact. By tracking event parameters, we gain clear insights into how many downloads occur over time and which content resonates most with our audience. These insights empower us to refine our strategy, create high-value resources, and continuously adapt to the evolving needs of marketing professionals. Take a look at this snapshot of our dashboard in action!

A dashboard showing various data visualizations related to gated content, including user counts, conversion rates, and channel attribution. The Analyticsmates logo, a sailboat, is in the top left corner.

Final Words

Setting up custom event parameters in GA4 with GTM might seem tricky at first, but it’s a game-changer for understanding user behavior. By tracking specific interactions like form submissions and downloads, you get richer insights that help you make smarter decisions. Just remember to test, validate, and keep your tracking aligned with your goals—and before you know it, you’ll have a streamlined analytics setup that truly works for you. Now, go put it into action!

Thank you for reading!

‍We're always looking for ways to improve our Google Analytics 4 blog content. Please share your feedback so we can make it even better.

Get free Google Analytics 4 reporting templates sent to your inbox...

Thank you! You have been subscribed to GA4 Updates!
Oops! Something went wrong while submitting the form.
top arrow
By using this website, you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts.. View our Privacy Policy for more information.