Matomo Analytics

Server-side event delivery to Matomo Analytics via the Tracking API. Matomo is an open-source, self-hostable alternative to Google Analytics with strong GDPR posture — particularly popular with EU-regulated organisations that want full data sovereignty.

⚠️

Status: alpha. The Matomo integration is catalogued and publishable but ships without a pre-built preset in the current release. Event mappings need to be configured manually per pipeline. A preset with standard page and e-commerce events is planned for the next blueprint release.

Prerequisites

A Matomo instance. Either:
- Matomo Cloud: your cloud subdomain (e.g. analytics.yourcompany.matomo.cloud).
- Self-hosted Matomo: the URL of your deployed instance.
The Site ID (idsite) of the Matomo site you want events delivered to. Find it in Matomo under Administration > Measurables/Websites.
Optional: a Matomo auth token (token_auth) if you need to set custom visitor IDs or override the IP address used for GeoIP lookup. Find it under My Profile > Security.

Configuration fields

Field	Required	Notes
`instance_url`	Yes	Matomo instance URL, no trailing slash.
`site_id`	Yes	Matomo Site ID (numeric).
`auth_token`	No	`token_auth` from Matomo. Only required for advanced features.

Endpoint

Events are delivered to:

POST {instance_url}/matomo.php

Following the Matomo Tracking HTTP API spec.

Next steps

Enable the Matomo integration on a pipeline in the Management UI.
Map your page and custom events to the Matomo parameter names (url, action_name, e_c, e_a, e_n, e_v, etc.).
For GDPR compliance reporting, configure the pipeline to strip any fields Matomo does not need.

Heap Microsoft Clarity