Shopware 6-plugin

MetriXs heeft een officiële Shopware 6-plugin die de tracker op elke pagina van je shop toevoegt en je shop automatisch verifieert. Het blijft strikt opt-in: er wordt niets geladen totdat je het verbindt. Geen thema-bewerking, geen Twig-snippets, geen cookiebanner.

Deze handleiding doorloopt de volledige installatie, stap voor stap.

Opmerking

De plugin ondersteunt zelf gehost Shopware 6 (6.5 en 6.6). Shopware Cloud-shops gebruiken een ander extensiesysteem (“apps”) en worden nog niet ondersteund.

Voordat je begint

Je hebt een MetriXs-account nodig. De plugin zelf is gratis en volledig functioneel; een gratis MetriXs-abonnement 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 shop toe in MetriXs

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

Stap 2: maak een site-API-key aan

De plugin authenticeert met een site-gebonden API-key. Deze geeft alleen toegang tot die ene shop (stats:read + event:write), nooit tot je account, en kan op elk moment worden ingetrokken.

1. Ga in het dashboard naar Instellingen → Sites
2. Vouw je shop uit en zoek de sectie API-keys
3. Klik op API-key maken en geef een naam, bijv. “Shopware”
4. Kopieer de key (mtx_live_...) direct — hij wordt maar één keer getoond en is later niet meer op te halen

Stap 3: installeer de plugin

1. Download de nieuwste plugin-ZIP van de GitHub-releasespagina (metrixs-mxcoan-X.Y.Z.zip)
2. Ga in de Shopware-administratie naar Extensies → Mijn extensies
3. Klik op Extensie uploaden en selecteer het ZIP-bestand

De plugin is getest op Shopware 6.5 en 6.6 (zelf gehost).

Stap 4: configureer de plugin

Ga in de Shopware-administratie naar Extensies → Mijn extensies → MX Cookieless Analytics → Configureren:

Of klik op Connect with MetriXs: het MetriXs-dashboard opent, waar je je account maakt (of opent), en de shop wordt toegevoegd, geverifieerd en tracking automatisch aangezet. Zonder API-key te kopiëren.

Veld	Wat je invult
Enable tracking	Laat voorlopig uit — zet aan na verificatie
Site API key	De key uit stap 2
MetriXs API URL	Laat de standaardwaarde https://app.metrixs.eu staan

Klik op Opslaan. De plugin verifieert je shop automatisch bij dezelfde opslag. De verificatie draait hooguit één keer per 5 minuten — als je een fout herstelt (bijv. een verkeerde key), wacht even en sla opnieuw op.

Zet daarna Enable tracking aan en sla nogmaals op. Shopware bouwt de thema-cache opnieuw op bij activatie van de plugin, dus de tracker verschijnt meteen op je pagina’s.

Stap 5: controleer dat tracking werkt

1. Open je shop in een incognito-/privévenster en bezoek enkele pagina’s
2. Open het MetriXs-dashboard en bekijk de Realtime-weergave — pageviews verschijnen binnen enkele seconden

Hoe de verificatie werkt: de plugin vraagt de MetriXs-API om een eenmalige challenge-token, serveert deze vanaf je eigen domein (/mxcoan/challenge) en de API haalt hem terug. Alleen iemand die je domein beheerst kan de token serveren, waarmee eigendom is bewezen. De token wordt na de handshake weer verwijderd.

Bestellingen en omzet

Zodra de plugin verbonden is, komen voltooide bestellingen vanzelf: de plugin meldt een bestelling zodra de transactie op Betaald staat, en MetriXs telt die als conversie — dus omzet- en conversieweiden vullen zich zonder extra instelling. Elke melding bevat het brutobedrag, de valuta, het ordernummer en de regels (naam, prijs, aantal). Persoonlijke gegevens gaan er niet mee — geen naam, adres, e-mail of bestellink.

Een bestelling wordt één keer gemeld, ook als hij later wordt terugbetaald of van status verandert. Is MetriXs even onbereikbaar, dan raakt de melding niet kwijt: hij volgt bij de eerstvolgende statuswijziging.

Opmerking

Meerdere verkoopkanalen op verschillende domeinen? Alleen het domein dat bij de handshake is geverifieerd, wordt geïnjecteerd. Voeg de andere domeinen toe in MetriXs en gebruik per domein een plugin of het snippet.

Instellingenreferentie

Instelling	Standaard	Betekenis
Enable tracking	Uit	Hoofdschakelaar — er wordt niets geladen totdat de shop is verbonden en dit aan staat
Site API key	—	Site-gebonden key uit het dashboard
MetriXs API URL	https://app.metrixs.eu	Alleen wijzigen voor eigen endpoints

Het tracker-script wordt geserveerd vanaf app.metrixs.eu met een URL met versie, geïnjecteerd in de <head> van elke pagina en asynchroon (defer) geladen. Het werkt prima naast Shopwares HTTP-cache en full-page caching: de plugin leegt de cache bij het verbinden.

Problemen oplossen

Verificatie mislukt

• Zorg dat de shop publiekelijk 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 op van het publieke domein van je shop
• Sla de instellingenpagina opnieuw op: de plugin herhaalt de verificatie (hooguit één keer per 5 minuten)

Geen data in het dashboard

• Enable tracking moet aan staan en de shop moet verbonden (geverifieerd) zijn
• Het domein moet exact overeenkomen met het domein in MetriXs (zonder www., zonder https://)
• Je brows als admin in je eigen shop? Storefront-bezoeken tellen als elke andere bezoeker — test vanuit een incognitovenster als je alleen je eigen traffic ziet
• Full-page cache in gebruik? De plugin leegt deze bij het verbinden; als je tracking aanzette zonder opnieuw te verbinden, leeg de cache handmatig

Omzet blijft op nul

• Bestellingen hebben geen instelling nodig, wel een verbonden shop: de plugin zet bij het verifiëren de commerce-functie van de site aan
• Alleen transacties die Betaald erreichen tellen; bestellingen “in bewerking” nog niet

API-key kwijt Keys zijn na aanmaak niet meer op te halen. Trek de oude in in het dashboard (Instellingen → Sites → API-keys), maak een nieuwe aan en vul die in bij de plugin-instellingen.

Deïnstalleren

Als je de plugin deïnstalleert:

• Je shop wordt in MetriXs automatisch als losgekoppeld gemarkeerd (events worden niet meer geaccepteerd)
• Je historische data blijft in je MetriXs-account
• De plugin-instellingen worden uit je database verwijderd

Liever zonder plugin?

Je kunt de tracker altijd handmatig toevoegen met het snippet uit de platformgidsen — de plugin automatiseert alleen installatie, verificatie en cache-afhandeling.