Tracking Usage
Viven gives org admins several ways to monitor how their team is using the Digital Twin platform — from a high-level dashboard to raw CSV exports to direct SQL access for deeper analytics.
Analytics Tab
Navigate to Analytics from the sidebar to get a real-time view of adoption and engagement across your org.
The Analytics page has two tabs:
Overview
The Overview tab shows high-level usage metrics for your organization:
- Active Users (Last 7 Days / Last 30 Days) — Count of distinct users who queried the platform in the selected window, with a trend comparison against the prior equivalent period.
- Total Users — Total active users in the org (visible to admins with org-wide analytics access).
- Weekly Active Users — Area chart showing weekly active users over the past ~12 weeks.
- Monthly Active Users — Area chart showing monthly active users over the past ~12 months.
- Top / Bottom Users — Ranked list of users by query volume in the last 30 days. Toggle between top and bottom to identify your most and least active users.
- Top Digital Twins — The most-queried twins in the last 30 days, sortable by number of queries or number of unique users.
Org admins and users with org-wide analytics access see data across the entire org. Other users see analytics scoped to twins they manage.
Feedback
The Feedback tab shows a daily breakdown of response quality signals:
| Column | Description |
|---|---|
| Date | Day of the responses |
| Thumbs Up | Positive feedback count |
| Thumbs Down | Negative feedback count |
| No Feedback | Responses with no rating |
| Total Responses | Sum of all responses that day |
You can sort, filter by date, and download the table as a CSV directly from this view.
Exports Tab
Go to Admin Console → Data → Exports to generate detailed CSV reports. Reports are generated asynchronously and delivered to your email as a CSV attachment.
The Exports tab is available to Org Admins. If you don't see it, contact your Viven representative to enable it for your organization.
There are three reports available:
1. Usage Data (Users)
A per-user, per-day breakdown of activity over the last 90 days.
Useful for understanding individual adoption, identifying power users, and tracking engagement trends over time.
Each row in the export includes:
- User ID
- Date
- Total queries
- Positive feedback count
- Negative feedback count
2. Usage Data (Custom Twins)
A weekly breakdown of activity by custom twin (also called Expert Twins) over the last 90 days.
Useful for understanding which custom twins are being used most, and by whom.
Each row includes:
- User ID
- Twin name
- Week
- Total queries
- Positive feedback count
- Negative feedback count
3. Sync Status Report
A real-time snapshot of which users have connected their required data sources (e.g., OneDrive, SharePoint, Teams).
Since delegated data sources require each user to connect individually, this report helps admins track connection status and follow up with users who haven't synced yet.
Each row shows the user alongside a True / False flag for each required source.
Custom SQL via DB Explorer
Super admins have access to DB Explorer, a read-only SQL interface for running custom queries directly against the platform's usage log.
This is the right tool if the built-in exports don't cover your specific reporting needs — for example, filtering by team, department, date range, or twin type in ways the standard CSVs don't support.
To get started with DB Explorer, reach out to your Viven representative. They will:
- Provision access for the relevant super admin(s)
- Share the data dictionary so you understand the available tables and fields
DB Explorer provides read-only access scoped to usage and analytics data. It does not expose user message content or other sensitive data.
Custom Analytics in Your BI Tool
If your team uses a BI tool (e.g., Tableau, Power BI, Microsoft Fabric, or Metabase) and wants to pull Viven usage data directly into your own dashboards, Viven can give you access to the underlying tracking table.
This is ideal for teams that want to:
- Blend Viven usage data with other internal datasets
- Build custom dashboards on their existing BI infrastructure
- Schedule automated reports
To set this up, contact your Viven representative. They will walk you through the connection options and share the data dictionary for the relevant tables.
Analytics data is refreshed approximately once per day. It is not available in real-time.
Summary: Which option is right for you?
| Need | Where to go |
|---|---|
| High-level adoption dashboard | Analytics tab → Overview |
| Daily feedback quality tracking | Analytics tab → Feedback |
| Per-user or per-twin CSV report | Admin Console → Data → Exports |
| Custom SQL queries on usage data | DB Explorer (contact your Viven rep) |
| Connect usage data to your BI tool | Contact your Viven rep |