Matomo
Matomo is an open-source, privacy-focused web analytics
platform that works self-hosted or in Matomo Cloud. This destination forwards
walkerOS events to Matomo via the _paq command queue with support for page
views, custom events, ecommerce, goals, site search, content tracking, and
custom dimensions.
Matomo is a web destination in the walkerOS flow:
Installation
- Integrated
- Bundled
Configuration
This destination uses the standard destination config wrapper (consent, data, env, id, ...). For the shared fields see destination configuration. Package-specific fields live under config.settings and are listed below.
Settings
| Property | Type | Description | More |
|---|---|---|---|
siteId | string | Matomo Site ID | |
url | string | Base URL of your Matomo instance | |
disableCookies | boolean | Disable all tracking cookies for cookie-free analytics | |
enableLinkTracking | boolean | Enable automatic outlink and download tracking | |
enableHeartBeatTimer | integer | Enable heart beat timer with interval in seconds for accurate time-on-page | |
customDimensions | Record<string, string> | Custom dimension ID to property path mapping applied to all events |
Mapping
Per-event rules under config.mapping. For the standard rule fields (consent, condition, data, batch, name, policy) see mapping.
| Property | Type | Description | More |
|---|---|---|---|
goalId | string | Goal ID to track a conversion alongside this event | |
goalValue | string | Property path for goal revenue value | |
siteSearch | boolean | Track as internal site search using trackSiteSearch | |
contentImpression | boolean | Track as content impression using trackContentImpression | |
contentInteraction | boolean | Track as content interaction using trackContentInteraction | |
customDimensions | Record<string, string> | Per-event custom dimension ID to property path mapping |
Examples
Custom event with goal
A promotion visible event fires Matomo trackEvent and then trackGoal to record a goal conversion.
Cart update
A cart view calls Matomo trackEcommerceCartUpdate with the nested product items and cart total.
Ecommerce order
A completed order calls Matomo trackEcommerceOrder with line items and order totals.
Goal with value
A promotion event fires Matomo trackEvent and then trackGoal with a monetary goal value from event data.
Initialization
Destination bootstrap loads the Matomo tracker script and configures the tracker URL and site id.
Page view
A page view is tracked in Matomo via trackPageView with the page title from event data.
Product detail view
A product view fires Matomo ecommerceProductDetailView with a single-product array.
Site search
A search submit fires Matomo trackSiteSearch with the keyword, category, and number of results.