Les événements représentent les actions entreprises par un utilisateur sur votre site. Ces événements sont définis et transmis à Contentsquare via votre code côté client via l'API Voice of Customer Events.
Avec JavaScript, vous pouvez définir vos propres critères pour déterminer le type d'action qui entraîne l'envoi d'un événement. L'événement peut être envoyé dès le chargement de la page, lorsqu'une modale apparaît ou lorsqu'un utilisateur voit une variante spécifique de votre page via un test A/B.
L'appel API Événements
Vous trouverez ci-dessous le format de base pour un appel à l'API Events :
hj('event', 'action_name');- Le premier paramètre doit toujours contenir la valeur de chaîne événement.
- Le deuxième paramètre est le nom personnalisé attribué à votre événement. Dans l'exemple ci-dessus, le nom de l'événement est action_name, mais vous pouvez choisir n'importe quel nom. (Exemple : 'opened_modal', 'shown_variant_a', etc.)
Vous trouverez ci-dessous un exemple d'envoi d'un événement que vous pouvez utiliser pour déclencher une enquête lorsqu'un utilisateur clique sur un bouton "S'abonner".
hj('event', 'subscribe_to_email_list');Soyez conscient des limitations lors de la mise en œuvre d'événements
-
Nommer vos événements.
Le nom de l'événement ne doit pas dépasser 250 caractères et ne peut contenir que les éléments suivants : caractères alphanumériques (az, AZ, 0-9), espaces, traits de soulignement (_), tirets (-), points (.), deux-points. (:) et barres obliques (/).
-
Il existe une limite de 10 000 événements uniques par site.
Nous prenons en charge 10 000 événements uniques par site, avec un nombre illimité d'utilisateurs associés à ces événements. Si vous dépassez cette limite, seuls 10 000 événements parmi les plus utilisés (triés de 0 à 9, aZ) seront disponibles.
-
Il n'est actuellement pas possible de transmettre des propriétés d'événement avec l'événement.
Bonnes pratiques
-
Ne transmettez pas d'informations d'identification personnelle sous forme d'événement.
Les informations d'identification personnelle (PII) ne doivent jamais être utilisées comme événements. Si vous souhaitez connecter des données à des utilisateurs spécifiques, vous devrez employer les attributs utilisateur à la place.
-
Si vous effectuez également des appels d'API d'identification, ceux-ci doivent être exécutés avant les appels d'API d'événement.
Peut-être souhaitez-vous combiner les événements avec un ciblage basé sur les attributs utilisateurs pour déclencher une enquête. Pour cela, vous devrez vous assurer que l'appel d'API d'identification a lieu avant l'appel d'API d'événement dans l'ordre d'exécution, en gardant à l'esprit tous les appels asynchrones vers d'autres services. Si l’appel d’API d’événement est exécuté avant la fin de l’appel d’API d’identification, l’enquête ne s’affichera pas.
-
Les événements ne peuvent pas être utilisés pour collecter des adresses e-mail ou IP, ni des numéros à 9 chiffres ou plus.
Puisqu'il n'existe actuellement aucun moyen d'utiliser notre outil de recherche d'utilisateurs avec les événements, ils ne peuvent pas être utilisés pour collecter des e-mails, des adresses IP ou des numéros composés de 9 chiffres ou plus afin d'empêcher la transmission de numéros de carte de crédit à Contentsquare. Cette décision se base sur le Règlement Général sur la Protection des Données (RGPD). Si vous souhaitez collecter des adresses e-mail avec le consentement de votre utilisateur et conformément au RGPD, vous pouvez le faire via les attributs utilisateurs .
-
Le tag Contentsquare doit être chargé avant d'envoyer des événements.
L'objet hj() n'est pas accessible tant que le tag Contentsquare n'est pas exécuté sur la page. Si le script appelant l'API Events est ajouté avant votre tag Contentsquare, il y aura une erreur et l'événement ne sera pas reconnu. Si, pour une raison quelconque, l'API Event est accessible avant l'exécution du tag Contentsquare, vous pouvez ajouter la ligne de code suivante avant que le code de l'API Event ne soit appelé :
window.hj=window.hj||function() {(hj.q=hj.q||[]).push(arguments);} ; -
Pour les sites de commerce électronique, évitez d'envoyer des informations spécifiques sur les produits.
Cela inclut des informations telles que les codes SKU. Habituellement, les URL sont plus utiles et sont capturées par défaut.
-
Soyez prudent lorsque vous envoyez des valeurs à partir d'objets tels que des couches de données GTM.
Ceux-ci contiennent souvent plus de données que prévu.
- Évitez de transmettre des informations telles que des dates ou des horodatages.
- Évitez de transmettre quoi que ce soit provenant d'URL, tels que des codes de parrainage.
- Évitez de transmettre des logs d'erreurs détaillés.
Événements de test
Suivre les étapes ci-dessous vous permettra de confirmer si vos appels d'API d'évènements sont bien reçus par Contentsquare. Si vous n'êtes pas familier avec la console de votre navigateur ou avec les outils de développement, envisagez de faire appel à un membre de votre équipe qui connaît mieux ces outils ou à un développeur Web pour vous aider.
1. Activez les logs de débogage Hotjar dans la console de votre navigateur.
Ouvrez la page sur laquelle vous souhaitez tester l'événement et ajoutez le paramètre ?hjDebug=1 à la fin de l'URL. Voici quelques exemples de ce à quoi cela pourrait ressembler :
https://www.example.com/?hjDebug=1
OU
https://www.example.com/?utm_1234&hjDebug=1
2. Ouvrez la console de votre navigateur.
Si vous n'êtes pas familier avec les outils de développement de votre navigateur ou avec la console, consultez ce guide pour découvrir comment ouvrir la console de votre navigateur.
3. Déclenchez l'événement manuellement.
Pour déclencher votre événement manuellement, ajoutez le code de l'API d'événement dans la console de votre navigateur et appuyez sur "Entrée" ou "Retour" sur votre clavier. Si l'événement se déclenche avec succès, vous verrez un log de confirmation semblable à celui-ci :
Nous vous recommandons également de suivre les étapes que vos utilisateurs suivent pour déclencher l'événement automatiquement. Si l'événement se déclenche bien automatiquement, vous saurez alors avec certitude que votre code a été implémenté avec succès.
Si un événement est détecté lorsqu'on le déclenche manuellement, mais pas qu'il ne se déclenche pas automatiquement lors du test du parcours utilisateur, vous devrez peut-être revoir votre code et vos critères déterminant le moment où l'appel de l'API d'événement est envoyé.