Microsoft Clarity
What real visitors do on each page, joined to the crawl: Neova reads your Microsoft Clarity project and turns dead clicks, rage clicks, quick backs and AI citations into flags, columns and ticket priorities.
Clarity records how people use the site: where they click, how far they scroll, when they leave. A crawl sees what the server sends; Clarity sees what visitors do with it. With both, Neova can say which problems real people meet, and which pages to fix first.
What It Adds
- 11 checks in a category of their own, Visitor Behavior, in the sidebar with its own page.
- Priorities: a ticket whose pages have real visits, or are cited in AI answers, moves up one level, and says why. All Flags sorts by visits.
- Columns: Visits (Clarity) and Friction in All URLs; Scroll Depth, Engagement Time, AI Citations and AI Bot Requests in Columns; the same numbers in each page’s Details.
- Dashboard: Visitor Friction (visits, friction per 100 sessions, the pages that struggle most, sessions per day) and Pages Cited in AI Answers.
- Rage clicksvisitors click the same spot again and again
- Dead clicksvisitors click something that does nothing
- Quick backsvisitors leave the page right away
- Excessive scrollingvisitors scroll up and down looking for something
- JavaScript errorsscripts fail in visitors’ browsers
- Low scroll depthvisitors see less than a quarter of the page
- Visited, never crawledpeople reach a page that no link leads to
- Visited, brokenpeople land on a page that answers an error
- Cited in AI answers, brokena page AI assistants cite is broken, redirected or not indexable
- AI bots on dead URLsAI crawlers keep requesting addresses that answer an error
- Friction on phonesphones fare at least twice as badly as desktops
A page is judged on its friction only from 30 sessions in the last 28 days: a handful of visits is not a flag. Friction is the dead clicks, rage clicks and quick backs per 100 of the page’s sessions.
Connect a Project
- In Microsoft Clarity, open the project of the site. Only a project admin can make a token.
- Open Settings, then Data Export, then Generate new API token.
- Name it, for example
Neova(4 to 32 letters, digits, hyphens, underscores or periods, no spaces), and copy the token. - In Neova: Settings, Connections, Microsoft Clarity, Connect…, paste the token, Save.
Neova checks the token with one request, finds the site from the pages in the answer, and keeps those first 3 days. One token per Clarity project: Add a Project… for each other site. The token stays in your computer’s keychain. If someone with access leaves the project, Microsoft advises making a new token.
How Neova Reads It
Microsoft’s Data Export API has tight limits, so Neova keeps the history itself:
- Once a day, while Neova’s scheduler runs, each connected project’s day is read and kept on your computer. A crawl reads Clarity itself only when that day is not kept yet.
- Each crawl uses the last 28 days: visits summed, scroll depth and engagement time weighted by visits. A new connection starts with 3 days and grows a day a day.
- Only numbers per page are read: no recordings, no single visit, nothing that names a visitor.
- Test Connection sends no request: it says what is kept, so the 10 a day stay for the daily read.
AI Visibility
Clarity’s AI Visibility shows which pages AI assistants cite in their answers and which URLs AI bots request. Neova reads both with the same token, for the last 28 days, and joins them to the crawl: a cited page that is broken or redirected, AI bots spending their visits on errors. Two settings in Clarity come first:
- Citations need the site’s domain verified in Clarity’s AI Visibility.
- Bot activity needs a CDN connected in Clarity’s AI Visibility settings (Clarity lists Azure, Akamai, Fastly, Cloudflare, CloudFront and WordPress).
Without them, the two checks say what is missing; the other nine run.
No Token? Import a File
If your company’s rules keep Neova from connecting, import Clarity’s data instead: Settings, Connections, Search Console, Analytics, Bing and Clarity by File. What Neova reads, step by step.
Clarity’s limits and steps from Microsoft’s Data Export API page, read November 19, 2026. Microsoft and Clarity are trademarks of Microsoft; Neova Labs is not affiliated with, endorsed by or sponsored by Microsoft. NEOVA™ is a trademark of Neova LLC.