Skip to main content
Ihr Quiz meldet Ereignisse als Browser-Events auf window. Hören Sie sie ab, um Verhalten in Ihrer Analyse zu erfassen, auf Antworten zu reagieren oder eigenen Code zum richtigen Zeitpunkt auszuführen.
Jedes Event legt seine Daten in event.detail ab. Zwei Angaben sind immer enthalten:
  • quizId: welches Quiz das Event ausgelöst hat
  • llQuizApi: die Quiz-API, sodass Sie das Quiz direkt im Listener auslesen oder ändern können
ll-quiz-init wird ausgelöst, sobald das Quiz bereit ist – das kann vor der Ausführung Ihres Skripts sein. Kein Problem: Ein spät registrierter Listener erhält ll-quiz-init trotzdem. Alle anderen Events werden durch Besucheraktionen ausgelöst, also nachdem Ihr Skript bereitsteht.

Events auf einen Blick

ll-quiz-init

Wird ausgelöst, sobald das Quiz auf der Seite und bereit ist. Hier holen Sie sich llQuizApi, befüllen Werte vor oder richten Dinge ein.
string
LlQuizApi
Die Quiz-API für dieses Quiz

ll-quiz-step-view

Wird jedes Mal ausgelöst, wenn ein Schritt angezeigt wird – auch beim ersten Schritt nach dem Laden und wenn der Besucher zurückgeht.
string
string
Field[]
Bisher gegebene Antworten, siehe fields und fieldsSimple
object
Dieselben Antworten als Label → Wert

ll-quiz-step-leave

Wird ausgelöst, wenn der Besucher einen Schritt verlässt – vor dem nächsten ll-quiz-step-view. Nutzen Sie es, um die Verweildauer eines Schritts zu messen oder einen Entwurf zu speichern.
string

ll-quiz-value-change

Wird ausgelöst, wenn eine Antwort übernommen wird. Getippte Felder (Text, E-Mail, Telefon, Zahl, Textarea, Datum, Geburtsdatum, Postleitzahl, Adresse, OTP) übernehmen den Wert, wenn der Besucher das Feld oder den Schritt verlässt – Sie erhalten also ein Event pro Antwort, nicht pro Tastenanschlag. Alle anderen Eingaben und jeder über die API gesetzte Wert werden sofort übernommen.
string
string
Der im Builder vergebene Name des Blocks
string
Zum Beispiel text-field oder multiple-choice
string
string
string
Die neue Antwort, im selben Format wie Field.value
string
Die zuletzt gemeldete Antwort oder der Wert, mit dem das Quiz geladen wurde
'user' | 'api' | 'system'
user: der Besucher. api: Ihr Skript über die Quiz-API. system: das Quiz selbst, etwa beim Leeren der Antworten nach dem Absenden
Hat sich der Wert nicht geändert, wird nichts ausgelöst. Werte, die beim Laden des Quiz bereits vorhanden sind (Standardwerte, URL-Parameter, wiederhergestellte Antworten), bilden den Ausgangspunkt und lösen nichts aus; sie stehen in fields bei ll-quiz-step-view.

ll-quiz-input-click

Wird ausgelöst, wenn der Besucher eine Option eines Multiple-Choice- oder Bildauswahl-Blocks anklickt. Wird beim selben Klick vor ll-quiz-value-change ausgelöst.
string
string
string
string
string
string
Der Wert der Option, wie er in der Antwort gespeichert wird
string
Der Text, den der Besucher gesehen hat

ll-quiz-button-click

Wird ausgelöst, wenn ein Continue-, Previous-, Submit- oder Button-Block angeklickt wird – vor jeder Validierung. Es wird auch dann ausgelöst, wenn der Klick am Ende blockiert wird; es zählt also Versuche, keine Erfolge.
string
string
string
string
Um zu erfahren, ob der Klick den Besucher tatsächlich weitergebracht hat, kombinieren Sie es mit ll-quiz-step-leave (hat es) oder ll-quiz-validation-error (hat es nicht).

ll-quiz-validation-error

Wird ausgelöst, wenn der Versuch, einen Schritt zu verlassen, blockiert wurde, weil etwas darin ungültig ist. Sie erhalten ein Event pro Versuch, nachdem alle Prüfungen abgeschlossen sind (einschließlich der Serverprüfungen von E-Mail-, Telefon- und OTP-Feldern), mit genau den Fehlern, die der Besucher sieht. Ausgeblendete Blöcke sind nie enthalten.
string
string
'user' | 'api' | 'system'
user: eine Schaltfläche oder eine navigierende Option. api: Ihr Skript (validateStep(), goNext(), goToStep(), submit()). system: das Quiz wollte von selbst weitergehen (Loader, Countdown, Zahlung)
string
Die Schaltfläche oder Option, die es ausgelöst hat; bei api leer
string
Bei api leer
array
Ein Eintrag pro fehlerhaftem Block, in Schrittreihenfolge: blockId, blockName, blockType und messages (die angezeigten Texte; der erste wird dargestellt)
Es wird nicht ausgelöst, wenn der Schritt gültig ist, wenn die Previous-Schaltfläche genutzt wird (sie validiert nie) oder bei einem Auswahlklick, der nicht navigiert.

ll-quiz-google-address-select

Wird ausgelöst, wenn der Besucher in einem Google-Address-Block einen Vorschlag auswählt.
string
string
string
string
object
street, city, state, stateShort, postalCode, country, countryShort

ll-quiz-submit

Wird ausgelöst, wenn das Quiz abgesendet und der Lead gespeichert wurde. Hier senden Sie Antworten weiter oder lösen eine Conversion aus.
string
Der Schritt, aus dem der Besucher abgesendet hat
string
Field[]
Alle Antworten
object
Alle Antworten als Label → Wert
any
Die Antwort des LanderLab-Servers oder null, wenn kein Lead gespeichert wurde (etwa weil das Speichern von Leads in den Quiz-Einstellungen deaktiviert ist)

ll-quiz-exit

Wird ausgelöst, wenn der Tab oder das Fenster geschlossen oder verlassen wird – basierend auf dem pagehide-Event des Browsers.
Browser garantieren dieses Event nicht bei jedem Schließen. Nutzen Sie es für Best-Effort-Tracking mit navigator.sendBeacon, niemals für etwas, das zwingend passieren muss.

fields und fieldsSimple

fields ist eine Liste mit einem Eintrag pro beantwortetem Block:
fieldsSimple enthält dieselben Informationen als ein Objekt mit dem Label als Schlüssel – praktisch zum Weiterleiten:
Beide lassen ausgeblendete Blöcke und leere Antworten aus. Teilen sich zwei Blöcke ein Label, verbindet fieldsSimple ihre Werte mit einem Komma. Die Quiz-API liefert mit getAnswers() und getAnswersSimple() dieselben Strukturen.