Getting started

Nebuly’s analytics platform provides deep insights into your AI system usage by leveraging both user interactions and platform user metadata. One of the most important concepts for accurate metric computation is the Platform User.

​

What are Platform Users?

Platform users represent the population of users who have access to your AI platform. Unlike interaction events, which capture what users do, platform users define who is allowed to use the platform, and when.

Tracking platform users is essential for calculating high-level KPIs such as:

• Activation rate – the percentage of platform users who are actively using the AI system.

Each platform user has:

• A unique identifier (end_user)
• A set of tags that describe user attributes (e.g., region, department, role)
• A start date (active_from) indicating when the user gained access
• An optional end date (active_to) marking when access was removed

​

Step 0: Get your API key

Before sending platform users, you must create a project and retrieve your associated API key.

​

Step 1: Send Platform Users

There are three available endpoints to manage platform users:

Each endpoint allows you to insert, update, or delete platform users by providing a list of user records with structured metadata. This gives Nebuly visibility into your total addressable user base at any point in time.

We also provide a GET endpoint to retrieve all platform users for inspection:

​

Why are Platform Users Important?

While interaction events tell us what users did, platform users tell us who could have done it. This context is crucial for meaningful metrics:

• If you had 100 users with access last week, and only 10 used the system, your activation rate is 10%.
• If you remove old users or add new ones but don’t update the platform user list, metrics like activation rate become misleading.

Keeping the platform user list fresh and synchronized ensures accurate metric computation.