Ereignisse einrichten

Was sind Ereignisse?

Seitenaufrufe zählt Trustlytics automatisch. Heisst: Sie sehen sofort, welche Seiten Ihrer Webseite besucht wurden.

Aber was passiert auf einer Seite? Welcher Button wird geklickt, welches Formular abgeschickt, welcher Plan gewählt? Das wissen Sie nur, wenn Sie es selbst markieren.

Genau dafür gibt es Ereignisse. Sie setzen einen kleinen Marker auf ein Element Ihrer Webseite, und Trustlytics zählt ab diesem Moment jeden Klick darauf.

Womit anfangen? Nehmen Sie die Aktionen, an denen für Sie Geld oder Zeit hängt. Also: Kaufen-Button, Kontaktformular, Telefonnummer-Klick, Download, Terminbuchung. Nicht markieren müssen Sie Ihre Navigation, denn welche Seite jemand danach öffnet, sehen Sie ohnehin bei den Seitenaufrufen.

Bevor wir loslegen: Sie wählen die Namen selbst

In den Beispielen weiter unten lesen Sie Wörter wie Newsletter-Anmeldung, Plan ausgewählt, plan, billing, starter, pro. Das sind Beispiele. Nichts davon ist vorgegeben.

Zwei Dinge legen Sie selbst fest:

• Den Ereignisnamen (das steht hinter data-trustlytics-event="...")
• Die Eigenschaften (falls Sie welche brauchen)

Trustlytics speichert genau das, was Sie hinschreiben. Es gibt keine Liste, aus der Sie wählen müssten. Komplett frei.

Die vier Attribute im Überblick

Damit Sie die Übersicht behalten: Es gibt genau vier Attribute. Eines ist Pflicht, drei sind freiwillig.

Für die meisten Fälle brauchen Sie nur das erste. Die anderen drei kommen dazu, wenn Sie mehr wissen möchten.

Beispiel 1: Newsletter-Anmeldung zählen

So sieht ein normales Newsletter-Formular aus:

<form action="/newsletter" method="POST">
 <input type="email" name="email" required>
 <button type="submit">Anmelden</button>
</form>

Sie ergänzen genau eine Angabe:

<form action="/newsletter" method="POST" data-trustlytics-event="Newsletter-Anmeldung">
 <input type="email" name="email" required>
 <button type="submit">Anmelden</button>
</form>

Fertig. Ab jetzt erscheint in Ihrer Trustlytics-Auswertung das Ereignis «Newsletter-Anmeldung», jedes Mal, wenn jemand das Formular abschickt.

Statt «Newsletter-Anmeldung» können Sie schreiben, was Sie möchten. «Anmeldung Newsletter», «Newsletter eingetragen», «Newsletter-Subscribe». Was für Sie verständlich ist, ist richtig.

Beispiel 2: Einen Button-Klick zählen

Sie haben einen «Demo buchen»-Button:

<a href="https://calendly.com/ihre-firma">Demo buchen</a>

Markierung dazu:

<a href="https://calendly.com/ihre-firma" data-trustlytics-event="Demo gebucht">Demo buchen</a>

Und fertig. Wieder: «Demo gebucht» können Sie ersetzen durch «Demo angefragt», «Calendly geöffnet», «Termin gewünscht». Nehmen Sie, was für Sie Sinn ergibt.

Beispiel 3: Wenn Sie zusätzlich Details speichern möchten

Manchmal reicht «Plan ausgewählt» nicht. Sie möchten wissen, welcher Plan geklickt wurde. Dafür gibt es Eigenschaften (das Attribut data-trustlytics-event-property-...).

Statt drei separate Ereignisse anzulegen («Starter geklickt», «Pro geklickt», «Enterprise geklickt»), nehmen Sie ein Ereignis mit einer Eigenschaft:

<a href="/checkout?plan=starter"
 data-trustlytics-event="Plan ausgewählt" 
 data-trustlytics-event-property-plan="starter">Starter</a>
