Quiz

Build a Quiz game with a question pool, a score summary, and a Leaderboard reward for your best players.

Reward what people know with a set of questions, then rank the best results on a leaderboard. Use Quiz when the campaign should reward knowledge, brand recall, or fast, accurate answers — like a seasonal activation where the fastest top scorers win a prize.

The screens below come from a Summer Escape Quiz, a seasonal activation that asks summer trivia and rewards the strongest results with a weekend getaway.

Assets you'll need

A quiz shows a Background Image behind the game, with an optional Header Image at the top.

Background Image

Optional

The full-screen visual behind any game (wheel, scratch, reveal, quiz, and more).

  • Optional
  • Size1536 × 2048 px
  • Aspect ratio3:4
  • FormatsJPEG / WEBP / PNG
Examples

Header Image

Optional

An optional banner shown above the quiz questions.

  • Optional
  • Aspect ratio3:2
  • FormatsJPEG / WEBP / PNG
Examples

Reward Icon

Optional

The icon that represents a reward.

  • Optional
  • Size800 × 800 px
  • Aspect ratio1:1
  • FormatsJPEG / WEBP / PNG

Circular design and a transparent background work best.

Examples

For every image spec in one place, see Image & asset specs.

How rewards work here

Quiz uses Leaderboard rewards. You create the reward as a Game Reward → Performance Based Reward, then link it to this game in Performance Rewards.

When you declare winners, you rank the quiz by Completion Time or by Score + Completion Time, with an optional minimum score. Keep one Leaderboard reward per game so the ranking stays clear.

Before you begin

Configure the game

Add the touchpoint and choose Quiz

In Build → Touchpoints, select Add New Touchpoint, then choose Quiz.

Create a new touchpoint modal with the Quiz type highlighted

Upload the background image

On the Appearance tab, under Background Image, click Select attachment to upload the image people see behind the quiz. This is required for the game to publish.

Quiz Appearance tab with the Background Image attachment control highlighted

Set the title and instructions

Add the Title people see at the top of the quiz, then use Subtitle for short instructions — for example, what the quiz is about and what's at stake.

Quiz Appearance tab with the Title field highlighted above the Subtitle instructions

Add the optional header image

Under Header Image, click Select attachment to add an image shown on the quiz itself. Use it for a stronger visual frame — like a branded banner with the activation name.

Quiz Appearance tab with the Header Image attachment control highlighted

Open the question builder

In the Quiz Questions section, select Add Question to open the question builder.

Quiz Questions section with the Add Question button highlighted

Build a multiple-choice question

Enter the Question Text, leave Question Type on Multiple Choice, then select Add Option for each answer. Type each option, and mark the right one with the Set as correct answer control. Each question can also carry an optional image and hint.

Add New Question modal with the Question Type dropdown set to Multiple Choice and three answer options below

Or ask for a typed answer

To accept a typed response, set Question Type to Text Input and fill the Answer field with the expected answer. Keep text answers short and unambiguous so scoring stays fair.

Add New Question modal with Question Type set to Text Input and the Answer field highlighted

Review the question pool

Each saved question appears in the Quiz Questions list with its type and, for multiple-choice questions, a check on the correct answer. Use the row controls to reorder, duplicate, edit, or delete a question, and keep adding until the pool is complete.

Quiz Questions list showing the saved questions and the questions counter highlighted

Decide how many questions appear per run

Use Number of Questions to Show to control how many questions appear in a single session.

Set it lower than the pool size to show a random subset each time, so the quiz feels fresh on replay. Leave it empty to show the full pool.

Number of Questions to Show field highlighted

Turn on the optional open-ended question

To collect one last response after the scored part, switch on Enable open-ended question under Open-ended Question. You can then choose whether it accepts text only, an image, or both.

Open-ended Question section with the Enable open-ended question toggle highlighted

Write the participation message

Under Participation Message, add the message shown after the quiz ends. This sits alongside the score in the final summary — a good place to point players to the leaderboard and the prize.

Participation Message rich-text editor highlighted

Create the Leaderboard reward

Open the Rewards tab, select Add New Reward, then choose Create a Game Reward.

Create New Reward modal with the Create a Game Reward card highlighted

Choose Performance Based Reward

Pick Performance Based Reward — the skill-based type that ranks players by performance. It appears as Leaderboard in the rewards list. Create it, then set its title, icon, quantity, and winner message. Total Quantity is the number of winning positions you'll award.

One reward per performance game

Keep one Leaderboard reward linked to one quiz so the ranking context stays clear. See Leaderboard rewards for the full reward setup.

Game reward sub-types with Performance Based Reward highlighted

Back on the quiz's Appearance tab, scroll to Performance Rewards, select Add Reward, and pick your Leaderboard reward from the dropdown. The linked reward appears as a row in the section.

Performance Rewards section with the linked reward and Add Reward button highlighted

Publish

Save the touchpoint, then select Publish. When the dialog reads Campaign is ready to publish, confirm to make the quiz live. Warnings and suggestions are optional — only errors block publishing.

Publish dialog showing the campaign is ready to publish

What players see at the end

After the last scored question, the optional open-ended question can appear before the summary.

The summary then shows the player's score, the total questions, the completion time, and your Participation Message. This makes Quiz the best fit when you want players to understand their result right after finishing.

Keep the leaderboard fair

Fair leaderboard quizzes usually:

  • show fewer questions than the full pool when you want replay variety
  • avoid mixing very easy and very hard questions without a reason
  • keep text-input answers short and unambiguous when score matters
  • decide up front whether winners rank by Completion Time or by Score + Completion Time

If publishing is blocked

Open the Publish dialog and expand each section to read the exact blocker. Common fixes:

  • a Background Image is set on the Appearance tab
  • every question has at least text or an image
  • every multiple-choice question has at least two options and one correct answer
  • every text-input question has an expected Answer
  • the number of questions shown does not exceed the pool
  • the Participation Message is set, and the linked reward has a winner message

Configure the shared settings

Quiz shares the standard touchpoint tabs. Configure them from their own guides:

Was this helpful?

Optional comments help us improve this page for future authors and readers.

On this page