# Performance & Analytics

The tenant gives you analytics at three levels: classroom-wide, per-game, and per-participant. You can track engagement, spot which questions are tripping people up, and export the data when you need it elsewhere.

## Accessing Analytics

### Classroom Analytics

1. Open your classroom
2. Click the menu next to the class name
3. Select the analytics or statistics option

You'll see total participants, overall completion rates, and aggregate performance.

<figure><img src="/files/o37Hp4uicgtVCTThi4YN" alt=""><figcaption></figcaption></figure>

### Game Analytics

1. Open your classroom
2. Click an individual game
3. Select the **Analytics** tab in the tab pane

## Classroom-Level Analytics

Tracks each participant across every game in the classroom. For each user you can see questions completed, completion percentage, time spent, and last activity.

<figure><img src="/files/x9JQQDaAl2tdRIUV2Gi3" alt=""><figcaption></figcaption></figure>

Useful for spotting people who need help, tracking engagement over time, and pulling progress reports for stakeholders.

The aggregate view shows average completion rate, total questions answered, overall accuracy, and retention metrics across the whole classroom.

## Game-Level Analytics

### Question Performance

For each question in a game you can see how many players answered correctly, how many tried and failed, average attempts, and time-to-completion distribution.

<figure><img src="/files/AI4wkfythBrgfzJQBIuq" alt=""><figcaption></figcaption></figure>

This is what tells you which concepts to reinforce ahead of time, where to add hints, or where the difficulty curve is too steep.

### Completion Rates

Tracks the percentage of participants who finish, average completion time, drop-off points in the game flow, and return rate for incomplete games.

### Live Scoreboard

During an active game, you get real-time standings, points per participant, progress through modules, and time-based metrics. Useful for fueling competition during the event and figuring out when most people are wrapping up so you can call time.

## Individual Participant Analytics

For any single participant you can see questions attempted and completed, correct vs incorrect answers, time per question, overall completion status, and badge unlocks.

To get there:

1. Open the classroom or game
2. Go to the Students/Participants tab
3. Select a participant
4. View their analytics

If they've played multiple games, you also get trends across games to track skill development.

## Auto-Assign

<figure><img src="/files/WYTkRcN61YZyVJk4TFvx" alt=""><figcaption></figcaption></figure>

Auto-assign is a per-game toggle that controls whether classroom members are automatically enrolled in a game. By default it's off, which means classroom membership alone doesn't grant access to a game. To get someone into a game without auto-assign, you either share the game's join link or manually add them to the roster.

That's fine for one-off events. For larger or longer programs, manual assignment doesn't scale. A semester class with weekly games and 30 students is 450 individual enrollments.

### How it Works

**On.** Every current classroom member is enrolled in the game immediately. Anyone who joins the classroom later is auto-enrolled too.

**Off.** No automatic enrollment, now or later. Each enrollment happens manually or through the game link.

Players already enrolled stay enrolled even if you turn auto-assign off. To remove someone, go to the Game Management page and remove them manually.

### Multi-Week Programs

Auto-assign's toggle behavior makes it useful for staged content rollouts.

For a ten-week program, create all ten games up front with names like "Week 1 - Introduction", "Week 2 - Network Analysis", and so on. Turn auto-assign on for Week 1 only. Participants joining the classroom see Week 1 in their library. Weeks 2 through 10 stay hidden because their auto-assign is off.

At the start of each week, turn on auto-assign for that week's game. Current members get enrolled instantly. Late joiners get enrolled in every week up to the current one, so they can catch up but can't jump ahead.

By the final week, everything's enabled. Anyone joining late has access to all ten games.

## Workflows

**Post-event.** Review game analytics for hard questions, check completion rates for engagement, look at individual performance for follow-up, export data for records.

**Ongoing programs.** Check classroom analytics weekly for trends. Watch individual progress for at-risk participants. Adjust content based on question difficulty data.

**Improving future events.** Pre-teach questions that consistently stump people. Look at drop-off points for engagement issues. Use time-to-completion to plan event duration.

## Exporting Data

You can export to CSV (for spreadsheets), PDF (for reports), or JSON (for integrations).

1. Open the Analytics tab at the classroom or game level
2. Click the export or download button
3. Pick a format
4. Choose the date range or data set
5. Download

Available exports include participant rosters with completion status, question-level statistics, individual participant detail (including answers), and aggregate metrics.

## Growth Statistics

The `/stats/growth` page shows tenant-wide trends. Get there from your dashboard by clicking **Statistics** or **Growth** in the main navigation.

The median completion time panel lists each game in your tenant with its name, median completion time, completion status (started vs completed), and basic game details.

Median is the middle participant's time, which keeps outliers from skewing things. Only fully completed plays count, and time runs from first attempt to final question. Games without enough completions show as "Insufficient Data."

This is what you use to set realistic time expectations for future events, see which games people abandon, and compare difficulty across modules.

## Data Privacy

| Role              | Can View                                                |
| ----------------- | ------------------------------------------------------- |
| Tenant Manager    | All analytics across the tenant, including growth stats |
| Classroom Manager | Analytics for assigned classrooms only                  |
| Participant       | Only their own performance                              |

Analytics data is preserved indefinitely. Deleted games keep their analytics in archived state. Removing a user preserves anonymized data.

## Troubleshooting

**Analytics not updating.** Usually a cache delay (clears in a few minutes) or stale browser data. Refresh the page, clear your cache, or wait it out.

**Missing participant data.** Check that they're actually enrolled, that they logged in with the right account, and that they started the game. Verify their username spelling.

**Export failing.** Try a smaller date range or a different format. Check your browser's download settings. Confirm your role has export permission.

## Related Documentation

* [Managing Games](/using-the-tenant-system/managing-games.md) - Creating and configuring games
* [Managing Users](/using-the-tenant-system/managing-users.md) - User enrollment and roles
* [Organizing Classrooms](/using-the-tenant-system/managing-games/classrooms.md) - Grouping games for analysis

***

[Back to Tenant Overview](/using-the-tenant-system/overview.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kc7cyber.com/using-the-tenant-system/analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
