PrestaShop module

MetriXs has a first-party PrestaShop module that adds the tracker to every page of your shop, verifies your shop automatically, and sends order_completed events server-side — so revenue, average order value, conversion rate and top products land in your MetriXs dashboard, including orders paid through redirect methods like iDEAL or Carte Bancaire. No theme editing, no code, no consent banner.

This guide walks through the full setup, step by step.

Before you start

You need a MetriXs account. The module itself is free and fully functional; a free MetriXs plan is enough to get started.

1. Go to app.metrixs.eu and sign up
2. Verify your email address via the link you receive

Step 1: Add your shop in MetriXs

1. Log in to the MetriXs dashboard
2. During onboarding (or via Settings → Sites), add your shop’s domain, e.g. yourshop.com — without https:// and without www.
3. Skip the dashboard’s snippet verification step — the module verifies your shop automatically in step 5
4. If prompted, start a trial or pick the free plan (events require an active plan)

Step 2: Create a site API key

The module authenticates with a site-scoped API key. It only grants access to that one shop (stats:read + event:write), never to your account, and can be revoked at any time.

1. In the dashboard, go to Settings → Sites
2. Expand your shop and find the API keys section
3. Click Create API key and give it a name, e.g. “PrestaShop”
4. Copy the key (mtx_live_...) immediately — it is shown once and cannot be retrieved later

Step 3: Install the module

1. Download the latest module ZIP from the GitHub releases page (mx-cookieless-analytics-X.Y.Z.zip)
2. In your shop’s back office, go to Modules → Module Manager
3. Click Upload a module, select the ZIP, and wait for the confirmation

Alternatively, unzip it into the modules/ directory of your PrestaShop installation (folder name must stay mx_cookieless_analytics).

Step 4: Configure the module

In Modules → Module Manager, find MX Cookieless Analytics and click Configure:

Field	What to enter
Enable tracking	Leave off for now — turn on after verification (step 5)
Site API key	The key from step 2
MetriXs URL	Leave at the default https://app.metrixs.eu
Shop domain	Leave empty to auto-detect from this shop
Exclude logged-in customers	On by default — your own visits don’t count

Click Save. Verification starts automatically with the same save.

Step 5: Connect and verify

This replaces manual verification — it only needs to be done once.

1. After saving, the module asks the MetriXs API for a one-time challenge token and verifies your shop automatically
2. You should see the green notice “shop verified”
3. In the MetriXs dashboard, your shop now shows as Verified
4. Turn Enable tracking on and save again

How it works: the module asks the MetriXs API for a one-time challenge token, serves it from your own domain, and the API fetches it back. Only someone who controls your domain can serve the token, so this proves ownership.

Step 6: Verify tracking works

1. Open your shop in an incognito/private window and browse a few pages
2. Open the MetriXs dashboard and check the Realtime view — pageviews should appear within seconds

Note: logged-in customers are excluded from tracking by default. Test from an incognito window or adjust the exclusion in the module settings.

Order tracking (included)

Every validated order is sent server-side the moment it is created — independent of the payment flow, so redirect-based payment methods (iDEAL, Carte Bancaire, bank transfer) are captured reliably. Thank-you-page scripts that re-fire on refresh are not needed.

Each order lands as an order_completed event with the paid total (tax included), the currency, the line items and the cart-rule discount code.

Once you place a test order, the MetriXs dashboard shows:

• Revenue, Average Order Value and conversion rate
• The checkout funnel and top products by revenue
• A discount-code ranking when you use cart rules with codes

One extra step is needed to see the commerce panels:

1. In the dashboard, go to Settings → Sites
2. Expand your shop and turn on the Commerce toggle

Revenue is converted to EUR automatically using daily ECB rates and displayed in your chosen display currency.

Settings reference

Setting	Default	Meaning
Enable tracking	Off	Master switch — nothing loads until the shop is connected and this is on
Site API key	—	Site-scoped key from the dashboard
MetriXs URL	https://app.metrixs.eu	Only change for custom endpoints
Shop domain	Empty (auto)	Must match the domain in MetriXs
Exclude logged-in customers	On	Don’t track logged-in customer accounts

Troubleshooting

Verification fails

• Make sure the shop is publicly reachable over HTTPS (no maintenance mode, no firewall blocking the MetriXs servers)
• Check for hosting security modules that block unknown bots — the MetriXs API fetches the challenge URL from your shop’s public domain
• Save the settings page again: the module retries verification (at most once every 5 minutes)

No data in the dashboard

• The settings page must show the “shop verified” confirmation
• Enable tracking must be on
• The shop domain must exactly match the domain in MetriXs (no www., no https://)
• You are logged in as a customer? You’re excluded by default — test incognito
• Using a full-page cache? Purge it so the tracker script lands on your pages

No revenue in the dashboard

• Place a test order and check the Realtime view for the order_completed event
• Turn on the Commerce toggle for the site (Settings → Sites) — the revenue panels are hidden without it

API key lost Keys cannot be retrieved after creation. Revoke the old one in the dashboard (Settings → Sites → API keys), create a new one, and update it in the module settings.

Uninstalling

When you uninstall the module:

• Your shop is automatically marked disconnected in MetriXs (events stop being accepted)
• Your historical data stays in your MetriXs account
• The module’s settings are removed from your database

Prefer no module?

You can always add the tracker manually with the snippet from the platform guides — the module simply automates installation, verification and order tracking.