سمات البيانات المنظّمة وقيمها المسموح بها

استخدِم ترميز البيانات المنظّمة على الصفحات المقصودة لمنتجاتك من أجل مساعدة Google في العثور على معلومات محدّثة عن منتجاتك وعروضك من موقعك الإلكتروني مباشرةً. ثمة سمات وقيم مقبولة لكلّ ترميز بيانات منظّمة متاح في Merchant Center، كما هو مذكور في مواصفات بيانات المنتجات. ويجب أن تتم مطابقة البيانات المنظّمة مع القيم والسمات الموافقة لها.

بعض السمات غير مسموح بها حاليًا في schema.org.

في هذه الصفحة

السمات والتعليقات التوضيحية في schema.org

السمات هي إحدى الطرق التي يتم من خلالها تنظيم بيانات المنتجات التي ترسلها إلى Merchant Center. وتتضمن كل سمة معلومة واحدة حول المنتج، مثل عنوانه أو وصفه. تؤدي المطابقة الدقيقة بين قيمة schema.org وسمات مواصفات بيانات المنتج الموافقة لها إلى انخفاض عدد الأخطاء عند التحقّق من الخلاصة.

ملاحظة: إذا كنت تستخدم ميزة "تعديلات تلقائية على بيانات السلع"، احرص على تحديد السمات المعرَّفة التالية من schema.org لزيادة مستوى دقتها: price وpriceCurrency وavailability وcondition. مزيد من المعلومات حول كيفية السماح لخدمة Merchant Center بتعديل معلومات المنتج تلقائيًا

السمة في بيانات المنتج

السمة المعرَّفة من schema.org

النوع والوصف
تندرج السمات التالية ضِمن النوع Product في schema.org

id

نص

title

نص

description

نص

image_link

عنوان URL

item_group_id

نص

يكون رمز التخزين التعريفي الأساسي مطلوبًا لتجميع كل خيارات المنتج التي تنتمي إلى مجموعة المنتجات نفسها معًا.

gtin

نص

رقم GTIN الذي يعرّف منتجك بشكل فريد

حدِّد سمة واحدة فقط من سمات schema.org المعرَّفة.

إذا استخدمت قيم GTIN، يجب أن تتضمّن عدد الأرقام الصحيح ورقم الاختبار الصحيح.

material

نص

pattern

نص

mpn

نص

brand

نص

استخدِم السمة brand لتحديد عنصر Brand الذي يحدد العلامة التجارية من خلال السمة name.

gender

نص

استخدِم السمة audience لتحديد عنصر PeopleAudience الذي يحدد الجنس باستخدام السمة suggestedGender. القيم الصالحة هي تلك التي تحدّدها السمة gender:

male

female

unisex

age_group

وكذلك

رقم (بالسنوات)

استخدِم السمة audience لتحديد عنصر PeopleAudience الذي يحدد الفئة العمرية باستخدام السمتَين suggestedMinAge (أو suggestedAge.minValue) وsuggestedMaxAge (أو suggestedAge.maxValue).

القيم الصالحة هي تلك التي تحدّدها السمة age_group:

مواصفات البيانات قيمة schema.org
 

suggestedMinAge أو suggestedAge.minValue

newborn 0
infant 0.25
toddler 1.0
kids 5.0
adult 13
مواصفات البيانات قيمة schema.org
  suggestedMaxAge أو suggestedAge.maxValue
newborn 0.25
infant 1.0
toddler 5.0
kids 13.0
adult غير محدّدة

color

نص

size

أو

نص

استخدِم السمة size لتحديد قيمة نصية أو عنصر SizeSpecification الذي يحدّد المقاس من خلال السمة name. يجب استخدام العنصر SizeSpecification عند تحديد sizeGroup و/أو sizeSystem.

size_type

نص

استخدِم السمة size لتحديد عنصر SizeSpecification الذي يحدّد نوع المقاس من خلال السمة sizeGroup.

يجب أن تكون القيم من النوع WearableSizeGroupEnumeration لتُعتبر صالحة. يمكن تحديد قيمتَين بحدّ أقصى. ويتم ربط هذه القيم بقيم الخلاصة على الشكل التالي:

مواصفات البيانات قيمة schema.org
big

WearableSizeGroupBig

