Benutzerdefinierte Events

Zusaetzlich zu automatischen Pageviews verfolgt MetriXs benutzerdefinierte Events, alles, was Sie messen moechten: Button-Klicks, Formular-Uebermittlungen, Video-Wiedergaben, Anmeldungen, Kaeufe. Benutzerdefinierte Events tragen eigene Eigenschaften, die Sie anhaengen koennen, und das Dashboard schluesselt sie fuer Sie auf.

Benutzerdefinierte Events senden

Feuern Sie ein benutzerdefiniertes Event von Ihrer Website mit der globalen metrixs()-Funktion (verfuegbar, sobald das Tracker-Skript geladen hat):

// Ein benutzerdefiniertes Event mit Eigenschaften
metrixs('Signup', { props: { plan: 'pro', location: 'hero' } })

Option	Typ	Standard	Beschreibung
`name`	`string`	—	Der Event-Name. Verwenden Sie `'pageview'` fuer einen manuellen Pageview.
`props`	`object`	`{}`	Benutzerdefinierte Eigenschaften, die an das Event angehaengt werden.
`url`	`string`	`location.href`	Ueberschreibt die fuer dieses Event aufgezeichnete Seiten-URL (nuetzlich fuer SPA-Routenwechsel).
`interactive`	`boolean`	`true`	Auf `false` setzen fuer passive Signale, die nicht als echte Interaktion zaehlen sollen (damit sie die Absprungrate nicht senken). Die eingebauten Scroll-Tiefe-/Engagement-Events verwenden dies.
`callback`	`function`	—	Wird aufgerufen, nachdem das Event gesendet wurde.

// Nicht-interaktives Signal, verlaengert die Besuchsdauer ohne Beeintraechtigung der Absprungrate
metrixs('scroll_to_bottom', { props: { article: 'gdpr' }, interactive: false })

Benutzerdefinierte Events, die waehrend eines Besuchs feuern, verlaengern auch seine gemessene Dauer, da die Dauer als die Zeit zwischen dem ersten Pageview und dem letzten Event berechnet wird. Siehe Besuchsdauer fuer die Bedeutung.

Automatisch erfasste Events

Der Tracker erfasst automatisch drei Event-Typen, kein Setup erforderlich:

Event-Name	Wann es feuert	Eigenschaft
`Outbound Link: Click`	Ein Besucher klickt auf einen Link zu einer externen Domain	`url`
`File Download`	Ein Besucher klickt auf einen Link zu einer Datei (pdf, zip, mp4, docx, …)	`url`
`404`	Eine 404-Seite, nur wenn die Seite `<meta name="metrixs:404" content="true">` setzt	`path`

Diese erscheinen im Dashboard in ihrer eigenen Automatisch erfasste Events-Karte, getrennt von Ihren benutzerdefinierten Events, damit Ihre benutzerdefinierten Events sauber bleiben.

Der lite-Tracker (tracker.lite.js) verzichtet auf Auto-Tracking, nur Pageviews. Verwenden Sie den vollstaendigen tracker.js, wenn Sie ausgehende Links, Downloads und 404s erfassen moechten.

Benutzerdefinierte Events im Dashboard anzeigen

Das Dashboard zeigt zwei Karten (nur wenn die Website benutzerdefinierte Events hat, sie verbergen sich sonst, damit es kein Chaos auf Websites gibt, die sie nicht verwenden):

Benutzerdefinierte Events, Ihre benutzerdefinierten Events.
Automatisch erfasste Events, ausgehende Links, Datei-Downloads und 404s.

Jede Zeile zeigt den Event-Namen und wie oft er feuerte, mit einem Balken skaliert auf das Top-Event. Klicken Sie auf eine Zeile, um sie inline zu erweitern und ihre Eigenschaftsaufschluesselung zu sehen, jeder Eigenschaftsschluessel mit seinen Top-Werten und Anzahlen.

Ein Klick auf einen Eigenschaftswert (z.B. plan = pro) filtert das gesamte Dashboard nach diesem Segment, genau wie ein Klick auf eine Seite oder ein Land. Entfernen Sie den Filter aus der Filterleiste oben.

Wie Eigenschaften gespeichert werden

Benutzerdefinierte Event-Eigenschaften werden in ClickHouse als parallele meta.key-/meta.value-Arrays gespeichert (eine Zeile pro Event). Das Dashboard entdeckt die Eigenschaftsschluessel pro Event mit einem dedizierten POST /api/v2/event-props-Endpunkt (der Haupt-Query-Builder kann unbekannte Schluessel nicht aufzaehlen), dann liest er jeden Wert ueber die event:props:<key>-Dimension. Eigenschaftsschluessel sind auf ^[a-zA-Z0-9_-]+$ beschraenkt, bleiben bei Buchstaben, Zahlen, Bindestrichen und Unterstrichen.