سجل التصيد الاحتيالي عبر البريد الإلكتروني

هذا التقرير هو سجل تصيد احتيالي على مستوى الحدث: صف واحد لكل تفاعل محاكاة تمت ملاحظته (التاريخ، الإجراء، البريد الإلكتروني للمستلم، الموضوع، المرسل، مستوى الصعوبة). ويظل بصيغة طويلة (long-form)، ولا يختزل سجل الشخص في نتيجة واحدة. يحتسب الاستعلام آخر 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 يومًا، وليس السجل الكامل.
• صيغة طويلة وغير مختزلة. صف واحد لكل تفاعل، وليس نتيجة واحدة لكل شخص.

​

الخطوات التالية