Custom events

Neben Pageviews zählt Lienks eigene Ereignisse, etwa Button-Klicks oder Formular-Absendungen. Ein Aufruf genügt.

Track an event

Rufe window.lienks.event('signup_clicked') auf, wo immer etwas gezählt werden soll. Das funktioniert, sobald das Lienks-Snippet auf deiner Seite eingebunden ist (siehe Quick start). Das Script stellt window.lienks bereit.

Zum Beispiel an einem Button:

<button onclick="window.lienks?.event('signup_clicked')">Sign up</button>

Oder in JavaScript mit einem Event-Listener:

document.querySelector('#signup').addEventListener('click', () => {
  window.lienks?.event('signup_clicked');
});

Das ?. sorgt dafür, dass nichts passiert, wenn das Script nicht geladen ist, zum Beispiel wegen eines Adblockers, statt dass auf deiner Seite ein Fehler auftritt.

Event names

Ein Eventname beginnt mit einem Kleinbuchstaben, danach folgen nur Kleinbuchstaben, Ziffern und Unterstriche, insgesamt höchstens 100 Zeichen:

^[a-z][a-z0-9_]{0,99}$

Gültig: signup_clicked, download_pdf, newsletter_form_sent
Ungültig: Signup Clicked (Großbuchstaben und Leerzeichen), signup-clicked (Bindestrich), 1st_click (beginnt mit einer Ziffer)

pageview ist reserviert und kann nicht als Eventname verwendet werden.

Ungültige Namen werden verworfen: Es wird nichts an Lienks gesendet und es gibt keine Fehlermeldung. Taucht ein Event nicht im Dashboard auf, prüfe zuerst den Namen.

Tipp: Wähle kurze, einheitliche Namen, zum Beispiel objekt_aktion, damit sie im Dashboard gut lesbar sind.

Use it with frameworks

In React, Vue, Svelte, Next.js und ähnlichen Frameworks verwendest du denselben Aufruf in deinem Click-Handler, mit window.lienks?.event(...).

In TypeScript-Projekten deklarierst du window.lienks, damit der Type-Checker es kennt:

declare global {
  interface Window {
    lienks?: { event: (eventName: string) => void };
  }
}
export {};

See your events

Im Dashboard deiner Site zeigt die Karte Eigene Ereignisse, welche Events ausgelöst wurden. Die Ansicht Neueste Events listet die letzten 50 Events mit Zeitpunkt, Name, Seite, Referrer, Browser, Betriebssystem, Gerät, Land und Bot-Status.

Mehr dazu unter Metrics and filters und Events.

Good to know