Журнал фішингових електронних листів

Цей звіт є журналом фішингових подій на рівні окремих подій: один рядок на кожну зафіксовану взаємодію із симуляцією (дата, дія, адреса електронної пошти отримувача, тема, відправник, складність). Він залишається в довгому форматі й не зводить історію окремої особи до єдиного результату. Запит згортає останні 12 календарних місяців у occurred_after (північ за UTC того самого числа місяця дванадцять місяців тому — а не тривалість 365 днів). Налаштування, облікові дані, пагінація та повторні спроби за обмеження частоти запитів такі самі, як у посібнику з підключення Power BI / Excel. Спочатку додайте спільний запит Fn_FetchAll; цей звіт викликає його за назвою.

​

Required key scopes

Ключ, якому надано лише simulation:read, не може викликати кінцеву точку подій звітності (API повертає 403). Див. вибір правильної деталізації.

​

Source endpoints

Дозволені фільтри для списку подій (будь-які інші повертають 400): limit, page_token, simulation, entity, event_type, occurred_after. Це сімейство звітності є попереднім набором даних. Перегляньте схему набору даних і політики щодо даних за адресами GET /v1/reporting/datasets та GET /v1/reporting/datasets/simulation_events.

​

Grain

Один рядок на кожну подію симуляції у звітності. Особа, яка відкрила, а потім натиснула те саме повідомлення, створює два рядки. Події з порожнім entity_id (без ініціатора / отримувача / цільового учасника) також відображаються — email має значення null. Вікно API розширюється на одну хвилину; точна межа occurred_at >= WindowStart повторно застосовується локально, щоб останній рік не залежав від того, чи сервер трактує occurred_after як включну, чи як виключну. Бюджет запитів: один посторінковий обхід подій у вікні плюс один обхід сутностей. Завжди встановлюйте limit = "500".

​

Column mapping

Назви застарілих стовпців узято з експорту вашого попереднього постачальника. Поля /v1 — це публічні назви API; запит дає деяким із них псевдоніми для звіту.

​

Action tokens

action — це закритий токен звітності. Застаріле «Email Sent» відповідає simulation.delivered (delivered — публічне дієслово; токен у каналі передачі — simulation.delivered). Додаткові поля, збережені, оскільки вони є в API: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, а також entity_type і entity_status з приєднання сутностей.

​

Divergences from the legacy export

• Необроблена IP-адреса недоступна ніколи. /v1 не надаватиме необроблену IP-адресу клієнта — це приватність за задумом, а не відкладене зіставлення. Запит не додає стовпець-заповнювач для IP.
• Тип пристрою є похідним, а не необробленим. device_type — це похідний клас пристрою для подій натискання, надсилання та повідомлення. Серед спостережуваних токенів: desktop, mobile, tablet і unknown, проте джерело зберігає довільний рядок — вважайте його відкритим текстом, а не закритим переліком. Значення null, якщо подія не має похідного класу, а необроблений рядок user_agent залишається приватним.
• «Email Sent» — це simulation.delivered. Використовуйте цей токен під час фільтрації або підрахунку надісланих листів. Не шукайте застарілий рядок email_sent.
• Адреса електронної пошти отримувача — це приєднання, а не поле події. Подія звітності не містить адреси електронної пошти; запит обходить /entities, щоб заповнити її.
• Останні 12 календарних місяців, а не тривалість 365 днів і не вся історія.
• Довгий формат, без згортання. Один рядок на взаємодію, а не один результат на особу.

​

Next steps