User Guide

Dashboard & Analytics

The FAQSIR dashboard provides real-time analytics on how users interact with your widget. Track page views, FAQ engagement, chat usage, and video plays — all from a single interface.

Plan requirement

The Engagement Dashboard is available on the Pro plan. Starter and Plus plan users will see a prompt to upgrade when visiting the dashboard. Plus plan users have access to Basic Usage Metrics. See Plans & Pricing for a full feature comparison.

Overview

The dashboard is your central hub for understanding widget engagement. It is accessible from the FAQSIR admin panel and provides at-a-glance metrics alongside detailed breakdowns. All data is sourced from events sent by the widget via the Stats endpoint.

Dashboard Widgets

Stats Overview

The stats overview section displays key metrics for the selected time period:

  • Total page views — How many times pages with the widget were loaded
  • FAQ interactions — Number of FAQ accordion opens and closes
  • Chat messages — Total messages sent through the chat feature
  • Video plays — Number of video summary plays

These metrics update based on the date range and granularity filters you select.

Top FAQs Table

A ranked table showing the most frequently opened FAQ questions across all your sources. This helps you understand which questions your audience finds most relevant, and can inform your content strategy.

Usage Trend Chart (Pro)

Available on the Pro plan. This chart plots engagement metrics over time, allowing you to identify trends, seasonal patterns, and the impact of content changes. You can toggle between different metric types to focus on the data that matters most.

Audience Split Chart (Pro)

Available on the Pro plan. Shows the breakdown of your audience by device type (desktop, mobile, tablet) and geographic location (by country). This helps you understand where and how your audience consumes your content.

Top Pages Table (Pro)

Available on the Pro plan. Ranks your pages by engagement volume, showing which articles generate the most widget interactions. Use this to identify your highest-performing content.

Date Range Filters

The dashboard supports flexible date range filtering:

Preset Description
Last 7 days The most recent week of data
Last 30 days The most recent month of data
Last 90 days The most recent quarter of data
Custom range Select specific start and end dates

Granularity

You can control the data granularity for trend charts:

Option Description
Auto Automatically selects the best granularity based on the date range
Hourly Shows data points for each hour (best for short ranges)
Daily Shows data points for each day (best for longer ranges)

Data Pipeline

Understanding how your analytics data flows helps you interpret the dashboard accurately:

  1. Event collection — The widget sends batched events to the Stats endpoint as users interact with your content.
  2. Enrichment — The API adds server-side dimensions (country, device type) to each event.
  3. Raw storage — Individual events are stored for up to 90 days.
  4. Aggregation — Events are rolled up into hourly and daily summaries for efficient querying.
  5. Dashboard display — The dashboard queries aggregated data to render charts and tables.

Data freshness

Dashboard data typically reflects events within the last 1–2 hours. Hourly aggregation runs on a regular schedule with a 2-hour lookback window to ensure recent events are captured.

Usage Monitoring

The dashboard also shows your current plan usage alongside your analytics data. Look for the usage indicators in the Billing section to track your source quota and video credit consumption:

  • Normal (neutral) — Usage is within plan allowance
  • Warning (amber) — More than 80% of quota consumed
  • Critical (red) — Quota reached or exceeded

Next Steps

Plans & Pricing

See which analytics features are included in each plan.

Stats Endpoint

Technical reference for the analytics event API.

Billing

Monitor your usage quotas and manage your subscription.

Sources & Content

Understand how sources generate the content your audience engages with.

Previous
Knowledge Base