> ## 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 المتصفح
> أضف نص تتبع Scanova إلى موقعك مباشرةً في HTML أو عبر Google Tag Manager. يعمل مع أي موقع أو نظام إدارة محتوى أو إطار عمل واجهة أمامية.
يتكوّن SDK من وسم `
```
## الخيار أ: التثبيت مباشرةً في HTML (موصى به)
الصق النص البرمجي داخل وسم `` في موقعك، **قبل إغلاق ``**:
```html theme={null}
Your Page
```
**أين تلصقه في المنصات الشائعة:**
| المنصة | أين تضيف النص البرمجي |
| ----------- | ----------------------------------------------------------------- |
| WordPress | Appearance ← Theme Editor ← `header.php`، قبل `` |
| Shopify | Online Store ← Themes ← Edit Code ← `theme.liquid`، قبل `` |
| Webflow | Project Settings ← Custom Code ← Head Code |
| Squarespace | Settings ← Advanced ← Code Injection ← Header |
| Wix | Settings ← Custom Code ← Add Code ← Head |
| HTML مخصص | مباشرةً داخل `` في قالب HTML الخاص بك |
## الخيار ب: Google Tag Manager
استخدم GTM إذا كنت تدير كل الوسوم من وحدة تحكم GTM ولا يمكنك تعديل HTML موقعك مباشرةً.
1. افتح حاوية GTM الخاصة بك
2. انقر على **Tags ← New**
3. اختر **Custom HTML** كنوع للوسم
4. الصق نص Scanova البرمجي كاملًا
5. اضبط المُشغّل على **All Pages**
6. سمِّ الوسم (مثلًا "Scanova Conversion Tracking") وانقر على **Save**
7. اضغط **Submit** ثم **Publish** لنشر الحاوية
لا تثبّت النص البرمجي مباشرةً في HTML وعبر GTM على الصفحة نفسها في آنٍ واحد. سيؤدي ذلك إلى تحميل SDK مرتين وإرسال أحداث مكرّرة.
**نصائح لـ GTM:**
* اجعل الوسم يُطلَق في أبكر وقت ممكن — استخدم المُشغّلين "DOM Ready" أو "Page View"، وليس "Window Loaded"
* إذا كان موقعك تطبيق صفحة واحدة (SPA)، فاقرأ [دليل SPA وأطر العمل](/ar/conversion-tracking/browser/spa-frameworks) قبل ضبط مُشغّلات GTM
## الخطوة 2: تحقّق من التثبيت
بعد نشر النص البرمجي:
1. افتح موقعك في متصفح
2. افتح DevTools، علامة التبويب **Network**
3. رشّح باستخدام `/ct`
4. أعد تحميل الصفحة
من المفترض أن ترى طلب `POST` إلى `https://t.scanova.io/ct` يُعيد الحالة `200`.
للاطلاع على قائمة تحقق كاملة، راجع [التحقق وتصحيح الأخطاء](/ar/conversion-tracking/browser/verify).
## الخطوات التالية
كل خيارات init وما الذي يتحكم فيه كل مفتاح.
تتبّع إجراءات محددة للمستخدم من شيفرة JavaScript لديك.
الإعداد الخاص بـ React وNext.js وVue.
التأكد من استقبال الأحداث بشكل صحيح.