<a href="/checkout?plan=pro"
 data-trustlytics-event="Plan ausgewählt"
 data-trustlytics-event-property-plan="pro">Pro</a>
<a href="/checkout?plan=enterprise"
 data-trustlytics-event="Plan ausgewählt"
 data-trustlytics-event-property-plan="enterprise">Enterprise</a>

In Ihrer Trustlytics-Auswertung erkennen Sie dann beim Ereignis «Plan ausgewählt»:

• plan: starter (40 %)
• plan: pro (50 %)
• plan: enterprise (10 %)

So sehen Sie sofort, welcher Plan am besten zieht. Ohne drei Ereignisse pflegen zu müssen.

Die Eigenschaft heisst «plan», weil wir «plan» geschrieben haben. Genauso gut wäre:

data-trustlytics-event-property-paket="starter"
data-trustlytics-event-property-tarif="starter"
data-trustlytics-event-property-typ="starter"

Was nach data-trustlytics-event-property- kommt, ist Ihr Name für die Eigenschaft. Genau dieser Name erscheint später in der Auswertung.

Beispiel 4: Mehrere Eigenschaften kombinieren

Sie möchten Plan und Abrechnungs-Modus zählen:

<a href="/checkout?plan=pro&billing=monthly"
 data-trustlytics-event="Plan ausgewählt"
 data-trustlytics-event-property-plan="pro"
 data-trustlytics-event-property-billing="monthly">Pro (monatlich)</a>
<a href="/checkout?plan=pro&billing=yearly"
 data-trustlytics-event="Plan ausgewählt"
 data-trustlytics-event-property-plan="pro"
 data-trustlytics-event-property-billing="yearly">Pro (jährlich)</a>

In der Auswertung schauen Sie beim Ereignis «Plan ausgewählt» dann zwei Aufschlüsselungen an:

• plan: starter (40 %), pro (50 %), enterprise (10 %)
• billing: monthly (70 %), yearly (30 %)

Sie können so viele Eigenschaften kombinieren, wie Sie brauchen. Maximal 20 pro Ereignis.

Dasselbe Vorgehen funktioniert für alles, was sich nach Kategorien aufteilen lässt: Whitepaper-Downloads nach Thema, Sprachwahl im Menü, Filter-Klicks im Shop, Sterne-Bewertungen. Immer ein Ereignis, viele Eigenschaften.

Beispiel 5: Einen Zahlenwert mitschicken

Eigenschaften speichern Text. Manchmal brauchen Sie aber eine Zahl, mit der sich rechnen lässt. Einen Bestellwert zum Beispiel. Dafür gibt es data-trustlytics-event-value.

Der Wert muss eine Zahl sein, mit Punkt als Dezimaltrennzeichen und ohne Währungszeichen:

<button data-trustlytics-event="Bestellung abgeschlossen"
  data-trustlytics-event-value="125.00">Jetzt kaufen</button>

Meistens setzt Ihr Shop-System diesen Wert automatisch auf den echten Warenkorb-Betrag, bevor der Button erscheint:

// Kurz bevor der Kaufen-Button klickbar ist:
button.dataset.trustlyticsEventValue = String(warenkorbBetrag); // z.B. "89.50"

Lassen Sie das Attribut weg oder bleibt es leer, wird das Ereignis trotzdem gezählt. Nur eben ohne Wert.

Wofür sich ein Wert sonst noch lohnt: Bewertungen (1 bis 5 Sterne), Anzahl Artikel im Warenkorb, Dauer eines abgespielten Videos in Sekunden, Anzahl gewählter Lizenzen. Immer dann, wenn nicht nur zählt, dass etwas passiert, sondern auch wie viel.

Beispiel 6: Den Auslöser steuern

Normalerweise erkennt Trustlytics selbst, wann ein Ereignis ausgelöst werden soll. Bei einem Link der Klick, bei einem Formular das Abschicken, bei einem Auswahlfeld die Änderung. In den allermeisten Fällen müssen Sie sich darum nicht kümmern.

