عرض وصفات الطعام الخاصة بك على Google

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

وصفات الطعام في "بحث Google" و"صور Google"

بالاستناد إلى طريقة ترميز المحتوى، يمكن أن تكون وصفاتك مؤهَّلة للحصول على التحسينات التالية:

تحسينات الوصفات
وصفات الطعام الإرشادية: يمكنك تفعيل "مساعد Google" لإرشاد المستخدمين أثناء التنقّل بين وصفاتك على Google Home والشاشات الذكية عن طريق إضافة بيانات Recipe المنظَّمة. وثمة خصائص إضافية مطلوبة لوصفات الطعام الإرشادية، ولكن يُنصح بها فقط لخدمة "بحث Google". احرص على إضافة recipeIngredient و recipeInstructions. إذا أضفت السمة video، يجب أيضًا إضافة السمة contentUrl.

لمزيد من المعلومات حول وصفات الطعام على "مساعد Google"، يمكنك التعرّف على كيفية إنشاء المهام من المحتوى على الإنترنت.

وصفة طعام على "مساعد Google"
منصّة العرض بعناصر متغيّرة لمضيف وصفات الطعام: يمكنك أن تتيح للمستخدمين إمكانية الاطّلاع على صفحات معرض الوصفات الخاص بك عن طريق إضافة بيانات ItemList المنظّمة. منصة العرض بعناصر متغيّرة لوصفة طعام في "بحث Google"

كيفية إضافة البيانات المنظَّمة

البيانات المنظَّمة هي تنسيق موحّد لتقديم معلومات عن صفحة محدّدة وتصنيف محتواها. وإذا كنت لا تزال مبتدئًا في مجال البيانات المنظَّمة، يمكنك الاطّلاع على المزيد من المعلومات حول آلية عمل البيانات المنظَّمة.

إليك نظرة عامة حول كيفية إنشاء بيانات منظَّمة واختبارها وإصدارها. للحصول على دليل مفصّل حول كيفية إضافة بيانات منظَّمة إلى صفحة ويب، يمكنك الاطّلاع على الدرس التطبيقي حول الترميز الخاص بالبيانات المنظَّمة.

  1. أضِف السمات المطلوبة. استنادًا إلى التنسيق الذي تستخدمه، تعرَّف على مكان إدراج البيانات المنظَّمة في الصفحة.
  2. اتّبِع الإرشادات.
  3. تحقّق من صحة الرمز باستخدام اختبار النتائج المنسّقة.
  4. انشر بعض الصفحات التي تتضمّن بياناتك المنظَّمة واستخدِم أداة فحص عنوان URL لاختبار طريقة عرض الصفحة في محرّك البحث Google. تأكّد من إمكانية وصول محرّك البحث Google إلى صفحتك ومن عدم حظرها باستخدام ملف robots.txt أو علامة noindex أو متطلبات تسجيل الدخول. إذا بدت الصفحة جيدة، يمكنك أن تطلب من Google إعادة الزحف إلى عناوين URL الخاصة بك.
  5. لإعلام Google بأي تغييرات لاحقة، ننصحك بإرسال ملف Sitemap. يمكنك برمجة هذا الإجراء باستخدام واجهة برمجة التطبيقات لملف Sitemap في Search Console.

أمثلة

إليك بعض الأمثلة لوصفات باستخدام رمز JSON-LD.

وصفات الطعام الإرشادية

في ما يلي مثال لصفحة مؤهّلة للعرض على "بحث Google" وكوصفة طعام إرشادية ضمن خدمة "مساعد Google".

