الرحلة من المسح إلى التقرير
إليك ما يحدث منذ لحظة مسح الزائر لرمز QR وحتى ظهور ذلك الحدث في تقاريرك.جلسة المسح
معامل الاستعلامscnv هو مفتاح النسبة. وهو يحمل معرّف جلسة المسح — وهو معرّف UUID يدل على مسح واحد بعينه لرمز QR بعينه من شخص بعينه في لحظة بعينها.
- يقرأ قيمة
scnvمن الرابط - يحفظها في
localStorageبصلاحية 60 يومًا - يُرفقها باسم
scan_session_idمع كل حدث يرسله ذلك المتصفح
النسبة عبر الصفحات والجلسات
يبقى معرّف جلسة المسح قائمًا عند التنقل بين صفحات النطاق نفسه. فإذا كان الزائر:- يمسح رمز QR ← فيصل إلى
/landing - ثم ينتقل إلى
/pricing - ثم يسجّل في
/signup
أحداث المتصفح وأحداث الخادم
هناك نوعان من الأحداث:
يقبل النوعان قيمة
scan_session_id التي تربطهما بمسح رمز QR. وفي أحداث الخادم، يحتاج خادمك إلى استلام scan_session_id من المتصفح — عادةً عبر حقل في نموذج، أو كعكة جلسة، أو استدعاء للواجهة.
كيف تُعالَج الأحداث
ما إن تستقبل واجهة التتبع حدثًا حتى يمر بسلسلة من مراحل المعالجة:- التحقق — فحص الحقول المطلوبة وحجم المحتوى وصلاحية الموقع والنطاق
- منع التكرار — وسم قيم
event_idالمتكررة بأنها مكررة (وتبقى محفوظة ولا تُحذف) - إثراء بيانات الجهاز — تحليل user-agent لاستخراج نوع الجهاز والمتصفح ونظام التشغيل
- إثراء بيانات الموقع الجغرافي — تحويل عنوان IP إلى دولة ومدينة عبر GeoIP
- ربط الهوية — تحويل
scan_session_idإلى معرّف رمز QR ومعرّف المستخدم من قاعدة بيانات Scanova - كشف الاحتيال — تقييم استدلالي لرصد السلوك الشبيه بسلوك الروبوتات
- الخصوصية / النظام العام لحماية البيانات — إزالة الحقول الشخصية إذا كانت
consentبقيمةdeniedأوpending
الهوية والجلسات
يحمل كل حدث يرسله SDK ثلاث قيم هوية منفصلة. وفهم الفرق بينها يعينك على قراءة التقارير:
قد تكون لزائر واحد جلسات ويب كثيرة، وللجلسة الواحدة أحداث كثيرة. وكل الأحداث خلال 60 يومًا من المسح تتشارك القيمة
scan_session_id نفسها.
توفر البيانات
- تُستقبل الأحداث وتوضع في الطابور فور وصولها
- في الأحوال المعتادة تظهر الأحداث المعالجة في التقارير خلال ثوانٍ
- وقد يحدث تأخير قصير يصل إلى بضع دقائق في أوقات ذروة الزيارات