Benutzerdefinierte Ereignisse

Alles, woran Sie einen Klick-Handler hängen können, kann ein Ereignis sein.

window.seean.track("signup");
window.seean.track("download", { file: "pricing.pdf" });

Ereignisse erscheinen in der Übersicht (Ereigniskarte), im Ereignis-Aktivitätsprotokoll, in Funnels als Schritte und in Kampagnenberichten, wenn sie auf die aktivierten Conversion-Ziele passen (oder alle benutzerdefinierten Ereignisse, wenn keine Ziele aktiviert sind). Eigenschaften werden mit dem Ereignis gesendet, aber die aktuelle Aktivitätsprotokoll-Tabelle zeigt sie nicht an.

Benennung

Verwenden Sie kurze, stabile Namen: signup, cta_click, newsletter_signup. Ein späteres Umbenennen teilt Ihren Verlauf.

Vor dem Aufruf laden

Rufen Sie track auf, nachdem das erzeugte Tracker-Skript ausgeführt wurde. Es gibt keine eingebaute Warteschlange für Aufrufe vor dem Laden. Bei reinem HTML platzieren Sie das verzögerte Skript Ihrer Anwendung nach dem verzögerten Seean-Skript; bei einem Framework folgen Sie seiner Installationsanleitung.

Für eine Download-Schaltfläche hängen Sie den Handler an, nachdem diese Schaltfläche existiert:

document.querySelector("#download-pricing")?.addEventListener("click", () => {
  window.seean?.track("download", { file: "pricing.pdf" });
});

Das zählt den Klick, nicht den Beweis, dass ein Download abgeschlossen wurde. Optional Chaining verhindert eine Ausnahme, wenn der Tracker nicht verfügbar ist, speichert oder wiederholt das Ereignis aber nicht. Ein ignorierter Besucher kann wirkungslose Tracker-Methoden haben, sodass die Existenz von window.seean allein kein Beweis für Erfassung ist.

Für ein Formular rufen Sie den Tracker in Ihrem bestehenden Pfad für erfolgreiches Absenden auf:

// After your server has confirmed the newsletter signup succeeded:
window.seean?.track("newsletter_signup", { form: "footer" });

Senden Sie dieses Erfolgsereignis nicht zusätzlich beim Klick auf die Absende-Schaltfläche: Validierung oder Anfrage können fehlschlagen, und beides zu verknüpfen würde erfolgreiche Absendungen doppelt zählen. Behalten Sie die normale Validierung und Fehlerbehandlung Ihres Formulars.

Deklarative Klicks und Formulare

Fügen Sie data-seean-event="signup" zu einer Schaltfläche oder einem Link hinzu, um dieses Ereignis beim Klick zu senden, einschließlich Klicks auf verschachtelte Elemente. An einem Formular sendet das Attribut beim Absenden statt bei Klicks auf seine Felder. Dynamische Elemente funktionieren über delegierte Listener. Automatische Conversion-Vorlagen überspringen markierte Elemente, um Doppelzählungen zu vermeiden; rufen Sie für dieselbe Aktion nicht zusätzlich seean.track() auf. Deklarative Attribute brauchen kein data-conversions-Opt-in. Namen müssen nicht leer sein, höchstens 64 Zeichen haben und dürfen nicht pageview lauten.

<button data-seean-event="download" data-seean-event-source="footer">Download</button>
<form data-seean-event="contact_submit">…</form>

Fügen Sie data-seean-event-PROPERTY="value" demselben markierten Element hinzu, um eine Eigenschaft zu senden. Das Beispiel oben sendet { "source": "footer" }. Attributwerte bleiben Strings ("2" ist nicht die Zahl 2); HTML normalisiert Attributnamen zu Kleinbuchstaben. Nur explizit präfixierte Attribute an diesem Element werden gelesen. Eigenschaften an Vorfahren oder Kindern, Formularfeldwerte und unabhängige Attribute werden nicht erfasst. Wird ein Attribut vor einer späteren Interaktion geändert, wird sein neuer Wert verwendet.

