跳到主要内容

了解 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。

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

使用酒店本地日期窗口​

Analytics 读取所选日期范围时使用酒店配置的时区。它按入住和退房活动时间戳筛选会话，而不是按预订更新时间筛选。 只有位于该本地窗口内的步骤，才会计入所选日期的图表和完成结果。之后的预订更新不能将更早或未来的完成步骤加入当天分析。 Successful Check‑Outs 卡片是例外：它使用终态事件的完成日期。

比较酒店本地营业日

请按酒店日历日选择日期，即使你在另一个时区查看 Analytics。

AVA 如何构建会话​

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

仅到达 Pre‑Arrival 的会话不会计入 All Check‑Ins。请使用 Pre‑Arrival 视图查看这些会话。 如果客人完成了 pre-arrival，随后又在设备上完成入住，AVA 会在两个视图中都计入该会话。 客人开始流程后，即使放弃 Pre‑Arrival，该尝试仍会出现在 Pre‑Arrival 视图中。

客人在 pre-arrival 后继续办理入住​

Pre‑Arrival 视图是成员群组，而不是排他类别。一个会话可以同时属于 Pre‑Arrival 和 Check‑In 群组。 只要 Pre‑Arrival 活动开始，会话就符合条件，即使客人之后放弃流程也一样。 达到 PRE_ARRIVAL 会将会话标记为完成。仅打开 pre-arrival 链接、没有记录流程活动，不会使会话符合条件。 如果观察到完整入住里程碑，该会话仍会保留在正确的 Check‑In 总数中。

客人活动Analytics 视图
客人打开链接，但没有记录流程活动不计入 Pre‑Arrival
客人开始 Pre‑Arrival，但中途放弃Pre‑Arrival，未完成
客人只完成 pre-arrivalPre‑Arrival，已完成
客人完成 pre-arrival，随后完成设备入住Pre‑Arrival 和 Check‑In

这样，混合流程会在两个相关群组中都可见。纯 pre-arrival 流程仍不计入 All Check‑Ins。

对于 Pre‑Arrival，Total Logs 统计所有有记录活动的会话，Completion Rate 统计达到 PRE_ARRIVAL 的会话。 例如，三次尝试中有两次完成，完成率为 66.7%。因此，放弃的尝试会降低完成率，并暴露流程流失。

历史汇总

之前保存的每日汇总可能会保留基于完成数的 Pre‑Arrival 统计，直到 AVA 重新计算。 新计算的汇总会将放弃的尝试纳入分母。

密钥编码是最后记录的步骤​

AVA 将 KEY_ENCODED 视为 Full Check-In 分类信号，即使会话没有 KEY_COLLECTION 或 KEY_RETRIEVED 步骤也适用。 该会话会出现在 Full Check‑In 和 All Check‑Ins 中。

KEY_ENCODED 不算完成率的完成里程碑。因此，会话可能增加 Full Check-In 总数，却不会增加已完成会话数。

完成率可能变化

使用钥匙卡编码的物业可能会看到 Full Check-In 完成率略低。 这是因为部分会话会在 KEY_ENCODED 结束，却没有其他完成里程碑。

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

卡片计算方式
Total Logs所选视图中的非演示会话数量
Completion Rate已完成会话 ÷ 非演示日志总数，使用所选视图的完成规则
Avg Completion Time从第一个成功步骤（通常是 Entry）到完成的时间
Successful Check‑Ins具有成功 PMS CHECKIN 里程碑的不同会话
Successful Check‑Outs具有成功终态事件的不同退房会话，按完成日期归属

完成规则一列控制 Completion Rate 和 Avg Completion Time，但不定义 Successful Check‑Ins。

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

示例

如果 Total Logs 是 40，而有 28 个会话达到配置的完成信号，完成率就是 70%。 Successful Check‑Ins 可能显示不同数字，因为它统计成功的 PMS 入住里程碑。

Successful Check-Outs 使用完成日期​

Successful Check‑Outs 卡片统计每个达到成功终态事件的唯一退房，并将数量归入退房成功当天酒店本地日历日期。 退房尝试、漏斗阶段、Completion Rate 和 Avg Completion Time 仍按开始日期归属。

例如，周一开始、周二成功的退房会显示在周二的 Successful Check‑Outs 中；其尝试和漏斗活动仍属于周一的退房分析。 这样可以让成功离店与实际完成日期保持一致。

将 PMS 入住与流程完成分开​

Successful Check‑Ins 确认 AVA 已完成 PMS 的 CHECKIN 请求。对于 OPERA，这发生在 AVA 向 PMS 发送 SCI code 时。 只有记录的入住证据为 SUCCESS 或 PARTIAL 时，AVA 才统计该里程碑。待处理或失败的旧里程碑数据不算成功 PMS 入住。 当事件证据显示没有入住活动时，AVA 会排除仅退房的流程，避免已完成退房上的旧 CHECKIN 标记抬高数量。 如果客人在退房前已完成入住，AVA 会保留该成功入住计数。

