ما هو JSON-LD؟

JSON-LD (ترميز كائنات JavaScript للبيانات المترابطة) هو التنسيق الذي توصي به محركات البحث للبيانات المنظَّمة. تضيف الصفحة كتلة <script type="application/ld+json"> تصف محتوى الصفحة، مثل منتج مع سعره، أو مقال مع مؤلفه، أو مؤسسة مع شعارها، باستخدام الأنواع والخصائص من مفردات schema.org. تقرأ جوجل وبينغ ومحركات البحث الأخرى هذه الكتل لعرض النتائج المنسَّقة، مثل تقييمات النجوم والأسعار ومسارات التنقل وبطاقات الوصفات.

تتسبب الأخطاء في JSON-LD في فشل صامت. تظل الصفحة تُحمَّل، لكن فاصلة مفقودة أو نوع مكتوب بطريقة خاطئة أو حقل مطلوب مفقود يعني أن محركات البحث ستتجاهل الترميز، أو أن الصفحة ستفقد نتيجتها المنسَّقة.

وصف الأداة

تجلب هذه الأداة HTML الخاص بالصفحة على الخادم، وتعثر على كل كتلة نص برمجي لـ JSON-LD، ثم تتحقق من كل كتلة على خطوتين. تتحقق أولًا من JSON-LD نفسه: من إمكانية تحليل JSON، ومن احتواء كل عنصر على @context يشير إلى schema.org وعلى @type، ومن كتابة الكلمات المفتاحية مثل @type و@id وتنسيقها بشكل صحيح. ثم تتحقق من المحتوى مقابل مفردات schema.org وقواعد جوجل للنتائج المنسَّقة، وتُبلغ عن الأنواع غير المعروفة، والخصائص التي لا تنتمي إلى نوع معيّن، والحقول المطلوبة أو الموصى بها المفقودة أو ذات التنسيق الخاطئ.

الميزات

  • العثور على كل كتلة JSON-LD في صفحة مباشرة، سواء في <head> أو <body>
  • الإبلاغ عن أخطاء بنية JSON مع رسالة محلل JSON
  • التحقق من @context و@type و@id و@graph وكتابة الكلمات المفتاحية
  • اكتشاف أنواع schema.org غير المعروفة والخصائص التي لا يدعمها نوع معيّن
  • التحقق من الحقول المطلوبة والموصى بها لدى جوجل للمنتجات والعروض والمراجعات والتقييمات والوصفات وإعلانات الوظائف ومقاطع الفيديو ومسارات التنقل وغير ذلك
  • إدراج كل عنصر من عناصر البيانات المنظَّمة مع نوعه واسمه
  • عرض كل كتلة بصيغة JSON منسَّقة

آلية العمل

تُنزَّل الصفحة من دون اتباع عمليات إعادة التوجيه، ولا تتم قراءة أكثر من أول 3 ميغابايت منها. تُحلَّل كل كتلة JSON-LD بشكل منفصل، وتُفحَص العناصر الموجودة داخل @graph كعناصر منفصلة. تستخدم عمليات التحقق من schema.org نسخة من مفردات schema.org الكاملة، بينما تستخدم عمليات التحقق من النتائج المنسَّقة لدى جوجل أداة التحقق من البيانات المنظَّمة مفتوحة المصدر من أدوبي.

نصائح

  • تعني الأخطاء أن محركات البحث ستتجاهل العنصر على الأرجح أو أنه لن يحصل على نتيجة منسَّقة، لذا أصلحها أولًا. تكون التحذيرات عادةً بشأن الحقول الموصى بها، ويمكن أن تؤدي إضافتها إلى تحسين مظهر النتيجة.
  • الكلمات المفتاحية في JSON-LD حساسة لحالة الأحرف: تعمل @type، بينما لا تعمل @Type.
  • استخدم عناوين URL مطلقة للحقول url وimage وlogo، وتواريخ بتنسيق ISO 8601 مثل 2026-09-25 أو 2026-09-25T10:00:00+02:00.
  • تقرأ الأداة HTML الذي يعيده الخادم. ولن تعثر على JSON-LD الذي تضيفه JavaScript لاحقًا في المتصفح.