Microsoft Clarity Connection Guide

Connect to see real user behavior signals that Google Analytics can't measure.

Why connect Microsoft Clarity to ClickSentinel?

Microsoft Clarity is Microsoft's free behavior analytics tool, specialized in detecting 'frustration signals' like rage clicks, dead clicks, and quickbacks — things Google Analytics doesn't measure. ClickSentinel syncs these metrics to complement its own traffic quality scoring.

The connection uses a dedicated Data Export API Token (different from the embedded tracking code on your site), created by someone with admin rights on the Clarity project. Because Clarity's API is limited to 10 requests/project/day and only returns aggregated data for the last 1-3 days, ClickSentinel syncs once a day to stay under that limit.

Detects rage clicks and dead clicks — UI problems regular traffic numbers can't show
Clarity automatically separates bot sessions from real user sessions at the source
Directly complements ClickSentinel's built-in Heatmap feature

Key concepts

Rage Click & Dead Click

A Rage Click is rapid repeated clicking on the same spot (a sign of frustration); a Dead Click is a click on an element that does nothing (a sign of confusing UI).

Bot Sessions

Clarity automatically identifies and separates bot-generated sessions, excluding them from real user behavior metrics.

Scroll Depth

Average scroll depth (%) — shows whether users read the full content or leave the page early.

Data Export API limits

Clarity only allows 10 requests/project/day and returns aggregated data for at most the last 3 days — there is no per-session detail via the API.

How it works

1Sign in to clarity.microsoft.com and select the project (site) you want to connect.
2Go to Settings → Data Export → Generate new API token (requires project admin rights).
3Go to Clarity in ClickSentinel, pick a Site, enter the Project ID and API Token, then click Connect.
4The first connection uses the returned data as its initial snapshot; subsequent days sync automatically at 3:35 AM.

Frequently asked questions

Why does Clarity only sync once a day?

Because Clarity's Data Export API is limited to 10 requests/project/day. ClickSentinel proactively syncs once a day at 3:35 AM to stay under the limit while leaving room for other needs.

Can Clarity data be off by a day?

It can lag by about a day. Since the API returns aggregated data for the last 1-3 days rather than a specific day, ClickSentinel assigns it to "yesterday" when building the chart — the series becomes more accurate as it accumulates over several days.

How are rage/dead clicks different from the click fraud ClickSentinel detects?

These are two different concepts. Rage/dead clicks are UX signals showing a REAL user is struggling on the page; click fraud (bots, VPNs, duplicate clicks) is NOT-REAL traffic. Both matter, but need to be handled differently.

Do I still need to install Clarity's own tracking code on my site?

Yes — Clarity still needs its own embedded script running on your site to collect data (just like Google Analytics). The API Token in this guide is only used for ClickSentinel to READ reports, it doesn't replace that embed code.