# Quiz Game ### Overview The Quiz is a fun and engaging game where players answer questions to earn a spot on the Leaderboard. Questions can be either sports-related or custom topics. Each Quiz instance can have multiple Quiz Games (Rounds) on different topics. For example, you could create a Quiz Instance named ‘Football Master’ and include rounds from various football leagues like La Liga, Serie A, and the Premier League. The questions can be based on real sports events, such as ‘Who will win the match between Real Madrid and Barcelona?’ with answer options like Real Madrid, Barcelona, or Draw.

#### Sports-Related Questions: You can create sports-related questions in two ways: 1\. **Automatic:** Select a sports event from our feed and choose from pre-defined questions. The correct answers will be automatically updated by the feed. 2\. **Manual:** Create your own sports event and add a custom question. You’ll need to manually resolve the event and select the correct answer. #### Custom Questions: Custom questions can be either sport-related or non-sport-related. For sport-related questions, you have additional options like match date, match/league name, and team names, which are not available for non-sport-related questions. All custom questions are created manually, and you must also manually define the correct answers from the BO once the Quiz is finished.

### Quiz User flow The player's journey progresses through the following steps: 1\. **Enter Quiz Lobby:** Players choose from multiple quiz instances available in the lobby. Each instance can have a different topic. 2\. **Select Quiz Game:** After opening a quiz instance, players see various quiz games (rounds) with details like end date, name, description, amount of questions, etc. 3\. **Answer Questions:** Players begin answering questions within the selected quiz game - questions may be sports-related or custom ones. 4\. **Wait for the correct answer:** If the question was linked to a sports event, the correct answer will be available once the event is resolved. For Custom questions, the correct answer should be manually defined by the BO once the Quiz is finished.

### Quiz UI Structure The Quiz consists of the following main components: Quiz Instance, Quiz Game, Initial Screen, Quiz Question, Rules tab, Leaderboard tab, Prizepool, and How to Play section. * **Quiz Instance:** Displayed in the lobby of the Quiz section within the Gamification Widget. You can create multiple Quiz instances, each representing a separate quiz experience. Each Quiz Instance contains multiple Quiz Games or rounds. * **Quiz Game (Rounds):** Every Quiz Game features an initial screen, end date, name, promo text, description, image, and cost type, and includes all the quiz questions. You can have 1 or more rounds in one Quiz Instance. * **T\&C panel:** contains details about the selected round such as the name of the round, end date, image, promo text, T\&C, and Start button. * **Quiz Questions:** Each question is part of a Quiz Game (round) and includes an image, question text, answer options, event name, and event date (for sports-related questions). * **Rules tab:** Here you can add custom text describing the rules, T\&C of the Quiz, etc. The Rules tab supports HTML as well. * **Leaderboard:** Shows the list of ranked players who are participating in the Quiz game and their scores. * **Prize pool:** Shows the list of prizes for each position. * **How to Play:** Shows the instructions on how to play the Quiz.

### How to Create a Quiz You can create a quiz from the BO in the Gamification tab -> Quiz. To create a quiz you need to complete the following steps: 1. Create the Quiz Instance in the BO by configuring the general and the UI settings

2. Add Quiz Rounds

3. Configure the Round by selecting the start and end date, adding a description, image, promo text, etc.

4. After saving the round, select the questions from the feed or create custom questions

5. Customize the question by updating the image, selecting the question type, etc.

6. Add prize pool

### Customize the Final Screen in Quiz The final screen of the Quiz can be customized to fit your brand. You can replace the default confetti animation with a custom image, change the completion message, and even add a call-to-action (CTA) button to guide players to other sections of the widget.

The options are available in the 'Round UI Setup' section of the Quiz template (per round): * **Final screen image:**\ Upload an image to replace the default confetti animation. If left empty, the animation will remain. * **Final screen message:**\ Customize the message shown on the final screen. If empty, the default translation will be used. (Supports HTML formatting.) * **CTA button title:**\ Add custom text for the button. * **CTA button action:**\ Add a deep link to redirect players to a specific widget section.