maternity

WearableSizeGroupMaternity

petite

WearableSizeGroupPetite

plus

WearableSizeGroupPlus

regular

WearableSizeGroupRegular

tall

WearableSizeGroupTall

size_system

نص

استخدِم السمة size لتحديد عنصر SizeSpecification الذي يحدّد نظام المقاسات من خلال السمة sizeSystem.

يجب أن تكون القيم من النوع WearableSizeSystemEnumeration لتُعتبر صالحة. ويتم ربط هذه القيم بقيم الخلاصة على الشكل التالي:

مواصفات البيانات قيمة schema.org
AU

WearableSizeSystemAU

BR

WearableSizeSystemBR

CN

WearableSizeSystemCN

DE

WearableSizeSystemDE

EU

WearableSizeSystemEurope

FR

WearableSizeSystemFR

IT

WearableSizeSystemIT

JP

WearableSizeSystemJP

MEX

WearableSizeSystemMX

UK

WearableSizeSystemUK

US

WearableSizeSystemUS

product_length

value: رقم
unitCode / unitText: نص

استخدِم السمة depth لتحديد عنصر QuantitativeValue الذي يحدّد طول المنتج باستخدام السمة value ويحدّد الأبعاد باستخدام السمة unitCode (رمز UN/CEFACT: ‏"CMT" أو "INH") أو unitText ("cm" أو "in").

product_width

value: رقم
unitCode / unitText: نص

استخدِم السمة width لتحديد عنصر QuantitativeValue الذي يحدّد عرض المنتج باستخدام السمة value ويحدّد الأبعاد باستخدام السمة unitCode (رمز UN/CEFACT:‏ "CMT" أو "INH") أو unitText ("cm" أو "in").

product_height

value: رقم
unitCode / unitText: نص

استخدِم السمة height لتحديد عنصر QuantitativeValue الذي يحدّد طول المنتج باستخدام السمة value ويحدّد الأبعاد باستخدام السمة unitCode (رمز UN/CEFACT: ‏"CMT" أو "INH") أو unitText (وحدة الخلاصة "cm" أو "in").

product_weight

value: رقم
unitCode / unitText: نص

استخدِم السمة weight لتحديد عنصر QuantitativeValue الذي يحدّد وزن المنتج باستخدام السمة value ويحدّد الأبعاد باستخدام السمة unitCode (رمز UN/CEFACT:‏ LBR أو ONZ أو KGM أو GRM) أو السمة unitText‏ (lb أو oz أوkg أو g).

تندرج السمات المعرَّفة التالية من schema.org ضمن النوع Offer ويجب دمجها في Product باستخدام السمة offers (اطّلِع على الأمثلة أدناه).

link

عنوان URL صالح يؤدي إلى منتجك

price

sale_price

أو:

price: رقم يتم إرساله بدون رموز العملات أو فواصل الآلاف أو مسافات (على سبيل المثال، 1498.99)

priceCurrency: نص يتم إرساله وفقًا لتنسيق ISO 4217 الذي يستخدم ثلاثة أحرف للعملات (على سبيل المثال، USD وGBP وEUR)، ويجب أن تستوفي العملة متطلبات اللغة والعملة للبلد المستهدف

ملاحظة: يمكن تقديم السمتَين price وpriceCurrency مباشرةً ضمن السمة Offer أو بشكل غير مباشر عبر السمة priceSpecification من النوع UnitPriceSpecification.

عند تحديد قيمة السمة sale_price، يجب تقديم price باستخدام السمة priceSpecification مع priceSpecification.priceType="StrikethroughPrice".

يمكن تحديد السمة sale_price مباشرةً ضمن سمة العرض Offer أو من خلال السمة priceSpecification من النوع UnitPriceSpecification بدون priceSpecification.priceType.

availability

يجب أن تكون القيم من النوع ItemAvailability لتُعتبر صالحة. ويتم ربطها بقيم الخلاصة على الشكل التالي:

مواصفات البيانات قيمة schema.org
in_stock

InStock

LimitedAvailability

OnlineOnly

out_of_stock

Discontinued

InStoreOnly

OutOfStock

SoldOut

preorder

PreOrder

PreSale

backorder

BackOrder

condition

