> ## 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 місяців: один рядок на кожну особу, яка отримала щонайменше одну симуляцію за останній рік, із кількістю та частками переходів за посиланнями, введення облікових даних і повідомлень, поточною серією переходів за посиланнями та об’єднаним списком останніх 5 результатів. Вікно охоплює **12 календарних місяців** (північ за UTC того самого числа місяця дванадцять місяців тому), а не період тривалістю 365 днів. Взаємодії автоматизованих сканерів і ботів не враховуються в кількості переходів за посиланнями та введення облікових даних. Це свідоме розходження зі застарілим експортом. Див. [Розбіжності із застарілим експортом](#%D1%80%D0%BE%D0%B7%D0%B1%D1%96%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D1%96-%D1%96%D0%B7-%D0%B7%D0%B0%D1%81%D1%82%D0%B0%D1%80%D1%96%D0%BB%D0%B8%D0%BC-%D0%B5%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%BE%D0%BC). Налаштування, облікові дані, розбиття на сторінки та повторні спроби через обмеження частоти запитів такі самі, як у [посібнику з підключення Power BI / Excel](/uk/developers/v1/powerbi). Спочатку додайте спільний запит `Fn_FetchAll`; цей звіт викликає його за назвою. ## Необхідні області дії ключа | Область дії | Призначення | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (приєднання за email та відображуваним іменем) | Цей звіт використовує **операційний** список результатів для кожної особи, а не родину попередніх звітів. Ключ, якому надано лише `reporting:read`, не може викликати `GET /v1/simulation_results` (API повертає `403`). Див. [вибір правильної деталізації](/uk/developers/v1/powerbi#%D0%B2%D0%B8%D0%B1%D1%96%D1%80-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D1%8C%D0%BD%D0%BE%D1%97-%D0%B4%D0%B5%D1%82%D0%B0%D0%BB%D1%96%D0%B7%D0%B0%D1%86%D1%96%D1%97). ## Кінцеві точки джерел | Кінцева точка | Роль | | - | - | | `GET /v1/simulation_results` | Результат для кожного одержувача. Це рівень деталізації фактів. | | `GET /v1/entities` | Зіставляє `entity` з email / відображуваним іменем. Рядок результату не містить email чи відображуваного імені одержувача (лише `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: `. Перемагає перша відповідна часова позначка, починаючи з найвищого пріоритету: | Пріоритет | Часова позначка | Мітка результату | | - | - | - | | 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` не є null **і** `bot_activity_detected` не дорівнює `true`. Зупиніться на першому пропуску. ## Зіставлення стовпців Назви застарілих стовпців походять з експорту вашого попереднього постачальника. Поля `/v1` — це публічні назви API; запит обчислює кількості та частки. | Застарілий стовпець | Поле або обчислення `/v1` | Стовпець звіту | | - | - | - | | Email | `Entity.email` (приєднання за `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Кількість результатів, де `delivered_at` не є null (включає рядки, позначені як боти) | `total_received` | | Clicks # | Кількість, де `clicked_at` не є null **і** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Кількість, де `credential_submitted_at` не є null **і** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Кількість, де `reported_at` не є null (боти включені — це не перехід за посиланням/введення облікових даних) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Послідовні найновіші доставлені результати, у яких особа перейшла за посиланням (боти перериNають серію) | `current_click_streak` | | Last 5 assessments | П’ять найновіших доставлених результатів, розділених `"; "` (див. [пріоритет](#пріоритет-результатів-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Відсутні в `/v1` | Пропущені, а не null | Ключ приєднання, збережений для зіркової моделі даних: `entity_id`. ## Розбіжності із застарілим експортом * **Активність ботів не враховується в кількості переходів за посиланнями та введення облікових даних.** Експорт попереднього постачальника зараховував взаємодії автоматизованих сканерів / ботів як переходи за посиланнями та введення облікових даних. Цей запит цього не робить. Результат із `bot_activity_detected = true` усе одно є доставленою симуляцією — він враховується в `total_received` та в агрегатах повідомлень — але розглядається як відсутність переходу та відсутність введення даних: він не входить до `clicks` / `credential_submissions` і перериває поточну серію переходів за посиланнями. Не «виправляйте» це, зараховуючи ботів, щоб збігтися зі застарілим експортом. * **Повідомлення не має вищого пріоритету за перехід за посиланням** у `last_5_assessments`. Особа, яка перейшла за посиланням, а пізніше повідомила, отримує мітку `clicked`. * **Додаткові дані каталогу пропускаються, а не заповнюються null.** Відділ та подібні поля відсутні в `/v1`. * **Немає фільтра за часом на боці сервера.** `GET /v1/simulation_results` не має `delivered_after`. Запит обходить усі результати, а потім залишає `delivered_at` за останні 12 календарних місяців. Велика організація з тривалою історією може витратити більшу частину бюджету частоти запитів на ключ, ніж у разі відфільтрованого списку. ## Наступні кроки Облікові дані, розбиття на сторінки та завантаження цих запитів у Power BI або Excel. Фішингові взаємодії на рівні подій за останні 12 місяців. Зарахування на Training на рівні «особа × призначення». Надайте `simulation:read` та `entity:read` ключу, який оновлює цей звіт. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.