Inviare i metadati

Come passare i metadati dell'utente a OpenReplay. Noti anche come trait o variabili utente in altre piattaforme.

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 progetto

Per configurare le chiavi dei metadati:

  1. Vai a Preferences > Projects in OpenReplay.
  2. Scegli il progetto a cui vuoi aggiungere i metadati.
  3. Vai alla scheda Metadata
  4. Fai clic su Add Metadata.
  5. Inserisci il nome della chiave desiderata nel campo Field Name.
  6. Fai clic su Add per salvare la chiave dei metadati.
Inviare i 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 replay

Una volta definite le chiavi dei metadati, puoi inviare i metadati durante la registrazione delle sessioni. Di seguito trovi i metodi di implementazione disponibili:

Inserisci 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()

Per 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>

Inserisci 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 metadati

Le chiavi dei metadati ti permettono di filtrare e cercare le sessioni in OpenReplay:

  1. Apri Omni-Search nella vista Sessions.
  2. Seleziona la chiave dei metadati (ad es. plan).
  3. Inserisci il valore dei metadati (ad es. free) per filtrare le registrazioni delle sessioni.
Filtrare i metadati

Questa funzione consente di individuare in modo rapido e preciso le sessioni in base ai dettagli specifici dell’utente.

Se hai domande su questa procedura, non esitare a contattarci su Slack.