تثبيت SDK المتصفح

يتكوّن SDK من وسم <script> واحد فقط. تثبّته مرة واحدة داخل <head> موقعك، ويُحمَّل بشكل غير متزامن دون أي أثر على أداء الصفحة.

الخطوة 1: انسخ النص البرمجي من لوحة التحكم

في لوحة تحكم Scanova، افتح التحليلات ← تتبع التحويلات
اختر إعداد تتبع التحويلات
اختر إعداد التتبع لموقعك، في علامة التبويب تضمين النص
فعّل مفاتيح التتبع التلقائي التي تريدها
انسخ النص البرمجي المُولَّد

سيبدو النص البرمجي على هذا النحو، مع site_id الخاص بك مُدرجًا مسبقًا:

<script>
(function(w,d,s,o,f,js,fjs){
  w['ScanovaTrackingObject']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
  js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
  js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
})(window,document,'script','scanova','https://cdn.scanova.io/ct/js/qcg.min.js');

scanova('init', 'YOUR_SITE_ID', {
  autoPageview: true,
  autoClicks: true,
  autoForms: true,
  autoScroll: true
});
</script>

الخيار أ: التثبيت مباشرةً في HTML (موصى به)

الصق النص البرمجي داخل وسم <head> في موقعك، قبل إغلاق </head>:

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>Your Page</title>

  <!-- Scanova Conversion Tracking -->
  <script>
  (function(w,d,s,o,f,js,fjs){
    w['ScanovaTrackingObject']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','scanova','https://cdn.scanova.io/ct/js/qcg.min.js');

  scanova('init', 'YOUR_SITE_ID', {
    autoPageview: true,
    autoClicks: true,
    autoForms: true,
    autoScroll: true
  });
  </script>
</head>
<body>
  <!-- your content -->
</body>
</html>

أين تلصقه في المنصات الشائعة:

المنصة	أين تضيف النص البرمجي
WordPress	Appearance ← Theme Editor ← `header.php`، قبل `</head>`
Shopify	Online Store ← Themes ← Edit Code ← `theme.liquid`، قبل `</head>`
Webflow	Project Settings ← Custom Code ← Head Code
Squarespace	Settings ← Advanced ← Code Injection ← Header
Wix	Settings ← Custom Code ← Add Code ← Head
HTML مخصص	مباشرةً داخل `<head>` في قالب HTML الخاص بك

الخيار ب: Google Tag Manager

استخدم GTM إذا كنت تدير كل الوسوم من وحدة تحكم GTM ولا يمكنك تعديل HTML موقعك مباشرةً.

افتح حاوية GTM الخاصة بك
انقر على Tags ← New
اختر Custom HTML كنوع للوسم
الصق نص Scanova البرمجي كاملًا
اضبط المُشغّل على All Pages
سمِّ الوسم (مثلًا “Scanova Conversion Tracking”) وانقر على Save
اضغط Submit ثم Publish لنشر الحاوية

لا تثبّت النص البرمجي مباشرةً في HTML وعبر GTM على الصفحة نفسها في آنٍ واحد. سيؤدي ذلك إلى تحميل SDK مرتين وإرسال أحداث مكرّرة.

نصائح لـ GTM:

اجعل الوسم يُطلَق في أبكر وقت ممكن — استخدم المُشغّلين “DOM Ready” أو “Page View”، وليس “Window Loaded”
إذا كان موقعك تطبيق صفحة واحدة (SPA)، فاقرأ دليل SPA وأطر العمل قبل ضبط مُشغّلات GTM

الخطوة 2: تحقّق من التثبيت

بعد نشر النص البرمجي:

افتح موقعك في متصفح
افتح DevTools، علامة التبويب Network
رشّح باستخدام /ct
أعد تحميل الصفحة

من المفترض أن ترى طلب POST إلى https://t.scanova.io/ct يُعيد الحالة 200. للاطلاع على قائمة تحقق كاملة، راجع التحقق وتصحيح الأخطاء.

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

إعداد SDK

كل خيارات init وما الذي يتحكم فيه كل مفتاح.

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

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

أطر عمل SPA

الإعداد الخاص بـ React وNext.js وVue.

التحقق وتصحيح الأخطاء

التأكد من استقبال الأحداث بشكل صحيح.

نظرة عامة

SDK المتصفح

جهة الخادم

مرجع الواجهة

الموارد

الخطوة 1: انسخ النص البرمجي من لوحة التحكم

الخيار أ: التثبيت مباشرةً في HTML (موصى به)

الخيار ب: Google Tag Manager

الخطوة 2: تحقّق من التثبيت

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

إعداد SDK

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

أطر عمل SPA

التحقق وتصحيح الأخطاء

​الخطوة 1: انسخ النص البرمجي من لوحة التحكم

​الخيار أ: التثبيت مباشرةً في HTML (موصى به)

​الخيار ب: Google Tag Manager

​الخطوة 2: تحقّق من التثبيت

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

إعداد SDK

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

أطر عمل SPA

التحقق وتصحيح الأخطاء

الخطوة 1: انسخ النص البرمجي من لوحة التحكم

الخيار أ: التثبيت مباشرةً في HTML (موصى به)

الخيار ب: Google Tag Manager

الخطوة 2: تحقّق من التثبيت

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