دليل تحسين محركات البحث والبيانات الوصفية¶

يقدم هذا الدليل أفضل الممارسات لتحسين صفحات التوثيق لمحركات البحث ومشاركة وسائل التواصل الاجتماعي.

الأوصاف الوصفية¶

أضف حقل description في العناصر الأمامية YAML لكل صفحة توثيق:

---
title: إدارة دورة حياة المطالبات
description: دليل شامل لدورة حياة المطالبات الصحية، من التقديم إلى الدفع، بما في ذلك تكامل نفيس ومعالجة الرفض.
---

أفضل الممارسات¶

1. الطول: حافظ على الأوصاف بين 150-160 حرفاً
2. الكلمات الرئيسية: أدرج الكلمات الرئيسية المهمة بشكل طبيعي
3. قابل للتنفيذ: ركز على ما سيتعلمه المستخدمون أو ينجزونه
4. فريد: يجب أن يكون لكل صفحة وصف فريد
5. لا تكرار: تجنب نسخ العنوان أو الفقرة الأولى

أمثلة¶

✅ أوصاف وصفية جيدة¶

# صفحة المطالبات الصحية
description: تعلم دورة حياة المطالبات الكاملة في الرعاية الصحية السعودية، من التحقق من الأهلية عبر تقديم نفيس إلى معالجة الدفع وإدارة الرفض.

# صفحة تكامل نفيس
description: دليل خطوة بخطوة للتكامل مع المنصة الوطنية لتبادل المعلومات الصحية في المملكة العربية السعودية (نفيس) باستخدام معايير FHIR R4.

# صفحة وكيل ClaimLinc
description: اكتشف كيف يقوم وكيل ClaimLinc الذكي بأتمتة التحقق من المطالبات وتحليل الرفض وسير عمل إعادة التقديم لتقليل وقت المعالجة بنسبة 60٪.

❌ أوصاف وصفية سيئة¶

# قصير جداً
description: معلومات المطالبات

# طويل جداً (أكثر من 160 حرفاً)
description: توفر هذه الصفحة معلومات شاملة حول نظام إدارة دورة حياة المطالبات بما في ذلك التقديم والتحقق وتكامل نفيس ومعالجة الرفض وعملية الاستئناف وسير عمل تتبع الدفع.

# حشو الكلمات الرئيسية
description: مطالبات، مطالبات صحية، تقديم مطالبات، معالجة مطالبات، مطالبات نفيس، مطالبات سعودية

Open Graph وTwitter Cards¶

يستخدم Material for MkDocs تلقائياً تكوين Open Graph على مستوى الموقع من mkdocs.yml. للتجاوزات الخاصة بالصفحة، أضف إلى العناصر الأمامية:

---
title: دليل تكامل نفيس
description: دليل كامل لتكامل نفيس مع برينسايت
social:
  cards: true
  cards_layout_options:
    title: تكامل نفيس
    description: ادمج نظامك الصحي مع المنصة الصحية الوطنية السعودية
    image: assets/images/nphies-preview.png
---

صور المعاينة الاجتماعية¶

أنشئ صور معاينة للصفحات المهمة:

1. الأبعاد: 1200x630 بكسل (معيار Twitter/OG)
2. التنسيق: PNG أو JPG
3. حجم الملف: أقل من 1 ميجابايت
4. المحتوى: أدرج عنوان الصفحة والمرئيات الرئيسية وعلامة برينسايت التجارية

عناوين الصفحات¶

اتبع هذه الاتفاقيات لعناوين الصفحات:

# التنسيق: الموضوع المحدد | الفئة | برينسايت
title: دورة حياة المطالبات | الرعاية الصحية | برينسايت

# لصفحات الفئات الرئيسية
title: مجال الرعاية الصحية | نظام معرفة برينسايت

# للأدلة التفصيلية
title: دليل تكامل FHIR R4 مع نفيس | التوثيق التقني

البيانات المنظمة¶

لنتائج بحث محسنة، ضع في اعتبارك إضافة بيانات منظمة للصفحات الرئيسية:

<!-- في محتوى الصفحة أو تجاوز القالب المخصص -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "دليل تكامل نفيس",
  "author": {
    "@type": "Organization",
    "name": "برينسايت"
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-03-20",
  "description": "دليل كامل للتكامل مع منصة نفيس السعودية",
  "keywords": "نفيس، FHIR، تكامل الرعاية الصحية، المملكة العربية السعودية"
}
</script>

هيكل URL¶

حافظ على عناوين URL نظيفة ووصفية:

✅ عناوين URL جيدة:
/healthcare/claims/lifecycle
/healthcare/nphies/fhir-r4-profile
/tech/agents/claimlinc

❌ عناوين URL سيئة:
/page1
/healthcare/claims/page
/docs123

تكامل التحليلات¶

تحليلات صديقة للخصوصية¶

كوّن التحليلات في mkdocs.yml باستخدام خدمات تحترم الخصوصية:

الخيار 1: Plausible Analytics¶

extra:
  analytics:
    provider: custom
    property: plausible
    feedback:
      title: هل كانت هذه الصفحة مفيدة؟
      ratings:
        - icon: material/emoticon-happy-outline
          name: كانت هذه الصفحة مفيدة
          data: 1
          note: شكراً على ملاحظاتك!
        - icon: material/emoticon-sad-outline
          name: يمكن تحسين هذه الصفحة
          data: 0
          note: شكراً! يرجى إنشاء مشكلة مع الاقتراحات.

