Intégration
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)
<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
<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
<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 et par la répartition par source dans les Statistiques |
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) |
data-rooquiz-pass | Paramètres d'URL 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.
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 :
<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>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.
Lien public et QR code
Le lien public est le moyen le plus courant de diffuser un quiz. Comment le copier, générer et télécharger un QR code pour vos imprimés ou présentations, et ce qui change si le quiz exige une connexion.
Carte de partage social
La carte de partage social (Open Graph) est l'aperçu affiché par les messageries et réseaux sociaux quand on colle le lien du quiz. Personnalisez titre, description et image pour plus de clics.