Documentation menu

Bloco Quiz

Um quiz pontuado, com várias perguntas: adicione um bloco Quiz, depois coloque elementos filhos Pergunta do quiz dentro dele, cada um com suas próprias opções de múltipla escolha e uma resposta correta. É a ferramenta do estúdio para quizzes de pontuação de leads, testes de conhecimento e envios no estilo "qual é o seu resultado" de personalidade, em que o resultado de fato depende do que o destinatário responde.

Como funciona

Diferente da enquete e da avaliação, um quiz não tem um fallback de nível 2 baseado em link — uma combinação de várias perguntas com várias opções não pode ser enumerada como um conjunto de links GET simples, do jeito que um único voto de enquete pode. Então o único caminho interativo do HTML enviado por e-mail é um <form method="post"> real dentro do e-mail, enviado diretamente ao endpoint de interações do MailInApp, envolvido em um nível apenas cinético. Cada pergunta é renderizada como um grupo de opções (radio) rotulado, e enviar posta todas as respostas de uma vez, sem sair da caixa de entrada. Onde quer que esse formulário cinético esteja escondido por CSS (Outlook, ou qualquer cliente que não consiga enviar um formulário dentro do e-mail), o e-mail em vez disso mostra um único botão sempre visível "Fazer o quiz", que abre o mesmo quiz na visualização ao vivo hospedada. Ali, a própria página de visualização ao vivo é o quiz, então ela renderiza apenas o formulário funcional puro, sem nenhum botão adicional envolvendo-o.

A pontuação acontece inteiramente no servidor. No envio, o endpoint de interações relê o próprio gabarito de respostas do bloco de quiz a partir da árvore armazenada do projeto e verifica cada resposta enviada em relação a ele — uma pontuação relatada pelo cliente nunca é confiada. O resultado é gravado no evento como { answers, score, total, bucket }, em que bucket é "pass" ou "fail", dependendo de (corretas / total) * 100 ter atingido ou não a nota de aprovação configurada no bloco.

Se você definir um Redirecionamento após o envio para um caminho na visualização ao vivo, esse redirecionamento carrega a pontuação e o total de volta como parâmetros de consulta. A página de resultados pode então mostrar um banner de resultados — a mensagem de aprovado/reprovado que você configurou, não um agradecimento genérico. Deixar o redirecionamento em branco (ou definir algo que não seja um caminho relativo ao site começando com /) volta para a própria página de resultados padrão do bloco de quiz.

Se a pesquisa do projeto tiver sido encerrada (uma data de encerramento ou um limite de respostas atingido), o bloco de quiz renderiza em vez disso seu título e o texto de cada pergunta como texto simples, não interativo, com um aviso "Esta pesquisa está fechada para novas respostas". Essa verificação só acontece na visualização ao vivo hospedada, já que o HTML enviado por e-mail é estático no momento do envio e nunca se encerra.

Campos configuráveis no próprio bloco Quiz:

  • Título e Rótulo de envio (padrão "Ver minha pontuação") — além de cor e tamanho de fonte próprios do título.
  • Nota de aprovação — a porcentagem mínima de acertos (0–100) que um destinatário precisa para cair no grupo "aprovado".
  • Mensagem quando aprovado / Mensagem quando não aprovado — os dois blocos de texto de resultado exibidos dependendo do grupo calculado.
  • Redirecionamento após o envio — um caminho opcional relativo ao site para onde enviar o destinatário depois da pontuação; veja acima como a pontuação/total são carregados junto.
  • Cor de fundo, preenchimento interno, borda, raio da borda no cartão.
  • Substituições de estilo de texto para o título, o texto da pergunta, as opções de resposta, o botão de envio e cada mensagem de resultado, de forma independente.

Cada elemento filho Pergunta do quiz carrega seu próprio texto de Pergunta, uma lista de Opções, e uma Resposta correta que precisa corresponder exatamente a uma das opções (diferenciando maiúsculas de minúsculas, comparação literal de string) — uma incompatibilidade significa que essa pergunta nunca poderá ser pontuada como correta.

Exemplos

Subject

How well do you know our products? Take the quiz

Um fornecedor de software pode rodar um quiz de pontuação de leads "qual é o seu nível de maturidade em automação?", condicionado a um limite de aprovação, com a mensagem de nota de aprovação direcionando leads qualificados para um link de agendamento de demonstração, e a mensagem de reprovação direcionando todos os outros para conteúdo de nutrição. Veja Engajamento e fidelização para mais sobre usar conteúdo interativo para qualificar e reengajar uma lista. Um provedor de cursos pode enviar uma verificação de conhecimento curta antes de uma sessão ao vivo, para que os instrutores saibam em que ponto a turma está antes de começar. Um quiz no estilo de personalidade "qual linha de produto é ideal para você" pode usar a divisão de aprovado/reprovado como uma bifurcação simples de dois caminhos: recomendar o Produto A acima do limite, o Produto B abaixo dele. Isso funciona sem construir uma lógica real de ramificação por resposta, já que o texto de cada grupo é exatamente para isso que servem as duas mensagens de resultado.

Como é o fallback estático

<div style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:700;font-size:18px;color:#111827">
    Test your knowledge!
  </p>
  <!-- kinetic <form> posting to /api/interactions omitted — hidden from
       Outlook and any client that can't post an in-email form -->
  <div style="text-align:center;margin-top:8px">
    <a href="https://mailinapp.com/v/eyJhbGci..."
       style="display:inline-block;padding:10px 20px;background-color:#4f46e5;
              color:#ffffff;border-radius:6px;text-decoration:none;
              font-size:14px;font-weight:600">
      Take the quiz
    </a>
  </div>
</div>

Este é o fallback sempre visível: um único botão para a visualização ao vivo hospedada, onde o mesmo quiz é renderizado como um <form> real e funcional — não existe um nível de link por pergunta ou por resposta, como a enquete e a avaliação têm.

Veja também