# Analytics

{% embed url="<https://youtu.be/2BPuWnU70Ro?feature=shared>" %}

## Overview

Breakroom provides basic analytics reports in the form of an auto-generated CSV file, which [World Owners](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#owner) and [World Administrators](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#administrator) can download from the [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour) or email to themselves.&#x20;

{% hint style="info" %}
Only [World Owners](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#owner) and [World Administrators](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#administrator) can access the Dashboard.
{% endhint %}

## Interpreting basic analytics report data

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FwKKQOu90Fx33ifAAiQ0C%2FAnalytics_001.png?alt=media&#x26;token=765ceb45-b49a-4b48-ab0f-e1318656bb56" alt=""><figcaption><p>Pictured: An example of a basic analytics report.</p></figcaption></figure>

User visits are represented by rows, while key information is listed in each column.

<table><thead><tr><th width="157">Column</th><th>Contents</th></tr></thead><tbody><tr><td>Grid</td><td>This number corresponds to the grid, or World, the user accessed.</td></tr><tr><td>UserID</td><td>The ID of the user who visited your World.</td></tr><tr><td>Username</td><td>The user's name.</td></tr><tr><td>Region</td><td>The Region ID the user visited.</td></tr><tr><td>RegionName</td><td>The name of the Region the user visited.</td></tr><tr><td>LoginTime</td><td>When the user logged in.</td></tr><tr><td>LogoutTime</td><td>When the user logged out.</td></tr><tr><td>SpendTime</td><td>How long the user spent in a particular Region.</td></tr><tr><td>LoginFrom</td><td>Whether the user logged in from a <a href="desktop-viewers">desktop viewer</a> or via <a href="world-stream">World Stream</a>.</td></tr><tr><td>Session</td><td>The user's session ID.</td></tr><tr><td>Email</td><td>The email associated with the user's account.</td></tr></tbody></table>

{% hint style="warning" %}
Users may decline to share certain data by personalizing the [Analytics and Marketing Preferences](https://docs.breakroom.tech/getting-started/settings#analytics-and-marketing-preferences-settings) available under the Settings panel. If users decline to share their data, you may see this data (such as usernames, user IDs, and email addresses) replaced by asterisks in your analytics report.
{% endhint %}

## Accessing basic analytics reports

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2F5JFFOrfumERqd5Fsskow%2FAnalytics_002.png?alt=media&#x26;token=f5cfeeee-3b8e-4549-a06a-6a7e912670ae" alt="" width="563"><figcaption><p>Pictured: The Dashboard > Analytics tab.</p></figcaption></figure>

To generate and download a basic analytics report, follow these steps.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click on the **Analytics tab**.
3. Use the calendars to select a start date and an end date for your report.
4. Click the **Generate Analysis Report button**.

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FRf3SDwc5hoauqfcHs8Aw%2FAnalytics_003.png?alt=media&#x26;token=0422f3bf-387b-45b5-9557-0bd53edae850" alt=""><figcaption></figcaption></figure>

5. A pop-up will appear confirming that your report has been created. Click the **Email Report button** to send a copy of the report file to your email address. Click the D**ownload Report button** to immediately download the report file to your computer.

{% hint style="info" %}
The filename will automatically indicate the World ID, ISO date, and generation time of the report. Please note that the generation time is listed in 24-hour format GMT.
{% endhint %}