Metrics Reference
How every student metric is measured and calculated. A plain-language breakdown of the 13 metrics tracked in Campus — where each number comes from and the exact formula behind it. Scoring and gamification are calculated on our servers; the app displays the results.
- Get — where the raw data comes from
- Calculate — the formula applied to it
Each metric below is also tagged with its current state:
| Tag | Meaning |
|---|---|
| Used | Live in Campus today |
| Partial | Exists, with caveats |
| Not a feature | Not implemented |
Scoring & assessment
Section titled “Scoring & assessment”Everything in this section is derived from four values stored per quiz: correct answers, questions attempted, total questions, and time taken.
Points — Used
Section titled “Points — Used”Each question is worth a point value (default 1). A correct answer earns the full points; a wrong answer earns zero. Points per quiz roll up into the student’s lifetime coin balance, which drives badges and the leaderboard.
How we get it
Each question’s settings.points; summed per correct answer into obtainedMarks, then added to the wallet coin balance.
How we calculate
points earned = Σ (points of each correctly-answered question)lifetime coins = Σ (points earned across all quizzes)Grading — Used
Section titled “Grading — Used”There is no letter grade or GPA. A “grade” is the student’s average accuracy percentage, plus a simple pass/fail flag on each quiz.
How we get it
Average of the per-day accuracy figures already stored for the student.
How we calculate
grade = average( accuracy of all quiz-days )pass? = correct ÷ attempted > 80% → PASSED, else FAILEDMastery — Used
Section titled “Mastery — Used”A tiered icon placed on each quiz once completed, based on accuracy — and a special tier for a flawless, fast run.
How we get it
From the quiz’s accuracy %, mistake count, and average time per question at completion.
How we calculate
| Status / Tier | Color | Icon | When it shows |
|---|---|---|---|
| Excellence | Purple/Indigo | mastery-1.svg | 0 mistakes and average under 7 seconds per question |
| Mastered | Green | crown-green.svg | Accuracy ≥ 100% |
| Competent | Yellow | crown-yellow.svg | Accuracy ≥ 90% |
| Proficient | Orange | mastery-2.svg | Accuracy ≥ 70% |
| Familiar | Pink/Red | mastery-3.svg | Accuracy ≥ 50% |
| In Progress (fallback) | Blue | master-4.svg | Completed, accuracy below 50% |
Excellence is checked first, ahead of the accuracy bands. A completed quiz under 50% accuracy falls back to the same icon used for an unfinished attempt.
Status — Used
Section titled “Status — Used”Where a student stands on a lesson: Not Started → In Progress → Completed.
How we get it
From whether a quiz result exists and how many questions have been answered.
How we calculate
no result → Not Startedsome answers → In Progressattempted ≥ total → Completed| Status | Color | Icon |
|---|---|---|
| Not Started | Gray | crown-gray.svg |
| In Progress | Blue | master-4.svg |
Attempts — Partial
Section titled “Attempts — Partial”Every retake is recorded as a new attempt. Attempts are counted but never limited — there is currently no maximum-retake cap in the system.
How we get it
One quiz-result record is created each time a student starts the quiz.
How we calculate
total attempts = count of quiz-result records for that lessonre-attempts (reporting) = Σ total quizzes startedRewards & gamification
Section titled “Rewards & gamification”Earned automatically on the server as quizzes complete. Coins are the shared currency underneath badges and ranking.
Badges — Used
Section titled “Badges — Used”14 tiers (Bronze → Vibranium), 10 levels each = 140 badges. A badge unlocks the moment the student’s total coins reach that badge’s threshold.
How we get it
Compared against the student’s lifetime coin balance.
How we calculate
award every badge where coin_threshold ≤ student's coinstier level unlocks at: start + (gap × level)| Tier | Coin threshold |
|---|---|
| Bronze | 1,000 |
| Graphite | 5,000 |
| Quartz | 10,000 |
| Silver | 15,000 |
| Jade | 25,000 |
| Gold | 50,000 |
| Pearl | 100,000 |
| Titanium | 150,000 |
| Platinum | 200,000 |
| Emerald | 300,000 |
| Sapphire | 400,000 |
| Ruby | 550,000 |
| Diamond | 750,000 |
| Vibranium | 1,000,000 |
Trophies — Used
Section titled “Trophies — Used”Awarded per quiz according to the score achieved on it.
How we get it
From the quiz’s correct-answer ratio at completion.
How we calculate
Platinum 100%Gold ≥ 85%Silver ≥ 70%Bronze below 70%Rewards — Used
Section titled “Rewards — Used”This is the teacher behaviour-points system (conduct), separate from quiz coins. Teachers assign positive or negative points to students.
How we get it
From behaviour records assigned to the student by staff.
How we calculate
reward total = Σ positive points − Σ |negative points|Streaks — Used
Section titled “Streaks — Used”Rewards showing up day after day. The count grows by one for each consecutive active day and resets after a missed day.
How we get it
From the daily time-spent record and the date of the last active day.
How we calculate
if last active day was yesterday → streak + 1otherwise → streak resets to 1(a day counts once its time-spent target is met)Ranking (leaderboard) — Used
Section titled “Ranking (leaderboard) — Used”Campus has more than one leaderboard, and they don’t rank the same way. Computed live and refreshed on a schedule.
How we get it
From each student’s summed quiz results (points, time, accuracy, speed).
How we calculate
Overall Leaderboard (org/class-wide, across all quizzes combined) — points win first:
order by: total points ↓ (highest first) then total time ↑ (faster wins ties) then average accuracy ↓ then average speed ↓Lesson Leaderboard (one specific lesson, best completed attempt per student) — speed wins first instead:
order by: time ↑ (fastest first) then points ↓ then accuracy ↓ then speed ↓ then earliest attemptEngagement & activity
Section titled “Engagement & activity”How much and how consistently a student is working, drawn from daily quiz and time-spent rollups.
Progress — Used
Section titled “Progress — Used”There is no single ”% of course complete” number. Progress is shown as change over time — how this period compares to the last.
How we get it
From point/time totals of the current period versus the previous one.
How we calculate
progress % = (current − previous) ÷ previous × 100(also shown as this-week vs last-week change)Activity — Used
Section titled “Activity — Used”The volume of questions a student answers over time — shown as a daily / weekly / monthly chart. This is a count chart, not a social feed.
How we get it
From the daily quiz summary, grouped by day, week, month, or year.
How we calculate
activity = Σ questions answered (per time bucket)Streams — Not a feature
Section titled “Streams — Not a feature”There is no “Streams” feature in Campus. The word is reused internally for two unrelated things: the live presence-tracking connection, and a data endpoint that (despite its name) only returns daily time-spent figures. There is no social stream or feed to calculate.