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.
| Modo | Ideal para | Comportamiento |
|---|---|---|
| En línea (altura automática) | Integrarse en el flujo de contenido de la página | La altura sigue automáticamente al contenido. Recomendado |
| Ventana emergente | Un botón de llamada a la acción en tu página | Abre el quiz en una superposición de pantalla completa |
| Iframe simple (altura fija) | Entornos en los que no es posible cargar un script | El 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
| Atributo | Descripción |
|---|---|
data-rooquiz-token | Obligatorio. El token público del quiz |
data-rooquiz-mode | inline (predeterminado) o popup |
data-rooquiz-utm-source | Fuente UTM registrada con cada respuesta, utilizada por el seguimiento de origen con UTM y el desglose por origen en Insights |
data-rooquiz-utm-medium | Medio UTM (opcional) |
data-rooquiz-utm-campaign | Campaña UTM (opcional) |
data-rooquiz-height | Altura inicial (px) para el modo en línea, usada antes de que se active el ajuste automático |
data-rooquiz-text | Texto del botón para el modo de ventana emergente |
data-rooquiz-track | auto: dispara también los píxeles de Meta y TikTok que ya tiene tu página (consulta Eventos de conversión) |
data-rooquiz-pass | Pará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.
Enlace público y código QR
El enlace público es la forma más habitual de distribuir un quiz. Cómo copiarlo, generar y descargar un código QR para impresos o presentaciones, y qué cambia cuando el quiz exige iniciar sesión.
Tarjeta para redes sociales
La tarjeta para redes sociales (Open Graph) es lo que muestran las apps de chat y las redes al pegar el enlace de tu quiz. Personaliza el título, la descripción y la imagen para mejorar los clics.