> ## 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. # Visneaizsargātākie lietotāji > Atveidojiet iepriekšējā nodrošinātāja 12 mēnešu visneaizsargātāko lietotāju kopsavilkumu, izmantojot /v1 simulāciju rezultātus un entītijas. Šis pārskats ir 12 mēnešu neaizsargātības kopsavilkums katram lietotājam: viena rinda katrai personai, kas pēdējā gada laikā saņēmusi vismaz vienu simulāciju, ar klikšķu, akreditācijas datu un ziņojumu skaitu un īpatsvaru, pašreizējo klikšķu sēriju un apvienotu pēdējo 5 iznākumu sarakstu. Laika logs ir **12 kalendārie mēneši** (UTC pusnakts tajā pašā mēneša dienā pirms divpadsmit mēnešiem), nevis 365 dienu ilgums. Automatizēto skeneru / robotprogrammatūras mijiedarbības tiek izslēgtas no klikšķu un akreditācijas datu skaita. Tā ir apzināta atšķirība no mantotā eksporta. Skatiet [Atšķirības no mantotā eksporta](#at%C5%A1%C4%B7ir%C4%ABbas-no-mantot%C4%81-eksporta). Iestatīšana, akreditācijas dati, lapošana un ātruma ierobežojuma atkārtoti mēģinājumi ir tādi paši kā [Power BI / Excel savienojamības rokasgrāmatā](/lv/developers/v1/powerbi). Vispirms pievienojiet kopīgo `Fn_FetchAll` vaicājumu; šis pārskats to izsauc pēc nosaukuma. ## Nepieciešamie atslēgas tvērumi | Scope | Izmantošanas mērķis | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (e-pasta adreses un attēlojamā vārda savienošana) | Šis pārskats izmanto **operatīvo** rezultātu sarakstu par katru personu, nevis pārskatu priekšskatījuma saimi. Atslēga, kurai piešķirts tikai `reporting:read`, nevar izsaukt `GET /v1/simulation_results` (API atgriež `403`). Skatiet [izvēlieties pareizo granularitāti](/lv/developers/v1/powerbi#izv%C4%93lieties-pareizo-granularit%C4%81ti). ## Avota galapunkti | Endpoint | Loma | | - | - | | `GET /v1/simulation_results` | Iznākums katram adresātam. Tā ir faktu granularitāte. | | `GET /v1/entities` | Pārvērš `entity` → e-pasta adrese / attēlojamais vārds. Rezultātu rindā nav paša adresāta e-pasta adreses vai attēlojamā vārda (tikai `entity`). | Atļautie filtri rezultātu sarakstā: `limit`, `page_token`, `simulation`, `entity`. Šim sarakstam nav `delivered_after` / `start_date`, tāpēc pēdējie 12 mēneši tiek lietoti Power Query pēc pilnās apstaigāšanas. Katrā rezultātā izmantotie lauki: `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`. ### Granularitāte Viena rinda katrai entītijai, kurai pēdējos 12 kalendāros mēnešos ir vismaz viens rezultāts ar `delivered_at`. Persona, kas bijusi mērķauditorija, bet kurai nekad nav piegādāts ziņojums, neparādās. Vairākas simulācijas vienai personai šeit tiek apvienotas. Pieprasījumu budžets: viena lapota visu organizācijas simulāciju rezultātu apstaigāšana plus viena entītiju apstaigāšana. Vienmēr iestatiet `limit = "500"`. ## Iznākuma prioritāte (`last_5_assessments`) Katrs no pieciem jaunākajiem piegādātajiem rezultātiem (`delivered_at` dilstošā secībā) tiek apkopots kā `YYYY-MM-DD: `. Uzvar pirmā atbilstošā laikspiedola vērtība, sākot ar augstāko prioritāti: | Prioritāte | Laikspiedols | Iznākuma etiķete | | - | - | - | | 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` | Tikai piegādāts ir `no action` (ziņojums ir saņemts; persona neko nedarīja). Persona, kas noklikšķināja un vēlāk ziņoja, ir `clicked` — ziņošana šajā sarakstā neuzvar riskantu mijiedarbību. Robotprogrammatūras atzīmētās rindas joprojām saņem iznākuma etiķeti pēc esošajiem laikspiedoliem; tās tikai nepalielina klikšķu / akreditācijas datu skaitu. **Pašreizējā klikšķu sērija:** apstaigājiet tos pašus piegādātos rezultātus no jaunākā uz vecāko un skaitiet secīgas rindas, kurās `clicked_at` nav null **un** `bot_activity_detected` nav `true`. Apstājieties pie pirmās neatbilstības. ## Kolonnu kartējums Mantotās kolonnu nosaukumi ir no jūsu iepriekšējā nodrošinātāja eksporta. `/v1` lauki ir publiskie API nosaukumi; vaicājums atvasina skaitus un īpatsvarus. | Mantotā kolonna | `/v1` lauks vai atvasinājums | Pārskata kolonna | | - | - | - | | Email | `Entity.email` (savienošana pēc `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Rezultātu skaits, kuros `delivered_at` nav null (ietver robotprogrammatūras atzīmētās rindas) | `total_received` | | Clicks # | Skaits, kur `clicked_at` nav null **un** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Skaits, kur `credential_submitted_at` nav null **un** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Skaits, kur `reported_at` nav null (ieskaitot robotprogrammatūru — tas nav klikšķis/akreditācijas dati) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Secīgi jaunākie piegādātie rezultāti, kuros persona noklikšķināja (robotprogrammatūra to pārtrauc) | `current_click_streak` | | Last 5 assessments | Pieci jaunākie piegādātie iznākumi, atdalīti ar `"; "` (skatiet [prioritāti](#iznākuma-prioritāte-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Nav pieejams `/v1` | Izlaists, nevis aizpildīts ar null | Zvaigžņu shēmas modelim saglabātā savienošanas atslēga: `entity_id`. ## Atšķirības no mantotā eksporta * **Robotprogrammatūras aktivitāte tiek izslēgta no klikšķu un akreditācijas datu skaita.** Iepriekšējā nodrošinātāja eksports automatizēto skeneru / robotprogrammatūras mijiedarbības skaitīja kā klikšķus un akreditācijas datu iesniegšanu. Šis vaicājums to nedara. Rezultāts ar `bot_activity_detected = true` joprojām ir piegādāta simulācija — tas tiek ieskaitīts `total_received` un ziņošanas apkopojumos —, bet tiek uzskatīts par neklikšķi un neiesniegšanu: tas tiek izlaists no `clicks` / `credential_submissions` un pārtrauc pašreizējo klikšķu sēriju. Nemēģiniet to “labot”, skaitot robotprogrammatūru, lai atbilstu mantotajam eksportam. * **Ziņošana neuzvar klikšķi** `last_5_assessments`. Persona, kas noklikšķināja un vēlāk ziņoja, tiek atzīmēta kā `clicked`. * **Direktorijas papildu lauki tiek izlaisti, nevis aizpildīti ar null.** Nodaļa un līdzīgi lauki nav pieejami `/v1`. * **Nav servera puses laika filtra.** `GET /v1/simulation_results` nav `delivered_after`. Vaicājums apstaigā visus rezultātus, pēc tam paturot `delivered_at` pēdējos 12 kalendāros mēnešos. Liela vēsturiska organizācija var patērēt lielāku daļu no atslēgas ātruma budžeta nekā filtrēts saraksts. ## Nākamie soļi Akreditācijas dati, lapošana un šo vaicājumu ielāde programmās Power BI vai Excel. Pikšķerēšanas mijiedarbības notikumu līmenī pēdējiem 12 mēnešiem. Training pieteikumi granularitātē persona × uzdevums. Piešķiriet `simulation:read` un `entity:read` atslēgai, kas atsvaidzina šo pārskatu. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.