Gamification Mechanics
To make the most of this document, please ensure you're familiar with App Specs and know how to configure custom fields for your Elements.
Gamify supports a number of Gamification Mechanics — rules for translating users' behaviour into points. The simplest Gamification Mechanics is to award a fixed number of points for a "correct" answer to the question — but it gets quite a bit more complicated than that.
Mechanics and their properties are defined by the Custom Fields of an Element. Gamify reads those Fileds to find out whether the Element needs to be processed and — if yes — how. This document describes the Field names and their expected values.
Supported mechanics
Trivia
The Trivia mechanics is designed to reward users for answering trivia questions correctly. It encourages participation by awarding points for correct answers to questions, typically related to general knowledge or specific topics. This mechanics is used to engage users with interactive quizzes or games where the goal is to test their knowledge and reward them for accuracy.
Required fields
gamification_points_mechanics must be set as votesTrivia
gamification_points_correctAnswer
Optional Fields
Estimation
The Estimation mechanics allows users to earn points based on how close their answers are to an estimated value or outcome. This mechanics is typically used in scenarios where users predict a value, and points are awarded depending on how accurate their prediction is, relative to the correct or actual outcome.
Required fields
gamification_points_mechanics must be set as votesEstimation
Prediction
The Prediction mechanics is designed to award points to users based on their ability to correctly predict the outcome of a specific event or scenario. In this mechanics, users provide a forecast or guess regarding a future event, and points are awarded if their prediction turns out to be correct.
Required fields
gamification_points_mechanics must be set as votesPredict
gamification_points_correctAnswer
Optional Fields
PredictionWithMultiplier
The PredictionWithMultiplier mechanics works similarly to the standard Prediction mechanics, with the added feature of multiplying the base points by a predefined multiplier. The multiplier increases the total points awarded for a correct prediction, making it more dynamic and rewarding for users who make accurate forecasts.
Required fields
gamification_points_mechanics must be set as votesPredictorWithMultiplier
gamification_points_correctAnswer
Tracking
The Tracking mechanics is used to award points based on specific tracked actions or behaviours over time. This mechanics allows for point accumulation based on how users interact with certain activities or events, encouraging ongoing engagement and rewarding users for consistent or specific behaviours that are being monitored or tracked.
Required fields
gamification_points_mechanics must be set as votesTracking
Poll
The Poll mechanics is used to award points based on user participation in a poll or survey. This mechanics allows users to earn points for submitting their votes or responses, typically in a multiple-choice or single-choice format. It is designed to encourage engagement by rewarding users for contributing their input to polls, which can be used for decision-making, feedback, or gathering opinions.
Users are rewarded for participation, there's no concept of "correct" or "incorrect" response in this mechanics.
Required fields
gamification_points_correctAnswer
Multi Score Poll
The Multi Score Poll element allows for awarding different points for each question or answer option within a poll. Unlike traditional polls where users typically earn a uniform point value for participation, this element lets each question or response option have its own set of points, offering more flexibility in the scoring system.
Required fields
gamification_points_mechanics must be set as votesMultiScorePoll
Element Custom Fields
gamification_multiplier
gamification_multiplier
The field defines a multiplier that directly scales the number of points awarded to a user. It is applied to the base points to modify the final score, providing dynamic adjustments based on specific conditions or game mechanics.
gamification_points
gamification_points
The number of points each user will receive for a correct answer.
Custom Fields
The below Element Custom Fields are expected to be defined by the Application Spec in order to "tell" Gamify how to process the Element. Not all of them are always required, some are only needed to support a particular mechanics.
gamification_points_mechanics
gamification_points_mechanics
This field must be present in an Element that needs to be processed by Gamify. It defines which Gamification Mechanics will be applied to the Element.
Accepted values
noPointsAllocated
— Gamification will not be applied to the Element.votesTrivia
— enables Trivia mechanicsvotesEstimation
— Enables Estimation mechanics, awarding points based on how close users' answers are to an estimated value or outcome.votesPredict
— Enables Prediction mechanics, granting points for correctly predicting the outcome of a specific event or scenario.votesPoll
— Enables Poll mechanics, where points are assigned based on user participation in polls or votes.votesPredictorWithMultiplier
— Enables Predictor With Multiplier mechanics, similar to standard prediction but with a point multiplier based on predefined conditions.votesTracking
— Enables Tracking mechanics, where points are awarded based on specific tracked actions or behaviours over time.votesMultiScorePoll
— Enables Multi Score Poll mechanics, allowing users to earn points from multiple scoring options within a poll, where different answers may yield varied point values.
Accepted values
numerical, allowing any number to be specified.
gamification_points_correctAnswer
gamification_points_correctAnswer
The number of points awarded for a correct answer.
Accepted values
Numerical, allowing any number to be specified.
gamification_points_min
gamification_points_min
The minimum number of points that can be awarded.
Accepted values
Numerical, allowing any number to be specified.
gamification_points_scoringMode
gamification_points_scoringMode
The mode used to determine scoring behaviour.
Accepted values
onClose
: Points will be awarded when the element is closed.onVote
: Points will be awarded each time new votes are received on the certification.
gamification_roundNumber
gamification_roundNumber
The current round number or identifier in the gamification sequence.
Accepted values
Numerical, representing the sequence number of the round.
String, allowing descriptive identifiers.
gamification_points_mechanic
gamification_points_mechanic
The specific mechanic applied for point calculation.
Accepted values
fixed
: Points are awarded at a constant, unchanging rate.decreasing
: Points decrease incrementally over time or events.exponentialDecreasing
: Points decrease at an exponential rate, reducing faster as time or events progress.
gamification_points_decreaseStartCountdown
gamification_points_decreaseStartCountdown
Time or rounds after which points start decreasing.
Accepted values
Numerical, specifying the countdown threshold.
gamification_correctAnswer
gamification_correctAnswer
Indicator of the correct answer in the gamification process.
Accepted values
The answer number that is correct for the question.
gamification_minValue
gamification_minValue
The minimum possible value within the scoring range.
Accepted values
Numerical, defining the lowest allowable value.
gamification_maxValue
gamification_maxValue
The maximum possible value within the scoring range.
Accepted values
Numerical, defining the highest allowable value.
gamification_step
gamification_step
The step interval for points or scoring increments.
Accepted values
Numerical, indicating the incremental step size.
gamification_points_coefficient
gamification_points_coefficient
A coefficient used in point calculations, often as a multiplier.
Accepted values
Numerical, acting as a factor in point multiplication.
gamification_points_reduction
gamification_points_reduction
Specifies a reduction factor for points over time or rounds.
Accepted values
Numerical, representing the decremental value.
gamification_max_points
gamification_max_points
The maximum limit for points a user can earn.
Accepted values
Numerical, setting the upper limit of points.
liveLeaderboardOption
liveLeaderboardOption
Option to display live leaderboard standings.
Accepted values
Boolean, where
true
enables the leaderboard.Boolean, where
false
disables it.
gamification_scoringTrigger
gamification_scoringTrigger
Value, which triggers scoring for Elements that do not have a "native" scoring trigger.
Accepted values
Boolean,
true
starts the scoring.
Last updated
Was this helpful?