> ## Documentation Index > Fetch the complete documentation index at: https://docs.scanova.io/llms.txt > Use this file to discover all available pages before exploring further. # الأسئلة الشائعة > إجابات عن أكثر الأسئلة تكرارًا حول تتبع التحويلات من Scanova: الإعداد، والنسبة، والأحداث، والخصوصية، والتقارير في لوحة التحكم. ## عام ### هل أحتاج إلى أحداث المتصفح وأحداث الخادم معًا؟ لا — يكفي أحدهما وحده. فأحداث المتصفح لا تتطلب أي إعداد على الخادم وهي أسرع طريق للبدء. أما أحداث الخادم فتحتاج إلى مفتاح 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`. ولتتبع التحويلات الحرجة (عمليات الشراء والتسجيل) استخدم [أحداث الخادم](/ar/conversion-tracking/server/send-events) التي لا يمكن حجبها. ### هل يؤثر SDK في أداء صفحتي؟ يُحمَّل SDK بشكل غير متزامن (بالخاصية `async`) ولا يعطّل عرض الصفحة. وحجم النص البرمجي نحو 10 كيلوبايت بعد التصغير والضغط. وتُرسل الأحداث في الخلفية بعد تحميل الصفحة. ### هل يمكنني استخدام SDK في صفحات متعددة؟ نعم — ثبّت النص البرمجي في قالب `` العام لموقعك فيعمل في كل صفحة. وتبقى `scan_session_id` بين الصفحات عبر `localStorage`، فتُنسب رحلة الزائر كاملة إلى المسح الأصلي. ### ماذا يحدث إن زار أحدهم الموقع دون مسح رمز QR؟ لا تُرسل أي أحداث. فـ SDK المتصفح يتحقق من وجود `scan_session_id` قبل إرسال أي حدث. وإن لم تكن موجودة (لأن الزائر وصل مباشرة لا عبر مسح)، يتخطى SDK الحدث كليًا. ولا يُحفظ شيء عن تلك الزيارة. ### كم تدوم نسبة المسح؟ 60 يومًا. فإن مسح زائر رمز QR ثم عاد إلى موقعك خلال 60 يومًا، تظل زياراته منسوبة إلى ذلك المسح. وبعد 60 يومًا تنتهي صلاحية المدخل `_scnv` في localStorage فتضيع النسبة. *** ## أحداث الخادم ### كيف أحصل على scan\_session\_id في خادمي؟ مرّرها من المتصفح إلى خادمك. والطرق الشائعة: * إدراجها في حقل نموذج مخفي * إرسالها في جسم الطلب عندما تستدعي واجهتك الأمامية واجهتك البرمجية * قراءتها من معامل الرابط عند تحميل الصفحة وحفظها في جلسة الزائر على خادمك راجع [إرسال أحداث الخادم](/ar/conversion-tracking/server/send-events#passing-scan_session_id-from-browser-to-server) للاطلاع على أمثلة برمجية. ### هل يمكنني إرسال الأحداث دفعات؟ نعم. استخدم `POST /server-events/batch` بما يصل إلى 100 حدث في الطلب الواحد. وهذا هو المستحسن للخوادم ذات الحجم الكبير وللبنى القائمة على الطوابير. ### ماذا يحدث إن أعدت إرسال طلب فاشل؟ إن أعدت إرسال `event_id` نفسه، يُوسم المكرر بذلك ويُستبعد من أعداد التحويلات. فاستخدم دائمًا `event_id` نفسه في كل إعادة إرسال. راجع [تكرار الطلبات والإرسال مرة أخرى](/ar/conversion-tracking/server/idempotency-retries). ### هل يمكنني إرسال أحداث بتواريخ سابقة؟ نعم — استخدم الحقل `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 ساعة إن لم تصل بيانات الجلسة أبدًا. أما إن وصلت في الوقت المناسب، فيُستكمل الحدث ويُحفظ للمدة المعتادة وهي سنتان.