Getting Started with GA Integration
Note
To Start using Clarity, you must finish the Setup process.
Integrating your Clarity project with Google Analytics (GA) allows Clarity to link session playbacks with your Google Analytics dashboard. Once you identify the sessions you need more information on, jump to GA Dashboard to debug and understand user pain points.
How does Clarity integration work?
Clarity will create a custom dimension called the 'Clarity Playback URL'. Data will start flowing into Google Analytics from the Clarity JavaScript you've added to your site without any more changes.
Note
Not all sessions will have a playback URL. Clarity saves your users' bandwidth by only uploading full-fidelity playbacks for a subset of page views.
Here are the steps to integrate Google Analytics into Clarity.
Installation
Note
You can only add one web property to integrate with Clarity at this point.
Step 1
Choose a project and navigate to the Settings tab.
Go to Setup and select Get Started under Google Analytics integration.
Step 2
You'll be redirected to Google to sign in. Choose an account or enter an email by selecting 'Use another account' and follow the steps.
Sign up for Google Analytics if you haven't already signed up.
Step 3
On the dialog box, select the web property you would like Clarity to send data.
If you see the site in the 'Site to connect' menu
Select the site from the menu and select Save. You'll be redirected to the Clarity Setup page.
If you don't see the site in the 'Site to connect' menu
Select the option to enter your site manually.
Manual setup
You would need to enter the site's details on What do you want to connect to? dialog box. The IDS differ based on Universal Analytics (UA) or Google Analytics 4 (GA4).
How to differentiate between UA and GA4?
Go to your Google Analytics account, select Admin from the left panel. In the Property column, select Property Settings. Your "UA-" ID appears at the top of the Property Settings page. If you don't see a Tracking ID, then you have a GA4 property.
Learn more about UA and GA4 and their comparing metrics.
Use the following to find out the different IDs while manually connecting:
Once you connect manually, select Continue, and you'll be redirected to the Clarity Setup page.
Deactivating the Integration
Go to Settings -> Setup -> Google Analytics integration.
Toggle the Active button if you wish to disable the GA integration temporarily.
Disconnect Google Analytics Integration
Important
Once you disconnect your project, it's removed from your Google Analytics account. You need to redo the installation process to use Clarity.
Step 1
Choose a project and navigate to the Settings tab.
Go to Setup and select Disconnect under Google Analytics integration.
Step 2
Confirm Disconnect on the pop-up window.
FAQ
For more answers, refer to Google Analytics FAQ.