**Behavior based on the number of rounds:** * If the Quiz has more than one round, the CTA button will replace the default 'Next Quiz' button. * If the Quiz has only one round, the CTA button will be shown next to the 'Review Answers' button. ### Remove tie ranking on Quiz Leaderboards You can now remove tie rankings on the Quiz leaderboard. The setting, ‘Remove Tie Rankings,’ is available in the BO under the Quiz template and is disabled by default. {% hint style="warning" %} Keep in mind that if **"Seasonal Ranking"** is enabled for the Quiz game and when **"Remove Tie Ranking"** is enabled, the General Leaderboard prioritizes players first by points and then by the time of their prediction, regardless of the round. If two players have the same points from different rounds, the player who made their prediction first will receive the higher rank on the leaderboard. {% endhint %}

When enabled, if two or more players have the same score, the player who made their prediction first will be ranked higher, ensuring that each position is held by a single player (e.g., only one player in 1st, 2nd, and 3rd place). In such case, the prize for 1st place for example will be issued only to 1 player.

If the option is disabled, players with the same score will share the same position on the leaderboard. For example, you could have three players tied for 1st place and two for 2nd place. In such case, the prize for 1st place for instance can be issued to two or more players depending on how many players have the same score.

### Quiz Specifics Here are some important details about the Quiz: * If the 'Seasonal ranking' is enabled the leaderboard will aggregates scores across all rounds, so prizes will be awarded only after all rounds are resolved. If some rounds remain unresolved, prizes will not be issued. * If the 'Seasonal ranking' is not enabled - there will be no 'General Leaderboard', only rounds leaderboards will be visible and the prizes will be issued once the round is resolved. * If there’s only one Quiz game (round) on the desktop view, the Quizzes tab won't be shown; instead, the Rules tab will be displayed. * If a question is tied to a sports event and the event is postponed, the UI won’t update automatically. You’ll need to manually mark the question as canceled in the BO. * If there are future Quiz Games (Rounds) they will not be displayed in the UI. * In case the 'cost type' is not free, the player will be charged once per round, regardless of the number of answered questions if they’re in 1 round it is considered as 1 attempt.

### Lock answers after submission You can control whether players can change their answers after submitting. The option is called **‘Allow editing of answers’** and is available in the Quiz round configuration. It is enabled by default meaning that players can edit their answers after submission.

BO: 'Allow editing of answers' option in Rounds settings

When disabled, players can’t edit their answers once they’ve submitted. This is configured per round, so you can have some rounds where editing is allowed and others where answers are locked.

### Set auto resolve for custom question You can automatically resolve a custom question with the **‘Set auto resolve for the question’** option. This option is available only for custom questions and is disabled by default, meaning they must be resolved manually from the Back Office. When enabled, you can define a specific UTC date and time, and the question will be resolved automatically once that time is reached. {% hint style="info" %} **Note:** After a question is auto-resolved, the answers can no longer be edited. {% endhint %}

### Spin expiration for Quiz The ‘**Spin Expiration Rule’** option in Quiz help you to configure spin attempt costs and define when unused attempts expire using flexible rules: * Relative period - e.g., expires 10 days after the attempt is issued * Specific time - e.g., expires at 00:00 UTC on the same day it was issued * Day of the week - e.g., expires on Monday at 00:00 UTC, regardless of when it was issued * Specific date & time - e.g., expires on 21.05.2026 at 00:00 UTC, regardless of issuance time If a spin attempt is not used before the set time is reached, it will automatically expire and can no longer be used. {% hint style="info" %} Note: When the cost type is 'Spin Attempts', the cost is applied once per round, regardless of how many predictions are made within that round. All predictions in the same round count as a single attempt. {% endhint %} You can also define **Max Active Spins per User**, which limits how many spin attempts a user can have at a time. For example, if set to 1, the user can participate in only one round of the Quiz. Once the spin is used, they must receive a new attempt before joining another round.

### How to load Quiz game on the site Quiz game has same possibilities of loading as part of the main page or as an overlay popup on top of your side as MatchX, you can read about all possible mechanics in [this article](https://help.smartico.ai/welcome/products/mini-games/matchx-game/loading-matchx-game-as-part-of-your-website)