منصّات العرض بعناصر متغيّرة

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

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

مثال

في ما يلي طريقة عرض وصفات لتحضير الدجاج من موقع إلكتروني واحد في منصّة عرض بعناصر متغيّرة:

منصّة العرض بعناصر متغيّرة للنتائج المنسَّقة التي تتضمن وصفات طعام

الإرشادات

بالإضافة إلى إرشادات البيانات المنظّمة القياسية، تنطبق الإرشادات التالية على جميع ترميزات القائمة:

  • يجب أن تكون جميع العناصر الموجودة في القائمة من النوع نفسه مثل: Article أو Recipe.
  • يجب أن يكون النص الظاهر للمستخدم مماثلاً للمعلومات الموجودة في البيانات المنظَّمة على الصفحة.
  • سيتم عرض العناصر الموجودة في تنسيق القائمة بالترتيب الذي تحدّده خاصية position.
  • يتيح تنسيق القائمة أنواع المحتوى التالية: وصفات الطعام والدورات التدريبية والمقالات والمطاعم.

توجد طريقتان لتنفيذ تنسيق القائمة على بياناتك المنظَّمة:

  • صفحة الملخّص + عدد من صفحات التفاصيل الكاملة
  • قائمة من صفحة واحدة متكاملة

صفحة الملخّص + عدد من صفحات التفاصيل الكاملة

تحتوي صفحة الملخّص على وصف موجز لكل عنصر في القائمة ويوجّه كل وصف المستخدم إلى صفحة تفاصيل تتناول عنصرًا واحدًا فقط.

صفحة الملخّص صفحة التفاصيل
تحدّد ItemList بحيث يكون لدى كل عنصر ListItem ثلاث خصائص فقط: @type (تعيين إلى "ListItem") وposition (الموضع في القائمة) وurl (عنوان URL لصفحة تتضمن تفاصيل كاملة حول هذا العنصر). تحدّد عنصر البيانات المنظَّمة المناسب لهذا النوع من القوائم.
الكود الزائف لصفحة الويب best_dessert_recipes.html:

ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/coffee_cake.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/apple_pie.html,
    },
    ... more recipes ...
  ]
الكود الزائف لصفحة الويب coffee_cake.html:

@type: Recipe
name: Party Coffee Cake
author: George Smith
.... more properties ...

نموذج التعليمات البرمجية:

نموذج التعليمات البرمجية:

قائمة من صفحة واحدة متكاملة

تستضيف القائمة التي تتضمن صفحة واحدة متكاملة جميع المعلومات الموجودة في القائمة بما في ذلك النص الكامل لكل عنصر، فيتم على سبيل المثال وضع معرض الصور لوصفات طريقة تحضير أنواع مختلفة من الكعك في صفحة واحدة.

صفحة واحدة
تحدّد ItemList بحيث يكون كل عنصر عبارة عن ListItem مع تعبئة الخاصية item بالبيانات المنظَّمة لنوع هذا العنصر schema.org (مثل الأفلام أو الدورات التدريبية). وتتضمّن الصفحة نصًا مرئيًا للمستخدم وعلامة ارتساء لتطابق كل عنصر ListItem.

الكود الزائف لصفحة الويب best_dessert_recipes.html:


ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_1
        name: George's Cherry Pie
        author: George Smith
        ... all other required Recipe type properties ...}
    },
    {
      @type: ListItem
      position: 2
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_2
        name: Party Coffee Cake
        author: Mary Stone
        ... all other required Recipe type properties ...}
    },
    ... more recipes ...
  ]
نموذج التعليمات البرمجية:

تعريفات أنواع البيانات المنظّمة

لتحديد قائمة، عليك تحديد الخاصية ItemList بحيث تتضمّن على الأقل خاصيتين من النوع ListItems. وعليك أيضًا تضمين الخصائص المطلوبة حتى يصبح المحتوى الخاص بك مؤهلاً لعرضه على شكل نتيجة منسّقة. ويمكنك تضمين الخصائص المُقترَحة لإضافة المزيد من المعلومات المتعلقة بالمحتوى الخاص بك، ما يؤدي إلى تحسين تجربة المستخدِم.

ItemList

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

للحصول على التعريف الكامل لخاصية ItemList، يُرجى الانتقال إلى schema.org/ItemList.

الخصائص المطلوبة
itemListElement

