> ## 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. # Utenti più suscettibili > Ricreare il riepilogo su 12 mesi degli utenti più suscettibili di un precedente provider a partire dai risultati delle simulazioni e dalle entità di /v1. Questo report è un riepilogo della suscettibilità per singolo utente su 12 mesi: una riga per ogni persona che ha ricevuto almeno una simulazione nell'ultimo anno, con conteggi e percentuali di clic, credenziali e segnalazioni, la serie corrente di clic e un elenco concatenato degli ultimi 5 risultati. La finestra temporale è di **12 mesi di calendario** (mezzanotte UTC dello stesso giorno del mese di dodici mesi fa), non una durata di 365 giorni. Le interazioni di scanner automatici / bot sono escluse dai conteggi di clic e credenziali. Si tratta di una divergenza deliberata rispetto all'esportazione legacy. Vedere [Divergenze rispetto all'esportazione legacy](#divergenze-rispetto-all-esportazione-legacy). Configurazione, credenziali, paginazione e nuovi tentativi in caso di limite di frequenza sono gli stessi della [guida alla connettività Power BI / Excel](/it/developers/v1/powerbi). Aggiungere prima la query condivisa `Fn_FetchAll`; questo report la richiama per nome. ## Ambiti della chiave richiesti | Ambito | Utilizzo | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (join di email e nome visualizzato) | Questo report utilizza l'elenco operativo dei risultati per singola persona, non la famiglia di anteprime di reportistica. Una chiave a cui è stato concesso solo `reporting:read` non può chiamare `GET /v1/simulation_results` (l'API restituisce `403`). Vedere [scegliere la granularità corretta](/it/developers/v1/powerbi#scegliere-la-granularit%C3%A0-corretta). ## Endpoint di origine | Endpoint | Ruolo | | - | - | | `GET /v1/simulation_results` | Risultato per singolo destinatario. Questa è la granularità dei fatti. | | `GET /v1/entities` | Risolve `entity` → email / nome visualizzato. La riga del risultato non contiene email né nome visualizzato del destinatario (solo `entity`). | Filtri consentiti nell'elenco dei risultati: `limit`, `page_token`, `simulation`, `entity`. In questo elenco non sono disponibili `delivered_after` / `start_date`, quindi gli ultimi 12 mesi vengono applicati in Power Query dopo la scansione completa. Campi utilizzati in ogni risultato: `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`. ### Granularità Una riga per ogni entità che ha almeno un risultato con `delivered_at` negli ultimi 12 mesi di calendario. Una persona individuata come destinataria ma a cui non è mai stato recapitato nulla non compare. Qui le simulazioni multiple per la stessa persona vengono aggregate. Budget di richieste: una scansione paginata di tutti i risultati delle simulazioni dell'organizzazione, più una scansione delle entità. Impostare sempre `limit = "500"`. ## Precedenza dei risultati (`last_5_assessments`) Ciascuno dei cinque risultati recapitati più recenti (`delivered_at` in ordine decrescente) viene riepilogato come `YYYY-MM-DD: `. Prevale il primo timestamp corrispondente, a partire da quello con priorità più alta: | Priorità | Timestamp | Etichetta del risultato | | - | - | - | | 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` | Solo recapitato è `no action` (il messaggio è arrivato; la persona non ha fatto nulla). Una persona che ha cliccato e in seguito ha segnalato è `clicked`: la segnalazione non prevale su un'interazione a rischio in questo elenco. Le righe contrassegnate come bot ricevono comunque un'etichetta di risultato in base ai timestamp presenti; semplicemente non incrementano i conteggi di clic / credenziali. **Serie corrente di clic:** scorrere gli stessi risultati recapitati dal più recente al meno recente e contare le righe consecutive in cui `clicked_at` non è nullo **e** `bot_activity_detected` non è `true`. Fermarsi alla prima riga che non soddisfa la condizione. ## Mappatura delle colonne I nomi delle colonne legacy provengono dall'esportazione del precedente provider. I campi `/v1` sono i nomi dell'API pubblica; la query ricava conteggi e percentuali. | Colonna legacy | Campo o derivazione `/v1` | Colonna del report | | - | - | - | | Email | `Entity.email` (join su `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Conteggio dei risultati in cui `delivered_at` non è nullo (include le righe contrassegnate come bot) | `total_received` | | Clicks # | Conteggio dove `clicked_at` non è nullo **e** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Conteggio dove `credential_submitted_at` non è nullo **e** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Conteggio dove `reported_at` non è nullo (bot inclusi: non costituiscono un clic/credenziale) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Risultati recapitati più recenti consecutivi su cui la persona ha cliccato (i bot la interrompono) | `current_click_streak` | | Last 5 assessments | I cinque risultati recapitati più recenti, separati da `"; "` (vedere [precedenza](#precedenza-dei-risultati-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Non presenti in `/v1` | Omesse, non impostate a null | Chiave di join mantenuta per un modello a schema a stella: `entity_id`. ## Divergenze rispetto all'esportazione legacy * **L'attività dei bot è esclusa dai conteggi di clic e credenziali.** L'esportazione di un precedente provider contava le interazioni di scanner automatici / bot come clic e invii di credenziali. Questa query no. Un risultato con `bot_activity_detected = true` è comunque una simulazione recapitata: viene conteggiato in `total_received` e negli aggregati delle segnalazioni, ma è trattato come non-clic e non-invio: è omesso da `clicks` / `credential_submissions` e interrompe la serie corrente di clic. Non "correggere" questo comportamento contando i bot per allinearsi all'esportazione legacy. * **La segnalazione non prevale su un clic** in `last_5_assessments`. Una persona che ha cliccato e in seguito ha segnalato viene etichettata come `clicked`. * **Le informazioni aggiuntive della directory sono omesse, non impostate a null.** Reparto e campi simili non sono presenti in `/v1`. * **Nessun filtro temporale lato server.** `GET /v1/simulation_results` non ha `delivered_after`. La query scorre tutti i risultati, poi mantiene `delivered_at` negli ultimi 12 mesi di calendario. Un'organizzazione con un ampio storico può consumare una parte maggiore del budget di frequenza per chiave rispetto a un elenco filtrato. ## Passaggi successivi Credenziali, paginazione e caricamento di queste query in Power BI o Excel. Interazioni di phishing a livello di evento negli ultimi 12 mesi. Iscrizioni alla Formazione con granularità persona × assegnazione. Concedere `simulation:read` e `entity:read` alla chiave che aggiorna questo report. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.