دليل المستودع: مركز حوكمة UTM ومنشئ روابط تفاعلي
صفحة تعريفية مستقلة بمستودع مركز حوكمة UTM ومنشئ روابط تفاعلي. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.
المشكلة التي يعالجها
يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:
Build an open-source UTM governance hub: 1) Single-file responsive HTML/JS tool (index.html) running client-side with dropdown enforcement strictly adhering to GA4 Default Channel Grouping rules, 2) Python CLI (utm_validator.py) auditing CSV lists of live ad links, 3) Enterprise UTM policy document, 4) Integration cheat sheet for Slack/Teams.لمن صُمم؟
الجمهور المحدد في README: BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.
محتويات المستودع
الملفات الأساسية التي يسردها قسم بنية المستودع في README:
config/utm_taxonomy.jsondocs/utm-best-practices.mdexamples/sample_links_audit.csvindex.htmlLICENSEpolicy/enterprise-utm-standards.mdREADME.mdsrc/url_cleaner.pysrc/utm_validator.pytests/test_cleaner.pytests/test_validator.pytools/index.html
طريقة مراجعته واستخدامه
- ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
- افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
- اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
- قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.
أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/url_cleaner.py --help
النطاق والقيود
- Case Sensitivity & Normalization: Enforces strict lowercase normalization on utm_source, utm_medium, and utm_campaign to prevent reporting fragmentation.
- Delimiter Standard: Replaces spaces with hyphens or underscores; flags unauthorized punctuation characters.
- Encoding Compliance: Ensures landing page URLs with Arabic query parameters or anchors are properly percent-encoded per RFC 3986.
هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.