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

دليل المستودع: رادار إرهاق الإعلانات الإبداعية على Meta

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

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

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

Develop a pure Python CLI (fatigue_radar.py) that ingests daily Meta Ads performance CSVs (Date, Ad ID, Impressions, Reach, Frequency, Spend, Clicks, Conversions). Calculates 3-day and 7-day rolling CTR and CPA slopes, flags ads entering the 'Fatigue Danger Zone', outputs an interactive HTML radar dashboard with visual status badges, and generates a rotation priority list.

لمن صُمم؟

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

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

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

  • examples/fatigue_dashboard.html
  • examples/meta_sample_export.csv
  • LICENSE
  • README.md
  • src/fatigue_radar.py
  • templates/creative-refresh-sop.md
  • tests/test_radar.py

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

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

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

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

  • Audience Saturation Dynamics: Ad fatigue is measured via First-Time Impression Ratio (FTIR) and frequency acceleration curves, not static CTR drops.
  • API Rate Limiting: Meta Marketing API queries must implement exponential backoff when fetching granular daily ad-level insights.
  • Budget-Dependent Decay: Small daily budgets (<$50/ad set) exhibit slower decay curves than scaled ASC campaigns with rapid frequency buildup.

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

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