> ## 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. # E-posta kimlik avı günlüğü > Önceki sağlayıcınızın olay düzeyindeki kimlik avı günlüğünü, /v1 raporlama simülasyon olayları ve varlıklarından yeniden oluşturun. Bu rapor, olay düzeyinde bir kimlik avı günlüğüdür: gözlemlenen her simülasyon etkileşimi için bir satır (tarih, eylem, alıcı e-postası, konu, gönderen, zorluk). Uzun biçimli kalır; bir kişinin geçmişini tek bir sonuca indirgemez. Sorgu, son **12 takvim ayını** `occurred_after` içine katar (on iki ay önceki aynı ayın gününde UTC gece yarısı; 365 günlük bir süre değildir). Ham istemci IP adresi hiçbir zaman `/v1` üzerinde yer almaz; bu, tasarım gereği gizliliktir ve bekleyen bir eşleme değildir. Cihaz türü, olay satırında türetilmiş bir sınıftır; ham `user_agent` gizli kalır. Bkz. [Eski dışa aktarımdan farklılıklar](#eski-d%C4%B1%C5%9Fa-aktar%C4%B1mdan-farkl%C4%B1l%C4%B1klar). Kurulum, kimlik bilgileri, sayfalama ve hız sınırı sonrası yeniden deneme işlemleri [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ı | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (e-posta ve görünen ad birleştirmesi) | Yalnızca `simulation:read` kapsamı verilmiş bir anahtar, raporlama olayları uç noktasını çağıramaz (API `403` döndürür). Bkz. [doğru ayrıntı düzeyini seçme](/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/reporting/simulation_events` | Olay düzeyinde olgu. Ayrıntı düzeyi, yazılmış tek bir etkileşimdir. `email_subject`, `sender_email`, `sender_domain` ve `difficulty_tier` bu satırda yer alır; bu nedenle sorgu, bu alanlar için kampanya düzeyindeki sonuçları birleştirmez. | | `GET /v1/entities` | `entity_id` → e-posta / görünen ad eşlemesini çözer. Raporlama olayı alıcı e-postasını içermez (raporlama okuyucusunda kesin bir dışlamadır). Eski "email" sütunu, `/entities` taranarak doldurulur. | Olay listesindeki izin verilen filtreler (başka herhangi biri `400` döndürür): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Bu raporlama ailesi bir [önizleme veri kümesidir](/tr/developers/v1/powerbi#raporlama-%C3%B6nizleme-veri-k%C3%BCmeleri-ki%C5%9Fi-ba%C5%9F%C4%B1na-kimlik-av%C4%B1). Veri kümesi şemasını ve veri ilkelerini `GET /v1/reporting/datasets` ve `GET /v1/reporting/datasets/simulation_events` adreslerinden inceleyebilirsiniz. ### Ayrıntı düzeyi Her raporlama simülasyon olayı için bir satır. Aynı iletiyi önce açıp sonra tıklayan bir kişi iki satır oluşturur. `entity_id` değeri null olan olaylar (aktör / alıcı / hedef katılımcı yok) yine de görünür; `email` null olur. API penceresi bir dakika genişletilir; kesin `occurred_at >= WindowStart` sınırı yerel olarak yeniden uygulanır, böylece son bir yıl, sunucunun `occurred_after` değerini dahil mi yoksa hariç mi değerlendirdiğine bağlı olmaz. İstek bütçesi: pencere içindeki olaların sayfalanmış tek bir taraması ve varlıkların bir taraması. Her zaman `limit = "500"` ayarını yapın. ## 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; sorgu, rapor için bazılarına takma ad verir. | Eski sütun | `/v1` alanı veya türetme | Rapor sütunu | | - | - | - | | Date | `Event.occurred_at` (tarih olarak; ham `occurred_at` değeri `datetimezone` olarak korunur) | `date` | | Action | `Event.event_type` — aşağıda listelenen kapalı belirteçler | `action` | | Email | `Entity.email` (`entity_id` üzerinden birleştirme) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` — 1–5 arası tam sayı, 1 en kolay, 5 en zor | `difficulty` | | Raw IP | Hiçbir zaman `/v1` üzerinde yer almaz | Çıkarılmıştır, null yapılmamıştır | | Device type | `Event.device_type` — türetilmiş sınıf; olayın türetilmiş sınıfı yoksa null | `device_type` | ### Eylem belirteçleri `action`, kapalı raporlama belirtecidir. Eski "Email Sent" değeri `simulation.delivered` ile eşlenir (`delivered` genel fiildir; iletim belirteci `simulation.delivered` değeridir). | `action` değeri | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | API'de bulunduğu için korunan ek alanlar: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, ayrıca varlık birleştirmesinden gelen `entity_type` ve `entity_status`. ## Eski dışa aktarımdan farklılıklar * **Ham IP hiçbir zaman kullanılamaz.** `/v1` ham istemci IP adresini sunmaz; bu, tasarım gereği gizliliktir ve bekleyen bir eşleme değildir. Sorgu, yer tutucu bir IP sütunu eklemez. * **Cihaz türü ham değil, türetilmiştir.** `device_type`, tıklama, gönderme ve bildirme olayları için türetilmiş bir cihaz sınıfıdır. Gözlemlenen belirteçler arasında `desktop`, `mobile`, `tablet` ve `unknown` yer alır; ancak yayıcı serbest biçimli bir dize depolar, bu nedenle bunu kapalı bir sabit liste olarak değil, açık metin olarak değerlendirin. Olayın türetilmiş sınıfı yoksa null olur ve ham `user_agent` dizesi gizli kalır. * **"Email Sent" değeri `simulation.delivered` olarak karşılanır.** Gönderimleri filtrelerken veya sayarken bu belirteci kullanın. Eski `email_sent` dizesini aramayın. * **Alıcı e-postası, olay üzerinde bir alan değil, bir birleştirmedir.** Raporlama olayı e-postayı içermez; sorgu, bunu doldurmak için `/entities` taraması yapar. * **Son 12 takvim ayı**; 365 günlük bir süre değildir ve tüm geçmiş de değildir. * **Uzun biçimli, indirgenmemiş.** Kişi başına bir sonuç değil, etkileşim başına bir satır. ## Sonraki adımlar Kimlik bilgileri, sayfalama ve bu sorguları Power BI veya Excel'e yükleme. Kişi başına 12 aylık tıklama, kimlik bilgisi ve bildirim özeti. Kişi × atama ayrıntı düzeyinde Eğitim kayıtları. Bu raporu yenileyen anahtara `reporting:read` ve `entity:read` kapsamlarını verin. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.