Skip to main content
Š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.
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ā. Vispirms pievienojiet kopīgo Fn_FetchAll vaicājumu; šis pārskats to izsauc pēc nosaukuma.

Nepieciešamie atslēgu tvērumi

Atslēga, kurai piešķirts tikai simulation:read, nevar izsaukt atskaišu notikumu galapunktu (API atgriež 403). Skatiet izvēlieties pareizo granularitāti.

Avota galapunkti

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. 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ē.

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). 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

Power BI un Excel iestatīšana

Akreditācijas dati, lappušu dalīšana un šo vaicājumu ielāde Power BI vai Excel.

Visvairāk neaizsargātie lietotāji

Katras personas 12 mēnešu klikšķu, akreditācijas datu un ziņošanas apkopojums.

Atbilstība katrai personai

Training reģistrācijas personas × uzdevuma granularitātē.

API atslēgas

Piešķiriet reporting:read un entity:read atslēgai, kas atsvaidzina šo pārskatu.