يجب أن تكون القيم من النوع OfferItemCondition لتُعتبر صالحة. ويتم ربطها بقيم الخلاصة على الشكل التالي:

مواصفات البيانات قيمة schema.org
new

NewCondition

refurbished

RefurbishedCondition

used

DamagedCondition

UsedCondition

checkout_link_template

عنوان URL صالح للدفع مقابل منتجك

أمثلة باستخدام JSON-LD

منتج واحد

مثال

يعرض المثال التالي منتجًا أساسيًا يتضمّن أقل عدد من السمات.

{
"@context": "https://schema.org/",
  "@type": "Product",
  "sku": "trinket-12345",
  "image": "https://www.example.com/trinket.jpg",
  "name": "Nice trinket",
  "description": "Trinket with clean lines",
  "gtin": "12345678901234",
  "brand": {
    "@type": "Brand",
    "name": "MyBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/trinket_offer",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": 39.99,
    "priceCurrency": "USD"

  }
}

يوضّح المثال التالي كيفية تحديد نوع المقاس ونظام المقاسات باستخدام schema.org. يحدّد المثال المقاس "XL" في نظام المقاسات المتّبَع في الولايات المتحدة لقميص أزرق بأكمام قصيرة للبالغين (الفئة العمرية 13 سنة وأكثر) في قسم الأزياء "Big&Tall" للرجال.

{
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "12345",
    "image": "https://www.example.com/tshirt.jpg",
    "name": "Classic T-Shirt",
    "description": "All-cotton t-shirt in classic cut",
    "gtin": "12345678901234",
    "brand": {
      "@type": "Brand",
      "name": "MyBrand"
    },
    "material": "cotton",
    "color": "blue",
    "size": {
      "@type": "SizeSpecification",
      "name": "XL",
      "sizeSystem": "https://schema.org/WearableSizeSystemUS",
      "sizeGroup": [ 
         "https://schema.org/WearableSizeGroupBig",
         "https://schema.org/WearableSizeGroupTall" 
      ]
    },
    "audience": {
      "@type": "PeopleAudience",
      "suggestedGender": "male",
      "suggestedMinAge": 13
    },
    "offers": {
      "@type": "Offer",
      "url": "https://www.example.com/tshirt",
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock",
      "price": 24.99,
      "priceCurrency": "USD"
    }
  }

 

منتجات متعددة غير مرتبطة ببعضها البعض مُدرجة على صفحة مقصودة واحدة

إذا كانت الصفحة تتضمّن منتجات متعددة غير مرتبطة ببعضها البعض، وكان كل منتج يتضمّن التعليق التوضيحي الخاص به للبيانات المنظّمة، يجب أن يتضمّن كل تعليق توضيحي معلومات تحدّد المنتج الذي تشير إليه.

على سبيل المثال، ننصحك بتقديم رمز التخزين التعريفي (سمة المعرّف [id]) أو رقم GTIN (سمة [gtin]) في كلّ تعليق توضيحي. في حال عدم تقديم هذه المعلومات، قد لا تتمّ مطابقة المنتجات في صفحتك المقصودة مع بيانات المنتجات المنظّمة. مزيد من المعلومات حول إعداد بيانات منظّمة على الصفحات المقصودة

مثال

[
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "trinket-12345",
    "image": "https://www.example.com/trinket.jpg",
    "name": "Nice trinket",
    "description": "Trinket with clean lines",
    "gtin": "12345678901234",
    "brand": {
      "@type": "Brand",
      "name": "MyBrand"
    },
    "offers": {
      "@type": "Offer",
      "url": "https://www.example.com/trinket_offer",
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock",
      "price": 39.99,
      "priceCurrency": "USD"
    }
  },
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "racket-12345",
    "image": "https://www.example.com/racket.jpg",
    "name": "Nice racket",
    "description": "Racket for Tennis",
    "gtin": "12345678901235",
    "brand": {
      "@type": "Brand",
      "name": "MyBrand"
    },
    "offers": {
      "@type": "Offer",
      "url": "https://www.example.com/racket_offer",
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock",
      "price": 59.99,
      "priceCurrency": "USD"
    }
  }
]

أسعار المنتجات بالجملة

