> ## 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. # Alttiimmat käyttäjät > Luo uudelleen aiemman palveluntarjoajan 12 kuukauden yhteenveto alttiimmista käyttäjistä /v1-simulaatiotuloksista ja -entiteeteistä. Tämä raportti on käyttäjäkohtainen 12 kuukauden alttiusyhteenveto: yksi rivi jokaista henkilöä kohden, joka on saanut vähintään yhden simulaation viimeisen vuoden aikana, sisältäen klikkausten, tunnistetietojen ja ilmoitusten määrät ja osuudet, nykyisen klikkausputken sekä yhdistetyn luettelon viimeisen viiden simulaation tuloksista. Aikaikkuna on **12 kalenterikuukautta** (UTC-aikaa keskiyö samana kuukauden päivänä kaksitoista kuukautta sitten), ei 365 päivän jakso. Automaattiset skannerien ja bottien vuorovaikutukset jätetään pois klikkausten ja tunnistetietojen syöttöjen määristä. Tämä on tietoinen poikkeama vanhasta viennistä. Katso [Poikkeamat vanhaan vientiin verrattuna](#poikkeamat-vanhaan-vientiin-verrattuna). Asetukset, tunnistetiedot, sivutus ja nopeusrajoituksen jälkeinen uudelleenyritys ovat samat kuin [Power BI / Excel -yhteysoppaassa](/fi/developers/v1/powerbi). Lisää ensin jaettu `Fn_FetchAll`-kysely; tämä raportti kutsuu sitä nimellä. ## Vaaditut avaimen oikeudet | Oikeus | Käyttötarkoitus | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (sähköpostin ja näyttönimen liitos) | Tämä raportti käyttää **operatiivista** henkilökohtaisten tulosten luetteloa, ei raportoinnin esikatseluryhmää. Avain, jolle on myönnetty vain `reporting:read`, ei voi kutsua `GET /v1/simulation_results` (API palauttaa `403`). Katso [valitse oikea tarkkuustaso](/fi/developers/v1/powerbi#valitse-oikea-granulaarisuus). ## Lähteenä käytettävät päätepisteet | Päätepiste | Rooli | | - | - | | `GET /v1/simulation_results` | Vastaanottajakohtainen tulos. Tämä on faktojen tarkkuustaso. | | `GET /v1/entities` | Muuntaa `entity`-arvon sähköpostiosoitteeksi / näyttönimeksi. Tulosrivillä ei ole omaa vastaanottajan sähköpostiosoitetta tai näyttönimeä (vain `entity`). | Tulosluettelon sallittujen luettelon suodattimet: `limit`, `page_token`, `simulation`, `entity`. Tässä luettelossa ei ole `delivered_after`-/`start_date`-suodatinta, joten viimeisten 12 kuukauden rajaus tehdään Power Queryssa koko läpikäynnin jälkeen. Jokaisella tuloksella käytetyt kentät: `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`. ### Tarkkuustaso Yksi rivi jokaista entiteettiä kohden, jolla on vähintään yksi tulos, jossa `delivered_at` sijoittuu viimeisten 12 kalenterikuukauden sisään. Henkilö, joka on kohdennettu mutta jolle ei koskaan toimitettu, ei näy raportissa. Saman henkilön useat simulaatiot yhdistetään tässä. Pyyntöbudjetti: yksi sivutettu läpikäynti kaikista organisaation simulaatiotuloksista sekä yksi läpikäynti entiteeteistä. Aseta aina `limit = "500"`. ## Tulosten etusijajärjestys (`last_5_assessments`) Jokainen viidestä viimeisimmästä toimitetusta tuloksesta (`delivered_at` laskevasti) tiivistetään muotoon `YYYY-MM-DD: `. Ensimmäinen vastaava aikaleima voittaa, korkein prioriteetti ensin: | Prioriteetti | Aikaleima | Tuloksen nimike | | - | - | - | | 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` | Pelkkä toimitettu on `no action` (viesti saapui perille; henkilö ei tehnyt mitään). Henkilö, joka klikkasi ja ilmoitti myöhemmin, on `clicked` — ilmoitus ei ohita riskialtista vuorovaikutusta tässä luettelossa. Bottimerkityt rivit saavat silti tulosnimikkeen olemassa olevien aikaleimojen perusteella; ne vain eivät kasvata klikkausten tai tunnistetietojen määriä. **Nykyinen klikkausputki:** käy läpi samat toimitetut tulokset uusimmasta vanhimpaan ja laske peräkkäiset rivit, joilla `clicked_at` ei ole tyhjä **ja** `bot_activity_detected` ei ole `true`. Lopeta ensimmäiseen poikkeamaan. ## Sarakkeiden yhdistäminen Vanhat sarakenimet ovat aiemman palveluntarjoajan viennistä. `/v1`-kentät ovat julkisen API:n nimiä; kysely johtaa määrät ja osuudet. | Vanha sarake | `/v1`-kenttä tai johtaminen | Raportin sarake | | - | - | - | | Email | `Entity.email` (liitos avaimella `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Niiden tulosten määrä, joissa `delivered_at` ei ole tyhjä (sisältää bottimerkityt rivit) | `total_received` | | Clicks # | Määrä, jossa `clicked_at` ei ole tyhjä **ja** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Määrä, jossa `credential_submitted_at` ei ole tyhjä **ja** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Niiden tulosten määrä, joissa `reported_at` ei ole tyhjä (botit mukaan lukien — ei klikkaus eikä tunnistetietojen syöttö) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Peräkkäiset uusimmat toimitetut tulokset, joissa henkilö klikkasi (botit katkaisevat putken) | `current_click_streak` | | Last 5 assessments | Viisi uusinta toimitettua tulosta, erotettuna merkillä `"; "` (katso [etusijajärjestys](#tulosten-etusijajärjestys-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Ei kohteessa `/v1` | Jätetty pois, ei asetettu tyhjäksi | Tähtikaaviomallia varten säilytettävä liitosavain: `entity_id`. ## Poikkeamat vanhaan vientiin verrattuna * **Bottiaktiviteetti jätetään pois klikkausten ja tunnistetietojen syöttöjen määristä.** Aiemman palveluntarjoajan vienti laski automaattiset skannerien ja bottien vuorovaikutukset klikkauksiksi ja tunnistetietojen syötöiksi. Tämä kysely ei tee niin. Tulos, jolla on `bot_activity_detected = true`, on silti toimitettu simulaatio — se lasketaan mukaan kohteeseen `total_received` ja ilmoitettujen yhteenvetoihin — mutta sitä käsitellään ei-klikkauksena ja ei-syöttönä: se jätetään pois kohteista `clicks` / `credential_submissions` ja se katkaisee nykyisen klikkausputken. Älä "korjaa" tätä laskemalla botteja mukaan vastaamaan vanhaa vientiä. * **Ilmoitus ei ohita klikkausta** kohteessa `last_5_assessments`. Henkilö, joka klikkasi ja ilmoitti myöhemmin, saa nimikkeen `clicked`. * **Hakemistolisätiedot jätetään pois, ei aseteta tyhjiksi.** Osasto ja vastaavat kentät eivät ole kohteessa `/v1`. * **Ei palvelinpuolen aikasuodatinta.** Kohteessa `GET /v1/simulation_results` ei ole `delivered_after`. Kysely käy läpi kaikki tulokset ja säilyttää sitten `delivered_at` viimeisten 12 kalenterikuukauden ajalta. Suuri historiallinen organisaatio voi kuluttaa avainkohtaisesta nopeusbudjetista enemmän kuin suodatettu luettelo kuluttaisi. ## Seuraavat vaiheet Tunnistetiedot, sivutus ja näiden kyselyjen lataaminen Power BI:hin tai Exceliin. Tapahtumatason tietojenkalasteluvuorovaikutukset viimeisten 12 kuukauden ajalta. Koulutus-ilmoittautumiset henkilö × tehtävä -tarkkuustasolla. Myönnä `simulation:read` ja `entity:read` tämän raportin päivittävälle avaimelle. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.