> ## 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. # E-Mail-Phishing-Protokoll > Bilden Sie das Phishing-Protokoll auf Ereignisebene eines früheren Anbieters aus den /v1-Reporting-Simulationsereignissen und -Entitäten nach. Dieser Bericht ist ein Phishing-Protokoll auf Ereignisebene: eine Zeile pro beobachteter Simulationsinteraktion (Datum, Aktion, E-Mail-Adresse des Empfängers, Betreff, Absender, Schwierigkeitsgrad). Er bleibt im Langformat – die Historie einer Person wird nicht zu einem einzelnen Ergebnis zusammengeführt. Die Abfrage bezieht die letzten **12 Kalendermonate** in `occurred_after` ein (Mitternacht UTC am selben Tag des Monats vor zwölf Monaten – nicht als Zeitspanne von 365 Tagen). Die rohe Client-IP ist nie auf `/v1` enthalten – Datenschutz durch Technikgestaltung, keine ausstehende Zuordnung. Der Gerätetyp ist eine abgeleitete Klasse in der Ereigniszeile; der rohe `user_agent` bleibt privat. Siehe [Abweichungen vom bisherigen Export](#abweichungen-vom-bisherigen-export). Einrichtung, Anmeldedaten, Paginierung und Wiederholungsversuche bei Ratenbegrenzung 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üsselberechtigungen | Berechtigung | Verwendung für | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (Verknüpfung über E-Mail-Adresse und Anzeigename) | Ein Schlüssel, dem nur `simulation:read` gewährt wurde, kann den Reporting-Endpunkt für Ereignisse nicht aufrufen (die API gibt `403` zurück). Siehe [Die richtige Granularität wählen](/de/developers/v1/powerbi#die-passende-granularit%C3%A4t-w%C3%A4hlen). ## Quellendpunkte | Endpunkt | Rolle | | - | - | | `GET /v1/reporting/simulation_events` | Fakt auf Ereignisebene. Die Granularität ist eine getippte Interaktion. `email_subject`, `sender_email`, `sender_domain` und `difficulty_tier` befinden sich in dieser Zeile, daher verknüpft die Abfrage für diese Felder keine Ergebnisse auf Kampagnenebene. | | `GET /v1/entities` | Löst `entity_id` in E-Mail-Adresse bzw. Anzeigename auf. Das Reporting-Ereignis enthält keine E-Mail-Adresse des Empfängers (ein fester Ausschluss im Reporting-Reader). Das Durchlaufen von `/entities` füllt die bisherige Spalte „E-Mail“. | Zulässige Filter für die Ereignisliste (alles andere liefert `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Diese Reporting-Familie ist ein [Vorschau-Datensatz](/de/developers/v1/powerbi#reporting-preview-datasets-phishing-pro-person). Das Datensatzschema und die Datenrichtlinien können Sie unter `GET /v1/reporting/datasets` und `GET /v1/reporting/datasets/simulation_events` einsehen. ### Granularität Eine Zeile pro Reporting-Simulationsereignis. Eine Person, die dieselbe Nachricht geöffnet und anschließend darauf geklickt hat, erzeugt zwei Zeilen. Ereignisse mit einem Nullwert für `entity_id` (kein Akteur / Empfänger / Zielteilnehmer) erscheinen trotzdem – `email` ist null. Das API-Zeitfenster wird um eine Minute erweitert; die exakte Grenze `occurred_at >= WindowStart` wird lokal erneut angewendet, sodass das letzte Jahr nicht davon abhängt, ob der Server `occurred_after` als einschließend oder ausschließend behandelt. Anfragebudget: ein paginierter Durchlauf der Ereignisse im Zeitfenster plus ein Durchlauf der Entitäten. Legen Sie stets `limit = "500"` fest. ## Spaltenzuordnung Die bisherigen Spaltennamen stammen aus dem Export Ihres früheren Anbieters. Die `/v1`-Felder sind die öffentlichen API-Namen; die Abfrage vergibt für den Bericht teilweise Aliasse. | Bisherige Spalte | `/v1`-Feld oder Ableitung | Berichtsspalte | | - | - | - | | Date | `Event.occurred_at` (als Datum; der rohe Wert `occurred_at` bleibt als `datetimezone` erhalten) | `date` | | Action | `Event.event_type` – geschlossene Token siehe unten | `action` | | Email | `Entity.email` (Verknüpfung über `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` – Ganzzahl 1–5, 1 am leichtesten, 5 am schwersten | `difficulty` | | Raw IP | Nie auf `/v1` | Ausgelassen, nicht auf Null gesetzt | | Device type | `Event.device_type` – abgeleitete Klasse; null, wenn das Ereignis keine abgeleitete Klasse hat | `device_type` | ### Aktions-Token `action` ist das geschlossene Reporting-Token. Das bisherige „Email Sent“ entspricht `simulation.delivered` (`delivered` ist das öffentliche Verb; das Token auf der Leitung lautet `simulation.delivered`). | Wert für `action` | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Zusätzlich enthaltene Felder, da die API sie bereitstellt: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at` sowie `entity_type` und `entity_status` aus der Entitätsverknüpfung. ## Abweichungen vom bisherigen Export * **Die rohe IP ist nie verfügbar.** `/v1` stellt die rohe Client-IP nicht bereit – Datenschutz durch Technikgestaltung, keine ausstehende Zuordnung. Die Abfrage fügt keine Platzhalterspalte für die IP hinzu. * **Der Gerätetyp ist abgeleitet, nicht roh.** `device_type` ist eine abgeleitete Geräteklasse für Klick-, Übermittlungs- und Meldeereignisse. Zu den beobachteten Token gehören `desktop`, `mobile`, `tablet` und `unknown`, der Emitter speichert jedoch eine Freitext-Zeichenfolge – behandeln Sie sie als offenen Text, nicht als geschlossene Enumeration. Sie ist null, wenn das Ereignis keine abgeleitete Klasse hat, und die rohe Zeichenfolge `user_agent` bleibt privat. * **„Email Sent“ ist `simulation.delivered`.** Verwenden Sie dieses Token, wenn Sie Versendungen filtern oder zählen. Suchen Sie nicht nach einer bisherigen Zeichenfolge `email_sent`. * **Die E-Mail-Adresse des Empfängers wird per Verknüpfung ermittelt und ist kein Feld des Ereignisses.** Das Reporting-Ereignis enthält keine E-Mail-Adresse; die Abfrage durchläuft `/entities`, um sie zu ergänzen. * **Die letzten 12 Kalendermonate**, keine Zeitspanne von 365 Tagen und nicht die vollständige Historie. * **Langformat, nicht zusammengeführt.** Eine Zeile pro Interaktion, nicht ein Ergebnis pro Person. ## Nächste Schritte Anmeldedaten, Paginierung und das Laden dieser Abfragen in Power BI oder Excel. Personenbezogene Zusammenfassung von Klicks, Anmeldedaten und Meldungen über 12 Monate. Schulungsanmeldungen auf der Granularität Person × Zuweisung. Gewähren Sie `reporting: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.