Usuaris més susceptibles

Aquest informe és un resum de susceptibilitat per usuari de 12 mesos: una fila per cada persona que ha rebut almenys una simulació durant l’últim any, amb recomptes i taxes de clics, credencials i notificacions, una ratxa actual de clics i una llista concatenada dels últims 5 resultats. La finestra és de 12 mesos naturals (mitjanit UTC del mateix dia del mes de fa dotze mesos), no una durada de 365 dies. La configuració, les credencials, la paginació i el reintent per límit de velocitat són els mateixos que a la guia de connectivitat de Power BI / Excel. Afegiu primer la consulta compartida Fn_FetchAll; aquest informe la crida pel nom.

​

Required key scopes

Aquest informe utilitza la llista de resultats per persona operativa, no la família de previsualització d’informes. Una clau que només tingui concedit reporting:read no pot cridar GET /v1/simulation_results (l’API retorna 403). Consulteu trieu el grau adequat.

​

Source endpoints

Filtres de la llista d’admesos a la llista de resultats: limit, page_token, simulation, entity. En aquesta llista no hi ha delivered_after / start_date, de manera que els últims 12 mesos s’apliquen a Power Query després del recorregut complet. Camps utilitzats a cada resultat: 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.

​

Grain

Una fila per cada entitat que tingui almenys un resultat amb delivered_at durant els últims 12 mesos naturals. Una persona seleccionada però a qui mai s’ha lliurat res no apareix. Les múltiples simulacions de la mateixa persona es consoliden aquí. Pressupost de sol·licituds: un recorregut paginat de tots els resultats de simulació de l’organització, més un recorregut d’entitats. Definiu sempre limit = "500".

​

Outcome precedence (last_5_assessments)

Cadascun dels cinc resultats lliurats més recents (delivered_at descendent) es resumeix com a YYYY-MM-DD: <outcome>. Guanya la primera marca de temps coincident, començant per la de prioritat més alta: Només lliurat és no action (el missatge ha arribat; la persona no ha fet res). Una persona que ha fet clic i més tard ha fet la notificació és clicked: la notificació no té prioritat sobre una interacció de risc en aquesta llista. Les files marcades com a bot continuen rebent una etiqueta de resultat a partir de les marques de temps presents; simplement no incrementen els recomptes de clics ni de credencials. Ratxa actual de clics: recorreu aquests mateixos resultats lliurats del més nou al més antic i compteu les files consecutives en què clicked_at no és nul i bot_activity_detected no és true. Pareu a la primera fila que no ho compleixi.

​

Column mapping

Els noms de columna heretats provenen de l’exportació del vostre proveïdor anterior. Els camps de /v1 són els noms públics de l’API; la consulta en deriva els recomptes i les taxes. Clau d’unió conservada per a un model d’estrella: entity_id.

​

Divergences from the legacy export

• L’activitat de bots s’exclou dels recomptes de clics i credencials. L’exportació d’un proveïdor anterior comptava les interaccions d’escàners automàtics i bots com a clics i enviaments de credencials. Aquesta consulta no ho fa. Un resultat amb bot_activity_detected = true continua sent una simulació lliurada: es comptabilitza a total_received i als agregats de notificacions, però es tracta com a no-clic i no-enviament: s’omet de clicks / credential_submissions i trenca una ratxa actual de clics. No ho «corregiu» comptant els bots per fer-ho coincidir amb l’exportació heretada.
• La notificació no té prioritat sobre un clic a last_5_assessments. Una persona que ha fet clic i més tard ha fet la notificació s’etiqueta com a clicked.
• Els extres del directori s’ometen, no s’estableixen com a nuls. El departament i altres camps similars no són a /v1.
• No hi ha filtre de temps al servidor. GET /v1/simulation_results no té cap delivered_after. La consulta recorre tots els resultats i després conserva els delivered_at dels últims 12 mesos naturals. Una organització amb un gran historial pot gastar més pressupost de límit de velocitat per clau que una llista filtrada.

​

Next steps