Deutsche Version

Back to overview

Matomo Analytics: Troubleshooting

Live Demo: Try this and other plugins live — no installation, no risk: demo.markus-michalski.net

The tracking code does not appear in the page source

Check in this order:

1. Was the module activated with vendor/bin/oe-console oe:module:activate mmd_matomo_analytics?
2. Is Enable tracking on, is the Matomo URL a valid https:// URL and the Site ID greater than 0? An http:// URL is not accepted.
3. Is Respect Do-Not-Track on and does your browser send DNT: 1? Then the module delivers no code without the Klaro integration.
4. Is Require consent on, cookieless tracking off and Klaro off? Then the module needs one of the consent cookies with a positive value, see Privacy and Consent.
5. Does your shop use the Apex theme? For other themes you have to extend the blocks yourself, see Storefront and Templates.
6. Clear the cache: vendor/bin/oe-console oe:cache:clear

No data in Matomo

1. Check the browser console for JavaScript errors.
2. Compare the site ID with the site ID in Matomo.
3. Check whether your IP address is excluded in Matomo or an ad blocker blocks Matomo.
4. Is Require consent on without Klaro? The module outputs requireConsent but no setConsentGiven. Matomo then sends nothing until your own script reports the consent.

Klaro integration does not work

1. Does the Klaro service name match the name of the Klaro service exactly?
2. Does the page source show type="text/plain" on the tracking script and data-name with the service name?
3. Has the visitor consented to the service? Only then does Klaro execute the script.
4. Clear the cache after changing settings.

E-Commerce tracking does not work

1. Are Enable E-Commerce tracking and the individual switch on?
2. Orders: is the code output on the confirmation page? It is output only once per order. Reloading the page does not send the order again.
3. Product views: the code is only output when the current page provides a product.

Known limitations

• IP anonymization: The setting has no effect. Anonymize IP addresses in your Matomo installation.
• Cart tracking: It is not event-based. Every page with a non-empty cart sends a cart update.
• Links and downloads: Both switches control the same enableLinkTracking call and cannot be turned off individually.
• Themes: Tracking templates exist for Apex only.
• Consent without Klaro: The module never reports setConsentGiven by itself.
• Opt-out widget: It shows the iframe even when tracking is off, as soon as a Matomo URL is saved.