Envoyer des métadonnées
Les métadonnées vous permettent d’ajouter des informations supplémentaires sur les utilisateurs aux rejeux de session sous forme de paires clé-valeur. Cette fonctionnalité améliore votre capacité à filtrer et rechercher des enregistrements de session, ce qui facilite l’identification des sessions pertinentes. Consultez ce tutoriel pour plus de détails sur la façon d’envoyer des métadonnées.
Ajouter des clés de métadonnées à un projet
Section titled Ajouter des clés de métadonnées à un projetPour configurer les clés de métadonnées :
- Accédez à Preferences > Projects dans OpenReplay.
- Choisissez le projet auquel vous souhaitez ajouter des métadonnées.
- Accédez à l’onglet Metadata.
- Cliquez sur Add Metadata.
- Saisissez le nom de clé souhaité dans le champ Field Name.
- Cliquez sur Add pour enregistrer la clé de métadonnées.

Limite : Vous pouvez ajouter jusqu’à 10 clés de métadonnées par projet.
Injecter des métadonnées dans les rejeux de session
Section titled Injecter des métadonnées dans les rejeux de sessionUne fois vos clés de métadonnées définies, vous pouvez envoyer des métadonnées lors de l’enregistrement des sessions. Voici les méthodes d’implémentation disponibles :
1. En utilisant NPM
Section titled 1. En utilisant NPMInjectez les métadonnées au démarrage du tracker :
tracker.start({
userID: "john@doe.com",
metadata: {
balance: "10M",
plan: "free"
}
});
Si les métadonnées ne sont disponibles qu’après le démarrage du tracker, utilisez la méthode setMetadata :
tracker.setMetadata('plan', 'free'); // after tracker.start()
2. En utilisant le snippet JavaScript
Section titled 2. En utilisant le snippet JavaScriptPour inclure des métadonnées avec le snippet, modifiez la variable startOpts :
<!-- OpenReplay Tracking Code -->
<script>
var initOpts = {
projectKey: "project_key",
defaultInputMode: 2,
obscureTextNumbers: false,
obscureTextEmails: true,
};
const yourMetadata = { yourKey: 'yourValue' };
var startOpts = { userID: "", metadata: yourMetadata };
(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>
Si les métadonnées deviennent disponibles plus tard :
<script>
OpenReplay.setMetadata("plan", "free");
</script>
3. En utilisant le SDK iOS
Section titled 3. En utilisant le SDK iOSInjectez des métadonnées dans votre application iOS :
import ORTracker
ORTracker.shared.setMetadata(key: String, value: String)
Filtrer et rechercher des sessions avec les métadonnées
Section titled Filtrer et rechercher des sessions avec les métadonnéesLes clés de métadonnées vous permettent de filtrer et de rechercher des sessions dans OpenReplay :
- Ouvrez l’Omni-Search dans la vue Sessions.
- Sélectionnez votre clé de métadonnées (par exemple,
plan). - Saisissez la valeur de la métadonnée (par exemple,
free) pour filtrer les enregistrements de session.

Cette fonctionnalité permet d’identifier rapidement et précisément les sessions en fonction de détails spécifiques à l’utilisateur.
Des questions ?
Section titled Des questions ?Si vous avez des questions sur ce processus, n’hésitez pas à nous contacter sur notre Slack ou à consulter notre Forum.