Skip to main content
本報告是以使用者為單位的 12 個月易受攻擊性彙總:過去一年內至少收到一次模擬的每位人員各佔一列,內容包含點擊/憑證/回報的次數與比率、目前連續點擊次數,以及串接而成的最近 5 次成果清單。 時間範圍為 12 個日曆月(自十二個月前同一日期的 UTC 午夜起算),而非 365 天的時間長度。
自動化掃描器/機器人的互動不計入點擊和憑證次數。這是與舊版匯出內容刻意不同之處。請參閱 與舊版匯出內容的差異。
設定、憑證、分頁和速率限制重試方式,均與 Power BI / Excel 連線指南相同。請先新增共用的 Fn_FetchAll 查詢;本報告會依名稱呼叫該查詢。

必要的金鑰範圍

本報告使用營運層級的個別人員結果清單,而非報告預覽系列。僅被授予 reporting:read 的金鑰無法呼叫 GET /v1/simulation_results(API 會傳回 403)。請參閱 選擇正確的粒度。

來源端點

結果清單上允許使用的篩選條件:limit、page_token、 simulation、entity。此清單上沒有 delivered_after / start_date, 因此過去 12 個月的範圍是在完整走訪後於 Power Query 中套用。 每筆結果所使用的欄位: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。