How do I add the metric « Events » to a Custom report?

Unfortunately, creating a custom report specifically with the « Events » metric is not currently possible in Matomo. The best alternative available is using the « Hits » metric which counts all actions, including events.

What does the « Hits » metric count in a custom report?

The « Hits » metric in a custom report counts all actions, regardless of their type. If no filter is applied to the custom report, « Hits » will count all actions.

How does the « Hits » metric behave when a filter is applied in a custom report?

When a filter is applied in a custom report and it specifically filters for events, « Hits » will count only the event actions that match the filter. If the filter excludes other types of actions, « Hits » will reflect the count of event actions based on the applied filter. In this case, « Hits » is a close approximation to the « Events » metric.