مدقّق Schema Markup والبيانات المهيكلة JSON-LD

تُدخل صفحة واحدة؛ ويُحلَّل كل كتلة JSON-LD في شفرتها الأصلية ثم تُقارن بمفردات Schema.org.

1. 01

   أدخل الصفحة المراد فحصها

   صفحة واحدة في كل مرة — البيانات المنظَّمة تخصّ صفحة بعينها، وأشجار الكيانات المتراكمة ليست شيئًا يُقرأ جنبًا إلى جنب. توحيد الرابط تظل مهمة: اضبطها على النطاق فقط وستقرأ ترميز الصفحة الرئيسية لا الصفحة التي لصقتها.

   الرابطexample.com/recipe

   توحيد الرابطالرابط كاملاً
2. 02

   شغّل الفحص على HTML الخام

   تجلب الأداة الصفحة وتحلّل شفرة HTML التي تصلها. هي لا تنفّذ JavaScript، لذا الترميز الذي يحقنه سكربت بعد التحميل لن يكون موجودًا لتجده. لهذا تقول النتيجة الفارغة «غير موجود في الشفرة الأصلية» لا «هذه الصفحة بلا schema».

   فحص البيانات المنظَّمة

   الرابط الفعلي200example.com/recipe
3. 03

   اقرأ طبعة JSON للبيانات المعلنة

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

   نسخ JSONتنزيل JSON

   1{

   2 "@type": "Recipe",

   "cookTme": "PT30M",

   4 "author": {

   5 "@type": "Person"

   6 }

   7}

   • Recipe
   • Person
4. 04

   تتبّع القائمة إلى السطر بعينه وصدّر

   تحت الطبعة العدّان ومدخل لكل مشكلة، مرتبة بحسب رقم السطر. يرتبط كل مدخل بسطره في الطبعة، فتبقى صفحة فيها ثلاثون مشكلة قابلة للتصفح. يمنحك «نسخ» و«تصدير» في الصف فوق الطبعة الطبعةَ نفسها: الملف المنزَّل ملف .json يمكنك لصقه مباشرة من جديد.

   1 خطأ0 تحذير

   السطر 3الخاصية "cookTme" غير موجودة في مفردات Schema.org.

كيفية قراءة تقرير البيانات المهيكلة JSON-LD

تجيب القائمة عن سؤالين: ماذا تعلن هذه الصفحة، وأي أجزائها سيرفضها المحلل. الحقول الإلزامية وأهلية النتائج المنسّقة لا تُحكم هنا؛ محرك البحث يقررهما لكل نتيجة منسّقة.

عناصر الطبعة

@type

نوع Schema.org للعنصر، مطبوع في سطره الأول، وهو السطر الذي يُعلَّم عليه النوع غير الصالح. العنصر الذي هو مجرد مرجع لا سطر @type له: الصفحة لم تعلن شيئًا والطبعة لا تختلق شيئًا.

@id

ما يميّز عنصرين من النوع نفسه، مطبوع بعد @type مباشرة. العنصر المشار إليه بـ@id يُملأ حيث يُستعمل ولا يُكرَّر في المستوى الأعلى، فقد تكون الطبعة أقصر من الترميز.

الأخطاء

ترميز سيرفضه المحلّل أو يتجاهله: نوع أو خاصية خارج المفردات، قيمة من صنف خاطئ، أو كتلة ليست JSON صالحًا.

التحذيرات

ترميز صالح لكنه على الأرجح ليس ما قصدته — غالبًا خاصية موجودة فعلًا لكنها غير معرَّفة لهذا النوع. تسمّيها Schema.org توقعات لا قواعد، لذا لا تصير أخطاءً هنا أبدًا.

مرجع الرسائل

النوع غير موجود في المفردات

هذا الـ@type غير موجود في Schema.org — عادةً خطأ إملائي أو اسم اخترعه الموقع. والعنصر الذي بلا @type إطلاقًا يُبلَّغ عنه بالطريقة نفسها، لأن المحلّل لا يستطيع فعل شيء بأيٍّ منهما.

الخاصية غير موجودة في المفردات

اسم الخاصية غير موجود في أي موضع من Schema.org، فلا أحد يقدر على قراءته. هذا خطأ: تُلقى القيمة مهما كانت.

الخاصية غير صالحة لهذا النوع

الخاصية موجودة، لكن ليس على هذا النوع — مثل cookTime على Article. تحذير فقط: تعامل Schema.org انتماء الخاصية إلى نوع بوصفه إرشادًا، والقارئون يتجاوزونه عادةً.

القيمة لا تطابق النوع المتوقع

الخاصية موجودة وفي مكانها، لكن القيمة من صنف آخر — نص عادي حيث كان المتوقع تاريخًا أو عنصرًا متداخلًا.

هذه الكتلة ليست JSON صالحًا

يُبلَّغ عنه فوق القائمة لا داخل كتلة، لأن الكتلة التي لا تُحلَّل لا عناصر فيها ليُربط بها شيء. كل ما بعد خطأ الصياغة غير مقروء؛ وفاصلة شاردة واحدة قد تخفي بقية الترميز.

لا يوجد @context يشير إلى schema.org

يُبلَّغ عنه هنا عمدًا رغم صمت المدقق المرجعي عنه. من دون @context تصبح الأسماء داخله مجرد كلمات، فلا شيء في الكتلة يمكن فحصه، وتقرير نظيف عن كتلة لم تُفحص هو أسوأ جواب ممكن.