Understanding Events
Learn what events are in Accoil, how they’re tracked, and how they power engagement, scoring, and activation insights.
Summary
Events are the core signals that tell Accoil what your users are doing. Tracked at the user level and connected to accounts, they power everything from segmentation and scoring to activation modelling and feature usage insights
How this helps
- Events provide visibility into user behavior
- They power key product analytics features
- Events tie user actions to account-level insights
What are Events?
In Accoil, events are the individual actions that users take inside your product. They’re how Accoil understands what your users are doing—and are the foundation for analyzing engagement, activation, and adoption.
These actions could be as simple as viewing a page or as meaningful as running a report, creating a resource, or completing a workflow.
What counts as an Event?
An event is any user-performed action that you choose to track from your product or system. These are often the key moments that show someone is interacting meaningfully with your product.
Some typical examples include:
- A user signs up
- A project is created or updated
- A report is downloaded
- A user invites a teammate
- A workflow or integration is completed
These events are tracked through track() calls and flow into Accoil as behavioral data points. See developer docs to learn more
Users perform Events — But Accounts are the anchor
All events are performed by users. However, because users in Accoil are always associated with an account, every event is also connected to that user’s account.
This account-level connection is critical: it allows you to analyze both individual behavior and account-wide engagement patterns using the same underlying event data.
Why Events matter
Events are central to understanding how people use your product. Once tracked in Accoil, they allow you to:
- Identify which users and accounts are actively engaging
- Power behavioral segments for targeting and outreach
- Define what activation looks like based on key actions
- Feed into engagement scoring models for accounts and users
Without events, Accoil has no visibility into what your users are doing in-product.
How Events work in Accoil
- Events are captured using
track()calls from your product or through a connected CDP like Segment. - Only users who trigger a scored event during the relevant workspace period are considered active in that workspace. A scored event is selected directly for the workspace or belongs to a feature selected for scoring.
- An account is active in a workspace when at least one associated user triggers a scored event during that period.
- Because scored events are configured per workspace, the same user or account can be active in one workspace and inactive in another.
- Since events are user-based but tied to accounts, account-level insights are built from the sum of individual user activity.
Where you’ll see Events in Accoil
Once events are being tracked, they show up across several key features in Accoil:
| Area | How Events Are Used |
|---|---|
| Dashboards and metrics | Use the Events dashboard and Metric Library to explore event activity and event-related metrics |
| Features | Group related events into a feature that represents a meaningful product capability |
| Segments | Filter users or accounts by specific events (e.g. “Has run a report in last 30 days”) |
| Activation Models | Define what actions indicate progress toward activation (e.g. “Invited a user”) |
| Workspaces | Include key events to determine engagement scores and active status for users or accounts |
.
Features and Events Overview
How user actions (events) and grouped behaviours (features) power engagement, activation, and adoption insights.
Understanding Features
Features allow you to group related product events into meaningful, user-facing capabilities—like \"Used Reports\" or \"Invited a Teammate.\