המשתמשים הפגיעים ביותר

הדוח הוא סיכום פגיעות ל-12 חודשים ברמת המשתמש: שורה אחת לכל אדם שקיבל לפחות סימולציה אחת בשנה האחרונה, הכולל ספירות ושיעורים של לחיצות, הזנת פרטי גישה ודיווחים, רצף לחיצות נוכחי ורשימה משורשרת של חמש התוצאות האחרונות. החלון הוא 12 חודשי לוח (חצות UTC באותו יום בחודש, לפני שנים-עשר חודשים), ולא פרק זמן של 365 ימים. ההגדרה, פרטי הגישה, חלוקה לעמודים (pagination) וניסיון חוזר במקרה של חריגה ממגבלת הקצב זהים למדריך החיבור ל-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.

​

רמת פירוט

שורה אחת לכל ישות שיש לה לפחות תוצאה אחת עם delivered_at ב-12 חודשי הלוח האחרונים. אדם שהיה יעד אך לא נמסרה לו סימולציה אינו מופיע. סימולציות מרובות לאותו אדם מתכנסות כאן לשורה אחת. תקציב בקשות: מעבר אחד עם חלוקה לעמודים על כל תוצאות הסימולציה בארגון, ועוד מעבר אחד על הישויות. הקפידו תמיד להגדיר limit = "500".

​

עדיפות תוצאות (last_5_assessments)

כל אחת מחמש התוצאות האחרונות שנמסרו (delivered_at בסדר יורד) מסוכמת כ-YYYY-MM-DD: <outcome>. חותמת הזמן הראשונה שמתאימה קובעת, לפי סדר עדיפות מהגבוהה ביותר: ״נמסר בלבד״ הוא no action (ההודעה הגיעה; האדם לא עשה דבר). אדם שלחץ ובהמשך דיווח הוא clicked — דיווח אינו עדיף על אינטראקציה מסוכנת ברשימה זו. שורות המסומנות כבוט עדיין מקבלות תווית תוצאה לפי חותמות הזמן הקיימות; הן פשוט אינן מגדילות את ספירות הלחיצות והזנת פרטי הגישה. רצף לחיצות נוכחי: עוברים על אותן תוצאות שנמסרו, מהחדשה לישנה, וסופרים שורות רצופות שבהן clicked_at אינו ריק וגם bot_activity_detected אינו true. עוצרים באי-התאמה הראשונה.

​

מיפוי עמודות

שמות העמודות הקודמות (legacy) לקוחים מהייצוא של הספק הקודם שלכם. שדות /v1 הם שמות ה-API הציבוריים; השאילתה גוזרת את הספירות והשיעורים. מפתח צירוף שנשמר למודל סכמת כוכב: entity_id.

​

שינויים לעומת הייצוא הקודם

• פעילות בוטים אינה נכללת בספירות הלחיצות והזנת פרטי הגישה. הייצוא של הספק הקודם ספר אינטראקציות של סורקים אוטומטיים ושל בוטים כלחיצות וכהזנות של פרטי גישה. השאילתה הזו אינה עושה זאת. תוצאה עם bot_activity_detected = true עדיין נחשבת סימולציה שנמסרה — היא נספרת ב-total_received ובסכומי הדיווחים — אך היא מטופלת כאי-לחיצה וכאי-הזנה: היא מושמטת מ-clicks / credential_submissions והיא שוברת רצף לחיצות נוכחי. אין ל״תקן״ זאת על ידי ספירת בוטים כדי להתאים לייצוא הקודם.
• דיווח אינו עדיף על לחיצה ב-last_5_assessments. אדם שלחץ ובהמשך דיווח מסומן כ-clicked.
• נתוני ספרייה נוספים מושמטים, ולא מאופסים. מחלקה ושדות דומים אינם קיימים ב-/v1.
• אין מסנן זמן בצד השרת. ל-GET /v1/simulation_results אין delivered_after. השאילתה עוברת על כל התוצאות, ואז שומרת את delivered_at ב-12 חודשי הלוח האחרונים. ארגון גדול עם היסטוריה ארוכה עשוי לנצל יותר מתקציב הקצב לכל מפתח, בהשוואה לרשימה מסוננת.

​

השלבים הבאים