Benutzerdefinierte Events erfassen

Was sind benutzerdefinierte Events?

Seitenaufrufe werden automatisch erfasst, doch viele wichtige Aktionen laden keine neue Seite: ein Klick auf einen Button, das Absenden eines Formulars, das Abspielen eines Videos, der Download einer Datei. Mit benutzerdefinierten Events können Sie diese Interaktionen erfassen.

Events mit JavaScript erfassen

Verwenden Sie die Funktion umami.track() an beliebiger Stelle im JavaScript Ihrer Website:

// Basic event — just a name
umami.track('signup-click');

// Event with custom data
umami.track('download', {
  fileName: 'whitepaper-2026.pdf',
  category: 'resources'
});

// Event with multiple properties
umami.track('video-play', {
  title: 'Product Demo',
  duration: 120,
  autoplay: false
});

Events mit HTML-Attributen erfassen

Für einfaches Klick-Tracking müssen Sie kein JavaScript schreiben. Fügen Sie einfach einem beliebigen HTML-Element das Attribut data-umami-event hinzu:

<!-- Basic click event -->
<button data-umami-event="signup-click">Sign Up</button>

<!-- Event with extra data -->
<a href="/pricing"
   data-umami-event="cta-click"
   data-umami-event-location="header">
  View Pricing
</a>

<!-- Download tracking -->
<a href="/files/report.pdf"
   data-umami-event="download"
   data-umami-event-file="report.pdf">
  Download Report
</a>

Alle Attribute vom Typ data-umami-event-* werden zu benutzerdefinierten Eigenschaften des Events.

Event-Daten ansehen

Öffnen Sie in der Seitenleiste unter Traffic den Punkt Events.

Dort sehen Sie:

• Event-Zeitverlauf: Ein Diagramm, das zeigt, wie oft Events im Zeitverlauf auftreten
• Event-Liste: Alle erfassten Events mit ihrer Anzahl
• Event-Eigenschaften: Klicken Sie auf ein Event, um die Aufschlüsselung seiner benutzerdefinierten Daten zu sehen

Besucher identifizieren

Mit umami.identify() können Sie Besucher außerdem mit benutzerdefinierten Eigenschaften identifizieren:

umami.identify({
  userId: 'user-123',
  plan: 'pro',
  company: 'Acme Corp'
});

Dadurch werden benutzerdefinierte Daten an die Sitzung des Besuchers angehängt, die Sie anschließend zum Filtern und Segmentieren nutzen können.

Häufige Muster für Event-Tracking

Best Practices

• Verwenden Sie aussagekräftige, einheitliche Namen. add-to-cart ist besser als click1.
• Halten Sie Eigenschaftswerte sauber. Vermeiden Sie dynamische Werte, die zu viele eindeutige Einträge erzeugen (z. B. Zeitstempel).
• Erfassen Sie das Ergebnis, nicht den Klick. Erfassen Sie form-submit, nicht submit-button-click.
• Erfassen Sie nicht zu viel. Konzentrieren Sie sich auf Events, aus denen Sie konkrete Maßnahmen ableiten können.

Wie geht es weiter?

• → Conversion-Ziele erfassen: Events als Conversion-Ziele nutzen
• → Conversion-Funnels einrichten: Funnels aus Events aufbauen
• → Umsatz-Tracking: Umsatzdaten zu Events hinzufügen

Brauchen Sie Hilfe? Schreiben Sie uns an support@eurometrics.eu.