Os metadados permitem adicionar informações extras sobre os usuários aos session replays na forma de pares chave-valor. Esse recurso amplia sua capacidade de filtrar e pesquisar gravações de sessões, facilitando a identificação das sessões relevantes. Consulte este tutorial para mais detalhes sobre como enviar metadados.

Para configurar chaves de metadados:

1. Acesse Preferences > Projects no OpenReplay.
2. Escolha o projeto ao qual você deseja adicionar metadados.
3. Acesse a aba Metadata
4. Clique em Add Metadata.
5. Digite o nome da chave desejada no campo Field Name.
6. Clique em Add para salvar a chave de metadados.

Limite: Você pode adicionar até 10 chaves de metadados por projeto.

Depois que suas chaves de metadados estiverem definidas, você pode enviar metadados ao gravar sessões. Estes são os métodos de implementação disponíveis:

Injete os metadados ao iniciar o tracker:

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

Se os metadados só estiverem disponíveis depois que o tracker iniciar, use o método setMetadata:

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

Para incluir metadados com o snippet, modifique a variável 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 os metadados ficarem disponíveis mais tarde:

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

Injete os metadados no seu app iOS:

import ORTracker

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

As chaves de metadados permitem filtrar e pesquisar sessões no OpenReplay:

1. Abra a Omni-Search na visualização Sessions.
2. Selecione sua chave de metadados (ex.: plan).
3. Digite o valor do metadado (ex.: free) para filtrar as gravações de sessões.

Esse recurso permite identificar sessões de forma rápida e precisa com base em detalhes específicos do usuário.

Se você tiver alguma dúvida sobre este processo, fique à vontade para falar conosco no nosso Slack .