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

# सबसे अधिक संवेदनशील उपयोगकर्ता

> /v1 सिमुलेशन परिणामों और एंटिटीज़ से पिछले प्रदाता की 12-महीने की सबसे अधिक संवेदनशील उपयोगकर्ताओं की रोलअप रिपोर्ट को पुनः बनाएँ।

यह रिपोर्ट प्रति उपयोगकर्ता 12-महीने की संवेदनशीलता रोलअप है: पिछले एक वर्ष में कम से कम एक सिमुलेशन प्राप्त करने वाले प्रत्येक व्यक्ति के लिए एक पंक्ति, जिसमें क्लिक / क्रेडेंशियल / रिपोर्ट की संख्या और दरें, वर्तमान क्लिक स्ट्रीक, और अंतिम 5 परिणामों की संयोजित सूची शामिल है।

विंडो **12 कैलेंडर महीनों** की है (12 महीने पहले उसी तारीख की UTC मध्यरात्रि से), न कि 365 दिनों की अवधि।

<Note>
  स्वचालित स्कैनर / बॉट इंटरैक्शन को क्लिक और क्रेडेंशियल गणना से बाहर रखा गया है। यह लीगेसी एक्सपोर्ट से जानबूझकर किया गया अंतर है। देखें
  [लीगेसी एक्सपोर्ट से अंतर](#%E0%A4%B2%E0%A5%80%E0%A4%97%E0%A5%87%E0%A4%B8%E0%A5%80-%E0%A4%8F%E0%A4%95%E0%A5%8D%E0%A4%B8%E0%A4%AA%E0%A5%8B%E0%A4%B0%E0%A5%8D%E0%A4%9F-%E0%A4%B8%E0%A5%87-%E0%A4%85%E0%A4%82%E0%A4%A4%E0%A4%B0)।
</Note>

सेटअप, क्रेडेंशियल, पेजिनेशन और रेट-लिमिट रीट्राई की प्रक्रिया [Power BI / Excel कनेक्टिविटी गाइड](/hi/developers/v1/powerbi) के समान है। पहले साझा `Fn_FetchAll` क्वेरी जोड़ें; यह रिपोर्ट उसे नाम से कॉल करती है।

## आवश्यक कुंजी स्कोप

| स्कोप | उपयोग |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (ईमेल और डिस्प्ले नाम जोड़ने के लिए) |

यह रिपोर्ट **ऑपरेशनल** प्रति-व्यक्ति परिणाम सूची का उपयोग करती है, रिपोर्टिंग प्रीव्यू परिवार का नहीं। केवल `reporting:read` प्रदान की गई कुंजी `GET /v1/simulation_results` को कॉल नहीं कर सकती (API `403` लौटाता है)। देखें [सही ग्रेन चुनें](/hi/developers/v1/powerbi#%E0%A4%B8%E0%A4%B9%E0%A5%80-grain-%E0%A4%9A%E0%A5%81%E0%A4%A8%E0%A5%87%E0%A4%82)।

## स्रोत एंडपॉइंट

| एंडपॉइंट | भूमिका |
| - | - |
| `GET /v1/simulation_results` | प्रति-प्राप्तकर्ता परिणाम। यह फ़ैक्ट ग्रेन है। |
| `GET /v1/entities` | `entity` को ईमेल / डिस्प्ले नाम में रिज़ॉल्व करता है। परिणाम पंक्ति में प्राप्तकर्ता का अपना ईमेल या डिस्प्ले नाम नहीं होता (केवल `entity` होता है)। |

परिणाम सूची पर अनुमत फ़िल्टर: `limit`, `page_token`, `simulation`, `entity`। इस सूची पर `delivered_after` / `start_date` उपलब्ध नहीं है, इसलिए पिछले 12 महीनों का फ़िल्टर पूरा वॉक होने के बाद Power Query में लागू किया जाता है।

प्रत्येक परिणाम पर उपयोग किए गए फ़ील्ड: `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`।

### ग्रेन

प्रत्येक एंटिटी के लिए एक पंक्ति, जिसका पिछले 12 कैलेंडर महीनों में `delivered_at` वाला कम से कम एक परिणाम हो। जिस व्यक्ति को लक्षित किया गया लेकिन कभी डिलीवर नहीं किया गया, वह दिखाई नहीं देता। एक ही व्यक्ति के कई सिमुलेशन यहाँ एक पंक्ति में समेकित हो जाते हैं।

रिक्वेस्ट बजट: संगठन के प्रत्येक सिमुलेशन परिणाम का एक पेजिनेटेड वॉक, साथ ही एंटिटीज़ का एक वॉक। `limit = "500"` हमेशा सेट करें।

## परिणाम प्राथमिकता (`last_5_assessments`)

पाँच सबसे हाल के डिलीवर किए गए परिणामों (`delivered_at` अवरोही क्रम में) में से प्रत्येक को `YYYY-MM-DD: <outcome>` के रूप में सारांशित किया जाता है। पहला मेल खाने वाला टाइमस्टैम्प मान्य होता है, सर्वोच्च प्राथमिकता पहले:

| प्राथमिकता | टाइमस्टैम्प | परिणाम लेबल |
| - | - | - |
| 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` |

केवल-डिलीवर्ड `no action` है (संदेश पहुँच गया; व्यक्ति ने कुछ नहीं किया)। जिस व्यक्ति ने क्लिक किया और बाद में रिपोर्ट किया, वह `clicked` है — इस सूची में रिपोर्ट जोखिमपूर्ण इंटरैक्शन से ऊपर नहीं गिना जाता। बॉट-फ़्लैग की गई पंक्तियों को भी मौजूद टाइमस्टैम्प के आधार पर परिणाम लेबल मिलता है; बस वे क्लिक / क्रेडेंशियल गणना में वृद्धि नहीं करतीं।

**वर्तमान क्लिक स्ट्रीक:** इन्हीं डिलीवर किए गए परिणामों को नए से पुराने क्रम में देखें और लगातार उन पंक्तियों की गणना करें जहाँ `clicked_at` गैर-null है **और** `bot_activity_detected` का मान `true` नहीं है। पहली चूक पर रुक जाएँ।

## कॉलम मैपिंग

लीगेसी कॉलम नाम आपके पिछले प्रदाता के एक्सपोर्ट से हैं। `/v1` फ़ील्ड सार्वजनिक API नाम हैं; क्वेरी गणना और दरें स्वयं निकालती है।

| लीगेसी कॉलम | `/v1` फ़ील्ड या व्युत्पत्ति | रिपोर्ट कॉलम |
| - | - | - |
| Email | `Entity.email` (`Result.entity` पर जोड़ें) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | उन परिणामों की संख्या जहाँ `delivered_at` गैर-null है (बॉट-फ़्लैग की गई पंक्तियाँ सहित) | `total_received` |
| Clicks # | उन पंक्तियों की संख्या जहाँ `clicked_at` गैर-null है **और** `bot_activity_detected` ≠ `true` | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | उन पंक्तियों की संख्या जहाँ `credential_submitted_at` गैर-null है **और** `bot_activity_detected` ≠ `true` | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | उन पंक्तियों की संख्या जहाँ `reported_at` गैर-null है (बॉट सहित — यह क्लिक/क्रेडेंशियल नहीं है) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | लगातार नवीनतम डिलीवर किए गए वे परिणाम जिन पर व्यक्ति ने क्लिक किया (बॉट इसे तोड़ देते हैं) | `current_click_streak` |
| Last 5 assessments | पाँच नवीनतम डिलीवर किए गए परिणाम, `"; "` से अलग किए गए ([प्राथमिकता](#परिणाम-प्राथमिकता-last_5_assessments) देखें) | `last_5_assessments` |
| Directory extras (department, …) | `/v1` पर उपलब्ध नहीं | छोड़ा गया, null नहीं किया गया |

स्टार-स्कीमा मॉडल के लिए रखी गई जॉइन कुंजी: `entity_id`।

## लीगेसी एक्सपोर्ट से अंतर

* **बॉट गतिविधि को क्लिक और क्रेडेंशियल गणना से बाहर रखा गया है।** पिछले प्रदाता का एक्सपोर्ट स्वचालित स्कैनर / बॉट इंटरैक्शन को क्लिक और क्रेडेंशियल सबमिशन के रूप में गिनता था। यह क्वेरी ऐसा नहीं करती। `bot_activity_detected = true` वाला परिणाम फिर भी एक डिलीवर किया गया सिमुलेशन है — वह `total_received` में और रिपोर्ट किए गए एग्रीगेट में गिना जाता है — लेकिन उसे गैर-क्लिक और गैर-सबमिशन माना जाता है: उसे `clicks` / `credential_submissions` से बाहर रखा जाता है और वह वर्तमान क्लिक स्ट्रीक को तोड़ देता है। लीगेसी एक्सपोर्ट से मिलान करने के लिए बॉट को गिनकर इसे "ठीक" न करें।
* **रिपोर्ट, क्लिक से ऊपर नहीं गिना जाता** `last_5_assessments` पर। जिस व्यक्ति ने क्लिक किया और बाद में रिपोर्ट किया, उसे `clicked` के रूप में लेबल किया जाता है।
* **डायरेक्टरी अतिरिक्त फ़ील्ड छोड़े गए हैं, null नहीं किए गए।** विभाग और इसी तरह के फ़ील्ड `/v1` पर उपलब्ध नहीं हैं।
* **कोई सर्वर-साइड समय फ़िल्टर नहीं।** `GET /v1/simulation_results` में कोई `delivered_after` नहीं है। क्वेरी प्रत्येक परिणाम का वॉक करती है, फिर पिछले 12 कैलेंडर महीनों में `delivered_at` वाले परिणाम रखती है। बड़े ऐतिहासिक डेटा वाला संगठन प्रति-कुंजी रेट बजट का फ़िल्टर की गई सूची की तुलना में अधिक उपयोग कर सकता है।

## अगले चरण

<CardGroup cols={2}>
  <Card title="Power BI और Excel सेटअप" href="/hi/developers/v1/powerbi">
    क्रेडेंशियल, पेजिनेशन, और इन क्वेरीज़ को Power BI या Excel में लोड करना।
  </Card>

  <Card title="ईमेल फ़िशिंग लॉग" href="/hi/developers/v1/reports/email-phishing-log">
    पिछले 12 महीनों के लिए इवेंट-स्तर की फ़िशिंग इंटरैक्शन।
  </Card>

  <Card title="प्रति-व्यक्ति अनुपालन" href="/hi/developers/v1/reports/per-person-compliance">
    व्यक्ति × असाइनमेंट ग्रेन पर Training नामांकन।
  </Card>

  <Card title="API कुंजियाँ" href="/hi/developers/developer-hub/api-keys">
    इस रिपोर्ट को रिफ़्रेश करने वाली कुंजी पर `simulation:read` और `entity:read` प्रदान करें।
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.