יומן פישינג בדוא"ל

דוח זה הוא יומן פישינג ברמת אירוע: שורה אחת לכל אינטראקציית סימולציה שנצפתה (תאריך, פעולה, כתובת דוא”ל של הנמען, נושא, שולח, רמת קושי). הוא נשאר בפורמט ארוך — הוא אינו מכווץ את ההיסטוריה של אדם לתוצאה אחת. השאילתה מקפלת 12 חודשי לוח אחרונים אל תוך occurred_after (חצות UTC באותו יום בחודש לפני שנים עשר חודשים — ולא משך של 365 ימים). ההגדרה, האישורים, ההחלוקה לעמודים וניסיונות חוזרים במקרה של הגבלת קצב זהים למדריך החיבור ל-Power BI / Excel. הוסיפו תחילה את שאילתת Fn_FetchAll המשותפת; דוח זה קורא לה בשמה.

​

היקפי מפתח נדרשים

מפתח שניתן לו רק simulation:read אינו יכול לקרוא לנקודת הקצה של אירועי הדיווח (ה-API מחזיר 403). ראו בחירת רמת הפירוט המתאימה.

​

נקודות קצה מקור

מסננים מותרים ברשימת האירועים (כל מסנן אחר מחזיר 400): limit, page_token, simulation, entity, event_type, occurred_after. משפחת דיווח זו היא מערך נתוני תצוגה מקדימה. ניתן לעיין בסכמת מערך הנתונים ובמדיניות הנתונים בכתובות GET /v1/reporting/datasets ו- GET /v1/reporting/datasets/simulation_events.

​

רמת פירוט

שורה אחת לכל אירוע סימולציה בדיווח. אדם שפתח ולאחר מכן לחץ על אותה הודעה יוצר שתי שורות. אירועים עם entity_id ריק (ללא משתתף פועל / נמען / יעד) עדיין מופיעים — email ריק. חלון ה-API מורחב בדקה אחת; הגבול המדויק של occurred_at >= WindowStart מוחל מחדש באופן מקומי, כך שהשנה האחרונה אינה תלויה בשאלה אם השרת מתייחס ל-occurred_after ככולל או כבלעדי. תקציב בקשות: מעבר אחד מחולק לעמודים על האירועים בחלון, ועוד מעבר אחד על הישויות. הקפידו תמיד להגדיר את limit = "500".

​

מיפוי עמודות

שמות העמודות הקודמים לקוחים מהייצוא של הספק הקודם שלכם. שדות /v1 הם שמות ה-API הציבוריים; השאילתה נותנת כינוי לחלקם עבור הדוח.

​

אסימוני פעולה

action הוא אסימון הדיווח הסגור. “Email Sent” מהייצוא הקודם ממופה ל-simulation.delivered (delivered הוא הפועל הציבורי; האסימון בפרוטוקול הוא simulation.delivered). שדות נוספים נשמרים מפני שה-API כולל אותם: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, וכן entity_type ו-entity_status מצירוף הישויות.

​

הבדלים ביחס לייצוא הקודם

• כתובת IP גולמית אינה זמינה לעולם. /v1 לא יחשוף כתובת IP גולמית של לקוח — זהו עיקרון של פרטיות מעצם התכנון, ולא מיפוי שממתין להשלמה. השאילתה אינה מוסיפה עמודת IP זמנית.
• סוג המכשיר נגזר ואינו גולמי. device_type הוא סיווג מכשיר נגזר עבור אירועי לחיצה, שליחה ודיווח. האסימונים שנצפו כוללים desktop, mobile, tablet ו-unknown, אך המשדר שומר מחרוזת חופשית — יש להתייחס אליה כטקסט פתוח ולא כמספר סגור של ערכים. הוא ריק כאשר לאירוע אין סיווג נגזר, ומחרוזת user_agent הגולמית נשארת פרטית.
• “Email Sent” הוא simulation.delivered. השתמשו באסימון זה בעת סינון או ספירה של שליחות. אל תחפשו מחרוזת email_sent מהייצוא הקודם.
• כתובת הדוא”ל של הנמען היא צירוף ולא שדה באירוע. אירוע הדיווח אינו כולל דוא”ל; השאילתה עוברת על /entities כדי למלא אותו.
• 12 חודשי לוח אחרונים, ולא משך של 365 ימים, ולא ההיסטוריה המלאה.
• פורמט ארוך, ללא כיווץ. שורה אחת לכל אינטראקציה, ולא תוצאה אחת לכל אדם.

​

השלבים הבאים