Mit dem Element „Seiten-Ereignis“ reagierst du darauf, was ein Kontakt auf deiner Seite tut. Er sieht dein Video bis zum Ende, klappt die Preise auf oder klickt auf den Call-to-Action. Deine Seite meldet das an Quentn, und die Kampagne führt den Kontakt passend weiter.
So schickst du zum Beispiel allen, die dein Webinar-Video zu Ende gesehen haben, eine andere E-Mail als denen, die abgebrochen haben. Oder du setzt ihnen ein Tag, um sie später gezielt anzusprechen.
Auf einen Blick:
- Verhalten statt Vermutung: Du reagierst auf das, was Kontakte auf deiner Seite tatsächlich tun.
- Frei wählbare Ereignisse: Du legst selbst fest, welche Momente zählen, zum Beispiel
video_completedodercta_clicked. - Einfach einzubauen: Mit der KI-Prompt-Vorlage übernimmt dein KI-Tool das.
- Datensparsam: Quentn setzt kein Cookie und sendet nur die Ereignisse, die du ausdrücklich einbaust.
Wofür du das Element nutzt
Deine Seite kann Quentn melden, was ein Kontakt dort tut, zum Beispiel:
| Ereignis | Bedeutung |
|---|---|
video_completed | Video bis zum Ende angesehen |
pricing_opened | Preise aufgeklappt |
cta_clicked | Call-to-Action geklickt |
scrolled_to_end | bis zum Ende der Seite gescrollt |
Das Element „Seiten-Ereignis“ reagiert auf ein solches Ereignis und führt den Kontakt ab dort durch die Kampagne weiter.
Welche Seiten Ereignisse senden können
- Seiten des Elements „Seite“
- statische Seiten mit eigenem HTML (Seiten mit frei wählbarem Pfad, auch die Startseite deiner Domain)
Beide müssen auf deiner eigenen Domain liegen, die live ist.
Hinweis: Landing Pages aus dem Drag-and-Drop-Editor können keine Seiten-Ereignisse senden.
Voraussetzungen
- Deine Domain ist eingerichtet und live.
- Für die Domain ist der Schalter „Kontakte erkennen“ eingeschaltet. Du findest ihn in der Domain-Verwaltung, standardmäßig ist er an.
- Die Seite ist aus eigenem HTML gebaut (siehe oben).
Einrichten in fünf Schritten
Schritt 1: Element einfügen
Ziehe „Seiten-Ereignis“ aus dem Seitenbereich (Bereich „AI-Code-Tools“) in deine Kampagne.
Schritt 2: Namen des Ereignisses eingeben
Gib den Namen ein, zum Beispiel video_completed.
- Erlaubte Zeichen: Kleinbuchstaben, Ziffern und Unterstriche, höchstens 64 Zeichen.
- Automatische Korrektur: Großbuchstaben wandelt Quentn beim Speichern in Kleinbuchstaben um. Leerzeichen am Anfang und Ende entfernt es.
- Vorschläge: Namen, die du in anderen Seiten-Ereignissen schon verwendest, werden dir beim Tippen vorgeschlagen.
Schritt 3: Seite wählen
| Auswahl | Wirkung |
|---|---|
| Jede Seite | Das Element reagiert auf das Ereignis, egal von welcher deiner Seiten es kommt. |
| Eine bestimmte Seite | Das Element reagiert nur auf Ereignisse dieser Seite. |
Die Liste zeigt die Seiten gruppiert nach Domain, jeweils mit Pfad und Titel. Statische Seiten sind als „(statische Seite)“ markiert.
Schritt 4: Ereignis in die Seite einbauen
Du baust die Seite mit KI:
Die KI-Prompt-Vorlage der Seite erklärt dem KI-Tool die Ereignisse und nennt die Namen, auf die deine Seiten-Ereignisse warten.
Tipp: Lege die Seiten-Ereignisse am besten vor dem Bauen der Seite an. Gibt es noch keine, wählt das KI-Tool selbst passende Namen und nennt sie dir. Diese trägst du dann im Element ein.
Du hast schon eine fertige Seite:
Füge an der Stelle im Code, an der das Ereignis passiert, diese Zeile ein:
window.Quentn && Quentn.track("video_completed")
Schritt 5: Kampagne veröffentlichen
Ein Seiten-Ereignis, das nur im Entwurf der Kampagne steckt, reagiert noch nicht. Erst nach dem Veröffentlichen ist es aktiv.
Auf der Arbeitsfläche heißt das Element dann zum Beispiel „Seiten-Ereignis: video_completed“.
Welche Kontakte erkannt werden
Ereignisse zählen nur für Kontakte, die Quentn auf der Seite erkennt. Das sind Kontakte, die
- über einen Link in einer E-Mail von Quentn auf die Seite gekommen sind,
- über ein Weiterleitungs-Element gekommen sind,
- nach der Bestätigung des Double-Opt-ins auf die Seite weitergeleitet wurden,
- nach dem Absenden eines Formulars von Quentn (Landing Page oder Formular) auf die Seite weitergeleitet wurden oder
- auf der Seite selbst ein Formular abgeschickt haben (Element „Seite“).
Andere Besucher senden keine Ereignisse, und Quentn speichert für sie nichts.
So funktioniert es technisch: Quentn hängt an solche Links ein Erkennungsmerkmal an (Parameter
qt). Die Seite liest es beim Laden aus und entfernt es sofort wieder aus der Adresszeile. Es taucht also weder in geteilten Links noch in deiner Webanalyse auf. Links zu Seiten aus dem Drag-and-Drop-Editor bekommen dieses Merkmal nicht.
Gut zu wissen
Wann ein Ereignis zählt
- Höchstens einmal in 10 Minuten: Ein Ereignis zählt höchstens einmal in 10 Minuten pro Kontakt, Ereignis und Seite. Lädt jemand die Seite mehrmals neu oder klickt mehrfach, wird der Kontakt nicht mehrfach weitergeführt.
- Einmal pro Seitenaufruf: Die Seite sendet jeden Ereignis-Namen pro Seitenaufruf nur einmal.
- Nur, wenn jemand zuhört: Ereignisse, auf die kein Seiten-Ereignis in einer veröffentlichten Kampagne wartet, verwirft Quentn, ohne etwas zu speichern.
- Vorschau: In der Vorschau sendet die Seite keine Ereignisse.
Namen und Seiten
- Mehrere Seiten, gleicher Name: Zwei Seiten-Ereignisse mit demselben Namen, die auf verschiedene Seiten warten, kommen sich nicht in die Quere. Ein Element mit „Jede Seite“ reagiert auf jede Seite einzeln.
- Gleiche Namen bewusst wählen: Nutze denselben Namen auf verschiedenen Seiten nur für dieselbe Art von Moment (z. B.
video_completed). Ein Seiten-Ereignis mit „Jede Seite“ würde sonst auf beides reagieren. - Seite gelöscht: Wird die gewählte Seite gelöscht, zeigt das Element „Gelöschte Seite“ an und reagiert nicht mehr. Wähle dann eine andere Seite.
Historie und Kopien
- Kontakthistorie: Jedes gezählte Ereignis erscheint in der Kontakthistorie als „Seiten-Ereignis“ mit dem Namen des Ereignisses. Im Filter der Historie kannst du gezielt danach suchen.
- Kampagne kopieren: Kopierst du eine Kampagne mit einem Element „Seite“ und einem Seiten-Ereignis, das auf diese Seite wartet, wartet die Kopie auf die kopierte Seite.
- Export und Import: Beim Export und Import einer Kampagne geht die Auswahl der Seite verloren. Wähle sie danach neu.
Datenschutz
- Kein Cookie: Quentn setzt für Seiten-Ereignisse kein Cookie und speichert nichts im Browser. Ein Kontakt wird nur während des aktuellen Seitenaufrufs erkannt.
- Nichts Automatisches: Das Skript von Quentn sendet nichts von sich aus, also auch keine automatischen Seitenaufrufe. Es sendet nur die Ereignisse, die du ausdrücklich mit
Quentn.track()einbaust. - Wiedererkennen bei späteren Besuchen: Dafür muss deine Seite das Erkennungsmerkmal selbst speichern (z. B. in einem Cookie) und beim nächsten Besuch mit
Quentn.setToken()wieder setzen. Ob du dafür die Einwilligung deiner Besucher brauchst, prüfst du nach dem Recht, das für dich gilt. - Deine Verantwortung: Für die Einwilligung deiner Besucher bist du als Betreiber der Seite verantwortlich.
- Erkennung ausschalten: Willst du auf einer Domain gar keine Kontakte erkennen, schalte „Kontakte erkennen“ in der Domain-Verwaltung aus. Dann bekommen Links zu dieser Domain kein Erkennungsmerkmal mehr, und die Seiten dort senden keine Ereignisse.
Für Entwickler: die JavaScript-Schnittstelle
Auf jeder Seite aus eigenem HTML stellt Quentn das Objekt window.Quentn bereit, bevor die Skripte der Seite laufen.
| Aufruf | Was er tut |
|---|---|
Quentn.submit(values) | Sendet die Formularwerte an Quentn (nur Element „Seite“ mit eingeschaltetem Formular). Gibt ein Promise zurück. In der Vorschau sendet es nichts. |
Quentn.track(name) | Sendet ein Seiten-Ereignis. Tut nichts, wenn der Kontakt nicht erkannt ist, in der Vorschau oder bei einem ungültigen Namen. Wirft nie einen Fehler. |
Quentn.token | Das aktuelle Erkennungsmerkmal oder null. |
Quentn.setToken(token) | Setzt ein Erkennungsmerkmal, das die Seite selbst gespeichert hat (z. B. nach Einwilligung), oder eines aus der Antwort eines Formulars, das nicht mit Quentn.submit() gesendet wurde (Feld contactToken). Gibt true zurück, wenn es übernommen wurde. |
Quentn.preview | true in der Vorschau. |
Wichtig: Während du die Seite lokal entwickelst, gibt es
window.Quentnnicht. Schreib Aufrufe deshalb immer abgesichert, zum Beispielwindow.Quentn && Quentn.track("video_completed").
Häufige Fragen
Kann ich das Element „Seite“ ohne eigene Domain nutzen?
Nein. Seiten aus eigenem HTML laufen nur auf deiner eigenen Domain, die live ist.
Ich habe die Seite neu hochgeladen, aber online sehe ich noch die alte Version.
Hast du das Element gespeichert und die Kampagne veröffentlicht? Erst dann geht die neue Version live.
Bilder oder Skripte werden auf der Seite nicht geladen.
Meist sind die Pfade absolut (/assets/...). Stell sie auf relative Pfade um (./assets/..., in Vite base: './') und lade den Build neu hoch.
Mein Seiten-Ereignis reagiert nicht.
Geh diese Punkte durch:
- Ist die Kampagne veröffentlicht?
- Stimmt der Name im Element genau mit dem Namen in
Quentn.track()überein? - Ist die richtige Seite gewählt (oder „Jede Seite“)?
- Kam der Kontakt über einen Quentn-Link oder ein Formular auf die Seite? Direkt aufgerufene Seiten erkennen niemanden.
- Ist „Kontakte erkennen“ für die Domain eingeschaltet?
- Hast du in der Vorschau getestet? Dort werden keine Ereignisse gesendet.
- Hat derselbe Kontakt das Ereignis in den letzten 10 Minuten schon ausgelöst?
Kann ich Seiten-Ereignisse auf einer Landing Page aus dem Drag-and-Drop-Editor nutzen?
Nein, nur auf Seiten aus eigenem HTML (Element „Seite“ und statische Seiten mit eigenem HTML).
Kann ich Videos hochladen?
Nein. Bette Videos von einem anderen Dienst ein, zum Beispiel YouTube oder Vimeo.