Personyze Wiki Personyze Wiki docs
Français
Open Personyze
Docs/ Données visiteur/ Capturer des données sur votre site (conteneurs)
Données visiteur

Capturer des données sur votre site (conteneurs)

Transmettre à Personyze ce que votre site sait déjà d’un visiteur : sources, sélecteur visuel, suggestion par IA, masques, fréquence, objectifs et vérification.

12 min read Updated 16 minutes ago

À quoi sert la capture de données

Chemin dans l’interface : Paramètres → Gestion des données clients et de session.

Votre site sait déjà sur un visiteur des choses que Personyze ignore : ce qu’il y a dans son panier, ce qu’il a saisi dans un formulaire, la catégorie qu’il parcourt, s’il est connecté et qui il est. La capture est le moyen de transmettre ces informations à Personyze — vous désignez l’endroit de la page où se trouve la valeur, et Personyze la capture à chaque visite.

Une fois capturée, la valeur se comporte comme n’importe quel autre attribut visiteur. Vous pouvez l’utiliser pour :

  • Cibler — montrer une offre uniquement aux visiteurs dont le panier dépasse 100 €, ou uniquement aux comptes de niveau Enterprise.
  • Personnaliser — insérer directement la valeur dans le contenu comme variable dynamique, pour qu’une popup salue quelqu’un par son prénom ou nomme la catégorie qu’il vient de parcourir.
  • Construire le profil utilisateur — l’enregistrer de façon permanente pour le visiteur, afin qu’elle soit là lors de sa visite suivante, depuis n’importe quel appareil.
  • Reconnaître les personnes d’un appareil à l’autre — capturer un e-mail ou un identifiant CRM relie le navigateur anonyme à un enregistrement importé : un visiteur sur son téléphone est alors la même personne que sur son ordinateur portable.
  • Suivre les conversions — le même mécanisme de capture alimente les objectifs de conversion. Capturez le montant d’une commande sur la page de remerciement et il devient le revenu attribué à la campagne qui l’a générée.

Trois types de données capturées

La distinction qui compte le plus est la durée de vie de la valeur — et c’est le premier choix que vous faites, car il détermine la section de la page dans laquelle vous travaillez.

  • Attributs limités à la session — capturés à chaque visite et effacés à la fermeture de l’onglet. Adaptés à ce qui n’est vrai que maintenant : le total actuel du panier, la recherche qui vient d’être saisie, la page consultée. Gérés sous Attributs utilisateur limités à la session → Nouveau conteneur.
  • Attributs inter-sessions — des champs de profil permanents enregistrés par utilisateur, toujours présents lors de la visite suivante. Adaptés à ce qui reste vrai : prénom, niveau de compte, secteur, fonction. Gérés sous Attributs utilisateur inter-sessions → Nouveau champ de profil.
  • Identifiants multi-appareils — e-mail, identifiant CRM, etc. : les clés qui relient un visiteur à un enregistrement importé et permettent à Personyze de le reconnaître d’un appareil à l’autre. Gérés sous Identifiants utilisateur multi-appareils.

Posez-vous la question : est-ce que ce sera encore vrai la semaine prochaine ? Le contenu du panier, non — session. L’intitulé de poste, oui — inter-sessions. Est-ce quelque chose qui identifie qui est réellement la personne ? Alors c’est un identifiant.

Le même centre contient aussi Listes d’utilisateurs importées (données utilisateur en masse par fichier, RSS, SFTP ou API) et Données utilisateur individuelles — consultation et suppression pour les demandes RGPD.

La page de gestion des données clients et de session, listant les attributs limités à la session, les attributs inter-sessions, les identifiants multi-appareils, les listes d’utilisateurs importées et la recherche d’utilisateur individuel
Le centre des données. Chaque ligne indique ce qui est configuré et la date de la dernière capture — un contrôle rapide que vos captures se déclenchent toujours. « Last captured: Just now » signifie que les données circulent.

Créer un conteneur

Cliquez sur Nouveau conteneur (ou Nouveau champ de profil pour une valeur permanente), donnez-lui un nom et choisissez d’où vient la valeur.

