RooQuiz Doku
Veröffentlichen & Teilen

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.

ModusIdeal fürVerhalten
Inline (automatische Höhe)Nahtlose Integration in den Inhaltsfluss der SeiteDie Höhe passt sich automatisch dem Inhalt an. Empfohlen
PopupEinen 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 kannAm 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.

<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

AttributBeschreibung
data-rooquiz-tokenErforderlich. Der öffentliche Token des Quiz
data-rooquiz-modeinline (Standard) oder popup
data-rooquiz-utm-sourceUTM-Quelle, die mit jeder Antwort gespeichert wird; genutzt vom UTM-Quellen-Tracking und von der Aufschlüsselung nach Quelle in Insights
data-rooquiz-utm-mediumUTM-Medium (optional)
data-rooquiz-utm-campaignUTM-Kampagne (optional)
data-rooquiz-heightAnfangshöhe (px) im Inline-Modus, bevor die automatische Größenanpassung greift
data-rooquiz-textBeschriftung des Buttons im Popup-Modus
data-rooquiz-trackauto: löst zusätzlich die bereits auf Ihrer Seite installierten Meta- und TikTok-Pixel aus (siehe Conversion-Events)
data-rooquiz-passKommagetrennte 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.

Auf dieser Seite