Mit Metadaten können Sie Session Replays zusätzliche Informationen über Benutzer in Form von Schlüssel-Wert-Paaren hinzufügen. Dadurch lassen sich Sitzungsaufzeichnungen besser filtern und durchsuchen, sodass relevante Sitzungen leichter zu finden sind. Weitere Details zum Senden von Metadaten finden Sie in diesem Tutorial.

So richten Sie Metadaten-Schlüssel ein:

1. Öffnen Sie in OpenReplay Preferences > Projects.
2. Wählen Sie das Projekt aus, dem Sie Metadaten hinzufügen möchten.
3. Öffnen Sie den Tab „Metadata“
4. Klicken Sie auf Add Metadata.
5. Geben Sie den gewünschten Schlüsselnamen in das Feld Field Name ein.
6. Klicken Sie auf Add, um den Metadaten-Schlüssel zu speichern.

Limit: Sie können pro Projekt bis zu 10 Metadaten-Schlüssel hinzufügen.

Sobald Ihre Metadaten-Schlüssel definiert sind, können Sie beim Aufzeichnen von Sitzungen Metadaten senden. Dafür stehen die folgenden Implementierungsmethoden zur Verfügung:

Übergeben Sie die Metadaten beim Start des Trackers:

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

Sind die Metadaten erst nach dem Start des Trackers verfügbar, verwenden Sie die Methode setMetadata:

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

Um Metadaten über das Snippet zu übergeben, passen Sie die Variable startOpts an:

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

Wenn die Metadaten erst später verfügbar werden:

<script>
  OpenReplay.setMetadata("plan", "free");
</script>

Übergeben Sie die Metadaten in Ihrer iOS-App:

import ORTracker

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

Mit Metadaten-Schlüsseln können Sie Sitzungen in OpenReplay filtern und durchsuchen:

1. Öffnen Sie die Omni-Search in der Ansicht „Sessions“.
2. Wählen Sie Ihren Metadaten-Schlüssel aus (z. B. plan).
3. Geben Sie den Metadatenwert ein (z. B. free), um die Sitzungsaufzeichnungen zu filtern.

Mit dieser Funktion lassen sich Sitzungen schnell und präzise anhand benutzerspezifischer Details identifizieren.

Wenn Sie Fragen zu diesem Vorgang haben, wenden Sie sich gerne über unseren Slack an uns.