# دليل تفعيل ودمج شبكات الإعلانات في موقع Dark Cyber X — Router Chef 📢

هذا الدليل يوضح للمالك كيفية ربط الموقع الإستاتيكي مع شبكات الإعلانات العالمية مثل:
- **Adsterra**
- **PropellerAds**
- **Monetag**

---

## ⚡ الخطوات العملية لتفعيل الإعلانات (7 خطوات سريعة)

### 1. إنشاء حساب في الشبكة الإعلانية
- سجّل حساب ناشر (Publisher) في الشبكة المختارة:
  - Adsterra: [publishers.adsterra.com](https://publishers.adsterra.com/)
  - PropellerAds: [publishers.propellerads.com](https://publishers.propellerads.com/)
  - Monetag: [monetag.com](https://monetag.com/)

### 2. إضافة الموقع بالدومين النهائي (Domain Verification)
- أضف موقعك بالدومين النهائي.
- 💡 **تنبيه جوهري لقبول الموقع بسرعة**: كثير من شبكات الإعلانات ترفض أو تؤخر قبول النطاقات الفرعية المجانية مثل `*.github.io` أو `*.pages.dev`. يُنصح بشدة بربط **دومين مخصص** (مثل `darkcyberx.app` أو `routerchef.darkcyberx.com`) قبل تقديم الموقع للمراجعة.

### 3. انتظار الموافقة والتحقق
- يستغرق الفحص عادة من بضع دقائق إلى 24 ساعة.
- تأكد أن جميع صفحات الموقع (الرئيسية، سياسة الخصوصية، شروط الاستخدام، من نحن، اتصل بنا) تعمل بنجاح بدون روابط معطلة.

### 4. إنشاء واستخراج أكواد الـ Banner
- من لوحة تحكم الشبكة، اضغط **Add Zone / Create Ad Unit**:
  - اختر نوع **Banner (728x90)** أو **Responsive Banner** للبانر العلوي.
  - أو اختر **Native Banner / 300x250** للبانر السفلي وأسفل المقالات.
- تجنب تفعيل وحدات Popunder أو Social Bar المزعجة على صفحة التحميل لضمان تجربة مستخدم موثوقة ونظيفة.

### 5. إعداد ملف التكوين المحلي `ad-config.js`
1. في المجلد `website/ads/`:
2. انسخ الملف `ad-config.example.js` وسمِّ النسخة الجديدة: `ad-config.js`.
3. افتح `ad-config.js` وعدّل التالي:
   ```javascript
   window.DARKCYBERX_AD_CONFIG = {
       enabled: true, // تغييرها إلى true
       network: "adsterra", // اسم الشبكة: adsterra أو propeller أو monetag

       bannerTopHtml: `
           <!-- الصق كود البانر العلوي هنا -->
       `,

       bannerBottomHtml: `
           <!-- الصق كود البانر السفلي هنا -->
       `,

       nativeOptionalHtml: `
           <!-- الصق كود الإعلان الإضافي المدمج هنا (اختياري) -->
       `
   };
   ```
*(ملاحظة: ملف `ad-config.js` مدرج تلقائياً في `.gitignore` لمنع نشر أكوادك أو معرفاتك الخاصة على GitHub).*

### 6. رفع ونشر الموقع
- ارفع التحديث إلى Cloudflare Pages أو GitHub Pages.
- سيقوم محرك `ads-loader.js` بقراءة الإعدادات وحقن الإعلانات تلقائياً في مساحات الـ `<div id="ad-banner-top">` و `<div id="ad-banner-bottom">`.

### 7. خط أحمر ملزم (أمان التطبيق)
- **ممنوع قطعياً**: حقن أو تشغيل أي أكواد إعلانية من هذه الشبكات داخل تطبيق ويندوز المكتبي (Desktop App) أو داخل لوحة إدارة الراوتر.
- الربط من التطبيق يتم **فقط** عبر فتح رابط الموقع الخارجي في متصفح النظام الافتراضي (Google Chrome / Edge) دون إزعاج المستخدم داخل اللوحة.

---

## 🛠️ استكشاف الأخطاء
- **إذا ظهرت رسالة Placeholder مؤقتة**: تأكد من أن `ad-config.js` موجود وقيمة `enabled: true`.
- **إذا لم تظهر الإعلانات بعد التفعيل**: تأكد من تعطيل مانع الإعلانات (AdBlocker) في متصفحك للتجربة، وتأكد من اكتمال مراجعة النطاق في لوحة تحكم الشبكة.