عام
هل أحتاج إلى أحداث المتصفح وأحداث الخادم معًا؟
لا — يكفي أحدهما وحده. فأحداث المتصفح لا تتطلب أي إعداد على الخادم وهي أسرع طريق للبدء. أما أحداث الخادم فتحتاج إلى مفتاح API وكود في الخادم لديك، لكنها أوثق (لا تتأثر بحاجبات الإعلانات) وتتيح لك الإبلاغ عن قيم الإيرادات والتحويلات التي تقع على الخادم. ومعظم الإعدادات تستخدم الاثنين: SDK المتصفح لبيانات التفاعل، وأحداث الخادم للتحويلات المؤكدة.هل يمكنني تتبع التحويلات من دون مسح رمز QR؟
لا. يحتاج SDK المتصفح إلىscan_session_id لإرسال أي حدث — فإن وصل زائر إلى موقعك دون مسح رمز QR، يلاحظ SDK غياب الجلسة فلا يرسل شيئًا. كما تشترط واجهة أحداث الخادم scan_session_id حقلًا إلزاميًا.
فتتبع التحويلات من Scanova مبني خصيصًا للقياس المنسوب إلى مسح رموز QR. وهو لا يصلح أداةَ تحليلات ويب للأغراض العامة.
SDK المتصفح
ما المتصفحات التي يدعمها SDK؟
يدعم SDK جميع المتصفحات الحديثة: Chrome وFirefox وSafari وEdge ونظائرها على الهواتف. ولا يحتاج إلى أي خصائص خاصة بالمتصفح سوىXMLHttpRequest أو fetch وlocalStorage.
هل يمكن لحاجبات الإعلانات أن تحجب SDK؟
نعم — قد تحجب حاجبات الإعلانات وإضافات المتصفح المهتمة بالخصوصية أحداث المتصفح المرسلة منt.scanova.io. ولتتبع التحويلات الحرجة (عمليات الشراء والتسجيل) استخدم أحداث الخادم التي لا يمكن حجبها.
هل يؤثر SDK في أداء صفحتي؟
يُحمَّل SDK بشكل غير متزامن (بالخاصيةasync) ولا يعطّل عرض الصفحة. وحجم النص البرمجي نحو 10 كيلوبايت بعد التصغير والضغط. وتُرسل الأحداث في الخلفية بعد تحميل الصفحة.
هل يمكنني استخدام SDK في صفحات متعددة؟
نعم — ثبّت النص البرمجي في قالب<head> العام لموقعك فيعمل في كل صفحة. وتبقى scan_session_id بين الصفحات عبر localStorage، فتُنسب رحلة الزائر كاملة إلى المسح الأصلي.
ماذا يحدث إن زار أحدهم الموقع دون مسح رمز QR؟
لا تُرسل أي أحداث. فـ SDK المتصفح يتحقق من وجودscan_session_id قبل إرسال أي حدث. وإن لم تكن موجودة (لأن الزائر وصل مباشرة لا عبر مسح)، يتخطى SDK الحدث كليًا. ولا يُحفظ شيء عن تلك الزيارة.
كم تدوم نسبة المسح؟
60 يومًا. فإن مسح زائر رمز QR ثم عاد إلى موقعك خلال 60 يومًا، تظل زياراته منسوبة إلى ذلك المسح. وبعد 60 يومًا تنتهي صلاحية المدخل_scnv في localStorage فتضيع النسبة.
أحداث الخادم
كيف أحصل على scan_session_id في خادمي؟
مرّرها من المتصفح إلى خادمك. والطرق الشائعة:- إدراجها في حقل نموذج مخفي
- إرسالها في جسم الطلب عندما تستدعي واجهتك الأمامية واجهتك البرمجية
- قراءتها من معامل الرابط عند تحميل الصفحة وحفظها في جلسة الزائر على خادمك
هل يمكنني إرسال الأحداث دفعات؟
نعم. استخدمPOST /server-events/batch بما يصل إلى 100 حدث في الطلب الواحد. وهذا هو المستحسن للخوادم ذات الحجم الكبير وللبنى القائمة على الطوابير.
ماذا يحدث إن أعدت إرسال طلب فاشل؟
إن أعدت إرسالevent_id نفسه، يُوسم المكرر بذلك ويُستبعد من أعداد التحويلات. فاستخدم دائمًا event_id نفسه في كل إعادة إرسال. راجع تكرار الطلبات والإرسال مرة أخرى.
هل يمكنني إرسال أحداث بتواريخ سابقة؟
نعم — استخدم الحقلevent_time لتحديد وقت وقوع الحدث. وهذا مفيد عند إرسال الأحداث بشكل غير متزامن من طابور. ويقبل الحقل صيغة ISO 8601 بتوقيت UTC.
الخصوصية والبيانات
هل أرسل عناوين البريد كما هي؟
لا. لا تضع أبدًا عناوين بريد صريحة فيmetadata أو properties. استخدم user_identifiers.email_hash ببصمة SHA-256 للعنوان بأحرف صغيرة.
ما الغرض من الحقل consent؟
ينقل الحقل consent إشارة موافقة الزائر وفق النظام العام لحماية البيانات إلى مراحل المعالجة:
granted— تُحفظ جميع الحقول كالمعتادdeniedأوpending— تُزال الحقول الشخصية (page_urlوreferrerوcityوmetadata) قبل الحفظ
consent نفسها فتُحفظ دائمًا كسجل للمراجعة.
كم مدة الاحتفاظ بالبيانات؟
يُحتفظ بالأحداث سنتين افتراضيًا. أما السجلات اليتيمة — وهي الأحداث التي يتعذر ربط جلسة المسح فيها — فتُحذف تلقائيًا بعد 24 ساعة.لوحة التحكم والتقارير
كم تستغرق الأحداث حتى تظهر في التقارير؟
عادةً من 10 إلى 30 ثانية في الأحوال المعتادة. وقد يحدث تأخير يصل إلى بضع دقائق في أوقات ذروة الزيارات.كيف أوقف التتبع مؤقتًا لموقع ما؟
افتح التحليلات ← تتبع التحويلات ← إعداد تتبع التحويلات، واختر إعداد التتبع في الموقع، ثم استخدم مفتاح Site Status في تبويب تضمين النص. وعند إيقاف الموقع مؤقتًا، تعيد أحداثه الرد400.
ما الحدث اليتيم ومتى يُحذف؟
الحدث اليتيم هو حدث تتوفر فيهscan_session_id لكن يتعذر ربطها بعد برمز QR — ويقع ذلك حين يصل الحدث قبل أن تربط مرحلة الهوية الجلسة بسجل رمز QR. وتُنظَّف الأحداث اليتيمة تلقائيًا بعد 24 ساعة إن لم تصل بيانات الجلسة أبدًا. أما إن وصلت في الوقت المناسب، فيُستكمل الحدث ويُحفظ للمدة المعتادة وهي سنتان.