Documentation menu

Bloque de cuestionario

Un cuestionario puntuado de varias preguntas: agrega un bloque de Cuestionario, luego coloca hijos de Pregunta de cuestionario dentro de él, cada uno con sus propias opciones de opción múltiple y una respuesta correcta. Es la herramienta del estudio para cuestionarios de puntuación de leads, pruebas de conocimiento, y envíos estilo "cuál es tu resultado" de personalidad donde el resultado realmente depende de lo que responda el destinatario.

Cómo funciona

A diferencia de encuesta y calificación, un cuestionario no tiene un nivel 2 de alternativa basado en enlaces — una combinación de varias preguntas y varias opciones no se puede enumerar como un conjunto de enlaces GET simples de la forma en que puede hacerlo un solo voto de encuesta. Así que el único camino interactivo del HTML enviado es un <form method="post"> real dentro del correo que se envía directamente al endpoint de interacciones de MailInApp, envuelto en un nivel exclusivamente cinético. Cada pregunta se renderiza como un grupo de radio etiquetado, y enviar publica cada respuesta de una sola vez sin salir de la bandeja de entrada. Dondequiera que ese formulario cinético esté oculto por CSS (Outlook, o cualquier cliente que no pueda publicar un formulario dentro del correo), el correo en su lugar muestra un único botón siempre visible "Realizar el cuestionario" que abre el mismo cuestionario en la vista en vivo alojada. Ahí, la propia página de vista en vivo es el cuestionario, así que renderiza solo el formulario funcional puro sin ningún botón envolvente adicional propio.

La puntuación ocurre completamente del lado del servidor. Al enviar, el endpoint de interacciones vuelve a leer la propia clave de respuestas del bloque de cuestionario desde el árbol almacenado del proyecto y verifica cada respuesta enviada contra ella — nunca se confía en una puntuación reportada por el cliente. El resultado se escribe en el evento como { answers, score, total, bucket }, donde bucket es "pass" o "fail" según si (correct / total) * 100 superó la puntuación de aprobación configurada del bloque.

Si defines una redirección tras el envío hacia una ruta en la vista en vivo, esa redirección lleva la puntuación y el total consigo como parámetros de consulta. La página de resultados puede entonces mostrar un banner de resultados — el mensaje de aprobado/reprobado que configuraste, no un agradecimiento genérico. Dejar la redirección en blanco (o definir algo que no sea una ruta relativa al sitio que comience con /) recurre a la página de resultados predeterminada propia del bloque de cuestionario.

Si la encuesta del proyecto ha cerrado (se alcanzó una fecha de cierre o un límite de respuestas), el bloque de cuestionario en su lugar renderiza su título y el texto de cada pregunta como texto plano no interactivo, con una nota "Esta encuesta está cerrada a nuevas respuestas". Esa verificación solo ocurre en la vista en vivo alojada, ya que el HTML enviado es estático en el momento del envío y nunca se cierra.

Campos configurables en el propio bloque de Cuestionario:

  • Título y Etiqueta de envío (por defecto "Ver mi puntuación") — más el color y el tamaño de fuente propios del título.
  • Puntuación de aprobación — el porcentaje mínimo de aciertos (0–100) que un destinatario necesita para caer en el bucket de "aprobado".
  • Mensaje al aprobar / Mensaje al no aprobar — los dos bloques de texto de resultados mostrados según el bucket calculado.
  • Redirección tras el envío — una ruta relativa al sitio opcional para enviar al destinatario tras la puntuación; mira arriba cómo viajan junto la puntuación/total.
  • Color de fondo, relleno, borde, radio de borde en la tarjeta.
  • Sobrescrituras de estilo de texto para el título, el texto de la pregunta, las opciones de respuesta, el botón de envío, y cada mensaje de resultados de forma independiente.

Cada hijo de Pregunta de cuestionario lleva su propio texto de Pregunta, una lista de Opciones, y una Respuesta correcta que debe coincidir exactamente con una de las opciones (distingue mayúsculas/minúsculas, coincidencia literal de cadena) — un desajuste significa que esa pregunta nunca podrá puntuarse como correcta.

Ejemplos

Subject

How well do you know our products? Take the quiz

Un proveedor de software puede ejecutar un cuestionario de puntuación de leads "¿cuál es tu nivel de madurez en automatización?" con acceso restringido tras un umbral de aprobación, con el mensaje de puntuación aprobatoria dirigiendo a los leads calificados hacia un enlace de reserva de demo y el mensaje de puntuación reprobatoria dirigiendo a todos los demás hacia contenido de nutrición en su lugar. Mira Interacción y fidelización para más sobre el uso de contenido interactivo para calificar y reactivar una lista. Un proveedor de cursos puede enviar un breve control de conocimientos antes de una sesión en vivo para que los instructores sepan dónde está parado el grupo al empezar. Un cuestionario de estilo personalidad "cuál línea de producto es adecuada para ti" puede usar la división aprobado/reprobado como una simple bifurcación de dos vías: recomendar el Producto A por encima del umbral, el Producto B por debajo. Eso funciona sin construir una lógica real de bifurcación por respuesta, ya que el texto de cada bucket es exactamente para lo que sirven los dos mensajes de resultados.

Cómo se ve la alternativa estática

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

Esta es la alternativa siempre visible: un único botón hacia la vista en vivo alojada, donde el mismo cuestionario se renderiza como un <form> real y funcional — no hay un nivel de enlace por pregunta o por respuesta como el que tienen encuesta y calificación.

Relacionado