الامتثال للخصوصية¶

عند تنفيذ التحليلات:

1. لا بيانات شخصية: لا تتتبع المعلومات الشخصية بدون موافقة
2. إشعار ملفات تعريف الارتباط: إذا كنت تستخدم ملفات تعريف الارتباط، قدم إشعاراً واضحاً
3. إلغاء الاشتراك: قدم آلية لإلغاء الاشتراك في التتبع
4. الاحتفاظ بالبيانات: حدد فترات الاحتفاظ بالبيانات المناسبة
5. الامتثال لنظام حماية البيانات الشخصية: اتبع نظام حماية البيانات الشخصية السعودي

تحسين محركات البحث¶

قائمة التحقق من SEO على الصفحة¶

لكل صفحة توثيق:

• عنوان فريد ووصفي (50-60 حرفاً)
• وصف وصفي (150-160 حرفاً)
• عنوان H1 واحد على الأقل
• تسلسل عناوين منطقي (H1 → H2 → H3)
• نص رابط وصفي (لا "انقر هنا")
• نص بديل لجميع الصور
• روابط داخلية للمحتوى ذي الصلة
• روابط خارجية لمصادر موثوقة
• تنسيق متوافق مع الجوال
• وقت تحميل سريع للصفحة

استراتيجية الكلمات الرئيسية¶

استهدف الكلمات الرئيسية ذات الصلة بشكل طبيعي:

الكلمات الرئيسية الأساسية: - برينسايت - الذكاء الاصطناعي في الرعاية الصحية - تكامل نفيس - الرعاية الصحية السعودية - إدارة المطالبات - FHIR R4

الكلمات الرئيسية الثانوية: - أتمتة الفوترة الطبية - الامتثال الصحي - التحول الصحي الرقمي - وكلاء الذكاء الاصطناعي في الرعاية الصحية - إدارة دورة الإيرادات

جودة المحتوى¶

محركات البحث تفضل:

1. محتوى شامل: أدلة معمقة بدلاً من صفحات سطحية
2. تحديثات منتظمة: حافظ على تحديث المحتوى
3. محتوى أصلي: رؤى وأمثلة فريدة
4. نية المستخدم: طابق ما يبحث عنه المستخدمون
5. قابلية القراءة: محتوى واضح ومنظم جيداً

خريطة الموقع¶

مكوّن إضافي sitemap مكون في mkdocs.yml وينشئ تلقائياً sitemap.xml:

plugins:
  - search
  - i18n
  - sitemap:
      change_freq: weekly
      priority: 0.8

إرشادات الأولوية¶

حدد أولويات الصفحات بناءً على الأهمية:

1.0 - الصفحة الرئيسية
0.9 - صفحات الفئات الرئيسية (الرعاية الصحية، الأعمال، التقنية)
0.8 - الأدلة المهمة (نفيس، المطالبات)
0.7 - صفحات الفئات الفرعية
0.6 - التوثيق الداعم
0.5 - الملاحق والمراجع

المراقبة والتحسين¶

عمليات تدقيق SEO المنتظمة¶

قائمة التحقق الفصلية:

1. SEO التقني
2. التحقق من الروابط المكسورة
3. التحقق من إمكانية الوصول إلى sitemap.xml
4. اختبار سرعة تحميل الصفحة

5. ضمان التوافق مع الجوال

6. SEO المحتوى

7. مراجعة وتحديث الأوصاف الوصفية
8. إضافة نص بديل مفقود
9. تحسين الربط الداخلي

10. تحديث المحتوى القديم

11. الأداء

12. مراجعة بيانات Search Console
13. تحليل سلوك المستخدم
14. تحديد فرص التحسين
15. تتبع الترتيب للمصطلحات الرئيسية

الأدوات¶

• Google Search Console: مراقبة أداء البحث
• Lighthouse: اختبار جودة الصفحة وSEO
• WebPageTest: قياس أوقات التحميل
• WAVE: التحقق من إمكانية الوصول (يؤثر على SEO)

مرجع سريع¶

هيكل الصفحة المثالي¶

---
title: عنوان الصفحة المحدد | الفئة | برينسايت
description: وصف واضح وموجز مع كلمات رئيسية (150-160 حرفاً)
---

# العنوان الرئيسي (H1)

مقدمة موجزة مع الكلمات الرئيسية الأساسية.

## عنوان القسم (H2)

محتوى مع روابط داخلية وخارجية.

### قسم فرعي (H3)

معلومات تفصيلية مع أمثلة.

**الموضوعات ذات الصلة**:
- [رابط لصفحة ذات صلة](../path/to/page.md)
- [موضوع آخر ذو صلة](../path/to/another.md)

قالب العناصر الأمامية¶

---
# مطلوب
title: عنوان الصفحة
description: وصف وصفي لـSEO (150-160 حرفاً)

# اختياري
tags:
  - الرعاية الصحية
  - المطالبات
  - نفيس

# للمشاركة الاجتماعية
social:
  cards: true
---

OID: 1.3.6.1.4.1.61026