Kukie.io integrates directly with Matomo (formerly Piwik), the leading open-source web analytics platform. When enabled, the banner script injects the Matomo tracking code and manages consent-aware tracking based on your consent model and the visitor's choices.
Configuring the Matomo Integration
In the Banner Editor, go to the Integrations tab and find the Matomo section. Enter two values:
- Matomo Tracker URL - the full URL to your Matomo installation, including the protocol. For example:
https://analytics.example.com. Do not include a trailing slash or thematomo.jspath - the banner script appends the correct paths automatically. - Matomo Site ID - the numeric site ID assigned by Matomo. You can find this in your Matomo dashboard under Settings → Websites → Manage.
Toggle Matomo Integration to on and click Save.
Tip: The Matomo tracker URL must be publicly accessible over HTTPS. The banner script loads the Matomo JavaScript tracker from this URL, so it must be reachable from your visitors' browsers.
Consent-Aware Tracking
The Matomo integration adapts its behaviour based on the consent model configured for the visitor's region:
Opt-in Mode (GDPR)
In opt-in regions, the banner script loads the Matomo tracker but calls _paq.push(['requireConsent']) before any tracking occurs. This tells Matomo to wait for explicit consent before storing cookies or recording visits.
When the visitor accepts the Analytics category, the banner fires _paq.push(['setConsentGiven']), and Matomo begins full tracking. If the visitor rejects analytics, Matomo never records the visit.
Opt-out Mode (CCPA)
In opt-out regions, Matomo starts tracking immediately when the page loads - no requireConsent call is made. If the visitor later opts out of the Analytics category, the banner fires _paq.push(['forgetConsentGiven']) to stop tracking and remove Matomo's cookies.
Notice Only and Hidden Modes
In these modes, Matomo tracks immediately without requiring consent, since the consent model does not restrict cookie usage.
What Matomo Tracks
When consent is given (or not required), the Matomo integration records:
- Page views and navigation paths.
- Referrer information.
- Visit duration and bounce rate.
- Browser, device, and operating system data.
- Geographic location (based on IP, if configured in Matomo).
All data is stored in your own Matomo instance - no data is sent to Kukie.io or any third party. This makes Matomo a popular choice for organisations that want full control over their analytics data.
Matomo Cloud vs Self-Hosted
The Kukie.io integration works with both Matomo Cloud and self-hosted Matomo installations. The only requirement is that the tracker URL is accessible over HTTPS from your visitors' browsers.
For self-hosted installations, make sure your Matomo server allows cross-origin requests from your website's domain, or that both run on the same domain.
Removing Manual Tracking Code
If you are currently using a manually embedded Matomo tracking snippet, remove it from your site's HTML after enabling the Kukie.io integration. Running both simultaneously will result in double-counted page views.
Important: Unlike Google Analytics, Matomo does not use Google Consent Mode. The Matomo integration has its own consent management via the
requireConsent/setConsentGivenAPI. Make sure you do not rely on GCM parameters for Matomo tracking decisions.