<html>
  <head>
    <title>Party Coffee Cake</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Party Coffee Cake",
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
      ],
      "author": {
        "@type": "Person",
        "name": "Mary Stone"
      },
      "datePublished": "2018-03-10",
      "description": "This coffee cake is awesome and perfect for parties.",
      "prepTime": "PT20M",
      "cookTime": "PT30M",
      "totalTime": "PT50M",
      "keywords": "cake for a party, coffee",
      "recipeYield": "10",
      "recipeCategory": "Dessert",
      "recipeCuisine": "American",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "270 calories"
      },
      "recipeIngredient": [
        "2 cups of flour",
        "3/4 cup white sugar",
        "2 teaspoons baking powder",
        "1/2 teaspoon salt",
        "1/2 cup butter",
        "2 eggs",
        "3/4 cup milk"
        ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "name": "Preheat",
          "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.",
          "url": "https://example.com/party-coffee-cake#step1",
          "image": "https://example.com/photos/party-coffee-cake/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Mix dry ingredients",
          "text": "In a large bowl, combine flour, sugar, baking powder, and salt.",
          "url": "https://example.com/party-coffee-cake#step2",
          "image": "https://example.com/photos/party-coffee-cake/step2.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Add wet ingredients",
          "text": "Mix in the butter, eggs, and milk.",
          "url": "https://example.com/party-coffee-cake#step3",
          "image": "https://example.com/photos/party-coffee-cake/step3.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Spread into pan",
          "text": "Spread into the prepared pan.",
          "url": "https://example.com/party-coffee-cake#step4",
          "image": "https://example.com/photos/party-coffee-cake/step4.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Bake",
          "text": "Bake for 30 to 35 minutes, or until firm.",
          "url": "https://example.com/party-coffee-cake#step5",
          "image": "https://example.com/photos/party-coffee-cake/step5.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Enjoy",
          "text": "Allow to cool and enjoy.",
          "url": "https://example.com/party-coffee-cake#step6",
          "image": "https://example.com/photos/party-coffee-cake/step6.jpg"
        }
      ],
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "video": {
        "@type": "VideoObject",
        "name": "How to make a Party Coffee Cake",
        "description": "This is how you make a Party Coffee Cake.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "http://www.example.com/video123.mp4",
        "embedUrl": "http://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

وصفة طعام على "بحث Google"

في ما يلي مثال على صفحة مؤهّلة للعرض على "بحث Google".

<html>
  <head>
    <title>Non-alcoholic Pina Colada</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Non-alcoholic Pina Colada",
      "image": [
      "https://example.com/photos/1x1/photo.jpg",
      "https://example.com/photos/4x3/photo.jpg",
      "https://example.com/photos/16x9/photo.jpg"
      ],
      "author": {
        "@type": "Person",
        "name": "Mary Stone"
      },
      "datePublished": "2018-03-10",
      "description": "This non-alcoholic pina colada is everyone's favorite!",
      "recipeCuisine": "American",
      "prepTime": "PT1M",
      "cookTime": "PT2M",
      "totalTime": "PT3M",
      "keywords": "non-alcoholic",
      "recipeYield": "1 serving",
      "recipeCategory": "Drink",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "recipeIngredient": [
        "2 cups of pineapple juice",
        "5/8 cup cream of coconut",
        "ice"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "text": "Blend 2 cups of pineapple juice and 5/8 cup cream of coconut until smooth."
        },
        {
          "@type": "HowToStep",
          "text": "Fill a glass with ice."
        },
        {
          "@type": "HowToStep",
          "text": "Pour the pineapple juice and coconut mixture over ice."
        }
      ],
      "video": {
        "@type": "VideoObject",
        "name": "How to make a Party Coffee Cake",
        "description": "This is how you make a Party Coffee Cake.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "http://www.example.com/video123.mp4",
        "embedUrl": "http://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

في ما يلي مثال لصفحة ملخّص الوصفات (صفحة بها قائمة وصفات) باستخدام بيانات itemList المنظَّمة. يمكن أن يكون هذا المحتوى مؤهّلاً للعرض في شبكة في نتائج "بحث Google".

<html>
  <head>
    <title>Grandma's Best Pie Recipes</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "url": "https://example.com/apple-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "url": "https://example.com/blueberry-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "url": "https://example.com/cherry-pie.html"
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

الإرشادات

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

تسري الإرشادات التالية على بيانات Recipe المنظَّمة.

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

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

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

Recipe

استخدِم سمات النوع Recipe من schema.org التالية في ترميز محتوى وصفات الطعام. يتوفّر التعريف الكامل لخاصية Recipe على schema.org/Recipe.

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

URL أو ImageObject

تمثل هذه الخاصية صورة صنف الطعام بعد اكتماله.

إرشادات إضافية للصور:

  • يجب أن تحتوي كل صفحة على صورة واحدة على الأقل (سواء استخدمت الترميز فيها أم لا). وسيختار محرّك البحث Google أفضل صورة لعرضها في نتائج "بحث Google" استنادًا إلى نسبة العرض إلى الارتفاع ودرجة الدقة.
  • يجب أن تكون عناوين URL للصور قابلة للزحف والفهرسة. لمعرفة ما إذا كان بإمكان محرّك البحث Google الوصول إلى عناوين URL، استخدِم أداة فحص عنوان URL.
  • يجب أن تمثّل الصور المحتوى الذي تم ترميزه.
  • يجب أن تكون الصور بتنسيق ملف يتوافق مع تطبيق "صور بحث Google".
  • للحصول على أفضل النتائج، قدِّم عدة صور عالية الدقة (بحد أدنى 50 ألف بكسل عند ضرب العرض بالارتفاع) وبنسب العرض إلى الارتفاع التالية: 16×9 و4×3 و1×1.

مثلاً:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
name

Text

تمثّل هذه الخاصية اسم الطبق.
الخصائص المقترَحة
aggregateRating

AggregateRating

تمثّل هذه السمة تعليقًا توضيحيًّا لمتوسط نتيجة المراجعات الممنوحة للطبق. ويمكنك اتّباع إرشادات مقتطف المراجعة وقائمة سمات AggregateRating المطلوبة والمقترَحة.

إذا تضمّنت بيانات Recipe المنظَّمة مراجعة واحدة، يجب أن يكون اسم المراجع اسمًا صالحًا لشخص أو مؤسسة. على سبيل المثال، "50% خصم على المكونات" ليس اسمًا صالحًا لمراجع.
author

Person أو Organization

اسم الشخص أو المؤسسة التي كتبت الوصفة.
cookTime

Duration

تمثّل هذه السمة الوقت الذي يستغرقه طهي الطبق بالتنسيق ISO 8601. ويمكنك استخدام الحد الأدنى والأقصى للوقت على هيئة عناصر تابعة لتحديد النطاق الزمني.

وعليك استخدامها دائمًا مع prepTime.

datePublished

Date

تمثّل هذه السمة تاريخ نشر الوصفة بالتنسيق ISO 8601.
description

Text

تمثّل هذه الخاصية ملخّصًا لوصف طبق الطعام.
keywords

Text

عبارات أخرى عن وصفتك، مثل الموسم ("الصيف") أو العطلة ("شم النسيم") أو أوصاف أخرى ("سريعة" أو "سهلة" أو "أصلية")

إرشادات إضافية

  • استخدِم فواصل بين الإدخالات المتعددة في قائمة الكلمات الرئيسية.
  • لا تستخدم علامة تمثّل السمة recipeCategory أو السمة recipeCuisine.

    سمة غير مقترَحة

    
"keywords": "dessert, American"

    مقترَح

    
"keywords": "winter apple pie, nutmeg crust"
nutrition.calories

Energy

عدد السعرات الحرارية لكل حصة طعام تُقدَّم من هذه الوصفة. إذا تم تحديد nutrition.calories، يجب تحديد recipeYield مع عدد حصص الطعام.
prepTime

Duration

تمثّل هذه السمة المدة الزمنية المستغرقة لتحضير مكوّنات الطبق وتجهيز مساحة العمل المخصّصة لإعداده بالتنسيق ISO 8601. ويمكنك استخدام الحد الأدنى والأقصى للوقت على شكل عناصر تابعة لتحديد النطاق الزمني.

عليك استخدامها دائمًا مع cookTime.
recipeCategory

Text

تمثل هذه الخاصية نوع الوجبة الذي تنتمي إليه الوصفة أو ترتيب تناولها. على سبيل المثال: "عشاء" أو "طبق رئيسي"، أو "حلوى"، أو "وجبة خفيفة".
recipeCuisine

Text

تمثل هذه الخاصية المنطقة التي ترتبط بها الوصفة. على سبيل المثال، وصفة "فرنسية" أو "من مناطق البحر المتوسط" أو "أمريكية"
recipeIngredient

Text

تمثّل هذه السمة مكوّنًا مستخدمًا في الوصفة.

مثلاً:


"recipeIngredient": [
  "1 (15 ounce) package double crust ready-to-use pie crust",
  "6 cups thinly sliced, peeled apples (6 medium)",
  "3/4 cup sugar",
  "2 tablespoons all-purpose flour",
  "3/4 teaspoon ground cinnamon",
  "1/4 teaspoon salt",
  "1/8 teaspoon ground nutmeg",
  "1 tablespoon lemon juice"
]

إرشادات إضافية:

  • اذكر فقط نص المكوِّنات الضرورية لإعداد الوصفة.
  • لا تذكر معلومات غير ضرورية، مثل تعريف المكوِّن
recipeInstructions

HowToStep أو HowToSection أو Text

تمثّل هذه السمة خطوات تحضير الطبق.

هناك عدّة خيارات لتحديد قيمة الخاصية recipeInstructions. ننصح باستخدام HowToStep. يمكن أيضًا استخدام HowToSection لتجميع HowToSteps إذا كانت الوصفة تحتوي على أقسام.

  • HowToStep: حدِّد خطوات هذه الوصفة باستخدام السمة HowToStep. 
    
"recipeInstructions": [
  {
    "@type": "HowToStep",
    "name": "Preheat",
    "text": "Heat oven to 425°F.",
    "url": "https://example.com/recipe#step1",
    "image": "https://example.com/photos/recipe/step1.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Prepare crust",
    "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
    "url": "https://example.com/recipe#step2",
    "image": "https://example.com/photos/recipe/step2.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Make filling",
    "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
    "url": "https://example.com/recipe#step3",
    "image": "https://example.com/photos/recipe/step3.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cover",
    "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
    "url": "https://example.com/recipe#step4",
    "image": "https://example.com/photos/recipe/step4.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Bake",
    "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
    "url": "https://example.com/recipe#step5",
    "image": "https://example.com/photos/recipe/step5.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cool",
    "text": "Cool on cooling rack at least 2 hours before serving.",
    "url": "https://example.com/recipe#step6",
    "image": "https://example.com/photos/recipe/step6.jpg"
  }
]
  • HowToSection (للوصفات المتعدّدة الأقسام فقط): استخدِم هذه السمة لتجميع الخطوات في عدة أقسام. يمكنك الاطّلاع على HowToSection مثلاً.
  • نص لخاصية واحدة أو نص لحقل متكرر: يضم النص خطوة واحدة أو أكثر. يتعامل Google مع كل الخطوات على أنها في قسم واحد. يتم ربط قيم الخصائص المتكررة في نص واحد. وبعدها يحاول Google تلقائيًا تقسيم النص الواحد إلى خطوات مستقلة. ويحاول Google البحث عن أسماء الأقسام وأرقام الخطوات والكلمات الرئيسية وأي نوع نص آخر قد يظهر بشكل غير صحيح في نص خطوات إعداد الوصفة ثم يُزِيل كل ذلك. للحصول على أفضل النتائج، ننصحك بتحديد الخطوات بشكل واضح باستخدام السمة HowToStep. 
    
"recipeInstructions": [
  "In large bowl, gently mix filling ingredients; spoon into crust-lined pie
plate. Top with second crust. Cut slits or shapes in several places in top
crust. Bake 40 to 45 minutes. The pie is ready when the or until apples are
tender and the crust is golden brown. Cool on cooling rack at least 2 hours
before serving."
]

إرشادات إضافية

  • لا تدرِج البيانات الوصفية التي تخص حقولاً أخرى. على وجه الخصوص، استخدِم الخاصية author لتحديد المؤلِّف وrecipeCuisine لأسلوب الطهي وrecipeCategory للفئة وkeywords للكلمات الرئيسية الأخرى.
  • أَدرِج نَصّ طريقة عمل الوصفة فقط، ولا تُدرِج نصًا آخر، مثل "توجيهات" أو "مشاهدة الفيديو" أو "الخطوة 1". يمكنك تحديد تلك العبارات خارج البيانات المنظَّمة.

    سمة غير مقترَحة

    
"recipeInstructions": [{
  "@type": "HowToStep",
  "text": "Step 1. Heat oven to 425°F."
}]

    سمة مقترَحة

    
"recipeInstructions": [{
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}]
recipeYield

Text أو Integer

تمثّل هذه السمة الكمية الناتجة عن الوصفة. حدِّد عدد حصص الطعام الناتجة عن هذه الوصفة من خلال إضافة رقم. وإذا أردت استخدام وحدة مختلفة (على سبيل المثال، عدد العناصر)، يمكنك إدراج أرقام إضافية. وتكون هذه الخاصية مطلوبة إذا حدّدت أي معلومات غذائية لكل حصة طعام (مثل nutrition.calories).

مثال


"recipeYield": [
  "6",
  "24 cookies"
]
totalTime

Duration

تمثّل هذه السمة الوقت الإجمالي الذي يستغرقه إعداد الطبق وطهيه بالتنسيق ISO 8601. ويمكنك استخدام الحد الأدنى والأقصى للوقت على هيئة عناصر تابعة لتحديد النطاق الزمني.

استخدِم السمة totalTime أو السمتَين cookTime وprepTime معًا.

video VideoObject

فيديو يصف الخطوات اللازمة لإعداد الطبق. اتّبِع قائمة سمات الفيديو المطلوبة والمقترَحة.

  • Video without clips 
    
{
  "@context": "https://schema.org/",
  "@type": "Recipe",
  "video": [
    {
      "@type": "VideoObject",
      "name": "Delicious PieParty Coffee Cake",
      "description": "How to make a delicious pie - quickly and easily!How to make Party Coffee Cake.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
      ],
      "contentUrl": "https://www.example.com/videos/123_600x400.mp4",
      "embedUrl": "https://www.example.com/videoplayer?id=123",
      "uploadDate": "2018-02-05T08:00:00+08:00"
    }
  ]
}
]
  • Video with clips: فيديو يضم مقاطع تتوافق مع شرائح الفيديو. يمكن أن تشير الأجزاء الأخرى من الوصفة (مثل الخطوات) إلى هذه المقاطع، والتي تم تحديدها في video.hasPart. 
    
