Les événements représentent des actions qu'un utilisateur a effectuées sur votre site. Ces événements sont définis et transmis à Contentsquare via votre code côté client par le biais de l'API Événements.
Avec JavaScript, vous pouvez configurer vos propres critères pour déterminer quel type d'action entraîne l'envoi d'un événement vers nous. L'événement peut être envoyé dès que la page se charge, lorsqu'un modal apparaît, ou lorsqu'un utilisateur voit une variation spécifique de votre page à travers un test A/B.
L'appel de l'API Événements
Voici le format de base pour un appel à l'API Événements :
window._uxa.push(["event", "eventName"]);- Le premier paramètre doit toujours contenir la valeur de chaîne event.
- 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 cela peut être n'importe quoi que vous choisissez. (Exemple : 'opened_modal', 'shown_variant_a', etc.)
Voici un exemple d'envoi d'un événement que vous pouvez utiliser pour déclencher un sondage lorsqu'un utilisateur clique sur un bouton S’abonner :
window._uxa.push(["event", "subscribed_to_email_list"]);Soyez conscient des limitations lors de la mise en œuvre des é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 (a-z, A-Z, 0-9), espaces, traits de soulignement (_), tirets (-), points (.), deux-points (:) et barres obliques (/).
-
Il y a une limite de 10 000 événements uniques par site
Nous supportons 10 000 événements uniques par site, avec un nombre illimité d'utilisateurs associés à ces événements. Si vous dépassez cela, seuls 10 000 des événements les plus utilisés (triés de 0 à 9, a à Z) seront disponibles.
-
Il n'est actuellement pas possible de passer des propriétés d'événement avec l'événement.
Bonnes pratiques
-
Ne pas transmettre d'informations personnelles identifiables en tant qu'événement
Les informations personnelles identifiables (PII) ne doivent jamais être utilisées comme événements. Si vous souhaitez connecter des données avec des utilisateurs spécifiques, vous devriez explorer la fonctionnalité Caractéristiques de l’utilisateur à la place.
-
Si vous effectuez également des appels à l'API d'Identification, ceux-ci doivent être exécutés avant les appels à l'API Événements
Vous voudrez peut-être combiner les événements avec le ciblage basé sur Caractéristiques de l’utilisateur pour déclencher un sondage. Pour configurer cela, l'ordre d'exécution nécessite que l'appel à l'API d'Identification se fasse avant l'appel à l'API Événements, en gardant à l'esprit tout appel asynchrone à d'autres services. Si l'appel à l'API Événements est exécuté avant que l'appel à l'API d'Identification ait terminé son exécution, le sondage ne s'affichera pas.
-
Les événements ne peuvent pas être utilisés pour collecter des adresses e-mail ou des adresses IP, ou des numéros de 9 chiffres ou plus
Étant donné qu'il n'existe actuellement aucun moyen d'utiliser notre outil de recherche de l'utilisateur avec des événements, ils ne peuvent pas être utilisés pour collecter des e-mails, des adresses IP ou des numéros de 9 chiffres ou plus afin d'éviter que des numéros de carte de crédit ne soient transmis à Contentsquare. Cette décision a été prise sur la base du 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 avec Caractéristiques de l’utilisateur.
-
Pour les sites e-commerce, évitez d'envoyer des informations spécifiques sur les produits
Cela inclut des informations telles que les codes SKU. En général, les URL sont plus utiles et sont capturées par défaut.
-
Faites attention lorsque vous envoyez des valeurs provenant d'objets tels que les couches de données GTM
Celles-ci contiennent souvent plus de données que vous ne le pensez.
- Évitez de transmettre quoi que ce soit comme des dates ou des horodatages
- Évitez de transmettre quoi que ce soit provenant d'URL telles que des codes de parrainage
- Évitez de transmettre des journaux d'erreurs détaillés
Tester les événements
Suivre les étapes ci-dessous vous permettra de confirmer si vos appels à l'API Événements sont reçus avec succès par Contentsquare. Si vous n'êtes pas familier avec la console de votre navigateur ou les outils de développement, envisagez d'impliquer un membre de l'équipe qui a plus de connaissances sur ces outils ou un développeur web pour vous aider.
1. Permettre les journaux de débogage dans la console de votre navigateur.
Ouvrez la page où vous souhaitez tester l'événement et ajoutez le ?hjDebug=1 paramètre à la fin de l'URL. Voici quelques exemples de ce à quoi cela pourrait ressembler :
https://www.example.com/?hjDebug=1https://www.example.com/?utm_1234&hjDebug=12. Ouvrez la console de votre navigateur.
Si vous n'êtes pas familier avec les outils de développement de votre navigateur, ou la console, consultez ce guide pour apprendre 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 Événements dans la console de votre navigateur et appuyez sur Entrée ou Retour sur votre clavier. Si l'événement a été déclenché avec succès, vous verrez un journal de confirmation similaire à :
COMMAND: Processing command: event example_action
Nous vous recommandons également de suivre les étapes que votre utilisateur suivrait, pour déclencher l'événement automatiquement. Si l'événement est déclenché automatiquement, alors vous saurez que votre code est mis en œuvre avec succès.
Si le même événement est détecté lorsqu'il est déclenché manuellement, mais pas automatiquement lors du test du parcours utilisateur, alors vous devrez peut-être revoir votre code et les critères qui déterminent quand l'appel API de l'événement est envoyé.