Suivre des événements

Une fois le tracker installé, beaucoup de choses sont collectées sans une ligne de code : pageviews, profondeur de défilement, erreurs JavaScript et, si vous laissez l'autocapture activée, chaque clic significatif. Cette page présente ce qui est automatique, ce que vous pouvez ajouter vous-même, et comment lire les signaux de frustration.

Pageviews

Un pageview est enregistré avec l'URL complète, le chemin, le referrer et le titre de la page. Son déclenchement dépend de la façon dont vous avez installé le tracker :

Applications monopages

Avec la balise script, le tracker enveloppe les fonctions d'historique du navigateur et écoute les boutons précédent et suivant. Un nouveau pageview n'est envoyé que lorsque le chemin change. Un changement de query string ou de #hash seul ne compte pas comme une nouvelle page.

Lorsqu'un visiteur passe à une autre page, le tracker envoie aussi les données de défilement de la page qu'il quitte et, si le replay est activé, démarre un nouvel instantané pour le nouveau chemin. C'est ce qui permet aux heatmaps et aux replays d'afficher chaque page séparément.

Événements personnalisés

Utilisez un événement personnalisé pour compter ce que le tracker ne peut pas deviner : une inscription, un changement d'affichage de tarifs, un téléchargement de fichier.

// Script tag
window.klickbee.track("signup_clicked", { plan: "pro" });

// npm package
tracking.track("signup_clicked", { plan: "pro" });

Règles à connaître :

• Le nom est une chaîne d'au plus 255 caractères.
• Les propriétés sont facultatives et doivent être plates : chaque valeur est une chaîne, un nombre, un booléen ou null. Les objets imbriqués et les tableaux ne sont pas acceptés.
• Les noms qui commencent par $ sont réservés aux événements propres au tracker ($scroll, $deadclick, $ragescroll, $error, $experiment). Ne les utilisez pas pour les vôtres.
• Utilisez des noms stables et en minuscules, comme signup_completed. Les goals et les funnels font correspondre les noms à l'identique, majuscules et minuscules comprises.

Vous retrouverez vos événements à plusieurs endroits du dashboard :

• Overview : la liste Top events.
• Live events : un flux en temps réel de ce qui est capturé.
• Sessions : la chronologie des événements d'une session.
• Funnels : sous forme d'étapes Event.
• Goals : sous forme de goals de type Event.

Les événements peuvent aussi porter une valeur et une devise à destination des plateformes publicitaires : trackez purchase avec { value: 49.9, currency: "EUR" }, puis faites pointer un mapping de conversion sur ces deux propriétés. Voir Conversions.

Autocapture : des clics sans code

Lorsque l'autocapture est activée, le tracker enregistre les clics sur les boutons, les liens et les autres éléments interactifs, sans aucun code de votre côté. Pour chaque clic, il conserve le sélecteur CSS de l'élément, son texte visible ou son libellé, la cible du lien et l'endroit de la page où le clic a eu lieu.

• Balise script : l'autocapture est activée sauf si vous définissez data-autocapture="false".
• Package npm : l'autocapture est désactivée sauf si vous définissez autocapture: true.

L'autocapture alimente la heatmap des clics, les goals de clic (voir Goals), le flux Live events (type « autocapture ») et trois des signaux de frustration ci-dessous. Les heatmaps ont aussi besoin du replay activé, car l'image de la page provient d'un enregistrement.

Le texte visible ou accessible de l'élément est capturé, jusqu'à 255 caractères. Les marqueurs data-kb-mask et data-kb-block décrits dans Confidentialité et consentement ne s'appliquent qu'au replay de session, pas à l'autocapture des clics. Si le texte d'un élément cliquable peut contenir des informations personnelles (un nom, une adresse e-mail), donnez-lui un aria-label sans donnée personnelle, qui sera capturé à la place du texte, ou désactivez l'autocapture.

Identifier vos visiteurs

Appelez identify dès que vous savez qui est la personne, typiquement après la connexion :

window.klickbee.identify("user_1234", { plan: "pro" });

À partir de là, ses sessions portent cet identifiant : il est affiché sur la page de session et dans le flux en direct, ce qui vous permet de retrouver les sessions d'un client donné. Appelez reset() à sa déconnexion pour que la personne suivante sur le même navigateur ne soit pas confondue avec lui.

Signaux de frustration

Klickbee détecte les moments où un visiteur peine, puis les affiche dans la liste Sessions, sur la page de session et sur la timeline du replay.

Chaque session reçoit un badge Frustration. Survolez-le pour voir le détail, par exemple « 3 rage · 1 dead · 1 U-turn ». Sur la page Sessions, le filtre Frustration only ne conserve que les sessions qui contiennent au moins un signal. Voir Sessions et heatmaps.

Erreurs JavaScript

Sauf si vous le désactivez avec captureErrors: false (package npm), le tracker enregistre les erreurs non interceptées et les rejets de promesses non gérés sous forme d'événements $error. Pour protéger votre quota et vos données, un message est tronqué à 255 caractères, les erreurs identiques répétées sont ignorées, et 10 au maximum sont envoyées par page.

Variantes de test A/B (package npm)

Si vous menez un test côté front, tracking.experiment("pricing_test", "b") enregistre la variante qu'un visiteur a vue. La page Experiments, sous Variant test, compare ensuite les variantes par rapport à un goal. Cette méthode n'est pas disponible sur window.klickbee : elle nécessite donc le package npm.

Pour aller plus loin

• Goals : transformez pageviews, événements et clics en conversions.
• Funnels, parcours et rétention
• Dépannage