Tracked Events

Was ist ein Tracked Event?

Ein Tracked Event ist jede User-Aktion auf deiner Site, die du datakant aufzeichnen und unter einem für Menschen lesbaren Namen anzeigen lässt. Der Tracker beobachtet von alleine jede Seite, jeden Click und jeden Scroll — aber diese rohen Signale werden erst nützlich, sobald du entscheidest, welche zählen, und sie benennst.

Sobald ein Event getrackt ist, taucht es in der Events-Tabelle auf der Settings-Seite, in Dashboards, Funnels und AI-Engine-Queries auf — und (wenn du es als Conversion markierst) in Attribution- und ROI-Reports. Das Event an Google Analytics, Meta CAPI oder eine andere Destination weiterzuleiten ist nur eine Sache des Event-Name-Mappings im Destinations-Tab.

Die vier Trigger-Typen

Wenn du im Events-Tab Add event öffnest, ist das Erste, was du auswählst, wie das Event feuert. Jeder Trigger entspricht einer anderen Form von User-Verhalten:

URL Match

Nutze einen URL-Match-Trigger, wenn die Aktion, die dich interessiert, „eine Seite erreichen“ ist. Klassische Beispiele sind eine Thank-you-Page nach einem Checkout, der Welcome-Screen nach dem Signup oder ein bestimmter Tab in einer Single-Page-App, in dem sich das URL-Fragment ändert.

Setup

1. Öffne Settings → Events und klicke Add event.
2. Wähle URL Match in Step 1 und klicke Continue.
3. Trage den Pfad ein, dem die URL entsprechen soll, z.B. /checkout/success. Du gibst die Domain nicht an — der Tracker scoped Events bereits auf die Property, die du konfigurierst.
4. Wähle einen Match-Typ — Exact, Starts with, Contains oder Regex. Wildcards mit * werden für die ersten drei unterstützt (z.B. /blog/*/share).
5. Gehe zu Step 3, benenne das Event (snake_case) und speichere.

Element Click

Nutze einen Click-Trigger, wenn die bedeutsame Aktion das Anklicken eines bestimmten Buttons, Links oder UI-Elements ist. Der datakant Tracker beobachtet deine Site kontinuierlich und baut einen Element-Katalog von Interaktionen — du musst den CSS-Selector nicht kennen. Du wählst das Element einfach aus einer visuellen Liste.

Setup

1. Öffne Settings → Events → Add event.
2. Wähle Element Click in Step 1 und klicke Continue.
3. Links blätterst du durch den Katalog erkannter Elemente. Jede Zeile zeigt einen inferierten Event-Key, einen Confidence-Score, wie oft das Element beobachtet wurde, und ein Beispiel des sichtbaren Texts.
4. Klicke ein Element, um es anzupinnen. Das rechte Pane rendert einen erfassten Screenshot der Seite, auf der das Element erscheint — so kannst du bestätigen, dass du das richtige gewählt hast.
5. Wenn du ein Element wählst, wird ein vorgeschlagener Event-Name automatisch in Step 3 eingefügt — dort prüfst oder umbenennst du ihn und speicherst.

Scroll Depth

Scroll Depth verrät dir, wie weit ein Visitor eine Seite gelesen hat, bevor er weggebounced ist. Es ist das schnellste Engagement-Signal für Long-form Pages — Blog-Posts, Landing Pages, Pricing-Seiten mit FAQs am Ende — wo Time-on-Page allein zu noisy ist.

Setup

1. Öffne Settings → Events → Add event.
2. Wähle Scroll Depth in Step 1.
3. Wähle einen Threshold — 25 / 50 / 75 / 100 %. Die Visualisierung neben dem Picker zeigt, wo der Threshold auf einer typischen deiner Seiten liegt.
4. Gehe zu Step 3, benenne das Event (z.B. scroll_50) und speichere.

Custom dataLayer

Wenn eine bedeutsame Aktion nicht einer URL oder einem Click auf ein sichtbares Element entspricht — denke an einen erfolgreichen Form Submit mit Client-side Validation, ein Video, das 75 % Playback erreicht, oder eine Stripe-Elements-Payment-Bestätigung — wirst du Events direkt aus deinem eigenen JavaScript feuern können mit window.datakant.track('event_key', { ...properties }).

Naming Conventions

Event-Namen sind snake_case — nur Kleinbuchstaben, Ziffern und Unterstriche. Sie müssen mit einem Buchstaben oder Unterstrich beginnen. Der Wizard validiert das für dich und deaktiviert Save, wenn der Name ungültig ist.

Ein beschreibendes Präfix (checkout_, signup_, nav_) ist der günstigste Weg, deine Events-Liste auch beim Wachstum übersichtlich zu halten.

Als Conversion markieren

Jedes Tracked Event kann als Conversion geflaggt werden. Conversions sind die Events, die in Funnels, Attribution-Reports und den ROI- / Value-Rollups in deinen Dashboards auftauchen — und es sind die, die die AI Engine priorisiert, wenn du Fragen stellst wie „Warum ist der Revenue letzte Woche eingebrochen?“.

Schalte in Step 3 des Wizards den Toggle Treat as a conversion. Zwei zusätzliche Felder erscheinen:

Default-Wert

Der monetäre Wert einer Conversion. Wird verwendet, wenn der auslösende Call keinen eigenen value liefert (z.B. eine Scroll-Depth-Conversion nutzt immer diesen Default; eine Custom-dataLayer-Conversion nutzt den Per-Call-Wert, falls einer übergeben wird).

Währung

ISO-4217-Code. Default ist EUR. Wird für die Anzeige verwendet und beim Forwarding an Destinations, die eine Währung erwarten (GA4, Meta CAPI, etc.).

Tipps & Best Practices

• Schmal starten. Versuche nicht, von Tag eins jeden Button zu tracken. Beginne mit den zwei oder drei Events, die direkt auf dein Business-Ziel zeigen (Lead Submission, Trial Start, Purchase). Füge mehr hinzu, sobald dein Team Fragen stellt, die das aktuelle Set nicht beantworten kann.
• Conversions bewusst markieren. Conversions blähen Funnel- und Attribution-Mathe auf. Zu viele Events als Conversions zu markieren macht diese Reports noisy. Faustregel: Wenn ein Event nicht wert ist, dem CEO im Wochen-Summary gezeigt zu werden, ist es vermutlich keine Conversion.
• Den Katalog wiederverwenden. Bevor du ein neues Element-Click-Event anlegst, scrolle durch den Katalog — das gleiche Element hat möglicherweise schon einen high-confidence inferierten Namen, den du umbenennen kannst, statt neu zu starten.
• Event-Namen über Destinations hinweg matchen. Wenn das Event an GA4 oder Meta weitergeleitet wird, wähle wenn möglich einen Namen, den diese Tools auch erkennen (purchase, sign_up, generate_lead) — das spart einen Mapping-Step im Destinations-Tab.