> ## 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.
# Eng ko‘p zaif foydalanuvchilar
> Oldingi provayderning 12 oylik eng ko‘p zaif foydalanuvchilar yig‘ma hisobotini /v1 simulyatsiya natijalari va obyektlari asosida qayta yarating.
Ushbu hisobot har bir foydalanuvchi bo‘yicha 12 oylik zaiflik yig‘ma hisoboti hisoblanadi: so‘nggi bir yil ichida kamida bitta simulyatsiya olgan har bir shaxs uchun bitta qator, unda bosish / hisob ma’lumotlarini kiritish / xabar berish sonlari va ko‘rsatkichlari, joriy bosishlar ketma-ketligi hamda oxirgi 5 ta natijaning birlashtirilgan ro‘yxati keltiriladi.
Vaqt oynasi — **12 taqvim oyi** (12 oy avvalgi xuddi shu oy kunining UTC bo‘yicha yarim tuni), 365 kunlik davomiylik emas.
Avtomatlashtirilgan skaner / bot o‘zaro ta’sirlari bosishlar va hisob ma’lumotlarini kiritish sonlariga kiritilmaydi. Bu eski eksportdan ataylab qilingan farqdir. Qarang:
[Eski eksportdan farqlar](#eski-eksportdan-farqlar).
Sozlash, hisob ma’lumotlari, sahifalash va tezlik cheklovi bo‘yicha qayta urinish [Power BI / Excel ulanish qo‘llanmasi](/uz/developers/v1/powerbi) bilan bir xil. Avval umumiy `Fn_FetchAll` so‘rovini qo‘shing; ushbu hisobot uni nomi bo‘yicha chaqiradi.
## Kerakli kalit ruxsatlari (scopes)
| Scope | Qo‘llanilishi |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (email va ko‘rsatiladigan ism bo‘yicha birlashtirish) |
Ushbu hisobot hisobotlarning dastlabki ko‘rinish oilasini emas, balki **operatsion** shaxslar bo‘yicha natijalar ro‘yxatidan foydalanadi. Faqat `reporting:read` ruxsati berilgan kalit `GET /v1/simulation_results` endpointini chaqira olmaydi (API `403` qaytaradi). Qarang:
[to‘g‘ri detallashtirish darajasini tanlang](/uz/developers/v1/powerbi#to-g-ri-kesimni-tanlang).
## Manba endpointlari
| Endpoint | Vazifasi |
| - | - |
| `GET /v1/simulation_results` | Har bir oluvchi bo‘yicha natija. Bu fakt darajasidir. |
| `GET /v1/entities` | `entity` qiymatini email / ko‘rsatiladigan ismga aylantiradi. Natija qatorida oluvchining o‘z emaili yoki ko‘rsatiladigan ismi yo‘q (faqat `entity`). |
Natijalar ro‘yxatida ruxsat etilgan filtrlar: `limit`, `page_token`, `simulation`, `entity`. Ushbu ro‘yxatda `delivered_after` / `start_date` yo‘q, shuning uchun oxirgi 12 oy filtri to‘liq o‘tishdan keyin Power Query’da qo‘llaniladi.
Har bir natijada ishlatiladigan maydonlar: `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`.
### Detallashtirish darajasi
So‘nggi 12 taqvim oyida `delivered_at` bo‘lgan kamida bitta natijaga ega har bir obyekt uchun bitta qator. Nishonga olingan, ammo hech qachon yetkazilmagan shaxs ko‘rinmaydi. Bir shaxs uchun bir nechta simulyatsiya bu yerda birlashtiriladi.
So‘rovlar hajmi: tashkilotdagi barcha simulyatsiya natijalarini sahifalab bir marta o‘tish, shuningdek obyektlarni bir marta o‘tish. Doimo `limit = "500"` ni o‘rnating.
## Natijalar ustuvorligi (`last_5_assessments`)
Eng so‘nggi beshta yetkazilgan natija (`delivered_at` bo‘yicha kamayish tartibida) `YYYY-MM-DD: ` sifatida jamlanadi. Birinchi mos keladigan vaqt tamg‘asi ustun bo‘ladi, eng yuqori ustuvorlikdan boshlab:
| Ustuvorlik | Vaqt tamg‘asi | Natija yorlig‘i |
| - | - | - |
| 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` |
Faqat yetkazilgan holati — `no action` (xabar yetib keldi; shaxs hech narsa qilmadi). Bosgan va keyin xabar bergan shaxs `clicked` hisoblanadi — ushbu ro‘yxatda xabar berish xavfli o‘zaro ta’sirdan ustun turmaydi. Bot deb belgilangan qatorlar ham mavjud vaqt tamg‘alariga ko‘ra natija yorlig‘ini oladi; ular faqat bosish / hisob ma’lumotlarini kiritish sonlarini oshirmaydi.
**Joriy bosishlar ketma-ketligi:** o‘sha yetkazilgan natijalarni eng yangisidan boshlab ko‘rib chiqing va `clicked_at` bo‘sh bo‘lmagan **hamda** `bot_activity_detected` qiymati `true` bo‘lmagan ketma-ket qatorlarni sanang. Birinchi mos kelmaslikda to‘xtang.
## Ustunlar xaritasi
Eski ustun nomlari oldingi provayderingiz eksportidan olingan. `/v1` maydonlari — ommaviy API nomlari; sonlar va ko‘rsatkichlarni so‘rov hisoblab chiqaradi.
| Eski ustun | `/v1` maydoni yoki hisoblash usuli | Hisobot ustuni |
| - | - | - |
| Email | `Entity.email` (`Result.entity` bo‘yicha birlashtirish) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | `delivered_at` bo‘sh bo‘lmagan natijalar soni (bot deb belgilangan qatorlar ham kiradi) | `total_received` |
| Clicks # | `clicked_at` bo‘sh bo‘lmagan **va** `bot_activity_detected` ≠ `true` bo‘lgan qatorlar soni | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | `credential_submitted_at` bo‘sh bo‘lmagan **va** `bot_activity_detected` ≠ `true` bo‘lgan qatorlar soni | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | `reported_at` bo‘sh bo‘lmagan qatorlar soni (botlar kiradi — bu bosish/hisob ma’lumotlarini kiritish emas) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | Shaxs bosgan, eng yangi yetkazilgan natijalar ketma-ketligi (botlar uni uzadi) | `current_click_streak` |
| Last 5 assessments | Eng yangi beshta yetkazilgan natija, `"; "` bilan ajratilgan (qarang: [ustuvorlik](#natijalar-ustuvorligi-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | `/v1` da mavjud emas | Qoldirilgan, null qilinmagan |
Yulduzsimon (star-schema) modeli uchun saqlangan birlashtirish kaliti: `entity_id`.
## Eski eksportdan farqlar
* **Bot faolligi bosishlar va hisob ma’lumotlarini kiritish sonlariga kiritilmaydi.** Oldingi provayder eksporti avtomatlashtirilgan skaner / bot o‘zaro ta’sirlarini bosish va hisob ma’lumotlarini kiritish sifatida hisoblagan. Ushbu so‘rov buni qilmaydi. `bot_activity_detected = true` bo‘lgan natija baribir yetkazilgan simulyatsiya hisoblanadi — u `total_received` ga va xabar berish bo‘yicha yig‘ma ko‘rsatkichlarga kiradi — lekin u bosmaslik va kiritmaslik sifatida qaraladi: u `clicks` / `credential_submissions` dan chiqarib tashlanadi va joriy bosishlar ketma-ketligini uzadi. Eski eksportga moslash uchun botlarni hisoblash orqali buni “tuzatmang”.
* **Xabar berish `last_5_assessments` da bosishdan ustun turmaydi.** Bosgan va keyin xabar bergan shaxs `clicked` deb belgilanadi.
* **Katalog qo‘shimcha ma’lumotlari qoldiriladi, null qilinmaydi.** Bo‘lim va shunga o‘xshash maydonlar `/v1` da mavjud emas.
* **Server tomonida vaqt filtri yo‘q.** `GET /v1/simulation_results` da `delivered_after` yo‘q. So‘rov barcha natijalarni o‘tadi, so‘ng oxirgi 12 taqvim oyidagi `delivered_at` ni saqlab qoladi. Katta tarixga ega tashkilot filtrlangan ro‘yxatga qaraganda har bir kalit uchun tezlik limitining ko‘proq qismini sarflashi mumkin.
## Keyingi qadamlar
Hisob ma’lumotlari, sahifalash va ushbu so‘rovlarni Power BI yoki Excel’ga yuklash.
So‘nggi 12 oy uchun hodisalar darajasidagi fishing o‘zaro ta’sirlari.
Shaxs × topshiriq darajasidagi Training ro‘yxatdan o‘tishlari.
Ushbu hisobotni yangilaydigan kalitga `simulation:read` va `entity:read` ruxsatlarini bering.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.