Tracking Events in Google Analytics 4
With Google Analytics 4 integration in your Elfsight widgets, you can easily track and analyze user interactions. In this article, we'll show you how to find your events and use them in reports. Let's get started! 🚀
In this article
Important Notes Before You Begin
📊 Built-in Google Analytics Support
Built-in Google Analytics events are currently available in the following widgets:
AI Chatbot Chat Widgets Popup Click to Call Countdown Timer Spinning Wheel Website Translator Slider Audio Player Reviews Widgets Social Feed
If you're using any of these, first see Setting Up Google Analytics Events in Your Widget.
If your widget isn’t on the list, contact Support for a custom solution.
✅ Automatic Event Tracking
If Google Analytics 4 is installed directly on your website, events are sent automatically — no additional setup is required.
🔄 Using Google Tag Manager
If you're using Google Tag Manager to send events to GA4, follow this guide instead: Tracking Events with Google Tag Manager.
Checking Events in Real Time
To make sure your widget events are being received, you can use the Realtime report in GA4.
- 1
-
In your GA4 property, go to Reports → Realtime overview. You'll find the event listed in the Event count by Event name section:
- 2
-
Click the event to view its details and parameters. For example, the chat_message event may include parameters like:
- source (Elfsight)
- app (e.g. AI Chatbot)
- widget_id (your widget ID)
- sender (user or agent)
That's it! Now you know how to check your events in real time. Next, let’s see how to use them in reports. 📊
Viewing Events in Reports
Once your events are collected, you can use them in GA4 reports and explorations.
- 1
-
Go to Reports → Engagement and click Events: Event Name:
- 2
-
Find your event (e.g. chat_message) in the list and click it to view details:
Pro Tip: You can also use events in Explorations to build custom reports.
Using Event Parameters in Reports
Events appear in reports automatically, but their parameters don’t. To use parameters like sender, app, or your custom ones, register them as event-scoped custom dimensions.
Here’s how to do it:
- 1
-
In your GA4 property, go to Admin → Data display → Custom definitions. Then click Create custom dimension:
- 2
-
Fill in the fields and click Save:
- Dimension name – Choose a name that’s easy for you to recognize in reports.
- Scope – Select Event.
- Event parameter – Enter the exact parameter name from your event (e.g. sender).
Newly added custom dimensions may take up to 24 hours to appear in your reports.
Now you know how to view your events and use their parameters in reports!
Great job! 🎉 You’re now ready to track and analyze your widget events in Google Analytics 4. If you need any help or clarification, feel free to contact our Support team — we’ll be happy to assist!