Möchten Sie es trotzdem selbst bestimmen, nehmen Sie data-trustlytics-event-on. Drei Werte stehen zur Wahl:

Ein Beispiel, bei dem sich das lohnt. Sie haben ein Auswahlfeld für die Sprache und möchten wissen, welche gewählt wird. Ein Klick darauf sagt nichts, denn geklickt wird es immer. Interessant ist erst die Änderung:

<select data-trustlytics-event="Sprache gewechselt"
  data-trustlytics-event-on="change">
  <option value="de">Deutsch</option>
  <option value="fr">Français</option>
  <option value="it">Italiano</option>
</select>

Beispiel 7: Feedback zu diesem Artikel (so machen wir es selbst)

Unter jedem Support-Artikel finden Sie die Frage «War dieser Artikel hilfreich?» mit zwei Daumen. Wir messen das mit Trustlytics. Was wir Ihnen empfehlen, nutzen wir auch. So sieht der Code aus:

<section class="helpful">
 <span>War dieser Artikel hilfreich?</span>
 <div class="helpful-btns">
 <button class="helpful-btn"
 title="Ja"
 data-trustlytics-event="Supportartikel:Ereignisse einrichten"
 data-trustlytics-event-property-helpful="Ja">
 <!-- Daumen hoch -->
 </button>
 <button class="helpful-btn"
 title="Nein"
 data-trustlytics-event="Supportartikel:Ereignisse einrichten"
 data-trustlytics-event-property-helpful="Nein">
 <!-- Daumen runter -->
 </button>
 </div>
</section>

Warum wir das genau so gebaut haben:

1. Der Ereignisname enthält den Artikeltitel. Statt nur «Feedback» schreiben wir «Supportartikel:Ereignisse einrichten». So sehen wir später, zu welchem Artikel das Feedback kam. Bei 50 Artikeln wäre «Feedback» allein wertlos.
2. Beide Buttons lösen dasselbe Ereignis aus. Der Unterschied steckt in der Eigenschaft helpful="Ja" oder helpful="Nein". In der Auswertung sehen wir auf einen Blick: 80 % sagen Ja, 20 % sagen Nein. Bei 20 % Nein wissen wir, dass dieser Artikel besser werden muss.

Welche Aktionen werden automatisch erkannt?

Trustlytics erkennt diese Klicks automatisch. Sie müssen nichts zusätzlich einstellen:

Regeln und Limits

So prüfen Sie, ob es funktioniert

1. Markierung im HTML setzen (wie in den Beispielen oben).
2. Änderung auf Ihrer Webseite speichern.
3. Webseite in einem neuen Browserfenster öffnen.
4. Auf das markierte Element klicken.
5. In Trustlytics zum Bereich «Ereignisse» wechseln. Der Eintrag erscheint live.

Tipps für die Namenswahl

• Verständliche Begriffe benutzen. «Newsletter-Anmeldung» ist besser als «form1».
• Beim Ereignisnamen sind Leerzeichen und Umlaute erlaubt. «Termin gebucht» oder «Plan ausgewählt» funktionieren problemlos.
• Bei Eigenschaftsnamen nur Kleinbuchstaben, Zahlen, Unterstrich. Also plan_typ ist in Ordnung. plan-typ oder Plan sind es nicht.
• Eigenschaftswerte dürfen alles enthalten. «pro Tarif», «39.90 CHF», «DE-AT». Kein Problem.
• Bleiben Sie bei einer Schreibweise. «Newsletter-Anmeldung» und «Newsletter Anmeldung» sind für Trustlytics zwei verschiedene Ereignisse. Das merken Sie erst, wenn die Auswertung Ihre Zahlen auf zwei Zeilen verteilt.

Datenschutz

Eine Bitte: Keine persönlichen Daten in die Werte schreiben. Keine E-Mail-Adressen, keine Namen, keine Telefonnummern.

• Schlecht: data-trustlytics-event-property-email="max@example.com"
• Gut: data-trustlytics-event-property-segment="bestandskunde"

Ein Ereignis entfernen

