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.
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
We recommend frequently updating the list of platform users to keep the system
aware of the currently active user base.
Before sending platform users, you must create a project and retrieve your associated API key.
How to get a Nebuly API Key
Head to ⚙️ settings and navigate to “project settings”; - Create a new
project (if you don’t have one already) and give it a name (e.g. Internal
chatbot); - Copy the nebuly default_key that has been assigned to the
project.
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: