Skip to main content
هذا التقرير هو ملخص تجميعي لمدى التعرض للاختراق على مستوى كل مستخدم خلال 12 شهرًا: صف واحد لكل شخص تلقى محاكاة واحدة على الأقل خلال السنة الأخيرة، مع أعداد ونسب النقرات وبيانات الاعتماد والإبلاغات، وسلسلة النقرات الحالية، وقائمة مجمّعة لنتائج آخر 5 محاكاات. تبلغ مدة النافذة الزمنية 12 شهرًا تقويميًا (منتصف الليل بالتوقيت العالمي المنسق في اليوم نفسه من الشهر قبل اثني عشر شهرًا)، وليست مدة 365 يومًا.
تُستبعد تفاعلات الماسحات الآلية / الروبوتات من أعداد النقرات وبيانات الاعتماد. وهذا اختلاف متعمد عن التصدير القديم. راجع الاختلافات عن التصدير القديم.
إن الإعداد وبيانات الاعتماد والترقيم الصفحي وإعادة المحاولة عند تجاوز حد المعدل هي نفسها الواردة في دليل الاتصال بـ Power BI / Excel. أضف أولًا استعلام Fn_FetchAll المشترك؛ إذ يستدعيه هذا التقرير بالاسم.

نطاقات المفاتيح المطلوبة

يستخدم هذا التقرير قائمة النتائج التشغيلية على مستوى كل شخص، وليس عائلة المعاينة الخاصة بالتقارير. لا يمكن لمفتاح مُنح reporting:read فقط أن يستدعي GET /v1/simulation_results (تُرجع واجهة برمجة التطبيقات 403). راجع اختيار مستوى التفصيل المناسب.

نقاط النهاية المصدر

المرشحات المسموح بها في قائمة النتائج: limit وpage_token و simulation وentity. لا يوجد delivered_after / start_date في هذه القائمة، ولذلك تُطبَّق فترة الأشهر الـ 12 الأخيرة في Power Query بعد المرور الكامل على جميع النتائج. الحقول المستخدمة في كل نتيجة: id وsimulation وentity وstatus و targeted_at وdelivered_at وbounced_at وopened_at وclicked_at و attachment_opened_at وcredential_submitted_at وreported_at و reported_before_interaction وbot_activity_detected وemail_subject و sender_email وdifficulty_level وcreated_at وupdated_at.

مستوى التفصيل

صف واحد لكل كيان لديه نتيجة واحدة على الأقل مع delivered_at خلال الأشهر التقويمية الـ 12 الأخيرة. لا يظهر الشخص الذي استُهدف ولكن لم تُسلَّم إليه أي رسالة. وتُدمج هنا المحاكاة المتعددة للشخص نفسه. ميزانية الطلبات: مرور واحد مقسّم إلى صفحات على جميع نتائج المحاكاة في المؤسسة، بالإضافة إلى مرور واحد على الكيانات. اضبط limit = "500" دائمًا.

أولوية النتائج (last_5_assessments)

تُلخَّص كل نتيجة من النتائج الخمس الأحدث المُسلَّمة (بترتيب delivered_at التنازلي) على أنها YYYY-MM-DD: <outcome>. يُعتمد أول طابع زمني مطابق، بدءًا من الأعلى أولوية: الحالة «مُسلَّمة فقط» هي no action (وصلت الرسالة؛ ولم يفعل الشخص شيئًا). أما الشخص الذي نقر ثم أبلغ لاحقًا فهو clicked — فالإبلاغ لا يتقدم على التفاعل الخطر في هذه القائمة. وتحصل الصفوف الموسومة كروبوتات على تسمية نتيجة من الطوابع الزمنية الموجودة؛ لكنها فقط لا تزيد أعداد النقرات / بيانات الاعتماد. سلسلة النقرات الحالية: امرّ على نتائج الرسائل المُسلَّمة نفسها بدءًا من الأحدث واحسب الصفوف المتتالية التي يكون فيها clicked_at غير فارغ و bot_activity_detected لا يساوي true. توقف عند أول صف لا يستوفي ذلك.

مطابقة الأعمدة

أسماء الأعمدة القديمة مأخوذة من تصدير مزودك السابق. حقول /v1 هي أسماء واجهة برمجة التطبيقات العامة؛ ويشتق الاستعلام الأعداد والنسب. مفتاح الربط المحتفَظ به لنموذج المخطط النجمي: entity_id.

الاختلافات عن التصدير القديم

  • يُستبعد نشاط الروبوتات من أعداد النقرات وبيانات الاعتماد. كان تصدير المزود السابق يحتسب تفاعلات الماسحات الآلية / الروبوتات كنقرات وعمليات إرسال لبيانات الاعتماد. أما هذا الاستعلام فلا يفعل ذلك. فالنتيجة التي تحمل bot_activity_detected = true تظل محاكاة مُسلَّمة — إذ تُحتسب في total_received وفي إجماليات الإبلاغ — لكنها تُعامل على أنها ليست نقرة وليست عملية إرسال: فهي مستبعدة من clicks / credential_submissions وتقطع سلسلة النقرات الحالية. لا «تصحح» ذلك باحتساب الروبوتات لمطابقة التصدير القديم.
  • الإبلاغ لا يتقدم على النقرة في last_5_assessments. فالشخص الذي نقر ثم أبلغ لاحقًا يُسمّى clicked.
  • الحقول الإضافية في الدليل محذوفة وليست فارغة. القسم وما شابهه من الحقول غير موجودة في /v1.
  • لا يوجد مرشح زمني من جهة الخادم. لا يحتوي GET /v1/simulation_results على delivered_after. يمرّ الاستعلام على كل النتيجة، ثم يُبقي delivered_at ضمن الأشهر التقويمية الـ 12 الأخيرة. وقد تستهلك المؤسسة الكبيرة ذات السجل التاريخي الواسع جزءًا أكبر من ميزانية المعدل لكل مفتاح مقارنة بقائمة مرشَّحة.

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

إعداد Power BI وExcel

بيانات الاعتماد والترقيم الصفحي وتحميل هذه الاستعلامات في Power BI أو Excel.

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

تفاعلات التصيد على مستوى الأحداث خلال الأشهر الـ 12 الأخيرة.

الامتثال لكل شخص

تسجيلات التدريب على مستوى الشخص × التكليف.

مفاتيح واجهة برمجة التطبيقات

امنح simulation:read وentity:read للمفتاح الذي يحدّث هذا التقرير.