{
  "@context": "https://schema.org/",
  "@type": "Recipe",
  "video": {
    "@type": "VideoObject",
    "name": "Make a pie",
    "description": "How to make a delicious pie - quickly and easily!",
    "thumbnailUrl": "https://example.com/photos/photo.jpg",
    "contentUrl": "https://www.example.com/videos/123_600x400.mp4",
    "embedUrl": "https://www.example.com/videoplayer?id=123",
    "uploadDate": "2018-02-05T08:00:00+08:00",
    "duration": "P1MT10S",
    "hasPart": [{
      "@type": "Clip",
      "@id": "Clip1",
      "name": "Preheat oven",
      "startOffset": 20,
      "endOffset": 29
      "url": "https://www.example.com/example?t=20"
     },
     {
       "@type": "Clip",
       "@id": "Clip2",
       "name": "Arrange pie crust",
       "startOffset": 29,
       "endOffset": 36
       "url": "https://www.example.com/example?t=29"
     },
     {
       "@type": "Clip",
       "@id": "Clip3",
       "name": "Make filling",
       "startOffset": 36,
       "endOffset": 45
       "url": "https://www.example.com/example?t=36"
     },
     {
       "@type": "Clip",
       "@id": "Clip4",
       "name": "Add filling",
       "startOffset": 45,
       "endOffset": 65
       "url": "https://www.example.com/example?t=45"
     },
     {
       "@type": "Clip",
       "@id": "Clip5",
       "name": "Bake",
       "startOffset": 65,
       "endOffset": 80
       "url": "https://www.example.com/example?t=65"
     },
     {
       "@type": "Clip",
       "@id": "Clip6",
       "name": "Let cool",
       "startOffset": 80,
       "endOffset": 90
       "url": "https://www.example.com/example?t=80"
    }]
  }
}
video.contentUrl

