Catégorie : Live Signals
Cette intégration est uniquement disponible pour les projets Web et supporte l'envoi de signaux vers les partis tiers suivants :
- Write to Data Layer
-
ForeSee
-
FreshChat
-
Heap Analytics
-
iAdvize Chat
-
Monetate
-
Namogoo Customer Journey OS
-
Qualaroo
-
Tealium Event Tracker
-
Ubix Labs
À quoi s'attendre
Cette intégration permet de segmenter selon les interactions utilisateurs telles que les clics de rage, le survol constant, le scroll répété et l'activité frauduleuse. Ces signaux peuvent également être envoyés à d'autres outils tiers en temps réel.
Ce que nous collectons
Variables dynamiques
Key | Value | Type de données |
LS_Rage click | {DOM Path} | Texte |
LS_Consecutive click | {DOM Path} | Texte |
LS_JavaScript error caused by click | {DOM Path} | Texte |
LS_Repetitive hovering | {DOM Path} | Texte |
LS_Repeated scrolling | {URL} | Texte |
LS_Mouse shakes | {URL} | Texte |
LS_Exit intent | {URL} | Texte |
LS_Excessive loading time | {Time in milliseconds} | Nombre |
LS_Time spent on page | {Time in seconds} | Nombre |
LS_Excessive pastes | {DOM Path} | Texte |
LS_Excessive reloads | {URL} | Texte |
LS_Excessive clicks | {DOM Path} | Texte |
LS_Returns intention | true | Texte |
LS_Ad blocker detected | {URL} | Texte |
Implémentation
Étapes d'implémentation
Consultez notre article "Demander une intégration" et suivez ses instructions pour commencer l'activation. Une fois cela fait, vous pourrez reprendre votre lecture de cet article.
Options de signal
Vous pouvez choisir parmi les signaux supportés suivants :
Signaux de friction
Signal | Description |
Clics de rage | Cliquer rapidement X fois en Y millisecondes |
Clics consécutifs | Cliquer X fois consécutives sur le même élément en Y secondes |
Survols répétitifs | Survoler X fois le même élément en Y secondes |
Scroll répété | Faire défiler la page jusqu'à X% puis remonter jusqu'à Y% Z fois |
Erreurs JavaScript causées par des clics | Chaque fois qu'un clic provoque une erreur JS en X secondes |
Secousses de souris | Accélérer les mouvements de souris de gauche à droite ou de haut en bas en X millisecondes |
Intention de sortie | Quitter la fenêtre principale après X secondes passées sur la page |
Temps de chargement excessif |
First Contentful Paint de plus de X secondes et se répète Y fois
|
Temps passé sur la page
|
Après avoir atteint X secondes sur une vue de page, naturelle ou artificielle, unique
|
Signaux de fraude
Signal | Description |
Collages excessifs | Coller X fois dans le même champ défini et pendant la même session |
Rechargements excessifs | Recharger une page(s) définie(s) X fois au cours de la même session |
Clics excessifs | Cliquer X fois sur le même élément défini lors d'une vue de page |
Signal de poussée
Signal | Description |
Intention de retour d'article
|
Ajouter différents SKU au panier X fois pour le même produit |
Signal de blocage de publicités
Signal | Description |
Bloqueur de publicités / Ad Blocker détecté | Chaque fois qu'un bloqueur de publicités est détecté en X secondes. |
Signaux Namogoo (uniquement pour les clients Namogoo)
Signal | Description |
Score de puissance du CPU (1-5) | Chaque fois que le score de puissance du CPU est égal ou inférieur à X. |
Score de puissance du réseau (1-5) | Chaque fois que le score de puissance du réseau est égal ou inférieur à X. |
Chaque signal peut remplacer les valeurs seuils définies par défaut.
Voici les valeurs par défaut de chaque signal. Vous pouvez demander à les modifier si nécessaire.
Signal | Type | Valeur par défaut | Nom de l'événement |
Seuil de clics de rage |
nombre
|
4 | rage_click_signal |
millisecondes
|
750 | rage_click_signal | |
Seuil de clics consécutifs
|
nombre
|
5 | consecutive_click_signal |
|
millisecondes
|
5000 | consecutive_click_signal |
Seuil de déclenchement d'erreurs JavaScript causées par un délai de clic
|
millisecondes | 2000 | js_error_signal |
Seuil de survol répétitif
|
nombre
|
5 | repetitive_hovering_signal |
Seuil de temporisation du survol répétitif
|
millisecondes
|
10000 | repetitive_hovering_signal |
Seuil de scroll répété
|
nombre
|
2 | repeated_scrolling_signal |
Seuil de pourcentage minimum de scroll répété
|
pourcentage | 10 | repeated_scrolling_signal |
Seuil de pourcentage maximum de scroll répété
|
pourcentage | 85 | repeated_scrolling_signal |
Seuil de temporisation des secousses de souris
|
millisecondes |
350
|
mouse_shakes_signal
|
Seuil d'accélération des secousses de souris
|
accélération |
0.01
|
mouse_shakes_signal
|
Seuil de temporisation de l'intention de sortie
|
millisecondes
|
10000 | exit_intent_signal |
Seuil de temps de chargement excessif
|
millisecondes
|
7000 |
excessive_loading_time_signal
|
Seuil de quantité de temps de chargement excessif
|
nombre
|
5 |
excessive_loading_time_signal
|
Seuil de temps passé sur la page
|
secondes
|
90 |
time_spent_on_page_signal
|
Seuil de collages excessifs
|
nombre
|
10 | excessive_pastes_fraud_signal |
Seuil de rechargements excessifs
|
nombre
|
20 | excessive_reloads_fraud_signal |
Seuil de clics excessifs
|
nombre
|
10 | excessive_clicks_fraud_signal |
Seuil d'intentions de retour d'article
|
nombre
|
2 |
returns_intention_signal
|
Seuil de minuterie de bloqueur de publicités
|
millisecondes | 2000 | adblocker_signal |
Seuil de score de puissance du CPU (Namogoo)
|
nombre | 1 |
cpu_strength_score
|
Seuil de score de puissance du réseau (Namogoo)
|
nombre | 1 |
network_strength_score
|
Définir des sélecteurs CSS
Signaux de fraude
Si vous utilisez les signaux de fraude, vous devrez définir ce qui suit :
Pour le module "Rechargements excessifs", vous devrez définir la partie de l'URL sur laquelle vous souhaitez que le module s'exécute.
Il est recommandé de ne définir cette condition que pour les pages qui comportent un champ de carte de crédit ou de bon de réduction.
Pour les modules "Collages excessifs" et "Clics excessifs", vous devez définir des sélecteurs CSS tels que les noms de classe / ID / attributs de données des champs de saisie pour lesquels vous souhaitez suivre les collages ou les clics. Il est recommandé d'utiliser des noms de classe uniques à ces champs. Vous pouvez renseigner autant de sélecteurs séparés par des virgules que vous le souhaitez, mais il est préférable de les limiter aux champs de saisie de carte de crédit et de bons de réduction, car c'est là que se produisent les fraudes. Si votre entreprise traite des demandes d'assurance, alors vous pourriez également inclure les champs du formulaire de demande d'assurance. Pour les conditions d'URL, veuillez utiliser le séparateur pipe |.
Autres signaux
Pour tous les signaux, vous avez la possibilité de définir des sélecteurs CSS ou des expressions JavaScript qui rendront la détection plus spécifique et de ne l'appliquer qu'à certaines pages et/ou certains éléments.
Format du sélecteur CSS
Le format standard utilisé par document.querySelector() est accepté.
Sélecteur CSS | Exemple |
ID | #submit |
Classes | .form-fields |
Attributs de données | [data-header-label='Sign In'] ou [data-header-label] |
Chemin DOM |
body > div#root > div:nth-of-type(2) > main#content > div > a:nth-of-type(1) |
Par exemple, le listener de clic ne détectera le sélecteur que sur le dernier nœud, qui dans ce cas est l'élément SPAN qui se trouve à l'intérieur d'un élément BUTTON. Donc, disons que votre sélecteur existe sur l'élément BUTTON ([data-testid='configurator-next']), mais que vous souhaitez qu'un signal soit détecté à la fois sur le BUTTON et le SPAN à l'intérieur, alors vous devrez demander à activer cette option. Autrement, le sélecteur ne sera jamais détecté.
Obtenir les sélecteurs CSS
Afin de facilement définir les sélecteurs CSS à fournir à Contentsquare pour le suivi des signaux en direct, vous pouvez installer cette extension Chrome.
1. Une fois installée, cliquez-droit sur la nouvelle icône de l'extension dans votre navigateur et cliquez sur "Options" :
2. Sur la page des options, passez l'option d'obtention des sélecteurs CSS à "Activé" et cliquez sur "Enregistrer les paramètres".
3. Rendez-vous sur la page à partir de laquelle vous souhaitez obtenir les sélecteurs CSS (actualisez-la si celle-ci était déjà ouverte).
4. Cliquez sur n'importe quel élément de la page, en particulier ceux que vous souhaitez suivre avec Live Signals, et vous verrez apparaître une modale déplaçable en haut à gauche de l'écran qui indiquera le type d'élément et les sélecteurs CSS qui lui sont associés.
Ex : Cliquer sur un bouton CTA fera apparaître la modale où vous verrez le type de tag et les sélecteurs CSS associés au CTA en question.
5. Cliquez sur les sélecteurs CSS que vous souhaitez utiliser pour les copier dans votre presse-papiers.
Si pour une raison quelconque la page se redirige après que vous l'ayez cliquée, elle affichera automatiquement les derniers sélecteurs CSS détectés en bleu une fois qu'elle sera chargée.
Dès que vous cliquerez sur un autre élément, il affichera alors les informations du nouvel élément sur lequel vous avez cliqué, tandis que le précédent s'affichera de nouveau en rouge, et ainsi de suite.
6. Veuillez ensuite lister les sélecteurs que vous souhaitez suivre à notre équipe, qui les configurera pour vous dans votre compte Contentsquare, et indiquez-leur à quels signaux en direct ils correspondent. Si les sélecteurs sont les mêmes pour plusieurs signaux, veuillez le préciser. N'oubliez pas de désactiver cette option une fois terminée, autrement elle suivra tous les sites que vous consultez.
Options d'alerte
Avec les signaux, vous avez la possibilité de choisir où envoyer ces signaux, par exemple à Contentsquare pour la segmentation mais également à certains produits tiers que nous supportons actuellement. Si vous souhaitez envoyer ces signaux vers un autre produit qui ne figure pas dans la liste, n'hésitez pas à en faire la requête via le support afin que nous étudiions cette option.
Si vous souhaitez envoyer ces signaux à Contentsquare, vous pouvez choisir de les envoyer soit en tant que :
- Variables dynamiques
- Événements de page (ceux-ci apparaissent dans le flux d'événements des replays de sessions)
Voici les options de partis tiers que nous prenons en charge pour l'envoi de signaux :
-
ForeSee
-
FreshChat
-
Heap Analytics
- iAdvize Chat
- Monetate
-
Namogoo Customer Journey OS
-
Qualaroo
- Tealium Event Tracker
-
Ubix Labs
Instructions spéciales
Dispatch JS Custom Events
Si vous choisissez l'option des évènements personnalisés ("CustomEvent"), vous devrez définir un écouteur d'événement portant sur la fenêtre dans votre code et écouter l'événement personnalisé nommé Contentsquare_LiveSignal
Le code à utiliser est le suivant :
window.addEventListener( "Contentsquare_LiveSignal", function (e) { //In the event detail property you will find the signal object that was dispatched. //Simply push that object to wherever you need. //console.log(e.detail); }, false );
Write to DataLayer
Si votre Data Layer n'est pas nommé dataLayer, veuillez-en renseigner le nom à CS.
Voici un exemple de ce à quoi ressemblera la charge utile lorsqu'elle sera ajoutée au Data Layer.
Adobe Experience Platform
- ID du locataire (obligatoire)
- Nom de l'objet Alloy (uniquement si vous n'utilisez pas le nom par défaut qui est alloy)
- ID de l'ensemble de données (facultatif)
Dans AEP, vous devrez configurer un schéma comme ceci:
Définissez une propriété contentsquare_live_signal contenant les données des signaux et respectant le schéma xdm. Veuillez également définir un indicateur facultatif pour les sous-propriétés suivantes de contentsquare_live_signal.
event
target
xpath
page
error_message
cs_replay_link
Le résultat devrait ressembler à ceci:
La charge utile que vous recevrez dans AEP ressemblera à ceci.
Amplitude
Dans votre CDP Amplitude, recherchez les événements qui portent le nom contentsquare_live_signal
Naviguez jusqu'à l'option "Événements inattendus" de l'onglet "Données".
Ajoutez ensuite l'événement à votre plan de suivi. Notez que chaque signal en direct peut avoir différentes propriétés, mais aussi que certains peuvent en partager. Assurez-vous donc de ne pas les bloquer.
Vous pouvez ensuite lui donner un nom tel que "Live Signals Contentsquare".
Ensuite, rendez-vous dans la section "Analytics" d'Amplitude et créez-y, par exemple, un nouveau graphique. Choisissez l'événement contentsquare_live_signal, sélectionnez où (son emplacement), puis sélectionnez la propriété event et trouvez les options que vous souhaitez pour les signaux en direct, tels que rage_click_signal.
iAdvize Chat
Dans votre application iAdvize Chat, vous devez configurer un chemin pour déclencher la notification de chat.
Créez une nouvelle campagne pour Live Signals et définissez les règles de ciblage.
Créez la règle de ciblage avec le déclencheur "L'adresse de la page actuelle contient" et définissez le chemin personnalisé que vous souhaitez. Cela peut être n'importe quoi. Vous devrez ensuite fournir ce chemin à Contentsquare afin qu'il puisse être configuré dans les paramètres de l'intégration.
Kameleoon
Configurez l'option "Données personnalisées" comme ceci :
Il est obligatoire d'utiliser uniquement ce nom pour le nom des données personnalisées : ContentsquareLiveSignals
Si un autre nom ou format est utilisé, cela ne fonctionnera pas.
Vous pourrez ensuite configurer des segments pour inclure le nom des signaux sur lesquels vous souhaitez agir.
Monetate
Afin d'utiliser cela avec Monetate, vous devrez créer une nouvelle action dans Monetate et la connecter à une expérience.
Après avoir créé l'action, ajoutez une condition de "Catégorie de page" et choisissez entre "La catégorie de page contient" et "La catégorie de page =".
Vous devrez insérer un préfixe comme : _cs_livesignal- puis ajouter le nom de l'événement du signal en direct pour lequel vous créez cette action, tel que rage_click_signal (retrouvez la liste des noms d'événements dans le tableau des signaux en direct dans ce document).
Appuyez sur "Entrée" et vous le verrez sous la forme suivante :
Vous avez maintenant une nouvelle action, comme ceci :
Rendez-vous ensuite sur l'expérience à laquelle vous souhaitez connecter l'action ou créer une nouvelle expérience dédiée et ajoutez l'événement existant que vous avez créé ci-dessus pour les Clics de rage dans le champ QUOI.
Optimizely Data Platform
Pour pouvoir utiliser ceci dans Optimizely Data Platform, vous devez d'abord créer un nouveau champ dans la section "Événements".
Rendez-vous dans "Paramètres du compte" > "Administration" > "Objets et champs" et cliquez sur le bouton "Créer un nouveau champ".
Choisissez "Événements" dans le menu déroulant "Objet contenant le nouveau champ".
Insérez ensuite ce nom d'affichage dans "Nom d'affichage du champ" : Contentsquare Live Signal
Et celui-ci dans "Nom du champ" : contentsquare_live_signal
Sélectionnez "Texte" pour le type de champ.
Cliquez sur "Enregistrer" et servez-vous de l'inspecteur d'événements pour vérifier que les signaux arrivent correctement.
Retournez dans les "Paramètres du compte" > "Inspecteur d'événements" et cliquez sur "Lancer l'inspecteur". Parcourez les événements jusqu'à ce que vous trouviez un événement intitulé contentsquare_live_signal.
Cela ressemblera à ceci :
Optimizely Web
Pour pouvoir utiliser Live Signals dans Optimizely Web, vous devez créer un nouvel attribut utilisateur personnalisé.
Dans votre compte Optimizely Web, rendez-vous dans la section "Audiences", puis cliquez sur "Attributs", puis sur "Créer un nouvel attribut".
Choisissez l'option "Attribut personnalisé".
Dans le champ "Nom de l'attribut", tapez "Contentsquare Live Signal" et dans celui du "Nom de l'API" tapez exactement : "ContentsquareLiveSignal", puis cliquez sur "Enregistrer". Vous n'avez pas besoin du code.
Vous pouvez maintenant créer une audience basée sur les différents signaux. Cliquez sur "Enregistré", puis sur "Créer une nouvelle audience".
Trouvez l'attribut Contentsquare Live Signal sous "Attributs personnalisés" et faites-le glisser vers la gauche.
Insérez le nom de l'événement de signal en direct que vous souhaitez, selon la liste mentionnée ci-dessus. Si l'un des noms a été modifié, vous devrez utiliser les nouveaux noms ici.
Vous pouvez maintenant cliquer sur "Enregistrer" et utiliser cette audience dans vos tests.
Qualtrics
Cela nécessite une interception pour l'affichage manuel avec un JavaScript personnalisé. Si vous ne disposez pas déjà d'une interception manuelle sur votre site, vous devrez créer une nouvelle interception d'application Web et de feedback et la connecter à l'enquête de votre choix. Vous devrez déployer le tag d'interception séparé pour que cela fonctionne.
Tealium Event Stream
Si vous utilisez un nom de profil différent de celui qui se trouve dans le Data Layer de Tealium, veuillez le fournir à CS.
Le nom du profil est inscrit ici :
Si vous souhaitez définir une source de données personnalisée, veuillez créer une source de données JavaScript, puis fournir à CS la key de la source de données.
Vérifier que ça fonctionne
Tester Live Signals
L'extension Chrome mentionnée ci-dessus, vous permet également de tester les signaux en direct que vous avez activés en activant cette option dans les options de l'extension :
Rendez-vous ensuite sur la page sur laquelle vous avez activé les signaux en direct et commencez à tester les signaux en essayant de les déclencher en fonction des différents comportements et seuils définis. Si vous avez besoin de modifier ces-derniers, informez-en notre équipe Support.
Une fois que vous aurez déclenché un signal en direct, il apparaîtra dans la fenêtre modale suivante qui s'affichera.
Notez que chaque signal n'est déclenché qu'une seule fois par session. Cela signifie si vous souhaitez retester un signal que vous avez déjà déclenché, vous devrez effacer les éléments de stockage de session.
Vérifier les données envoyées à Contentsquare si elles sont activées
Vous pouvez également vérifier que les données sont bien envoyées à l'aide de l'extension Chrome Contentsquare Tracking Setup Assistant.
Vous remarquerez que les valeurs envoyées sont généralement celles, soit de l'élément qui a déclenché le signal, soit de la page sur laquelle il a été déclenché, en fonction du signal déclenché. Vous pouvez ensuite filtrer les résultats selon les éléments spécifiques qui ont déclenché des signaux pour voir lesquels en ont déclenchés le plus. Vous pouvez également les regrouper à l'aide de regex (expressions régulières).
Si vous avez choisi d'envoyer les values en tant qu'événements de page, cela ressemblera à ceci.
Les événements de page apparaissent dans le flux d'événements de replay.
Une fois terminé, vous pourrez voir les résultats dans Contentsquare sous forme de variables dynamiques ou d'événements de page, en fonction de ce que vous aurez activé.
Vérifier les données envoyées aux partis tiers
Bloomreach Engagement
Dans votre compte Bloomreach, rendez-vous dans la section "Données et ressources" --> "Clients" pour accéder aux données des signaux en direct.
Braze
Dans votre compte Braze, vous pouvez voir les signaux dans la section "Événements personnalisés".
Ils seront également disponibles pour la planification de campagnes et le ciblage de segments :
Dynamic Yield
Dans votre compte Dynamic Yield, vous pouvez créer un public cible basé sur chaque signal en direct en accédant à la section "Audiences", puis en définissant une condition basée soit sur un déclencheur d'événement, soit sur un déclencheur d'événement par propriété. Si vous choisissez cette dernière option, il vous suffit de choisir l'événement Contentsquare Live Signal et de saisir manuellement le nom de la propriété du signal, par exemple rage_click_signal. La dénomination est basée sur les valeurs par défaut mentionnées plus haut dans ce document pour chaque signal. Si la valeur par défaut a été modifiée, utilisez la nouvelle convention de dénomination.
Gleap
Dans Gleap, vous pourrez voir les signaux s'afficher dans la section "Données personnalisées" de chaque workflow.
Ces données seront également disponibles dans les exports de données Gleap.
Google Analytics 4
Dans votre compte GA4, retrouvez les signaux dans la section "Temps réel" sous "Événements".
Ainsi que dans la vue globale des événements.
Et enfin, dans la vue "Explorer".
Intercom
Dans Intercom, vous verrez les signaux en direct dans la section "Propriétés utilisateurs du chat".
Karte
Si vous avez choisi Karte comme parti tiers vers lequel envoyer des signaux, vous les verrez comme ceci dans la section "Événements" :
LiveChat
Si vous avez choisi LiveChat, vous pourrez voir l'événement du signal affiché dans la section des variables personnalisées du chat.
LivePerson Conversational Cloud
Dans votre compte LivePerson, vous trouverez les signaux en direct dans la section "Contenu recherché" du chat et des rapports de chat.
Segment
Si vous avez choisi Segment comme parti tiers pour l'envoi des signaux, vous verrez ceci :
Sentry
Si vous avez choisi Sentry comme tiers pour envoyer des signaux, vous les verrez dans la section des "Problèmes" :
Tealium
Si vous avez choisi Tealium comme parti tiers pour envoyer des signaux, vous verrez ceci :
Zendesk Chat
Si c'est Zendesk Chat que vous avez choisi comme parti tiers, alors, lorsque qu'un signal est déclenché, la fenêtre de chat s'ouvrira pour le visiteur et ce-dernier verra ceci du côté de l'agent de chat :