ملف العمل الأصلي
START-HERE.txt
تحتفظ الشيفرة وصفحات الأمثلة القابلة للتشغيل بمعرّفاتها ونصوصها التجريبية الأصلية. يشرحها الدرس وإرشادات الملفات بلغتك.
المسار العملي
اختر إجراء زائر مفيدًا، واربط مسار بيانات تحليلات تجريبيًا بمساعدة المساعد، وتحقق مما يُجمع فعلًا.
دورك: حدّد معنى الحدث، وتحكّم في اختيار التتبع التجريبي، وتحقق من الملاحظات لدى المزود.
1. استخدم المشروع المرفق واطلب من مساعد البرمجة تنفيذ الجانب التقني. لا تحتاج إلى كتابة HTML أو JavaScript أو SQL بنفسك.
2. اتبع خطوات الدرس الحالي، واضبط فقط حساباتك التي يحق لك استخدامها، وافحص النتيجة في الصفحة الفعلية أو لدى مزود الخدمة.
3. افصل بين النتائج المتوقعة وما لاحظته بالفعل. إن تعذّر إجراء اختبار فعلي، سجّل الخطوة المحددة التي توقفت عندها.
تفاصيل الإعداد أدناه متاحة لك ولمساعدك. شروح الكود وتمارين التنفيذ الإضافية اختيارية؛ وتبقى اختبارات الوصول والخصوصية المهمة جزءًا من المسار العملي.
--- الإعداد المطلوب (قراءة الكود اختيارية) ---
أنشئ موقع GA4 وتدفق بيانات ويب في حسابك. ضع معرّف القياس G-... في config.js؛ إنه إعداد عام وليس سر API. عطّل Enhanced Measurement لتدفق التدريب المخصص هذا لتجنب تفاعلات تلقائية إضافية. قدّم public/ عبر HTTP. لا يُحمّل أي مزوّد تحليلات حتى النقر على Allow analytics. استخدم مسارات اختبار مصطنعة فقط. افحص DebugView/Realtime في حسابك؛ مدخلات dataLayer المحلية وحدها لا تثبت استلام البيانات. أزل debug_mode بعد الاختبار. للنشر العام، نفّذ إشعارًا مناسبًا وسحب الموافقة وحفظ التفضيلات لجمهورك.
لا تفتح index.html باستخدام file://: استيرادات الوحدات تحتاج HTTP. من جذر الورشة، شغّل python3 -m http.server 8000 --directory public، ثم افتح http://localhost:8000. يكفي هذا الخادم الثابت هنا لأن جمع التحليلات خارجي، بخلاف الدروس التي فيها دوال خادم خاصة بك.