Eigene Ereignisse

Mit eigenen Ereignissen erfassen Sie gezielt die Nutzeraktionen, die für Ihr Geschäft zählen — über das hinaus, was das Auto-Tracking abdeckt. Sie legen Name und Metadaten fest, das SDK sendet das Ereignis samt vollständiger QR-Zuordnung.

Syntax

scanova('track', 'event_name', { key: 'value' });

event_name — eine Zeichenkette, die die Aktion beschreibt. Verwenden Sie snake_case.
metadata — ein optionales Objekt mit beliebigen Schlüssel-Wert-Daten zum Ereignis. Maximal 10 KB.

Sie können scanova('track', ...) jederzeit nach scanova('init', ...) aufrufen — aus Event-Listenern, asynchronen Callbacks oder jedem anderen JavaScript-Kontext.

Auf der Leitung sendet das SDK jedes eigene Ereignis mit event_type gleich custom und Ihrem Namen im Feld event_name der obersten Ebene — nicht innerhalb von metadata. Das unterscheidet sich vom direkten Aufruf von POST /ct, wo event_type den inhaltlichen Namen selbst trägt. Siehe Referenz zum Ereignismodell.

Beispiele

Klick auf eine Schaltfläche

Erfassen, wann eine Person auf einen bestimmten Call-to-Action klickt:

document.getElementById('start-trial-btn').addEventListener('click', () => {
  scanova('track', 'cta_click', {
    button_text: 'Start Free Trial',
    section: 'hero',
    plan: 'pro'
  });
});

Abgeschlossene Anmeldung

Senden Sie dies, nachdem die Absendung Ihres Anmeldeformulars clientseitig bestätigt wurde:

scanova('track', 'signup_completed', {
  method: 'email',
  plan: 'free'
});

Für Kauf- oder Anmeldebestätigungen, die serverseitig erfolgen, verwenden Sie stattdessen Server-Ereignisse. Server-Ereignisse sind zuverlässiger und lassen sich nicht von Browser-Erweiterungen blockieren.

Video-Interaktion

video.addEventListener('play', () => {
  scanova('track', 'video_play', { video_id: 'intro-tour' });
});

video.addEventListener('ended', () => {
  scanova('track', 'video_complete', { video_id: 'intro-tour' });
});

Produkt-Interaktion

document.querySelectorAll('.product-card').forEach(card => {
  card.addEventListener('click', () => {
    scanova('track', 'product_click', {
      product_id: card.dataset.productId,
      product_name: card.dataset.productName,
      position: card.dataset.position
    });
  });
});

Interaktion mit Tabs oder Akkordeons

document.querySelectorAll('.tab-btn').forEach(btn => {
  btn.addEventListener('click', () => {
    scanova('track', 'tab_click', { tab_name: btn.textContent.trim() });
  });
});

Klick auf einen externen Link

document.querySelectorAll('a[href^="http"]').forEach(link => {
  link.addEventListener('click', () => {
    scanova('track', 'external_link_click', { destination: link.href });
  });
});