For the complete documentation index, see llms.txt.

Product Analytics

Dernière mise à jour Voir en Markdown

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).

Lorsque Product Analytics est activé, les cookies suivants sont créés en plus des cookies standard du Tag :

CookieDuréeDescription
_cs_s_ctx30 minutesStocke les données de contexte de session (heure de la première page vue, URL et référent).
_cs_i3 joursStocke la chaîne d'identité chiffrée définie via la commande identify.
_cs_ep13 moisStocke les propriétés d'événement personnalisées au niveau de la visite, définies via customProperties:visit:add.

Ces 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 session

La 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éeEnvoyée sousRôle
firstViewTimefvtDébut de la session.
firstViewUrlfvurlPage d'arrivée de la session.
sessionReferrerfpvurlSource 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_ctx

Si _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.

L'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éeDescription
Événements d'interactionLes 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émentsChaque é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 pageLe titre de chaque page vue. Vous pouvez l'exclure avec hidePageTitle (en anglais).
Contexte de sessionHeure 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'utilisateurLa chaîne d'identité définie via identify (en anglais), stockée chiffrée dans le cookie _cs_i.
Propriétés personnaliséesLes 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éments

Pour 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és
Product Analytics

Les 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.

CommandeDescription
trackEventEnvoie 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énement
Product Analytics

Les 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.

CommandeDescription
customProperties:visit:addAjoute des propriétés personnalisées à tous les événements suivants. Alias : addEventProperties.
customProperties:visit:removeSupprime une propriété personnalisée des événements suivants. Alias : removeEventProperty.
customProperties:visit:clearSupprime toutes les propriétés personnalisées des événements suivants. Alias : clearEventProperties.
Product Analytics

Les commandes d'identité vous permettent d'attacher un identifiant unique à l'utilisateur en cours pour l'analyse multi-appareils et multi-sessions.

CommandeDescription
identifyAssocie 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.
resetIdentityDissocie la chaîne d'identité de l'utilisateur en cours et réinitialise la session.
getIdentityIndique 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 utilisateur
Product Analytics

Les 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.

CommandeDescription
addUserPropertiesAttache 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 vue
Product Analytics

Les 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.

CommandeDescription
customProperties:page:addAjoute des propriétés personnalisées à la page vue en cours et à ses événements.
customProperties:page:removeSupprime une propriété personnalisée de la page vue en cours.
customProperties:page:clearSupprime toutes les propriétés personnalisées de la page vue en cours.

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.

Vous pouvez exclure les titres de page de la collecte PA avec les commandes suivantes :

CommandeDescription
hidePageTitleRemplace le titre de la page par **** pour la prochaine page vue ou toutes les suivantes.
resetHidePageTitleAnnule 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.