跳到主要内容

了解 Command Center Analytics

快速设置

大多数酒店会在 3 分钟内查看 Completion Rate、Biggest Drop‑Off 和 Issues。

本指南说明 AVA 如何计算 Command Center 中的每个 Analytics 图表，以及你可能会看到的额外入住覆盖卡片。

前往： Main Menu → Command Center → Analytics

为 Codex 或 Claude 复制 MCP 配置​

快速设置

这一步不到 1 分钟。令牌有效期很短，并使用你当前的浏览器会话。

当你想把 Analytics 数据发送给 AI 客户端时，请使用这些按钮。 复制出的令牌还包含完整的 Streamliner MCP 范围。 受支持的客户端在重启后可以使用设置工具。 复制完成后，AVA 会显示一个针对该客户端的弹窗，并提供粘贴说明。

按钮复制内容适用场景
Copy Codex MCP Config带有 mcp_servers.streamliner 的 TOML MCP 配置Codex
Copy Claude MCP Config带有 mcpServers.streamliner 的 JSON MCP 配置Claude Code 或 Claude Desktop

  1. 前往 Main Menu → Command Center → Analytics。

  2. 点击 Copy Codex MCP Config 或 Copy Claude MCP Config。

  3. 等待按钮变为 Creating MCP token...。

  4. 阅读对应客户端的弹窗说明。

  5. 将复制的配置粘贴到你的 AI 客户端配置文件中。

  6. 重启客户端，让它加载新的 MCP 服务器。

    ✓ Claude 配置使用 JSON。 ✓ Codex 配置使用 TOML。 ✓ 两种配置都包含一个短期有效的 STREAMLINER_MCP_TOKEN。

只使用新的令牌

如果你在这次改动前复制过令牌，请重新复制一份最新配置。 旧令牌会保留之前的权限范围，直到你刷新它们。

各自的粘贴位置

Codex 使用 ~/.codex/config.toml。

Claude 使用 Claude Desktop Developer 配置，通常是 claude_desktop_config.json。

弹窗会显示什么​

弹窗会确认你已成功复制配置。 随后会显示该客户端的文件路径、粘贴位置和重启步骤。

如果你使用的是 Codex

  1. 在运行 Codex 的机器上打开 ~/.codex/config.toml。

  2. 将复制的 TOML 块粘贴到文件顶层。

  3. 保存文件，然后重启 Codex。

    ✓ 如果 mcp_servers.streamliner 已存在，请替换那一段。

如果你使用的是 Claude Desktop

  1. 打开 Claude Desktop。

  2. 前往 Settings → Developer → Edit Config。

  3. 将复制的 JSON 粘贴到 claude_desktop_config.json。

  4. 保存文件，然后完全退出并重新打开 Claude Desktop。

    ✓ 在 macOS 上，该文件通常位于 ~/Library/Application Support/Claude/。 ✓ 如果 mcpServers 已存在，只合并 streamliner 项。

快速参考​

视图统计为一个会话的条件完成规则
Pre‑Arrival任何到达 Pre‑Arrival 步骤的预订PRE_ARRIVAL 成功
Check‑In → All任何包含入住流程步骤的预订（包括提前入住或预注册），不含仅限 Pre‑Arrival 的预订CHECKIN、KEY_COLLECTION 或 GET_DOOR_LOCK_KEY
Check‑In → Early Check‑InEARLY_CHECKIN_ATTEMPT 或 ROOM_ASSIGNMENT_QUEUEDEARLY_CHECKIN_ATTEMPT 或 ROOM_ASSIGNMENT_QUEUED 成功
Check‑In → Pre‑Registration任何包含 Pre‑Registration 步骤的预订PRE_REGISTRATION 成功
Check‑In → Full Check‑InCHECKIN、KEY_COLLECTION 或 GET_DOOR_LOCK_KEYCHECKIN、KEY_COLLECTION 或 GET_DOOR_LOCK_KEY 成功
Check‑Out任何包含退房步骤的预订CHECKOUT 或 COMPLETED_CHECKOUT_PAYMENT 成功

打开 Analytics 并选择视图​

入住/退房 Analytics 仪表盘

  1. 前往 Main Menu → Command Center。

  2. 选择 Analytics 选项卡。

  3. 选择 Pre‑Arrival、Check‑In 或 Check‑Out。

  4. 如果选择 Check‑In，请使用子选项卡：All Check‑Ins、Early Check‑In、Pre‑Registration 或 Full Check‑In。

    ✓ 所有图表都会更新为对应视图和日期范围。

AVA 如何构建会话​

  • 会话 指一条预订入住记录，不是每位客人各算一次。
  • 当至少记录到该视图中的一个步骤时，该会话就会被纳入统计。
  • 失败步骤仍会计入总数，这样你可以看到流失和问题。
Pre‑Arrival 是单独统计的

Pre‑arrival 会话不会计入 All Check‑Ins。如需查看这些会话，请使用 Pre‑Arrival 视图。