Choisir une source de données

  • Paramètre d’URL — un segment de chemin, un paramètre de requête ou un fragment. Utilisez-le pour le suivi de campagnes, comme ?utm_source=, ou pour une catégorie intégrée au chemin.
  • Page / cookie — un sélecteur CSS, une variable window.* , un cookie ou une balise meta. C’est l’option la plus large, et celle qu’utilisent la plupart des captures.
  • Dimension GA4 — associez une dimension ou une propriété utilisateur GA4 que vous collectez déjà.
  • Datalayer GTM — lisez une clé du dataLayer GTM. Si votre équipe de développement pousse déjà la valeur du panier ou le niveau client dans le dataLayer, prenez-la là plutôt que d’extraire le DOM.
Le panneau New session container montrant les quatre sources de données : URL parameter, Page or cookie, GA4 dimension et GTM datalayer
Quatre sources de données. Préférez le GTM datalayer ou une variable window à un sélecteur CSS quand la valeur y est déjà exposée — les données structurées ne cassent pas quand la page change de style.
La source de données Page or cookie sélectionnée, avec Grab data from réglé sur un sélecteur CSS
Page / cookie sélectionné. Grab data from précise ensuite la source — un sélecteur CSS, un cookie, une balise meta, une clé de stockage ou une variable JavaScript.

Désigner la valeur

Avec Depuis un sélecteur CSS choisi, il y a deux façons de le fournir :

  • Je connais le sélecteur — saisissez-le directement, par exemple .user-email.
  • Trouver sur les pages — saisissez une URL d’exemple et cliquez sur Ouvrir le sélecteur. Personyze ouvre cette page dans le simulateur QA, dans un onglet séparé ; cliquez sur l’élément et le sélecteur capturé revient dans le champ.

Plusieurs éléments peuvent correspondre au sélecteur indique à Personyze d’essayer chaque correspondance jusqu’à trouver une valeur valide — utile quand la même classe apparaît plusieurs fois et qu’une seule occurrence contient réellement la donnée.

L’option Find on pages avec un champ d’URL d’exemple et un bouton Open picker pour capturer un sélecteur visuellement
Find on pages : saisissez une URL d’exemple où la valeur est visible — une page de compte pour un e-mail, une page panier pour un total — et ouvrez le sélecteur pour cliquer dessus.

Utiliser le sélecteur visuel

Le sélecteur visuel ouvre votre site avec un panneau à côté : vous capturez donc sur la vraie page au lieu de deviner le balisage.

Le sélecteur de capture de données de Personyze ouvert à côté d’un site en ligne, prêt à capturer des données utilisateur et du site
Le sélecteur de capture ancré à côté de votre site en ligne. Saisissez une URL, choisissez une source et travaillez directement sur la vraie page.

Décrivez-la et laissez l’IA remplir le formulaire

Plutôt que de déterminer vous-même la source, la clé et le masque, dites ce que vous voulez avec des mots simples — « le nombre d’articles actuellement dans le panier » — et cliquez sur Suggest with AI. L’IA propose la source, la clé ou le sélecteur, un masque et un nom sous lequel l’enregistrer. Apply & fill the form reporte les quatre dans le formulaire.

Le panneau Describe what to grab avec une suggestion de l’IA proposant la source, la clé, le masque et le nom d’enregistrement
Décrivez la valeur avec des mots simples et l’IA déduit le reste — ici, elle propose le stockage de session, la clé cart-data , un masque Number only, et cart_item_count comme nom. Apply remplit le formulaire.

Pointer et cliquer

Choisissez Grab data from page et le panneau vous demande de cliquer sur un élément. Survolez la page et cliquez sur la valeur voulue.

Le sélecteur vous invitant à pointer et cliquer sur un élément de la page pour en capturer la valeur
Avec la source page choisie, le sélecteur attend votre clic. Tout ce qui se trouve sur la page devient sélectionnable.

