> ## 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.
# بداية سريعة — انطلق في 5 خطوات
> أسرع طريق إلى تتبع تحويلات يعمل فعلًا: أنشئ موقع تتبع، وثبّت النص البرمجي، وتحقق من الأحداث، وابدأ القياس في أقل من 10 دقائق.
يغطي هذا الدليل أقل الخطوات اللازمة للانتقال من حساب في Scanova إلى تتبع أحداث يعمل فعلًا. وللإعدادات الأعمق، اتبع الروابط في كل خطوة.
## الخطوة 1: أنشئ موقع تتبع
يمثل **موقع التتبع** نطاق موقع واحد. وتحتاج إلى واحد قبل أن تثبّت SDK أو ترسل أحداث خادم.
1. سجّل الدخول إلى لوحة تحكم Scanova
2. انتقل إلى **التحليلات ← تتبع التحويلات**
3. انقر على **Create Site**
4. أدخل اسمًا للموقع وأضف **النطاقات المسموح بها** (مثل `yoursite.com`)
5. احفظ
بعد الحفظ تنشئ Scanova قيمة **`site_id`** فريدة لهذا الموقع. وستستخدمها في النص البرمجي وفي كل استدعاءات الواجهة.
أضف كل أسماء المضيفين التي سيعمل عليها نص التتبع لديك — الصيغة التي تبدأ بـ `www` والصيغة التي بلا `www`، إضافة إلى أي نطاقات اختبار تريد التجربة عليها.
## الخطوة 2: ثبّت SDK المتصفح
1. في **التحليلات ← تتبع التحويلات ← إعداد تتبع التحويلات**، اختر **إعداد التتبع** في الموقع الذي أنشأته للتو، وابقَ في تبويب **تضمين النص**
2. اضبط مفاتيح الالتقاط التلقائي (مشاهدات الصفحة، والنقرات، وإرسال النماذج) ووضع التصحيح
3. انسخ النص البرمجي الذي ظهر
4. الصقه قبل `` في قالب HTML الخاص بموقعك
```html theme={null}
```
هل تستخدم Google Tag Manager؟ راجع [التثبيت عبر GTM](/ar/conversion-tracking/browser/install#option-b-google-tag-manager).
## الخطوة 3: اربط رموز QR بموقع التتبع
كي تُنسب الأحداث إلى رمز QR بعينه، يجب أن يطابق نطاق وجهة ذلك الرمز أحد **Allowed Domains** في موقع التتبع لديك.
1. افتح رمز QR في لوحة تحكم Scanova
2. انتقل إلى إعداداته في **Settings** أو **Redirect**
3. تأكد أن رابط الوجهة يقع على نطاق أضفته في الخطوة 1 (مثل `yoursite.com`)
إذا كان رمز QR يوجّه إلى نطاق **غير** مدرج في Allowed Domains لموقع التتبع، فستُرفض أحداث المتصفح القادمة من ذلك النطاق بالرد `403`. فالنسبة لا تعمل إلا عند تطابق نطاق الوجهة.
## الخطوة 4: تحقق من أن SDK يعمل
1. افتح موقعك في متصفح
2. افتح أدوات المطور ثم تبويب **Network**
3. رشّح النتائج بـ `/ct`
4. أعد تحميل الصفحة — من المفترض أن ترى طلب `POST` إلى `https://t.scanova.io/ct` برد `200`
إن رأيت الطلب فإن SDK يعمل. وإن لم تره، راجع [حل مشكلات SDK المتصفح](/ar/conversion-tracking/troubleshooting#browser-sdk-issues).
## الخطوة 5: (اختياري) أرسل تحويلات من الخادم
لتأكيدات الشراء أو عمليات التسجيل أو غيرها من أحداث الخادم، أنشئ مفتاح API وأرسل الأحداث من خادمك.
1. افتح **إعداد التتبع** في الموقع نفسه، ثم تبويب **تتبع عبر API**
2. اختر **Add New Key**، وسمّ المفتاح، ثم انسخه واحفظه في مكان آمن
3. أرسل طلب `POST` إلى `https://track.scanova.io/server-events`:
```bash theme={null}
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` أبدًا في كود يعمل داخل المتصفح. فهو للاستخدام على الخادم فقط.
الدليل الكامل: [إرسال أحداث الخادم](/ar/conversion-tracking/server/send-events)
## الخطوة 6: اطّلع على بياناتك
افتح **التحليلات ← تتبع التحويلات** في لوحة التحكم، واختر موقعك، ثم افتح تبويب **Analytics**. ومن المفترض أن ترى أول أحداثك خلال 30 إلى 60 ثانية من التحقق من SDK في الخطوة 3.
***
## إلى أين بعد ذلك
تعرّف على كل خيارات SDK — مفاتيح التتبع التلقائي، ووضع التصحيح، وغيرها.
تتبّع إجراءات بعينها مثل النقر على الأزرار وإكمال النماذج.
أرسل تحويلات الخادم بأمان مع بيانات النسبة.
خطوات الإعداد الخاصة بـ React وNext.js وVue.