Einbetten
Neben dem Teilen eines Links können Sie ein Quiz direkt in Ihre eigene Website einbetten – Besucher füllen es auf Ihrer Landingpage aus, ohne sie zu verlassen.
Drei Einbettungsmodi
Öffnen Sie im gewünschten Quiz Teilen → Einbetten, wählen Sie einen Anzeigemodus und kopieren Sie den erzeugten Code in das HTML Ihrer Website.
| Modus | Ideal für | Verhalten |
|---|---|---|
| Inline (automatische Höhe) | Nahtlose Integration in den Inhaltsfluss der Seite | Die Höhe passt sich automatisch dem Inhalt an. Empfohlen |
| Popup | Einen Call-to-Action-Button auf Ihrer Seite | Öffnet das Quiz in einem Vollbild-Overlay |
| Einfaches iframe (feste Höhe) | Umgebungen, in denen kein Skript geladen werden kann | Am einfachsten; feste Höhe mit internem Scrollen |
Inline (automatische Höhe)
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>Das Einbettungsskript beobachtet die Höhe des Quiz-Inhalts (Seitenwechsel, Wechsel zur Ergebnisseite usw.) und passt die Größe des iframes in Echtzeit an – keine Scrollleisten, nichts wird abgeschnitten.
Popup
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN" data-rooquiz-mode="popup" data-rooquiz-text="Start the quiz"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>Auf Ihrer Seite wird ein Button angezeigt; ein Klick darauf öffnet das Quiz in einem Vollbild-Overlay. Geschlossen wird es mit ESC oder per Klick auf den abgedunkelten Hintergrund.
Einfaches iframe
<iframe src="https://YOUR_QUIZ_DOMAIN/a/YOUR_QUIZ_TOKEN?embed=1" width="100%" height="600" style="border:0;" title="RooQuiz"></iframe>Das iframe verweist immer auf die stabile Adresse /a/<token> des Quiz, nicht auf seinen benutzerdefinierten Pfad. Wenn Sie den benutzerdefinierten Pfad später ändern, funktioniert bereits auf Ihrer Website eingebundener Einbettungscode also weiterhin.
Die Zeile „Made with RooQuiz“
Im Free-Tarif enthalten Einbettungen eine kleine Hinweiszeile Made with RooQuiz. Sie steht außerhalb des iframes auf Ihrer Seite: Inline- und Popup-Einbettungen rendern sie automatisch über embed.js, und der einfache iframe-Code enthält sie als <p> direkt unter dem iframe – lassen Sie sie dort stehen. Im Pro-Tarif lässt der generierte Code sie weg.
Verfügbare Attribute
| Attribut | Beschreibung |
|---|---|
data-rooquiz-token | Erforderlich. Der öffentliche Token des Quiz |
data-rooquiz-mode | inline (Standard) oder popup |
data-rooquiz-utm-source | UTM-Quelle, die mit jeder Antwort gespeichert wird; genutzt vom UTM-Quellen-Tracking und von der Aufschlüsselung nach Quelle in Insights |
data-rooquiz-utm-medium | UTM-Medium (optional) |
data-rooquiz-utm-campaign | UTM-Kampagne (optional) |
data-rooquiz-height | Anfangshöhe (px) im Inline-Modus, bevor die automatische Größenanpassung greift |
data-rooquiz-text | Beschriftung des Buttons im Popup-Modus |
data-rooquiz-track | auto: löst zusätzlich die bereits auf Ihrer Seite installierten Meta- und TikTok-Pixel aus (siehe Conversion-Events) |
data-rooquiz-pass | Kommagetrennte URL-Parameter, die aus der Adresse Ihrer Seite ans Quiz weitergegeben werden, z. B. partner,campaign_id (mit email,name wird das Lead-Formular vorausgefüllt). In der JS-API setzen Sie Werte direkt mit params: { partner: 'acme' } Nach einer Änderung der URL-Parameter kopieren Sie den Einbettungscode erneut – bereits eingebundener Code behält die alte Liste. |
Wenn Sie die UTM-Attribute nicht setzen, werden alle utm_*-Parameter aus der URL der einbettenden Seite automatisch übernommen.
Conversion-Events
Im Pro-Tarif geben Inline- und Popup-Einbettungen die Conversion-Events des Quiz – Quiz gestartet, Lead gewonnen, Quiz abgeschlossen, CTA geklickt und mehr – an Ihre Seite weiter. Jedes Event landet als rooquiz_<event> im dataLayer Ihrer Seite (für Ihren eigenen Google Tag Manager) und wird als Browser-Event rooquiz:<event> ausgelöst. Mit data-rooquiz-track="auto" oder dem Schalter Auch die Meta- und TikTok-Pixel meiner Seite auslösen im Einbettungsbereich gehen die Events direkt an die bereits auf Ihrer Seite installierten Pixel. In der JS-API übergeben Sie track: 'auto'.
Ein einfaches iframe kann keine Events weitergeben. Die vollständige Event-Liste finden Sie unter Werbe-Tracking-Pixel.
JS-API
Wenn Sie einen eigenen Auslöser benötigen (z. B. einen selbst gestalteten Button, der das Popup öffnet), rufen Sie die API direkt auf:
<script src="https://YOUR_QUIZ_DOMAIN/embed.js"></script>
<script>
// Mount an inline embed manually
RooQuiz.embed({ el: '#container', token: 'YOUR_QUIZ_TOKEN', utmSource: 'homepage' })
// Open the popup from any element
document.querySelector('#my-button').onclick = () => RooQuiz.open('YOUR_QUIZ_TOKEN', { utmSource: 'homepage' })
</script>Die eingebettete Seite blendet Fußzeile und Hintergrund automatisch aus und fügt sich transparent in Ihre Website ein; Ihre Theme-Farben gelten weiterhin. Über Einbettungen gesammelte Antworten erscheinen wie gewohnt unter Einsendungen.
Öffentlicher Link & QR-Code
Der öffentliche Link ist der häufigste Weg, ein Quiz zu verteilen. So kopieren Sie ihn, erzeugen und laden einen QR-Code für Druck oder Folien herunter und was sich ändert, wenn das Quiz eine Anmeldung verlangt.
Social-Share-Card
Die Social-Share-Card (Open Graph) ist das, was Chat-Apps und soziale Netzwerke anzeigen, wenn Ihr Quiz-Link eingefügt wird. Passen Sie Titel, Beschreibung und Vorschaubild an, um mehr Klicks zu erzielen.