محمود عبدالنبي
شراء الوسائط · أداة سطر أوامر · 2

دليل المستودع: قاطع تلقائي لرصد شذوذ الإنفاق الإعلاني والموسمية

صفحة تعريفية مستقلة بمستودع قاطع تلقائي لرصد شذوذ الإنفاق الإعلاني والموسمية. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Create a Python spend anomaly detection script (circuit_breaker.py) that monitors campaign spend records against hourly velocity thresholds, conversion drop-off anomalies, and CPA ceilings. Features: 1) Configurable JSON rules for spend limits, 2) Mock simulation test suite replicating flash-sale pacing spikes, 3) Out-of-the-box Telegram and Discord alert webhook dispatchers, 4) Complete operational runbook.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • config/alert_rules.sample.json
  • examples/simulated_spend_log.json
  • LICENSE
  • playbooks/emergency-runbook.md
  • README.md
  • src/circuit_breaker.py
  • tests/test_circuit_breaker.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/circuit_breaker.py --help

النطاق والقيود

  • Multi-Platform API Latency: Real-time spend anomaly detection must account for 15-to-45 minute reporting delays on Meta and TikTok APIs.
  • Seasonal Spend Spikes: Circuit breakers during White Friday or Ramadan require dynamic thresholds to avoid pausing profitable hyper-scaling campaigns.
  • Safe Auto-Pause Execution: Automated script errors default to notifying on-call media buyers via webhook rather than silently killing high-ROI ads.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة