自動化掃描器/機器人的互動不計入點擊和憑證次數。這是與舊版匯出內容刻意不同之處。請參閱
與舊版匯出內容的差異。
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。
