Microsoft Clarity Overview
Microsoft Clarity is a free, AI-powered user behavior analytics tool. It helps website owners understand how visitors interact with their site through session recordings, heat maps, and AI-driven insights. Once connected to AgencyAnalytics, you can add Microsoft Clarity data to your Client dashboards and reports.
Uses Clarity API V1
The Clarity API only returns the previous day's data, so the data will always be 1 day behind
Before You Start
To connect to Microsoft Clarity without errors, you'll need the Microsoft Clarity API token for the relevant Client.
Connect Microsoft Clarity
You'll need to first grab an API token from Microsoft Clarity, then paste it into AgencyAnalytics.
Get the API Token from Microsoft Clarity
Step 1: Open the Microsoft Clarity native dashboard for the specific Client.
Step 2: Click Project Settings, then Setup, then Data Export.
Step 3: Copy the listed API Token.
Connect Microsoft Clarity in AgencyAnalytics
Step 1: Open the Client where you'd like to connect Microsoft Clarity.
Step 2: Click the Data tab in the top navigation bar.
Step 3: Click + Connect Source in the upper-right corner.
Step 4: Search for Microsoft Clarity in the search bar at the top, then click the Microsoft Clarity card.
Step 5: Paste in the API token, then click Save.
Once connected, you can add Microsoft Clarity data to your Client dashboards and reports.
Note: Data values may differ from the Microsoft Clarity dashboard due to differences in how bots are filtered by the API.
FAQ
Why can't I see any historical data for Microsoft Clarity?
The Microsoft Clarity API has a 24-hour look-back period, so it only provides yesterday's data. AgencyAnalytics warehouses this data for you, so each day the available historical data increases by 24 hours.
Example:
Jaime connects Microsoft Clarity to a Client at 9 am on June 1st
They review the data in AgencyAnalytics. Data from the day before, May 31st, is available
Jaime checks back on June 8th. They find complete data from May 31st through June 7th available
Why am I getting a usage-limit error when I try to view data?
Microsoft Clarity has a hard-coded rate limit of 10 requests per day, per project. If you're seeing a usage-limit error, it means you've exceeded the 10 requests for the day and must wait for the limit to reset.
Note: Refreshing data from all three dimensions (OS / Source / Channel) will consume 3 of the 10 available daily requests.
đŹ Need additional help?
If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help đ