عند تطبيق السعر بالجملة على منتج، ننصحك بوضع إجمالي سعر العرض مباشرةً في التعليق التوضيحي للمخطط. يوضّح المثال التالي أنّه إذا تم بيع 3 وحدات كحدّ أدنى بسعر ‎$2 USD لكل وحدة، سيكون السعر الإجمالي ‎$6 USD (السعر الإجمالي للحدّ الأدنى للكمية التي يمكن شراؤها):

مثال

{

  "offers": {

    "@type": "Offer",

    "url": "https://www.example.com/Product/Detail/S-123",

    "availability": "http://schema.org/InStock",

    "priceCurrency": "USD",

    "price": "6.00" 

  }

}

السعر المخفَّض

يعرض المثال التالي منتجًا أساسيًا بسعر مخفَّض. للإشارة إلى السعر المخفَّض، يجب أيضًا تحديد السعر الأصلي من المصنع باستخدام السمة ‎/priceType.

مثال

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "trinket-12345",
  "image": "https://www.example.com/trinket.jpg",
  "name": "Nice trinket",
  "description": "Trinket with clean lines",
  "gtin": "12345678901234",
  "brand": {
    "@type": "Brand",
    "name": "MyBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/trinket_offer",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": 10.00,
    "priceCurrency": "USD",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "priceType": "https://schema.org/StrikethroughPrice",
      "price": 15.00,
      "priceCurrency": "USD"
    }
  }
}


If a /UnitPriceSpecification is also used for the non sale-price, the encoding simply contains two /UnitPriceSpecifications:

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "trinket-12345",
  "image": "https://www.example.com/trinket.jpg",
  "name": "Nice trinket",
  "description": "Trinket with clean lines",
  "gtin": "12345678901234",
  "brand": {
    "@type": "Brand",
    "name": "MyBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/trinket_offer",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "priceSpecification": [
      {
        "@type": "UnitPriceSpecification",
        "price": 10.00,
        "priceCurrency": "USD"
      },
      {
        "@type": "UnitPriceSpecification",
        "priceType": "https://schema.org/StrikethroughPrice",
        "price": 15.00,
        "priceCurrency": "USD"
      }
    ]
  }
}

السعر المخصّص للمشتركين

توضّح الأمثلة التالية ترميز الأسعار الخاصة بالمشتركين. للإشارة إلى سعر خاص بالمشتركين، استخدِم validForMemberTier في البيانات المنظّمة.

ملاحظة: بالنسبة إلى مستويات الاشتراك المحدَّدة أو تلك التي تتضمّن أسعارًا مختلفة للمشتركين، احرص على استخدام سمة "برنامج الولاء" [loyalty_program] في خلاصة بيانات منتجاتك. مزيد من المعلومات حول برامج الولاء

أمثلة

في المثال الأول، تم تحديد السعر النشط باستخدام السمة "السعر" على مستوى العرض، وتم تحديد السعر المخصّص للمشتركين في واحدة من مواصفات السعر المشار إليها باستخدام السمة validForMemberTier:

"offers": {
  "@type": "Offer",
  "url": "https://www.example.com/trinket_offer",
  "price": 10.00,
  "priceCurrency": "GBP",
  "priceSpecification": {
    "@type": "UnitPriceSpecification",
    "price": 8.00,
    "priceCurrency": "GBP",
    "validForMemberTier": {
      "@type": "MemberProgramTier",
      "@id": "https://www.example.com/com/members#tier_gold"
    }
  }
}

يعرض المثال الثاني السعر النشط والسعر المخصّص للمشتركين، وقد تم ترميز كليهما باستخدام مواصفات السعر:

"offers": {
  "@type": "Offer",
  "url": "https://www.example.com/trinket_offer",
  "priceSpecification": [
    {
      "@type": "UnitPriceSpecification",
      "price": 10.00,
      "priceCurrency": "GBP"
    },
    {
      "@type": "UnitPriceSpecification",
      "price": 8.00,
      "priceCurrency": "GBP",
      "validForMemberTier": {
        "@type": "MemberProgramTier",
        "@id": "https://www.example.com/com/members#tier_gold"
      }
    }
  ]
}

يوضّح المثال الثالث كيفية ترميز سعر مخفَّض وسعر أصلي مشطوب وأسعار مخصّصة للمشتركين في عدة فئات ضمن برنامج الولاء، وكل ذلك ضمن عرض واحد:

"offers": {
  "@type": "Offer",
  "url": "https://www.example.com/trinket_offer",
  "priceSpecification": [
    {
      "@type": "UnitPriceSpecification",
      "price": 9.00,
      "priceCurrency": "GBP"
    },
    {
      "@type": "UnitPriceSpecification",
      "priceType": "https://schema.org/StrikethroughPrice",
      "price": 10.00,
      "priceCurrency": "GBP"
    },
    {
      "@type": "UnitPriceSpecification",
      "price": 8.00,
      "priceCurrency": "GBP",
      "validForMemberTier": {
        "@type": "MemberProgramTier",
        "@id": "https://www.example.com/com/members#tier_silver"
      }
    },
    {
      "@type": "UnitPriceSpecification",
      "price": 7.00,
      "priceCurrency": "GBP",
      "validForMemberTier": [
        {
          "@type": "MemberProgramTier",
          "@id": "https://www.example.com/com/members#tier_gold"
        },
        {
          "@type": "MemberProgramTier",
          "@id": "https://www.example.com/com/members#tier_platinum"
        }
      ]
    }
  ]
}

في المثال الرابع، تُظهر مواصفات السعر المخصّص للمشتركين نقاط اشتراك بدلاً من سعر مخصّص للمشتركين:

"offers": {
  "@type": "Offer",
  "url": "https://www.example.com/trinket_offer",
  "price": 10.00,
  "priceCurrency": "GBP",
  "priceSpecification": {
    "@type": "UnitPriceSpecification",
    "membershipPointsEarned": 20,
    "validForMemberTier": {
      "@type": "MemberProgramTier",
      "@id": "https://www.example.com/com/members#tier_gold"
    }
  }
}

الشحن

لتحديد تكاليف الشحن لمنتجك (ننصح به)، استخدِم النوع OfferShippingDetails في Schema.org، ويجب أن يكون مدمجًا في عرض يستخدم السمة shippingDetails وأن يرتبط بالسمة shipping في مواصفات بيانات المنتجات. يمكن توفير سمات shippingDetails متعدّدة.

السمة في بيانات المنتج

السمة المعرَّفة من schema.org

النوع والوصف
تندرج السمات التالية ضِمن النوع OfferShippingDetails في schema.org.

shipping.country

نص

رمز البلد المكوّن من رقمَين وفقًا لمعيار ISO 3166-1

استخدِم السمة shippingDestination لتحديد عنصر DefinedRegion الذي يحدّد بلد الشحن من خلال السمة addressCountry.

shipping.region

نص

رمز تقسيم فرعي يتألف من رقمَين أو ثلاثة أرقام وفقًا لمعيار ISO 3166-2، بدون بادئة البلد. يُسمَح به في الولايات المتحدة أو أستراليا أو اليابان فقط. على سبيل المثال: "NY" أو "NSW" أو "03".

استخدِم السمة shippingDestination لتحديد عنصر DefinedRegion الذي يحدّد منطقة الشحن من خلال السمة addressRegion. استخدِم السمة shippingDestination نفسها لتحديد addressRegion على النحو الذي تُستخدَم به لتحديد addressCountry.

shipping.price

value: رقم بدون رموز العملات أو فواصل الآلاف أو مسافات (مثل 1498.99).

currency: نص يتم إرساله بتنسيق ISO 4217 ذي الأحرف الثلاثة (مثل "USD" و"SAR" و"AED"). يجب أن تكون العملة هي نفسها العملة المستخدَمة في سعر العرض.

استخدِم السمة shippingRate لتحديد عنصر MonetaryAmount الذي يحدّد السمتَين value وcurrency.

shipping.min_handling_time

shipping.max_handling_time

shipping.min_transit_time

shipping.max_transit_time

رقم (عدد صحيح غير سالب)

تحدّد هذه السمة الحد الأدنى والأقصى لعدد أيام العمل المطلوبة لمعالجة طلب وشحنه. يحدّد وقت المناولة الفترة بين تقديم الطلب ووقت تسليمه إلى شركة شحن. تحدّد مدة النقل الفترة بين وقت تسليم المنتج إلى شركة الشحن ووقت تسليمه إلى العميل.