URL

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


"contentUrl": "https://www.example.com/video/123/file.mp4"

احرص على اتّباع أفضل ممارسات الفيديو.
video.hasPart

Clip

مقطع فيديو يمثّل جزءًا من الفيديو الكامل.

video.hasPart.endOffset

Number

وقت انتهاء المقطع، ويتم التعبير عنه بعدد الثواني من بداية الفيديو.

video.hasPart.name

Text

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

video.hasPart.startOffset

Number

وقت بدء المقطع، ويتم التعبير عنه بعدد الثواني من بداية الفيديو.

video.hasPart.url

URL

رابط للانتقال إلى بداية المقطع. يجب أن تتطابق بداية المقطع مع القيمة المُحدَّدة في video.hasPart.startOffset. مثلاً: 


"startOffset": 20,
"endOffset": 29,
"url": "https://www.example.com/example?t=20"

HowToSection

يمكنك استخدام HowToSection لتجميع سلسلة من الخطوات (أو الأقسام الفرعية) التي تُشكِّل جزءًا من تعليمات إعداد الوصفة. ويمكنك تحديد HowToSection مباشرةً ضمن تعريف السمة recipeInstructions، أو على أنه itemListElement لسمة HowToSection أخرى.

يحدد النوع HowToSection قسمًا لوصفة واحدة ويحتوي على خطوة واحدة أو عدة خطوات. ولا تستخدم HowToSection لتحديد وصفات مختلفة لصنف الطعام نفسه، بل استخدِم HowToSection كجزء من وصفة واحدة. لسرد وصفات متعددة للطبق نفسه، استخدِم كائنات Recipe متعددة. على سبيل المثال، لعرض طرق متعدّدة لتحضير فطيرة تفاح، أدرِجها على أنها عناصر Recipe متعددة، وليس عناصر HowToSection.

