بداية سريعة — انطلق في 5 خطوات

يغطي هذا الدليل أقل الخطوات اللازمة للانتقال من حساب في Scanova إلى تتبع أحداث يعمل فعلًا. وللإعدادات الأعمق، اتبع الروابط في كل خطوة.

الخطوة 1: أنشئ موقع تتبع

يمثل موقع التتبع نطاق موقع واحد. وتحتاج إلى واحد قبل أن تثبّت SDK أو ترسل أحداث خادم.

سجّل الدخول إلى لوحة تحكم Scanova
انتقل إلى التحليلات ← تتبع التحويلات
انقر على Create Site
أدخل اسمًا للموقع وأضف النطاقات المسموح بها (مثل yoursite.com)
احفظ

بعد الحفظ تنشئ Scanova قيمة site_id فريدة لهذا الموقع. وستستخدمها في النص البرمجي وفي كل استدعاءات الواجهة.

أضف كل أسماء المضيفين التي سيعمل عليها نص التتبع لديك — الصيغة التي تبدأ بـ www والصيغة التي بلا www، إضافة إلى أي نطاقات اختبار تريد التجربة عليها.

الخطوة 2: ثبّت SDK المتصفح

في التحليلات ← تتبع التحويلات ← إعداد تتبع التحويلات، اختر إعداد التتبع في الموقع الذي أنشأته للتو، وابقَ في تبويب تضمين النص
اضبط مفاتيح الالتقاط التلقائي (مشاهدات الصفحة، والنقرات، وإرسال النماذج) ووضع التصحيح
انسخ النص البرمجي الذي ظهر
الصقه قبل </head> في قالب HTML الخاص بموقعك

<head>
  <!-- other tags -->
  <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>

هل تستخدم Google Tag Manager؟ راجع التثبيت عبر GTM.

الخطوة 3: اربط رموز QR بموقع التتبع

كي تُنسب الأحداث إلى رمز QR بعينه، يجب أن يطابق نطاق وجهة ذلك الرمز أحد Allowed Domains في موقع التتبع لديك.

افتح رمز QR في لوحة تحكم Scanova
انتقل إلى إعداداته في Settings أو Redirect
تأكد أن رابط الوجهة يقع على نطاق أضفته في الخطوة 1 (مثل yoursite.com)

إذا كان رمز QR يوجّه إلى نطاق غير مدرج في Allowed Domains لموقع التتبع، فستُرفض أحداث المتصفح القادمة من ذلك النطاق بالرد 403. فالنسبة لا تعمل إلا عند تطابق نطاق الوجهة.

الخطوة 4: تحقق من أن SDK يعمل

افتح موقعك في متصفح
افتح أدوات المطور ثم تبويب Network
رشّح النتائج بـ /ct
أعد تحميل الصفحة — من المفترض أن ترى طلب POST إلى https://t.scanova.io/ct برد 200

إن رأيت الطلب فإن SDK يعمل. وإن لم تره، راجع حل مشكلات SDK المتصفح.

الخطوة 5: (اختياري) أرسل تحويلات من الخادم

لتأكيدات الشراء أو عمليات التسجيل أو غيرها من أحداث الخادم، أنشئ مفتاح API وأرسل الأحداث من خادمك.

افتح إعداد التتبع في الموقع نفسه، ثم تبويب تتبع عبر API
اختر Add New Key، وسمّ المفتاح، ثم انسخه واحفظه في مكان آمن
أرسل طلب POST إلى https://track.scanova.io/server-events:

curl -X POST "https://track.scanova.io/server-events" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "site_id": "YOUR_SITE_ID",
    "event_name": "purchase",
    "scan_session_id": "SCAN_SESSION_ID_FROM_BROWSER",
    "conversion_value": { "amount": 49.99, "currency": "USD" }
  }'

لا تكشف X-API-Key أبدًا في كود يعمل داخل المتصفح. فهو للاستخدام على الخادم فقط.

الدليل الكامل: إرسال أحداث الخادم

الخطوة 6: اطّلع على بياناتك

افتح التحليلات ← تتبع التحويلات في لوحة التحكم، واختر موقعك، ثم افتح تبويب Analytics. ومن المفترض أن ترى أول أحداثك خلال 30 إلى 60 ثانية من التحقق من SDK في الخطوة 3.

إلى أين بعد ذلك

إعدادات SDK المتصفح

تعرّف على كل خيارات SDK — مفاتيح التتبع التلقائي، ووضع التصحيح، وغيرها.

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

تتبّع إجراءات بعينها مثل النقر على الأزرار وإكمال النماذج.

أحداث الخادم

أرسل تحويلات الخادم بأمان مع بيانات النسبة.

دليل تطبيقات الصفحة الواحدة وأطر العمل

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

نظرة عامة

SDK المتصفح

جهة الخادم

مرجع الواجهة

الموارد

بداية سريعة — انطلق في 5 خطوات

الخطوة 1: أنشئ موقع تتبع

الخطوة 2: ثبّت SDK المتصفح

الخطوة 3: اربط رموز QR بموقع التتبع

الخطوة 4: تحقق من أن SDK يعمل

الخطوة 5: (اختياري) أرسل تحويلات من الخادم

الخطوة 6: اطّلع على بياناتك

إلى أين بعد ذلك

إعدادات SDK المتصفح

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

أحداث الخادم

دليل تطبيقات الصفحة الواحدة وأطر العمل

​الخطوة 1: أنشئ موقع تتبع

​الخطوة 2: ثبّت SDK المتصفح

​الخطوة 3: اربط رموز QR بموقع التتبع

​الخطوة 4: تحقق من أن SDK يعمل

​الخطوة 5: (اختياري) أرسل تحويلات من الخادم

​الخطوة 6: اطّلع على بياناتك

​إلى أين بعد ذلك

إعدادات SDK المتصفح

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

أحداث الخادم

دليل تطبيقات الصفحة الواحدة وأطر العمل

الخطوة 1: أنشئ موقع تتبع

الخطوة 2: ثبّت SDK المتصفح

الخطوة 3: اربط رموز QR بموقع التتبع

الخطوة 4: تحقق من أن SDK يعمل

الخطوة 5: (اختياري) أرسل تحويلات من الخادم

الخطوة 6: اطّلع على بياناتك

إلى أين بعد ذلك