Single Page Quiz Extension
Most Common Answer Logic
This type of quiz is used to give results based on how many similarities there are between the answers to the questions and the possible results. It will give the user the result that most closely matches the corresponding answers they gave.
We will go over the single page setup.
How we did it
Using the SDK’s event listeners, we track which answers the user is clicking on. Then, once the user reaches the end of the quiz and clicks to view their results, we show the layer that is tagged with the name of the answer that they gave the most.
What you need
- Custom HTML script
- The Number of answers per question must always equal the number of results. E.g. if question 1 has answer options A, B, C, and D then there must be 4 results.
- All questions must have the same number of answer options
- Each answer will correspond to the results later
How to implement
Add Quiz Plugin Code to Ceros Experience
Create a new Ceros Experience in the Ceros Admin and Paste the following code in the Custom HTML section of the settings panel:
<script async id="ceros-quiz-plugin" src="//creative-services.ceros.com/ceros/quiz-plugin/v1-1/main.min.js?r=1" ></script>
Create Quiz Assets - Questions, Answers and Results
First, create the assets for the quiz.
For example, you could have 4 questions with 4 possible answers (A, B, C, D or 1, 2, 3, 4), with the last question directing you to one of 4 possible results.
For a single page quiz, you could have the questions visible on scroll, or you could have the hotspot interactions reveal and hide the layer folders rather than on individual pages.
Based on the tagging you set up, four clicks on answer “A” would return result “A.”
When there is an even number of questions, in the event of a tie (i.e., the user clicks “A” twice and “B” twice), the result will be based on alphabetical sequence of the
value:awould win over
In other words, if 50% of the answer values were “A” and 50% were “B,” result “A” would be shown since “A” is first in the alphabet.
Keep this in mind if you want a certain result to display in the event of a tie.
Create and Tag Answer Hotspots, Add Click Interactions
Next, create a hotspot over each answer choice.
After the hotspots have been created, add the appropriate tags to them within the SDK panel, and the click interaction necessary to show the next question.
- Click the SDK icon (wrench and hammer) in the toolbar to bring up the SDK panel.
- Select the hotspot you want to work with, and add the following tags in the “Current Selection” section:
This identifies the hotspot as an answer.
(Pro Tip: All answers must have the
answertag, so to save time, you can select all answer hotspots and add this tag to all of them at the same time.)
In this tag,
xis the value assigned to the question, or in other words, which option was selected. For example, if this was answer “C” you would use
value:cas the tag.
This tag defines the question the answer belongs to. In this case,
xidentifies the layer/folder that the question is on. If this was question 1, the tag would be
- While the hotspot is selected, add the “On Click” interaction to hide the current question and show the next question.
The final question’s answer hotspots will have the same tags as listed above, but with the addition of the tag of
goto:resultsto each hotspot.
You only need to add an “On Click -> Hide” interaction to hide the final question – the
goto:resultstag takes care of showing the appropriate result layer folder, but you can use an On Hover interaction to boost the style and user experience.
Create, Tag and Add Click Interactions to Results Hotspots
After all the answer hotspots are created and tagged, create a hotspot for each result you would like displayed.
These hotspots will reveal each result layer through an “On Click” interaction.
Add the “On Click” interaction to each of these result hotspots where the “On Click” interaction will display the result. Typically this will be done by “showing” a hidden layer folder.
In addition to the “On Click” interactions, add the two following tags to the results hotspots:
This identifies the hotspot as a trigger to show a result layer/folder
- A tag to define the value the hotspot represents.
For example, if the hotspot takes users to result “D,” add
das the tag.
These hotspots can exist off canvas to prevent users from clicking them, but must not be hidden in the Layers panel.
Option to Reset the Quiz and Start Over
To reset the quiz, add a hotspot with the tags
quiz-resetto a button (i.e., a square shape and a hotspot) within each result layer folder.
This hotspot will also need an “On Click” interaction to hide the current result layer and show the quiz start page.