# كيف تصحح تنسيق القيم في بيانات JSON-LD؟

بعض قيم JSON-LD تبدو صحيحة للزائر، لكن تنسيق الأرقام والعملات والهواتف والنصوص يمنع schema.org وGoogle من قراءتها كما ينبغي.

آخر مراجعة: 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> تمنع الإشارات اللغوية المتعارضة داخل الصفحة.

## كيف تفحصها؟

1. افتح الصفحة في Schema Markup Validator، ثم راجع القيم المعروضة لكل كيان في JSON-LD.
2. افحص price و lowPrice و highPrice: يجب أن تستخدم أرقاماً غربية ونقطة عشرية، من دون فاصل آلاف، مثل "1200.50".
3. تأكد أن priceCurrency رمز ISO 4217 من ثلاثة أحرف، مثل SAR أو AED أو EGP أو USD.
4. انسخ name و headline و alternateName إلى محرر يُظهر المحارف المخفية، وابحث عن علامات الاتجاه و ZWNJ والتطويل ـ بين حرفين.
5. تأكد من أن telephone يبدأ بـ + أو 00، وأن addressCountry رمز من حرفين مثل SA أو AE أو EG.
6. قارن inLanguage باللغة الأساسية في <html lang>، مثل ar أو ar-SA.

## طريقة الإصلاح

### أي موقع

1. استبدل الأرقام العربية الهندية في حقول السعر بأرقام غربية، واستخدم النقطة للفاصل العشري، واحذف فواصل الآلاف: اكتب "1200.50" أو 1200.5.
2. اكتب priceCurrency برمز ISO 4217 من ثلاثة أحرف، مثل SAR أو AED أو EGP أو USD.
3. احذف من name وheadline وalternateName علامات LRM وRLM وعلامات embeddings وisolates وZWNJ، والتطويل ـ الواقع بين حرفين، مع إبقاء النص العربي الظاهر كما هو. أبقِ «هـ» الهجرية والسابقة المتصلة برقم أو كلمة لاتينية كما هي.
4. اكتب telephone بالصيغة الدولية E.164، مثل +966501234567، من دون مسافات أو أقواس داخل JSON-LD.
5. اكتب addressCountry برمز ISO 3166-1 من حرفين، مثل SA أو AE أو EG.
6. اضبط inLanguage ليتوافق مع اللغة الأساسية في <html lang>، مثل "ar" أو "ar-SA".
7. عدّل القالب أو مصدر البيانات الذي ينشئ JSON-LD حتى لا تعود القيمة الخاطئة عند تحديث الصفحة.

### wordpress

1. في Rank Math راجع بيانات النشاط من Titles & Meta → Local SEO، وصحح الاسم والهاتف والعنوان والدولة.
2. في Yoast SEO راجع Settings → Site representation، وصحح اسم المؤسسة وأسماءها البديلة.
3. إذا جاءت القيم من منتج أو إضافة للتجارة الإلكترونية، صحح السعر والعملة والهاتف في بيانات المنتج أو المتجر أولاً.
4. إن بقيت المشكلة، اطلب من مطوّرك فحص المرشح أو القالب الذي يولّد JSON-LD وتوحيد التنسيق فيه.

### shopify

1. صحح السعر والعملة وبيانات النشاط في إعدادات المتجر والمنتجات، ثم اختبر الصفحة لمعرفة ما يولّده القالب.
2. إذا كان JSON-LD مكتوباً في القالب، افتح نسخة احتياطية منه ثم صحح القيم في ملفات Liquid التي تنشئ البيانات المنظّمة.
3. إذا كانت القيم تأتي من تطبيق، عدّل إعداداته أو اطلب من دعمه إخراج الأسعار والعملات وأرقام الهواتف بالصيغة المعيارية.

### salla

ملاحظة المنصة: لا تتيح سلة للتاجر تعديل JSON-LD الخاص بالمتجر مباشرة. صحح الاسم والهاتف والعنوان والدولة في إعدادات المتجر، ثم اطلب من دعم المنصة معالجة القيمة إن استمرت في JSON-LD.

### zid

ملاحظة المنصة: لا تتيح زد للتاجر تعديل JSON-LD الخاص بالمتجر مباشرة. املأ الاسم والهاتف والعنوان والدولة بدقة في إعدادات المتجر، ثم تواصل مع دعم المنصة إذا بقي التنسيق غير الصحيح.

## مثال

### قبل

```json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "عطر الــورد",
  "offers": {
    "@type": "Offer",
    "price": "١٬٢٠٠٫٥٠",
    "priceCurrency": "ر.س"
  },
  "telephone": "0501234567",
  "addressCountry": "السعودية",
  "inLanguage": "en"
}
```

### بعد

```json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "عطر الورد",
  "offers": {
    "@type": "Offer",
    "price": "1200.50",
    "priceCurrency": "SAR"
  },
  "telephone": "+966501234567",
  "addressCountry": "SA",
  "inLanguage": "ar"
}
```

## كيف تتحقق؟

1. اضغط «تحقق الآن» على هذا الإجراء في رانكاوي، فنعيد قراءة الصفحات المتأثرة فوراً.
2. اختبر الصفحة في Schema Markup Validator، وتأكد أن الحقول تعرض القيم المصححة من دون محارف مخفية.
3. افتح Rich Results Test من Google، وتأكد أن السعر والعملة وبقية القيم تظهر كما كتبتها.

## أخطاء شائعة

- تحويل السعر إلى نص منسق مثل "1,200.50 SAR" داخل حقل price.
- استخدام SR أو «ر.س» أو رمز الريال بدلاً من SAR في priceCurrency.
- تصحيح النص الظاهر وترك القيمة القديمة داخل JSON-LD.
- كتابة الهاتف بصيغة محلية مثل 0501234567 من دون رمز الدولة.
- إضافة علامات اتجاه مخفية إلى الاسم كله بدلاً من ضبط اتجاه العرض في HTML.

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

### هل يجب أن يكون السعر نصاً أم رقماً في JSON-LD؟

يمكن أن يكون رقماً أو نصاً رقمياً، لكن استخدم أرقاماً غربية ونقطة عشرية من دون فواصل آلاف، مثل 1200.5 أو "1200.50".

### هل أستطيع عرض السعر بالأرقام العربية الهندية للزائر؟

نعم، يمكنك تنسيق السعر الظاهر في الصفحة بما يناسب جمهورك. اجعل القيمة داخل JSON-LD بالصيغة المعيارية المستقلة عن تنسيق العرض في الصفحة.

### هل ar-SA يطابق lang="ar"؟

نعم، اللغة الأساسية في الحالتين هي العربية. تظهر المشكلة عندما تختلف اللغة الأساسية فعلاً، مثل inLanguage بقيمة en وصفحة يبدأ lang فيها بـ ar.

## طلب جاهز لمساعدك الذكي

استخدم أداتي رانكاوي get_issue_pages و get_actions لقراءة الصفحات المتأثرة بالمشكلة schema-value-format وتفاصيل كل حقل وقيمته. راجع price و lowPrice و highPrice و priceCurrency و name و headline و alternateName و telephone و addressCountry و inLanguage، ثم اكتب لي JSON-LD مصححاً لكل صفحة. استخدم الأرقام الغربية والنقطة العشرية ورموز ISO المناسبة، واحذف المحارف المخفية والتطويل الزخرفي بين الحروف مع إبقاء «هـ» الهجرية والسابقة المتصلة برقم أو كلمة لاتينية، وطابق inLanguage مع <html lang>. لا تعدّل شيئاً في موقعي.
