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 applications, including Angular, React, Vue, Ember…

Partytown ↗ is a generic all-purpose proxy that helps relocate resource intensive scripts into a web worker, and off of the main thread.

The Tracking Tag is incompatible with Partytown. It relies on DOM mutations, querying, observations, and global variables — features that do not function properly when the Tag is loaded using Partytown.

Due to several constraints imposed by those frameworks, we don’t currently support both Salesforce Lightning Aura and Lightning Web Runtime, or any Lightning Web Components. The impact depends on your implementation; it can affect subsets of some pages or your full website, depending on how many Aura or Lightning Web Components you use.

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 two separate event trackers: Session Replay and Analytics.
Both provide full support for custom elements ↗ and the shadow DOM ↗.

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 Session Replay is on);
• Overwriting the native function CSSStyleSheet.prototype.insertRule (when Session Replay is on).