Взаємодії автоматизованих сканерів і ботів не враховуються в кількості переходів за посиланнями та
введення облікових даних. Це свідоме розходження зі
застарілим експортом. Див.
Розбіжності із застарілим експортом.
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 не є null і
bot_activity_detected не дорівнює true. Зупиніться на першому пропуску.
Зіставлення стовпців
Назви застарілих стовпців походять з експорту вашого попереднього постачальника. Поля/v1
— це публічні назви API; запит обчислює кількості та частки.
Ключ приєднання, збережений для зіркової моделі даних:
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
Облікові дані, розбиття на сторінки та завантаження цих запитів у Power BI або Excel.
Журнал фішингових листів
Фішингові взаємодії на рівні подій за останні 12 місяців.
Відповідність вимогам для кожної особи
Зарахування на Training на рівні «особа × призначення».
Ключі API
Надайте
simulation:read та entity:read ключу, який оновлює цей звіт.