استخدِم السمة deliveryTime لتحديد عنصر ShippingDeliveryTime الذي يحدّد السمتَين handlingTime وtransitTime من النوع QuantitativeValue. استخدِم السمتَين minValue وmaxValue ضمن QuantitativeValue لتحديد الحد الأدنى والأقصى لأيام العمل على التوالي.

مثال

يوضّح المثال التالي كيفية تحديد معلومات الشحن باستخدام schema.org. يحدّد المثال تكلفة شحن بقيمة 3.49 دولار أمريكي لولايات كاليفورنيا ونيفادا وأريزونا في الولايات المتحدة. ويتراوح وقت المناولة بين 0 ويوم عمل واحد، كما تتراوح مدة النقل بين يوم عمل واحد و5 أيام عمل.

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "trinket-12345",
  "gtin": "12345678901234",
  "image": "https://www.example.com/trinket.jpg",
  "name": "Nice trinket",
  "description": "Trinket with clean lines",
  "brand": {
    "@type": "Brand",
    "name": "MyBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/trinket_offer",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": 39.99,
      "priceCurrency": "USD"
    },
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "US",
        "addressRegion": [ "CA", "NV", "AZ" ]
      },
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": 3.49,
        "currency": "USD"
      },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": {
          "@type": "QuantitativeValue",
          "minValue": 0,
          "maxValue": 1,
    "unitCode": "DAY"
        },
        "transitTime": {
          "@type": "QuantitativeValue",
          "minValue": 1,
          "maxValue": 5,
    "unitCode": "DAY"
        }
      }
    }
  }

المرتجعات

لتحديد مهلة إرجاع المشتريات وتكلفة منتجك، استخدِم النوع MerchantReturnPolicy في Schema.org، ويجب أن يكون مدمجًا في النوع Offer باستخدام السمة hasMerchantReturnPolicy.

مع أنّ السمة MerchantReturnPolicy لا يمكن تطبيقها إلا على العروض التي تم الزحف إليها ولا تقابلها أي سمة في مواصفات بيانات المنتج، عليك استخدام سمة "تصنيف سياسة الإرجاع" [return_policy_label] في خلاصة منتجاتك إذا حمّلْت مستودعك يدويًا. كيفية إعداد سمة تصنيف سياسة الإرجاع [return_policy_label]

السمة المعرَّفة من schema.org

النوع والوصف
تندرج السمات المعرَّفة التالية من schema.org ضمن السمة MerchantReturnPolicy ويجب دمجها في منتج باستخدام السمة offers (اطّلِع على الأمثلة أدناه).
applicableCountry

النصّ

رمز البلد المكوّن من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2 (على سبيل المثال، US)

رمز البلد المكوّن من ثلاثة أحرف وفقًا لمعيار ISO 3166-1 alpha-3 (على سبيل المثال، USA)

تمثّل هذه السمة البلد الذي تنطبق عليه سياسة الإرجاع لتاجر معيّن. يمكن أن يختلف هذا البلد عن البلد الذي تم شحن المنتج منه. ويمكن تحديد ما يصل إلى 50 بلدًا.

returnPolicyCategory

يجب أن تكون القيم من النوع MerchantReturnEnumeration لتُعتبر صالحة.

  • MerchantReturnFiniteReturnWindow
  • MerchantReturnNotPermitted
  • MerchantReturnUnlimitedWindow

إذا تم تحديد السمة على أنّها MerchantReturnFiniteReturnWindow أو MerchantReturnUnlimitedWindow يُنصح باستخدام السمتَين returnMethod وreturnShippingFeesAmount. بالإضافة إلى ذلك، إذا تم تحديد هذه السمة على أنّها MerchantReturnFiniteReturnWindow، يجب استخدام السمة merchantReturnDays.

merchantReturnDays

Integer

تمثّل هذه السمة عدد الأيام التي يمكن خلالها إرجاع المنتج (بدءًا من تاريخ التسليم).

returnMethod

يجب أن تكون القيم من النوع ReturnMethodEnumeration لتُعتبر صالحة:

  • ReturnAtKiosk
  • ReturnByMail
  • ReturnInStore
returnFees إنّ القيمة الصالحة من النوع ReturnFeesEnumeration هي FreeReturn.
returnShippingFeesAmount

