لماذا يهم
- يقرأ Google البيانات المنظّمة من كتل JSON-LD ليعرض النتائج المنسّقة، مثل بيانات النشاط التجاري والأسعار والتقييمات.
- إذا لم تكن الكتلة JSON صالحاً فلا يستطيع Google قراءة أي شيء منها: تُهمَل الكتلة كلها، لا السطر الخاطئ وحده. ويعرض Search Console هذه الحالة في تقرير البيانات المنظّمة غير القابلة للتحليل (Unparsable structured data).
- من الأسباب المعروفة: فاصلة زائدة بعد آخر عنصر، وعلامة تنصيص داخل اسم عربي مثل
مطعم "الأصيل"دون تهريب، وسطر جديد داخل نص.
مثال
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Restaurant", "name": "مطعم "الأصيل" للمأكولات البحرية",
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Restaurant", "name": "مطعم \"الأصيل\" للمأكولات البحرية",
كيف تُصلح
- احذف الفاصلة التي تسبق
}أو]. - هرّب علامة التنصيص داخل النص بكتابتها
\"، أو استخدم علامتي التنصيص العربيتين «» اللتين لا تحتاجان إلى تهريب:
json
{
"@context": "https://schema.org",
"@type": "Restaurant",
"name": "مطعم \"الأصيل\" للمأكولات البحرية"
}- الأفضل أن تُولَّد الكتلة بدالة ترميز JSON في لغة البرمجة، مثل
JSON.stringifyفي JavaScript أوjson_encodeفي PHP، بدل كتابتها كنص يدوياً. - بعد الإصلاح اختبر الصفحة في أداة Google لاختبار النتائج المنسّقة أو في مدقق Schema.org.
كيف نكشف
- نجمع كل وسوم
<script type="application/ld+json">، بأي حالة أحرف ومع أي معاملات بعد النوع، ونتجاوز الكتل الفارغة. - نفحص كل كتلة فحصاً صارماً حسب مواصفة JSON (RFC 8259)، ونحدد نوع الخطأ وموضعه في الصفحة بالسطر والعمود.
- نرقّم الكتل حسب ترتيبها بين كتل JSON-LD في الصفحة، ولكل كتلة معطوبة مخالفة واحدة عند أول خطأ فيها.
هذه القاعدة تفحص الصيغة فقط؛ صحة الأنواع والخصائص حسب Schema.org فحص آخر.
المراجع
- RFC 8259: صيغة JSON (بالإنجليزية)
- Google: مقدمة إلى ترميز البيانات المنظَّمة
- مدقق Schema.org (بالإنجليزية)
- W3C: JSON-LD 1.1 (بالإنجليزية)