Completion Rate 和 Avg Completion Time 继续使用配置的终态或房间访问信号，因此流程表现与 PMS 里程碑彼此独立。

发生的情况Successful Check‑Ins完成指标
PMS CHECKIN 成功，随后钥匙卡编码失败统计 PMS 入住可能显示流程未完成或失败
只剩待处理或失败的旧 CHECKIN 标记不统计遵循所选视图现有完成规则
房间分配进入队列，但 PMS CHECKIN 未成功不统计遵循所选视图现有完成规则
PMS CHECKIN 和房间访问都成功统计 PMS 入住终态信号成功时计为已完成

该卡片不再将排队、提前入住和钥匙收集类别合并为 Successful Check‑Ins。

入住覆盖卡片​

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

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

覆盖统计使用酒店时区中每笔预订的到店日期。即使客人提前完成 pre-arrival 入住，只要在所选范围内到店，仍会被统计。 漏斗使用活动日期，因此两类指标回答的是不同问题。

AVA 如何判断资格

AVA 只统计同时具有 AVA 活动、有效的商户本地到店日期和合格状态的预订。 合格状态为 RESERVED、CHECKED_IN、CHECKED_OUT 和 DUE_OUT。 DUE_OUT 计入，因为该预订已在离店前完成入住。对于 OPERA，AVA 还会将 DueOut 纳入 CHECKED_IN PMS 覆盖分组。 这样可以将离店日和日用房到店保留在覆盖分母中。如果 AVA 无法核验所需字段，会隐藏覆盖卡片，而不是显示误导性的百分比。

单元 vs 预订

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

OPERA 预订

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

OPERA 预订家族

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

被截断的会话映射

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

OPERA 退房覆盖

如果所选日期范围在夜审前包含今天，未来到店的 Checked Out 行会计为零。 AVA 使用物业的营业日期执行此提前终止判断，使覆盖读取快速且一致。

到店群组不可用时

AVA 首先使用所选日期范围内到店客人的窄范围覆盖结果。 如果该结果不可用、不完整或仍在发布中，AVA 会使用按到店日期筛选的日志。 如果这些日志不可用，AVA 可能使用基于活动的会话映射；该回退方式可能低估窄日期范围的覆盖率。 空结果表示有效的零值，而不是缺失数据。没有可用来源时，覆盖卡片会保持隐藏。

AVA 会把每个已处理预订只计算一次。正常覆盖结果使用按到店日期关联的群组。 所选范围按酒店时区比较到店日期。仅搜索预订，以及 PMS 或前台同步步骤，不会计入 AVA 分子。 如果分子可能超过分母，AVA 会隐藏占比卡片，而不是将数值强行限制在分母以内。 这样可以让 AVA Check-In Share 与预订覆盖保持一致。

新结果可能会短暂延迟

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

已修正的历史覆盖

覆盖规则更新后，AVA 会在重新使用旧结果前刷新已保存的历史覆盖结果。 短日期范围可能先显示修正后的卡片；较长范围在计划刷新完成前可能使用实时覆盖。

Check-In Share 看起来不对​

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

修复：

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

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

退房覆盖卡片​

AVA 仅在 PMS 提供完整的离店范围群组时显示退房覆盖。你可能会在 Check-Out 视图看到两张卡片。 这些卡片将 AVA 的退房活动与入住活动分开衡量。

卡片显示内容重要原因
Eligible Check-Out Units所选期间离店的不同确认号或子预订单元这是退房覆盖分母
AVA Check-Out Share具有持久 AVA 退房活动的合格单元百分比这显示该期间 AVA 的离店采用情况
覆盖使用离店日期

退房覆盖使用酒店时区中每笔预订的离店日期。入住覆盖使用到店日期，因此两张卡片可能覆盖不同单元。 退房分子只统计持久的 AVA 退房活动；仅搜索和 PMS 或前台同步步骤不计入。

按 PMS 查看退房覆盖​

Cloudbeds、Mews 和 OPERA 为退房覆盖提供原生离店群组。AVA 不会把到店覆盖重新标记为退房覆盖。 不受支持的 PMS 适配器可能显示 Unavailable，而不是百分比。对于 OPERA，预订分页不完整时也会显示 Unavailable。 AVA 不会根据不完整的离店数据计算百分比。

退房覆盖不可用​

你看到的情况： 退房覆盖卡片显示 Unavailable，而不是百分比。

原因： AVA 无法核验完整的离店范围覆盖数据。PMS 可能不支持离店群组，或者 OPERA 预订页面不完整。 AVA 会隐藏该比率，避免显示误导性结果。

修复：

  1. 确认选择了 Check-Out 和正确的日期范围。

  2. PMS 同步完成后刷新 Analytics 选项卡。

  3. 几分钟后再次尝试相同范围。

  4. 如果卡片仍不可用，请联系支持团队。

    ✓ 不可用表示当前结果尚不可信，不表示数值为零。