MonetaryAmount

تقدّم هذه القيمة معلومات عن تكلفة الشحن لعمليات إرجاع المنتجات.

مثال

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "trinket-12345",
  "gtin": "12345678901234",
  "image": "https://www.example.com/trinket.jpg",
  "name": "Nice trinket",
  "description": "Trinket with clean lines",
  "brand": {
    "@type": "Brand",
    "name": "MyBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/trinket_offer",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": 39.99,
      "priceCurrency": "USD"
    },
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": 2.99,
        "currency": "USD"
      },
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "US"
      },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": {
          "@type": "QuantitativeValue",
          "minValue": 0,
          "maxValue": 1,
          "unitCode": "DAY"
        },
        "transitTime": {
          "@type": "QuantitativeValue",
          "minValue": 1,
          "maxValue": 5,
          "unitCode": "DAY"
        }
      }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "US",
      "returnPolicyCategory":  "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 60,
      "returnMethod": "https://schema.org/ReturnByMail",
      "returnFees": "https://schema.org/FreeReturn"
    }
  }
}

كفاءة استهلاك الطاقة

يتوافق Schema.org مع تصنيف كفاءة استهلاك الطاقة للمنتجات باستخدام النوع EnergyConsumptionDetails الذي يمكن تحديده لمنتج يستخدم السمة hasEnergyConsumptionDetails.

السمة في بيانات المنتج

  • السمة المعرَّفة من schema.org
النوع والوصف
تندرج سمات schema.org التالية ضمن النوع EnergyConsumptionDetails.

energy_efficiency_class

يجب أن تكون القيم من النوع EUEnergyEfficiencyEnumeration في schema.org لتُعتبر صالحة. ويمكنك استخدام جدول ربط القيم الوارد تحت هذا الجدول.

min_energy_efficiency_class

يتم تحديدها ضِمن نوع البيانات EnergyConsumptionDetails. يتم تحديد القيمة باستخدام جدول التعيين العادي لسمة energy_efficiency_class. في حال حذف هذه القيمة مع توفير قيمة energy_efficiency_class، سيتم تلقائيًا استخدام القيمة EUEnergyEfficiencyCategoryG.

max_energy_efficiency_class

يتم تحديدها ضِمن نوع البيانات EnergyConsumptionDetails. يتم تحديد القيمة باستخدام جدول التعيين العادي لسمة energy_efficiency_class. في حال حذف هذه القيمة مع توفير قيمة لسمة energy_efficiency_class، سيتم تلقائيًا استخدام القيمة EUEnergyEfficiencyCategoryA3Plus.

تندرج قيم energyEfficiencyScale وenergyEfficiencyScaleMin وenergyEfficiencyScaleMax ضِمن نوع التعداد EUEnergyEfficiencyEnumeration في schema.org ويتم ربطها بقيم سمات كفاءة استهلاك الطاقة الثلاث في مواصفات بيانات المنتج على النحو التالي.

مثال

يوضّح المثال التالي كيفية تحديد معلومات كفاءة استهلاك الطاقة باستخدام schema.org. ويحدّد المثال فئة كفاءة استهلاك الطاقة "C" في الاتحاد الأوروبي لسخّان مياه، وفقًا لمقياس من "+A" إلى "F".

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "1234-5678",
  "image": "https://www.example.com/waterheater.jpg",
  "name": "Water heater",
  "description": "Large capacity water heater",
  "gtin": "12345678901231",
  "mpn": "WH1234",
  "brand": {
    "@type": "Brand",
    "name": "ExampleWaterHeaterBrand"
  }, 
  "hasEnergyConsumptionDetails": {
    "hasEnergyEffiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
    "energyEffiencyScaleMax":
"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
    "energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF"
  },

  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/hotwaterheater",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": 1799.00,
    "priceCurrency": "EUR"
  }
}

سعر الوحدة

يتوافق Schema.org مع أسعار وحدات المنتجات باستخدام السمة referenceQuantity ضمن النوع UnitPriceSpecification، الذي يتم توفيره باستخدام السمة priceSpecification في العرض. عند تحديد سعر الوحدة، يجب أيضًا تحديد سعر المنتج وعملته باستخدام السمة priceSpecification (بدلاً من استخدام السمتَين price وpriceCurrency مباشرةً في العرض).

