Fins conditionnelles

Conditional endings let you show different end screens to respondents based on their quiz score. Instead of a single "Thank you!" screen, you can display personalized results --- for example, showing "Expert!" to high scorers and "Keep learning!" to low scorers.

How Quiz Scoring Works

NueForm supports three quiz modes, each with its own scoring mechanism:

Setting the Form Mode

1. Open your form in the NueForm builder.
2. Open the form settings (gear icon).
3. Under Form Mode, select one of the quiz modes.

Alternatively, use the API:

curl -X PATCH https://app.nueform.com/api/v1/forms/FORM_ID \
  -H "Authorization: Bearer nf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "knowledge_quiz" }'

Setting Up Multiple End Screens

Each end screen in a quiz-mode form can have a score range that determines when it is shown. NueForm evaluates end screens in order and shows the first one whose score range contains the respondent's score.

Step 1: Create End Screens

Add multiple end_screen questions to your form. Each one represents a different result page.

1. In the form builder, click + and select End Screen from the Layout category.
2. Set the title and description for this ending (e.g., "Expert Level --- Congratulations!").
3. Repeat for each distinct ending you want to create.

Step 2: Assign Score Ranges

For Knowledge Quiz and Lead Qualification modes, each end screen needs a score range:

1. Select an end screen question.
2. In the question properties panel, set the Score Range:
   • Min Score --- The minimum score to show this ending (inclusive).
   • Max Score --- The maximum score to show this ending (inclusive).

Example: Knowledge Quiz with 10 Questions (1 Point Each)

Step 3: Configure Scorable Questions

Knowledge Quiz

For each question you want to score:

1. Select the question in the builder.
2. In the properties panel, mark the correct answer(s). This is available for these question types: multiple_choice, dropdown, yes_no, opinion_scale, rating, and legal.
3. Optionally set a custom point value (default is 1 point per correct answer).

Lead Qualification

For each question you want to score:

1. Select the question.
2. In the properties panel, assign a point value to each choice. For example, in a "Company Size" dropdown:
   • "1-10 employees" = 1 point
   • "11-50 employees" = 3 points
   • "51-200 employees" = 5 points
   • "200+ employees" = 10 points

The respondent's total score is the sum of points from all their selected choices.

Match Quiz Endings

Match quizzes work differently from score-based quizzes. Instead of numeric score ranges, each choice maps to one or more outcome endings. The ending with the most "votes" from the respondent's choices wins.

How Match Scoring Works

1. Each question's choices are mapped to one or more end screens.
2. When a respondent selects a choice, the associated end screens each get a tally point.
3. After all questions are answered, the end screen with the highest tally is shown.
4. Ties are broken by order (the first end screen wins).

Setting Up a Match Quiz

1. Set the form mode to Match Quiz.
2. Add multiple End Screen questions --- each represents an outcome (e.g., personality types, product recommendations).
3. For each scorable question, open the properties and map each choice to the relevant endings:
   • Choice "I prefer mornings" maps to End Screen "Early Bird"
   • Choice "I prefer evenings" maps to End Screen "Night Owl"

Example: "What Type of Traveler Are You?"

End Screens:

• Adventure Seeker
• Culture Explorer
• Relaxation Expert

Question: "Pick your ideal vacation activity"

After all questions, the ending with the highest tally determines the result.

Quiz Settings (Knowledge Quiz)

Knowledge quizzes have additional settings for feedback:

Configure these in the form settings under Quiz Settings:

{
  "quizSettings": {
    "showCorrectAnswers": true,
    "correctFeedbackText": "That's right!",
    "incorrectFeedbackText": "Not quite. Try again next time!"
  }
}

How End Screen Selection Works

When a response is submitted, NueForm computes quiz results server-side:

1. Knowledge Quiz: Counts correct answers and sums point values. Picks the first end screen whose scoreRange contains the total score.
2. Lead Qualification: Sums the point values of selected choices. Picks the first end screen whose scoreRange contains the total score.
3. Match Quiz: Tallies how many times each end screen was "voted for" by the respondent's choices. Picks the end screen with the highest tally (ties broken by order).

If no end screen matches the computed score, the first end screen in the form is used as a fallback.

The computed results are stored in the response's quizResults field:

{
  "formMode": "knowledge_quiz",
  "score": 7,
  "correctAnswers": 7,
  "totalScorableQuestions": 10,
  "maxScore": 10,
  "matchedEndingId": "507f1f77bcf86cd799439099"
}

Testing Conditional Endings

1. Publish your quiz form.
2. Submit responses with different answer patterns to trigger each end screen.
3. Verify in the Responses dashboard that quizResults contains the expected score and matchedEndingId.
4. Confirm that each respondent sees the correct end screen.

Meilleures pratiques

1. Cover all score ranges. Ensure every possible score maps to an end screen. Use 0 as the minimum of your lowest range and the maximum possible score as the maximum of your highest range.

2. Keep feedback encouraging. Even for low scores, use positive and constructive language in your end screen descriptions.

3. Use the fallback wisely. The first end screen in your form is the default fallback. Make it a generic, safe message in case score ranges are misconfigured.

4. Limit the number of endings. Three to five distinct endings usually provide enough personalization without becoming unwieldy.

5. Test edge cases. Submit responses that score exactly on the boundary of two ranges to verify the correct ending is selected.

Voir aussi

• Form Modes --- Detailed reference for all quiz modes
• Webhook Payloads --- How quiz results appear in webhook data
• API Reference: Responses --- Accessing quiz results via the API