自动化扫描器/机器人的交互不计入点击和凭据次数。这是与旧版导出有意为之的差异。请参阅
与旧版导出的差异。
Fn_FetchAll查询；本报告将按名称调用该查询。
所需的密钥范围
本报告使用操作型的按人员结果列表，而不是报告预览系列。仅被授予
reporting:read 的密钥无法调用
GET /v1/simulation_results（API 将返回 403）。请参阅
选择合适的粒度。
源端点
结果列表上允许使用的筛选条件：
limit、page_token、
simulation、entity。此列表上没有 delivered_after / start_date，
因此在完整遍历之后，需在 Power Query 中应用过去 12 个月的筛选。
每条结果中使用的字段：id、simulation、entity、status、
targeted_at、delivered_at、bounced_at、opened_at、clicked_at、
attachment_opened_at、credential_submitted_at、reported_at、
reported_before_interaction、bot_activity_detected、email_subject、
sender_email、difficulty_level、created_at、updated_at。
粒度
在过去 12 个日历月内，至少有一条结果包含delivered_at 的每个实体对应一行。被设为目标但从未送达的人员不会出现。同一人员的多次模拟在此合并。
请求预算：对组织中所有模拟结果进行一次分页遍历，再对实体进行一次遍历。请务必设置 limit = "500"。
结果优先级（last_5_assessments）
最近五条已送达的结果（按 delivered_at
降序）将分别汇总为 YYYY-MM-DD: <outcome>。匹配到的第一个时间戳生效，优先级由高到低：
仅送达为
no action（邮件已送达；该人员未进行任何操作）。先点击后报告的人员为 clicked——在此列表中，报告的优先级不高于有风险的交互。被标记为机器人的行仍会根据已有的时间戳获得结果标签；只是不会增加点击/凭据次数。
当前连续点击次数：按从新到旧的顺序遍历这些已送达的结果，统计 clicked_at 非空且 bot_activity_detected 不是 true 的连续行数。遇到第一个不符合条件的行即停止。
列映射
旧版列名来自您之前的服务提供商的导出。/v1 字段是公共 API 名称；次数和比率由查询派生。
为星型架构模型保留的关联键：
entity_id。
与旧版导出的差异
- 机器人活动不计入点击和凭据次数。 之前的服务提供商的导出会将自动化扫描器/机器人的交互计为点击和凭据提交。本查询不会这样做。带有
bot_activity_detected = true的结果仍然是一次已送达的模拟——它会计入total_received以及报告汇总——但会被视为未点击和未提交：它不会计入clicks/credential_submissions，并且会中断当前连续点击次数。请勿为了与旧版导出保持一致而将机器人计入。 - 在
last_5_assessments上，报告的优先级不高于点击。 先点击后报告的人员会被标记为clicked。 - 目录扩展信息被省略，而非置空。 部门及类似字段不在
/v1上。 - 没有服务器端时间筛选。
GET /v1/simulation_results没有delivered_after。查询会遍历所有结果，然后仅保留过去 12 个日历月内的delivered_at。对于历史数据量较大的组织，相比使用筛选后的列表，可能会消耗更多的单密钥速率预算。
后续步骤
Power BI 和 Excel 设置
凭据、分页，以及在 Power BI 或 Excel 中加载这些查询。
电子邮件钓鱼日志
过去 12 个月的事件级钓鱼交互。
按人员的合规情况
人员 × 分配粒度的培训注册情况。
API 密钥
在用于刷新本报告的密钥上授予
simulation:read 和 entity:read。