Compatibility

The Contentsquare Tracking Tag is designed to work on these web browsers:

The Contentsquare Tracking Tag is compatible with all JavaScript frameworks for single-page application, including Angular, React, Vue, Ember…

Due to limits on CSP management, there is a high chance of the Tracking Tag not being able to work. Restrictions on window functions preventing to use Tag commands.

The tag works on HTTP and HTTPS.

The Contentsquare Tracking Tag uses common web browser APIs and native JavaScript API. Overriding any of these APIs can prevent the Tag from functioning normally.

Contentsquare supports iFrames, including for Zoning and Session Replay.

1. Add the tag to the topmost window and inside each iframe down to and including the one(s) you want to track. Use the same Tag ID.

2. Your Contentsquare team enables the iFrameTracking tag setting to support iFrame tracking. When the flag is enabled, the tag inside the iFrames is not sending any natural pageview.

3. For Single Page Applications, trigger an artificial pageview inside the iFrame with a condition to execute only in this context to send a pageview.

   if (window.self !== window.top) {
     window._uxa = window._uxa || [];
     window._uxa.push(['trackPageview', 'PATH']);
   }

In version 12.0.0 and later, tracking of first and third-party iFrames in Session Replay is fully supported, and activated on demand by Contentsquare.

The tracking Tag has 2 separate events trackers, Shadow DOM support is not the same on both streams:

• Session Replay: full support. Each shadow element has a proper listener attached to it and the Tracking Tag doesn’t miss any event.
• Analytics: mouseover, mouseout, focusin, focusout, change events are not supported as shadow element children live outside the DOM tree. This is a “by design” limitation factoring in scalability constraints.

The Tag collects mouse events by attaching them to the canvas but there is no possibility to locate them within the canvas.

Contentsquare doesn’t provide tracking capabilities for AMP yet.

The Tracking tag doesn’t verify if data was received by the server before deleting it locally. All events would be deleted at request sending attempt.

The tag only reads except for the following:

• Adding a script into the head to call the library;
• Adding a property __contentsquare_identifier to every element (when the Session Replay is on);
• Overwriting the native function CSSStyleSheet.prototype.insertRule (when the Session Replay is on).