汇总卡片（选项卡顶部）​

卡片计算方式
Total Logs所选视图中的会话数量
Completion Rate已完成会话 ÷ 总日志数
Avg Completion Time从第一个成功步骤（通常是 Entry）到完成的时间
Successful Check‑Ins / Check‑Outs该视图中已完成会话的数量

什么算完成 取决于当前视图（请参见快速参考表）。

在比较时间段之前，请用这张表确认哪些会话计入完成。

示例

如果 Total Logs 是 40，而 Successful Check‑Ins 是 28，那么完成率就是 70%。

入住覆盖卡片​

当 AVA 从你的 PMS 收到覆盖数据时，你可能会在 Completion Rate 之后看到两张额外卡片。 这适用于 AVA PMS、Cloudbeds、Opera、Mews 和 eZee。

卡片显示内容重要原因
Eligible Check-In Units所选期间内不同的确认号或子预订单元这是覆盖分母
AVA Check-In Share至少被 AVA 处理过一次的合格单元百分比这显示该期间 AVA 的采用情况
单元 vs 预订

这些卡片统计的是单元，不是整笔预订。 一笔多房间预订可能会增加多个合格单元。

截断的会话映射

如果 AVA 将 sessionsMapMeta.truncated 标记为 true，它会忽略该不完整映射。 随后会在可用时使用完整入住日志来计算占比。 如果 AVA 无法获取完整日志，覆盖卡片会保持隐藏。

AVA 会把每个已处理的预订只计算一次。 它会在会话映射完整时使用该映射。 如果会话映射缺失或被截断，它会改用原始日志标识。 这样可以让 AVA Check-In Share 与预订覆盖保持一致。 它应当保持在 100% 或以下。

新结果可能会短暂延迟

如果你再次刷新相同日期范围，AVA 可能会在短时间内复用上一次的覆盖结果。 这样可以让 Analytics 选项卡在重复查看时保持快速。

Check-In Share 看起来不对​

你看到的情况： AVA Check-In Share 高于预期。

修复：

  1. 刷新 Analytics 选项卡。
  2. 确认日期范围与 PMS 报表一致。
  3. 检查你的酒店是否使用受支持的 PMS。
  4. 如果仍然不对，请附上截图联系支持团队。

如果你没有看到这些卡片，当前 PMS 数据可能不包含单元覆盖指标。 不受支持的 PMS 提供商不会显示这些卡片。

漏斗图（流失与步骤耗时）​

漏斗图显示到达每个步骤的会话百分比。

  • Drop‑off 将每个步骤与前一步进行比较。
  • Avg Stage Duration 表示在该阶段中停留的时间，从阶段开始到阶段成功。
  • Avg Time to Next Step 表示从一个成功步骤到下一个成功步骤的时间。
  • Slowest Step 卡片优先使用阶段耗时。
  • 如果 AVA 没有阶段计时，会回退到下一步耗时。
  • 如果后一步早于前一步发生，持续时间会显示为 0。

使用 Biggest Drop‑Off 卡片先找出最需要培训的步骤。

示例

如果 Document Upload 有 60 个会话，而前一步有 100 个，那么流失率就是 40%。 如果 Document Upload 本身耗时 20 秒，那么 Avg Stage Duration 就是 20 秒。 如果 Document Upload 在 10:05 完成，而 Validation 在 10:07 完成，那么 Avg Time to Next Step 就是 2 分钟。

时间分析（按小时）​

时间分析会按所选视图中的第一个成功步骤对会话分组。

  • 使用酒店时区。
  • Pre‑Arrival 需要 PRE_ARRIVAL 成功。
  • 会显示 Peak Hours 和 Rush Periods，帮助安排人员。

使用 Peak Hours 规划你最繁忙时间段的值守。

示例

如果某个会话在当地时间 7:10 首次成功，它会计入 07:00 这一小时。

问题（最近失败）​

问题会列出最近失败步骤最多的会话。

  • AVA 会检查最近 10 个事件中的失败情况。
  • 如果最近没有失败，它会使用记录中的最近一次失败。

使用 View Details 查看完整步骤历史。

示例

如果某次支付在 3:12 失败，而之前步骤都成功，那么问题会显示为 Payment，时间为 3:12。 如果最近 10 个事件都成功，AVA 会显示记录中的最近一次失败。

最近活动​

最近活动会显示已成功或失败的关键步骤，例如：

  • Check‑In、Check‑Out
  • Room Assignment
  • Pre‑Registration
  • Identity Verification
  • Payment

这个列表最多显示最近 30 条。

使用这个列表确认最近完成的是哪些步骤。

示例

你可能会看到“Check‑In completed successfully”，或者看到 Identity Verification 的失败消息。

最终步骤分布（会话结束位置）​

此图会把每个会话的最后一步归入不同类别：

  • Success - 完成步骤
  • Timing - 提前入住步骤（包括 Room Queued）
  • Partial - 预注册
  • Room - 房间分配步骤（Room Assignment）
  • Documentation - 证件或身份证验证
  • Payment - 支付步骤
  • Early - Entry / Fetch 步骤

