TrueMetriks documentation: Microsoft Clarity https://docs.truemetriks.com/session-replay/clarity/ Generated from the TrueMetriks documentation. Paste the whole of this file into ChatGPT, Claude, Gemini, Cursor or any other AI. I use TrueMetriks, a server-side tracking and conversion attribution platform. It tracks my website visitors, ties every sale back to the ad that produced it, and sends those conversions back to my ad platforms. Help me with this specific task: Microsoft Clarity. Add free Microsoft Clarity session replay from TrueMetriks by pasting one Project ID, no code, and tag every recording with the event name to filter by outcome. HOW TO GUIDE ME - This file has three parts: THE GUIDE is today's task, BACKGROUND is a prerequisite to confirm with me before you start THE GUIDE, not optional reading, and LINK MAP is the only place a real link comes from. - Ask me ONE thing at a time and wait for my answer before moving on. - At the start of every step, ask me: "do you want the written steps, or the video?" If I pick the video, give me the exact link from the LINK MAP at the bottom and wait until I tell you I have watched it. If I pick the written steps, give them to me from this file. - Only ever give me links that appear in the LINK MAP below. Never invent a URL, never guess an anchor, and if I ask for something that has no link here, say so and point me at https://docs.truemetriks.com/ instead. - Never ask me for my password, my API key, my MCP key, or any card details. You are reading me the steps; I am the one clicking in my own account. - Confirm each step worked before starting the next one. - Keep it short. I am doing this while looking at my screen, not reading an essay. - Everything you need is in this file. You do not need to browse the web. =============================================================================== THE GUIDE: Microsoft Clarity https://docs.truemetriks.com/session-replay/clarity/ =============================================================================== ## What you need A Microsoft Clarity account with a project for this website. Clarity is free at [clarity.microsoft.com](https://clarity.microsoft.com) - sign in with a Microsoft, Google, or Facebook account and create a project that points at your site's URL. Each project has a short **Project ID**, which is the only thing you paste into TrueMetriks. ## Connect Microsoft Clarity to TrueMetriks ### Step 1 - Open Settings In TrueMetriks, pick the site you want from the selector at the top of the left sidebar, then click **Settings** at the bottom of the sidebar. ### Step 2 - Open the Microsoft Clarity tile Click the **Integrations** tab, then click the **Microsoft Clarity** tile. ### Step 3 - Copy your Clarity Project ID In Clarity at clarity.microsoft.com, open your project and go to its **Settings**. The **Project ID** sits at the top of the **Overview** - click the copy icon next to it. It is a short string like `qz8mn4k2p`. The Project ID is also the trailing part of your Clarity tag URL: in **Settings -> Setup** the install snippet loads `https://www.clarity.ms/tag/` - the bit after `/tag/` is the same ID. ### Step 4 - Paste the ID and save Back in TrueMetriks, paste the ID into **Clarity Project ID**, leave **Tag Clarity sessions with TrueMetriks event names** ticked, and click **Save**. The tile now reads **Configured**. Clarity starts loading on every page on the next visit, and recordings appear in your Clarity dashboard within a few minutes. ## Tag Clarity sessions with TrueMetriks event names This is the checkbox under the Project ID. Leave it on (the default) and each recording is labelled with the TrueMetriks event that fired, so in Clarity you can **filter recordings by that tag** and jump straight to, say, every session that ended in a Purchase. The tag uses the same event names you see on the [Events page](https://docs.truemetriks.com/dashboard/events/) and the standard conversion events from your [Facebook](https://docs.truemetriks.com/ad-integrations/facebook/) and other integrations. ## Load more than one project A single site can feed more than one Clarity project. Click **+ Add project**, paste another Project ID, and Save - TrueMetriks loads every project you list on each page, and each keeps its own **Tag sessions** toggle. This is useful when two teams keep separate Clarity workspaces, or when you are migrating from an old project to a new one and want both recording for a while. To remove a project, clear its ID (or use the trash icon when more than one row is shown) and Save. ## Where your recordings show up Recordings and heatmaps live in **Clarity**, not in TrueMetriks. Open clarity.microsoft.com, pick this project, and you will see the session list, recordings, and heatmaps there. ## If sessions are not showing up - **Give it a few minutes.** Clarity batches recordings; the first sessions can take a little while to appear after you save the Project ID. - **Confirm the TrueMetriks tracker is live on the page.** Clarity rides your TrueMetriks tracker, so if a page is not sending visits to TrueMetriks it will not load Clarity either. Check that the page shows up in your TrueMetriks [visits](https://docs.truemetriks.com/dashboard/sessions/) first, and see the [install guide](https://docs.truemetriks.com/getting-started/install-first-tracker/) if it does not. - **Check the Project ID.** It is the short string after `/tag/` in the Clarity snippet - no spaces, no full URL. Re-copy it from Clarity's Overview and Save again. - **Confirm the project is for this site** in Clarity (the Website URL on the Overview screen should match), or recordings will land in the wrong project. =============================================================================== LINK MAP Use these exact URLs. Anything ending in a # anchor opens on that section or that video. Nothing else is a valid link. Never invent a URL and never guess an anchor. Microsoft Clarity The guide ................................... https://docs.truemetriks.com/session-replay/clarity/ What you need ............................... https://docs.truemetriks.com/session-replay/clarity/#what-you-need Connect Microsoft Clarity to TrueMetriks .... https://docs.truemetriks.com/session-replay/clarity/#connect-microsoft-clarity-to-truemetriks Step 1 - Open Settings ...................... https://docs.truemetriks.com/session-replay/clarity/#step-1-open-settings Step 2 - Open the Microsoft Clarity tile .... https://docs.truemetriks.com/session-replay/clarity/#step-2-open-the-microsoft-clarity-tile Step 3 - Copy your Clarity Project ID ....... https://docs.truemetriks.com/session-replay/clarity/#step-3-copy-your-clarity-project-id Step 4 - Paste the ID and save .............. https://docs.truemetriks.com/session-replay/clarity/#step-4-paste-the-id-and-save Tag Clarity sessions with TrueMetriks event names https://docs.truemetriks.com/session-replay/clarity/#tag-clarity-sessions-with-truemetriks-event-names Load more than one project .................. https://docs.truemetriks.com/session-replay/clarity/#load-more-than-one-project Where your recordings show up ............... https://docs.truemetriks.com/session-replay/clarity/#where-your-recordings-show-up If sessions are not showing up .............. https://docs.truemetriks.com/session-replay/clarity/#if-sessions-are-not-showing-up