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

دليل المستودع: مدقق قواعد تسمية الإعلانات وتصنيفها

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

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

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

Build an ad naming governance and validation toolkit: 1) Universal ad naming taxonomy specification ([Channel]_[Objective]_[Audience]_[Angle]_[Format]_[Date]), 2) Pure Python linter script (taxonomy_linter.py) that audits CSV ad exports and flags invalid names, 3) Interactive Excel/Sheets formula generator for building valid names, 4) Integration guide for automated Slack/Discord notifications.

لمن صُمم؟

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

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

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

  • config/taxonomy_rules.json
  • examples/ad_names_sample.csv
  • examples/valid_and_invalid_campaigns.csv
  • LICENSE
  • README.md
  • reports/validation_errors.csv
  • spec/universal-taxonomy-spec.md
  • src/naming_validator.py
  • src/taxonomy_linter.py
  • templates/formula-builder.md
  • tests/test_linter.py
  • tests/test_naming.py

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

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

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

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

  • Delimiter Parsing Consistency: Standardizes double-underscore or pipe delimiters across Meta, Google, and TikTok naming conventions.
  • Token Integrity: Enforces required fields (Geo, Funnel Stage, Objective, Creator Handle, Angle, Format, Aspect Ratio).
  • Automated ETL Cleanliness: Validated names ensure clean dimension splitting in BigQuery and Looker Studio dashboards without messy regex overrides.

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

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