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>

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

AtributoDescrição
data-rooquiz-tokenObrigatório. O token público do quiz
data-rooquiz-modeinline (padrão) ou popup
data-rooquiz-utm-sourceOrigem UTM registrada com cada resposta, usada pelo rastreamento de origem com UTM e pelo detalhamento por origem em Insights
data-rooquiz-utm-mediumMídia UTM (opcional)
data-rooquiz-utm-campaignCampanha UTM (opcional)
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
data-rooquiz-trackauto: dispara também os pixels da Meta e do TikTok já instalados na sua página (veja Eventos de conversão)
data-rooquiz-passParâmetros de URL 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.

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', utmSource: 'homepage' })
  // Open the popup from any element
  document.querySelector('#my-button').onclick = () => RooQuiz.open('YOUR_QUIZ_TOKEN', { utmSource: 'homepage' })
</script>

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