كيف تصحح تنسيق القيم في بيانات JSON-LD؟
درجة الخطورة: تحذيرمتوسطةالمدة التقريبية بالدقائق: 20آخر تحديث: 2026-10-14



كيف تصلحهافي هذا الدليل
ما المشكلة؟
وجدنا في JSON-LD قيمة مكتوبة بتنسيق لا يمكن قراءته على نحو موثوق. نعرض لك الحقل والقيمة المتأثرة في تفاصيل المشكلة. قد يكون السعر مكتوباً بأرقام عربية هندية أو بفاصل آلاف أو بالفاصل العشري العربي، أو قد لا تكون العملة رمز ISO 4217 من ثلاثة أحرف. وقد يحتوي name أو headline أو alternateName على علامات اتجاه مخفية أو ZWNJ أو تطويلاً زخرفياً بين حرفين، مثل «رمضــان». لا ننبّه إلى «هـ» الهجرية مثل «1448هـ»، ولا إلى السابقة المتصلة برقم أو كلمة لاتينية مثل «الـ96» و«بـQR». وتشمل المشكلة أيضاً telephone بلا رمز دولة، وaddressCountry بلا رمز ISO 3166-1 من حرفين، وinLanguage الذي لا يطابق اللغة الأساسية في <html lang>.
لماذا تهمّ؟
تحتاج محركات البحث إلى قيم ثابتة يمكن تفسيرها آلياً؛ فقد يمنع التنسيق المحلي للسعر أو العملة التعرف إلى القيمة الصحيحة.
قد تجعل الحروف المخفية اسم الكيان في JSON-LD مختلفاً تقنياً عن الاسم الظاهر، حتى إن بدا النصان متطابقين. والتطويل الزخرفي بين الحروف قد يمنع مطابقة الاسم حرفياً مع الاسم نفسه في مكان آخر، لذلك ننبّه إليه فحصاً لنظافة البيانات.
الصيغة الدولية للهاتف ورمز الدولة المعياري يساعدان على ربط بيانات النشاط بالبلد والكيان الصحيحين.
مطابقة inLanguage للغة الأساسية في <html lang> تمنع الإشارات اللغوية المتعارضة داخل الصفحة.
كيف تكتشفها بنفسك
- افتح الصفحة في Schema Markup Validator، ثم راجع القيم المعروضة لكل كيان في JSON-LD.
- افحص price و lowPrice و highPrice: يجب أن تستخدم أرقاماً غربية ونقطة عشرية، من دون فاصل آلاف، مثل "1200.50".
- تأكد أن priceCurrency رمز ISO 4217 من ثلاثة أحرف، مثل SAR أو AED أو EGP أو USD.
- انسخ name و headline و alternateName إلى محرر يُظهر المحارف المخفية، وابحث عن علامات الاتجاه و ZWNJ والتطويل ـ بين حرفين.
- تأكد من أن telephone يبدأ بـ + أو 00، وأن addressCountry رمز من حرفين مثل SA أو AE أو EG.
- قارن inLanguage باللغة الأساسية في
<html lang>، مثل ar أو ar-SA.
كيف تصلحها
WordPress
- في Rank Math راجع بيانات النشاط من Titles & Meta → Local SEO، وصحح الاسم والهاتف والعنوان والدولة.
- في Yoast SEO راجع Settings → Site representation، وصحح اسم المؤسسة وأسماءها البديلة.
- إذا جاءت القيم من منتج أو إضافة للتجارة الإلكترونية، صحح السعر والعملة والهاتف في بيانات المنتج أو المتجر أولاً.
- إن بقيت المشكلة، اطلب من مطوّرك فحص المرشح أو القالب الذي يولّد JSON-LD وتوحيد التنسيق فيه.
Shopify
- صحح السعر والعملة وبيانات النشاط في إعدادات المتجر والمنتجات، ثم اختبر الصفحة لمعرفة ما يولّده القالب.
- إذا كان JSON-LD مكتوباً في القالب، افتح نسخة احتياطية منه ثم صحح القيم في ملفات Liquid التي تنشئ البيانات المنظّمة.
- إذا كانت القيم تأتي من تطبيق، عدّل إعداداته أو اطلب من دعمه إخراج الأسعار والعملات وأرقام الهواتف بالصيغة المعيارية.
سلةقيد في منصة الموقع
قيد في منصة الموقع: لا تتيح سلة للتاجر تعديل JSON-LD الخاص بالمتجر مباشرة. صحح الاسم والهاتف والعنوان والدولة في إعدادات المتجر، ثم اطلب من دعم المنصة معالجة القيمة إن استمرت في JSON-LD.
زدقيد في منصة الموقع
قيد في منصة الموقع: لا تتيح زد للتاجر تعديل JSON-LD الخاص بالمتجر مباشرة. املأ الاسم والهاتف والعنوان والدولة بدقة في إعدادات المتجر، ثم تواصل مع دعم المنصة إذا بقي التنسيق غير الصحيح.
أي موقع
- استبدل الأرقام العربية الهندية في حقول السعر بأرقام غربية، واستخدم النقطة للفاصل العشري، واحذف فواصل الآلاف: اكتب "1200.50" أو 1200.5.
- اكتب priceCurrency برمز ISO 4217 من ثلاثة أحرف، مثل SAR أو AED أو EGP أو USD.
- احذف من name وheadline وalternateName علامات LRM وRLM وعلامات embeddings وisolates وZWNJ، والتطويل ـ الواقع بين حرفين، مع إبقاء النص العربي الظاهر كما هو. أبقِ «هـ» الهجرية والسابقة المتصلة برقم أو كلمة لاتينية كما هي.
- اكتب telephone بالصيغة الدولية E.164، مثل +966501234567، من دون مسافات أو أقواس داخل JSON-LD.
- اكتب addressCountry برمز ISO 3166-1 من حرفين، مثل SA أو AE أو EG.
- اضبط inLanguage ليتوافق مع اللغة الأساسية في
<html lang>، مثل "ar" أو "ar-SA". - عدّل القالب أو مصدر البيانات الذي ينشئ JSON-LD حتى لا تعود القيمة الخاطئة عند تحديث الصفحة.
مثال
{
"@context": "https://schema.org",
"@type": "Product",
"name": "عطر الــورد",
"offers": {
"@type": "Offer",
"price": "١٬٢٠٠٫٥٠",
"priceCurrency": "ر.س"
},
"telephone": "0501234567",
"addressCountry": "السعودية",
"inLanguage": "en"
}{
"@context": "https://schema.org",
"@type": "Product",
"name": "عطر الورد",
"offers": {
"@type": "Offer",
"price": "1200.50",
"priceCurrency": "SAR"
},
"telephone": "+966501234567",
"addressCountry": "SA",
"inLanguage": "ar"
}كيف تتأكد من الإصلاح
- اضغط «تحقق الآن» على هذا الإجراء في رانكاوي، فنعيد قراءة الصفحات المتأثرة فوراً.
- اختبر الصفحة في Schema Markup Validator، وتأكد أن الحقول تعرض القيم المصححة من دون محارف مخفية.
- افتح Rich Results Test من Google، وتأكد أن السعر والعملة وبقية القيم تظهر كما كتبتها.
أخطاء شائعة
- تحويل السعر إلى نص منسق مثل "1,200.50 SAR" داخل حقل price.
- استخدام SR أو «ر.س» أو رمز الريال بدلاً من SAR في priceCurrency.
- تصحيح النص الظاهر وترك القيمة القديمة داخل JSON-LD.
- كتابة الهاتف بصيغة محلية مثل 0501234567 من دون رمز الدولة.
- إضافة علامات اتجاه مخفية إلى الاسم كله بدلاً من ضبط اتجاه العرض في HTML.
جهّز الإصلاح مع مساعدك الذكي
اربط مساعدك الذكي برانكاوي في أي خطة، ثم انسخ هذا الطلب إليه. سيقرأ الصفحات المتأثرة وخطوات منصتك ويجهّز لك التعليمات لتراجعها.
استخدم أداتي رانكاوي get_issue_pages و get_actions لقراءة الصفحات المتأثرة بالمشكلة schema-value-format وتفاصيل كل حقل وقيمته. راجع price و lowPrice و highPrice و priceCurrency و name و headline و alternateName و telephone و addressCountry و inLanguage، ثم اكتب لي JSON-LD مصححاً لكل صفحة. استخدم الأرقام الغربية والنقطة العشرية ورموز ISO المناسبة، واحذف المحارف المخفية والتطويل الزخرفي بين الحروف مع إبقاء «هـ» الهجرية والسابقة المتصلة برقم أو كلمة لاتينية، وطابق inLanguage مع <html lang>. لا تعدّل شيئاً في موقعي.
كيف تربط مساعدك الذكيأسئلة شائعة
هل يجب أن يكون السعر نصاً أم رقماً في JSON-LD؟
يمكن أن يكون رقماً أو نصاً رقمياً، لكن استخدم أرقاماً غربية ونقطة عشرية من دون فواصل آلاف، مثل 1200.5 أو "1200.50".
هل أستطيع عرض السعر بالأرقام العربية الهندية للزائر؟
نعم، يمكنك تنسيق السعر الظاهر في الصفحة بما يناسب جمهورك. اجعل القيمة داخل JSON-LD بالصيغة المعيارية المستقلة عن تنسيق العرض في الصفحة.
هل ar-SA يطابق lang="ar"؟
نعم، اللغة الأساسية في الحالتين هي العربية. تظهر المشكلة عندما تختلف اللغة الأساسية فعلاً، مثل inLanguage بقيمة en وصفحة يبدأ lang فيها بـ ar.
أدلة مرتبطة
كيف تضيف البيانات المنظّمة للمنتج (Product Schema) ليظهر السعر في Google؟
صفحة المنتج بلا JSON-LD من نوع Product لا تعطي Google السعر والتوفّر بصيغة واضحة. تعرّف ما تضيفه وكيف تتحقق منه.
كيف تضيف البيانات المنظّمة للمقال (Article Schema) إلى مدونتك؟
المقال بلا JSON-LD من نوع Article أو BlogPosting يترك Google يخمّن العنوان والكاتب وتاريخ النشر. أضفها بكتلة صغيرة أو من إضافة السيو.
لماذا يجب أن تطابق قيمة lang في صفحتك لغة محتواها؟
محتوى صفحتك عربي ووسم html يقول lang="en"، أو العكس. تعرّف كيف تصحح القيمة في القالب حتى تقرأ المتصفحات وقارئات الشاشة صفحتك بلغتها.
كيف تصلح تعارض ترميز الصفحة بين الخادم ووسم meta charset؟
الخادم يعلن ترميزاً والصفحة تعلن آخر، أو تعلن UTF-8 وبايتاتها ليست كذلك، فيظهر النص العربي مشوهاً. هكذا توحّد الترميز إلى UTF-8.

