Quizzes

The User Manual has moved! For the most up-to-date information, please visit our new site at docs.antavo.com.
We're committed to providing you with the best resources, and our new site offers an enhanced experience with the latest documentation. Thank you for your understanding and continued support.

Alongside the Content consumption and Gamified profiling modules, the Quizzes module provides an option to boost your loyalty program with gamification elements by asking customers to answer questions for loyalty benefits. The Quizzes module was built to provide a flexible tool to present customers with quiz questions and reward those who answer the questions correctly with loyalty points.

All the below-explained settings are available through the Quizzes endpoints of the Display API and answers can be submitted by sending a POST request. Antavo evaluates the request based on the configured game mechanics and registers the Quiz event with a true or false value of the ‘is correct’ event attribute depending on the answer provided in the API request.

 

Find the configuration page by navigating to the Modules menu and searching for ‘Quizzes' in the module list. The page will open to a list of quizzes that have already been added with the following information:

  • Quiz question

  • Number of possible answers

  • Start date

  • End date

Adding new quizzes

  • Click the ‘Create new quiz’ option in the sidebar of the Quizzes module page

Basic information

  • Enable card
    Display of quiz in form of cards on the membership site that is built with Antavo’s iframe frontend solution.

This setting is not applicable when the list of available quizzes is queried through the Display API.

  • Name the quiz

  • Write a description

  • Set the number of points customers should get if they answer the question correctly

  • Upload an image

  • Label the quiz CTA button

Mechanics

  • Tick the ‘Is repeatable?’ checkbox to let customers try answering the question again until they submit the correct answer
    Once a customer has given the correct answer, the quiz is not repeatable for them even if this checkbox is active.

    • If you enabled repeatability, set the repeat interval
      The repeat interval is the time period until customers can try again after answering incorrectly. The repeat interval should be set in the following format: ({number}minute(s)|hour(s)|day(s).

  • Set the start date and the end date
    Customers can answer the quiz question only in the time interval between the start and end dates.

Notifications

  • Add the success message
    This text is returned in the “message” parameter of the API response if the customer selected the correct answer.

  • Add the error message
    This text is returned in the “message” parameter of the API response if the customer selected a wrong answer.

Question and answers

  • Enter the question to answer
    You can add only one question to each quiz.

  • Click ‘Add +’ to add possible answers
    Make sure you add at least two possible answers and select the correct answer. Only one answer can be selected as the correct answer.

Points economy

If your brand uses Multi-accounts, select the account to which the Quiz events and potentially earned points will be registered.

Don’t forget to click ‘Save’ before leaving the page. Once a quiz has been saved, it is active right away however, you can deactivate it anytime.

Managing quizzes

Edit a quiz

  • Navigate to the Quizzes tab

  • Click the ‘Edit’ button of the quiz you want to edit

  • Edit the quiz

  • Save your changes by clicking ‘Save’ at the bottom of the page

Deactivate a quiz

  • Navigate to the Quizzes tab

  • Click the ‘Edit’ button of the quiz you want to deactivate

  • Click the ‘Set inactive’ button on the upper right-hand side of the page

  • Confirm your choice in the dialog that appears

Archive a quiz

  • Navigate to the Quizzes tab

  • Click the ‘Edit’ button on the inactive quiz you would like to archive

  • Click the ‘Archive’ button on the upper right-hand side of the page

  • Confirm your choice in the dialog that appears

Archiving is irreversible. Once a quiz is archived, it cannot be restored anymore.

© Copyright 2022 Antavo Ltd.