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.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.
/v1ham 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ındadesktop,mobile,tabletveunknownyer 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 hamuser_agentdizesi gizli kalır. - “Email Sent” değeri
simulation.deliveredolarak karşılanır. Gönderimleri filtrelerken veya sayarken bu belirteci kullanın. Eskiemail_sentdizesini 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
/entitiestaraması 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.
