PrestaShop-module

MetriXs heeft een officiële PrestaShop-module die de tracker op elke pagina van je winkel zet, je winkel automatisch verifieert en order_completed-events server-side verstuurt — omzet, gemiddelde orderwaarde, conversieratio en topproducten komen zo in je MetriXs-dashboard, inclusief bestellingen via omleidingsbetalingsmethoden zoals iDEAL of Carte Bancaire. Geen themabewerking, geen code, geen cookiemelding.

Deze guide loopt door de complete installatie, stap voor stap.

Voordat je begint

Je hebt een MetriXs-account nodig. De module zelf is gratis en volledig functioneel; het gratis MetriXs-plan is genoeg om te starten.

1. Ga naar app.metrixs.eu en registreer je
2. Bevestig je e-mailadres via de link die je ontvangt

Stap 1: voeg je winkel toe in MetriXs

1. Log in op het MetriXs-dashboard
2. Voeg tijdens het onboarding (of via Instellingen → Sites) het domein van je winkel toe, bijv. jouwshop.nl — zonder https:// en zonder www.
3. Sla de snippet-verificatiestap van het dashboard over — de module verifieert je winkel automatisch in stap 5
4. Start indien gevraagd een proefperiode of kies het gratis plan (events vereisen een actief plan)

Stap 2: maak een sitesleutel aan

De module authenticiteert met een sitespecifieke API-sleutel. Die geeft alleen toegang tot deze ene winkel (stats:read + event:write), nooit tot je account, en is op elk moment in te trekken.

1. Ga in het dashboard naar Instellingen → Sites
2. Vouw je winkel uit en zoek het gedeelte API-sleutels
3. Klik op Create API key en geef hem een naam, bijv. “PrestaShop”
4. Kopieer de sleutel (mtx_live_...) meteen — hij wordt één keer getoond en is later niet meer op te halen

Stap 3: installeer de module

1. Download de nieuwste module-ZIP van de GitHub-releases-pagina (mx-cookieless-analytics-X.Y.Z.zip)
2. Ga in de backoffice naar Modules → Modulebeheer
3. Klik op Module uploaden, selecteer de ZIP en wacht op de bevestiging

Alternatief: pak hem uit in de modules/-map van je PrestaShop-installatie (de mapnaam moet mx_cookieless_analytics blijven).

Stap 4: configureer de module

Ga naar Modules → Modulebeheer, zoek MX Cookieless Analytics en klik op Configureren:

Veld	Wat in te vullen
Enable tracking	Laat voorlopig uit — aanzetten na verificatie (stap 5)
Site API key	De sleutel uit stap 2
MetriXs URL	Laat de standaardwaarde https://app.metrixs.eu staan
Shop domain	Laat leeg voor automatische detectie
Exclude logged-in customers	Standaard aan — je eigen bezoeken tellen niet

Klik op Opslaan. De verificatie start automatisch met hetzelfde opslaan.

Stap 5: verbind en verifieer

Dit vervangt handmatige verificatie — maar één keer nodig.

1. Na het opslaan vraagt de module de MetriXs-API om een eenmalige challangetoken en verifieert je winkel automatisch
2. Je ziet de groene bevestiging “shop verified”
3. In het MetriXs-dashboard staat je winkel nu op Verified
4. Zet Enable tracking aan en sla opnieuw op

Hoe het werkt: de module vraagt de MetriXs-API om een eenmalige token, servet hem vanaf je eigen domein en de API haalt hem terug. Alleen iemand die jouw domein beheert kan de token serveren — dat bewijst eigendom zonder

Stap 6: controleer of tracking werkt

1. Open je winkel in een incognitovenster en bezoek een paar pagina’s
2. Open het MetriXs-dashboard en check de Realtime-weergave — pageviews moeten binnen enkele seconden verschijnen

Let op: ingelogde klanten zijn standaard uitgesloten. Test in incognitomodus of pas de uitsluiting aan in de module-instellingen.

Ordertracking (inbegrepen)

Elke gevalideerde bestelling wordt server-side verstuurd, precies bij aanmaak — onafhankelijk van de betalingsflow, dus omleidingsbetalingsmethoden (iDEAL, Carte Bancaire, bankoverschrijving) worden betrouwbaar gemeten. Een bedankt-pagina-script dat bij verversen dubbel telt is niet nodig.

Elke bestelling komt binnen als order_completed-event met het betaalde totaal (incl. btw), de valuta, de orderregels en de winkelwagenregel-code.

Zodra je een testbestelling plaatst, toont het MetriXs-dashboard:

• Omzet, gemiddelde orderwaarde en conversieratio
• De checkout-trechter en topproducten op omzet
• Een kortingscode-ranking als je winkelwagenregels met codes gebruikt

Eén extra stap om de commerce-panelen te zien:

1. Ga in het dashboard naar Instellingen → Sites
2. Vouw je winkel uit en zet de Commerce-schakelaar aan

De omzet wordt automatisch met dagelijkse ECB-koersen naar EUR omgerekend en in jouw gekozen weergavevaluta getoond.

Instellingenreferentie

Instelling	Standaard	Betekenis
Enable tracking	Uit	Hoofdschakelaar — er wordt niets geladen tot de winkel verbonden is en dit aan staat
Site API key	—	Sitespecifieke sleutel uit het dashboard
MetriXs URL	https://app.metrixs.eu	Alleen wijzigen voor eigen endpoints
Shop domain	Leeg (auto)	Moet overeenkomen met het domein in MetriXs
Exclude logged-in customers	Aan	Ingelogde klantaccounts niet volgen

Problemen oplossen

Verificatie mislukt

• Zorg dat de winkel openbaar bereikbaar is via HTTPS (geen onderhoudsmodus, geen firewall die de MetriXs-servers blokkeert)
• Controleer hostingbeveiligingsmodules die onbekende bots blokkeren — de MetriXs-API haalt de challenge-URL van je winkel op
• Sla de instellingenpagina opnieuw op: de module probeert het opnieuw (maximaal één keer per 5 minuten)

Geen data in het dashboard

• De instellingenpagina moet de “shop verified”-bevestiging tonen
• Enable tracking moet aan staan
• Het winkeldomein moet exact overeenkomen met het domein in MetriXs (zonder www., zonder https://)
• Ben je ingelogd als klant? Standaard uitgesloten — test incognito
• Volledige page cache actief? Spoel hem door zodat het tracker-script op je pagina’s landt

Geen omzet in het dashboard

• Plaats een testbestelling en check het order_completed-event in de Realtime-weergave
• Zet de Commerce-schakelaar van de site aan (Instellingen → Sites) — zonder hem zijn de omzetpanelen verborgen

API-sleutel kwijt Sleutels zijn na aanmaak niet op te halen. Trek de oude in het dashboard in (Instellingen → Sites → API-sleutels), maak een nieuwe aan en vul die in de module in.

Deinstalleren

Als je de module deïnstalleert:

• Je winkel wordt automatisch als ontkoppeld gemarkeerd in MetriXs (events worden niet meer geaccepteerd)
• Je historische gegevens blijven in je MetriXs-account
• De module-instellingen worden uit je database verwijderd

Liever zonder module?

Je kunt de tracker altijd handmatig toevoegen met het fragment uit de platformguides — de module automatiseert alleen installatie, verificatie en ordertracking.