Les événements personnalisés sont parfaits pour ajouter de l’intelligence en enregistrant des événements spécifiques à votre domaine en parallèle des relectures de session. OpenReplay utilise 2 types d’événements : fonctionnels (event) et techniques (issue). Tous les événements sont indexés pour faciliter la recherche et synchronisés avec les enregistrements de session.

Les événements fonctionnels sont indexés et facilitent la recherche d’enregistrements de session spécifiques. S’ils ont été correctement reçus par OpenReplay, ils seront disponibles en tant que filtres dans la barre omnisearch.

Utilisez la méthode event pour signaler des événements fonctionnels tels que order completed ou product added. Elle prend 2 paramètres : name (string) et payload (objet JS non récursif).

tracker.event('product_added', 'shoes'); // after tracker.start()

Vous trouverez ci-dessous un exemple montrant comment envoyer un événement fonctionnel à l’aide du snippet.

<!-- OpenReplay Tracking Code -->
<script>
var initOpts = { projectKey: "GxPpaDARdn2345fgt321" };
var startOpts = { userID: ""}; 
(function(A,s,a,y,e,r){
  r=window.OpenReplay=[e,r,y,[s-1, e]];
  s=document.createElement('script');s.src=A;s.async=!a;
  ...
})("//static.openreplay.com/latest/openreplay.js", 1, 0, initOpts, startOpts);
</script>
  ...
  __OPENREPLAY__.event('product_added', 'shoes'); // send a functional event later in your code
  ...

Les événements techniques sont affichés dans la relecture de session sous l’onglet Events des DevTools et sous forme d’annotations sur la lecture. Ils sont également pris en compte dans les Funnels pour corréler les baisses de conversion avec des problèmes techniques.

issue est utilisé pour envoyer des événements techniques, comme des erreurs, qui peuvent survenir dans votre stack ou d’autres systèmes en aval. issue prend 2 paramètres : name (string) et payload (objet JS non récursif).

tracker.issue('payment_error', {code: 500, context: 42}); // after tracker.start()

Vous trouverez ci-dessous un exemple montrant comment envoyer un événement technique à l’aide du snippet.

<!-- OpenReplay Tracking Code -->
<script>
var initOpts = { projectKey: "GxPpaDARdn2345fgt321" };
var startOpts = { userID: "" }; 
(function(A,s,a,y,e,r){
  r=window.OpenReplay=[e,r,y,[s-1, e]];
  s=document.createElement('script');s.src=A;s.async=!a;
  ...
})("//static.openreplay.com/latest/openreplay.js", 1, 0, initOpts, startOpts);
</script>
  ...
  __OPENREPLAY__.issue('payment_error', {code: 500, context: 42}); // send a technical event (issue) later in your code
  ...

import ORTracker

ORTracker.shared.event(name: String, payload: Encodable?)

Si vous cherchez un exemple pratique d’utilisation des événements personnalisés, consultez notre tutoriel détaillé ici.

Vous rencontrez des difficultés avec les événements personnalisés ? Connectez-vous à notre Slack ou consultez notre Forum et obtenez de l’aide auprès de notre communauté.