# Einbetten

Source: https://docs.rooquiz.com/de/publish/embed

> Betten Sie ein Quiz direkt in Ihre eigene Website ein, damit Besucher antworten, ohne die Seite zu verlassen: die verfügbaren Einbettungsmodi, der jeweils erzeugte Code und welcher Modus zu welcher Seite passt.

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)

```html
<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

```html
<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

```html
<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](https://docs.rooquiz.com/de/publish/tracking) und von der Aufschlüsselung nach Quelle in [Insights](https://docs.rooquiz.com/de/results/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](#conversion-events))                                                                                                                                                                                                                                                                        |
| `data-rooquiz-pass`         | Kommagetrennte [URL-Parameter](https://docs.rooquiz.com/de/publish/tracking), 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](https://docs.rooquiz.com/de/publish/ad-pixels).

## 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:

```html
<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>
```

<Callout type="info">
  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](https://docs.rooquiz.com/de/results/records).
</Callout>
