> ## 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. # Anfälligste Benutzer > Bilden Sie die 12-Monats-Auswertung der anfälligsten Benutzer eines früheren Anbieters anhand von /v1-Simulationsergebnissen und -Entitäten nach. Dieser Bericht ist eine 12-Monats-Auswertung der Anfälligkeit pro Benutzer: eine Zeile pro Person, die im zurückliegenden Jahr mindestens eine Simulation erhalten hat, mit Anzahl und Quote der Klicks, Zugangsdaten-Eingaben und Meldungen, einer aktuellen Klickserie und einer verketteten Liste der letzten 5 Ergebnisse. Der Zeitraum umfasst **12 Kalendermonate** (Mitternacht UTC am selben Tag des Monats zwölf Monate zuvor), nicht eine Dauer von 365 Tagen. Interaktionen automatisierter Scanner bzw. Bots werden aus den Zählungen von Klicks und Zugangsdaten-Eingaben ausgeschlossen. Dies ist eine bewusste Abweichung vom Legacy-Export. Siehe [Abweichungen vom Legacy-Export](#abweichungen-vom-legacy-export). Einrichtung, Zugangsdaten, Paginierung und Wiederholungsversuche bei Rate-Limits entsprechen dem [Leitfaden zur Power BI-/Excel-Anbindung](/de/developers/v1/powerbi). Fügen Sie zuerst die gemeinsame Abfrage `Fn_FetchAll` hinzu; dieser Bericht ruft sie über ihren Namen auf. ## Erforderliche Schlüssel-Scopes | Scope | Verwendung | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (Verknüpfung von E-Mail-Adresse und Anzeigename) | Dieser Bericht verwendet die **operative** Ergebnisliste pro Person, nicht die Reporting-Preview-Familie. Ein Schlüssel, dem nur `reporting:read` gewährt wurde, kann `GET /v1/simulation_results` nicht aufrufen (die API gibt `403` zurück). Siehe [Wahl der richtigen Granularität](/de/developers/v1/powerbi#die-passende-granularit%C3%A4t-w%C3%A4hlen). ## Quell-Endpunkte | Endpunkt | Rolle | | - | - | | `GET /v1/simulation_results` | Ergebnis pro Empfänger. Dies ist die Faktengranularität. | | `GET /v1/entities` | Löst `entity` in E-Mail-Adresse bzw. Anzeigename auf. Die Ergebniszeile enthält selbst keine E-Mail-Adresse und keinen Anzeigenamen des Empfängers (nur `entity`). | Zulässige Filter in der Ergebnisliste: `limit`, `page_token`, `simulation`, `entity`. In dieser Liste gibt es kein `delivered_after` / `start_date`, daher werden die zurückliegenden 12 Monate nach dem vollständigen Durchlauf in Power Query angewendet. Verwendete Felder pro Ergebnis: `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ät Eine Zeile pro Entität, die in den zurückliegenden 12 Kalendermonaten mindestens ein Ergebnis mit `delivered_at` hat. Eine Person, die zwar adressiert, aber nie zugestellt wurde, erscheint nicht. Mehrere Simulationen für dieselbe Person werden hier zusammengefasst. Anfragebudget: ein paginierter Durchlauf aller Simulationsergebnisse der Organisation sowie ein Durchlauf der Entitäten. Setzen Sie stets `limit = "500"`. ## Rangfolge der Ergebnisse (`last_5_assessments`) Jedes der fünf jüngsten zugestellten Ergebnisse (`delivered_at` absteigend) wird als `YYYY-MM-DD: ` zusammengefasst. Der erste zutreffende Zeitstempel gilt, beginnend mit der höchsten Priorität: | Priorität | Zeitstempel | Ergebnisbezeichnung | | - | - | - | | 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` | Nur zugestellt ist `no action` (die Nachricht wurde zugestellt; die Person hat nichts unternommen). Eine Person, die geklickt und später gemeldet hat, ist `clicked` – eine Meldung hat in dieser Liste keinen Vorrang vor einer riskanten Interaktion. Als Bot markierte Zeilen erhalten weiterhin eine Ergebnisbezeichnung anhand der vorhandenen Zeitstempel; sie erhöhen lediglich nicht die Zählungen von Klicks und Zugangsdaten-Eingaben. **Aktuelle Klickserie:** Gehen Sie dieselben zugestellten Ergebnisse beginnend mit dem neuesten durch und zählen Sie aufeinanderfolgende Zeilen, in denen `clicked_at` nicht null ist **und** `bot_activity_detected` nicht `true` ist. Brechen Sie beim ersten Fehltreffer ab. ## Spaltenzuordnung Die Namen der Legacy-Spalten stammen aus dem Export Ihres früheren Anbieters. Bei `/v1`-Feldern handelt es sich um die öffentlichen API-Namen; die Abfrage leitet die Zählungen und Quoten ab. | Legacy-Spalte | `/v1`-Feld oder Ableitung | Berichtsspalte | | - | - | - | | Email | `Entity.email` (Verknüpfung über `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Anzahl der Ergebnisse, bei denen `delivered_at` nicht null ist (einschließlich als Bot markierter Zeilen) | `total_received` | | Clicks # | Anzahl, bei der `clicked_at` nicht null ist **und** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Anzahl, bei der `credential_submitted_at` nicht null ist **und** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Anzahl, bei der `reported_at` nicht null ist (einschließlich Bots – kein Klick bzw. keine Zugangsdaten-Eingabe) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Aufeinanderfolgende neueste zugestellte Ergebnisse, bei denen die Person geklickt hat (Bots unterbrechen die Serie) | `current_click_streak` | | Last 5 assessments | Die fünf neuesten zugestellten Ergebnisse, getrennt durch `"; "` (siehe [Rangfolge](#rangfolge-der-ergebnisse-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Nicht in `/v1` | Weggelassen, nicht mit null befüllt | Für ein Sternschema-Modell beibehaltener Verknüpfungsschlüssel: `entity_id`. ## Abweichungen vom Legacy-Export * **Bot-Aktivität wird aus den Zählungen von Klicks und Zugangsdaten-Eingaben ausgeschlossen.** Der Export eines früheren Anbieters zählte Interaktionen automatisierter Scanner bzw. Bots als Klicks und Zugangsdaten-Eingaben. Diese Abfrage tut das nicht. Ein Ergebnis mit `bot_activity_detected = true` ist weiterhin eine zugestellte Simulation – es wird in `total_received` und in den Aggregaten zu Meldungen mitgezählt –, wird aber als Nicht-Klick und Nicht-Eingabe behandelt: Es wird in `clicks` / `credential_submissions` nicht berücksichtigt und unterbricht eine aktuelle Klick- serie. „Korrigieren“ Sie dies nicht, indem Sie Bots mitzählen, um den Legacy-Export nachzubilden. * **Eine Meldung hat keinen Vorrang vor einem Klick** in `last_5_assessments`. Eine Person, die geklickt und später gemeldet hat, wird als `clicked` bezeichnet. * **Verzeichniszusätze werden weggelassen, nicht mit null befüllt.** Abteilung und ähnliche Felder sind nicht in `/v1` enthalten. * **Kein serverseitiger Zeitfilter.** `GET /v1/simulation_results` hat keinen `delivered_after`. Die Abfrage durchläuft alle Ergebnisse und behält dann `delivered_at` in den zurückliegenden 12 Kalendermonaten. Eine große Organisation mit umfangreichem Verlauf verbraucht möglicherweise mehr vom Rate-Budget pro Schlüssel als eine gefilterte Liste. ## Nächste Schritte Zugangsdaten, Paginierung und das Laden dieser Abfragen in Power BI oder Excel. Phishing-Interaktionen auf Ereignisebene für die zurückliegenden 12 Monate. Schulungszuweisungen in der Granularität Person × Zuweisung. Gewähren Sie `simulation:read` und `entity:read` für den Schlüssel, der diesen Bericht aktualisiert. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.