يتوفّر تعريف HowToSection الكامل على schema.org/HowToSection.

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

قائمة بالخطوات التفصيلية للقسم و/أو الأقسام الفرعية. يمكن أن تتضمن وصفة البيتزا مثلاً قسمًا لخطوات إعداد العجينة وقسمًا لتحضير الطبقات الفوقية وقسمًا لخلط المكونات وخَبزها. إذا كانت الوصفة تحتوي على أقسام، ولكن لم يتم تحديدها باستخدام HowToSections، قد يعرض "مساعد Google" عن طريق الخطأ اسم القسم كخطوة أخرى فقط (على سبيل المثال، خطوة "إعداد العجينة" متبوعة بخطوة "خلط الدقيق والخميرة").

مثال:


{
  "@type": "HowToSection",
  "name": "Assemble the pie",
  "itemListElement": [
    {
      "@type": "HowToStep",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate."
    }, {
      "@type": "HowToStep",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust."
    }
  ]
}
name Text

تمثّل هذه الخاصية اسم القسم.

HowToStep

يمكنك استخدام HowToStep لتجميع جملة أو أكثر توضّح كيفية تنفيذ جزء من الوصفة. حدِّد السمة text باستخدام الجُمل أو حدِّد السمة itemListElement بالتناوب، باستخدام السمة HowToDirection أو HowToTip لكل جملة.