Die unten stehenden Eigenschaftslimits gelten. Ein ungültiger Schlüssel, zu viele Eigenschaften oder ein zu großer Wert führen dazu, dass der Collector das Ereignis ablehnt; Werte werden nicht stillschweigend gekürzt. Verwenden Sie die JavaScript-API für typisierte Zahlen-, Boolean- oder Null-Werte.

Ein Klick- oder Absendeereignis bestätigt nicht, dass Ihr Server die Aktion abgeschlossen hat. Verwenden Sie die oben beschriebene Methode mit dem Erfolgs-Handler, wenn Sie diese Bestätigung brauchen.

Angemeldete Nutzer identifizieren

window.seean?.identify("user_42", { plan: "pro" });

identify(id, properties?) hängt Ihre eigene Nutzer-ID (1–64 Zeichen aus A–Z a–z 0–9 _ . : @ -, niemals eine E-Mail-Adresse) an jeden späteren Datensatz der offenen Seite und erfasst ein identify-Ereignis mit den optionalen Eigenschaften. Es wirkt nur für Websites, die Identify users (Nutzer identifizieren) unter Settings → Installation eingeschaltet haben; siehe Personen und Retention.

Eigenschaftslimits

Ereignisnamen akzeptieren bis zu 64 Zeichen. Jedes Ereignis kann bis zu 20 Eigenschaften enthalten; das serialisierte Eigenschaftsobjekt darf 4.096 Zeichen nicht überschreiten. Eigenschaftsschlüssel beginnen mit einem Buchstaben und enthalten nur Buchstaben, Ziffern oder Unterstriche, bis zu 64 Zeichen. Werte können ein String mit bis zu 512 Zeichen, eine endliche Zahl, ein Boolean oder null sein. Verschachtelte Objekte und Arrays werden abgelehnt.

Verwenden Sie unkritische Bezeichnungen wie eine Formularposition oder Produktkategorie. Senden Sie niemals Passwörter, E-Mail-Adressen, Zahlungsdaten oder private Tokens. Eigenschaften sind derzeit nicht als Spalten im Aktivitätsprotokoll oder als Dashboard-Eigenschaftsfilter verfügbar; das Senden einer Eigenschaft erzeugt kein neues Berichtssteuerelement.

Ereignis prüfen

Führen Sie die Aktion einmal aus und öffnen Sie das Events activity log (Ereignis-Aktivitätsprotokoll) der gewählten Website im aktuellen Zeitraum. Prüfen Sie Name, Pfad und Anzahl. Benutzerdefinierte Ereignisse verwenden dieselben Datenschutzsignale, Ausschlüsse und dasselbe Erfassungskontingent wie Seitenaufrufe; eine abgelehnte oder ignorierte Anfrage hinterlässt möglicherweise keine Zeile. Ein Ereignis namens pageview wird als Seitenaufruf statt als benutzerdefiniertes Ereignis gezählt.

Fehlt eine Zeile, prüfen Sie die Skriptbereitschaft, die Anfrage-Payload und die Fehlerbehebung zur Installation. track() gibt keine Bestätigung zurück, dass die Speicherung erfolgreich war, und der Tracker bietet keine dauerhafte Wiederholungswarteschlange.

404-Seiten

Fügen Sie <meta name="seean:status" content="404"> zu Ihrer Nicht-gefunden-Seite hinzu, und ihr automatischer Seitenaufruf trägt status: 404, sodass sie unter Pages → 404s (Seiten → 404s) erscheint, ohne ein zweites Ereignis.

Ein Aufruf von track("pageview", { status: 404 }) fügt stattdessen einen zweiten Seitenaufruf hinzu. Siehe 404-Tracking.

Etwas unklar? Support kontaktieren.