استخدِم ترميز البيانات المنظّمة على الصفحات المقصودة لمنتجاتك من أجل مساعدة Google في العثور على معلومات محدثة عن منتجاتك وعروضك من موقعك الإلكتروني مباشرةً. ثمة سمات وقيم مقبولة لكلّ ترميز بيانات منظمة متاح في Merchant Center، كما هو مذكور في مواصفات بيانات المنتجات. ويجب أن تتم مطابقة البيانات المنظّمة مع القيم والسمات الموافقة لها.
في هذه الصفحة:
السمات والتعليقات التوضيحية في schema.org
السمات هي إحدى الطرق التي يتم من خلالها تنظيم بيانات المنتجات التي ترسلها إلى Merchant Center. وتتضمن كل سمة معلومة واحدة حول المنتج، مثل عنوانه أو وصفه. تؤدي المطابقة الدقيقة بين قيمة schema.org وسمات مواصفات بيانات المنتج الموافقة لها إلى حدوث عدد أقل من الأخطاء عند التحقق من الخلاصة.
ملاحظة: إذا كنت تستخدم ميزة التعديلات التلقائية على بيانات السلع، احرص على تحديد السمات المعرَّفة التالية من schema.org لزيادة مستوى دقتها: price
وpriceCurrency
وavailability
وcondition
. مزيد من المعلومات حول ميزة التعديلات التلقائية على بيانات السلع
سمة بيانات المنتج
|
النوع والوصف | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
تندرج السمات التالية ضمن النوع Product في schema.org. |
|||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
عنوان URL | |||||||||||||||||||||||||||||
نص يكون رمز التخزين التعريفي الأساسي مطلوبًا لتجميع كل خيارات المنتج التي تنتمي إلى مجموعة المنتجات نفسها معًا. |
|||||||||||||||||||||||||||||
نص رقم GTIN الذي يعرّف منتجك بشكل فريد حدِّد سمة واحدة فقط من سمات schema.org. إذا استخدمت قيم GTIN، يجب أن تتضمّن عدد الأرقام الصحيح ورقم الاختبار الصحيح. |
|||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
نص استخدِم السمة |
|||||||||||||||||||||||||||||
نص استخدِم السمة
|
|||||||||||||||||||||||||||||
وكذلك |
رقم (بالسنوات) استخدِم السمة القيم الصالحة هي تلك التي تحددها السمة
|
||||||||||||||||||||||||||||
نص | |||||||||||||||||||||||||||||
أو |
نص استخدِم السمة |
||||||||||||||||||||||||||||
نص استخدِم السمة يجب أن تكون القيم من النوع
|
|||||||||||||||||||||||||||||
نص استخدِم السمة يجب أن تكون القيم من النوع WearableSizeSystemEnumeration لتُعتبر صالحة. ويتم ربط هذه القيم بقيم الخلاصة على الشكل التالي:
|
|||||||||||||||||||||||||||||
استخدِم السمة |
|||||||||||||||||||||||||||||
استخدِم السمة |
|||||||||||||||||||||||||||||
استخدِم السمة |
|||||||||||||||||||||||||||||
استخدِم السمة |
|||||||||||||||||||||||||||||
تندرج السمات المعرّفة من schema.org التالية ضمن السمة Offer type التي يجب دمجها في |
|||||||||||||||||||||||||||||
عنوان URL صالح لمنتجك | |||||||||||||||||||||||||||||
أو: |
price: رقم يتم إرساله بدون رموز العملات أو فواصل الآلاف أو مسافات (على سبيل المثال، 1498.99). priceCurrency: نص يتم إرساله وفقًا لتنسيق ISO 4217 الذي يستخدم ثلاثة أحرف للعملات (مثل USD وGBP وEUR)، ويجب أن تستوفي العملة متطلبات اللغة والعملة للبلد المستهدف. ملاحظة: يمكن تقديم السمتَين price وpriceCurrency مباشرةً ضمن السمة Offer أو بشكل غير مباشر عبر السمة priceSpecification من النوع UnitPriceSpecification. عند تحديد قيمة السمة sale_price، يجب تقديم السعر باستخدام السمة priceSpecification مع priceSpecification.priceType="ListPrice". يمكن تحديد السمة sale_price مباشرةً ضمن سمة العرض Offer أو من خلال السمة priceSpecification من النوع UnitPriceSpecification بدون priceSpecification.priceType. |
||||||||||||||||||||||||||||
يجب أن تكون القيم من النوع
|
|||||||||||||||||||||||||||||
يجب أن تكون القيم من النوع
|
|||||||||||||||||||||||||||||
عنوان 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"
}
}
]
السعر المخفَّض
يعرض المثال التالي منتجًا أساسيًا بسعر مخفَّض. للإشارة إلى السعر المخفَّض، يجب أيضًا تحديد السعر الأصلي من المصنع باستخدام السمة /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/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
}
}
في حال استخدام سمة
/UnitPriceSpecification أيضًا للسعر غير المخفَّض، يتمضّن الترميز ببساطة سمتَي/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/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
]
}
}
الشحن
لتحديد تكاليف الشحن لمنتجك (إجراء مقترَح)، استخدِم النوع OfferShippingDetails
في Schema.org، ويجب أن يكون مدمجًا في عرض يستخدم السمة shippingDetails
وأن يرتبط بالسمة shipping
في مواصفات بيانات المنتجات. يمكن توفير سمات shippingDetails
متعددة.
سمة بيانات المنتج
|
النوع والوصف |
---|---|
تندرج السمات التالية ضمن النوع OfferShippingDetails في schema.org. |
|
|
نص رمز البلد المكوّن من رقمَين وفقًا لمعيار ISO 3166-1 استخدِم السمة |
نص رمز تقسيم فرعي يتألف من رقمَين أو ثلاثة أرقام وفقًا لمعيار ISO 3166-2، بدون بادئة البلد. يُسمَح به في الولايات المتحدة أو أستراليا أو اليابان فقط. على سبيل المثال: "NY" أو "NSW" أو "03". استخدِم السمة |
|
استخدِم السمة |
|
رقم (عدد صحيح غير سالب) تحدّد هذه السمة الحد الأدنى والأقصى لعدد أيام العمل المطلوبة لمعالجة طلب وشحنه. يحدّد وقت المناولة الفترة بين تقديم الطلب ووقت تسليمه إلى شركة شحن. تحدّد مدة النقل الفترة بين وقت تسليم المنتج إلى شركة الشحن ووقت تسليمه إلى العميل. استخدِم السمة |
مثال
يوضّح المثال التالي كيفية تحديد معلومات الشحن باستخدام 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.
سمة بيانات المنتج
|
النوع والوصف |
---|---|
تندرج السمات المعرّفة من schema.org التالية ضمن السمة MerchantReturnPolicy ويجب دمجها في منتج باستخدام السمة offers (اطّلِع على الأمثلة أدناه). | |
applicableCountry |
رموز البلدان المكوّنة من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2 (مثل US) رموز البلدان المكوّنة من ثلاثة أحرف وفقًا لمعيار ISO 3166-1 alpha-3 (مثل USA) يجب اختيار البلد الذي تنطبق عليه سياسة إرجاع لتاجر معيّن. يمكن أن يختلف هذا البلد عن البلد الذي تم شحن المنتج منه. ويمكن تحديد ما يصل إلى 50 بلدًا. |
يجب أن تكون القيم من النوع MerchantReturnEnumeration لتُعتبر صالحة. إذا تم تحديد السمة على أنّها MerchantReturnFiniteReturnWindow أو MerchantReturnUnlimitedWindow يُنصح باستخدام السمتَين returnMethod وreturnShippingFeesAmount. بالإضافة إلى ذلك، إذا تمّ تحديد هذه السمة على أنّها MerchantReturnFiniteReturnWindow، يجب استخدام السمة merchantReturnDays. |
|
merchantReturnDays |
تمثّل هذه السمة عدد الأيام التي يمكن خلالها إرجاع المنتج (بدءًا من تاريخ التسليم). |
returnMethod |
يجب أن تكون القيم من النوع ReturnMethodEnumeration لتُعتبر صالحة:
|
returnFees | إنّ القيمة الصالحة من النوع ReturnFeesEnumeration هي FreeReturn. |
returnShippingFeesAmount |
معلومات عن تكلفة الشحن لعمليات إرجاع المنتجات |
مثال
{
"@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
الذي يمكن تحديده لمنتج يستخدم السمة EnergyConsumptionDetails
.
سمة بيانات المنتج
|
النوع والوصف |
---|---|
تندرج سمات schema.org التالية ضمن النوع EnergyConsumptionDetails . |
|
يجب أن تكون القيم من النوع |
|
أضِف هذه السمة تحت مثال EnergyConsumptionDetails الذي تم استخدامه لتحديد السمة energy_efficiency_class ، واستخدِم جدول التعيين نفسه لاختيار القيمة. إذا لم يتم توفير هذه السمة وتم تحديد energy_efficiency_class ، يُفترض أنّ القيمة هي EUEnergyEfficiencyCategoryG . |
|
أضِف هذه السمة تحت مثال EnergyConsumptionDetails الذي تم استخدامه لتحديد السمة energy_efficiency_class ، واستخدِم جدول التعيين نفسه لاختيار القيمة. إذا لم يتم توفير هذه السمة وتم تحديد energy_efficiency_class ، يُفترض أنّ القيمة هي EUEnergyEfficiencyCategoryA3Plus . |
تندرج قيم energyEfficiencyScale
وenergyEfficiencyScaleMin
وenergyEfficiencyScaleMax
ضمن نوع التعداد EUEnergyEfficiencyEnumeration
في schema.org ويتم ربطها بقيم سمات كفاءة استهلاك الطاقة الثلاث في مواصفات بيانات المنتج على النحو التالي.
قيمة مواصفات بيانات المنتج | قيمة تعداد Schema.org من النوعEUEnergyEfficiencyEnumeration type |
---|---|
A+++ |
EUEnergyEfficiencyCategoryA3Plus |
A++ |
EUEnergyEfficiencyCategoryA2Plus |
A+ |
EUEnergyEfficiencyCategoryA1Plus |
A |
EUEnergyEfficiencyCategoryA |
B |
EUEnergyEfficiencyCategoryB |
C |
EUEnergyEfficiencyCategoryC |
D |
EUEnergyEfficiencyCategoryD |
E |
EUEnergyEfficiencyCategoryE |
F |
EUEnergyEfficiencyCategoryF |
G |
EUEnergyEfficiencyCategoryG |
مثال
يوضّح المثال التالي كيفية تحديد معلومات كفاءة استهلاك الطاقة باستخدام 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 ضمن النوع UnitPriceSpecification . |
|
حدِّد مقياس تسعير الوحدات باستخدام السمة استخدِم السمة |
|
حدِّد المقياس الأساسي لتسعير الوحدات باستخدام السمة استخدِم السمة |
مثال
يوضّح المثال التالي سعرًا بقيمة 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 لبياناتك المنظّمة.