Meest vatbare gebruikers

Dit rapport is een overzicht van de vatbaarheid per gebruiker over 12 maanden: één rij per persoon die in het afgelopen jaar ten minste één simulatie heeft ontvangen, met aantallen en percentages voor klikken, inloggegevens en meldingen, een huidige klikreeks en een samengevoegde lijst met de laatste 5 uitkomsten. De periode beslaat 12 kalendermaanden (middernacht UTC op dezelfde dag van de maand twaalf maanden geleden), niet een duur van 365 dagen. Installatie, inloggegevens, paginering en nieuwe pogingen bij ratelimits zijn hetzelfde als in de connectiviteitshandleiding voor Power BI / Excel. Voeg eerst de gedeelde Fn_FetchAll-query toe; dit rapport roept deze bij naam aan.

​

Vereiste sleutelscopes

Dit rapport gebruikt de operationele lijst met resultaten per persoon, niet de preview-familie voor rapportage. Een sleutel die alleen reporting:read heeft gekregen, kan GET /v1/simulation_results niet aanroepen (de API retourneert 403). Zie kies het juiste detailniveau.

​

Bronendpoints

Filters op de toegestane lijst voor de resultatenlijst: limit, page_token, simulation, entity. Deze lijst heeft geen delivered_after / start_date, dus de afgelopen 12 maanden worden in Power Query toegepast na de volledige doorloop. Gebruikte velden per resultaat: id, simulation, entity, status, targeted_at, delivered_at, bounced_at, opened_at, clicked_at, attachment_opened_at, credential_submitted_at, reported_at, reported_before_interaction, bot_activity_detected, email_subject, sender_email, difficulty_level, created_at, updated_at.

​

Detailniveau

Eén rij per entiteit met ten minste één resultaat met delivered_at in de afgelopen 12 kalendermaanden. Een persoon die wel is geselecteerd maar nooit iets heeft ontvangen, komt niet voor. Meerdere simulaties voor dezelfde persoon worden hier samengevoegd. Aanvraagbudget: één gepagineerde doorloop van alle simulatieresultaten in de organisatie, plus één doorloop van entiteiten. Stel altijd limit = "500" in.

​

Voorrang van uitkomsten (last_5_assessments)

Elk van de vijf meest recente afgeleverde resultaten (delivered_at aflopend) wordt samengevat als YYYY-MM-DD: <outcome>. De eerste overeenkomende tijdstempel wint, met de hoogste prioriteit eerst: Alleen afgeleverd is no action (het bericht is aangekomen; de persoon heeft niets gedaan). Een persoon die heeft geklikt en later heeft gemeld, is clicked — een melding gaat in deze lijst niet voor een risicovolle interactie. Rijen die als bot zijn gemarkeerd krijgen nog steeds een label van uitkomst op basis van de aanwezige tijdstempels; ze verhogen alleen de aantallen voor klikken en inloggegevens niet. Huidige klikreeks: doorloop dezelfde afgeleverde resultaten van nieuw naar oud en tel opeenvolgende rijen waarin clicked_at niet leeg is en bot_activity_detected niet true is. Stop bij de eerste rij die niet voldoet.

​

Kolomtoewijzing

De namen van de verouderde kolommen komen uit de export van uw vorige provider. /v1-velden zijn de namen in de openbare API; de query leidt de aantallen en percentages af. Behouden koppelsleutel voor een sterschemamodel: entity_id.

​

Afwijkingen ten opzichte van de verouderde export

• Botactiviteit wordt uitgesloten van de aantallen voor klikken en inloggegevens. De export van een vorige provider telde interacties van geautomatiseerde scanners en bots mee als klikken en ingediende inloggegevens. Deze query doet dat niet. Een resultaat met bot_activity_detected = true is nog steeds een afgeleverde simulatie — het telt mee in total_received en in de aggregaties voor meldingen — maar wordt behandeld als een niet-klik en een niet-indiening: het wordt weggelaten uit clicks / credential_submissions en verbreekt een huidige klikreeks. Probeer dit niet te “herstellen” door bots mee te tellen om aan te sluiten op de verouderde export.
• Een melding gaat niet voor een klik bij last_5_assessments. Een persoon die heeft geklikt en later heeft gemeld, krijgt het label clicked.
• Extra mapgegevens worden weggelaten, niet op null gezet. Afdeling en vergelijkbare velden zijn niet aanwezig op /v1.
• Geen tijdfilter aan de serverzijde. GET /v1/simulation_results heeft geen delivered_after. De query doorloopt alle resultaten en behoudt daarna delivered_at in de afgelopen 12 kalendermaanden. Een grote organisatie met veel historie kan meer van het ratelimietbudget per sleutel verbruiken dan een gefilterde lijst.

​

Volgende stappen