如果失败发生在最后一次成功之后，那么失败步骤会成为最终步骤。

使用这张图查看最常见的停止点。

示例

在 50 个会话中，20 个结束于 Check‑In（success），10 个结束于 Early Check‑In（timing）， 8 个结束于 Document Upload（documentation），12 个结束于 Payment（payment）。

从最终步骤分布打开会话​

  1. 在 Final Step Distribution 中选择一个柱状分段。

  2. 查看打开的会话列表。

    ✓ 列表会显示确认号、客人、房间和最近一次失败。

  3. 在任一会话上选择 Open details。

    ✓ 该会话的 Reservation Details 面板会打开。

会话列表 vs 预订

列表显示的是会话，不是分组后的预订。可用它快速找出重复失败。

设备分析（可选）​

设备分析使用入住/退房会话中的设备详情。

如果客人没有提供设备信息，这张图可能为空。

使用这个视图按操作系统比较 kiosk 与移动端的使用情况。

示例

如果大多数会话来自 iOS，你可以考虑优化移动端入住流程。

限制与数据新鲜度​

  • 每次查询最多覆盖 90 天。
  • 如果范围内有超过 50,000 条事件，AVA 会提示你缩小日期范围。
  • 为了性能，会话列表有上限（每个步骤约 200 条，总计 2,000 条）。

故障排查​

所有图表都显示为 0​

你会看到： 汇总卡片显示 0，图表为空。

修复：

  1. 扩大日期范围。
  2. 确认 Status 中有日志。
  3. 检查你的套餐是否包含 Analytics。

完成率看起来比预期低​

你会看到： 明明很多客人已经入住，完成率却很低。

检查：

  • Pre‑Arrival 中的会话不计入 All Check‑Ins。
  • All Check‑Ins 只把 Full Check‑In 步骤视为完成。
  • Early Check‑In 和 Pre‑Registration 会在各自的子选项卡中统计。

覆盖卡片缺失​

你会看到： 只显示标准汇总卡片。

修复：

  1. 保持在 Check-In。

  2. 确认 PMS 连接处于活动状态。

  3. 同步完成后刷新页面。

  4. 如果日期范围很忙，几分钟后再刷新一次。

    ✓ 如果你的 PMS 支持预订覆盖，Eligible Check-In Units 和 AVA Check-In Share 会在 Completion Rate 之后出现。

覆盖卡片仍然看起来没变​

你会看到： 刷新后 Eligible Check-In Units 或 AVA Check-In Share 仍然没变化。

修复：

  1. 等一分钟。
  2. 再刷新一次 Analytics 选项卡。
  3. 确认日期范围与预期的 PMS 更新一致。
  4. 如果看起来仍然不对，请检查 PMS 同步是否已完成。

MCP 配置复制失败​

你会看到： 点击 Copy Codex MCP Config 或 Copy Claude MCP Config 后按钮报错。

修复：

  1. 保持在 Analytics 选项卡。
  2. 再试一次复制按钮。
  3. 如果令牌请求超时，刷新页面后重试。
  4. 如果错误仍然存在，请把具体报错信息发给支持团队。

配置已复制，但客户端无法连接​

你会看到： 弹窗打开了，但 Codex 或 Claude 没有加载 Streamliner 服务器。

修复：

  1. 检查你是否把配置粘贴到了正确的文件中。
  2. 确认 STREAMLINER_MCP_TOKEN 仍然存在。
  3. 完全重启客户端。
  4. 如果设置耗时太久，请重新复制一份配置。

缺少设置工具​

你会看到： 客户端已连接，但看不到设置操作。

修复：

  1. 从 Analytics 重新复制一份配置。
  2. 完全重启客户端。
  3. 确认粘贴进去的 STREAMLINER_MCP_TOKEN 是最新的。
  4. 如果仍有旧的 Streamliner 配置块，请删除它。

设置写入超时​

你会看到： 设置保存像是卡住了，随后返回超时或取消消息。

修复：

  1. 从 Analytics 重新复制一份配置。

  2. 完全重启客户端。

  3. 再试一次设置修改。

  4. 如果再次失败，检查令牌或会话是否已过期。

    ✓ 正常的设置更新应该能顺利结束，而不是一直挂起。

写入设置时认证失败​

你会看到： 保存商户设置时出现认证错误。

修复：

  1. 从 Analytics 重新复制一份配置。

  2. 完全重启客户端。

  3. 在同一家酒店里重试设置修改。

  4. 如果你切换了酒店，切换后请刷新配置。

    ✓ 新错误通常会提示你生成新的 MCP 配置/令牌。

仍然卡住？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ Status 有数据，但 Analytics 为空
  • ❌ 更改日期范围后图表始终不更新
  • ❌ Issues 列表显示了错误的时间戳

建议附上：

  • 你选择的日期范围
  • Analytics 选项卡截图
  • 一条示例预订的确认号

相关指南​