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.

Limieten

Limiet	Waarde
Eigenschappen per event	30 (overtollige worden verwijderd)
Lengte van de eigenschapssleutel	300 tekens
Lengte van de eigenschapswaarde	2.000 tekens
Waardetypen	strings, getallen, booleans (geen objecten of arrays)

Payloads die deze limieten overschrijden worden geweigerd.

Persoonsgegevens (PII)

MetriXs slaat geen persoonsgegevens op, en dat geldt ook voor aangepaste event-eigenschappen. Eigenschappen die op persoonsgegevens lijken (e-mailadressen, telefoonnummers, gebruikersidentificatoren, betaalgegevens en dergelijke) worden automatisch verwijderd voordat er iets wordt opgeslagen. Als een eigenschap wordt verwijderd, zie je een waarschuwing in de browserconsole zodat je je implementatie kunt corrigeren.

De controle is een vangnet, geen vervanging voor goede datapraktijken. Het blijft jouw verantwoordelijkheid om vanaf het begin geen persoonsgegevens te versturen. Koppel nooit namen, e-mailadressen, telefoonnummers of iets anders dat een bezoeker identificeert aan een aangepast event. De controle kan niet alles herkennen (bijvoorbeeld de naam van een persoon), vertrouw er dus nooit op om gegevens te “opschonen” die je niet zou moeten versturen. Wil je bezoekers segmenteren, gebruik dan niet-identificerende labels (plan: 'pro', variant: 'b'), nooit identificatoren.