EventsEnhanced

Description

Turn Matomo's Events reports into a navigable analysis: open a detail page for any event category, action or name and see how it evolves and what it is combined with.

Features

• Event detail pages: a "View Event Details" row action on the Events reports (Categories, Actions, Names) opens a dedicated page for the selected value. Selectors at the top of the page let you switch the dimension (category, action, name) and the value without going back to the report.
• Evolution graph of the selected value over time, with a metric picker (events, visits, event value, events with a value).
• Related breakdowns on each detail page: the two other event dimensions filtered on the selected value (for example the actions and names of a category) and the event values recorded for it.
• Events (All Dimensions) report under Behavior > Events: category, action and name in one hierarchical table, with visits, unique visitors, events, total, minimum, maximum and average event value. It is also available as a dashboard widget.
• Top 10 evolution graphs for event names (under Behavior > Events), and for event categories and actions (from the Related Reports links), with one line per value.
• API methods for every breakdown, for example EventsEnhanced.getEventActionsForCategory, EventsEnhanced.getEventNamesForAction, EventsEnhanced.getEventValuesForName, EventsEnhanced.getEventsWithAllDimensions and EventsEnhanced.getEventNamesEvolution. Report metadata is complete, so API and AI clients (such as the McpServer plugin) can discover them.
• Events derived from actions report under Behavior > Events: the events GA4 collects automatically (session_start, first_visit, page_view, click, file_download, view_search_results, and video_start, video_progress, video_complete with Media Analytics, form_start, form_submit with Form Analytics), rebuilt from Matomo data and kept apart from your events, so you can compare Matomo with the GA4 Events report line by line.
• GA4 names for Media Analytics events: when the Media Analytics plugin is activated, its automatic video and audio events are named after the GA4 events (video_start, video_pause, video_resume, video_seek, video_complete, and audio_* for audio) instead of the media title, so the Event Names report lists interactions you can compare with GA4.
• Segments, periods and the standard view permission of the Events reports apply everywhere.
• Translated into 12 languages.

Premium version

EventsEnhanced Premium is an add-on of this plugin: installed next to it, it replaces the previews of every detail page with three reports:

• Page URLs and Page titles where the selected events were actually triggered.
• Countries of the visitors who triggered them.
• Custom Dimensions: values of your action-scoped Custom Dimensions for the selected events.

Requirements

• Matomo 6.x (6.0.0 or later, below 7.0.0)
• PHP 8.1 or later
• The Events plugin (bundled with Matomo and enabled by default).

Installation / Configuration

1. Install EventsEnhanced from the Marketplace (Administration > Platform > Marketplace), or copy the EventsEnhanced folder into the plugins directory of your Matomo installation.
2. Activate it in Administration > Plugins.
3. Open Behavior > Events, hover a row of any Events report and click the "View Event Details" icon.

There are no settings. Reports are built during archiving, so data appears for periods archived after activation. To see past periods, or to get the corrected numbers of this version for periods archived before an update, invalidate and re-archive them, for every period type (the default of the command), for example ./console core:invalidate-report-data --sites=1 --dates=2025-01-01,2025-12-31 --plugin=EventsEnhanced then ./console core:archive.

Privacy and data

All reports are computed inside your Matomo database from the events you already track. The plugin sends no data to third parties.

Need help with Matomo?

Openmost is an official Matomo Implementation Partner. Event reports are only as useful as the tracking behind them: we design Matomo tracking plans with consistent event naming, goals and custom dimensions, then implement them in your tag manager.

Support

• Email: ronan@openmost.com
• Homepage: https://openmost.com/matomo/extensions/events-enhanced
• Issues: https://github.com/openmost/EventsEnhanced/issues

Screenshots

Screenshots of the Events reports and of an event detail page are available in the screenshots folder and on the Marketplace.

License

GPL v3 or later