Compatibilité

Navigateurs

Les navigateurs suivants sont compatibles avec l’utilisation du tracking Tag Contentsquare :

Navigateur	Version	Problème/Avertissement
Chrome	Dernière version
Chrome for Android	Dernière version
Android Browser	Dernière version
Firefox	Dernière version
Safari	Dernière version	Le Tracking Tag utilise l’API Beacon pour envoyer des données lorsque l’utilisateur quitte la page (chargement, fermeture d’onglets, fermeture de navigateur). Cette fonctionnalité est supportée sur OSX 12.1 et plus. ITP 2.1 supprime tous les cookies JavaScript 7 jours après la dernière visite sur un site.
iOS Safari	Dernière version	Le Tracking Tag utilise l’API Beacon pour envoyer des données lorsque l’utilisateur quitte la page (chargement, fermeture d’onglets, fermeture de navigateur). Cette fonctionnalité est supportée sur OSX 12.1 et plus. ITP 2.1 supprime tous les cookies JavaScript 7 jours après la dernière visite sur un site.
Microsoft Edge	Dernière version
Internet Explorer	11	Le Tracking Tag utilise l’API Beacon pour envoyer des données lorsque l’utilisateur quitte la page (chargement, fermeture d’onglets, fermeture de navigateur). Cette fonctionnalité n’est pas supportée sur ce navigateur. Les anciennes versions d’Internet Explorer ne sont pas supportées.
Opera	Dernière version
In-app browsers et WebViews	-	Le tracking fonctionne tant que l’application ne bloque pas les APIs du navigateur, et n’empêche ou ne supprime les cookies, ni le local storage. Le comportement du Tracking Tag a été validé (pageviews et tracking d’événements, enregistrement de session) sur les navigateurs in-app suivants, sur iOS et Android : Facebook, Facebook Messenger, Twitter, Instagram, Linkedin, Slack, Snapchat, Pinterest, Wechat

Frameworks

Le tracking Tag est compatible avec l’ensemble des frameworks JS pour des applications web monopage (ou SPA, single-page application) dont Angular, React, Vue, Ember, etc.

Salesforce APEX Lightning (non supporté)

À cause des limites de gestion des CSP, il est probable que le Tracking Tag ne fonctionne pas. Des restrictions sur les fonctions window empêchent l’utilisation des commandes du Tag.

Protocoles

Le tag fonctionne sur HTTP et HTTPS.

Sites surchargeant les fonctions natives JavaScript et les APIs navigateurs (non supporté)

Le Tracking Tag Contentsquare utilise les APIs Web standards et l’API JavaScript native. Toute surcharge de ces APIs peut empêcher le bon fonctionnement du Tag.

Iframes

Contentsquare supporte les iFrames, y compris pour le Zoning et le Session Replay.

Implementation

Ajoutez le tag à la fenêtre la plus haute et dans chaque iframe jusqu’à celle que vous trackez. Utilisez le même tag ID.
Votre équipe Contentsquare active l’option du tag iFrameTracking pour supporter le tracking des iFrames. Lorsque l’option est activé, le tag dans les iFrames n’envoie aucun pageview naturel.
Pour les Single Page Applications, déclenchez un pageview artificiel dans l’iFrame avec une condition pour limiter le déclenchement à l’iFrame.
```
if (window.self !== window.top) {
  window._uxa = window._uxa || [];
  window._uxa.push(['trackPageview', 'PATH']);
}
```

Session Replay et iframes

Dans les versions 12.0.0 et ultérieures du Tag, le tracking des iFrames first et third-party est compatible avec le Session Replay, et activé à la demande par Contentsquare.

Session replay :

Le Session Replay a un support partiel des iFrames : la fenêtre la plus haute affichera un carré gris à la place de l’iframe, et l’iframe peut être joué séparément.

Pour cela :

le Tag doit être présent sur la fenêtre la plus haute et l’iFrame.
iframeTracking doit être désactivé dans les paramètres du Tag.

Éléments personnalisés et shadow DOM

Le tracking Tag a deux trackers d’événements séparés : Session Replay et Analytics.
Les deux supportent complètement les élements personnalisés (custom elements) et le shadow DOM.

HTML Canvas et WebGL (support partiel)

Le tag collecte les événements de la souris en les attachant au canvas mais il est impossible de les localiser au sein du canvas.

Google AMP - Accelerated Mobile Pages (non supporté)

Contentsquare ne supporte pas le tracking des AMP à date.

Mode hors-ligne (non supporté)

Le Tracking Tag ne vérifie pas si les données ont été reçues côté serveur avant de les supprimer localement. Tous les événements seraient supprimés à chaque tentative de requête.

Fonctionnement du tracking Tag

Le tag ne fait que de la lecture à l’exception des points suivants :

ajout de la balise script dans le head pour appeler la librairie ;
ajout d’une propriété __contentsquare_identifier à chaque élément (lorsque le Session Replay est actif) ;
surcharge de la fonction native CSSStyleSheet.prototype.insertRule (lorsque le Session Replay est actif).