Games
How to create Gamification Content.
Multiple Types of Games
There are five (5) different types of games, as follows:
Raffle - After scanning, the user enters the game. At a set point in the future, the customer selects a winner.
Instant winner - After scanning, the user immediately finds out whether or not they have won a prize.
Quiz - After scanning, the user is given a quiz with several multiple-choice questions. After the answers are selected the user is shown their score.
One-question quiz - After scanning, the user is shown one multiple-choice question. After answering, the user is shown whether or not they answered correctly.
Multi-player trivia - A game similar to a quiz where the user with the highest score wins.
Raffle
The Raffle Game allows users to scan and enter the game and, at a set point in the future, the customer selects a winner.
Creating a Raffle
The following will outline the steps for creating a raffle at a high level. The following assumes the reader is familiar with the CMS system and the steps required to create a content item and campaigns.
Design
The steps of designing a raffle are outlined in Designing your Qapture Content. In the Design area, the user can choose to upload a cover photo for the raffle. Supported formats are .jpg, .png, and .gif. Alternatively, video can be uploaded as well.
Raffle
In the Raffle section, the user simply adds the Title (required) and subtitle (optional). There is a required Confirmation Icon that should be added by selecting the “Add Icon” button and choosing from our selection of icons. If you need to make a change to your selection, simply change the icon by selecting the 
button.
The “Confirmation Text” is the message that the user will see to inform him that his submission to the game has been successful. This field is required.
The “Code Title” is the title text that will appear above the confirmation code.
The “Participation Code Prefix” is a short customizable field of 1-6 characters that can be added to the system generated confirmation code. If left as-is, it will be populated by “SOD”.
Below this field, there is a checkbox allowing the user to denote whether or not he wishes the Rules of the game to be shown on the mobile to the user on this page. If checked, two additional boxes will appear - “Rules Title”, and “Terms and Conditions”. Both fields are then required fields, with the “Terms and Conditions” field containing a bulleted list.
Form
The Form is the first screen presented to the user after he or she scans. This is the form that the user must have filled out in order to proceed to be entered into the Game.
For more information about the initial form, see Utilizing the Embedded Form.
Finish
The Finish Screen is presented to the user in the case where entries to the raffle are no longer permitted but the winner has not yet been chosen.
There is an optional icon that can be added by selecting the “Add Icon” button and choosing from our selection of icons. If you need to make a change to your selection, simply change the icon by selecting the 
button.
The “Title” field to this page is required and there is room for additional optional text to explain that the time for submission of entries is over.
Below this field, there is a checkbox allowing the user to denote whether or not he or she wishes the Rules of the game to be shown on the mobile to the user on this page as well. If checked, the rules that were previously entered will appear on this page.
Sponsorship
Sponsorships can be added to the Raffles by following the instructions on the Utilizing the Sponsorship Section page.
Instant Winner Game
The Instant Win Game allows users to scan and immediately find out whether or not they have won a prize.
Creating an Instant Winner Game
The following will outline at a high level the steps for creating an instant winner game. The following assumes the reader is familiar with the CMS system and the steps required to create a content item and campaigns.
Design
The steps to designing the Instant Win game are outlined in Designing your Qapture Content. In the Design area, the user cant choose to upload a cover photo for the game. Supported formats are .jpg, .png, and .gif. Alternatively, video can be uploaded as well.
Instant Winner
The first portion of the Instant Winner section defines what happens in the case of a winning entry.
In the Instant Winner section, the user simply adds the Title (required) and subtitle (optional). There is a required Success Icon that should be added by selecting the “Add Icon” button and choosing from our selection of icons. If you need to make a change to your selection, simply change the icon by selecting the 
button.
The “Success Text” is the message that the user will see to inform him/her that the scan has resulted in an instant win. This field is required.
The “Code Title” is the title text that will appear above the confirmation code.
The “Code Prefix” is a short customizable field of 1-6 characters that can be added to the system generated confirmation code. If left as-is, it will be populated by “SOD”.
The next portion of the Instant Winner section defines what happens in the case of a non-winning entry.
Next, the user chooses a required Failure icon by selecting the “Add Icon” button and choosing from our selection of icons. If you need to make a change to your selection, simply change the icon by selecting the 
button.
The “Failure Text” is the message that the user will see to inform him/her that the scan has not resulted in an instant win. This field is required.
The following two fields, “Contact Title” and “Contact Value” are required and are used to display contact information for the contact for the game. For example, if someone were to have questions or issues with the game, this is who they would contact.
Below this field, there is a checkbox allowing the user to denote whether or not he or she wishes the Rules of the game to be shown on the mobile to the user on both the Success and Failure notification pages. If checked, two additional boxes will appear - “Rules Title”, and “Terms and Conditions”. Both fields are then required fields, with the “Terms and Conditions” field containing a bulleted list.
Dynamic Profile Update
The admin can add a property to a user's profile if they win an Instant Winner game. Together with the Exclusion Rules, this allows the admin to prevent a user from winning the game if they have already won a previous Instant Winner game.
Note: Dynamic Profile Update that is configured from the Instant Winner section of the editor is different from Dynamic Profile Update that is configured in the Info section. The latter adds a property once a user opens the content, more info in the Creating a Content Set page.
To add a Dynamic Profile Update:
Open the Instant Winner tab and select
from the top right corner of the section.Click on the checkbox titled "Allow dynamic profile update".\
Dynamic Profile Update settings Select either a "Managed" or an "Unmanaged" update type.
Managed: Update the value of a predefined User Property (Not recommended for the common use case).
Unmanaged: If the name of the Property that is entered does not match with an existing Property, a new Property with that name will be created and its value updated (Recommended).
Click on the drop-down menu labelled "App key" to select the App Key of the application that will be used to scan the Qapture code.
Click on the drop-down menu labelled either "Managed property" or "Unmanaged property", depending on the update type that was chosen, to select the property that will be updated or to create one if Unmanaged update type was chosen. For example, if the game is labelled "Instant Winner Week 42", the admin might name the property "winner_week_42".
Choose the new value that will be written to the Property once the Content is loaded on the user's application (for example, the value "true").
Click on the
button at the bottom of the settings menu to save the Dynamic Profile Update.
Winner Rules
This section denotes the type of Instant Win game that you are selecting. Once the user hits “Save” or “Save and Continue”, this field cannot be changed.
There are 4 types of Instant Win Games (Winner Types):
All Winners - Every scan is a winner
Random Winners - the CMS will randomly select winners
Every X Users - The CMS will count scans and choose winners in order
The Xth Scan - One winner will be chosen at a particular scan count
All Winners
Every scan is a winner. You must select the maximum number of winners you would like in the field marked “Max Winners”. This is useful for contests such as "the first 100 scans win".
Random Winners
The CMS will randomly select winners based on the information you provide. In the field marked “Probability of Success” you simply input the success rate you want to be utilized in numerical format.
For example, if you want 1 winner out of every 1,000 scans, you simply divide 1 by 1000 and arrive at the answer of 0.001. You would therefore input “0.001” into the “Probability of Success” field.
Additionally, you must also select the maximum number of winners you would like in the field marked “Max Winners”. Once the maximum number has been awarded, no more winning scans will be awarded.
Every X Users
The CMS will count the scans in the order they were scanned and determine a winner based upon that. For example, you may choose to have every 1000th scan be a winner. You simply choose what the value of “X” is (i.e. 1000) and what the maximum number of winners is that you would like. Once the maximum number has been awarded, no more winning scans will be awarded, regardless of if they are the Xth scan or not.
The Xth Scan
The CMS will count the scans in the order they were scanned and determine the winner based on the number you have pre-selected. For example, if you choose that x is 1,000,000, then the one millionth scan will be determined to be the winner. In this scenario, there can only be one winner.
Exclusion Rules
Within the Winner Rules section, it is possible to add one or more exclusion rules that make certain users ineligible for winning an Instant Winner game. The exclusion rules are based on profile properties. The intended use case for this capability is to be used together with the Dynamic Profile Update in the Instant Winner section of the editor. The admin can exclude a scanner from winning if they have already won a previous Instant Winner game, by adding a property with value "true" in other Instant winner games and excluding that property and value.
To add an exclusion:
From the dropdown menu titled "App key*", select the application that the code will be scanned with.
In the menus that appear, select the Name of the desired property, the Operator (Equals, Not equals, Greater than, or Less than), and the Value of the property.
If desired, click on "+ Add property" to add another property to the exclusion rule.
Form
The Form is the first screen presented to the user after he or she scans. This is the form that the user must have filled out in order to proceed to be entered into the Game.
For more information about the initial form, see Utilizing the Embedded Form.
Finish
The Finish Screen is presented to the user in the case where the game might be over, but the code is still available for scanning for some reason.
There is an optional icon that can be added by selecting the “Add Icon” button and choosing from our selection of icons. If you need to make a change to your selection, simply change the icon by selecting the 
button.
The “Title” field to this page is required and there is room for additional optional text to explain that the time for submission of entries is over.
Below this field, there is a checkbox allowing the user to denote whether or not he wishes the Rules of the game to be shown on the mobile device to the user on this page as well. If checked, the rules that were previously entered will appear on this page.
Pick a Box
In a Pick a Box game, users must select from a number of boxes that appear on the screen. If the user wins, they can either win a prize or be taken to another content item. The Winner Rules for a Pick a Box game are identical to the rules for Instant Winner games.
Creating a Pick a Box Game
The following will outline at a high level the steps for creating a Pick A Box game and assumes the reader is familiar with the CMS system and the steps required to create a content item and campaigns.
Pick a Box Section
In this section, configure the core elements of the game visible to the user, including the title, subtitle, and display of boxes.
Title: Appears above the boxes
Subtitle (optional)
Number of boxes: The number of boxes that will appear on the screen, between 1 and 12
Box Background: The boxes can be framed in a black or white square, or the background can be transparent
Box alignment format: The boxes can be displayed 1, 2, or 3 in a line
Box style: choose between several designs for the boxes
Enable multiple entries for the same user: Allow user to play the same game more than once
Winner Rules
This section denotes the rules by which winners are selected. Once the user hits “Save” or “Save and Continue”, this field cannot be changed.
There are 4 types of Instant Win Games (Winner Types):
All Winners - Every scan is a winner
Random Winners - the CMS will randomly select winners
Every X Users - The CMS will count scans and choose winners in order
The Xth Scan - One winner will be chosen at a particular scan count
All Winners
Every scan is a winner. You must select the maximum number of winners you would like in the field marked “Max Winners”. This is useful for contests such as "the first 100 scans win".
Random Winners
The CMS will randomly select winners based on the information you provide. In the field marked “Probability of Success” you simply input the success rate you want to be utilized in numerical format.
For example, if you want 1 winner out of every 1,000 scans, you simply divide 1 by 1000 and arrive at the answer of 0.001. You would therefore input “0.001” into the “Probability of Success” field.
Additionally, you must also select the maximum number of winners you would like in the field marked “Max Winners”. Once the maximum number has been awarded, no more winning scans will be awarded.
Every X Users
The CMS will count the scans in the order they were scanned and determine a winner based upon that. For example, you may choose to have every 1000th scan be a winner. You simply choose what the value of “X” is (i.e. 1000) and what the maximum number of winners is that you would like. Once the maximum number has been awarded, no more winning scans will be awarded, regardless of if they are the Xth scan or not.
The Xth Scan
The CMS will count the scans in the order they were scanned and determine the winner based on the number you have pre-selected. For example, if you choose that x is 1,000,000, then the one millionth scan will be determined to be the winner. In this scenario, there can only be one winner.
Exclusion Rules
Within the Winner Rules section, it is possible to add one or more exclusion rules that make certain users ineligible for winning a game. The exclusion rules are based on profile properties. The intended use case for this capability is to be used together with the Dynamic Profile Update in the Info section of the editor. The admin can exclude a scanner from winning if they have already won a previous Instant Winner game, by adding a property with value "true" in other Instant winner games and excluding that property and value.
To add an exclusion:
From the dropdown menu titled "App key*", select the application that the code will be scanned with.
In the menus that appear, select the Name of the desired property, the Operator (Equals, Not equals, Greater than, or Less than), and the Value of the property.
If desired, click on "+ Add property" to add another property to the exclusion rule.
Quiz
The Quiz game allows users to participate in a quiz after scanning a Qapture code.
Creating a Quiz
The following will outline at a high level the steps for creating a quiz game and assumes the reader is familiar with the CMS system and the steps required to create a content item and campaigns.
Design
The steps to designing the Quiz are outlined in Designing your Qapture Content. In the Design area, the user can choose to upload a cover photo for the quiz. Supported formats are .jpg, .png, and .gif. Alternatively, video can be uploaded as well.
Quiz Section
The Quiz section allows you to choose the title and subtitle for the quiz, as well as the quiz's settings.
The first field is the "Quiz title" field, which will be displayed at the top of the page and is mandatory.
The following "Subtitle" field is optional and will be displayed below the title if filled.
If the user checks the checkbox marked "Allow shuffle the answers", the answers will be shown to the users in a different order every time the Qapture code is scanned.
If the user checks the checkbox marked "Show right answers immediately", two further options will appear:
If the checkbox marked "Show right answers immediately" is checked, the right answer will appear after an answer was chosen, in the same page. If the checkbox "Show right answers on results screen" is checked, a link to the quiz's right answers will be displayed in the final results screen with its chosen title.
If the user checks the checkbox marked "Enable multiple entries for the same user", a "try again" button will be displayed at the final screen after the quiz was submitted. For this purpose, further fields will need to be filled:
The user must fill the "Try again" button title field. It's possible to check the checkbox marked "Limit number of tries", in which case the participant in the quiz will be shown an error text if they try to take the quiz more than the chosen number of tries. If this option is chosen, the user must fill the "Limit number of tries" field, and the "Limitation error text" field, which will contain the text displayed after the participant has exceeded their allowed number of tries.
Q&A
The quiz's questions and answers are entered in the Q&A section.
To add a new question, simply click the 
button. It is possible to reorder the questions by clicking the three dots 
on the left side of the question and dragging it to its new position.
For each question, the "Question title" must contain the body of the question, with an option to add a subtitle.
Each question must have at least one Answer. The answer's text is filled in the "Title" field. Additionally, the user can click the "Correct answer" switch to indicate that the answer is correct (Note: more than one question can be correct)
An Icon or Image can be added by clicking on the 
or 
button, respectively.
Results Screens
The Results screen is displayed once the participant has answered all the available questions.
It is mandatory to fill in the "Results title" field, which will be displayed above the results. Also, the user must choose an Icon or Image to be displayed above the title.
The field "Score title" is mandatory and will be displayed above the participant's score. The "Answers title" field must also be filled and will be displayed above the quiz's answers.
One-Question Quiz
A One-Question Quiz is a game where the user is given one multiple-choice question to answer upon scanning a Qapture Code. After the question is answered, the result displays whether or not the user answered correctly.
Creating a One-Question Quiz
The following will outline at a high level the steps for creating a quiz game. The following assumes the reader is familiar with the CMS system and the steps required to create a content item and campaigns.
Design
The steps to designing the One-Question Quiz are outlined in Designing your Qapture Content. In the Design area, the user can choose to upload a cover photo for the quiz. Supported formats are .jpg, .png, and .gif. Alternatively, video can be uploaded as well.
Q&A
See the Q&A section in Creating a Quiz. It is not possible to add further questions in a One Question Quiz.
Results Screens
In this section, the user chooses the title and image displayed when the question was answered correctly or incorrectly.
Rating Game
The Rating Game content type allows you to create an interactive experience in which users rate a media item—an audio clip, image/GIF, or video—directly within the content page. After submitting a rating, users are automatically redirected to one of two result screens:
High Rating Screen – displayed when the user’s rating is greater than or equal to a defined threshold.
Low Rating Screen – displayed when the user’s rating is below that threshold.
The Rating Game supports configurable scoring logic, multiple user attempts, and custom result screens.
Creating a Rating Game
Rating Game Section
This tab contains the core configuration options for the game logic and media.
Game Information
Game title
Standard field, required. Displayed at the top of the game page.
Subtitle
Standard field, optional.
Your score title
Label displayed above the score input area.
Upload media
Upload the main media file for the game. Required. Supports sound, image/GIF, or video. Only one media item can be uploaded.
Media description
Optional text displayed below the media.
Entry Settings
These settings function identically to other standard content types:
Enable multiple entries for the same user
“Try again” button title
Limit number of tries
Number of tries
Limitation error text
Rating Configuration
Define how the rating system behaves:
Basic rating
The number shown to users as the visible rating range. Required. Default: 10. Min: 1, Max: 100000.
Rating limit for input
Maximum number a user can enter as their score. Required. Default: 100. Min: 0, Max: 9,999,999,999.
Consider as high rating
The threshold used to determine whether the high or low rating screen is shown. Required. Min: Basic displayed rating limit. Max: 9,999,999,999. Must not exceed "Rating limit for input".
High Rating Screen
This screen is shown when the user enters a score greater than or equal to the value configured in Consider as high rating.
Configuration Options
Game title
Standard field.
Subtitle
Standard field.
Score title
Title displayed above the score area.
Upload media
Media shown on the high-rating screen. Required. Supports: None, Image/GIF, or Video.
Low Rating Screen
This screen is shown when the user enters a score below the configured high-rating threshold.
Configuration Options
Game title
Standard field.
Subtitle
Standard field.
Score title
Title displayed above the score area.
Upload media
Media shown on the high-rating screen. Required. Supports: None, Image/GIF, or Video.
Turning a Game Off / On
In the main Contents screen, hovering the mouse over the card of a Gamification content type reveals a pause/play button that allows you to Enable 
or Pause 
the games.
By clicking the Pause 
button, you will pause the game. When the game is paused, the Finish screen will appear whenever someone tries to scan the Qapture code for the first time; however, anyone who has already scanned the code will have the success or failure that was previously presented to them be shown again. This enables them to be able to retrieve a success code from a Paused game.
The Game can also be set to end on a specific date by choosing an Expiry Date in the campaign's configuration.
Sponsorship
Sponsorships can be added to the Games by following the instructions on the Utilizing the Sponsorship Section page.
Social Media
Links to social media can be added to the Content by following the instructions in the Utilizing the Social Media Section page.
Branding
Branding can be added to the Content by following the instructions in the Utilizing the Branding Section page.
Specifications
For a breakdown of the specifications and limitations of each content type, see Content Specifications.
Last updated