دليل البيانات المنظمة العملي

دليل ترميز JSON-LD لتحسين محركات البحث العملي

يساعد JSON-LD محركات البحث على فهم ماهية الصفحة، من نشرها، كيف تتناسب مع موقعك، وأي الحقائق تستحق الاستخدام في ميزات البحث المدعومة.

الهدف المفيد ليس إضافة كل نوع مخطط تجده، بل هدفه بيانات منظمة دقيقة تطابق الصفحة المرئية، تتحقق بسهولة، وتبقى متزامنة عند تغيير المحتوى.

النسخة المختصرة المفيدة

استخدم JSON-LD عندما يمكنك وصف الصفحة بوقائع صادقة ومرئية: العنوان، الوصف، المؤلف، تاريخ النشر، مسار التنقل، تفاصيل المنتج، بيانات الفيديو، أو محتوى أسئلة وأجوبة واضح. لا تضف مخططًا لوعد ميزات لم تعد Google تعرضها أو لترميز محتوى لا يراه المستخدمون.

أفضل مخطط أولاً Article و WebPage و BreadcrumbList لمعظم صفحات الدليل.
أفضل سير عمل أنشئ المخطط من نفس بيانات وصف الصفحة التي تدعم العنوان والوصف والرابط القانوني وOpen Graph.
أفضل فحص واقعي يمكن لترميز FAQPage و WebSite وصف المحتوى، لكن لا تبنِ استراتيجية حول عروض 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 الجيد ممل بأفضل طريقة: متسق، مولد من حقول موثوقة، سهل التحقق، وصعب النسيان عند تغيير الصفحة.

01

اختر كيان صفحة رئيسي واحد

حدد ما إذا كانت الصفحة في الأساس مقالًا، منتجًا، تطبيقًا، فيديو، أسئلة متكررة، مجموعة، أو صفحة ويب عامة. يجب أن يدعم المخطط الثانوي الكيان الرئيسي.

02

طابق المحتوى المرئي

يجب أن يكون كل ادعاء موسوم مرئيًا أو يمكن استنتاجه بوضوح في الصفحة: العنوان، المؤلف، التواريخ، السعر، التقييم، الأسئلة والأجوبة، مسار التنقل، والصور.

03

استخدم قيم @id ثابتة

امنح الكيانات المهمة معرفات ثابتة مثل الرابط القانوني مع #article أو #webpage أو #organization أو #faq. هذا يساعد المحللات على ربط أجزاء الرسم البياني.

04

توليد من بيانات وصف مشتركة

أعد استخدام نفس حقول المصدر التي تنشئ عناوين الصفحات، أوصاف الميتا، الروابط القانونية، صور Open Graph، علامات اللغة، وتواريخ التعديل الأخيرة.

05

حافظ على تواريخ صادقة

غيّر تاريخ التعديل dateModified فقط عند تغيير محتوى الصفحة بشكل جوهري. لا تحدث التواريخ تلقائيًا لمجرد الظهور بمظهر جديد في نتائج البحث.

06

اجعل الصور قابلة للزحف

استخدم روابط صور مطلقة، أبعاد مناسبة، وملفات غير محجوبة بواسطة الروبوتات أو المصادقة أو العرض بالتأخير فقط.

07

العرض المبكر

في Blazor وتطبيقات JavaScript الأخرى، يُفضل JSON-LD المعروض مسبقًا أو من الخادم حتى تراه الزواحف في استجابة HTML الأولية.

08

تحقق وراقب

قم بتشغيل اختبار النتائج الغنية قبل النشر، تحقق من مدقق ترميز المخطط للنحو، وراقب Search Console بعد الفهرسة.

نموذج JSON-LD نظيف لصفحات Blazor

في Blazor، النموذج الأكثر أمانًا هو بناء المخطط من بيانات وصف الصفحة أثناء التهيئة أو العرض المسبق، تسلسله مرة واحدة، وعرض سكريبت application/ld+json حيث يمكن للزواحف رؤيته في HTML الأولي.

HTMLمثال JSON-LD لمقال
<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>
C#نموذج مساعد C#
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>");
}
قاعدة عملية: استخدم روابط ثابتة لـ url و @id. استخدم نفس الرابط القانوني في كل مكان. إذا ظهرت نفس الصفحة بروابط بلغات متعددة، أنشئ بيانات وصف خاصة بكل لغة وحافظ على اتساق إعداد hreflang/الرابط القانوني.

تحقق من 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 الغنية هي الفائدة الرئيسية لتحسين محركات البحث.

المصادر التي تم التحقق منها

الإرشادات أعلاه مستندة إلى وثائق Google Search Central وschema.org الرسمية، ثم تحولت إلى قائمة تحقق عملية لـ JSON-LD.

01 مقدمة بيانات Google المنظمة developers.google.com 02 سياسات بيانات Google المنظمة developers.google.com 03 بيانات منظمة لمقال Google developers.google.com 04 بيانات منظمة لمسار التنقل Google developers.google.com 05 بيانات منظمة لأسئلة متكررة Google developers.google.com 06 تحديث مربع بحث روابط الموقع في Google developers.google.com 07 البدء مع Schema.org schema.org 08 اختبار نتائج Google الغنية search.google.com 09 مدقق ترميز المخطط validator.schema.org

الأسئلة الشائعة

هل ترميز مخطط 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 بعد فهرسة الصفحات المهمة.