# Incorporar

Source: https://docs.rooquiz.com/pt-BR/publish/embed

> Incorpore um quiz diretamente no seu próprio site para que os visitantes respondam sem sair da página: os modos de incorporação disponíveis, o código que cada um gera e qual modo combina com cada página.

Além de compartilhar um link, você pode **incorporar um quiz diretamente no seu próprio site** — os visitantes o respondem na sua landing page sem sair dela.

## Três modos de incorporação

Abra **Compartilhar** → **Incorporar** no quiz desejado, escolha um modo de exibição e copie o código gerado para o HTML do seu site.

| Modo                             | Ideal para                                         | Comportamento                                              |
| -------------------------------- | -------------------------------------------------- | ---------------------------------------------------------- |
| **Inline (altura automática)**   | Integrar-se ao fluxo de conteúdo da página         | A altura acompanha o conteúdo automaticamente. Recomendado |
| **Popup**                        | Um botão de chamada para ação na sua página        | Abre o quiz em uma sobreposição em tela cheia              |
| **iframe simples (altura fixa)** | Ambientes em que não é possível carregar um script | O mais simples; altura fixa com rolagem interna            |

### Inline (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>
```

O script de incorporação acompanha a altura do conteúdo do quiz (paginação, navegação até a página de resultado etc.) e redimensiona o iframe em tempo real — sem barras de rolagem e sem cortes.

### Popup

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

Um botão é exibido na sua página; ao clicar nele, o quiz abre em uma sobreposição em tela cheia. Feche com ESC ou clicando na máscara.

### iframe simples

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

O iframe sempre aponta para o endereço estável `/a/<token>` do quiz, e não para o caminho personalizado, então alterar o caminho personalizado depois nunca quebra um código de incorporação que já está no seu site.

## A linha "Made with RooQuiz"

No **plano Free**, as incorporações mantêm uma pequena linha de crédito **Made with RooQuiz**. Ela fica **fora do iframe**, na sua página: as incorporações inline e popup a exibem automaticamente pelo `embed.js`, e o código de iframe simples a inclui como um `<p>` logo abaixo do iframe — mantenha-o ali. No **Pro**, o código gerado não a inclui.

## Atributos disponíveis

| Atributo                    | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data-rooquiz-token`        | Obrigatório. O token público do quiz                                                                                                                                                                                                                                                                                                                                                                                            |
| `data-rooquiz-mode`         | `inline` (padrão) ou `popup`                                                                                                                                                                                                                                                                                                                                                                                                    |
| `data-rooquiz-utm-source`   | Origem UTM registrada com cada resposta, usada pelo [rastreamento de origem com UTM](https://docs.rooquiz.com/pt-BR/publish/tracking) e pelo detalhamento por origem em [Insights](https://docs.rooquiz.com/pt-BR/results/insights)                                                                                                                                                                                                                                             |
| `data-rooquiz-utm-medium`   | Mídia UTM (opcional)                                                                                                                                                                                                                                                                                                                                                                                                            |
| `data-rooquiz-utm-campaign` | Campanha UTM (opcional)                                                                                                                                                                                                                                                                                                                                                                                                         |
| `data-rooquiz-height`       | Altura inicial (px) no modo inline, usada antes de o redimensionamento automático entrar em ação                                                                                                                                                                                                                                                                                                                                |
| `data-rooquiz-text`         | Texto do botão no modo popup                                                                                                                                                                                                                                                                                                                                                                                                    |
| `data-rooquiz-track`        | `auto`: dispara também os pixels da Meta e do TikTok já instalados na sua página (veja [Eventos de conversão](#eventos-de-conversão))                                                                                                                                                                                                                                                                                           |
| `data-rooquiz-pass`         | [Parâmetros de URL](https://docs.rooquiz.com/pt-BR/publish/tracking) separados por vírgula, copiados do endereço da sua página para o quiz, por exemplo `partner,campaign_id` (adicione `email,name` para preencher o formulário de leads). Na API JS, passe `params: { partner: 'acme' }` para definir valores Depois de mudar os parâmetros de URL do quiz, copie o código de incorporação de novo — o que já está no seu site mantém a lista antiga. |

Se você não definir os atributos UTM, os parâmetros `utm_*` presentes na URL da página que hospeda o quiz são repassados automaticamente.

## Eventos de conversão

No plano **Pro**, as incorporações inline e popup repassam à sua página os eventos de conversão do quiz — quiz iniciado, lead capturado, quiz concluído, clique no CTA e outros. Cada um é enviado ao `dataLayer` da sua página como `rooquiz_<evento>` (para o seu próprio Google Tag Manager) e emitido como evento do navegador `rooquiz:<evento>`. Adicione `data-rooquiz-track="auto"`, ou ative **Disparar também os pixels Meta e TikTok da minha página** no painel de incorporação, para enviá-los direto aos pixels já instalados na sua página. Na API JS, passe `track: 'auto'`.

Um iframe simples não consegue repassar eventos. Veja a lista completa em [Pixels de rastreamento de anúncios](https://docs.rooquiz.com/pt-BR/publish/ad-pixels).

## API JS

Quando você precisa de um gatilho personalizado (por exemplo, um botão com o seu próprio design abrindo o popup), chame a API diretamente:

```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">
  A página incorporada oculta automaticamente o rodapé e o fundo, integrando-se de forma transparente ao seu site; as cores do seu tema continuam sendo aplicadas. As respostas coletadas por incorporação aparecem normalmente em [Registros de respostas](https://docs.rooquiz.com/pt-BR/results/records).
</Callout>
