Analytics Overview

Overview of the Asiyst analytics engine, real-time telemetry processing, conversion tracking, and dashboard reporting.

Overview

The Asiyst Analytics Engine provides real-time visibility into how visitors engage with your interactive avatar, discover documentation, ask questions, and convert through guided product tours. Telemetry is collected with zero client lag (< 2KB payload), processed across global edge workers, and rendered in interactive dashboard charts.

Telemetry Architecture & Data Pipeline

[Browser SDK] ──(Beacon API / WS)──▶ [Edge Ingestion Gateway]
                                                │
                                                ▼
[Dashboard & Exports] ◀── [Aggregated Views] ◀── [Time-Series Analytics Store]

Client Collection: The Web SDK collects non-blocking interaction events (impressions, clicks, messages, guidance completions) using navigator.sendBeacon on page unload.

Edge Ingestion: Events are validated, deduplicated, and enriched with geographic region and device category.

Real-Time Aggregation: Metrics are rolled up into 1-minute, 1-hour, and 1-day time series buckets for instant dashboard querying.

Data Exports: Historical logs can be exported via CSV, queried via REST API, or streamed into BigQuery, Snowflake, and PostHog.

Core Metric Categories

Category	Tracked Metrics	Primary Use Case
Visitors & Reach	Unique visitors, returning visitors, device breakdown	Measure total addressable audience on website
Avatar Engagement	Viewport impressions, click-through rate (CTR), greeting accepts	Evaluate avatar visibility and attractiveness
Conversational Quality	Total conversations, turns per session, resolution rate, CSAT	Monitor assistant accuracy and visitor satisfaction
Performance & Latency	Time to First Token (TTFT), median response time, error rate	Maintain high-speed SLA guarantees
Guidance & Outcomes	Step completions, goal achievements, assisted conversions	Measure tangible ROI and sales impact

Privacy-First Tracking Guarantees

Asiyst enforces strict compliance with global privacy regulations (GDPR, CCPA, ePrivacy Directive):

Zero Third-Party Cookies: Telemetry uses first-party ephemeral session tokens stored in sessionStorage.

IP Masking: Client IP addresses are truncated at edge ingestion and never persisted to database records.

Opt-Out Compliance: The SDK respects the navigator.doNotTrack header and custom cookie consent managers (OneTrust, Cookiebot).

Accessing Analytics Data

Asiyst Dashboard: Navigate to Project > Analytics to view interactive heatmaps, retention graphs, and top conversation topics.

REST API: Query raw and aggregated data programmatically via GET /api/v1/projects/:id/analytics.

Webhook Streams: Receive real-time event notifications on your backend server.