Connect Microsoft Clarity
In the client’s workspace, open Sources, add Microsoft Clarity and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.
Analytics integration
Connect Microsoft Clarity with an API token and add behavior signals to web reporting.
What you can do with Microsoft Clarity in Maven
Maven supports Microsoft Clarity reporting through API token credentials for project-level behavior summaries and session quality signals. Use Clarity beside GA4, Search Console, and paid media sources to add qualitative context to acquisition and conversion reporting.
What you can measure
Maven keeps Microsoft Clarity numbers consistent across dashboards, reports, and answers so the team is not debating which spreadsheet is right.
Total monitored seconds in a down state across selected checks and dates
Total seconds without monitoring coverage across selected checks and dates
Monitored uptime seconds divided by uptime plus downtime seconds as a percentage
Total monitored seconds in an up state across selected checks and dates
Average provider-native accessibility score across represented page checks
Average provider-native best-practices score across represented page checks
Cumulative Layout Shift score.
First Contentful Paint in milliseconds.
Largest Contentful Paint in milliseconds.
Numeric value reported by the provider. Interpret with metric_name and stream.
Average provider-native web performance score across represented page checks
Average provider-native SEO score across represented page checks
Speed Index in milliseconds.
Total Blocking Time in milliseconds.
Average active (interacting) time per recorded session in seconds (Clarity EngagementTime activeTime), weighted by recorded sessions. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Average total time per recorded session in seconds (Clarity EngagementTime totalTime), weighted by recorded sessions. Differs from avg_session_duration_seconds (web analytics sessions). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Average uptime-check response time in milliseconds. Unweighted mean of the provider's daily average per check (Pingdom and compatible uptime monitors); not request-weighted.
Average percent of the page scrolled per recorded session (Clarity ScrollDepth averageScrollDepth), weighted by recorded sessions. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Share of recorded sessions with at least one of the clicks on page elements that produced no response (0-1): sessions with the signal (Clarity DeadClickCount sessionsCount x sessionsWithMetricPercentage) divided by sessions evaluated, re-weighted across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Occurrences of clicks on page elements that produced no response in recorded sessions (Clarity DeadClickCount subTotal). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Share of recorded sessions with at least one of the clicks followed by a JavaScript error (0-1): sessions with the signal (Clarity ErrorClickCount sessionsCount x sessionsWithMetricPercentage) divided by sessions evaluated, re-weighted across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Occurrences of clicks followed by a JavaScript error in recorded sessions (Clarity ErrorClickCount subTotal). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Share of recorded sessions with at least one of the scrolling through a page more than expected (0-1): sessions with the signal (Clarity ExcessiveScroll sessionsCount x sessionsWithMetricPercentage) divided by sessions evaluated, re-weighted across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Occurrences of scrolling through a page more than expected in recorded sessions (Clarity ExcessiveScroll subTotal). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Share of recorded sessions with at least one of the navigating to a page and quickly returning to the previous one (0-1): sessions with the signal (Clarity QuickbackClick sessionsCount x sessionsWithMetricPercentage) divided by sessions evaluated, re-weighted across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Occurrences of navigating to a page and quickly returning to the previous one in recorded sessions (Clarity QuickbackClick subTotal). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Share of recorded sessions with at least one of the rapid repeated clicks in one spot (0-1): sessions with the signal (Clarity RageClickCount sessionsCount x sessionsWithMetricPercentage) divided by sessions evaluated, re-weighted across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Occurrences of rapid repeated clicks in one spot in recorded sessions (Clarity RageClickCount subTotal). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Recorded sessions classified as bots (Clarity Traffic totalBotSessionCount). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Distinct users across recorded sessions (Clarity Traffic distinctUserCount). Non-additive: a sum over dates or dimension values over-counts returning users. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Sessions recorded by the session-recording tool (Clarity Traffic totalSessionCount, bot sessions included). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Share of recorded sessions with at least one of the JavaScript errors (0-1): sessions with the signal (Clarity ScriptErrorCount sessionsCount x sessionsWithMetricPercentage) divided by sessions evaluated, re-weighted across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Occurrences of JavaScript errors in recorded sessions (Clarity ScriptErrorCount subTotal). Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Average pages per recorded session: page views behind Clarity's pagesPerSessionPercentage divided by recorded sessions, so it re-weights across dates and dimension values. Session-recording measure from the behavior rows of obt_web_ops (Microsoft Clarity live insights), not GA4/web-analytics sessions. Daily snapshot of the trailing 24 hours before the sync; group by device_category, browser or country (device/browser/country call) or page_location (URL call) for the breakdown rows.
Connection and sync
You connect Microsoft Clarity with API token, account ID, account name and num days from the Microsoft Clarity account. Maven stores them encrypted. Each Microsoft Clarity sync takes a fresh copy of the current records, so the workspace always reflects what is in Microsoft Clarity now.
Microsoft Clarity project-total live-insights rows (one row per metricName information row).
Fields: account name, stream
Microsoft Clarity live-insights rows for session-summary dimensions.
Fields: account name, stream
Microsoft Clarity live-insights rows for URL/heatmap dimensions.
Fields: account name, stream
How it works
No SQL or warehouse setup. Connect the source, then build the client’s report by asking Claude or ChatGPT.
In the client’s workspace, open Sources, add Microsoft Clarity and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.
Maven pulls the client’s Microsoft Clarity data (1 objects) and models it into documented tables. No SQL, warehouse or pipeline setup.
Build the client’s report or deck by asking Claude or ChatGPT through the MCP, set alerts on what matters, and publish to the client’s portal once you approve it.
Works well with
FAQ
Maven exposes 34 governed Microsoft Clarity metrics, including Downtime Seconds, Unmonitored Seconds, Uptime Percentage, Uptime Seconds, Web Accessibility Score and Web Best Practices Score — each defined once so it means the same thing in every report.
You can break Microsoft Clarity metrics down by Signal Type, Account, Target, Strategy, Performance Score, Accessibility Score, Best Practices Score and Seo Score, and more.
Yes. Microsoft Clarity sits in the same client workspace as sources like Google Ads, Facebook Ads, Google Search Console, Shopify and HubSpot, so one report or question can use them together.
Maven syncs clarity behavior insights from Microsoft Clarity.
Maven refreshes Microsoft Clarity on a schedule after the source is connected, and shows each source’s last sync time in the client’s workspace, so you can check the data is current before a report goes out.
Yes. Maven encrypts integration credentials and tokens, scopes access to the workspace, and uses the connection only to sync the reporting data needed for governed analytics.
Set up your first client, build their report by asking Claude or ChatGPT, and publish it to their portal.
Nothing is charged unless you subscribe.