Gamification Mechanics

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

liveLeaderboardOption

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

gamification_minValue

gamification_maxValue

gamification_step

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

gamification_multiplier

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

gamification_scoringTrigger

gamification_points

Element Custom Fields

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

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

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 mechanics

  • votesEstimation — 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

The number of points awarded for a correct answer.

Accepted values

  • Numerical, allowing any number to be specified.

gamification_points_min

The minimum number of points that can be awarded.

Accepted values

  • Numerical, allowing any number to be specified.

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

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

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

Time or rounds after which points start decreasing.

decreasePeriod = elementEndAt - elementStartAt - decreaseStartCountdownMS

Accepted values

  • Numerical, specifying the countdown threshold.

gamification_correctAnswer

Indicator of the correct answer in the gamification process.

Accepted values

  • The answer number that is correct for the question.

gamification_minValue

The minimum possible value within the scoring range.

Accepted values

  • Numerical, defining the lowest allowable value.

gamification_maxValue

The maximum possible value within the scoring range.

Accepted values

  • Numerical, defining the highest allowable value.

gamification_step

The step interval for points or scoring increments.

Accepted values

  • Numerical, indicating the incremental step size.

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

Specifies a reduction factor for points over time or rounds.

Accepted values

  • Numerical, representing the decremental value.

gamification_max_points

The maximum limit for points a user can earn.

Accepted values

  • Numerical, setting the upper limit of points.

liveLeaderboardOption

Option to display live leaderboard standings.

Accepted values

  • Boolean, where true enables the leaderboard.

  • Boolean, where false disables it.

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?