> ## 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. # Nejcitlivější uživatelé > Znovu vytvořte 12měsíční souhrn nejcitlivějších uživatelů z předchozího poskytovatele na základě výsledků simulací a entit z /v1. Tento report je souhrn náchylnosti jednotlivých uživatelů za 12 měsíců: jeden řádek pro každou osobu, která za uplynulý rok obdržela alespoň jednu simulaci, s počty a mírami kliknutí, zadání přihlašovacích údajů a nahlášení, aktuální sérií kliknutí a zřetězeným seznamem posledních 5 výsledků. Časové okno tvoří **12 kalendářních měsíců** (půlnoc UTC ve stejný den v měsíci před dvanácti měsíci), nikoli období 365 dnů. Interakce automatizovaných skenerů a botů jsou z počtů kliknutí a přihlašovacích údajů vyloučeny. Jde o záměrnou odchylku od původního exportu. Viz [Odchylky od původního exportu](#odchylky-od-p%C5%AFvodn%C3%ADho-exportu). Nastavení, přihlašovací údaje, stránkování a opakování při překročení limitu požadavků jsou stejné jako v [průvodci připojením Power BI / Excel](/cs/developers/v1/powerbi). Nejprve přidejte sdílený dotaz `Fn_FetchAll`; tento report jej volá podle názvu. ## Požadované rozsahy klíče | Rozsah | Použití | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (propojení e-mailu a zobrazovaného jména) | Tento report používá **operativní** seznam výsledků jednotlivých osob, nikoli rodinu reportingových náhledů. Klíč, kterému byl udělen pouze `reporting:read`, nemůže volat `GET /v1/simulation_results` (rozhraní API vrátí `403`). Viz [výběr správné granularity](/cs/developers/v1/powerbi#v%C3%BDb%C4%9Br-spr%C3%A1vn%C3%A9-granularity). ## Zdrojové koncové body | Koncový bod | Role | | - | - | | `GET /v1/simulation_results` | Výsledek pro jednotlivého příjemce. Toto je faktová granularita. | | `GET /v1/entities` | Převádí `entity` → e-mail / zobrazované jméno. Řádek výsledku neobsahuje vlastní e-mail ani zobrazované jméno příjemce (pouze `entity`). | Povolené filtry v seznamu výsledků: `limit`, `page_token`, `simulation`, `entity`. V tomto seznamu není `delivered_after` / `start_date`, proto se posledních 12 měsíců aplikuje v Power Query po úplném projití všech záznamů. Pole použitá u každého výsledku: `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`. ### Granularita Jeden řádek pro každou entitu, která má alespoň jeden výsledek s `delivered_at` v posledních 12 kalendářních měsících. Osoba, která byla cílem, ale které nebylo nikdy nic doručeno, se nezobrazí. Více simulací pro stejnou osobu se zde sloučí. Rozpočet požadavků: jedno stránkované projití všech výsledků simulací v organizaci a jedno projití entit. Vždy nastavte `limit = "500"`. ## Priorita výsledků (`last_5_assessments`) Každý z pěti nejnovějších doručených výsledků (`delivered_at` sestupně) je shrnut jako `YYYY-MM-DD: `. Platí první odpovídající časové razítko, od nejvyšší priority: | Priorita | Časové razítko | Označení výsledku | | - | - | - | | 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` | Pouze doručeno je `no action` (zpráva byla doručena; osoba neudělala nic). Osoba, která klikla a později nahlásila, je `clicked` – nahlášení nemá v tomto seznamu přednost před rizikovou interakcí. Řádky označené jako boti stále získají označení výsledku podle přítomných časových razítek; pouze nezvyšují počty kliknutí / přihlašovacích údajů. **Aktuální série kliknutí:** projděte stejné doručené výsledky od nejnovějšího a počítejte po sobě jdoucí řádky, kde `clicked_at` není null **a** `bot_activity_detected` není `true`. Na prvním nesplnění skončete. ## Mapování sloupců Názvy původních sloupců pocházejí z exportu vašeho předchozího poskytovatele. Pole `/v1` jsou názvy veřejného rozhraní API; dotaz z nich odvozuje počty a míry. | Původní sloupec | Pole nebo odvození `/v1` | Sloupec reportu | | - | - | - | | Email | `Entity.email` (propojení přes `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Počet výsledků, kde `delivered_at` není null (zahrnuje řádky označené jako boti) | `total_received` | | Clicks # | Počet, kde `clicked_at` není null **a** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Počet, kde `credential_submitted_at` není null **a** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Počet, kde `reported_at` není null (boti zahrnuti – nejde o kliknutí ani zadání přihlašovacích údajů) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Po sobě jdoucí nejnovější doručené výsledky, na které osoba klikla (boti sérii přerušují) | `current_click_streak` | | Last 5 assessments | Pět nejnovějších doručených výsledků, oddělených pomocí `"; "` (viz [priorita](#priorita-výsledků-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Není v `/v1` | Vynecháno, nenahrazeno hodnotou null | Klíč pro propojení uchovaný pro model typu hvězda: `entity_id`. ## Odchylky od původního exportu * **Aktivita botů je vyloučena z počtů kliknutí a přihlašovacích údajů.** Export předchozího poskytovatele počítal interakce automatizovaných skenerů a botů jako kliknutí a zadání přihlašovacích údajů. Tento dotaz je nepočítá. Výsledek s `bot_activity_detected = true` je stále doručenou simulací – započítává se do `total_received` a do agregací nahlášení – ale považuje se za nekliknutí a nezadání údajů: je vynechán z `clicks` / `credential_submissions` a přerušuje aktuální sérii kliknutí. „Neopravujte“ to započítáním botů, aby výsledek odpovídal původnímu exportu. * **Nahlášení nemá přednost před kliknutím** u `last_5_assessments`. Osoba, která klikla a později nahlásila, je označena jako `clicked`. * **Doplňková data z adresáře jsou vynechána, nikoli nahrazena hodnotou null.** Oddělení a podobná pole nejsou v `/v1`. * **Žádný filtr času na straně serveru.** `GET /v1/simulation_results` nemá `delivered_after`. Dotaz projde všechny výsledky a poté ponechá `delivered_at` v posledních 12 kalendářních měsících. Velká historická organizace může spotřebovat větší část rozpočtu limitu požadavků na klíč, než by spotřeboval filtrovaný seznam. ## Další kroky Přihlašovací údaje, stránkování a načítání těchto dotazů v Power BI nebo Excelu. Phishingové interakce na úrovni událostí za posledních 12 měsíců. Zápisy do školení na granularitě osoba × přiřazení. Udělte `simulation:read` a `entity:read` klíči, který tento report aktualizuje. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.