انتقل إلى المحتوى
SEO Madmanby Adam Hafez
أداة مجانية

فحص ترميز Product لمقتطفات المنتجات

افحص JSON-LD للمنتج وفق قواعد Google لمقتطفات المنتجات: الاسم والعروض والسعر والعملة والتوفر. أداة مجانية تعمل في متصفحك.

تعمل بالكامل في متصفحك. لا يُرفع ما تُدخله، ولا يُسجَّل، ولا يُحفظ.

يُحلَّل النص بـ JSON.parse في متصفحك وفق جداول الخصائص التي توثّقها Google لعنصر Product. ولا يُرسل أي شيء تكتبه.

أهم النقاط

  • توثّق Google الاسم name كالخاصية الوحيدة المطلوبة حصرًا في Product، مع قاعدة تشترط وجود review أو aggregateRating أو offers.
  • يحتاج Offer إلى price، أو priceSpecification.price، وإلى priceCurrency التي توصي Google بكتابتها برمز ISO 4217 من ثلاثة أحرف.
  • أما AggregateOffer فيحتاج بدلًا من ذلك إلى lowPrice وpriceCurrency، مع التوصية بـ highPrice وofferCount.
  • تذكر Google عشر قيم لـ ItemAvailability، منها InStock وOutOfStock وPreOrder وSoldOut، وأي نص آخر ليس قيمة موثّقة.
  • تقرأ الأداة JSON-LD الذي تكتبه فقط، ولا تستطيع التأكد من أن السعر الظاهر في الصفحة يطابق الترميز.

ما تحتاج إليه

  • كائن JSON-LD ملصوق لعنصر Product

أدوات أخرى

كلها مجانية، وكلها تعمل في المتصفح.

تصفّح الأدوات

طريقة الاستخدام

  1. 1الصق JSON-LD للمنتجانسخ محتوى وسم script من النوع application/ld+json الذي يصف المنتج، لا ترميز الصفحة المحيط به.
  2. 2تأكد من الاسم وواحدة من ثلاثأضِف name، ثم واحدة على الأقل من review أو aggregateRating أو offers، وهي التركيبة التي توثّقها Google كمطلوبة.
  3. 3أكمِل Offerأضِف price وpriceCurrency من ثلاثة أحرف. ولنطاق أسعار استخدم AggregateOffer مع lowPrice بدلًا من ذلك.
  4. 4استخدم قيمة توفر موثّقةاختر من قيم ItemAvailability العشر التي تذكرها Google، لا ملاحظة نصية حرة عن المخزون.
  5. 5اكتب priceValidUntil كتاريخاكتبه بصيغة ISO 8601 مثل 2026-12-31، ثم أعِد الفحص لترى الخصائص الموصى بها التي ما زالت مفقودة.

الصق JSON-LD لعنصر Product من صفحة منتج، وستفحصه الأداة وفق جداول الخصائص في مستندات Google عن مقتطفات المنتجات.

وهي تحلّله بـ JSON.parse في متصفحك، فيظهر أي خطأ في الصياغة قبل فحص الخصائص، ولا يغادر أي شيء تلصقه متصفحك.

ماذا تفحص الأداة؟

  • عقدة Product. تبحث الأداة في الكائن الواحد أو المصفوفة أو قائمة @graph عن أول عقدة قيمة @type فيها Product. وإن لم تجدها، تتوقف بمشكلة واحدة.
  • name. توثّق Google الاسم كخاصية مطلوبة في Product.
  • واحدة من review أو aggregateRating أو offers. تشترط Google وجود واحدة على الأقل من الثلاث. وتظهر كل منها أيضًا وحدها كموجودة أو مفقودة، كمعلومة.
  • price وpriceCurrency في Offer. تشترط Google في Offer وجود price (أو priceSpecification.price) وpriceCurrency، مع التوصية بكتابة العملة برمز ISO 4217 من ثلاثة أحرف.
  • lowPrice وpriceCurrency في AggregateOffer. إذا كانت قيمة @type في العرض AggregateOffer، تطبّق الأداة جدوله بدلًا من ذلك، وlowPrice وpriceCurrency مطلوبتان.
  • availability. حين توجد، يجب أن تنتهي بإحدى قيم ItemAvailability العشر التي تذكرها Google: InStock وOutOfStock وPreOrder وBackOrder وDiscontinued وLimitedAvailability وInStoreOnly وOnlineOnly وPreSale وSoldOut.
  • صيغ availability المقبولة. تنجح الصيغة الكاملة https://schema.org/InStock والكلمة وحدها.
  • priceValidUntil. حين توجد، يجب أن تبدأ بتاريخ بصيغة ISO 8601 مثل 2026-12-31.

كيف تقرأ النتائج؟

يحمل كل صف واحدة من أربع تسميات. مشكلة تعني أن شرطًا موثّقًا غير مستوفى: لا عقدة Product، أو لا اسم، أو لا واحدة من الخصائص الثلاث، أو غياب price أو lowPrice أو priceCurrency.

