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

# En savunmasız kullanıcılar

> Önceki bir sağlayıcının 12 aylık en savunmasız kullanıcılar özetini /v1 simülasyon sonuçlarından ve varlıklardan yeniden oluşturun.

Bu rapor, kullanıcı bazında 12 aylık savunmasızlık özetidir: son bir yıl içinde en az bir simülasyon alan her kişi için bir satır içerir; satırda tıklama / kimlik bilgisi / bildirim sayıları ve oranları, güncel tıklama serisi ve birleştirilmiş son 5 sonuç listesi yer alır.

Zaman aralığı **12 takvim ayıdır** (on iki ay önceki aynı ayın gününde UTC gece yarısı); 365 günlük bir süre değildir.

<Note>
  Otomatik tarayıcı / bot etkileşimleri tıklama ve kimlik bilgisi
  sayımlarının dışında tutulur. Bu, eski dışa aktarımdan kasıtlı bir
  farklılıktır. Bkz.
  [Eski dışa aktarımdan farklılıklar](#eski-d%C4%B1%C5%9Fa-aktar%C4%B1mdan-farkl%C4%B1l%C4%B1klar).
</Note>

Kurulum, kimlik bilgileri, sayfalama ve hız sınırı sonrası yeniden deneme,
[Power BI / Excel bağlantı kılavuzu](/tr/developers/v1/powerbi) ile aynıdır. Önce
paylaşılan `Fn_FetchAll` sorgusunu ekleyin; bu rapor onu adıyla çağırır.

## Gerekli anahtar kapsamları

| Kapsam | Kullanım amacı |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (e-posta ve görünen ad birleştirmesi) |

Bu rapor, raporlama önizleme ailesini değil, **operasyonel** kişi bazlı sonuç listesini kullanır. Yalnızca `reporting:read` verilmiş bir anahtar `GET /v1/simulation_results` uç noktasını çağıramaz (API `403` döndürür). Bkz.
[doğru ayrıntı düzeyini seçin](/tr/developers/v1/powerbi#do%C4%9Fru-ayr%C4%B1nt%C4%B1-d%C3%BCzeyini-se%C3%A7in).

## Kaynak uç noktalar

| Uç nokta | Rol |
| - | - |
| `GET /v1/simulation_results` | Alıcı bazında sonuç. Olgu ayrıntı düzeyi budur. |
| `GET /v1/entities` | `entity` değerini e-posta / görünen ada çözümler. Sonuç satırında alıcının kendi e-postası veya görünen adı yoktur (yalnızca `entity` bulunur). |

Sonuç listesindeki izin verilen filtreler: `limit`, `page_token`,
`simulation`, `entity`. Bu listede `delivered_after` / `start_date` yoktur; bu nedenle son 12 aylık filtre, tüm liste dolaşıldıktan sonra Power Query'de uygulanır.

Her sonuçta kullanılan alanlar: `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`.

### Ayrıntı düzeyi

Son 12 takvim ayında `delivered_at` olan en az bir sonucu bulunan her varlık için bir satır. Hedeflenen ancak hiç teslim edilmeyen bir kişi görünmez. Aynı kişi için birden fazla simülasyon burada tek satırda birleşir.

İstek bütçesi: kuruluştaki tüm simülasyon sonuçlarının sayfalanmış tek bir dolaşımı ve varlıkların bir dolaşımı. Daima `limit = "500"` ayarlayın.

## Sonuç önceliği (`last_5_assessments`)

Teslim edilen en son beş sonucun her biri (`delivered_at` azalan sırada) `YYYY-MM-DD: <outcome>` olarak özetlenir. Eşleşen ilk zaman damgası geçerlidir; en yüksek öncelik ilk sıradadır:

| Öncelik | Zaman damgası | Sonuç etiketi |
| - | - | - |
| 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` |

Yalnızca teslim edilmiş durumu `no action` olarak gösterilir (ileti ulaştı; kişi hiçbir şey yapmadı). Tıklayan ve daha sonra bildiren bir kişi `clicked` olur; bu listede bildirim, riskli bir etkileşimin önüne geçmez. Bot işaretli satırlar da mevcut zaman damgalarına göre bir sonuç etiketi alır; yalnızca tıklama / kimlik bilgisi sayılarını artırmazlar.

**Güncel tıklama serisi:** Aynı teslim edilmiş sonuçları en yeniden başlayarak dolaşın ve `clicked_at` değerinin boş olmadığı **ve** `bot_activity_detected` değerinin `true` olmadığı ardışık satırları sayın. İlk uyuşmazlıkta durun.

## Sütun eşlemesi

Eski sütun adları, önceki sağlayıcınızın dışa aktarımından alınmıştır. `/v1` alanları genel API adlarıdır; sayıları ve oranları sorgu türetir.

| Eski sütun | `/v1` alanı veya türetme | Rapor sütunu |
| - | - | - |
| Email | `Entity.email` (`Result.entity` üzerinden birleştirme) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | `delivered_at` değeri boş olmayan sonuçların sayısı (bot işaretli satırlar dahil) | `total_received` |
| Clicks # | `clicked_at` değerinin boş olmadığı **ve** `bot_activity_detected` ≠ `true` olan kayıtların sayısı | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | `credential_submitted_at` değerinin boş olmadığı **ve** `bot_activity_detected` ≠ `true` olan kayıtların sayısı | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | `reported_at` değeri boş olmayan kayıtların sayısı (botlar dahil; tıklama/kimlik bilgisi değildir) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | Kişinin tıkladığı, teslim edilmiş en yeni ardışık sonuçlar (botlar seriyi keser) | `current_click_streak` |
| Last 5 assessments | `"; "` ile ayrılmış, teslim edilmiş en yeni beş sonuç (bkz. [öncelik](#sonuç-önceliği-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | `/v1` üzerinde yoktur | Atlanır, boş bırakılmaz |

Yıldız şemalı bir model için tutulan birleştirme anahtarı: `entity_id`.

## Eski dışa aktarımdan farklılıklar

* **Bot etkinliği, tıklama ve kimlik bilgisi sayımlarının dışında tutulur.** Önceki bir sağlayıcının dışa aktarımı, otomatik tarayıcı / bot etkileşimlerini tıklama ve kimlik bilgisi gönderimi olarak sayıyordu. Bu sorgu saymaz. `bot_activity_detected = true` olan bir sonuç yine de teslim edilmiş bir simülasyondur; `total_received` içinde ve bildirim toplamlarında sayılır, ancak tıklama değil ve gönderim değil olarak değerlendirilir: `clicks` / `credential_submissions` dışında tutulur ve güncel tıklama serisini keser. Bunu, eski dışa aktarımla eşleşmesi için botları sayarak "düzeltmeyin".
* **Bildirim, `last_5_assessments` üzerinde tıklamanın önüne geçmez.** Tıklayan ve daha sonra bildiren bir kişi `clicked` olarak etiketlenir.
* **Dizin ek alanları atlanır, boş bırakılmaz.** Departman ve benzeri alanlar `/v1` üzerinde yoktur.
* **Sunucu tarafında zaman filtresi yoktur.** `GET /v1/simulation_results` uç noktasında `delivered_after` yoktur. Sorgu tüm sonuçları dolaşır, ardından yalnızca son 12 takvim ayındaki `delivered_at` kayıtlarını tutar. Geçmişi büyük bir kuruluş, filtrelenmiş bir listeye göre anahtar başına hız bütçesinin daha büyük bir bölümünü harcayabilir.

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Power BI ve Excel kurulumu" href="/tr/developers/v1/powerbi">
    Kimlik bilgileri, sayfalama ve bu sorguları Power BI veya Excel'e yükleme.
  </Card>

  <Card title="E-posta kimlik avı günlüğü" href="/tr/developers/v1/reports/email-phishing-log">
    Son 12 ay için olay düzeyinde kimlik avı etkileşimleri.
  </Card>

  <Card title="Kişi bazında uyumluluk" href="/tr/developers/v1/reports/per-person-compliance">
    Kişi × atama ayrıntı düzeyinde Eğitim kayıtları.
  </Card>

  <Card title="API anahtarları" href="/tr/developers/developer-hub/api-keys">
    Bu raporu yenileyen anahtara `simulation:read` ve `entity:read` kapsamlarını verin.
  </Card>
</CardGroup>


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