跳到主要内容

了解 Command Center Analytics

快速设置

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

本指南说明 AVA 如何计算 Command Center 中的每个 Analytics 图表，也说明你可能会看到的额外入住覆盖率卡片和 STB EVA 导出。

前往： Main Menu → Command Center → Analytics

Analytics 加载更快

AVA 现在会从每日汇总读取这个选项卡，以便更快显示宽日期范围。 如果汇总数据缺失或汇总调用失败，AVA 会回退到实时路径。

大日期范围会更慢

大日期范围仍可能需要更长时间加载。 非常繁忙的物业可能会更早返回窄日期范围错误，而不是一直卡住。 这只适用于 Analytics 选项卡。

演示会话

演示入住仍会出现在 Status 和预订详情中。 它们不会计入 Analytics 总数、流失、时间分析、问题或最近活动。

不提供报表下载

主 Analytics 图表不包含浏览器 PDF 下载。 当 STB EVA submissions 面板出现时，你可以使用其下载图标导出 CSV。 该导出现在使用与仪表板计数相同的 EVA 提交日志来源。

为 Codex 或 Claude 复制 MCP 配置​

快速设置

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

当你想把 Analytics 数据发送给 AI 客户端时，请使用这些按钮。 复制出的 token 还包含完整的 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。

只使用新的 token

如果你在这次改动前复制过 token，请重新复制一份最新配置。 旧 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 如何构建会话​

  • 会话 指一条预订入住记录，不是每位客人各算一次。
  • 当至少记录到该视图中的一个步骤时，该会话就会被纳入统计。
  • 演示标记的会话会从这些 Analytics 图表中排除。
  • 失败步骤仍会计入总数，这样你可以看到流失和问题。
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 预订

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

OPERA 预订

如果你的 PMS 是 OPERA，AVA 会在合格单元统计中忽略 PM、PF 和 PX 伪房间。 当房间行信息较少时，它也会使用顶层房型字段，这样真正的客房仍能被正确统计。

OPERA 预订家族

AVA 还会按父确认号去重关联的 OPERA 预订家族。 这样可以避免终态兄弟行抬高 Eligible Check-In Units。

被截断的会话映射

如果 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 提供商不会显示这些卡片。

导出 STB EVA submissions CSV​

快速设置

这一步不到 1 分钟。导出仅在启用 EVA 的 Check-In 中出现。

使用 STB EVA submissions 面板上的小下载图标导出所选日期范围。

项目显示内容你可以做什么
STB EVA submissions所选期间内尝试、成功和失败的 EVA 提交点击下载图标下载 CSV
CSV contents汇总计数以及 eva_submission_logs 中每次 EVA API 尝试的一行记录用于 STB 报表或审计复核

  1. 前往 Main Menu → Command Center。

  2. 选择 Analytics 选项卡。

  3. 保持 Check-In 视图选中。

  4. 滚动到 STB EVA submissions。

  5. 点击下载图标。

  6. 保存下载的 stb-eva-submissions.csv 文件。

    ✓ 文件包含 transaction ID、结果代码、预订和入住 ID、错误元数据以及已清洗的请求详情。 ✓ 护照和证件号码会被遮罩。 ✓ MRZ 和 base64 字段会被省略。 ✓ 导出不再包含旧版 EVA 报表中的历史预订行。 ✓ 如果下载失败，AVA 会在面板中显示本地错误消息。

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

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

  • 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 seconds。 如果 Document Upload 在 10:05 完成，而 Validation 在 10:07 完成，那么 Avg Time to Next Step 就是 2 minutes。

时间分析（按小时）​

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

  • 使用酒店时区。
  • 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（成功），10 个结束于 Early Check‑In（timing）， 8 个结束于 Document Upload（documentation），12 个结束于 Payment（payment）。

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

  1. 在 Final Step Distribution 中选择一个条形分段。

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

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

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

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

会话列表 vs 预订

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

设备分析（可选）​

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

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

使用这个视图比较按 OS 划分的 kiosk 与移动端使用情况。

示例

如果大多数会话来自 iOS，你可能需要优化移动入住流程。

限制与数据新鲜度​

  • Analytics 每次查询最多覆盖 90 天。
  • 当每日汇总可用时，宽范围会优先从汇总数据加载。
  • 对于结果集过大的非常繁忙物业，可能需要缩小日期范围。
  • 如果 AVA 要求你缩小日期范围，请缩短时间段后重试。
  • 为了性能，列表会设上限（每个步骤约 200 条，总计 2,000 条）。

故障排查​

所有图表都显示零​

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

解决方法：

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

完成率看起来比预期低​

你会看到： 即使很多客人已经入住，完成率仍然很低。

检查：

  • 演示入住会被排除，因此测试会话不会抬高 Total Logs。
  • 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 同步是否已经完成。

Analytics 一直加载或要求缩小范围​

你会看到： Analytics 选项卡持续转圈、超时，或要求你缩小日期范围。

原因： 更大的范围需要更多处理时间。 非常繁忙的物业也可能更早碰到请求限制。

解决方法：

  1. 最多等待 2 分钟让请求完成。

  2. 如果页面仍然超时或要求缩小范围，请尝试更小的日期范围。

  3. 刷新 Analytics 选项卡并重试。

  4. 如果小范围仍失败，请向支持团队提供所选日期。

    ✓ 更小的范围应该更快完成，也有助于你判断是范围大小还是数据可用性的问题。

MCP 配置复制失败​

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

解决方法：

  1. 保持在 Analytics 选项卡。
  2. 再试一次复制按钮。
  3. 如果 token 请求超时，请刷新页面后重试。
  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. 如果再次失败，检查 token 或会话是否已过期。

    ✓ 有效的设置更新应该会完成，而不是一直挂起。

设置写入时认证失败​

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

解决方法：

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

  2. 完全重启客户端。

  3. 在同一家酒店中重试设置变更。

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

    ✓ 新错误应提示你生成新的 MCP 配置/token。

仍然没有浏览器 PDF 下载​

你会看到： 你原本期待主 Analytics 图表上有 Download report 按钮。

解决方法：

  1. 这是当前 Analytics 选项卡中的预期行为。
  2. 直接使用屏幕上的图表和日期范围筛选器。
  3. 如果你需要提交详情，请使用 STB EVA submissions 的下载图标。
  4. 如果你需要其他导出方式，请联系支持。

STB EVA 导出缺失​

你会看到： 你在 STB EVA submissions 下看不到下载图标。

解决方法：

  1. 切换到 Check-In。
  2. 确认在 Settings → Check-in → Government Integration 中已为新加坡启用 EVA。
  3. 在 Analytics 数据加载完成后刷新页面。
  4. 如果面板仍然隐藏，所选日期范围可能不包含 EVA 提交。

CSV 导出失败​

你会看到： 你点击下载图标，但没有文件下载下来。

解决方法：

  1. 等 Analytics 汇总加载完成后再试一次。
  2. 缩小日期范围。
  3. 检查浏览器是否允许下载。
  4. 等本地错误清除后再试一次。
  5. 如果导出仍然失败，请联系支持。

仍然卡住？​

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

  • ❌ Status 中有数据，但 Analytics 为空
  • ❌ 更改日期范围后图表始终不更新
  • ❌ 问题列表显示的时间戳不正确

建议附上：

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