تُستبعد تفاعلات الماسحات الآلية / الروبوتات من أعداد النقرات
وبيانات الاعتماد. وهذا اختلاف متعمد عن التصدير القديم. راجع
الاختلافات عن التصدير القديم.
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 للمفتاح الذي يحدّث هذا التقرير.
