Product Analytics
Les fonctionnalités de Product Analytics (PA) capturent et visualisent les interactions des utilisateurs sur les plateformes web, mobiles et autres, fournissant des informations sur le comportement et l'engagement des utilisateurs. Ces données aident à identifier les préférences des utilisateurs, les points de friction et les tendances comportementales, permettant ainsi l'amélioration et l'optimisation de l'expérience numérique.
Pour plus d'informations, consultez nos pages produit ↗ et tarifs ↗ (en anglais).
Cookies PA
Section titled Cookies PALorsque Product Analytics est activé, les cookies suivants sont créés en plus des cookies standard du Tag :
| Cookie | Durée | Description |
|---|---|---|
_cs_s_ctx | 30 minutes | Stocke les données de contexte de session (heure de la première page vue, URL et référent). |
_cs_i | 3 jours | Stocke la chaîne d'identité chiffrée définie via la commande identify. |
_cs_ep | 13 mois | Stocke les propriétés d'événement personnalisées au niveau de la visite, définies via customProperties:visit:add. |
Configuration serveur
Section titled Configuration serveurCes cookies sont nouveaux lorsque Product Analytics est activé et ne sont pas présents dans un déploiement standard du Tag. Si vous avez déjà un filtre de cookies, mettez-le à jour avant d'activer les fonctionnalités PA.
Si vous appliquez une liste d'autorisation de cookies — via une plateforme de gestion du consentement (CMP), un WAF ou des règles de filtrage côté serveur — ajoutez _cs_s_ctx, _cs_i et _cs_ep à cette liste. Le blocage de l'un d'entre eux empêche Product Analytics de collecter correctement les données.
La taille de _cs_ep augmente avec le nombre de propriétés d'événement personnalisées définies. Combinée à _cs_s_ctx, la taille totale de l'en-tête de requête Cookie peut dépasser les limites imposées par les reverse proxies ou les serveurs web. Si votre infrastructure impose une limite de taille d'en-tête, assurez-vous qu'elle autorise au moins 4 Ko pour les cookies.
Pour plus d'informations, consultez Cookies.
Collecte du contexte de session
Section titled Collecte du contexte de sessionLa plupart des rapports PA reposent sur le contexte au niveau de la session — le moment où une visite a commencé et son origine — attaché à chaque événement, et pas seulement à la première page vue. Le Tag conserve ce contexte côté client dans le cookie _cs_s_ctx et le renvoie sous forme de paramètres de requête à chaque page vue et événement suivant :
| Valeur stockée | Envoyée sous | Rôle |
|---|---|---|
firstViewTime | fvt | Début de la session. |
firstViewUrl | fvurl | Page d'arrivée de la session. |
sessionReferrer | fpvurl | Source de trafic de la session. |
Ce cookie est créé uniquement lorsque Product Analytics est actif sur le projet. Il n'a aucun effet sur les fonctionnalités d'Experience Analytics telles que Session Replay ou les heatmaps.
Impact du blocage de _cs_s_ctx
Section titled Impact du blocage de _cs_s_ctxSi _cs_s_ctx est bloqué ou supprimé — par une règle WAF, une liste d'autorisation de cookies ou une plateforme de gestion du consentement — le Tag ne peut pas restaurer le contexte de session après la première page vue. La page d'arrivée, la source de trafic et l'heure de début de session sont alors absentes de chaque événement suivant, ce qui dégrade l'attribution et la qualité globale des rapports PA pour les sessions concernées.
Pour l'éviter, ajoutez _cs_s_ctx à tout filtre de cookies que vous appliquez — consultez Configuration serveur.
Collecte de données
Section titled Collecte de donnéesL'activation de Product Analytics ne modifie pas les données que le Tag collecte déjà pour Experience Analytics — consultez Données collectées. Elle ajoute les données suivantes :
| Donnée | Description |
|---|---|
| Événements d'interaction | Les interactions click, tap, change et submit sont collectées sous forme d'événements, afin de pouvoir les analyser sans balisage préalable. |
| Hiérarchie des éléments | Chaque événement d'interaction porte la chaîne des éléments ancêtres de l'élément ciblé. Consultez Collecte de la hiérarchie des éléments. |
| Titre de la page | Le titre de chaque page vue. Vous pouvez l'exclure avec hidePageTitle (en anglais). |
| Contexte de session | Heure de début de session, page d'arrivée et source de trafic, attachés à chaque événement. Consultez Collecte du contexte de session. |
| Identité de l'utilisateur | La chaîne d'identité définie via identify (en anglais), stockée chiffrée dans le cookie _cs_i. |
| Propriétés personnalisées | Les propriétés utilisateur, d'événement et de page vue que vous envoyez via les API du Tag. Consultez Enrichissement de la collecte de données. |
Collecte de la hiérarchie des éléments
Section titled Collecte de la hiérarchie des élémentsPour alimenter l'analyse des interactions, le Tag enrichit les événements click, tap, change et submit avec la hiérarchie des éléments : la chaîne des éléments ancêtres, de l'élément ciblé jusqu'à la racine du document. Chaque niveau collecte le nom de la balise et un ensemble limité d'attributs.
La collecte de la hiérarchie respecte les paramètres de masquage de votre projet, et les attributs qui contiennent couramment des données sensibles ou non sémantiques ne sont jamais collectés. Pour le format de sérialisation, les limites de taille et la liste complète des attributs exclus, consultez Hiérarchie des éléments (en anglais).
Enrichissement de la collecte de données (API du Tag pour PA)
Section titled Enrichissement de la collecte de données (API du Tag pour PA)L'activation de Product Analytics débloque les groupes de commandes du Tag suivants. Toutes les commandes PA sont appelées via window._uxa.push(...), la même interface que celle utilisée pour les commandes standard du Tag.
Consultez la référence des commandes (en anglais) pour la syntaxe complète et des exemples.
Commandes d'événements personnalisés
Section titled Commandes d'événements personnalisésLes commandes d'événements personnalisés vous permettent d'envoyer vos propres événements nommés, enrichis de propriétés personnalisées, en plus des interactions que Contentsquare capture automatiquement.
| Commande | Description |
|---|---|
trackEvent | Envoie un événement personnalisé avec un nom et des propriétés facultatives. |
Commandes de propriétés d'événement
Section titled Commandes de propriétés d'événementLes commandes de propriétés d'événement vous permettent d'attacher des propriétés personnalisées (paires clé-valeur) à tous les événements suivants de la visite en cours.
| Commande | Description |
|---|---|
customProperties:visit:add | Ajoute des propriétés personnalisées à tous les événements suivants. Alias : addEventProperties. |
customProperties:visit:remove | Supprime une propriété personnalisée des événements suivants. Alias : removeEventProperty. |
customProperties:visit:clear | Supprime toutes les propriétés personnalisées des événements suivants. Alias : clearEventProperties. |
Commandes d'identité
Section titled Commandes d'identitéLes commandes d'identité vous permettent d'attacher un identifiant unique à l'utilisateur en cours pour l'analyse multi-appareils et multi-sessions.
| Commande | Description |
|---|---|
identify | Associe l'utilisateur en cours à la chaîne d'identité fournie. Si une identité différente est déjà définie, la session est réinitialisée : l'ID utilisateur est régénéré et une page vue de renouvellement est envoyée. |
resetIdentity | Dissocie la chaîne d'identité de l'utilisateur en cours et réinitialise la session. |
getIdentity | Indique si l'utilisateur en cours est associé à une chaîne d'identité. |
Pour plus d'informations sur l'identification des utilisateurs, consultez Suivre les utilisateurs (en anglais).
Commandes de propriétés utilisateur
Section titled Commandes de propriétés utilisateurLes commandes de propriétés utilisateur vous permettent d'attacher des propriétés personnalisées (paires clé-valeur) à l'utilisateur en cours. Ces propriétés sont associées à tous les événements futurs de cet utilisateur.
| Commande | Description |
|---|---|
addUserProperties | Attache des propriétés personnalisées à l'utilisateur en cours, en écrasant les valeurs précédemment définies pour les mêmes propriétés. |
Commandes de propriétés de page vue
Section titled Commandes de propriétés de page vueLes commandes de propriétés de page vue vous permettent d'attacher des propriétés personnalisées (paires clé-valeur) à la page vue en cours et à tous les événements de cette page.
| Commande | Description |
|---|---|
customProperties:page:add | Ajoute des propriétés personnalisées à la page vue en cours et à ses événements. |
customProperties:page:remove | Supprime une propriété personnalisée de la page vue en cours. |
customProperties:page:clear | Supprime toutes les propriétés personnalisées de la page vue en cours. |
Confidentialité
Section titled ConfidentialitéLes éléments masqués et chiffrés définis dans le tag de tracking Contentsquare sont également appliqués à la collecte de données PA. Consultez Gestion des données personnelles.
Pour les projets dont le mode sans IP est actif, le traitement des adresses IP est également désactivé pour la collecte de données PA.
Masquage du titre de page
Section titled Masquage du titre de pageVous pouvez exclure les titres de page de la collecte PA avec les commandes suivantes :
| Commande | Description |
|---|---|
hidePageTitle | Remplace le titre de la page par **** pour la prochaine page vue ou toutes les suivantes. |
resetHidePageTitle | Annule hidePageTitle pour les prochaines pages vues. |
Si vous appliquez une Content Security Policy, consultez Content Security Policy pour les directives requises par le Tag Contentsquare.
La collecte des données décrites sur cette page auprès de vos visiteurs ne nécessite aucune directive supplémentaire. Le Visual Labeler, utilisé pour taguer les événements depuis l'application Contentsquare, charge ses ressources depuis un hôte supplémentaire et nécessite 'unsafe-eval'. Ces directives sont listées dans la section Product Analytics de la page Content Security Policy.