يمكنك ترميز خطوات وصفتك باستخدام السمات التالية لنوع HowToStep. حدِّد السمة HowToStep مباشرةً ضمن تعريف السمة recipeInstructions أو على أنها itemListElement لسمة HowToSection.

يتوفّر التعريف الكامل لسمة HowToStep على schema.org/HowToStep.

الخصائص المطلوبة
itemListElement HowToDirection أو HowToTip

تمثل هذه الخاصية قائمة بالخطوات الفرعية التفصيلية بما يشمل التوجيهات أو النصائح.

وتكون اختيارية في حال استخدام text.
text Text

تمثل هذه الخاصية النص الكامل لتعليمات هذه الخطوة.

وتكون اختيارية في حال استخدام itemListElement. إرشادات إضافية:

  • أدرِج نصًا تعليميًا فقط ولا تُدرِج نصًا آخر مثل "التوجيهات" أو "مشاهدة الفيديو" أو "الخطوة 1". حدِّد العبارات غير المستخدمة في الخاصية التي تم ترميزها.

    غير مقترَحة

    
{
  "@type": "HowToStep",
  "text": "Step 1. Heat oven to 425°F."
}

    مقترَح

    
{
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}
الخصائص المقترَحة
image ImageObject أو URL

تمثل هذه الخاصية صورة للخطوة. إرشادات إضافية للصور:

  • يجب أن تكون جميع عناوين URL للصور قابلة للزحف والفهرسة.
  • يجب أن تمثل الصور المحتوى محل الترميز.
  • يجب أن تكون الصور بالتنسيق ‎.jpg أو ‎.png أو ‎.gif.
