WordPress-plugin

MetriXs heeft een officiële WordPress-plugin die de tracker aan elke pagina toevoegt, je site automatisch verifieert () en WooCommerce-omzet serverzijde kan meten. Geen child-theme, geen code bewerken, geen cookiebanner.

Deze handleiding doorloopt de volledige installatie, stap voor stap.

Voordat je begint

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

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

Stap 1: Voeg je site toe in MetriXs

1. Log in op het MetriXs-dashboard
2. Tijdens de onboarding (of via Settings → Sites) voeg je het domein van je site toe, bijv. jouw Domein.nl — zonder https:// en zonder www.
3. Sla de snippet-verificatiestap van het dashboard over — de plugin verifieert je site automatisch in stap 5
4. Start eventueel een trial of kies het gratis plan (events vereisen een actief plan)

Stap 2: Maak een site-API-key aan

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

1. Ga in het dashboard naar Settings → Sites
2. Klap je site uit en zoek de sectie API keys
3. Klik op API-key aanmaken en geef hem een naam, bijv. “WordPress”
4. Kopieer de key (mtx_live_...) direct — hij wordt maar één keer getoond en kan later niet meer worden opgevraagd

Stap 3: Installeer de plugin

Via je WordPress-admin:

1. Ga naar Plugins → Nieuwe plugin
2. Zoek op “MetriXs Analytics”
3. Klik op Nu installeren en daarna op Activeren

Stap 4: Configureer de plugin

Ga naar Instellingen → MetriXs Analytics:

Veld	Wat invullen
Site domain	Meestal al ingevuld met de hostname van je site; moet overeenkomen met het domein in MetriXs
MetriXs URL	Laat de standaardwaarde https://app.metrixs.eu staan
Site API key	De key uit stap 2

Klik op Wijzigingen opslaan.

Stap 5: Verbinden en verifiëren

Dit vervangt handmatige verificatie en hoef je maar één keer te doen.

1. Klik op dezelfde instellingenpagina op Connect & verify site
2. Je ziet de groene melding “Site connected. Tracking is live”
3. In het MetriXs-dashboard staat je site nu op Verified

Zo werkt het: de plugin vraagt een eenmalig challenge-token op bij de MetriXs API, serveert het vanaf je eigen domein, en de API haalt het weer op. Alleen wie je domein beheert kan het token serveren, dus dit bewijst eigendom

Stap 6: Controleer of tracking werkt

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

Let op: ingelogde administrators zijn standaard uitgesloten van tracking (je wilt jezelf meestal niet meetellen). Test vanuit een incognitovenster of pas de uitsluitingen aan in de plugin-instellingen.

WooCommerce (optioneel)

Gebruik je WooCommerce, zet dan omzetmeting aan:

1. Sla eerst je API-key op (stap 4)
2. Vink op de instellingenpagina van de plugin de optie WooCommerce aan
3. Sla op en klik nogmaals op Connect & verify site — dit zet commerce voor de site aan in MetriXs
4. Plaats een testbestelling om het te bevestigen

Eenmaal actief toont het MetriXs-dashboard:

• Omzet, gemiddelde orderwaarde en conversieratio
• De conversietrechter: bezoekers → checkout → betaling → bestelling
• Top producten op omzet

De events worden serverzijde verstuurd vanaf je WordPress-server, zodat redirect-gebaseerde betaalmethoden (iDEAL, Bancontact, enz.) betrouwbaar worden geregistreerd. Omzet wordt automatisch naar EUR geconverteerd met dagelijkse ECB-koersen en getoond in je gekozen weergavevaluta.

Instellingen-overzicht

Instelling	Standaard	Betekenis
Site domain	Hostname van je site	Moet overeenkomen met het domein in MetriXs
MetriXs URL	https://app.metrixs.eu	Alleen wijzigen voor custom endpoints
Site API key	—	Site-scoped key uit het dashboard
Exclude all logged-in visitors	Uit	Niemand tracken die is ingelogd
Exclude roles	Administrator aan	Kies welke rollen worden uitgesloten
WooCommerce	Uit	Server-side commerce-events

Ontwikkelaars kunnen ook de filters metrixs_settings, metrixs_script_attributes en metrixs_exclude_visitor gebruiken, of METRIXS_DISABLE_TRACKING definiëren (bijv. op staging-sites) in wp-config.php.

Problemen oplossen

Verificatie mislukt

• Controleer of je permalinks niet op “Plain” staan (Instellingen → Permalinks — kies een andere structuur en sla op; de verificatieroute heeft op sommige setups pretty permalinks nodig)
• Zorg dat je site publiek bereikbaar is (geen onderhoudsmodus, geen firewall die de MetriXs-servers blokkeert)
• Wacht een minuut en probeer opnieuw

Geen data in het dashboard

• De instellingenpagina moet “Connected” tonen
• Het domein in de plugin moet exact overeenkomen met het domein in MetriXs (geen www., geen https://)
• Ben je ingelogd als admin? Dan ben je standaard uitgesloten — test incognito
• Gebruik je een caching-plugin? Leeg de cache zodat de tracker op je pagina’s terechtkomt

API-key kwijt Keys kunnen na aanmaak niet worden opgehaald. Trek de oude in het dashboard in (Settings → Sites → API keys), maak een nieuwe aan en vul deze in bij de plugin-instellingen.

Verwijderen

Bij het deactiveren en verwijderen van de plugin:

• Je site wordt automatisch losgekoppeld in MetriXs (events worden niet meer geaccepteerd)
• Je historische data blijft gewoon bewaard in je MetriXs-account
• De opties van de plugin worden uit je WordPress-database verwijderd

Liever geen plugin?

Je kunt de tracker altijd handmatig toevoegen met het snippet uit de platform-handleidingen — de plugin automatiseert alleen installatie, verificatie en WooCommerce-tracking.