نظرة عامة على SDK المتصفح

SDK المتصفح من Scanova هو نص JavaScript خفيف (‏~10 كيلوبايت) تضيفه إلى موقعك مرة واحدة. بعد ذلك يتتبّع تلقائيًا مشاهدات الصفحة، والنقرات على الروابط، وعمق التمرير، وإرسال النماذج — وكلها منسوبة إلى مسح رمز QR الذي جاء بالزائر إلى موقعك.

ما الذي يفعله SDK

عندما يصل زائر إلى موقعك عبر مسح رمز QR، يحتوي الرابط على المعامل scnv:

https://yoursite.com/?scnv=7ad26d4f-3181-4ef8-b6ca-b8f59499dd43

يقوم SDK بما يلي:

يقرأ المعامل scnv ويحفظه في localStorage (صلاحية 60 يومًا)
يتتبّع الأحداث المدمجة تلقائيًا (مشاهدات الصفحة، والنقرات، والتمرير، والنماذج) بحسب إعداداتك
يُرفق بيانات النسبة — يحمل كل حدث scan_session_id، ما يربطه برمز QR الأصلي
يستمر عبر الصفحات — إذا انتقل الزائر إلى صفحة أخرى في موقعك، تنتقل النسبة معه

الأحداث المتتبَّعة تلقائيًا

تُفعَّل هذه الأحداث بمفتاح واحد ضمن خيارات init:

الخيار	ما الذي يتتبّعه	نوع الحدث المُرسَل
`autoPageview`	كل تحميل للصفحة	`pageview`
`autoClicks`	النقرات على الروابط والأزرار وعناصر `[role="button"]`	`click`
`autoForms`	إرسال النماذج	`form_submit`
`autoScroll`	عمق التمرير عند 25% و50% و75% و90%	`scroll`

التفاصيل الكاملة: الأحداث التلقائية

الأحداث المخصصة

إلى جانب التتبع التلقائي، يمكنك إرسال أي حدث من شيفرة JavaScript لديك:

scanova('track', 'cta_click', { button: 'Start Free Trial' });

التفاصيل الكاملة: الأحداث المخصصة

المتطلبات

موقع إلكتروني يمكنك فيه تعديل قسم <head> أو إضافة وسم عبر Google Tag Manager
موقع تتبع مُنشأ في التحليلات ← تتبع التحويلات، مع إضافة نطاقك ضمن Allowed Domains
قيمة site_id من لوحة التحكم

قبل التثبيت

تأكّد مما يلي:

أن موقع التتبع الخاص بك مُنشأ في لوحة التحكم
أن نطاق موقعك مُدرج ضمن Allowed Domains لذلك الموقع
أنك تعرف أين تضيف وسم <script> (قالب HTML، أو قسم الترويسة في نظام إدارة المحتوى، أو GTM)
أن رموز QR مرتبطة بموقع التتبع هذا في لوحة تحكم Scanova

الخطوات التالية

تثبيت SDK

إضافة النص البرمجي مباشرةً أو عبر Google Tag Manager.

إعداد SDK

كل خيارات init مع القيم الافتراضية وأمثلة عليها.

الأحداث التلقائية

البيانات التي تلتقطها كل خاصية من خصائص التتبع التلقائي.

الأحداث المخصصة

تتبّع إجراءات محددة من شيفرة JavaScript لديك.