السمة في بيانات المنتج

السمة المعرَّفة من schema.org

النوع والوصف
  تندرج السمات المعرَّفة التالية من schema.org ضِمن النوع UnitPriceSpecification.  

  unit_pricing_measure

  value: رقم
unitCode / unitText: نص

حدِّد مقياس تسعير الوحدات باستخدام السمة referenceQuantity من النوع QuantitativeValue ضمن عنصر UnitPriceSpecification المستخدَم لتحديد سعر العرض.

استخدِم السمة value والسمة unitCode (رمز UN/CEFACT) أو unitText لتحديد القيمة ووحدة مقياس تسعير الوحدات. يُرجى الرجوع إلى المقالة حول السمة unit_pricing_measure للاطّلاع على القيم والوحدات المسموح بها.  

unit_pricing_base_measure

value: رقم
unitCode / unitText: نص

حدِّد المقياس الأساسي لتسعير الوحدات باستخدام السمة valueReference من النوع QuantitativeValue ضمن عنصر QuantitativeValue المستخدَم لتحديد مقياس تسعير الوحدات.

استخدِم السمة value والسمة unitCode (رمز UN/CEFACT) أو unitText لتحديد القيمة ووحدة مقياس تسعير الوحدات. يُرجى الرجوع إلى المقالة حول السمة unit_pricing_base_measure للاطّلاع على القيم والوحدات المسموح بها.

مثال

يوضّح المثال التالي سعرًا بقيمة 3.99 ريال سعودي لكيس أرز وزنه 5 كيلوغرام مع سعر موحّد مفضّل لكل كيلوغرام. يعني ذلك أنّ المنتج قد يظهر للمستهلكين بسعر وحدة يبلغ 0.80 ريال سعودي/الكيلو.

 {
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "basrice12345",
  "image": "https://www.example.com/rice.jpg",
  "name": "Basmati rice",
  "description": "Large bag of Organic Basmati white rice, 5 Kilogram",
  "gtin": "12345678901231",
  "brand": {
    "@type": "Brand",
    "name": "ExampleRiceBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/basrice1kg",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": 3.99,
      "priceCurrency": "EUR",
      "referenceQuantity": {
        "@type": "QuantitativeValue",
        "value": 5,
        "unitCode": "KGM",
        "valueReference": {
          "value": 1,
          "unitCode": "KGM"
        }
      }
    }
  }
}

اختبار الترميز

يمكنك اختبار تنفيذ schema.org باستخدام أداة النتائج الغنية بصريًا (من خلال مراجعة تقارير البيانات المنظّمة "بيانات التجار"). ويمكنك الانتقال إلى مركز مساعدة Google Search Console لمزيد من المعلومات حول استخدام الأداة وتصحيح الأخطاء وتحليل النتائج في الأداة. مزيد من المعلومات حول بيانات المنتج المنظّمة

متطلبات ترميز البيانات المنظّمة

  • يجب توفير ترميز البيانات المنظّمة في محتوى HTML الذي يعرضه خادم الويب. ولا يمكن إنشاء ترميز البيانات المنظّمة باستخدام JavaScript بعد تحميل الصفحة.
  • لا يمكن تغيير الصفحة المقصودة بناءً على معلومات حول العميل، مثلاً في حال تعديل الأسعار بناءً على عنوان IP الخاص بالعميل أو نوع المتصفّح.
  • يجب أن تتطابق البيانات المنظّمة مع القيم التي تظهر للعميل. يُعدّ تقديم بيانات غير صحيحة على الصفحات المقصودة الخاصة بالمنتجات مخالفًا لإرشادات المطوّرين على الويب.
  • تنصح Google باستخدام JSON-LD لبياناتك المنظّمة.
قد تحتوي هذه الصفحة على محتوى تمت ترجمته باستخدام تكنولوجيا الذكاء الاصطناعي (AI). علمًا أنّ الترجمات المستندة إلى هذه التكنولوجيا قد تتضمن بعض الأخطاء.

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟
بحث
محو البحث
إغلاق البحث
القائمة الرئيسية
8555398008007799293
true
مركز مساعدة البحث
false
true
true
true
true
true
71525
false
false
true
false
false