> ## 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-pasta pikšķerēšanas žurnāls > Atveidojiet iepriekšējā pakalpojumu sniedzēja notikumu līmeņa pikšķerēšanas žurnālu, izmantojot /v1 atskaišu simulācijas notikumus un entītijas. Šis pārskats ir notikumu līmeņa pikšķerēšanas žurnāls: viena rinda katrai novērotajai simulācijas mijiedarbībai (datums, darbība, adresāta e-pasts, tēma, sūtītājs, grūtības pakāpe). Tas paliek garās formas — personas vēsture netiek apvienota vienā rezultātā. Vaicājums iekļauj pēdējos **12 kalendāros mēnešus** `occurred_after` (pusnakts UTC tajā pašā mēneša dienā pirms divpadsmit mēnešiem — nevis 365 dienu ilgums). Neapstrādāta klienta IP adrese nekad nav `/v1` — tā ir privātuma nodrošināšana jau pēc dizaina, nevis gaidošā kartēšana. Ierīces tips ir atvasināta klase notikuma rindā; neapstrādāts `user_agent` paliek privāts. Skatiet [Atšķirības no iepriekšējā eksporta](#at%C5%A1%C4%B7ir%C4%ABbas-no-iepriek%C5%A1%C4%93j%C4%81-eksporta). Iestatīšana, akreditācijas dati, lappušu dalīšana un ātruma ierobežojuma atkārtoti mēģinājumi ir tādi paši kā [Power BI / Excel savienojamības rokasgrāmatā](/lv/developers/v1/powerbi). Vispirms pievienojiet kopīgo `Fn_FetchAll` vaicājumu; šis pārskats to izsauc pēc nosaukuma. ## Nepieciešamie atslēgu tvērumi | Scope | Lietojums | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (e-pasta un parādāmā vārda savienošana) | Atslēga, kurai piešķirts tikai `simulation:read`, nevar izsaukt atskaišu notikumu galapunktu (API atgriež `403`). Skatiet [izvēlieties pareizo granularitāti](/lv/developers/v1/powerbi#izv%C4%93lieties-pareizo-granularit%C4%81ti). ## Avota galapunkti | Endpoint | Loma | | - | - | | `GET /v1/reporting/simulation_events` | Notikumu līmeņa fakts. Granularitāte ir viena ievadīta mijiedarbība. `email_subject`, `sender_email`, `sender_domain` un `difficulty_tier` ir šajā rindā, tāpēc vaicājums šiem laukiem nesavieno kampaņu līmeņa rezultātus. | | `GET /v1/entities` | Atrisina `entity_id` → e-pasts / parādāmais vārds. Atskaišu notikums izlaiž adresāta e-pastu (stingrs izņēmums atskaišu lasītājam). Caur `/entities` veiktā apstaigāšana ir veids, kā tiek aizpildīta iepriekšējā sistēmas kolonna “email”. | Atļautie filtri notikumu sarakstā (jebkurš cits atgriež `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Šī atskaišu saime ir [priekšskatījuma datu kopa](/lv/developers/v1/powerbi#reporting-priek%C5%A1skat%C4%ABjuma-datu-kopas-pik%C5%A1%C4%B7er%C4%93%C5%A1ana-katram-cilv%C4%93kam). Datu kopas shēmu un datu politikas varat apskatīt vietnē `GET /v1/reporting/datasets` un `GET /v1/reporting/datasets/simulation_events`. ### Granularitāte Viena rinda katram atskaišu simulācijas notikumam. Persona, kas atvērusi un pēc tam noklikšķinājusi uz tā paša ziņojuma, veido divas rindas. Notikumi ar null vērtību `entity_id` (nav dalībnieka — darbības veicēja / adresāta / mērķa) tāpat tiek rādīti — `email` ir null. API logs tiek paplašināts par vienu minūti; precīza `occurred_at >= WindowStart` robeža tiek atkārtoti piemērota lokāli, lai pēdējais gads nebūtu atkarīgs no tā, vai serveris `occurred_after` uzskata par iekļaujošu vai izslēdzošu. Pieprasījumu budžets: viena lappusēs sadalīta notikumu apstaigāšana logā, kā arī viena entītiju apstaigāšana. Vienmēr iestatiet `limit = "500"`. ## Kolonnu kartēšana Iepriekšējās sistēmas kolonnu nosaukumi ir no jūsu iepriekšējā pakalpojumu sniedzēja eksporta. `/v1` lauki ir publiskie API nosaukumi; vaicājums dažus no tiem pārskatam pārdēvē. | Legacy column | `/v1` field or derivation | Report column | | - | - | - | | Date | `Event.occurred_at` (kā datums; neapstrādātais `occurred_at` tiek saglabāts kā `datetimezone`) | `date` | | Action | `Event.event_type` — slēgtie tokeni norādīti tālāk | `action` | | Email | `Entity.email` (savienojums pēc `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` — vesels skaitlis 1–5, 1 vieglākais, 5 grūtākais | `difficulty` | | Raw IP | Nekad nav `/v1` | Izlaists, nav null | | Device type | `Event.device_type` — atvasināta klase; null, ja notikumam nav atvasinātas klases | `device_type` | ### Darbību tokeni `action` ir slēgtais atskaišu tokens. Iepriekšējās sistēmas “Email Sent” atbilst `simulation.delivered` (`delivered` ir publiskais darbības vārds; tīkla tokens ir `simulation.delivered`). | `action` value | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Papildu lauki, kas saglabāti, jo tie ir API: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, kā arī `entity_type` un `entity_status` no entītiju savienojuma. ## Atšķirības no iepriekšējā eksporta * **Neapstrādāta IP adrese nekad nav pieejama.** `/v1` neatklās neapstrādātu klienta IP adresi — privātuma nodrošināšana pēc dizaina, nevis gaidošā kartēšana. Vaicājums nepievieno IP vietturi saturošu kolonnu. * **Ierīces tips ir atvasināts, nevis neapstrādāts.** `device_type` ir atvasināta ierīces klase klikšķu, iesniegšanas un ziņošanas notikumiem. Novērotie tokeni ir `desktop`, `mobile`, `tablet` un `unknown`, taču izstarotājs saglabā brīvas formas virkni — uztveriet to kā atvērtu tekstu, nevis slēgtu uzskaitījumu. Tā ir null, ja notikumam nav atvasinātas klases, un neapstrādātā `user_agent` virkne paliek privāta. * **“Email Sent” ir `simulation.delivered`.** Izmantojiet šo tokenu, filtrējot vai skaitot nosūtījumus. Nemeklējiet iepriekšējās sistēmas `email_sent` virkni. * **Adresāta e-pasts ir savienojums, nevis notikuma lauks.** Atskaišu notikums izlaiž e-pastu; vaicājums apstaigā `/entities`, lai to aizpildītu. * **Pēdējie 12 kalendārie mēneši**, nevis 365 dienu ilgums un nevis pilna vēsture. * **Garā forma, nav apvienots.** Viena rinda katrai mijiedarbībai, nevis viens rezultāts katrai personai. ## Nākamie soļi Akreditācijas dati, lappušu dalīšana un šo vaicājumu ielāde Power BI vai Excel. Katras personas 12 mēnešu klikšķu, akreditācijas datu un ziņošanas apkopojums. Training reģistrācijas personas × uzdevuma granularitātē. Piešķiriet `reporting:read` un `entity:read` atslēgai, kas atsvaidzina šo pārskatu. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.