# Intégration

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

> Intégrez un quiz directement à votre site pour que les visiteurs répondent sans quitter la page : modes d'intégration disponibles, code généré par chacun et mode adapté à chaque type de page.

Au-delà du partage d'un lien, vous pouvez **intégrer un quiz directement à votre propre site web** : les visiteurs y répondent sur votre page d'atterrissage sans la quitter.

## Trois modes d'intégration

Ouvrez **Partager** → **Intégrer** sur le quiz concerné, choisissez un mode d'affichage, puis copiez le code généré dans le HTML de votre site.

| Mode                               | Idéal pour                                                   | Comportement                                               |
| ---------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------- |
| **En ligne (hauteur automatique)** | S'insérer dans le flux de contenu de la page                 | La hauteur s'adapte automatiquement au contenu. Recommandé |
| **Pop-up**                         | Un bouton d'appel à l'action sur votre page                  | Ouvre le quiz dans une surcouche plein écran               |
| **Iframe simple (hauteur fixe)**   | Les environnements où il est impossible de charger un script | Le plus simple ; hauteur fixe avec défilement interne      |

### En ligne (hauteur automatique)

```html
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>
```

Le script d'intégration surveille la hauteur du contenu du quiz (pagination, passage à la page de résultat, etc.) et redimensionne l'iframe en temps réel : ni barres de défilement, ni contenu tronqué.

### Pop-up

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

Un bouton s'affiche sur votre page ; un clic ouvre le quiz dans une surcouche plein écran. Fermez-la avec Échap ou en cliquant sur le masque.

### Iframe simple

```html
<iframe src="https://YOUR_QUIZ_DOMAIN/a/YOUR_QUIZ_TOKEN?embed=1" width="100%" height="600" style="border:0;" title="RooQuiz"></iframe>
```

L'iframe pointe toujours vers l'adresse stable `/a/<token>` du quiz, et non vers son chemin personnalisé : modifier plus tard le chemin personnalisé ne casse donc jamais le code d'intégration déjà présent sur votre site.

## La mention « Made with RooQuiz »

Avec le **forfait Free**, les intégrations conservent une petite mention **Made with RooQuiz**. Elle se trouve **en dehors de l'iframe**, sur votre page : les intégrations en ligne et en popup l'affichent automatiquement via `embed.js`, et le code de l'iframe simple l'inclut sous forme de `<p>` juste sous l'iframe ; laissez-la en place. Avec **Pro**, le code généré ne l'inclut pas.

## Attributs disponibles

| Attribut                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data-rooquiz-token`        | Obligatoire. Le jeton public du quiz                                                                                                                                                                                                                                                                                                                                                                                         |
| `data-rooquiz-mode`         | `inline` (par défaut) ou `popup`                                                                                                                                                                                                                                                                                                                                                                                             |
| `data-rooquiz-utm-source`   | Source UTM enregistrée avec chaque réponse, utilisée par le [Suivi des sources UTM](https://docs.rooquiz.com/fr/publish/tracking) et par la répartition par source dans les [Statistiques](https://docs.rooquiz.com/fr/results/insights)                                                                                                                                                                                                                                     |
| `data-rooquiz-utm-medium`   | Support UTM (facultatif)                                                                                                                                                                                                                                                                                                                                                                                                     |
| `data-rooquiz-utm-campaign` | Campagne UTM (facultatif)                                                                                                                                                                                                                                                                                                                                                                                                    |
| `data-rooquiz-height`       | Hauteur initiale (px) en mode en ligne, utilisée avant que le redimensionnement automatique ne prenne le relais                                                                                                                                                                                                                                                                                                              |
| `data-rooquiz-text`         | Libellé du bouton en mode pop-up                                                                                                                                                                                                                                                                                                                                                                                             |
| `data-rooquiz-track`        | `auto` : déclenche aussi les pixels Meta et TikTok déjà présents sur votre page (voir [Événements de conversion](#événements-de-conversion))                                                                                                                                                                                                                                                                                 |
| `data-rooquiz-pass`         | [Paramètres d'URL](https://docs.rooquiz.com/fr/publish/tracking) séparés par des virgules, copiés depuis l'adresse de votre page vers le quiz, par ex. `partner,campaign_id` (ajoutez `email,name` pour préremplir le formulaire de lead). Avec l'API JS, passez `params: { partner: 'acme' }` pour fixer des valeurs Après avoir modifié les paramètres d'URL du quiz, recopiez le code d'intégration : celui déjà installé garde l'ancienne liste. |

Si vous ne définissez pas les attributs UTM, les éventuels paramètres `utm_*` présents dans l'URL de la page hôte sont transmis automatiquement.

## Événements de conversion

Avec l'offre **Pro**, les intégrations en ligne et pop-up transmettent à votre page les événements de conversion du quiz : quiz commencé, lead capturé, quiz terminé, clic sur le CTA, etc. Chacun est poussé dans le `dataLayer` de votre page sous le nom `rooquiz_<événement>` (pour votre propre Google Tag Manager) et émis comme événement navigateur `rooquiz:<événement>`. Ajoutez `data-rooquiz-track="auto"`, ou activez **Déclencher aussi les pixels Meta et TikTok de ma page** dans le panneau d'intégration, pour les envoyer directement aux pixels déjà installés sur votre page. Avec l'API JS, passez `track: 'auto'`.

Un iframe simple ne peut pas transmettre d'événements. La liste complète figure dans [Pixels de suivi publicitaire](https://docs.rooquiz.com/fr/publish/ad-pixels).

## API JS

Si vous avez besoin d'un déclencheur personnalisé (par exemple votre propre bouton qui ouvre la pop-up), appelez directement l'API :

```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">
  La page intégrée masque automatiquement le pied de page et l'arrière-plan pour se fondre de manière transparente dans votre site ; les couleurs de votre thème s'appliquent toujours. Les réponses recueillies via une intégration apparaissent normalement dans les [Réponses](https://docs.rooquiz.com/fr/results/records).
</Callout>
