occurred_after 中（即 12 个月前同一日期当天的 UTC 午夜，而非 365 天的时长）。
原始客户端 IP 绝不会出现在
/v1 上，这是出于隐私的设计，而非尚未完成的映射。设备类型是事件行上的派生类别；原始 user_agent 保持私有。请参阅与旧版导出的差异。Fn_FetchAll 查询；本报告会按名称调用该查询。
所需的密钥范围
仅被授予
simulation:read 的密钥无法调用报告事件端点（API 将返回 403）。请参阅选择合适的粒度。
源端点
事件列表上允许使用的筛选条件（其他任何条件均返回
400）：limit、page_token、simulation、entity、event_type、occurred_after。
此报告系列属于预览数据集。可通过 GET /v1/reporting/datasets 和 GET /v1/reporting/datasets/simulation_events 查看数据集架构和数据策略。
粒度
每个报告模拟事件对应一行。如果某人打开并随后点击了同一封邮件，则会产生两行。entity_id 为 null（无执行者/收件人/目标参与者）的事件仍会出现，此时 email 为 null。
API 时间窗口会扩大一分钟；确切的 occurred_at >= WindowStart 边界会在本地重新应用，因此过去一年的范围不取决于服务器将 occurred_after 视为包含还是不包含。
请求预算：对窗口内的事件进行一次分页遍历，再对实体进行一次遍历。请始终设置 limit = "500"。
列映射
旧版列名来自您上一家服务商的导出。/v1 字段是公共 API 名称；查询会为报告对其中一些字段设置别名。
操作令牌
action 是封闭的报告令牌。旧版“Email Sent”映射到 simulation.delivered（delivered 是公共动词；传输令牌为 simulation.delivered）。
因 API 提供而保留的额外字段：
sender_domain、full_name、event_id、entity_id、simulation_id、occurred_at，以及来自实体关联的 entity_type 和 entity_status。
与旧版导出的差异
- 原始 IP 始终不可用。
/v1不会公开原始客户端 IP，这是出于隐私的设计，而非尚未完成的映射。查询不会添加占位 IP 列。 - 设备类型是派生的，而非原始值。
device_type是点击、提交和报告事件的派生设备类别。观察到的令牌包括desktop、mobile、tablet和unknown，但发送端存储的是自由格式字符串，请将其视为开放文本，而非封闭枚举。当事件没有派生类别时为 null，原始user_agent字符串保持私有。 - “Email Sent”对应
simulation.delivered。 筛选或统计发送量时请使用该令牌。请勿查找旧版的email_sent字符串。 - 收件人电子邮件是关联得到的，而非事件上的字段。 报告事件不包含电子邮件；查询通过遍历
/entities来填充。 - 过去 12 个日历月，而非 365 天的时长，也不是完整历史记录。
- 长格式，不合并。 每次交互一行，而非每人一个结果。
后续步骤
Power BI 和 Excel 设置
凭据、分页，以及在 Power BI 或 Excel 中加载这些查询。
最易受攻击的用户
按个人汇总的 12 个月点击、凭据和报告情况。
个人合规情况
人员 × 分配粒度的培训注册情况。
API 密钥
在用于刷新此报告的密钥上授予
reporting:read 和 entity:read。