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

دليل المستودع: حزمة قياس التردد والتخلي عن حقول النماذج

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

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

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

Develop a lightweight, privacy-safe form hesitation tracking library (form_telemetry.js): 1) Tracks time spent per field (focus to blur), correction count (backspaces), and last-interacted field upon abandonment, 2) Does not record keystroke text by design; field timing and correction-count events still require appropriate consent, minimization, and disclosure, 3) Pushes structured form_friction events to dataLayer, 4) Includes GTM container JSON and GA4 exploration guide.

لمن صُمم؟

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

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

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

  • docs/ga4-exploration-setup.md
  • examples/sample_form_events.json
  • gtm/form-telemetry-gtm-recipe.json
  • LICENSE
  • README.md
  • reports/hesitation_heatmap.html
  • src/aggregate_hesitation.py
  • src/form_telemetry.js
  • src/form_telemetry.min.js
  • src/hesitation_tracker.js
  • tests/telemetry.test.js
  • tests/test_hesitation.py

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

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

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

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

  • Performance Impact: Event listeners for focus, blur, and keystroke timing must use passive listeners and debounce routines to prevent input lag.
  • PII Data Isolation: Field value contents are never logged or transmitted; telemetry captures field names, character counts, and hesitation milliseconds only.
  • Bilingual Field Identification: Normalizes Arabic input labels (e.g. 'رقم الجوال') to standard telemetry keys (e.g. 'phone_input').

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

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