Aangepaste events

Naast automatische pageviews volgt MetriXs aangepaste events, alles wat u wilt meten: button-kliks, formulier-inzendingen, video-afspeelacties, aanmeldingen, aankopen. Aangepaste events dragen eigen eigenschappen die u kunt koppelen, en het dashboard splitst ze voor u uit.

Aangepaste events verzenden

Vuurt een aangepast event af vanaf uw site met de globale metrixs()-functie (beschikbaar zodra het tracker-script is geladen):

// Een aangepast event met eigenschappen
metrixs('Signup', { props: { plan: 'pro', location: 'hero' } })

Optie	Type	Standaard	Beschrijving
name	string	—	De event-naam. Gebruik 'pageview' voor een handmatige pageview.
props	object	{}	Aangepaste eigenschappen om aan het event te koppelen.
url	string	location.href	Overschrijf de pagina-URL die voor dit event wordt vastgelegd (handig voor SPA-route-wijzigingen).
interactive	boolean	true	Stel in op false voor passieve signalen die niet mogen tellen als echte interactie (zodat ze het bouncepercentage niet verlagen). De ingebouwde scroll-diepte-/engagement-events gebruiken dit.
callback	function	—	Aangeroepen nadat het event is verzonden.

// Niet-interactief signaal, verlengt bezoekduur zonder bouncepercentage te beinvloeden
metrixs('scroll_to_bottom', { props: { article: 'gdpr' }, interactive: false })

Aangepaste events die tijdens een bezoek worden afgevuurd, verlengen ook de gemeten duur, omdat duur wordt berekend als de tijd tussen de eerste pageview en het laatste event. Zie Bezoekduur voor waar dit belangrijk is.

Automatisch getrackte events

De tracker legt automatisch drie event-types vast, geen setup vereist:

Event-naam	Wanneer het afvuurt	Eigenschap
Outbound Link: Click	Een bezoeker klikt op een link naar een extern domein	url
File Download	Een bezoeker klikt op een link naar een bestand (pdf, zip, mp4, docx, …)	url
404	Een 404-pagina, alleen als de pagina <meta name="metrixs:404" content="true"> instelt	path

Deze verschijnen in het dashboard in hun eigen Automatisch getrackte events-kaart, gescheiden van uw aangepaste events, zodat uw aangepaste events schoon blijven.

De lite-tracker (tracker.lite.js) laat automatische tracking weg, alleen pageviews. Gebruik de volledige tracker.js als u uitgaande links, downloads en 404s wilt vastleggen.

Aangepaste events in het dashboard bekijken

Het dashboard toont twee kaarten (alleen als de site aangepaste events heeft, ze verbergen zich anders, dus geen rommel op sites die ze niet gebruiken):

• Aangepaste events, uw door de gebruiker gedefinieerde events.
• Automatisch getrackte events, uitgaande links, bestanddownloads en 404s.

Elke rij toont de event-naam en hoe vaak het afgevuurd is, met een balk geschaald naar het top-event. Klik op een rij om deze uit te vouwen en de eigenschappen-uitsplitsing te zien, elke eigenschapssleutel met zijn topwaarden en aantallen.

Klikken op een eigenschapswaarde (bijv. plan = pro) filtert het hele dashboard naar dat segment, net als klikken op een pagina of een land. Verwijder het filter vanuit de filterbalk bovenaan.

Hoe eigenschappen worden opgeslagen

Aangepaste event-eigenschappen worden in ClickHouse opgeslagen als parallelle meta.key-/meta.value-arrays (een rij per event). Het dashboard ontdekt de eigenschapssleutels per event met een speciaal POST /api/v2/event-props-endpoint (de hoofd-query-builder kan onbekende sleutels niet opsommen), en leest elke waarde via de event:props:<key>-dimensie. Eigenschapssleutels zijn beperkt tot ^[a-zA-Z0-9_-]+$, houd u aan letters, cijfers, streepjes en underscores.