دليل البيانات المنظمة العملي
دليل ترميز مخطط JSON-LD لتحسين محركات البحث العملي
يساعد JSON-LD محركات البحث على فهم ماهية الصفحة، من نشرها، كيف تتناسب مع موقعك، وأي الحقائق تستحق الاستخدام في ميزات البحث المدعومة.
الهدف المفيد ليس إضافة كل نوع مخطط تجده، بل هدفه بيانات منظمة دقيقة تطابق الصفحة الظاهرة، تتحقق بسهولة، وتبقى متزامنة عند تغيير المحتوى.
النسخة المختصرة المفيدة
استخدم JSON-LD عندما يمكنك وصف الصفحة بوقائع صادقة ومرئية: العنوان، الوصف، المؤلف، تاريخ النشر، مسار التنقل، تفاصيل المنتج، بيانات الفيديو، أو محتوى أسئلة وأجوبة واضح. لا تضف مخططًا لوعد بميزات لم تعد Google تعرضها أو لترميز محتوى لا يمكن للمستخدمين رؤيته.
فهرس المحتويات
ما يفعله JSON-LD فعليًا
JSON-LD هو كتلة بيانات منظمة قابلة للقراءة آليًا. عادةً ما تكون في وسم سكريبت في الرأس أو جسم الصفحة وتصف الكيانات باستخدام مفردات schema.org. تستخدمها محركات البحث كطبقة توضيحية فوق المحتوى الظاهر.
وضوح المحلل
المعنى
يحول حقائق الصفحة إلى كيانات وخصائص مسماة، مثل Article، المؤلف، تاريخ النشر، BreadcrumbList، أو SoftwareApplication.
ميزة البحث
الأهلية
يمكن أن يجعل الصفحة مؤهلة للنتائج الغنية المدعومة، لكن Google تقرر ما يظهر بناءً على الجودة، السياسة، الاستعلام، وتوفر الميزات.
رسم بياني للموقع
الاتساق
يوفر لنظام إدارة المحتوى أو تطبيق Blazor مكانًا منظمًا لإعادة استخدام نفس رابط الكانونيكال، اللغة، العنوان، التواريخ، الصور، وبيانات الناشر.
ليست اختصارًا
الحد
لا يصلح المحتوى الضعيف، المراجعات المزيفة، إجابات FAQ المخفية، التواريخ القديمة، أو الصفحات التي لا تطابق البيانات المنظمة.
اختر المخطط حسب وظيفة الصفحة
أسهل طريقة لتجنب البيانات المنظمة المزعجة أو المكررة هي السؤال عن هدف الصفحة. أضف أصغر مجموعة مخطط تصف هذا الهدف بدقة.
المحتوى
Article / BlogPosting
- استخدمه لـ
- أدلة، دروس، مراجعات، منشورات شبيهة بالأخبار، وشروحات مطولة.
- أضف عند
- الصفحة تحتوي على عنوان واضح، مؤلف أو ناشر، تاريخ نشر، تاريخ تعديل، رابط كانوني، وصورة.
- تجنب عند
- الصفحة في الغالب واجهة أداة، قائمة منتجات، صفحة فئة، أو صفحة هبوط ضعيفة.
التنقل
BreadcrumbList
- استخدمه لـ
- تقريبًا كل صفحة تحت الصفحة الرئيسية.
- أضف عند
- يمكن للمستخدمين فهم مكان الصفحة في هيكل الموقع.
- تجنب عند
- مسار مسار التنقل يتعارض مع الروابط الداخلية، روابط الكانونيكال، أو التنقل الظاهر.
هوية الموقع
WebPage / WebSite / Organization
- استخدمه لـ
- الصفحة الرئيسية، المحاور، صفحات من نحن، والصفحات التي تهم هوية الناشر.
- أضف عند
- تريد رسمًا بيانيًا كيانياً ثابتًا يربط الصفحة، الموقع، الناشر، واللغة.
- تجنب عند
- أنت تضيف ترميز WebSite فقط لملاحقة عرض مربع بحث روابط الموقع القديم.
منتج أو تطبيق
Product / SoftwareApplication
- استخدمه لـ
- أدوات، تطبيقات، صفحات SaaS، إضافات، برامج قابلة للتنزيل، أو صفحات منتجات حقيقية.
- أضف عند
- المحتوى الظاهر في الصفحة يشمل الاسم، الوصف، نظام التشغيل أو الفئة، السعر، العروض، والتقييمات عند ترميزها.
- تجنب عند
- التقييمات، السعر، التوفر، أو المراجعات غير مرئية للمستخدمين في الصفحة.
أسئلة
FAQPage
- استخدمه لـ
- أقسام الأسئلة والأجوبة الظاهرة التي تساعد المستخدمين حقًا على فهم الموضوع.
- أضف عند
- محتوى الأسئلة والأجوبة مفيد في الصفحة حتى لو لم تعرض Google نتائج FAQ الغنية.
- تجنب عند
- تضيف أسئلة وأجوبة عامة فقط لاحتلال مساحة في البحث أو تكرار نفس الإجابة عبر صفحات متعددة.
الوسائط
VideoObject / ImageObject
- استخدمه لـ
- صفحات تحتوي على فيديو مدمج مهم، فيديو تعليمي، أو أصل صورة قابل للزحف.
- أضف عند
- الوسائط مركزية للصفحة ولها عنوان، وصف، صورة مصغرة، تاريخ رفع، ورابط ثابت.
- تجنب عند
- الوسائط زخرفية، مخفية، محجوبة، أو غير ذات صلة بالغرض الرئيسي للصفحة.
قائمة تحقق للتنفيذ تمنع معظم الأخطاء
JSON-LD الجيد ممل بأفضل طريقة: متسق، مولد من حقول موثوقة، سهل التحقق، وصعب النسيان عند تغيير الصفحة.
اختر كيان صفحة رئيسي واحد
حدد ما إذا كانت الصفحة في الأساس مقالًا، منتجًا، تطبيقًا، فيديو، أسئلة شائعة، مجموعة، أو صفحة ويب عامة. يجب أن يدعم المخطط الثانوي الكيان الرئيسي.
طابق المحتوى الظاهر
يجب أن يكون كل ادعاء موسوم مرئيًا أو يمكن استنتاجه بوضوح في الصفحة: العنوان، المؤلف، التواريخ، السعر، التقييم، الأسئلة والأجوبة، مسار التنقل، والصور.
استخدم قيم @id ثابتة
امنح الكيانات المهمة معرفات ثابتة مثل رابط الكانونيكال مع #article أو #webpage أو #organization أو #faq. هذا يساعد المحللات على ربط أجزاء الرسم البياني.
توليد من بيانات وصف مشتركة
أعد استخدام نفس حقول المصدر التي تنشئ عناوين، أوصاف ميتا، روابط الكانونيكال، صور Open Graph، علامات اللغة، وتواريخ التعديل الأخيرة.
حافظ على تواريخ صادقة
غيّر تاريخ التعديل dateModified فقط عند تغيير محتوى الصفحة بشكل جوهري. لا تحدث التواريخ تلقائيًا لمجرد الظهور بمظهر جديد في نتائج البحث.
اجعل الصور قابلة للزحف
استخدم روابط صور مطلقة، أبعاد مناسبة، وملفات غير محجوبة بواسطة الروبوتات، المصادقة، أو العرض بالتأخير فقط.
اعرض مبكرًا
في Blazor وتطبيقات JavaScript الأخرى، يُفضل JSON-LD المعروض مسبقًا أو من الخادم حتى تراه الزواحف في استجابة HTML الأولية.
تحقق وراقب
شغّل اختبار النتائج الغنية قبل النشر، تحقق من مدقق ترميز المخطط للنحو، وراقب Search Console بعد الفهرسة.
نموذج JSON-LD نظيف لصفحات Blazor
في Blazor، النموذج الأكثر أمانًا هو بناء المخطط من بيانات وصف الصفحة أثناء التهيئة أو العرض المسبق، تسلسله مرة واحدة، وعرض سكريبت application/ld+json حيث يمكن للزواحف رؤيته في HTML الأولي.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://example.com/en/json-ld-schema-guide/#article",
"headline": "JSON-LD Schema Markup Guide for Practical SEO",
"description": "A practical guide to choosing, generating, and validating structured data.",
"image": "https://example.com/images/json-ld-guide.png",
"datePublished": "2026-03-28T10:00:00+00:00",
"dateModified": "2026-05-31T10:00:00+00:00",
"author": {
"@type": "Organization",
"name": "Example Publisher"
},
"publisher": {
"@type": "Organization",
"name": "Example Publisher",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/en/json-ld-schema-guide/"
}
}
</script>private MarkupString BuildJsonLd(PageMetaData meta)
{
var pageUrl = BuildPageUrl(meta);
var schema = new Dictionary<string, object?>
{
["@context"] = "https://schema.org",
["@type"] = "Article",
["@id"] = $"{pageUrl}#article",
["headline"] = meta.Title,
["description"] = meta.Description,
["url"] = pageUrl,
["datePublished"] = meta.Published?.ToString("O"),
["dateModified"] = meta.Modified?.ToString("O"),
["inLanguage"] = CS.Culture
};
var json = JsonSerializer.Serialize(schema, new JsonSerializerOptions
{
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
});
return new MarkupString($"<script type=\"application/ld+json\">{json}</script>");
}تحقق من JSON-LD قبل الاعتماد عليه
للتحقق وظيفتان مختلفتان. مدقق ترميز المخطط يفحص ما إذا كانت المفردات وصياغة JSON-LD مفهومة. اختبار النتائج الغنية من Google يفحص ما إذا كانت Google تعترف بالصفحة كأهلية لأنواع النتائج الغنية المدعومة.
أهلية Google
اختبار النتائج الغنية
يتحقق مما إذا كان Google يمكنه قراءة الصفحة وإذا كانت البيانات المنظمة المكتشفة مؤهلة لأنواع النتائج الغنية المدعومة.
افتح اختبار النتائج الغنيةالمفردات
مدقق ترميز المخطط
يفحص الهيكل العام لـ schema.org وصياغة JSON-LD، بما في ذلك الأنواع، الخصائص، الكيانات المتداخلة، وJSON غير الصحيح.
افتح مدقق ترميز المخططبعد النشر
Search Console
استخدم تقارير فحص URL والتحسين لاكتشاف مشاكل الزحف، الفهرسة، والبيانات المنظمة بعد معالجة Google للصفحة.
اقرأ وثائق بيانات Google المنظمةأخطاء شائعة في JSON-LD تضر بالثقة
معظم مشاكل المخطط ليست أخطاء تقنية معقدة، بل هي عدم تطابق بين ما يقوله الترميز وما يمكن للمستخدم أو الزاحف التحقق منه في الصفحة.
ترميز المحتوى المخفي أو المفقود
إذا لم يتمكن المستخدمون من رؤية الإجابة أو المراجعة أو العرض أو الصورة أو ادعاء المؤلف، لا تضعها في البيانات المنظمة. هذه أسرع طريقة لفقدان الثقة.
إضافة FAQPage لكل شيء
يمكن لمخطط FAQ وصف الأسئلة والأجوبة الظاهرة، لكنه لا يجب أن يكون كتلة نسخ ولصق عبر كل مقال. استخدمه فقط عندما تحسن الأسئلة والأجوبة الصفحة.
سكريبتات مكررة متضاربة
وجود عدة كتل Article بعناوين، تواريخ، أو روابط مختلفة يصعب تفسير الصفحة. رسم بياني واضح واحد أفضل من ثلاثة جزئيين.
رابط كانوني أو @id خاطئ
يجب أن تطابق روابط المخطط صفحة الكانونيكال، رابط الثقافة، وإعداد hreflang. الروابط متعددة اللغات تسبب تكرار المحتوى والتشويش في الكيانات.
تحديث زائف
لا تُحدث تاريخ التعديل dateModified لتغييرات القالب أو التتبع أو تحديثات المخطط فقط. استخدم التاريخ لتغييرات المحتوى الحقيقية.
عرض متأخر للعميل فقط
إذا ظهر JSON-LD فقط بعد عرض العميل المتأخر، قد تفوته الزواحف. يُفضل العرض من الخادم أو العرض المسبق للصفحات المهمة.
وصفات مخطط عملية حسب نوع الصفحة
نادراً ما تحتاج إلى رسم بياني ضخم. هذه التركيبات تغطي الصفحات التي تنشرها معظم المواقع الصغيرة، المدونات، الأدوات، ومشاريع المراجعة فعليًا.
مقال إرشادي
Article + BreadcrumbList + WebPage
- استخدم Article للعنوان، المؤلف، الناشر، الصورة، التواريخ، وأسماء الأقسام.
- استخدم BreadcrumbList لمسار الموقع الظاهر.
- استخدم WebPage أو مراجع @id لربط الصفحة وكيان المقال.
صفحة أداة
SoftwareApplication + WebPage + BreadcrumbList
- استخدم SoftwareApplication فقط إذا كانت الصفحة عن تطبيق أو أداة حقيقية.
- أدرج نظام التشغيل، الفئة، السعر أو تفاصيل العرض فقط عندما تكون مرئية.
- تجنب استخدام علامات التقييم أو المراجعة إلا إذا كانت الصفحة تعرض بيانات مراجعة حقيقية.
صفحة مراجعة
المراجعة / المنتج فقط عندما تدعمها الصفحة
- علّم العنصر المراجع، المؤلف، التاريخ، والتقييم فقط عندما تظهر بوضوح في الصفحة.
- حافظ على شفافية روابط الشركاء والسياق التجاري.
- استخدم نفس التقييم في المخطط والمحتوى الظاهر.
صفحة أسئلة
FAQPage فقط للأسئلة والأجوبة المفيدة والمرئية
- اجعل كل إجابة مفيدة بحد ذاتها، وليس مجرد متغير للكلمة المفتاحية.
- لا تخفِ الإجابات خلف واجهة مستخدم محجوبة لا يمكن للزواحف الوصول إليها.
- لا تتوقع أن تكون نتائج FAQ الغنية هي الفائدة الرئيسية من SEO.
المصادر التي تم التحقق منها
مصادر البحث لهذا الدليل
الإرشادات أعلاه مبنية على وثائق Google Search Central وschema.org الرسمية، ثم تحولت إلى قائمة تحقق عملية لـ JSON-LD.
الأسئلة الشائعة
هل ترميز مخطط JSON-LD عامل ترتيب؟
JSON-LD بحد ذاته ليس مفتاح ترتيب سحري. يساعد محركات البحث على فهم المحتوى المؤهل ويدعم الأهلية للنتائج الغنية، لكن الترتيب يعتمد على جودة المحتوى، الصلة، إمكانية الزحف، الروابط، والعديد من الإشارات الأخرى.
أين يجب وضع JSON-LD في الصفحة؟
عادةً ما يكون من الأسهل إدارة وسم السكريبت في الرأس، لكن يمكن لـ Google قراءة JSON-LD في الجسم أيضًا. الجزء المهم هو وجود العلامة في الصفحة المعروضة ومطابقتها للمحتوى الظاهر.
هل يجب أن أستمر في استخدام مخطط FAQPage؟
استخدم FAQPage فقط عندما تحتوي الصفحة على أسئلة وأجوبة مفيدة ومرئية حقًا. لا تعتمد عليه لزيادة مساحة نتائج Google لأن عرض نتائج FAQ الغنية تم تقليله وإهماله لمعظم المواقع العادية.
هل يمكن لصفحة واحدة أن تحتوي على عدة كتل JSON-LD؟
نعم. يمكن لصفحة مقال عادية أن تحتوي على بيانات Article وBreadcrumbList وWebPage. حافظ على اتساق الكتل، تجنب الكيانات المتضاربة المكررة، واستخدم قيم @id ثابتة لربط الأجزاء ذات الصلة.
هل JSON-LD أفضل من Microdata؟
لأغلب المواقع الحديثة، نعم. تدعم Google JSON-LD وMicrodata وRDFa، لكن JSON-LD أسهل عادةً للصيانة لأنه لا يتطلب سمات مخطط داخل قوالب HTML المرئية.
كم مرة يجب أن أتحقق من صحة البيانات المنظمة؟
تحقق كلما غيرت القوالب، حقول البيانات الوصفية، مساعدي المخطط، الروابط، توجيه اللغة، إنشاء الصور، بيانات المراجعة، أو أقسام الأسئلة الشائعة. تحقق أيضًا من Search Console بعد فهرسة الصفحات المهمة.