Benutzerdefinierte Ereignisse

Verfolgen Sie benutzerdefinierte Ereignisse und Benutzerinteraktionen, um zu verstehen, wie Besucher mit Ihrer Website interagieren.

Übersicht

Benutzerdefinierte Ereignisse ermöglichen es Ihnen, spezifische Benutzeraktionen zu verfolgen, die für Ihr Unternehmen wichtig sind:

• Button-Klicks
• Formular-Einsendungen
• Video-Wiedergabe
• Datei-Downloads
• Externe Link-Klicks
• Scroll-Tiefe
• Zeit auf der Seite

Grundlegende Ereignisverfolgung

Verwenden Sie die Funktion track(), um benutzerdefinierte Ereignisse zu versenden:

// Verfolgung eines einfachen Ereignisses
zenovay('track', 'button_click');

// Verfolgung eines Ereignisses mit Eigenschaften
zenovay('track', 'video_play', {
video_id: 'intro-video',
video_title: 'Getting Started with Zenovay',
video_duration: 120
});

Ereigniseigenschaften

Fügen Sie zusätzlichen Kontext zu Ihren Ereignissen mit Eigenschaften hinzu:

zenovay('track', 'purchase', {
product_id: 'pro-plan',
product_name: 'Pro Plan',
price: 29.99,
currency: 'USD',
category: 'subscription'
});

Häufige Ereignismuster

Formular-Einsendungen

document.getElementById('contact-form').addEventListener('submit', function(e) {
zenovay('track', 'form_submit', {
  form_name: 'contact_form',
  form_type: 'lead_generation'
});
});

Datei-Downloads

document.querySelectorAll('a[href$=".pdf"]').forEach(link => {
link.addEventListener('click', function(e) {
  zenovay('track', 'file_download', {
    file_name: this.href.split('/').pop(),
    file_type: 'pdf',
    file_url: this.href
  });
});
});

Video-Interaktionen

const video = document.querySelector('video');

video.addEventListener('play', () => {
zenovay('track', 'video_play', {
  video_title: video.title,
  video_duration: video.duration
});
});

video.addEventListener('ended', () => {
zenovay('track', 'video_complete', {
  video_title: video.title,
  watch_time: video.currentTime
});
});

React-Integration

Verwenden Sie für React-Anwendungen das globale Objekt zenovay aus dem Tracking-Skript:

function ProductCard({ product }) {
const handleAddToCart = () => {
  // Verwenden Sie das globale Objekt zenovay aus dem Tracking-Skript
  zenovay('track', 'add_to_cart', {
    product_id: product.id,
    product_name: product.name,
    price: product.price
  });
};

return (
  <button onClick={handleAddToCart}>
    Add to Cart
  </button>
);
}

Namenskonventionen für Ereignisse

Befolgen Sie diese Konventionen für konsistente Ereignisverfolgung:

Empfohlene Ereignisnamen

Richtlinien für Eigenschaften

• Halten Sie Eigenschaftsnamen aussagekräftig und konsistent
• Verwenden Sie snake_case für Eigenschaftsnamen
• Fügen Sie relevanten Kontext ein (IDs, Namen, Kategorien)
• Vermeiden Sie persönlich identifizierbare Informationen (PII)

Anzeigen benutzerdefinierter Ereignisse

Benutzerdefinierte Ereignisse werden in Ihrem Domain-Dashboard angezeigt. Öffnen Sie Domains, klicken Sie auf Ihre Website und verwenden Sie den relevanten Tab:

• Analytics-Tab — zeigen Sie Ereigniszählungen neben Seitenaufrufen und anderen Verhaltensmetriken an
• Revenue-Tab — erstellen Sie Konversionsfunnel und verfolgen Sie Zielabschlüsse aus benutzerdefinierten Ereignissen

Debugging von Ereignissen

Verwenden Sie die Browser-Konsole zum Debuggen der Ereignisverfolgung:

// Aktivieren Sie den Debug-Modus
zenovay('debug');

// Verfolgen Sie ein Ereignis (wird in der Konsole protokolliert)
zenovay('track', 'test_event', { debug: true });