محمود عبدالنبي
التقارير والتحليلات · قالب وإطار عمل · 1

دليل المستودع: حزمة تتبع بوابات الدفع المصرية (فوري وإنستاباي) عبر GTM

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

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

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

Create a specialized tracking toolkit for Egyptian payment gateways (Fawry, Instapay, Paymob, Vodafone Cash): 1) Data Layer specification distinguishing 'payment_initiated' vs 'payment_confirmed', 2) Ready-to-import GTM container JSON with custom variables and triggers, 3) Python reconciliation script (reconcile_payments.py) matching bank transaction logs to order numbers, 4) Implementation guide for WooCommerce and custom checkouts.

لمن صُمم؟

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

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

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

  • data-layer/dataLayer-spec-fawry-instapay.js
  • docs/egyptian-payment-tracking-guide.md
  • docs/implementation-guide-woocommerce.md
  • gtm/gtm-egypt-payments-container.json
  • LICENSE
  • README.md
  • scripts/dataLayer_payment_listener.js
  • src/reconcile_payments.py
  • src/validate_datalayer.py
  • templates/fawry-instapay-gtm-container.json
  • tests/test_reconciler.py
  • tests/test_reconciliation.py

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

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

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

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

  • Asynchronous Payment Handshake: Cash-at-kiosk (Fawry) and Instapay transfers do not finalize immediately; requires server-side webhook listener to confirm purchase events.
  • Iframe Checkout Sandboxing: Hosted payment redirect pages require postMessage listener bridges to trigger GTM dataLayer events on parent merchant window.
  • EGP Currency & Decimal Precision: Ensures Fawry fee surcharges and decimal places are calculated accurately in e-commerce purchase payloads.

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

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