This article outlines steps you can take to check your Contentsquare tag installation.
- How to verify the tag installation from inside the Contentsquare app
- How to verify the tag installation using the Contentsquare Tracking Setup Assistant browser extension
- How to verify the tag installation using your browser developer tools
- FAQ for tag verification issues
How to verify the tag installation from inside the Contentsquare app
1. Go to your Sites page.
2. Click 'Install tracking code' or 'Verify tracking code' for the relevant Site.
3. Click 'Verify installation'.
This button will open a browser window and display a message telling you if the tag is installed correctly.
How to verify the tag installation using your browser developer tools
Manually checking to see if the tag is loading on your site is the most reliable method of verification.
1. Open your browser’s developer tools and click on the 'Network' tab.
- To do this in Chrome, on the menu bar, click 'View' > 'Developer' > 'Developer Tools'
- To do this in 'Firefox', on the menu bar, click 'Tools' > 'Browser Tools' > 'Web Developer Tools'
With the Developer Tools open, select the 'Network' tab.
2. Type csq in the filter search field.
3. Visit your website, then refresh the page and wait for it to finish loading.
After following the steps above, check the 'Network' tab for the following:
-
You see multiple requests, but only one csq- script appears among the requests (e.g. csq-1234567.js)
It looks like your tag is correctly installed. If you see any of these requests appear in 'red', that could point to an error with the script or something is blocking the tag from loading, such as a browser extension.
-
You see requests and more than one csq- script appearing
If you see more than one csq- script in the Network tab, this means that more than one tag is installed on your website. This will cause issues with tracking. To fix this, you must remove all Contentsquare tags and re-install only the correct one.
-
You do not see any requests
If you don't see any requests, this means that the Contentsquare tag was not successfully installed. To fix this, follow the instructions in our article, How do I install the Contentsquare tag?
FAQ for Contentsquare tag verification issues
Why am I seeing "Tracking code not found"?
There are 3 common reasons why the verification is not working properly:
-
The tag hasn't yet been added to your website or is being blocked by a browser extension
Double-check that the Contentsquare tag has indeed been added to your site. Ensure any browser extensions that block network requests (e.g. ad blockers) are turned off during the verification process.
-
The tag was added incorrectly
To find out if the Contentsquare tag was added to your site properly, follow the steps above for verifying the tag installation using developer tools.
If you're not seeing any requests in developer tools, the tag has not been added properly. Try adding the tag once again. We also suggest avoiding pasting the tag code in word processors and other text editing programs before pasting the Contentsquare tag on your site as these programs tend to automatically alter the content of the tag for styling.
-
No traffic to your site
Contentsquare verifies tracking as being active if it detects at least one visit in the past hour. If your site hasn’t had any visitors within the past hour(s), this could be due to low traffic to your site or perhaps that the tag isn’t installed.
If you didn't block your IP in your Contentsquare account and you don't have Do Not Track enabled in your browser, you can browse the pages of your site to trigger the activation. Once you do that, refresh Contentsquare after 2-3 minutes to see if you’ve triggered the activation.
If it’s still not working, follow the steps above for verifying the tag installation using developer tools to make sure that your tag is installed on your site.
-
The tag from a different site has been added
It's possible that the incorrect tag has been added to your site. You can find the tag for your site on your Sites page by clicking 'View tracking code' next to the site URL.
Compare the tag, specifically the csq- number, that’s present on your website to the tag you’ve just copied. If the csq- number is different, then you can confirm that the wrong tag has been added. Remove the tag that is present on your site by retracing your installation steps, then add the correct tag on your website.
-
The tag was accidentally removed during an update to your site
Sometimes during website changes, the tag can be accidentally removed. Check whether the tag is still present on your site by following the steps for verifying the tag installation using developer tools.
If the verification fails, you can re-add the tag to your site by following one of our installation guide.
-
Contentsquare is tracking some pages, but not all
To check if the Contentsquare tag is installed on a specific page, follow the steps for verifying the tag installation using developer tools. If you're not seeing any requests to Contentsquare in the developer tools, the tag is not installed. To install the tag, you can use our installation guide.
If you have confirmed that the Contentsquare tag is installed correctly, but you still aren't collecting data, it could be that Contentsquare is being blocked due to a Content Security Policy (CSP) on your site.
You can use the Contentsquare Tracking Setup Assistant extension to check for CSP issues. Alternatively, follow the steps below to see if a CSP related error is the cause of the problem:
1. Open your browser’s Developer Tools on the Console tab.
- To do this in Chrome, on the menu bar click View > Developer > JavaScript Console
- To do this in Firefox, on the menu bar click Tools > Browser Tools > Browser Console
2. Visit your website, then refresh the page and wait for it to finish loading.
3. Check for any errors on the Console tab that mention a Content Security Policy.
To fix this issue, you'll need to adjust your CSP settings using the configuration given in our Content Security Policy documentation.