RooQuiz Docs
Publicar y compartir

Inserción

Además de compartir un enlace, puedes insertar un quiz directamente en tu propio sitio web: los visitantes lo completan en tu página de destino sin salir de ella.

Tres modos de inserción

Abre Compartir → Insertar en el quiz que quieras, elige un modo de visualización y copia el código generado en el HTML de tu sitio.

ModoIdeal paraComportamiento
En línea (altura automática)Integrarse en el flujo de contenido de la páginaLa altura sigue automáticamente al contenido. Recomendado
Ventana emergenteUn botón de llamada a la acción en tu páginaAbre el quiz en una superposición de pantalla completa
Iframe simple (altura fija)Entornos en los que no es posible cargar un scriptEl más sencillo; altura fija con desplazamiento interno

En línea (altura automática)

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

El script de inserción vigila la altura del contenido del quiz (paginación, paso a la página de resultados, etc.) y redimensiona el iframe en tiempo real: sin barras de desplazamiento ni recortes.

Ventana emergente

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

Se muestra un botón en tu página; al hacer clic, el quiz se abre en una superposición de pantalla completa. Se cierra con ESC o haciendo clic en la máscara.

Iframe simple

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

El iframe siempre apunta a la dirección estable /a/<token> del quiz, no a su ruta personalizada, así que cambiar la ruta personalizada más adelante nunca rompe el código de inserción que ya está en tu web.

La línea "Made with RooQuiz"

En el plan Free, las inserciones conservan una pequeña línea de crédito Made with RooQuiz. Está fuera del iframe, en tu página: las inserciones en línea y emergentes la muestran automáticamente mediante embed.js, y el código de iframe simple la incluye como un <p> justo debajo del iframe; déjala ahí. En Pro, el código generado no la incluye.

Atributos disponibles

AtributoDescripción
data-rooquiz-tokenObligatorio. El token público del quiz
data-rooquiz-modeinline (predeterminado) o popup
data-rooquiz-utm-sourceFuente UTM registrada con cada respuesta, utilizada por el seguimiento de origen con UTM y el desglose por origen en Insights
data-rooquiz-utm-mediumMedio UTM (opcional)
data-rooquiz-utm-campaignCampaña UTM (opcional)
data-rooquiz-heightAltura inicial (px) para el modo en línea, usada antes de que se active el ajuste automático
data-rooquiz-textTexto del botón para el modo de ventana emergente
data-rooquiz-trackauto: dispara también los píxeles de Meta y TikTok que ya tiene tu página (consulta Eventos de conversión)
data-rooquiz-passParámetros de URL separados por comas que se copian de la dirección de tu página al quiz, p. ej. partner,campaign_id (añade email,name para rellenar el formulario de leads). Con la API de JS, pasa params: { partner: 'acme' } para fijar valores Si cambias los parámetros de URL del quiz, vuelve a copiar el código de inserción: el que ya está en tu web conserva la lista anterior.

Si no defines los atributos UTM, los parámetros utm_* que haya en la URL de la página que aloja el quiz se transmiten automáticamente.

Eventos de conversión

En el plan Pro, las inserciones en línea y emergentes pasan a tu página los eventos de conversión del quiz: quiz iniciado, lead captado, quiz completado, clic en el CTA y más. Cada uno se envía al dataLayer de tu página como rooquiz_<evento> (para tu propio Google Tag Manager) y se emite como evento del navegador rooquiz:<evento>. Añade data-rooquiz-track="auto", o activa Activar también los píxeles de Meta y TikTok de mi página en el panel de inserción, para enviarlos directamente a los píxeles que ya tiene tu página. Con la API de JS, pasa track: 'auto'.

Un iframe simple no puede pasar eventos. Consulta la lista completa en Píxeles de seguimiento publicitario.

API de JS

Cuando necesites un disparador personalizado (p. ej., un botón con tu propio diseño que abra la ventana emergente), llama directamente a la 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 página insertada oculta automáticamente el pie de página y el fondo, y se integra de forma transparente en tu sitio; los colores de tu tema se siguen aplicando. Las respuestas recogidas mediante inserciones aparecen como de costumbre en Registros de respuestas.

En esta página