Inviare i metadati
I metadati ti permettono di aggiungere informazioni extra sugli utenti ai session replay sotto forma di coppie chiave-valore. Questa funzione migliora la tua capacità di filtrare e cercare le registrazioni delle sessioni, rendendo più semplice individuare quelle rilevanti. Consulta questo tutorial per maggiori dettagli su come inviare i metadati.
Aggiungere chiavi di metadati a un progetto
Section titled Aggiungere chiavi di metadati a un progettoPer configurare le chiavi dei metadati:
- Vai a Preferences > Projects in OpenReplay.
- Scegli il progetto a cui vuoi aggiungere i metadati.
- Vai alla scheda Metadata
- Fai clic su Add Metadata.
- Inserisci il nome della chiave desiderata nel campo Field Name.
- Fai clic su Add per salvare la chiave dei metadati.

Limite: puoi aggiungere fino a 10 chiavi di metadati per progetto.
Inserire i metadati nei session replay
Section titled Inserire i metadati nei session replayUna volta definite le chiavi dei metadati, puoi inviare i metadati durante la registrazione delle sessioni. Di seguito trovi i metodi di implementazione disponibili:
1. Con NPM
Section titled 1. Con NPMInserisci i metadati all’avvio del tracker:
tracker.start({
userID: "john@doe.com",
metadata: {
balance: "10M",
plan: "free"
}
});
Se i metadati sono disponibili solo dopo l’avvio del tracker, usa il metodo setMetadata:
tracker.setMetadata('plan', 'free'); // after tracker.start()
2. Con lo snippet JavaScript
Section titled 2. Con lo snippet JavaScriptPer includere i metadati con lo snippet, modifica la variabile 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>
Se i metadati diventano disponibili in un secondo momento:
<script>
OpenReplay.setMetadata("plan", "free");
</script>
3. Con l’SDK per iOS
Section titled 3. Con l’SDK per iOSInserisci i metadati nella tua app iOS:
import ORTracker
ORTracker.shared.setMetadata(key: String, value: String)
Filtrare e cercare le sessioni con i metadati
Section titled Filtrare e cercare le sessioni con i metadatiLe chiavi dei metadati ti permettono di filtrare e cercare le sessioni in OpenReplay:
- Apri Omni-Search nella vista Sessions.
- Seleziona la chiave dei metadati (ad es.
plan). - Inserisci il valore dei metadati (ad es.
free) per filtrare le registrazioni delle sessioni.

Questa funzione consente di individuare in modo rapido e preciso le sessioni in base ai dettagli specifici dell’utente.
Hai domande?
Section titled Hai domande?Se hai domande su questa procedura, non esitare a contattarci su Slack.