> ## 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.

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

> تتبّع سلوك المستخدمين على موقعك بعد مسح رمز QR باستخدام SDK المتصفح: مشاهدات الصفحة، والنقرات، وعمق التمرير، وإرسال النماذج، والأحداث المخصصة.

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

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

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

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

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

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

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

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

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

التفاصيل الكاملة: [الأحداث التلقائية](/ar/conversion-tracking/browser/auto-tracking)

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

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

```javascript theme={null}
scanova('track', 'cta_click', { button: 'Start Free Trial' });
```

التفاصيل الكاملة: [الأحداث المخصصة](/ar/conversion-tracking/browser/custom-events)

## المتطلبات

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

## قبل التثبيت

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

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

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

<CardGroup cols={2}>
  <Card title="تثبيت SDK" icon="download" href="/ar/conversion-tracking/browser/install">
    إضافة النص البرمجي مباشرةً أو عبر Google Tag Manager.
  </Card>

  <Card title="إعداد SDK" icon="sliders" href="/ar/conversion-tracking/browser/sdk-configuration">
    كل خيارات init مع القيم الافتراضية وأمثلة عليها.
  </Card>

  <Card title="الأحداث التلقائية" icon="bolt" href="/ar/conversion-tracking/browser/auto-tracking">
    البيانات التي تلتقطها كل خاصية من خصائص التتبع التلقائي.
  </Card>

  <Card title="الأحداث المخصصة" icon="sparkles" href="/ar/conversion-tracking/browser/custom-events">
    تتبّع إجراءات محددة من شيفرة JavaScript لديك.
  </Card>
</CardGroup>