ListItem

هو عبارة عن قائمة من العناصر. يجب أن تكون جميع العناصر من نفس النوع. ولمزيد من التفاصيل، يُرجى الاطّلاع على ListItemListItem.

ListItem

يتضمّن ListItem تفاصيل عنصر واحد في القائمة.

  • بالنسبة إلى صفحة الملخّص، يجب أن تتضمّن ListItem الخصائص type وposition وurl.
  • بالنسبة إلى قائمة الصفحة المتكاملة، يجب أن تتضمّن ListItem جميع خصائص schema.org الإضافية لنوع البيانات التي تصفها (مثل الكائنين Recipe أو Course).

للحصول على التعريف الكامل لخاصية ListItem، يُرجى زيارة schema.org/ListItem.

مثال على عنصر في قائمة الملخّص البسيط (JSON-LD):

{
  "@type":"ListItem",
  "position":1,
  "url":"http://example.com/desserts/apple-pie"
}

مثال على عنصر في قائمة الصفحة متكاملة (JSON-LD):

{
  "@type": "ListItem",
  "position": 1,
  "item": {
    "@type": "Recipe",
    "url": "http://example.com/desserts/pies/#apple-pie",
    "name": "Apple Pie",
    "image": "https://example.com/300px-Apple_pie.jpg",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "6",
      "reviewCount": "32"
    },
    "recipeYield": "8 servings",
    "recipeIngredient": [
      "Pastry crust for bottom and top",
      "1/2 cup unsalted butter",
      "3 tablespoons all-purpose flour",
      "1/4 cup water",
      "1/4 cup white sugar",
      "1/2 cup brown sugar",
      "10 cups peeled, chopped green apples"
    ], ... snip ...
  }
}
الخصائص المطلوبة
item

Thing

لا تُستخدم هذه الخاصية إلا مع قوائم الصفحة المتكاملة. وتتطلّب قوائم الصفحة المتكاملة وجود هذه الخاصية. ولا تُستخدَم مع صفحات الملخّص. ويمكنك تعبئة هذا الكائن بالقيم التالية بالإضافة إلى جميع العناصر التي ضمن النوع المحدّد والموضّح من البيانات المنظَّمة:

  • item.name
  • item.url
  • أي خصائص أخرى مطلوبة لهذا النوع من البيانات على النحو الموضّح في schema.org والقواعد الموضّحة في هذه المستندات المخصّصة لنوع المحتوى التابع لك (مثل مقالة أو كتاب). ولتقديم مثال على كتاب في قائمة، عليك إدخال الخاصيتين bookFormat وisbn ولتقديم مثال على وصفة طعام، عليك إدخال الخاصيتين prepTime وimage.
item.name

Text

تمثّل هذه الخاصية اسم العنصر الموجود في معرض الصور. ويتم تجاهل تنسيق HTML. وتتطلّب قوائم الصفحة المتكاملة وجود هذه الخاصية. ولا تُستخدم مع صفحات الملخّص.

item.url

عنوان URL

عنوان URL مؤهل تمامًا + علامة ارتساء الصفحة بهذا العنصر على الصفحة. وتتطلّب قوائم الصفحة المتكاملة وجود هذه الخاصية. ولا تُستخدَم مع صفحات الملخّص. يجب أن يكون عنوان URL هو عنوان الصفحة الحالية بالإضافة إلى تضمين علامة ارتساء HTML (علامة <a> أو القيمة name أو القيمة id) على صفحتك بالقرب من النص المرئي للمستخدم. مثال: https://example.org/recipes/pies#apple_pie.

position

العدد الصحيح

تمثّل هذه الخاصية موضع العنصر في منصّة العرض بعناصر متغيّرة. ويكون هذا العدد مرتبًا وفق الرقم 1.

url

عنوان URL

تُستخدم هذه الخاصية مع صفحة الملخّص فقط والتي تتطلّب وجود هذه الخاصية أيضًا. ولا تُستخدم مع قوائم الصفحة المتكاملة. وتمثل هذه الخاصية عنوان URL أساسيًا لصفحة تفاصيل العنصر. ويجب أن تكون جميع عناوين URL الموجودة في القائمة فريدة ولكنها تتبع النطاق نفسه (النطاق نفسه أو النطاق الفرعي أو الأساسي للصفحة الحالية).

إرسال تعليقات حول...