> ## 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. # Usuaris més susceptibles > Recreeu el resum de 12 mesos dels usuaris més susceptibles d'un proveïdor anterior a partir dels resultats i les entitats de simulació de /v1. 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. Les interaccions d'escàners automàtics i bots s'exclouen dels recomptes de clics i credencials. Es tracta d'una divergència deliberada respecte a l'exportació heretada. Consulteu [Divergències respecte a l'exportació heretada](#divergences-from-the-legacy-export). 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](/ca/developers/v1/powerbi). Afegiu primer la consulta compartida `Fn_FetchAll`; aquest informe la crida pel nom. ## Required key scopes | Scope | Ús | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (unió per correu electrònic i nom visible) | 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](/ca/developers/v1/powerbi#trieu-el-grau-de-detall-adequat). ## Source endpoints | Endpoint | Funció | | - | - | | `GET /v1/simulation_results` | Resultat per destinatari. Aquest és el grau dels fets. | | `GET /v1/entities` | Resol `entity` → correu electrònic / nom visible. La fila de resultat no conté el correu electrònic ni el nom visible del destinatari (només `entity`). | 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: `. Guanya la primera marca de temps coincident, començant per la de prioritat més alta: | Prioritat | Marca de temps | Etiqueta de resultat | | - | - | - | | 1 | `credential_submitted_at` | `credential submitted` | | 2 | `clicked_at` | `clicked` | | 3 | `attachment_opened_at` | `attachment opened` | | 4 | `reported_at` | `reported` | | 5 | `opened_at` | `opened` | | 6 | `delivered_at` | `no action` | | 7 | `bounced_at` | `bounced` | 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. | Columna heretada | Camp de `/v1` o derivació | Columna de l'informe | | - | - | - | | Email | `Entity.email` (unió per `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Recompte de resultats en què `delivered_at` no és nul (inclou les files marcades com a bot) | `total_received` | | Clicks # | Recompte en què `clicked_at` no és nul **i** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Recompte en què `credential_submitted_at` no és nul **i** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Recompte en què `reported_at` no és nul (inclosos els bots; no és un clic ni una credencial) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Resultats lliurats consecutius més recents en què la persona ha fet clic (els bots la trenquen) | `current_click_streak` | | Last 5 assessments | Els cinc resultats lliurats més recents, separats per `"; "` (vegeu [precedència](#outcome-precedence-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | No és a `/v1` | Omès, no establert com a nul | 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 Credencials, paginació i càrrega d'aquestes consultes a Power BI o Excel. Interaccions de phishing a nivell d'esdeveniment durant els últims 12 mesos. Inscripcions de Training amb grau de persona × assignació. Concediu `simulation:read` i `entity:read` a la clau que actualitza aquest informe. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.