Löschen Sie einfach das data-trustlytics-event-Attribut aus Ihrem HTML. Ab diesem Moment wird nichts mehr gezählt. Bereits gesammelte Daten bleiben in Ihren Berichten erhalten.

Typische Stolpersteine

Fünf Dinge, an denen es beim Einrichten am häufigsten scheitert:

• Grossbuchstaben im Eigenschaftsnamen. property-Plan funktioniert nicht, property-plan schon. Beim Ereignisnamen dagegen ist alles erlaubt. Diese Ungleichheit übersieht fast jeder einmal.
• Zwei Schreibweisen für dieselbe Sache. Heute «Demo gebucht», morgen «Demo Gebucht». In der Auswertung stehen dann zwei Ereignisse, und keines zeigt die volle Zahl.
• Das Attribut sitzt am falschen Element. Am Formular zählt das Abschicken, am Button darin der Klick. Beides ist richtig, aber es misst Unterschiedliches.
• Währungszeichen im Wert. data-trustlytics-event-value="CHF 125" ist keine Zahl. Richtig ist 125.00, ohne alles.
• Zwanzig Ereignisse auf einmal markiert. Danach ist die Liste voll und die Übersicht weg. Fangen Sie mit drei bis fünf an, den wichtigsten.

Häufige Fragen

Was, wenn jemand sehr schnell mehrmals klickt?
Jeder Klick zählt einzeln. Wenn jemand dreimal hintereinander auf denselben Button klickt, sehen Sie auch drei Ereignisse. Das ist Absicht, weil Trustlytics nicht raten möchte, was Sie zählen wollen. Grenze: 200 Ereignisse pro Besuch.

Werden Bots gezählt?
Nein. Suchmaschinen-Crawler und Bots werden automatisch herausgefiltert.

Wie genau ist die Zählung?
Jedes Ereignis wird gespeichert. Der aktuelle Tag wird live ausgewertet, die Werte vom Vortag erscheinen final am Morgen danach.

Funktioniert das auch mit React, Vue oder Next.js?
Ja. Das data-trustlytics-event-Attribut funktioniert in jedem Framework. Setzen Sie es einfach im JSX oder Template, gleich wie in normalem HTML.

Was passiert, wenn ich eine Eigenschaft später ändere?
Wenn Sie heute property-plan="starter" schreiben und morgen property-plan="basic", zählt Trustlytics beide getrennt. In der Auswertung erkennen Sie beide Werte nebeneinander.

Kann ich Markierungen nachträglich ändern?
Ja, jederzeit. Alte Ereignisse bleiben mit dem alten Namen erhalten. Neue kommen mit dem neuen Namen herein.

Was ist der Unterschied zwischen Ereignis-Wert und Eigenschaft?
Eine Eigenschaft speichert Text und teilt Ihr Ereignis in Kategorien auf, etwa nach Plan oder Sprache. Der Ereignis-Wert speichert eine Zahl, mit der sich rechnen lässt, etwa einen Betrag. Faustregel: Möchten Sie später gruppieren, nehmen Sie eine Eigenschaft. Möchten Sie summieren, nehmen Sie den Wert.

Kann ich Wert und Eigenschaften gleichzeitig verwenden?
Ja, das ist sogar der Normalfall bei Bestellungen. Der Wert trägt den Betrag, eine Eigenschaft die Zahlungsart oder das Land. Beide stören sich nicht.

Brauche ich data-trustlytics-event-on überhaupt?
In den meisten Fällen nicht. Trustlytics erkennt von selbst, ob geklickt, abgeschickt oder ausgewählt wurde. Sie brauchen es nur, wenn Sie diesen Standard bewusst überschreiben möchten.

Zählen meine eigenen Klicks mit?
Ja. Wenn Sie zum Prüfen selbst auf den Button klicken, ist das ein Ereignis wie jedes andere. Bei kleineren Webseiten fällt das ins Gewicht, rechnen Sie also damit, dass die ersten Einträge von Ihnen stammen.