CS-Cart & Multi-Vendor Add-On

Matomo Analytics
for CS-Cart & Multi-Vendor

Own your data. Stop feeding your customers' behavior to Google. The Matomo Analytics Add-On brings full ecommerce tracking — orders, revenue, visitors, conversions — directly into CS-Cart, hosted on your server, under your control.

✓ 100% Data Ownership ✓ GDPR Compliant ✓ No Data Sampling ✓ Real-Time Reports ✓ Ecommerce Tracking
CS-Cart 4.x · Ultimate · Multi-Vendor Matomo Self-Hosted & Cloud No core file edits

01 Why Matomo — and why it beats the alternative

Every time a visitor lands on your store and Google Analytics fires, you are handing a competitor's advertising platform a detailed map of your customers. Matomo is the open-source alternative: the same depth of insight, none of the data leakage.

🔒
Your data stays yours

Matomo runs on your own server — or Matomo Cloud with EU data residency. No third party ever touches your visitor data. Not Google. Not Meta. No one.

📊
No sampling, ever

Google Analytics samples data above certain thresholds. Matomo processes every single visit, every order, every event. Your reports reflect reality — not a statistical estimate of it.

🇪🇺
GDPR-ready out of the box

Self-hosted Matomo can operate without cookies and without consent banners in many EU jurisdictions. Stop paying for consent management tools just to run basic analytics.

Real-time, every time

Watch orders arrive, track active visitors, and monitor your conversion funnel live — without waiting 24-48 hours for Google to process your data.

🛒
Built for ecommerce

Orders, revenue, items, average order value, abandoned carts, conversion rates — all tracked automatically. CS-Cart fires the right Matomo events at every step of the purchase journey.

🔌
Plug & play integration

Enter your Matomo URL and Site ID in the add-on settings and you're live. No JavaScript customization, no tag manager setup, no developer needed.

02 What the add-on tracks

The add-on injects Matomo's tracking code across your entire CS-Cart storefront and fires dedicated ecommerce events at the right moments — automatically, without any manual configuration.

Page Views
Every storefront page — product pages, category listings, CMS pages, checkout steps — tracked with full URL, title, and referrer data.
Order Completion
Fires trackEcommerceOrder on the order confirmation page with order ID, total revenue, subtotal, shipping, tax, and discount.
Order Items
Each product in the order is passed to Matomo with SKU, name, category, unit price, and quantity — populating your ecommerce item reports.
Visitor Profiles
Traffic sources, devices, browsers, operating systems, screen resolutions, and geolocation — the full visitor picture, on your server.
Cart Updates
Tracks addEcommerceItem and trackEcommerceCartUpdate events as customers add and remove products — enabling abandoned cart analysis.
Search Queries
Internal search tracking captures what customers type into your store's search box — revealing demand you may not be serving.
Goals & Conversions
Define custom goals in your Matomo dashboard — registrations, newsletter sign-ups, contact form submissions — and track conversion rates over time.
User Sessions
Session duration, bounce rate, pages per visit, return visitor rate — behavioral metrics that tell you how engaged your audience actually is.

03 Matomo vs. Google Analytics 4

If you're migrating from GA4 or evaluating alternatives, here's what matters for an ecommerce store.

FeatureGoogle Analytics 4Matomo + This Add-On
Data ownership✗ Google's servers✓ Your server
GDPR — no consent needed (self-hosted)✗ Requires consent banner✓ Possible without consent
Data sampling✗ Yes, above thresholds✓ Never — 100% data
Real-time ecommerce dataDelayed (up to 48h)✓ Real-time
Ecommerce order trackingManual GTM setup needed✓ Automatic via add-on
Cart abandonment trackingRequires custom events✓ Built-in
Data shared with ad platforms✗ Yes — feeds Google Ads✓ Never
Works without 3rd-party cookiesPartial (GA4 modeling)✓ Cookie-less mode
Data retention — unlimited✗ 14 months max (free)✓ Unlimited on self-hosted
Open source✗ Proprietary✓ GPL licensed

04 Requirements

RequirementValueNotes
CS-Cart version4.xTested on CS-Cart 4.13 through 4.20.x
Supported editionsCS-Cart, Ultimate, Multi-VendorWorks identically on all editions
Matomo version4.x, 5.xSelf-hosted Matomo (free) or Matomo Cloud
Matomo site IDRequiredFound in Matomo → Administration → Websites → Manage
Matomo URLRequiredYour Matomo instance URL, e.g. https://analytics.yourstore.com
Core file editsNoneHook-based only — upgrade-safe by design
ℹ️
Don't have Matomo yet? Download it for free at matomo.org — it installs in minutes on any standard PHP/MySQL server, the same stack your CS-Cart runs on.

