Microsoft Clarity Overview
Microsoft Clarity is a free, AI-powered user behavior analytics tool that helps website owners understand how visitors interact with their site through features like session recordings, heat-maps, and AI-driven insights.
Data Details
Uses Clarity API V1
Clarity API only returns the previous days data (1 day of data available at connection)
Historical depth of Microsoft Clarity data is built up over time in AgencyAnalytics as the warehouse accumulates daily snapshots.
🔌 Connect Microsoft Clarity
To avoid an error when connecting Microsoft Clarity to a Client, the person connecting must have:
Microsoft Clarity API Token for the relevant Client
In Microsoft Clarity:
Open the Microsoft Clarity native dashboard for the specific Client.
Click Project Settings → Setup → Data Export.
Copy the listed API Token.
With the API Token copied, do the following in AgencyAnalytics:
Open the Client where you'd like to connect Microsoft Clarity.
Click Data Sources in the top navigation bar.
Click Connect Data Source in the upper right corner.
Search for Microsoft Clarity in the search bar at the top, then click the Microsoft Clarity card.
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.
❓ Why can't I see any historical data for Microsoft Clarity?
The Microsoft Clarity API only has a 24 hour look back period, which means it only provides yesterdays data via their API. We warehouse this data for you, so each day the available historical data will increase by 24 hours.
Example:
Jaime connects Microsoft Clarity to a Client at 9am 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 - 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 that 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 😄