Skip to main content
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.
Kurulum, kimlik bilgileri, sayfalama ve hız sınırı sonrası yeniden deneme işlemleri Power BI / Excel bağlantı kılavuzu ile aynıdır. Önce paylaşılan Fn_FetchAll sorgusunu ekleyin; bu rapor onu adıyla çağırır.

Gerekli anahtar kapsamları

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.

Kaynak uç noktaları

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

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

Power BI ve Excel kurulumu

Kimlik bilgileri, sayfalama ve bu sorguları Power BI veya Excel’e yükleme.

En savunmasız kullanıcılar

Kişi başına 12 aylık tıklama, kimlik bilgisi ve bildirim özeti.

Kişi bazında uyumluluk

Kişi × atama ayrıntı düzeyinde Eğitim kayıtları.

API anahtarları

Bu raporu yenileyen anahtara reporting:read ve entity:read kapsamlarını verin.