05 Installation & setup

1

Purchase and download

Get the Matomo Analytics Add-On from the CS-Cart Marketplace and download the .zip archive to your computer.

2

Install via Admin Panel

In your CS-Cart admin go to Add-ons → Manage Add-ons → +, select the downloaded .zip and click Upload & Install. The add-on activates immediately.

3

Enter your Matomo URL

Go to Add-ons → Manage Add-ons → Matomo Analytics → Settings and enter the full URL of your Matomo instance — e.g. https://analytics.yourstore.com.

4

Enter your Site ID

In Matomo go to Administration → Websites → Manage and copy the Site ID for your store. Paste it into the add-on settings. Each storefront in a Multi-Vendor setup can have its own Site ID.

5

Save & verify

Click Save. Visit your storefront, then check Matomo's Real-time visitor log — your visit should appear within seconds. Tracking is live.

The tracking script loads asynchronously — it will not slow down your storefront, even if your Matomo server is temporarily unreachable.

06 Settings

All settings at Add-ons → Manage Add-ons → Matomo Analytics → Settings.

SettingDefaultDescription
Matomo URLFull URL of your Matomo instance including protocol. Example: https://analytics.yourstore.com. No trailing slash required.
Site IDThe numeric Site ID assigned to your store in Matomo. Found under Administration → Websites → Manage.
Track ecommerce ordersYesEnables automatic trackEcommerceOrder events on the order confirmation page with full order value, items, and revenue data.
Track cart updatesYesFires cart update events when customers add or remove items — required for cart abandonment analysis in Matomo.
Cookie-less trackingNoDisables Matomo's tracking cookies. Visitors are tracked via fingerprinting only. Useful for cookie-consent-free operation in certain EU contexts — consult your legal team.
Track admin panelNoWhen enabled, admin panel activity is also tracked. Disabled by default to keep analytics clean of internal traffic.
Respect Do Not TrackYesHonors the browser's DNT header. Recommended for GDPR compliance.

07 Ecommerce tracking — what you see in Matomo

Once the add-on is installed and configured, your Matomo ecommerce reports populate automatically. Here's what becomes available in your Matomo dashboard without any additional setup.

💰
Revenue & orders overview
Total revenue, number of orders, average order value, and revenue per visit — all in a single Matomo ecommerce dashboard, updated in real time.
🛍️
Top products report
Which products drive the most revenue? The Matomo products report ranks every item by orders, quantity sold, and revenue — directly from your CS-Cart order data.
📂
Category performance
Revenue broken down by product category. Identify your most profitable categories and spot underperformers — without building custom reports.
🔄
Abandoned cart analysis
See which products are being added to carts but never purchased. Calculate your cart abandonment rate and identify friction in your checkout funnel.
📈
Conversion funnel
Track the full path from first visit to order confirmation. See exactly where customers drop off — product page, cart, checkout step — and fix the bottlenecks.
🌍
Traffic & acquisition
Where are your buyers coming from? Organic search, direct, referral, email campaigns — Matomo segments revenue by acquisition channel so you know what's working.
💡
Matomo's ecommerce reports are available under E-Commerce → Overview in your Matomo dashboard. The data appears within minutes of your first tracked order.

08 GDPR & privacy compliance

Privacy compliance is not an add-on feature — it's the entire point of choosing Matomo. Here's how the add-on supports your compliance obligations.

Compliance aspectHow it works
Data residencyAll analytics data is stored on your own server (self-hosted) or Matomo Cloud's EU region. No data ever flows to Google, Meta, or US-based infrastructure.
IP anonymizationMatomo anonymizes visitor IP addresses by default. The last two octets are masked before storage — visitor IPs are never stored in full.
Cookie-less trackingEnable the cookie-less tracking setting to operate without any tracking cookies. In many EU jurisdictions this removes the need for a consent banner entirely — verify with your legal counsel.
Do Not TrackThe add-on honors the browser's DNT signal by default. Visitors who have enabled DNT are not tracked.
Data deletionYou control data retention in Matomo — set automatic deletion periods or remove specific visitors on request to fulfill GDPR right-to-erasure obligations.
No data sharingMatomo does not share data with advertising networks, data brokers, or any third party. Your customer behavior data feeds your analytics — nothing else.
⚠️
Cookie-less tracking and consent requirements vary by jurisdiction. Always confirm your specific setup with qualified legal counsel before removing consent banners.

