Developer docs

Engagement Quality

A session-level dimension that answers one question: how much genuine attention did this visit show? Here is the full logic behind High, Medium, Low — and Unknown.

v3.0Updated May 2026

What it measures

Engagement Quality condenses everything a session did into a single score from 0 to 100, then buckets that score into high, medium, or low. It is designed to separate visits that genuinely engaged with your site from visits that only touched it — a distinction raw pageview counts cannot make.

The score updates live while the session runs: every new pageview and interaction can move it, so the final value reflects the whole visit.

The values

high

Score 70 or above. Sustained, meaningful activity: several pages, real interactions, longer active time — and often a conversion.

medium

Score 35–69. Real but moderate activity — the visitor browsed and interacted, but didn't go deep. Typical for shorter research visits.

low

Score below 35. Little meaningful activity: one or two pages, seconds of attention, no real interaction — or visible frustration signals.

unknown

The session produced no usable activity signals at all — no pageview, no interaction, no measurable time. Deliberately not guessed.

What raises the score

Four groups of positive signals feed the score. Each group is capped, so no single behavior can dominate the result:

  • Active time. The strongest baseline signal. Thresholds step up from roughly 15 seconds to over 3 minutes of active engagement — idle tabs don't count.
  • Breadth and depth. How many pages the session viewed and how deep the navigation went. Five or more pages with real depth is a strong signal.
  • Meaningful interactions. Clicks and interactions on real page elements. A handful of meaningful interactions counts for more than any amount of passive browsing.
  • Conversions. The largest single boost. A purchase, completed signup, demo request, or submitted form lifts the score substantially — weighted by what that conversion means for your business type.

What lowers the score

Negative signals subtract from the score. They are the reason a technically active session can still land in low:

  • Immediate bounce. A single page, only seconds of attention, no meaningful interaction — the strongest penalty.
  • Frustration signals. Rage clicks (rapid clicking on the same spot) and repeated dead clicks (clicks that trigger nothing).
  • Errors. Script errors during the session — and especially form or checkout errors — pull the score down.

Good to know

  • Business-type aware. Conversion signals are weighted by your detected business model: a completed trial signup counts for more on a SaaS product, a submitted lead form counts for more on a B2B site.
  • Conversions stick. A session that converted and was graded high keeps that grade — later idle time can't demote it.
  • Overrides win. You can manually override any session's engagement quality; the engine never overwrites a manual value. See AI Derived Dimensions for the shared mechanics.