Benutzerdefinierte Events

Erfassen Sie Nutzerinteraktionen über Seitenaufrufe hinaus.

Grundlegende Verwendung

Verwenden Sie das globale analytics-Objekt, um Events zu erfassen:

// Track a simple event
window.analytics.track('signup_click');

// Track an event with properties
window.analytics.track('purchase', {
  plan: 'pro',
  value: 29
});

Häufige Beispiele

Button-Klicks

<button onclick="window.analytics.track('cta_click', { button: 'hero' })">
  Get Started
</button>

Formularübermittlungen

<form onsubmit="window.analytics.track('form_submit', { form: 'contact' })">
  <!-- form fields -->
  <button type="submit">Send</button>
</form>

Newsletter-Anmeldung

function handleSubscribe() {
  // Your subscription logic...

  window.analytics.track('newsletter_signup', {
    source: 'footer'
  });
}

Video-Interaktion

video.addEventListener('play', () => {
  window.analytics.track('video_play', { video: 'demo' });
});

video.addEventListener('ended', () => {
  window.analytics.track('video_complete', { video: 'demo' });
});

E-Commerce

// Add to cart
window.analytics.track('add_to_cart', {
  product: 'T-Shirt',
  price: 25,
  currency: 'USD'
});

// Purchase complete
window.analytics.track('purchase', {
  value: 75,
  items: 3
});

React / Next.js

// Declare the global type
declare global {
  interface Window {
    analytics: {
      track: (event: string, props?: Record<string, any>) => void;
    };
  }
}

// Use in components
export function SignupButton() {
  const handleClick = () => {
    window.analytics.track('signup_click', { location: 'header' });
    // Continue with signup...
  };

  return (
    <button onClick={handleClick}>
      Sign Up
    </button>
  );
}

Event-Eigenschaften

Eigenschaften helfen Ihnen, Events zu segmentieren und zu analysieren. Halten Sie sie einfach:

  • Verwenden Sie Kleinbuchstaben mit Unterstrichen: button_click
  • Halten Sie Eigenschaftswerte kurz und kategorisch
  • Nehmen Sie keine personenbezogenen Daten auf (E-Mails, Namen usw.)
  • Beschränken Sie sich auf 5–10 Eigenschaften pro Event

Datenschutzhinweis

Nehmen Sie niemals personenbezogene Daten (PII) in Event-Namen oder -Eigenschaften auf. Dazu gehören E-Mails, Namen, Telefonnummern oder alle Daten, die eine bestimmte Person identifizieren könnten.

Events mit Zielen verwenden

Benutzerdefinierte Events können als Conversion-Ziele verwendet werden. Wenn Sie beispielsweise ein purchase-Event erfassen, können Sie ein Ziel erstellen, das ausgelöst wird, wenn dieses Event eintritt.

Gehen Sie zu Einstellungen → Ziele → Ziel hinzufügen → Wählen Sie „Benutzerdefiniertes Event“ und geben Sie den Event-Namen ein. Erfahren Sie mehr in unserer Ziel-Dokumentation.

Verwandte Ressourcen