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.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 ientity_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.
/v1eksponerer 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_typeer en avledet enhetsklasse for klikk-, innsendings- og rapporteringshendelser. Observerte tokens inkludererdesktop,mobile,tabletogunknown, 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 tidligereemail_sent-streng. - Mottakerens e-postadresse er en kobling, ikke et felt på hendelsen. Rapporteringshendelsen utelater e-postadressen; spørringen går gjennom
/entitiesfor å 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.
