RooQuiz Docs
Publier et partager

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.

ModeIdéal pourComportement
En ligne (hauteur automatique)S'insérer dans le flux de contenu de la pageLa hauteur s'adapte automatiquement au contenu. Recommandé
Pop-upUn bouton d'appel à l'action sur votre pageOuvre le quiz dans une surcouche plein écran
Iframe simple (hauteur fixe)Les environnements où il est impossible de charger un scriptLe 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

AttributDescription
data-rooquiz-tokenObligatoire. Le jeton public du quiz
data-rooquiz-modeinline (par défaut) ou popup
data-rooquiz-utm-sourceSource 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-mediumSupport UTM (facultatif)
data-rooquiz-utm-campaignCampagne UTM (facultatif)
data-rooquiz-heightHauteur initiale (px) en mode en ligne, utilisée avant que le redimensionnement automatique ne prenne le relais
data-rooquiz-textLibellé du bouton en mode pop-up
data-rooquiz-trackauto : déclenche aussi les pixels Meta et TikTok déjà présents sur votre page (voir Événements de conversion)
data-rooquiz-passParamè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.

Sur cette page