> ## 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.

# Najbardziej podatni użytkownicy

> Odtwórz 12-miesięczne zestawienie najbardziej podatnych użytkowników z poprzedniego dostawcy na podstawie wyników symulacji i encji z /v1.

Ten raport to zestawienie podatności na poziomie poszczególnych użytkowników z ostatnich 12 miesięcy: jeden wiersz na każdą osobę, która w ciągu ostatniego roku otrzymała co najmniej jedną symulację, wraz z liczbą i odsetkiem kliknięć, podanych poświadczeń i zgłoszeń, bieżącą serią kliknięć oraz połączoną listą wyników z ostatnich 5 symulacji.

Okno czasowe obejmuje **12 miesięcy kalendarzowych** (północ UTC w tym samym dniu miesiąca dwanaście miesięcy wcześniej), a nie okres 365 dni.

<Note>
  Interakcje automatycznych skanerów i botów są wyłączone z liczby kliknięć i podanych poświadczeń. Jest to celowa różnica względem eksportu ze starego systemu. Zobacz
  [Różnice względem eksportu ze starego systemu](#r%C3%B3%C5%BCnice-wzgl%C4%99dem-eksportu-ze-starego-systemu).
</Note>

Konfiguracja, poświadczenia, stronicowanie i ponawianie po przekroczeniu limitu żądań są takie same jak w
[przewodniku po łączności z Power BI / Excel](/pl/developers/v1/powerbi). Najpierw dodaj wspólne zapytanie
`Fn_FetchAll`; ten raport wywołuje je po nazwie.

## Wymagane zakresy klucza

| Zakres | Zastosowanie |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (złączenie adresu e-mail i nazwy wyświetlanej) |

Ten raport korzysta z **operacyjnej** listy wyników na poziomie poszczególnych osób, a nie z rodziny podglądów raportowych. Klucz z uprawnieniem wyłącznie `reporting:read` nie może wywołać
`GET /v1/simulation_results` (API zwraca `403`). Zobacz
[wybór odpowiedniego poziomu szczegółowości](/pl/developers/v1/powerbi#wyb%C3%B3r-w%C5%82a%C5%9Bciwego-poziomu-szczeg%C3%B3%C5%82owo%C5%9Bci).

## Punkty końcowe źródła

| Punkt końcowy | Rola |
| - | - |
| `GET /v1/simulation_results` | Wynik dla poszczególnego odbiorcy. To jest poziom szczegółowości faktów. |
| `GET /v1/entities` | Zamienia `entity` na adres e-mail / nazwę wyświetlaną. Wiersz wyniku nie zawiera własnego adresu e-mail ani nazwy wyświetlanej odbiorcy (tylko `entity`). |

Filtry dozwolone na liście wyników: `limit`, `page_token`,
`simulation`, `entity`. Na tej liście nie ma `delivered_after` / `start_date`, więc ostatnie 12 miesięcy jest stosowane w Power Query po pobraniu wszystkich danych.

Pola używane w każdym wyniku: `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`.

### Poziom szczegółowości

Jeden wiersz na każdą encję, która ma co najmniej jeden wynik z `delivered_at` w ciągu ostatnich 12 miesięcy kalendarzowych. Osoba, która była celem, ale nie otrzymała wiadomości, nie pojawia się w raporcie. Wiele symulacji dla tej samej osoby jest tu zagregowanych w jeden wiersz.

Budżet żądań: jedno stronicowane przejście przez wszystkie wyniki symulacji w organizacji oraz jedno przejście przez encje. Zawsze ustawiaj `limit = "500"`.

## Pierwszeństwo wyników (`last_5_assessments`)

Każdy z pięciu ostatnich dostarczonych wyników (`delivered_at`
malejąco) jest podsumowywany jako `YYYY-MM-DD: <outcome>`. Wygrywa pierwszy pasujący znacznik czasu, zaczynając od najwyższego priorytetu:

| Priorytet | Znacznik czasu | Etykieta wyniku |
| - | - | - |
| 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` |

Wynik „tylko dostarczono” to `no action` (wiadomość dotarła, a osoba nic nie zrobiła). Osoba, która kliknęła, a później zgłosiła wiadomość, ma wynik `clicked` — na tej liście zgłoszenie nie ma pierwszeństwa przed ryzykowną interakcją. Wiersze oznaczone jako boty nadal otrzymują etykietę wyniku na podstawie obecnych znaczników czasu; po prostu nie zwiększają liczby kliknięć ani podanych poświadczeń.

**Bieżąca seria kliknięć:** przejdź przez te same dostarczone wyniki od najnowszego i policz kolejne wiersze, w których `clicked_at` ma wartość inną niż null **oraz** `bot_activity_detected` nie jest `true`. Zatrzymaj się na pierwszym niespełniającym warunku.

## Mapowanie kolumn

Nazwy kolumn starego systemu pochodzą z eksportu poprzedniego dostawcy. Pola `/v1` to publiczne nazwy API; zapytanie wylicza liczby i odsetki.

| Kolumna starego systemu | Pole `/v1` lub sposób wyliczenia | Kolumna raportu |
| - | - | - |
| Email | `Entity.email` (złączenie po `Result.entity`) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | Liczba wyników, w których `delivered_at` ma wartość inną niż null (obejmuje wiersze oznaczone jako boty) | `total_received` |
| Clicks # | Liczba wyników, w których `clicked_at` ma wartość inną niż null **oraz** `bot_activity_detected` ≠ `true` | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | Liczba wyników, w których `credential_submitted_at` ma wartość inną niż null **oraz** `bot_activity_detected` ≠ `true` | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | Liczba wyników, w których `reported_at` ma wartość inną niż null (łącznie z botami — to nie jest kliknięcie ani podanie poświadczeń) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | Kolejne najnowsze dostarczone wyniki, w których osoba kliknęła (boty przerywają serię) | `current_click_streak` |
| Last 5 assessments | Pięć najnowszych dostarczonych wyników, rozdzielonych znakiem `"; "` (zobacz [pierwszeństwo](#pierwszeństwo-wyników-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | Nie występuje w `/v1` | Pominięte, nie ustawione na null |

Klucz złączenia zachowany na potrzeby modelu gwiazdy: `entity_id`.

## Różnice względem eksportu ze starego systemu

* **Aktywność botów jest wyłączona z liczby kliknięć i podanych poświadczeń.** Eksport poprzedniego dostawcy liczył interakcje automatycznych skanerów i botów jako kliknięcia i podanie poświadczeń. To zapytanie tego nie robi. Wynik z `bot_activity_detected = true` nadal jest dostarczoną symulacją — jest wliczany do `total_received` oraz do zagregowanych zgłoszeń — ale jest traktowany jako brak kliknięcia i brak podania poświadczeń: jest pomijany w `clicks` / `credential_submissions` i przerywa bieżącą serię kliknięć. Nie „naprawiaj” tego, wliczając boty w celu dopasowania do eksportu ze starego systemu.
* **Zgłoszenie nie ma pierwszeństwa przed kliknięciem** w `last_5_assessments`. Osoba, która kliknęła, a później zgłosiła wiadomość, otrzymuje etykietę `clicked`.
* **Dodatkowe dane katalogowe są pomijane, a nie ustawiane na null.** Dział i podobne pola nie występują w `/v1`.
* **Brak filtra czasu po stronie serwera.** `GET /v1/simulation_results` nie ma
  `delivered_after`. Zapytanie przechodzi przez wszystkie wyniki, a następnie zachowuje
  `delivered_at` z ostatnich 12 miesięcy kalendarzowych. Duża organizacja z długą historią może zużyć większą część budżetu limitu żądań przypadającego na klucz niż w przypadku listy z filtrem.

## Następne kroki

<CardGroup cols={2}>
  <Card title="Konfiguracja Power BI i Excel" href="/pl/developers/v1/powerbi">
    Poświadczenia, stronicowanie oraz ładowanie tych zapytań w Power BI lub Excelu.
  </Card>

  <Card title="Dziennik wiadomości phishingowych" href="/pl/developers/v1/reports/email-phishing-log">
    Interakcje phishingowe na poziomie zdarzeń z ostatnich 12 miesięcy.
  </Card>

  <Card title="Zgodność na poziomie osoby" href="/pl/developers/v1/reports/per-person-compliance">
    Zapisy na Szkolenie na poziomie osoba × przypisanie.
  </Card>

  <Card title="Klucze API" href="/pl/developers/developer-hub/api-keys">
    Przyznaj `simulation:read` i `entity:read` dla klucza, który odświeża ten raport.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.