محمود عبدالنبي
التقارير والتحليلات · أداة سطر أوامر · 2

دليل المستودع: أداة فحص سلامة طبقة البيانات وجودة أحداث التجارة الإلكترونية

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

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

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

Develop a pure Python dataLayer integrity testing tool (datalayer_sentinel.py): 1) Validates JSON-LD and dataLayer payloads against GA4 standard schemas (view_item, add_to_cart, begin_checkout, purchase), 2) Checks for critical parameters (currency ISO code, value numeric type, item arrays, transaction_id uniqueness), 3) Emits clear pass/fail terminal reports and JSON summaries suitable for GitHub Actions CI/CD.

لمن صُمم؟

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

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

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

  • ci/github-action-workflow.yml
  • examples/sample_datalayer_dumps.json
  • examples/sample_page_datalayer.json
  • LICENSE
  • README.md
  • schema/ecommerce_datalayer_schema.json
  • schemas/ga4_ecommerce_schemas.json
  • src/datalayer_sentinel.py
  • tests/test_sentinel.py

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

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

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

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

  • JSON Schema Validation: Validates client-side dataLayer.push payloads against strict schema contracts for standard e-commerce events.
  • Asynchronous Event Race Conditions: Detects when purchase or addToCart events push before user consent or container library initialization.
  • Automated CI/CD Quality Gate: Runs headless assertion tests during automated staging builds to prevent regressions during store checkout updates.

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

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