Des informations supplémentaires sur les utilisateurs peuvent être fournies au moyen de métadonnées (également appelées traits ou variables utilisateur). Elles prennent la forme de paires clé/valeur et sont utiles pour filtrer et rechercher des relectures de session spécifiques.

Les métadonnées doivent être spécifiées explicitement depuis le tableau de bord dans ‘Preferences > Metadata’. Vous pouvez ajouter jusqu’à 10 clés. Dans l’exemple ci-dessous, nous utilisons plan.

Une fois la ou les clés ajoutées (dans cet exemple plan), vous pouvez injecter les métadonnées au démarrage du tracker sous la forme d’une paire clé/valeur (string).

Injectez les métadonnées au démarrage du tracker (dans cet exemple plan).

const tracker = new OpenReplay({
  projectKey: PROJECT_KEY
});

tracker.start({
  userID: "john@doe.com",
  metadata: {
    balance: "10M",
    plan: "free"
  }
});

Si cela n’est pas possible (certaines ou toutes les métadonnées peuvent n’être définies/connues que plus tard dans le flux de navigation, soit bien après le démarrage du tracker), appelez alors la méthode setMetadata pour ce faire :

tracker.setMetadata('plan', 'free'); // after tracker.start()

Voici un exemple de la manière d’injecter les métadonnées (dans cet exemple plan) à l’aide du snippet. Notez la variable/ligne startOpts ajoutée, ainsi que le changement de paramètres dans la deuxième ligne.

<!-- OpenReplay Tracking Code -->
<script>
var initOpts = { projectKey: "GxPpaDARdn2345fgt321" };
var startOpts = { userID: getUserID(), metadata: { plan: getPlan()} } // use startOpts variable to inject metadata
(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;
  ...
})(0, "GxPpaDARdn2345fgt321", "//static.openreplay.com/3.5.0/openreplay.js",1,29);
</script>

Si cela n’est pas possible (les métadonnées sont connues plus tard dans le flux de navigation, soit bien après le démarrage du tracker), appelez plutôt la méthode setMetadata pour identifier vos utilisateurs. L’identité de l’utilisateur peut être modifiée à tout moment pendant la session en appelant setMetadata. Cependant, OpenReplay ne conservera que le dernier ID utilisateur injecté.

<!-- 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.setMetadata("plan", "free"); // set metadata later in your code
  ...

import ORTracker

ORTracker.shared.setMetadata(key: String, value: String)

Cliquer sur la barre d’omni-recherche affichera la liste des filtres disponibles, y compris la ou les clés de métadonnées que vous avez ajoutées. Vous pouvez désormais filtrer les enregistrements de sessions par n’importe quelle clé/valeur.

Les paires clé/valeur de métadonnées sont affichées sur la page de relecture de session, dans la carte d’identification de l’utilisateur. Les sessions ayant des valeurs de métadonnées similaires peuvent être trouvées en cliquant sur l’icône en forme de boucle.

Si vous avez des questions sur ce processus, n’hésitez pas à nous contacter sur notre Slack ou à consulter notre Forum.