ईमेल फ़िशिंग लॉग

यह रिपोर्ट इवेंट-स्तरीय फ़िशिंग लॉग है: प्रत्येक देखे गए सिमुलेशन इंटरैक्शन (date, action, recipient email, subject, from, difficulty) के लिए एक पंक्ति। यह लॉन्ग-फ़ॉर्म में ही रहती है — यह किसी व्यक्ति के इतिहास को एक ही परिणाम में संक्षिप्त नहीं करती। क्वेरी पिछले 12 कैलेंडर महीनों को occurred_after में समेटती है (बारह महीने पहले उसी तारीख़ की मध्यरात्रि UTC — 365 दिनों की अवधि नहीं)। सेटअप, क्रेडेंशियल, पेजिनेशन और रेट-लिमिट रीट्राई Power BI / Excel connectivity guide के समान हैं। पहले साझा Fn_FetchAll क्वेरी जोड़ें; यह रिपोर्ट उसे नाम से कॉल करती है।

​

आवश्यक की स्कोप

केवल simulation:read प्राप्त की रिपोर्टिंग इवेंट्स एंडपॉइंट को कॉल नहीं कर सकती (API 403 लौटाता है)। देखें choose the right grain।

​

स्रोत एंडपॉइंट

इवेंट्स लिस्ट पर अनुमत फ़िल्टर (इनके अलावा कुछ भी 400 लौटाता है): limit, page_token, simulation, entity, event_type, occurred_after। यह रिपोर्टिंग फ़ैमिली एक preview dataset है। डेटासेट स्कीमा और डेटा नीतियों को GET /v1/reporting/datasets और GET /v1/reporting/datasets/simulation_events पर देखें।

​

ग्रेन

प्रत्येक रिपोर्टिंग सिमुलेशन इवेंट के लिए एक पंक्ति। जिस व्यक्ति ने एक ही संदेश को खोला और फिर उस पर क्लिक किया, उसके लिए दो पंक्तियाँ बनती हैं। जिन इवेंट्स में entity_id null है (कोई एक्टर / प्राप्तकर्ता / लक्षित प्रतिभागी नहीं) वे भी दिखाई देते हैं — email null होता है। API विंडो को एक मिनट बढ़ाया जाता है; सटीक occurred_at >= WindowStart सीमा को स्थानीय रूप से पुनः लागू किया जाता है, ताकि पिछला वर्ष इस बात पर निर्भर न करे कि सर्वर occurred_after को समावेशी मानता है या अपवर्जी। रिक्वेस्ट बजट: विंडो में इवेंट्स का एक पेजिनेटेड वॉक, और एंटिटीज़ का एक वॉक। हमेशा limit = "500" सेट करें।

​

कॉलम मैपिंग

Legacy कॉलम नाम आपके पिछले प्रदाता के एक्सपोर्ट से हैं। /v1 फ़ील्ड्स सार्वजनिक API नाम हैं; क्वेरी रिपोर्ट के लिए इनमें से कुछ को ऐलियस करती है।

​

Action टोकन

action क्लोज़्ड रिपोर्टिंग टोकन है। Legacy “Email Sent” का मैप simulation.delivered से होता है (delivered सार्वजनिक क्रिया है; वायर टोकन simulation.delivered है)। API में उपलब्ध होने के कारण रखे गए अतिरिक्त फ़ील्ड: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, साथ ही एंटिटी जॉइन से entity_type और entity_status।

​

Legacy एक्सपोर्ट से अंतर

• रॉ IP कभी उपलब्ध नहीं होता। /v1 रॉ क्लाइंट IP को उजागर नहीं करेगा — यह प्राइवेसी बाय डिज़ाइन है, लंबित मैपिंग नहीं। क्वेरी कोई प्लेसहोल्डर IP कॉलम नहीं जोड़ती।
• डिवाइस टाइप व्युत्पन्न है, रॉ नहीं। device_type क्लिक, सबमिट और रिपोर्ट इवेंट्स के लिए एक व्युत्पन्न डिवाइस क्लास है। देखे गए टोकन में desktop, mobile, tablet और unknown शामिल हैं, लेकिन एमिटर एक फ़्री-फ़ॉर्म स्ट्रिंग संग्रहीत करता है — इसे ओपन टेक्स्ट मानें, क्लोज़्ड enum नहीं। जब इवेंट में कोई व्युत्पन्न क्लास नहीं होती तो यह null होता है, और रॉ user_agent स्ट्रिंग निजी रहती है।
• “Email Sent” simulation.delivered है। भेजे गए ईमेल को फ़िल्टर या गिनते समय इसी टोकन का उपयोग करें। Legacy email_sent स्ट्रिंग न खोजें।
• प्राप्तकर्ता का ईमेल जॉइन है, इवेंट पर फ़ील्ड नहीं। रिपोर्टिंग इवेंट में ईमेल शामिल नहीं होता; क्वेरी इसे भरने के लिए /entities को वॉक करती है।
• पिछले 12 कैलेंडर महीने, 365 दिनों की अवधि नहीं, और पूरा इतिहास भी नहीं।
• लॉन्ग-फ़ॉर्म, संक्षिप्त नहीं। प्रति इंटरैक्शन एक पंक्ति, प्रति व्यक्ति एक परिणाम नहीं।

​

अगले चरण