Analytics

Turn first-party event data into practical insights and personalized experiences.

Bosca Analytics helps you see what resonates with your audience so you can make smarter decisions, faster.

What you get

  • Clear insight into content performance and engagement
  • First-party data collection you control
  • Signals that power personalization and AI enrichment
  • Dashboards your teams can actually use
  • SQL-based data exploration through Trino

Where your data comes from

  • Lightweight browser and app SDKs capture key events (page views, actions, completions)
  • Server-side events fill in the gaps where needed
  • The Analytics SDK is distributed via NPM for easy integration

Auto-Instrumentation

The Analytics SDK includes automatic instrumentation that tracks user behavior with zero extra setup:

  • Click tracking
  • Scroll depth
  • Page views
  • Form interactions
  • Mouse movement
  • Element visibility

This data is suitable for building heat maps and understanding user behavior patterns across your content.

How data is stored

Events flow through the Analytics Collector service and are persisted using an Apache Iceberg catalog backed by S3-compatible object storage. This architecture makes data suitable for both real-time insights and long-term batch processing.

A dedicated analytics warehouse database (separate from the primary operational database) stores structured query results and aggregations.

Querying with Trino

Bosca integrates Trino as a distributed SQL query engine for analytics workloads. Trino connects to the Iceberg catalog and S3 storage, enabling standard SQL queries over your event data.

AI agents can also query analytics data through Trino, allowing natural language data exploration via the MCP server.

Dashboards

Bosca includes configurable dashboards that surface important metrics directly in the Administration UI. Dashboard configurations are managed through the administration interface.

Visualization Types

Dashboards support a range of visualization types:

  • Number — single metric display
  • Label — text-based display
  • Bar, Line, Pie, Doughnut — standard chart types
  • Bubble, Scatter — distribution and correlation charts
  • Table — tabular data display
  • Date Picker — interactive date filtering
  • TopoJSON Map — geographic data visualization

Parameterized Queries

Analytics queries support typed parameters (string, integer, float, boolean, date, time, datetime) that can be shared across visualizations within a dashboard. This allows dashboard-level filters to control multiple charts at once.

Access Control

Dashboards integrate with the platform's permission model, so you can control which groups have access to specific dashboards.

Script Triggers

Analytics events can trigger scripts for custom transformations and side effects. When events arrive at the analytics collector, configured script triggers fire automatically, letting you enrich data, trigger workflows, or propagate events to external systems in real time.

Privacy and ownership

  • You own your data—fully first-party
  • Choose what to collect and how long to keep it
  • Use alongside tools like Google Analytics without duplication

For developers

Related modules:

  • Analytics collector: backend/servers/analytics-collector
  • Analytics models: backend/framework/analytics-models
  • Analytics AI: backend/framework/analytics-ai
  • Core analytics: backend/framework/core-analytics

Related: