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.
| 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)
<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
<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
| 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 e pelo detalhamento por origem em 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) |
data-rooquiz-pass | Parâ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.
Link público e QR Code
O link público é a forma mais comum de distribuir um quiz. Veja como copiá-lo, gerar e baixar um QR Code para materiais impressos ou slides e o que muda quando o quiz exige login para responder.
Cartão de compartilhamento
O cartão de compartilhamento (Open Graph) é o que apps de mensagens e redes sociais mostram quando o link do seu quiz é colado. Personalize título, descrição e imagem de prévia para aumentar os cliques.