# Inserción

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

> Inserta un quiz directamente en tu propio sitio para que los visitantes respondan sin salir de la página: los modos disponibles, el código que genera cada uno y qué modo conviene a cada página.

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)

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

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

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

```html
<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](https://docs.rooquiz.com/es/publish/tracking) y el desglose por origen en [Insights](https://docs.rooquiz.com/es/results/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](#eventos-de-conversión))                                                                                                                                                                                                                                                                                    |
| `data-rooquiz-pass`         | [Parámetros de URL](https://docs.rooquiz.com/es/publish/tracking) 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](https://docs.rooquiz.com/es/publish/ad-pixels).

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

```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 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](https://docs.rooquiz.com/es/results/records).
</Callout>
