> ## 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. # Legfogékonyabb felhasználók > Egy korábbi szolgáltató 12 hónapos legfogékonyabb felhasználói összesítésének újraalkotása a /v1 szimulációs eredményeiből és entitásaiból. Ez a jelentés egy felhasználónkénti, 12 hónapos fogékonysági összesítés: soronként egy olyan személy szerepel, aki az elmúlt évben legalább egy szimulációt kapott. A jelentés tartalmazza a kattintások, a hitelesítő adatok megadásának és a bejelentések számát és arányát, az aktuális kattintási sorozatot, valamint az utolsó 5 eredmény összefűzött listáját. Az időablak **12 naptári hónap** (az UTC szerinti éjfél tizenkét hónappal ezelőtti, azonos hónapnapon), nem 365 napos időtartam. Az automatizált szkenner- és botinterakciók nem számítanak bele a kattintások és a hitelesítő adatok megadásának számába. Ez szándékos eltérés a korábbi exporttól. Lásd: [Eltérések a korábbi exporttól](#elt%C3%A9r%C3%A9sek-a-kor%C3%A1bbi-exportt%C3%B3l). A beállítás, a hitelesítő adatok, a lapozás és a sebességkorlát miatti újrapróbálkozás megegyezik a [Power BI / Excel kapcsolódási útmutatóban](/hu/developers/v1/powerbi) leírtakkal. Először adja hozzá a megosztott `Fn_FetchAll` lekérdezést; ez a jelentés névvel hivatkozik rá. ## Szükséges kulcshatókörök | Hatókör | Felhasználás | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (e-mail-cím és megjelenítendő név illesztése) | Ez a jelentés az **operatív**, személyenkénti eredménylistát használja, nem a jelentési előnézeti családot. Az a kulcs, amely csak `reporting:read` hatókört kapott, nem hívhatja meg a következőt: `GET /v1/simulation_results` (az API ezt adja vissza: `403`). Lásd: [válassza ki a megfelelő részletezettségi szintet](/hu/developers/v1/powerbi#a-megfelel%C5%91-granularit%C3%A1s-kiv%C3%A1laszt%C3%A1sa). ## Forrásvégpontok | Végpont | Szerep | | - | - | | `GET /v1/simulation_results` | Címzettenkénti eredmény. Ez a ténytábla részletezettségi szintje. | | `GET /v1/entities` | A `entity` értéket e-mail-címre és megjelenítendő névre oldja fel. Az eredménysor nem tartalmaz saját címzett e-mail-címet vagy megjelenítendő nevet (csak ezt: `entity`). | Az eredménylistán engedélyezett szűrők: `limit`, `page_token`, `simulation`, `entity`. Ezen a listán nincs `delivered_after` / `start_date`, ezért az elmúlt 12 hónap szűrését a Power Query végzi el a teljes bejárás után. Az egyes eredményeknél használt mezők: `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`. ### Részletezettségi szint Soronként egy entitás szerepel, amelynek legalább egy olyan eredménye van, amelynél a `delivered_at` az elmúlt 12 naptári hónapba esik. Az a személy, akit megcéloztak, de aki soha nem kapott kézbesítést, nem jelenik meg. Az ugyanahhoz a személyhez tartozó több szimuláció itt egyetlen sorrá összevonódik. Kérésköltségvetés: a szervezet minden szimulációs eredményének egy lapozott bejárása, plusz az entitások egy bejárása. Mindig állítsa be a következőt: `limit = "500"`. ## Eredmények elsőbbsége (`last_5_assessments`) Az öt legutóbbi kézbesített eredményt (`delivered_at` szerint csökkenő sorrendben) a `YYYY-MM-DD: ` összegzi. Az első egyező időbélyeg érvényesül, a legmagasabb prioritástól kezdve: | Prioritás | Időbélyeg | Eredménycímke | | - | - | - | | 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` | A csak kézbesített állapot a `no action` (az üzenet megérkezett, a személy nem tett semmit). Az a személy, aki rákattintott, majd később bejelentette, `clicked` állapotú – a bejelentés ezen a listán nem előzi meg a kockázatos interakciót. A botként megjelölt sorok is kapnak eredménycímkét a meglévő időbélyegek alapján; csak éppen nem növelik a kattintások és a hitelesítő adatok megadásának számát. **Aktuális kattintási sorozat:** ugyanezeket a kézbesített eredményeket járja végig a legújabbtól kezdve, és számolja meg az egymást követő sorokat, ahol a `clicked_at` nem null **és** a `bot_activity_detected` nem `true`. Az első ki nem elégítő soron álljon meg. ## Oszlopleképezés A korábbi oszlopnevek az Ön korábbi szolgáltatójának exportjából származnak. A `/v1` mezők a nyilvános API-nevek; a lekérdezés származtatja a darabszámokat és az arányokat. | Korábbi oszlop | `/v1` mező vagy származtatás | Jelentésoszlop | | - | - | - | | Email | `Entity.email` (illesztés ezen: `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Azon eredmények száma, ahol a `delivered_at` nem null (a botként megjelölt sorokat is beleértve) | `total_received` | | Clicks # | Azon sorok száma, ahol a `clicked_at` nem null **és** a `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Azon sorok száma, ahol a `credential_submitted_at` nem null **és** a `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Azon sorok száma, ahol a `reported_at` nem null (a botokat is beleértve – ez nem kattintás/hitelesítő adat megadása) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | A legújabb kézbesített eredmények közül egymás után hányra kattintott a személy (a botok megszakítják) | `current_click_streak` | | Last 5 assessments | Az öt legújabb kézbesített eredmény, elválasztva ezzel: `"; "` (lásd az [elsőbbséget](#eredmények-elsőbbsége-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Nem szerepel itt: `/v1` | Kihagyva, nem null értékkel | A csillagséma-modellhez megtartott illesztési kulcs: `entity_id`. ## Eltérések a korábbi exporttól * **A botaktivitás nem számít bele a kattintások és a hitelesítő adatok megadásának számába.** Egy korábbi szolgáltató exportja az automatizált szkenner- és botinterakciókat kattintásként és hitelesítő adatok megadásaként számolta. Ez a lekérdezés nem így tesz. Az a eredmény, amelynél `bot_activity_detected = true`, továbbra is kézbesített szimuláció – beleszámít a `total_received` értékbe és a bejelentési összesítésekbe –, de nem kattintásnak és nem adatmegadásnak minősül: kimarad a `clicks` / `credential_submissions` értékből, és megszakítja az aktuális kattintási sorozatot. Ne „javítsa” ezt a botok beszámításával a korábbi exporthoz igazítva. * **A bejelentés nem előzi meg a kattintást** ezen: `last_5_assessments`. Az a személy, aki rákattintott, majd később bejelentette, ezt a címkét kapja: `clicked`. * **A címtári kiegészítő adatok kimaradnak, nem null értékűek.** Az osztály és a hasonló mezők nem szerepelnek itt: `/v1`. * **Nincs kiszolgálóoldali időszűrő.** A `GET /v1/simulation_results` nem rendelkezik ezzel: `delivered_after`. A lekérdezés az összes eredményt bejárja, majd csak azokat tartja meg, amelyeknél a `delivered_at` az elmúlt 12 naptári hónapba esik. Egy nagy múltú szervezet esetében több kulcsonkénti sebességkeretet használhat fel, mint egy szűrt lista. ## Következő lépések Hitelesítő adatok, lapozás, valamint ezeknek a lekérdezéseknek a betöltése Power BI-ba vagy Excelbe. Eseményszintű adathalász-interakciók az elmúlt 12 hónapra. Képzési beiratkozások személy × hozzárendelés részletezettségi szinten. Adja meg a `simulation:read` és a `entity:read` hatókört a jelentést frissítő kulcsnak. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.