Incorporar e compartilhar um quiz

Todo quiz publicado recebe um link para compartilhar, além de um código de iframe pronto para incorporá-lo diretamente no seu próprio site.

Última atualização

Como incorporo meu quiz no meu site?

Abra o menu do quiz, escolha "Opções de incorporação" e copie o código. A opção Inline é um iframe apontando para o link de compartilhamento do seu quiz com ?embed=true no final, mais uma linha de script que ajusta o tamanho do quadro ao quiz. Cole os dois no HTML do seu site.

O código de incorporação#

A opção Inline em "Opções de incorporação", no menu do quiz, fornece exatamente este código: um iframe com o link de compartilhamento do seu quiz e um parâmetro de consulta ?embed=true que muda a página para um layout próprio para incorporação, seguido de um pequeno script que ajusta o tamanho do quadro ao quiz:

<iframe src="https://fluotest.com/to/your-username/your-quiz?embed=true" width="100%" height="600" frameborder="0" style="border:none;border-radius:8px;" allow="clipboard-write"></iframe>
<script src="https://fluotest.com/embed-resize.js" async></script>

Tipos de incorporação: Popup, Slide-in, Exit-intent#

Além do iframe inline simples, a janela de incorporação pode gerar uma única tag de script. Ela carrega o embed-widget.js, que exibe seu quiz como um botão de popup flutuante, um painel que desliza de um canto ou um aviso que aparece na intenção de saída. Escolha o modo na janela de incorporação; o código abaixo mostra o modo Popup.

<script src="https://fluotest.com/embed-widget.js" data-quiz-url="https://fluotest.com/to/your-username/your-quiz" data-mode="popup" async></script>

data-mode aceita popup, slidein ou exit-intent. Atributos opcionais: data-button-text (rótulo do gatilho do popup/slide-in), data-color (cor de destaque, por padrão o roxo do FluoTest), data-position (bottom-right ou bottom-left) e data-delay (atraso do slide-in em milissegundos, padrão 4000).

Altura e largura#

O quadro ocupa toda a largura do espaço onde você o coloca. A altura acompanha o quiz: o pequeno script embed-resize.js do código deixa o quadro exatamente da altura da etapa atual, então os respondentes nunca rolam dentro dele. Quando eles passam para a próxima etapa e o topo do quiz está fora de vista, a página rola de volta para o topo do quiz. O atributo height="600" só vale até o script carregar. Funciona com vários quizzes na mesma página. Se o seu site tem um cabeçalho fixo, adicione data-fluotest-offset="80" (a altura do cabeçalho em pixels) ao iframe para que o topo do quiz não fique escondido atrás dele.

Códigos de incorporação copiados antes de 27 de outubro de 2026 continuam funcionando com altura fixa. Para ter a altura automática, adicione esta linha embaixo do iframe existente:

<script src="https://fluotest.com/embed-resize.js" async></script>

Alguns construtores de sites colocam o HTML personalizado em uma caixa própria com altura fixa. Nenhum script na sua página consegue mudar essa caixa, então defina a altura dela nas configurações do construtor.

Remoção do selo e domínios personalizados#

Quizzes gratuitos mostram um selo "Powered by FluoTest" tanto na página hospedada quanto na incorporação. O Pro o remove. Se você conectou um domínio personalizado, confira nas configurações de domínio o link exato a usar no lugar de fluotest.com.

Solução de problemas#

  • A incorporação parece cortada ou tem uma barra de rolagem: Confira se a linha de script do embed-resize.js está embaixo do iframe (códigos copiados antes de 27 de outubro de 2026 não a têm) e se a Content-Security-Policy do seu site permite scripts de fluotest.com. Se o seu construtor de sites coloca o HTML personalizado em uma caixa própria com altura fixa, aumente a altura dessa caixa no construtor.
  • O quiz não carrega no iframe: Confirme que o quiz está publicado, não foi excluído e que o link de compartilhamento funciona quando aberto diretamente em uma nova aba.
  • O selo "Powered by FluoTest" ainda aparece no Pro: Confirme que o workspace está mesmo no Pro (ou tem acesso vitalício): o selo depende do plano do dono do quiz, não da página em que ele está incorporado.
  • O quiz em popup, slide-in ou exit-intent não aparece: Confira se a tag de script não está bloqueada por uma Content-Security-Policy que proíbe scripts ou iframes de terceiros; libere fluotest.com na sua CSP. O exit-intent só dispara uma vez por sessão do navegador e só com movimento do ponteiro no desktop, não no celular.

Perguntas frequentes#

Preciso de algum código além do iframe para incorporar um quiz?

Não. Cole o código copiado (o iframe e a linha de script embaixo dele) no HTML do seu site onde você quiser que o quiz apareça. O script só ajusta o tamanho do quadro; sem ele, o quiz continua funcionando com uma altura fixa de 600px.

O quiz incorporado fica diferente da versão hospedada?

O parâmetro ?embed=true muda para um layout próprio para incorporação (por exemplo, sem os elementos de página do próprio FluoTest ao redor), mas o conteúdo e o comportamento do quiz são os mesmos.

Posso compartilhar o link diretamente em vez de incorporar?

Sim, o mesmo link de compartilhamento funciona como uma página independente. Para isso, use o link simples (sem ?embed=true).

Qual é a diferença entre o código de iframe e o código de script?

O código de iframe exibe o quiz inline, exatamente onde você o cola; a linha de script dele só ajusta o tamanho do quadro. O código de script (usado para Popup, Slide-in e Exit-intent) carrega um pequeno script que cria o gatilho (um botão, painel ou aviso de saída) e só cria o iframe quando o visitante interage com ele.