# Users Analytics

The **Users Analytics** module focuses on understanding user demographics, growth trends, and access behavior.

<figure><img src="https://835503362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxKMBw1IB53ZJ2sltFPC%2Fuploads%2FKK89egWQfHgCLO3UDita%2FFrame%201000004624.png?alt=media&#x26;token=9ea7ab9f-3901-44b6-b55c-e10504fe6fc3" alt=""><figcaption></figcaption></figure>

## User Demographics Visualization

An interactive world map visualizes user distribution by country. Each location is represented with dot sizes proportional to total users.

<figure><img src="https://835503362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxKMBw1IB53ZJ2sltFPC%2Fuploads%2F01kxhKuLN4L3tgAnFMXm%2FFrame%201000005170.png?alt=media&#x26;token=52b8398a-f5e6-42a8-b012-7ffee7923e06" alt=""><figcaption></figcaption></figure>

Hovering on a country reveals:

* Country name
* Total user count
* Percentage of total users globally

A bar char next to the map ranks the **Top 10 countries** based on user percentage.

## New User Registration Analytics

A line graph displays new user registrations using the `createdAt` timestamp from user records.

<figure><img src="https://835503362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxKMBw1IB53ZJ2sltFPC%2Fuploads%2FbGNszutqFXuYePtk582j%2FFrame%201000005161.png?alt=media&#x26;token=9acf4c2d-d35c-4a76-98bf-ab7eb08c67a3" alt=""><figcaption></figcaption></figure>

Filter options:

* **Daily**: Last 7 days
* **Weekly**: Last 7 weeks
* **Monthly**: Last 7 months

Only 7 data points are shown at a time to maintain clarity and relevance.

## User Sign-In Tracking Analytics

A separate line graph visualizes daily sign-ins based on unique IP address entries. It triggered when a new IP address is detected for a user.

<figure><img src="https://835503362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxKMBw1IB53ZJ2sltFPC%2Fuploads%2FPUj4RcEYSMqiCDIUQ3QB%2FFrame%201000005163.png?alt=media&#x26;token=c07933c9-97d5-4967-a908-4da2148fa378" alt=""><figcaption></figcaption></figure>

It applies the same filter as above (Daily, Weekly, Monthly).

## User IP Address Records

This section logs the IP addresses used to access the platform across all user accounts. It helps detect suspicious activity, such as shared access patterns, and supports fraud prevention efforts. Admins can view a user's login history, including timestamps and associated IPs, and identify if the same IP is used by multiple accounts.

<figure><img src="https://835503362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxKMBw1IB53ZJ2sltFPC%2Fuploads%2F4Z1TfI69QbElCuaT0cC1%2FFrame%201000004625.png?alt=media&#x26;token=ad14763b-ea31-4cba-a068-8b9ab815da1f" alt=""><figcaption></figcaption></figure>

A tabular section contains section-level access data:

| Column             | Description                       |
| ------------------ | --------------------------------- |
| **User**           | Display name or username          |
| **IP Address**     | Last recorded IP address          |
| **IP Country**     | Geolocation-based country         |
| **Last Signed In** | Most recent login timestamp (UTC) |
| **Created**        | User registration timestamp (UTC) |

{% hint style="info" %}
Records older than **3 months** will be automatically deleted from the backend table.
{% endhint %}