التحقق من SDK المتصفح وتصحيح أخطائه

​

قائمة التحقق

​

1. تحقّق من طلب الشبكة

1. افتح موقعك في Chrome أو Firefox
2. افتح DevTools (‏F12 أو زر الفأرة الأيمن ← فحص)
3. انتقل إلى علامة التبويب Network
4. رشّح باستخدام /ct
5. أعد تحميل الصفحة تحميلًا قسريًا (‏Ctrl+Shift+R / Cmd+Shift+R)

​

2. افحص حمولة الطلب

• أن site_id يطابق معرّف موقع التتبع لديك في لوحة التحكم
• أن event_type هو pageview (إذا كان autoPageview: true)
• أن scan_session_id موجود (إذا زرت الصفحة بمعامل ?scnv=)

{
  "event_id": "f9ac7db6-f900-4d8e-8918-c846834195a8",
  "site_id": "YOUR_SITE_ID",
  "event_type": "pageview",
  "scan_session_id": "7ad26d4f-3181-4ef8-b6ca-b8f59499dd43",
  "page_url": "https://yoursite.com/?scnv=7ad26d4f-3181-4ef8-b6ca-b8f59499dd43",
  "timestamp": "2026-05-13T10:00:00.000Z"
}

​

3. اختبر النسبة إلى رمز QR

https://yoursite.com/?scnv=00000000-0000-0000-0000-000000000001

​

4. فعّل وضع التصحيح مؤقتًا

scanova('init', 'YOUR_SITE_ID', { debug: true, autoPageview: true });

[QCG SDK] Initialized with Site ID: YOUR_SITE_ID
[QCG SDK] Loaded version 1.x.x

​

الأخطاء الشائعة وحلولها

​

لا يظهر أي طلب /ct

​

400 — طلب غير صالح

• أنك تستخدم site_id الخاص بموقع التتبع الصحيح في لوحة التحكم
• أن الموقع نشط (راجع حالته في لوحة التحكم)

​

403 — النطاق غير مسموح به

1. انتقل إلى التحليلات ← تتبع التحويلات
2. اختر موقعك ← انقر على Edit
3. أضف اسم المضيف بدقة (مثل yoursite.com وwww.yoursite.com وstaging.yoursite.com)
4. احفظ

​

422 — خطأ في التحقق

• event_type مفقود أو فارغ
• تجاوز أحد الحقول الطول المسموح به
• احتواء metadata على عنوان بريد إلكتروني صريح — استخدم user_identifiers بقيمة مجزّأة بدلًا من ذلك
• تجاوز metadata حجم 10 كيلوبايت

​

429 — تجاوز حد المعدل

​

تظهر الأحداث في الشبكة لكن لا تظهر في لوحة التحكم

• انتظر حتى 60 ثانية — هناك تأخير معالجة قصير
• تأكّد من أنك تنظر إلى موقع التتبع الصحيح في لوحة التحكم
• تحقّق من أن site_id في حمولة الحدث يطابق الموقع في لوحة التحكم

​

لا يظهر أي طلب /ct في زيارة معيّنة

​

إطلاق حدثين لكل تحميل للصفحة