Skip to main content
Ez a riport egy eseményszintű adathalászat-napló: soronként egy megfigyelt szimulációs interakció (dátum, művelet, címzett e-mail-címe, tárgy, feladó, nehézségi szint). Hosszú formátumú marad – nem vonja össze egy személy előzményeit egyetlen eredménnyé. A lekérdezés az elmúlt 12 naptári hónapot foglalja occurred_after értékbe (a tizenkét hónappal korábbi, azonos hónapnapi UTC szerinti éjfél – nem 365 napos időtartam).
A nyers kliens-IP-cím soha nem szerepel itt: /v1 – ez tudatos adatvédelmi megoldás, nem függőben lévő leképezés. Az eszköztípus az eseménysoron szereplő származtatott osztály; a nyers user_agent nem nyilvános. Lásd: Eltérések a korábbi exporttól.
A beállítás, a hitelesítő adatok, a lapozás és a sebességkorlát miatti újrapróbálkozás megegyezik a Power BI / Excel csatlakozási útmutatóban leírtakkal. Először adja hozzá a közös Fn_FetchAll lekérdezést; ez a riport név szerint hívja meg.

Szükséges kulcshatókörök

Az a kulcs, amely csak simulation:read jogosultságot kapott, nem hívhatja meg a riportolási eseményvégpontot (az API 403 választ ad vissza). Lásd: a megfelelő szemcsézettség kiválasztása.

Forrásvégpontok

Az eseménylista engedélyezett szűrői (bármi más 400 választ eredményez): limit, page_token, simulation, entity, event_type, occurred_after. Ez a riportolási család előzetes adatkészlet. Az adatkészlet sémáját és adatkezelési szabályzatait itt tekintheti meg: GET /v1/reporting/datasets és GET /v1/reporting/datasets/simulation_events.

Szemcsézettség

Riportolási szimulációs eseményenként egy sor. Az a személy, aki megnyitotta, majd rákattintott ugyanarra az üzenetre, két sort eredményez. Azok az események is megjelennek, amelyeknél a entity_id null (nincs szereplő / címzett / célszemély) – ilyenkor a email null. Az API időablakát egy perccel kiszélesítjük; a pontos occurred_at >= WindowStart határt helyben újra alkalmazzuk, így az elmúlt év nem függ attól, hogy a szerver a occurred_after értéket zártként vagy nyitottként kezeli. Kérések költségvetése: az ablakban lévő események egy lapozott bejárása, plusz az entitások egy bejárása. Mindig állítsa be a következőt: limit = "500".

Oszlopleképezés

A korábbi oszlopnevek az előző szolgáltató exportjából származnak. A /v1 mezők a nyilvános API-nevek; a lekérdezés egyeseket álnevekkel lát el a riport számára.

Műveleti tokenek

A action a zárt riportolási token. A korábbi „Email Sent” a következőre képeződik le: simulation.delivered (a delivered a nyilvános ige; a hálózaton átvitt token a simulation.delivered). Az alábbi mezők azért maradnak meg, mert az API tartalmazza őket: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, valamint a entity_type és a entity_status az entitás-összekapcsolásból.

Eltérések a korábbi exporttól

  • A nyers IP-cím soha nem érhető el. A /v1 nem teszi elérhetővé a nyers kliens-IP-címet – ez tudatos adatvédelmi megoldás, nem függőben lévő leképezés. A lekérdezés nem ad hozzá helykitöltő IP-oszlopot.
  • Az eszköztípus származtatott, nem nyers. A device_type egy származtatott eszközosztály kattintási, beküldési és jelentési eseményekhez. A megfigyelt tokenek között szerepel a desktop, mobile, tablet és unknown, de a kibocsátó szabad formátumú karakterláncot tárol – kezelje nyílt szövegként, nem zárt enumként. Értéke null, ha az eseményhez nincs származtatott osztály, a nyers user_agent karakterlánc pedig nem nyilvános.
  • Az „Email Sent” a következő: simulation.delivered. Ezt a tokent használja a küldések szűrésekor vagy számolásakor. Ne keresse a korábbi email_sent karakterláncot.
  • A címzett e-mail-címe összekapcsolással érhető el, nem az esemény mezője. A riportolási esemény nem tartalmaz e-mail-címet; a lekérdezés a /entities bejárásával tölti ki.
  • Az elmúlt 12 naptári hónap, nem 365 napos időtartam, és nem a teljes előzmény.
  • Hosszú formátum, nem összevont. Interakciónként egy sor, nem személyenként egy eredmény.

Következő lépések

Power BI és Excel beállítása

Hitelesítő adatok, lapozás, és ezeknek a lekérdezéseknek a betöltése Power BI-ba vagy Excelbe.

Leginkább veszélyeztetett felhasználók

Személyenkénti 12 hónapos kattintási, hitelesítőadat- és jelentési összesítés.

Személyenkénti megfelelőség

Képzési beiratkozások személy × hozzárendelés szemcsézettséggel.

API-kulcsok

Adja meg a reporting:read és a entity:read jogosultságot annak a kulcsnak, amely frissíti ezt a riportot.