09 Multi-Vendor support

The add-on works identically on CS-Cart Multi-Vendor. Visitor tracking and ecommerce events are captured across all vendor storefronts without any additional configuration.

AspectDetails
Single Matomo instanceAll storefronts can report to a single Matomo site — giving you a unified view of your marketplace's total traffic and revenue.
Per-storefront trackingAlternatively, assign a different Site ID per vendor storefront to analyze each vendor's traffic and sales in isolation within Matomo.
Order trackingOrders from all vendors are tracked through the standard CS-Cart order confirmation hook — no per-vendor configuration needed.
Vendor admin accessAnalytics configuration is handled from the root CS-Cart admin. Individual vendors do not have access to the Matomo settings.

10 Use cases

Replacing Google Analytics with full data ownership

Install the add-on, enter your Matomo credentials, and disable Google Analytics on your store. Your customer data stays on your infrastructure permanently. You retain full history — not the 14-month cap Google imposes on free accounts. Reports that previously required GA4 exploration become standard Matomo dashboard views.

Identifying your best-converting traffic sources

Matomo's acquisition reports segment revenue by channel — organic search, direct, referral, email, paid. Unlike GA4, these reports are based on 100% of your sessions, not sampled estimates. Pair this with Matomo's campaign URL builder to track the exact ROI of every email or ad campaign you run.

Finding checkout drop-off points

Set up a Matomo goal funnel with steps matching your CS-Cart checkout flow: Cart → Address → Shipping → Payment → Confirmation. The funnel report shows exactly which step loses the most customers — giving you a prioritized list of where to focus your CRO efforts.

Operating cookie-free in the EU

Enable Cookie-less tracking in the add-on settings and configure Matomo's cookie-less mode on the server side. For self-hosted Matomo tracking your own domain's visitors, many EU data protection authorities consider this setup exempt from cookie consent requirements. Remove your analytics consent banner and stop losing 20-40% of tracked visitors to consent rejection.

Multi-vendor marketplace analytics

Use a single Matomo site for your entire marketplace to benchmark total platform performance, or assign individual Site IDs per storefront to give each brand a clean analytics view. Revenue attribution works out of the box — each completed order fires the full Matomo ecommerce event with correct revenue figures regardless of which vendor fulfilled it.

11 FAQ

Do I need a Matomo account to use this add-on?
Yes. You need an active Matomo instance — either self-hosted (free, open-source, downloadable at matomo.org) or Matomo Cloud (paid, managed by Matomo). The add-on connects CS-Cart to your existing Matomo site using your Site ID and Matomo URL. The add-on does not include a Matomo license or hosting.
Is this add-on GDPR compliant?
Yes — by design. Because Matomo is self-hosted (or uses EU data residency on Matomo Cloud), all visitor data stays on your infrastructure. No data is shared with Google, Meta, or any third party. The add-on also supports cookie-less tracking and respects Do Not Track headers. For specific compliance requirements in your jurisdiction, verify your setup with qualified legal counsel.
Does the add-on track ecommerce orders automatically?
Yes. The add-on fires Matomo's ecommerce tracking events on order completion automatically — including order ID, total revenue, subtotal, shipping, tax, discount, and individual order items with SKU, name, price, and quantity. No manual JavaScript or tag manager configuration is required.
Will this slow down my store?
No. The Matomo tracking script is loaded asynchronously — it does not block page rendering or affect your storefront's load time. If your Matomo server is temporarily unreachable, the tracking simply skips without any visible effect on the storefront.
Does it work with CS-Cart Multi-Vendor?
Yes. The add-on works identically on CS-Cart Multi-Vendor. You can track all storefronts under a single Matomo site for a unified marketplace view, or assign different Site IDs per storefront for isolated vendor analytics.
Can I use this alongside an existing consent management platform?
Yes. If you have a consent management platform (CMP) on your store, you can configure the add-on to only fire tracking after consent is granted — using Matomo's built-in consent API. The add-on settings support this via the cookie-less and opt-in tracking options. Contact mokeshop support for guidance on specific CMP integrations.
What happens if I uninstall the add-on?
Uninstalling removes the add-on and all its settings from CS-Cart. The Matomo tracking code is no longer injected into your storefront. Your existing data in Matomo is not affected — it remains on your Matomo server and is accessible independently of CS-Cart.
Does the add-on modify CS-Cart core files?
No. The add-on uses CS-Cart's native hook system exclusively. No core files are modified. It is upgrade-safe — CS-Cart updates will not break the add-on or require re-installation.