Une fois l’élément choisi, le panneau indique d’où il capture (le sélecteur qu’il a déduit), un aperçu de la valeur qui serait envoyée, et un lien Pick a different element si vous êtes tombé sur le mauvais élément. Nommez la valeur sous Store grabbed value as — c’est ce nom que vous choisirez dans les listes déroulantes lors de la création d’audiences et de contenu dynamique : rendez-le lisible : cart_item_count, pas c1.

Un élément choisi dans le sélecteur de capture, montrant le sélecteur capturé et un aperçu de la valeur qui serait envoyée
Un élément choisi : le sélecteur déduit, et un aperçu en direct de la valeur que Personyze enverrait. L’aperçu est le moyen le plus rapide de confirmer que vous avez capturé la bonne chose avant d’enregistrer.

Attention aux identifiants dynamiques. Si votre site génère des sélecteurs avec un identifiant qui change selon le visiteur ou le produit — div-cart-SS4443 — la capture fonctionne pour vous et pour personne d’autre, car ce sélecteur n’existe sur la page de personne d’autre. Utilisez select parents pour remonter à un ancêtre générique comme div-cart. La règle : le sélecteur doit être constant d’une session et d’un visiteur à l’autre.

Réglages avancés

Masque — ne garder qu’une partie de la valeur

Le texte brut de la page est rarement la valeur que vous voulez. « Total du panier : 149,99 € » est une chaîne ; vous voulez 149.99. Un masque ne prend que certaines parties du texte capturé :

  • Tout transmettre — par défaut, aucun filtrage.
  • Nombre uniquement / Non-nombres uniquement — retirer l’un ou l’autre. Number only est ce qui transforme « 149,99 € » en quelque chose que l’on peut comparer à « supérieur à 100 ».
  • Adresse e-mail — extraire un e-mail du texte qui l’entoure.
  • Récupérer si contient / Récupérer si ne contient pas — capturer sous condition.
  • Fragment de texte, Récupérer à partir d’un mot précis, Récupérer d’un mot précis à un autre mot précis — extraire une portion d’après les mots qui l’entourent.
  • Expression régulière (avancé) — pour tout ce que les options ci-dessus ne peuvent pas exprimer.

Si vous comptez cibler numériquement — un panier de plus de 100 € — il vous faut presque certainement Number only. Une valeur capturée sous la forme « 149,99 € » ne correspondra pas à une règle « supérieur à ».

La liste déroulante Mask ouverte, montrant les options pour ne garder qu’une partie de la valeur capturée
Les options de masque dans les réglages du conteneur. L’aperçu du sélecteur se met à jour quand vous changez de masque, pour que vous puissiez confirmer le résultat avant d’enregistrer.
Réglages avancés du sélecteur de capture, avec un masque appliqué pour ne garder qu’une partie de la valeur capturée
Le même masquage dans le sélecteur, avec Number only appliqué. Vérifiez l’aperçu : il doit afficher le nombre seul, sans le texte qui l’entoure.

Enregistrer une valeur par

Détermine la fréquence à laquelle la valeur est enregistrée :

  • Un par visite (session) — une capture par session. Adapté aux informations stables comme le niveau de compte.
  • Un par page — une capture à chaque page vue. Adapté à une valeur qui change pendant la navigation, comme la catégorie en cours.
  • Sans limite — une capture à chaque changement, par exemple un total de panier qui se met à jour à mesure que des articles sont ajoutés.
La liste déroulante Log one record per ouverte, montrant One per visit, One per page et No limit
Log one record per. Alignez-le sur la fréquence réelle de changement de la valeur — No limit sur une valeur statique est une capture gaspillée ; One per visit sur un total de panier vous fait manquer les mises à jour.

Grab from et Value to send

Récupérer depuis choisit quelle partie de l’élément lire — son contenu, ou un attribut. Valeur à envoyer permet d’envoyer une valeur fixe quand la valeur capturée n’est pas vide au lieu du texte capturé : utile quand la simple présence d’un élément est le signal (un élément existe → envoyer logged_in), plutôt que son contenu.

Capturer uniquement après un clic

