Skip to main content
Denne rapporten er en phishing-logg på hendelsesnivå: én rad per observerte simuleringsinteraksjon (dato, handling, mottakerens e-postadresse, emne, avsender, vanskelighetsgrad). Den forblir i langt format – den slår ikke sammen en persons historikk til ett enkelt resultat. Spørringen samler de siste 12 kalendermånedene i occurred_after (midnatt UTC på samme dag i måneden for tolv måneder siden – ikke en varighet på 365 dager).
Rå IP-adresse for klienten finnes aldri på /v1 – personvern som er innebygd i designet, ikke en ventende tilordning. Enhetstype er en avledet klasse på hendelsesraden; rå user_agent forblir privat. Se Avvik fra den tidligere eksporten.
Oppsett, legitimasjon, paginering og nye forsøk ved rate-begrensning er de samme som i veiledningen for Power BI / Excel-tilkobling. Legg først til den delte Fn_FetchAll-spørringen; denne rapporten kaller den ved navn.

Nødvendige nøkkelomfang

En nøkkel som kun har fått simulation:read kan ikke kalle endepunktet for rapporteringshendelser (API-et returnerer 403). Se velg riktig granularitet.

Kildeendepunkter

Tillatte filtre på hendelseslisten (alt annet returnerer 400): limit, page_token, simulation, entity, event_type, occurred_after. Denne rapporteringsfamilien er et forhåndsvisningsdatasett. Inspiser datasettets skjema og datapolicyer på GET /v1/reporting/datasets og GET /v1/reporting/datasets/simulation_events.

Granularitet

Én rad per rapporteringssimuleringshendelse. En person som åpnet og deretter klikket på den samme meldingen, gir to rader. Hendelser med null i entity_id (ingen aktør / mottaker / målrettet deltaker) vises likevel – email er null. API-vinduet utvides med ett minutt; den nøyaktige occurred_at >= WindowStart-grensen anvendes på nytt lokalt, slik at det siste året ikke avhenger av om serveren behandler occurred_after som inkluderende eller ekskluderende. Forespørselsbudsjett: én paginert gjennomgang av hendelser i vinduet, pluss én gjennomgang av entiteter. Angi alltid limit = "500".

Kolonnetilordning

Navnene på de tidligere kolonnene stammer fra eksporten fra din forrige leverandør. /v1-felt er de offentlige API-navnene; spørringen gir noen av dem aliaser i rapporten.

Handlingstokens

action er det lukkede rapporteringstokenet. Den tidligere «Email Sent» tilsvarer simulation.delivered (delivered er det offentlige verbet; token på wire er simulation.delivered). Ekstra felt som beholdes fordi API-et har dem: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, samt entity_type og entity_status fra entitetskoblingen.

Avvik fra den tidligere eksporten

  • Rå IP-adresse er aldri tilgjengelig. /v1 eksponerer ikke rå IP-adresse for klienten – personvern som er innebygd i designet, ikke en ventende tilordning. Spørringen legger ikke til noen plassholderkolonne for IP.
  • Enhetstype er avledet, ikke rå. device_type er en avledet enhetsklasse for klikk-, innsendings- og rapporteringshendelser. Observerte tokens inkluderer desktop, mobile, tablet og unknown, men avsenderen lagrer en fritekststreng – behandle den som åpen tekst, ikke som en lukket enum. Den er null når hendelsen ikke har noen avledet klasse, og den rå user_agent-strengen forblir privat.
  • «Email Sent» er simulation.delivered. Bruk dette tokenet når du filtrerer eller teller utsendelser. Ikke let etter en tidligere email_sent-streng.
  • Mottakerens e-postadresse er en kobling, ikke et felt på hendelsen. Rapporteringshendelsen utelater e-postadressen; spørringen går gjennom /entities for å fylle den ut.
  • Siste 12 kalendermåneder, ikke en varighet på 365 dager, og ikke hele historikken.
  • Langt format, ikke sammenslått. Én rad per interaksjon, ikke ett resultat per person.

Neste steg

Oppsett av Power BI og Excel

Legitimasjon, paginering og innlasting av disse spørringene i Power BI eller Excel.

Mest sårbare brukere

Oppsummering per person over 12 måneder for klikk, legitimasjon og rapportering.

Etterlevelse per person

Påmeldinger til opplæring på granularitet person × tildeling.

API-nøkler

Gi reporting:read og entity:read til nøkkelen som oppdaterer denne rapporten.