name Text

الكلمة أو العبارة القصيرة التي تلخّص الخطوة (على سبيل المثال، "تحضير قشرة الفطيرة"). لا تستخدِم نصًا غير وصفي (مثل "الخطوة 1: [نص]") أو أي شكل آخر من أشكال ترقيم الخطوات (مثل "1. [نص]").

url URL

تمثل هذه الخاصية عنوان URL الذي يؤدي مباشرة إلى الخطوة (إذا كان متاحًا)، مثلاً جزء من رابط إلى موضع ثابت.

video VideoObject أو Clip

تمثّل هذه السمة فيديو لهذه الخطوة أو مقطعًا من الفيديو.

بالنسبة إلى السمة VideoObject، اتّبِع قائمة السمات المطلوبة والمقترَحة لكل منالفيديو أو المقطع.

HowToDirection وHowToTip

استخدِم السمة HowToDirection والسمة HowToTip لوصف التوجيهات أو النصائح، مع العِلم أنهما يستخدمان السمات المطلوبة والمقترَحة نفسها.

يتوفّر تعريفا HowToDirection وHowToTip الكاملان على schema.org/HowToDirection وschema.org/HowToTip.

الخصائص المطلوبة
text Text

تمثّل هذه السمة نص التوجيه أو النصيحة.

ItemList

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

يتوفّر تعريف ItemList الكامل على schema.org/ItemList.

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

ListItem

تمثّل هذه الخاصية تعليقًا توضيحيًا لصفحة عنصر واحد.
ListItem.position

Integer

تمثّل هذه الخاصية ترتيب صفحة العنصر في القائمة. مثلاً:


"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]
ListItem.url

URL

تمثّل هذه السمة عنوان URL أساسيًا لصفحة العنصر. ويجب تخصيص عنوان URL فريد لكل عنصر.

مراقبة النتائج المنسّقة باستخدام Search Console

Search Console هي أداة تساعدك في مراقبة مستوى أداء صفحاتك في "بحث Google". وليس عليك الاشتراك في Search Console لإدراج موقعك الإلكتروني ضمن نتائج "بحث Google"، ولكن تساعدك هذه الأداة في التعرّف على شكل موقعك كما يراه محرّك البحث Google وتحسين هذا الشكل. ننصح بالتحقق من Search Console في الحالات التالية:

  1. بعد نشر بيانات منظَّمة للمرة الأولى
  2. بعد إصدار نماذج جديدة أو تعديل الترميز
  3. تحليل الزيارات بشكل دوري

بعد نشر بيانات منظَّمة للمرة الأولى

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

  1. أصلِح الأخطاء.
  2. افحص عنوان URL مباشر لمعرفة ما إذا كانت المشكلة مستمرّة.
  3. اطلب إجراء تحقق باستخدام تقرير الحالة.

بعد إصدار نماذج جديدة أو تعديل الترميز

عند إجراء تغييرات كبيرة على موقعك الإلكتروني، راقِب الزيادات في عدد أخطاء البيانات المنظَّمة والتحذيرات.
  • إذا لاحظت زيادة في عدد الأخطاء، قد يكون السبب أنك طرحت نموذجًا جديدًا لا يعمل أو أنّ موقعك الإلكتروني يتفاعل مع النموذج الحالي على نحو جديد وغير صالح.
  • إذا لاحظت انخفاضًا في العناصر الصالحة (لا يقابله زيادة في عدد الأخطاء)، من الممكن أنك توقّفت عن تضمين بيانات منظَّمة في صفحاتك. استخدِم أداة فحص عنوان URL للاطّلاع على سبب المشكلة.

تحليل الزيارات بشكل دوري

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

تحديد المشاكل وحلّها

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