تحذير يعني أن القيمة موجودة لكن ليست بالصيغة الموثّقة، مثل رمز عملة أو ملاحظة نصية عن المخزون. معلومة تعني أن خاصية موصى بها غائبة. وناجح يعني أن الفحص مستوفى. صحّح المشكلات أولًا، ثم التحذيرات.

وحين تكون offers مصفوفة، تقرأ الأداة العرض الأول فقط، فأعِد الفحص مع وضع كل عرض في المقدمة إذا اختلفت العروض.

مثال عملي

تبدأ الأداة بعنصر Product اسمه Trail running shoe، له صورة وعرض Offer واحد: price بالقيمة “89.00”، وpriceCurrency بالقيمة “USD”، وavailability بالقيمة https://schema.org/InStock، وpriceValidUntil بالقيمة “2026-12-31”. والنتائج:

  • @type هو Product، وname، وoffers: ناجح.
  • aggregateRating وreview: معلومة، مفقود.
  • واحدة من review أو aggregateRating أو offers: ناجح، offers.
  • price في Offer: ناجح. priceCurrency في Offer: ناجح، USD.
  • availability وpriceValidUntil: ناجح.

غيّر priceCurrency إلى $ فيتحول ذلك الصف إلى تحذير. واحذف كتلة offers كلها فيصبح صف الخصائص الثلاث مشكلة، مع عبارة لا توجد أي منها، لأن العقدة صار فيها اسم فقط.

وتنبّه Google أيضًا إلى أن اختبار النتائج الغنية بصريًا قد يحذّر من offers دون review أو aggregateRating، وهي حال هذا المثال.

أخطاء شائعة تكشفها

  • Product باسم فقط. JSON صالح، و@type صحيح، ولا مراجعة ولا تقييم ولا عرض: الحد الأدنى الموثّق غير مستوفى.
  • نطاق أسعار مكتوب كـ Offer. العرض AggregateOffer الذي يحمل price بدل lowPrice يفشل في فحص lowPrice.
  • ملاحظات مخزون نصية. عبارة مثل “In stock” أو “Available” ليست من قيم ItemAvailability العشر، فتظهر كتحذير.
  • صيغ تاريخ محلية. قيمة priceValidUntil مثل 12/31/2026 ليست تاريخًا بصيغة ISO 8601.
  • رموز العملات. $ أو € في priceCurrency بدل رمز من ثلاثة أحرف.

وما لا تستطيع الأداة فحصه: إن كان السعر في الترميز يطابق السعر الظاهر في الصفحة، وإن كانت الصفحة تركز على منتج واحد، وإن كان تاريخ priceValidUntil قد مضى.

أدوات وقراءات ذات صلة

المصادر

  1. 1.Product snippet (Product, Review, Offer) structured data، Google Search Centralمصدر أساسي

أسئلة شائعة

هل offers مطلوبة لمقتطف المنتج؟

ليس وحدها. تقول Google إنك تحتاج إلى واحدة فقط من review وaggregateRating وoffers، لكنها تنبّه إلى أن اختبار النتائج الغنية بصريًا قد يعرض تحذيرًا إذا قدّمت offers دون review أو aggregateRating.

هل تغطي الأداة النتائج الغنية لبيانات التاجر؟

لا. تطبّق الأداة مستندات مقتطفات المنتجات فقط، ولها جداول خصائص أصغر. وتحيل Google المواقع التجارية التي يشتري منها الناس المنتج إلى مستنداتها المنفصلة عن بيانات التاجر.

هل يمكن أن يكون JSON-LD داخل @graph؟

نعم. تبحث الأداة في الكائن الواحد أو المصفوفة أو قائمة @graph عن أول عقدة قيمة @type فيها Product.

لماذا تُرصد priceCurrency عندي كتحذير؟

تتوقع الأداة ثلاثة أحرف كبيرة، وهي صيغة ISO 4217 التي توصي بها Google، مثل USD أو EUR. أما رمز مثل $ أو رمز بأحرف صغيرة مثل usd فموجود لكن ليس بتلك الصيغة، فيظهر كتحذير لا كنجاح.

هل يهم انتهاء تاريخ priceValidUntil؟

قد يهم. تقول Google إن مقتطف المنتج قد لا يظهر إذا أشار priceValidUntil إلى تاريخ مضى. وتتأكد الأداة فقط من أن القيمة تبدأ بتاريخ YYYY-MM-DD، ولا تقارنه باليوم، فافحص التاريخ بنفسك.

هل أستخدم ترميز Product في صفحة تصنيف؟

تقول Google إن النتائج الغنية للمنتجات تدعم الصفحات التي تركز على منتج واحد فقط. وصفحة التصنيف أو القائمة التي تضم منتجات كثيرة ليست نوع الصفحة الذي وُثّق له هذا الترميز.