元数据允许你以键值对的形式向会话回放中添加有关用户的额外信息。此功能增强了你筛选和搜索会话录制的能力，使识别相关会话更加容易。 有关如何发送元数据的更多详情，请参阅此教程。

要设置元数据键：

1. 在 OpenReplay 中导航到 Preferences > Projects。
2. 选择你想要添加元数据的项目。
3. 导航到 Metadata 选项卡。
4. 点击 Add Metadata。
5. 在 Field Name 输入框中输入所需的键名。
6. 点击 Add 以保存元数据键。

限制： 每个项目最多可以添加 10 个元数据键。

定义元数据键后，你可以在录制会话时发送元数据。以下是可用的实现方法：

在启动 tracker 时注入元数据：

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

如果元数据仅在 tracker 启动后才可用，请使用 setMetadata 方法：

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

要在代码片段中包含元数据，请修改 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>

如果元数据稍后才可用：

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

在你的 iOS 应用中注入元数据：

import ORTracker

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

元数据键允许你在 OpenReplay 中筛选和搜索会话：

1. 在 Sessions 视图中打开 Omni-Search。
2. 选择你的元数据键（例如 plan）。
3. 输入元数据值（例如 free）以筛选会话录制。

此功能可根据用户特定的详细信息快速、精确地识别会话。

如果你对此流程有任何疑问，欢迎通过我们的 Slack 联系我们，或查看我们的论坛。