> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> שחזור סיכום 12 החודשים של המשתמשים הפגיעים ביותר מספק קודם, על בסיס תוצאות סימולציה וישויות מ-/v1.

הדוח הוא סיכום פגיעות ל-12 חודשים ברמת המשתמש: שורה אחת לכל אדם שקיבל לפחות סימולציה אחת בשנה האחרונה, הכולל ספירות ושיעורים של לחיצות, הזנת פרטי גישה ודיווחים, רצף לחיצות נוכחי ורשימה משורשרת של חמש התוצאות האחרונות.

החלון הוא **12 חודשי לוח** (חצות UTC באותו יום בחודש, לפני שנים-עשר חודשים), ולא פרק זמן של 365 ימים.

<Note>
  אינטראקציות של סורקים אוטומטיים ושל בוטים אינן נכללות בספירות הלחיצות והזנת פרטי הגישה. זהו שוני מכוון מהייצוא הקודם (legacy). ראו
  [שינויים לעומת הייצוא הקודם](#%D7%A9%D7%99%D7%A0%D7%95%D7%99%D7%99%D7%9D-%D7%9C%D7%A2%D7%95%D7%9E%D7%AA-%D7%94%D7%99%D7%99%D7%A6%D7%95%D7%90-%D7%94%D7%A7%D7%95%D7%93%D7%9D).
</Note>

ההגדרה, פרטי הגישה, חלוקה לעמודים (pagination) וניסיון חוזר במקרה של חריגה ממגבלת הקצב זהים ל[מדריך החיבור ל-Power BI / Excel](/he/developers/v1/powerbi). הוסיפו תחילה את שאילתת `Fn_FetchAll` המשותפת; הדוח הזה קורא לה בשמה.

## היקפי מפתח נדרשים

| היקף | שימוש |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (צירוף לפי אימייל ושם תצוגה) |

הדוח הזה משתמש ברשימת התוצאות התפעולית לפי אדם, ולא במשפחת תצוגות המקדימות של הדיווח. מפתח שניתן לו רק `reporting:read` אינו יכול לקרוא ל-`GET /v1/simulation_results` (ה-API מחזיר `403`). ראו
[בחירת רמת הפירוט הנכונה](/he/developers/v1/powerbi#%D7%91%D7%97%D7%99%D7%A8%D7%AA-%D7%A8%D7%9E%D7%AA-%D7%94%D7%A4%D7%99%D7%A8%D7%95%D7%98-%D7%94%D7%A0%D7%9B%D7%95%D7%A0%D7%94).

## נקודות קצה של המקור

| נקודת קצה | תפקיד |
| - | - |
| `GET /v1/simulation_results` | תוצאה לכל נמען. זוהי רמת הפירוט של נתוני העובדות. |
| `GET /v1/entities` | מתרגמת `entity` לאימייל / שם תצוגה. בשורת התוצאה אין אימייל או שם תצוגה של הנמען (רק `entity`). |

מסננים ברשימת ההיתרים ברשימת התוצאות: `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>`. חותמת הזמן הראשונה שמתאימה קובעת, לפי סדר עדיפות מהגבוהה ביותר:

| עדיפות | חותמת זמן | תווית תוצאה |
| - | - | - |
| 1 | `credential_submitted_at` | `credential submitted` |
| 2 | `clicked_at` | `clicked` |
| 3 | `attachment_opened_at` | `attachment opened` |
| 4 | `reported_at` | `reported` |
| 5 | `opened_at` | `opened` |
| 6 | `delivered_at` | `no action` |
| 7 | `bounced_at` | `bounced` |

״נמסר בלבד״ הוא `no action` (ההודעה הגיעה; האדם לא עשה דבר). אדם שלחץ ובהמשך דיווח הוא `clicked` — דיווח אינו עדיף על אינטראקציה מסוכנת ברשימה זו. שורות המסומנות כבוט עדיין מקבלות תווית תוצאה לפי חותמות הזמן הקיימות; הן פשוט אינן מגדילות את ספירות הלחיצות והזנת פרטי הגישה.

**רצף לחיצות נוכחי:** עוברים על אותן תוצאות שנמסרו, מהחדשה לישנה, וסופרים שורות רצופות שבהן `clicked_at` אינו ריק **וגם** `bot_activity_detected` אינו `true`. עוצרים באי-התאמה הראשונה.

## מיפוי עמודות

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

| עמודה קודמת (legacy) | שדה או גזירה של `/v1` | עמודה בדוח |
| - | - | - |
| Email | `Entity.email` (צירוף לפי `Result.entity`) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | ספירת תוצאות שבהן `delivered_at` אינו ריק (כולל שורות המסומנות כבוט) | `total_received` |
| Clicks # | ספירה כאשר `clicked_at` אינו ריק **וגם** `bot_activity_detected` ≠ `true` | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | ספירה כאשר `credential_submitted_at` אינו ריק **וגם** `bot_activity_detected` ≠ `true` | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | ספירת תוצאות שבהן `reported_at` אינו ריק (כולל בוטים — זו אינה לחיצה או הזנת פרטי גישה) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | תוצאות רצופות שנמסרו, מהחדשה ביותר, שבהן האדם לחץ (בוטים שוברים את הרצף) | `current_click_streak` |
| Last 5 assessments | חמש התוצאות החדשות ביותר שנמסרו, מופרדות באמצעות `"; "` (ראו [עדיפות](#עדיפות-תוצאות-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | לא קיים ב-`/v1` | מושמט, לא מאופס |

מפתח צירוף שנשמר למודל סכמת כוכב: `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 חודשי הלוח האחרונים. ארגון גדול עם היסטוריה ארוכה עשוי לנצל יותר מתקציב הקצב לכל מפתח, בהשוואה לרשימה מסוננת.

## השלבים הבאים

<CardGroup cols={2}>
  <Card title="הגדרת Power BI ו-Excel" href="/he/developers/v1/powerbi">
    פרטי גישה, חלוקה לעמודים וטעינת השאילתות האלה ב-Power BI או ב-Excel.
  </Card>

  <Card title="יומן פישינג באימייל" href="/he/developers/v1/reports/email-phishing-log">
    אינטראקציות פישינג ברמת האירוע ב-12 החודשים האחרונים.
  </Card>

  <Card title="ציות לפי אדם" href="/he/developers/v1/reports/per-person-compliance">
    הרשמות להדרכה ברמת פירוט של אדם × הקצאה.
  </Card>

  <Card title="מפתחות API" href="/he/developers/developer-hub/api-keys">
    הקצו `simulation:read` ו-`entity:read` למפתח שמרענן את הדוח הזה.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.