RooQuiz Docs
Publicar e compartilhar

Incorporar

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.

ModoIdeal paraComportamento
Inline (altura automática)Integrar-se ao fluxo de conteúdo da páginaA altura acompanha o conteúdo automaticamente. Recomendado
PopupUm botão de chamada para ação na sua páginaAbre o quiz em uma sobreposição em tela cheia
iframe simples (altura fixa)Ambientes em que não é possível carregar um scriptO mais simples; altura fixa com rolagem interna

Inline (altura automática)

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

<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

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

Atributos disponíveis

AtributoDescrição
data-rooquiz-tokenObrigatório. O token público do quiz
data-rooquiz-modeinline (padrão) ou popup
data-rooquiz-fromTag de origem registrada com cada resposta, usada pelo rastreamento de origem e pelo detalhamento por origem em Insights
data-rooquiz-heightAltura inicial (px) no modo inline, usada antes de o redimensionamento automático entrar em ação
data-rooquiz-textTexto do botão no modo popup

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:

<script src="https://YOUR_QUIZ_DOMAIN/embed.js"></script>
<script>
  // Mount an inline embed manually
  RooQuiz.embed({ el: '#container', token: 'YOUR_QUIZ_TOKEN', from: 'homepage' })
  // Open the popup from any element
  document.querySelector('#my-button').onclick = () => RooQuiz.open('YOUR_QUIZ_TOKEN')
</script>

Não recomendamos incorporar quizzes configurados como somente para respondentes cadastrados: os navegadores restringem o armazenamento e os pop-ups de login dentro de iframes de terceiros, o que pode prejudicar a experiência de login. Para esses quizzes, compartilhe o link público.

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.

Nesta página