--- title: "Metrics Reference | Analytics | Ilmiya Documentation" description: "A metric-by-metric breakdown of everything Ilmiya Analytics tracks — what each number means and how it's calculated." url: "https://ilmiya.com/docs/analytics/metrics-reference/" language: "en" --- # Metrics Reference A plain-language, metric-by-metric breakdown of everything tracked in Analytics — what each number means for a student, and how it’s calculated behind the scenes. Each metric below is tagged with its current state: | Tag | Meaning | | --- | --- | | **Used** | Live in Analytics today | | **Partial** | Exists, with caveats | | **Not a feature** | Not implemented | * * * ## 01 · Accuracy — Used **What it means** The percentage of a student’s answers that are correct on a quiz or lesson attempt. It’s the foundation Mastery, Grades, and Trophies are all built on top of. **How it works** ``` correct answers ÷ total questions in the quiz = accuracy % ``` Recalculated every time a student submits or updates a quiz attempt. ## 02 · Streams — Partial **What it means** The live view teachers and admins watch. Every student shows up as a colored dot next to their name, and that color changes automatically as the student uses the app. **How it works** | Dot | State | Color | What it means | | --- | --- | --- | --- | | | **Active** | Green | Currently inside a lesson, quiz, or assignment and actively interacting — learning right now | | | **Idle** | Yellow | Still on a lesson/quiz screen, but no interaction for about 5 minutes — paused, not actively working | | | **Away** | Orange | Signed in and connected to the app, but not currently inside a lesson, quiz, or assignment at all | | | **Offline** | Red | Hasn’t logged in, or isn’t connected at all | > **Note** > > “Active on Aide” and “Active on Canvas” aren’t distinct states yet — leaving the main app for Aide or Canvas currently shows the student as Offline rather than “active elsewhere.” ## 03 · Activity — Partial **What it means** Each day a student is active, the minutes they spent get turned into a color on their calendar and progress views. **How it works** ``` 15 minute checkpoint reached → Red30 minute checkpoint reached → Orange45 minute checkpoint reached → Yellow60 minute checkpoint reached → Green — daily goal met ``` > **Note** > > The system tracks one combined “total time spent” per day today — it doesn’t yet separate time by Active/Idle/Away/Offline state, or by which app (LMS, Aide, Canvas) the time was spent in. ## 04 · Points — Used **What it means** The base currency everything else — Badges, Leaderboards — is built on. **How it works** ``` Answer a question correctly, for the first time → +1 point (some questions are worth more)Answer incorrectly → 0 points for that questionAnswer a question you already got right, again → no extra point — never duplicated ``` ## 05 · Badges — Used **What it means** Milestone rewards a student unlocks automatically as their point total grows — no teacher action needed. **How it works** There are 14 badge tiers, each with 10 levels — 140 badge levels in total. The moment a student’s running point total crosses into a new tier’s threshold, that badge unlocks: | 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 | Each tier is further divided into 10 levels, unlocking progressively as points climb from one tier’s threshold toward the next. Viewing badges: click **Awards** in the top navigation, then select the **Badges** tab — every unlocked badge is shown as a collection, with locked badges greyed out. ## 06 · Trophies — Used **What it means** Unlike badges (which track all-time points), a trophy reflects the correct-answer ratio achieved on that one quiz — not a longer-term milestone. **How it works** ``` Accuracy on this quiz = 100% → Platinum trophyAccuracy ≥ 85% → Gold trophyAccuracy ≥ 70% → Silver trophyAccuracy below 70% → Bronze trophy ``` > **Note** > > Figures shown live during an in-progress quiz are a preview and may be refined once the quiz is finalized. ## 07 · Mastery & Grades — Used **What it means** The closest thing today’s app has to a “grade” — a word describing how well a student did, based on their accuracy on an attempt. **How it works** ``` Accuracy = 100% → "Expert"Accuracy ≥ 85% → "Proficient"Accuracy ≥ 70% → "Competent"Accuracy < 70% → "Beginner" ``` > **Note** > > There’s no complete A–F letter-grade system today — these Mastery words are the real grade. If true letter grades are wanted, that would be new feature work to scope. ## 08 · Streaks — Used **What it means** Keeping a daily streak alive by coming back day after day. **How it works** ``` Active today, and also active yesterday → streak count goes up by 1Misses a full day with no activity → streak resets to 1 next time active ``` There’s also a separate set of streak-based rewards — similar to badges, but for hitting certain streak-length milestones — alongside this day counter. ## 09 · Progress — Used **What it means** Where a student stands on a given lesson or quiz. **How it works** ``` Lesson/quiz marked done → "Completed"Not done, but at least one question answered → "In Progress"Not done, nothing answered yet → "Not Started" ``` ## 10 · Consistency — Used **What it means** How many questions in a row a student has answered correctly. **How it works** ``` Answer correctly → "in a row" count goes up by 1Answer incorrectly → count resets to 0 ``` The best run during a session is what’s saved as the Consistency score. ## 11 · Speed — Used **What it means** How quickly a student is answering questions. **How it works** Speed is measured as questions answered per minute — a higher number means a faster pace, not “seconds spent per question.” It’s used consistently everywhere it’s shown, and also factors into leaderboard ranking. > **Note** > > A higher Speed value means faster (more questions per minute) — not average seconds per question. ## 12 · Ranking — Used **What it means** A student’s position on the leaderboard compared to classmates. Each rule below only kicks in if everyone above it is exactly tied. **How it works** ``` 1. Highest total points wins (checked first)2. Still tied? Less total time wins (faster overall finish)3. Still tied? Higher average accuracy wins4. Still tied? Higher average speed wins5. Still tied? Whichever account was created more recently wins (final tie-break) ``` ## 13 · Rewards / PBIS — Used **What it means** A manual point system teachers use to recognize or flag behaviour — separate from quiz performance. Nothing here is detected automatically; every point comes from a teacher’s action. **How it works** A teacher assigns a behaviour (e.g. “Helped a classmate,” worth +2) to a student or class, and those points are added to that student’s record immediately. A student’s behaviour score is the sum of all the behaviours logged for them. ## 14 · Attempts — Partial **What it means** How many times a student has tried a given quiz or lesson. **How it works** Every time a student starts a quiz or lesson, it’s recorded as one attempt — even if not finished. > **Note** > > Assignments can be configured with a maximum number of attempts allowed, but that limit isn’t enforced yet — students can currently retry as many times as they like regardless of the configured number. ## 15 · Focus — Not a feature There’s no dedicated “Focus” or attention-tracking metric in Analytics today — nothing like detecting tab-switching or unusually long pauses during a session. > **Note** > > If a genuine, distinct focus/engagement score is expected, treat it as net-new work — confirm what’s meant by “Focus” before assuming it exists. [Previous Awards](https://ilmiya.com/docs/analytics/awards/) [Next Overview](https://ilmiya.com/docs/administration/) --- [View this page on Ilmiya](https://ilmiya.com/docs/analytics/metrics-reference/) · [All pages in Markdown](https://ilmiya.com/markdown-index.md)