محمود عبدالنبي
التقارير والتحليلات · مجموعة بيانات منتقاة · 1

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

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

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

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

Build an exhaustive GA4 e-commerce taxonomy and BigQuery SQL schema pack for MENA: 1) Extended e-commerce event taxonomy specification (including cod_placed, cod_verified, bnpl_selected, delivery_completed), 2) BigQuery SQL query templates that require adaptation and validation against your GA4 export schema (unnesting events, customer lifetime value, blended attribution), 3) GTM Web and Server-Side container examples that require review and configuration before import.

لمن صُمم؟

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

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

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

  • data/event_dictionary.csv
  • docs/mena-payment-tracking-guide.md
  • docs/mena_custom_dimensions.md
  • gtm/gtm-web-container-template.json
  • LICENSE
  • README.md
  • schema/ga4_mena_event_schema.json
  • schemas/ga4-event-taxonomy.json
  • SOURCES.md
  • sql/bigquery_ecommerce_unnester.sql
  • sql/customer_ltv_analysis.sql
  • tests/test_data_integrity.py

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

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

أمثلة أوامر البدء من README: python -m unittest discover -s tests

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

  • Required E-Commerce Parameter Consistency: Enforces official items array schemas with item_id, item_name, price, and item_category.
  • Currency Normalization: Multi-currency regional transactions (SAR, AED, EGP, USD) must be explicitly passed at event level to prevent conversion distortion.
  • BigQuery Partitioning: Daily event export partitions require integer transaction timestamps (event_timestamp) for performant querying.

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

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