An event is a specific user interaction with an element on a website, such as clicking a button, submitting a form, or downloading a file.
This guide explains how to send existing Plerdy custom events to Google Analytics 4 through Google Tag Manager. Before starting, make sure that the Plerdy tracking code, Google Tag Manager container, and Google tag are installed on the same website.
If you have not created an event in Plerdy yet, follow the guide to adding events in Plerdy first. Then complete the steps below to send these events to GA4.
Steps to Set Up Custom Events via Google Tag Manager and Send Them to GA4
1. Go to the Triggers section in your Google Tag Manager dashboard.
2. Choose the following settings:
- Select Custom Event as a Trigger Type.
- Enter ^Plerdy – .+$ in the Event Name field. This regular expression matches event names that begin with Plerdy – .
- Activate Use regex matching.
- Select All Custom Events in This trigger fires on section.
3. Go to the Tags section and create a GA4 Event tag.
4. Choose the following settings for this tag:
- Select Google Analytics: GA4 Event as the Tag Type.
- In the Measurement ID field, enter the same GA4 measurement ID used by your Google tag. It must have the format G-XXXXXXXXXX.
- Enter plerdy_event in the Event Name field.
- Open Event Parameters and add plerdy_event_name as the parameter name.
- Enter {{Event}} as the value of the plerdy_event_name parameter.
- Leave the Event Settings Variable field empty unless your GTM container already has a properly configured Google tag event settings variable.
Do not use {{Page URL}} or the original {{Event}} value as the GA4 event name. GA4 event names cannot contain spaces or hyphens. The setup above sends all matched Plerdy actions under the valid plerdy_event name while preserving the original Plerdy event name in the plerdy_event_name parameter.
5. Open the Triggering section, select the Plerdy Custom Event trigger created earlier, and click Save.
6. Click Preview in Google Tag Manager and connect Tag Assistant to your website. Perform an action tracked by the Plerdy event. Confirm that the GA4 Event tag fires once and that the event appears in the Data Layer.
7. Open Google Analytics 4 and go to Admin → Data display → DebugView. Confirm that the plerdy_event event appears and contains the plerdy_event_name parameter.
8. Return to Google Tag Manager and click Submit. Select Publish and Create Version, enter a version name and description, and click Publish.
How to View Plerdy Event Names in GA4 Reports
To use the plerdy_event_name parameter in GA4 reports, go to Admin → Data display → Custom definitions and click Create custom dimension. Enter Plerdy Event Name in the Dimension name field, select Event as the scope, enter plerdy_event_name in the Event parameter field, and click Save.