The Contentsquare Tracking setup assistant is a Chrome extension that helps you quickly check the configuration of the main tracking tag and monitor all the page views, transactions, and custom variables sent to Contentsquare’s servers.
Get started
You can install the extension directly from the Chrome Web Store using any Chromium-based browser (e.g. Google Chrome, Microsoft Edge, Opera, Brave, Arc, etc.).
How to test your implementation
If you are just setting up your Contentsquare project, follow the instructions here to test your project's Main tracking tag implementation.
How to use the Tracking setup assistant
Use the Tracking setup assistant to confirm the Main tracking tag is loaded.
- Go to the page on your site you want to confirm and open the Tracking setup assistant extension
- The tag is loaded if you see the checkmark and it says 'Main tag loaded' and check to make sure your 'Custom variables', 'Page events', and 'Dynamic variables' are configured correctly.
If the tag is not loaded the Tracking setup assistant will look like this:
Troubleshooting capabilities
Click the vertical '...' view more options menu to use the following troubleshooting capabilities:
Zone path tracker
Allows you to click on any web page element, then press 'A' on your keyboard and it will automatically display that elements zone path at the bottom of the page.
- Use this to view the exact path the tag uses to troubleshoot Zoning accuracy issues.
Delete all CS Cookies
Will delete the following cookies from the main window the user is currently on:"_cs_s", "_cs_id", "_cs_v", "_cs_ex", "_cs_c".
- Delete cookies to help troubleshoot when your Session replays are not working as expected.
Validate CSP
If your page already has our custom code the tracking assistant will automatically check your Content Security Policy (CSP) failures. If you see a 'CSP Error' in your Tracking Setup Assistant use the 'Validate CSP' option to learn more.
Turn off anonymization
Will trigger the following API command:
window._uxa = window._uxa || [];
window._uxa.push(["trackConsentGranted"]);
- Use this to test to make sure personal data is not exposed.
Trigger testing dvar
Will trigger the following API command:
window._uxa = window._uxa || [];
window._uxa.push(["trackDynamicVariable", {key: "SR Testing", value: "True"} ]);
- Use this to test and debug issues with your dynamic variables and session replay.
Sessions tracked drop-down menu
Allows you to adjust your collection settings to a specific mode to include or exclude your browser from tracking:
- Use this to help with debugging and pinpointing a tag issue by excluding.
‘Session not tracked’ - does not track
‘Session Tracked’ - tracked for Zoning but not Session Replay
‘Collected for Session Replay’ - tracked fully including Session Replay
How to use the Tracking setup assistant to create a mapping
- Click ‘Custom Variables’ to identify page name, section, and levels.
- Use these attributes to build pages in your Mappings.
Why isn’t my Tracking setup assistant working?
There are a few reasons your Tracking setup assistant might not work:
- Sampling applied to your Contentsquare project might have an adblocker
- Changes have been made to the native functions of your site that affect the Tracking setup assistant’s functionality
What if I see notification badges on my Tracking setup assistant?
You can ignore the badges and continue to use the Tracking setup assistant. This is a known issue related to the browser not removing requests sent after navigation to another tab. It does not affect the extension's functionality.
How can I check the CS Tag without using the Contentsquare Tracking Setup Assistant chrome extension?
To make sure your CS Tag is firing without the extension you can use your browser's Developer Tools:
-
Open the developer console (Option + ⌘ + I (on macOS), or Shift + CTRL + J (on Windows/Linux).
-
Open the Network tab and filter for “contentsquare”.
-
Check if you get the files, as shown below (they must be in the correct order):
A. https://t.contentsquare.net/uxa/{TAG ID}.js
B.https://c.contentsquare.net/pageview
C.https://c.contentsquare.net/events
D.https://c.contentsquare.net/transaction