Certaines valeurs n’apparaissent qu’après une interaction — un total qui se met à jour après « Ajouter au panier », ou un champ de formulaire qui n’est rempli qu’à l’envoi. Utiliser le conteneur quand cet élément est cliqué (dans le sélecteur : Grab value only after another element is clicked) attend un clic sur un second élément avant de capturer.

L’option pour capturer une valeur uniquement après un clic sur un autre élément, pour les valeurs qui apparaissent après une interaction
Capture après clic : choisissez l’élément de la valeur, puis un élément déclencheur. Personyze ne capture qu’une fois ce déclencheur cliqué — la solution pour les valeurs qui n’existent pas au chargement de la page.

Utiliser une capture comme objectif de conversion

Un objectif de conversion se configure de la même façon — même sélecteur, mêmes sources, mêmes masques. La différence tient à ce que signifie la valeur capturée : au lieu de décrire le visiteur, elle enregistre qu’un événement digne d’être mesuré s’est produit, et éventuellement ce qu’il valait.

Deux réglages comptent davantage pour les objectifs que pour les attributs ordinaires :

  • Mask → Number only — la valeur d’un objectif doit être un nombre pour être additionnée comme revenu. Capturer « Total de la commande : 149,99 € » tel quel vous donne une chaîne que Personyze ne peut pas additionner.
  • Value to send → Fixed value when the grabbed one is nonempty — quand c’est la présence d’un élément qui constitue la conversion, et non son contenu. Pointez sur le titre « Merci pour votre commande » et envoyez une valeur fixe 1: si l’élément est là, l’objectif se déclenche ; s’il n’y est pas, rien ne se passe. C’est ainsi que vous suivez une conversion sur une page qui n’affiche aucun chiffre utile.
Le sélecteur de capture avec Fixed value when grabbed one is nonempty sélectionné, envoyant une valeur définie au lieu du texte capturé
Envoyer une valeur fixe au lieu du texte capturé. La présence de l’élément est le signal — l’aperçu affiche la valeur capturée (« Grocery ») mais SENT 1. C’est le schéma pour un objectif qui se déclenche sur un élément de confirmation.

La fréquence compte aussi : un objectif d’achat demande généralement Un par visite (session), pour qu’une page de confirmation actualisée ne compte pas la commande deux fois. Consultez Configurer le suivi des objectifs de conversion pour la configuration complète des objectifs.

L’enregistrer dans le profil utilisateur

Un conteneur de session est effacé à la fermeture de l’onglet. Pour conserver une valeur de façon permanente — nom, âge, secteur, fonction, type de compte — créez-la plutôt sous Attributs utilisateur inter-sessions → Nouveau champ de profil : nommez le champ, choisissez son type de données (texte, numérique, date) et enregistrez. Il peut ensuite être rempli via le sélecteur, une saisie manuelle ou une intégration.

Ces champs de profil sont ce qui fait fonctionner le ciblage ABM et CRM. Pour la configuration complète, consultez Ajouter des champs de données de profil utilisateur personnalisés pour le ciblage ABM et CRM et Configuration et synchronisation des données de profil utilisateur.

Vérifier que ça fonctionne

Ne supposez pas qu’une capture se déclenche simplement parce qu’elle a été enregistrée. Trois façons de vérifier :

  • L’aperçu dans le sélecteur — le contrôle le plus rapide, avant même d’enregistrer.
  • Le centre des données — chaque section affiche Last captured. S’il indique « Just now », les données circulent ; s’il date de plusieurs heures sur un site très fréquenté, quelque chose est cassé.
  • Mode test / console du navigateur — avec votre adresse IP en test, la console affiche tout ce que Personyze a recueilli sur le visiteur, y compris les valeurs des conteneurs. Consultez Mode test de Personyze dans la console.

Une capture qui ne renvoie silencieusement rien est la panne la plus courante, et elle vient presque toujours de l’une de ces trois causes : le sélecteur n’existe pas sur cette page, il contenait un identifiant dynamique, ou la valeur n’était pas encore affichée au moment de la capture (utilisez grab after click).

Did this page answer your question?
Thank you — that goes to whoever maintains this page.