Guides
View as Markdown Open in ChatGPT Open in Claude

Analytics & Insights

Every deployed doc site tracks usage automatically — no snippet to install, no cookie banners needed (tracking is anonymous by default). Open your project in the dashboard → Analytics.

Traffic

  • Page views & unique visitors over time
  • Top pages — what people actually read
  • Navigation flow — how visitors move between pages
  • Bounce rate, time on page, device/browser/geo breakdowns
  • Referrers — where readers come from

Search Insights

  • Popular searches — what visitors look for most
  • Zero-result queries — searches that found nothing. This is your highest-signal backlog: people told you exactly what's missing.
  • Click-through — which results get clicked per query

AI Insights

The AI assistant is an always-on user interview:

  • Questions asked and answer confidence over time
  • Thumbs up/down feedback per answer, rolled up into a satisfaction rate
  • Confidence by topic — which areas of your docs the AI answers well (and which it doesn't)
  • Unresolved intents — questions the AI couldn't answer confidently, ranked by frequency. Each one is a page you should write.

Always Up to Date

The assistant's knowledge index rebuilds automatically on every deploy — new and changed pages are re-chunked and re-embedded as part of the build pipeline, so answers always reflect your latest published content. No manual step required. (A retrain endpoint exists to force a full rebuild if you ever need one.)

Content Health

A 0–100 score per page and for the whole site, based on:

  • Freshness — pages untouched for 90+ days are flagged stale
  • Feedback — pages with negative "was this helpful?" ratios
  • Broken links
  • Annotation coverage — % of your public API symbols that are documented (details)

Content owners are notified when their pages degrade — see Collaboration.

DX Funnel

For API-first products, Syntext tracks the developer journey: docs visit → API playground usage → first successful API call, including time-to-first-call — the metric that predicts activation.

Programmatic Access

Everything above is queryable via the Analytics API for custom reports and BI exports.

Tracking beacons return 202 and never block page rendering. Analytics collection respects the visitor's Do Not Track setting.
Was this page helpful?