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.
Fn_FetchAll hinzu; dieser Bericht ruft sie über ihren Namen auf.
Erforderliche Schlüssel-Scopes
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.
Quell-Endpunkte
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 mitdelivered_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: <outcome> zusammengefasst. Der erste zutreffende
Zeitstempel gilt, beginnend mit der höchsten Priorität:
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.
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 = trueist weiterhin eine zugestellte Simulation – es wird intotal_receivedund in den Aggregaten zu Meldungen mitgezählt –, wird aber als Nicht-Klick und Nicht-Eingabe behandelt: Es wird inclicks/credential_submissionsnicht 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 alsclickedbezeichnet. - Verzeichniszusätze werden weggelassen, nicht mit null befüllt. Abteilung und ähnliche
Felder sind nicht in
/v1enthalten. - Kein serverseitiger Zeitfilter.
GET /v1/simulation_resultshat keinendelivered_after. Die Abfrage durchläuft alle Ergebnisse und behält danndelivered_atin 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
Power BI- und Excel-Einrichtung
Zugangsdaten, Paginierung und das Laden dieser Abfragen in Power BI oder Excel.
E-Mail-Phishing-Protokoll
Phishing-Interaktionen auf Ereignisebene für die zurückliegenden 12 Monate.
Compliance pro Person
Schulungszuweisungen in der Granularität Person × Zuweisung.
API-Schlüssel
Gewähren Sie
simulation:read und entity:read für den Schlüssel, der diesen Bericht aktualisiert.