导出 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。

退房转化使用必需里程碑​

在 Check‑Out 中，AVA 根据必需的退房里程碑计算转化率。

阶段AVA 的处理方式
Checkout Started来自 FETCH_CHECKOUT 的必需起始里程碑
Bill Reviewed客人查看账单时产生的可选活动
Charges Confirmed客人确认费用时产生的可选活动
Checkout Payment收取付款时产生的可选活动
Checkout Complete来自 CHECKOUT 的必需最终里程碑

客人可以直接从 Checkout Started 进入 Checkout Complete。AVA 会将这条路径计为完成，不显示虚假的流失。 观察到的可选阶段会显示在 Optional checkout activity 中，不会降低转化率，也不会创建红色流失转变。 仪表盘和可下载分析报表使用相同的阶段规则。

AVA 观察到退房付款活动时会显示 Checkout Payment。即使保存的设置已过时，付款仍在必需漏斗之外。 AVA 不会将缺少付款标记为 not required，也不会将其视为失败。

直接 PMS 退房看起来像流失​

你看到的情况： 客人在 PMS 中完成退房，但跳过了账单或付款阶段。

修复：

  1. 在 Command Center → Analytics 中选择 Check‑Out。

  2. 找到作为最后必需阶段的 Checkout Complete。

  3. 在 Optional checkout activity 中查看账单、费用或付款事件。

  4. 如需保存副本，请将仪表盘与可下载报表进行比较。

    ✓ 直接 PMS 退房会计入最终转化。

从必需步骤流失查看预订​

必需退房步骤的流失可能包含 View list 操作。使用它可以查找到达一个必需阶段、却未到达下一阶段的预订。

  1. 在 Command Center → Analytics 中选择 Check‑Out。
  2. 找到有流失数量的必需阶段转变。
  3. 点击 View list。
  4. 查看确认号、客人姓名、房间和最新失败详情。
  5. 点击 Download CSV 保存显示的预订。

只有在每个匹配会话都等于所显示的流失数量时，AVA 才显示 View list。 如果预订映射不完整，AVA 会隐藏该转变的操作。

查看失败的退房付款​

AVA 观察到退房付款活动时，付款会显示在 Optional checkout activity 下，即使保存的付款设置已过时也可能显示。 付款活动不会改变退房完成情况或必需阶段转化率。

  1. 在 Command Center → Analytics 中选择 Check‑Out。
  2. 在 Optional checkout activity 下找到 Payment。
  3. 列出失败付款时，点击 View failed reservations。
  4. 查看预订详情和失败消息。
  5. 点击 Download CSV 保存显示的失败记录。

CSV 包含 Confirmation number、Guest name、Room、Failure step 和 Failure message。 只有每笔失败付款都能映射到会话时，AVA 才显示 View failed reservations。

Successful Check-Outs 出现在另一天​

你看到的情况： 退房在某天开始，但 Successful Check‑Outs 在另一天增加。

修复：

  1. 查看终态退房事件成功的时间。

  2. 将该时间戳与酒店本地日历日期比较。

  3. 比较尝试或漏斗阶段时，查看退房开始日期。

  4. 如果退房刚完成，请刷新 Analytics 选项卡。

    ✓ 退房跨越午夜或延迟完成时，这是预期行为。

时间分析（按小时）​

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

  • 使用酒店时区。
  • 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 同步是否已经完成。

时间分析使用错误的本地小时​

你看到的情况： Time Analysis 的小时峰值与酒店本地人员安排不一致。

修复：

  1. 检查分析响应中的 timeAnalysis.timezone 值。

  2. 如果该值是 UTC，按 UTC 小时解读图表，而不是按酒店本地小时解读。

  3. 使用 merchantTimezone 将小时段换算为本地时间，再安排人员。

    ✓ Time Analysis 当前按 UTC 分桶；酒店时区不会改变这些小时标签。

Analytics 显示另一天的步骤​

你看到的情况： 图表中出现的步骤似乎不属于所选酒店日期。

修复：

  1. 在 Settings → Essentials → Hotel Basic Details 中确认酒店时区。

  2. 按酒店本地日期重新选择范围。

  3. 刷新 Analytics 选项卡。

    ✓ Analytics 使用酒店本地日期窗口筛选活动。

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. 如果导出仍然失败，请联系支持。

漏斗预订列表缺失​

你看到的情况： 有漏斗流失，但没有 View list 或预订列表。

修复：

  1. 确认选择了 Check‑Out 和正确的日期范围。

  2. 确认该转变属于必需退房阶段。

  3. 刷新 Analytics，然后重新查看流失转变。

  4. 如果预订映射不完整，使用仪表盘中的聚合计数；AVA 会在映射完整后显示列表。

    ✓ 只有当列表中的会话数能完全匹配显示的流失数量时，才会显示 View list。

仍然卡住？​

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

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

建议附上：

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