البيانات المنظَّمة لمقتطفات المراجعة (Review، AggregateRating)

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

‫مقتطف من المراجعة على "بحث Google‏"

يتيح محرّك بحث Google أيضًا توفير مراجعات لأنواع schema.org (وأنواعها الفرعية) التالية:

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

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

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

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

أمثلة

ثمة طرق عديدة لإضافة بيانات Review المنظَّمة إلى الصفحة:

  • يمكنك إضافة مراجعة بسيطة.
  • يمكنك دمج مراجعة في نوع schema.org آخر باستخدام السمة review المخصصة له.
  • يمكنك إضافة تقييمات مجمّعة. ويمكنك حذف التقييم لمراجعة واحدة إذا كان المحتوى المُرمز يشمل المؤلف وتاريخ المراجعة. بالنسبة إلى المراجعات المجمّعة، يجب توفير متوسط التقييم حتى يتم عرض المقتطف المنسّق.
  • يمكنك دمج التقييمات المجمّعة في نوع schema.org آخر باستخدام السمة aggregateRating المخصصة له.

مراجعة بسيطة

في ما يلي مثال لمراجعة بسيطة.

JSON-LD


<html>
  <head>
  <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Review",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://www.example.com/seafood-restaurant.jpg",
        "name": "Legal Seafood",
        "servesCuisine": "Seafood",
        "priceRange": "$$$",
        "telephone": "1234567",
        "address" :{
          "@type": "PostalAddress",
          "streetAddress": "123 William St",
          "addressLocality": "New York",
          "addressRegion": "NY",
          "postalCode": "10038",
          "addressCountry": "US"
        }
      },
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "4"
      },
      "name": "A good seafood place.",
      "author": {
        "@type": "Person",
        "name": "Bob Smith"
      },
      "publisher": {
        "@type": "Organization",
        "name": "Washington Times"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Review">
      <div property="itemReviewed" typeof="Restaurant">
        <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span property="name">Legal Seafood</span>
        <span property="servesCuisine">Seafood</span>
        <span property="priceRange">$$$</span>
        <span property="telephone">1234567</span>
        <span property="address">123 William St, New York</span>
      </div>
      <span property="reviewRating" typeof="Rating">
        <span property="ratingValue">4</span>
      </span> stars -
      <b>"<span property="name">A good seafood place.</span>" </b>
      <span property="author" typeof="Person">
        <span property="name">Bob Smith</span>
      </span>
      <div property="publisher" typeof="Organization">
        <meta property="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

البيانات الجزئية


 <html>
  <head>
  <title>Legal Seafood</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Review">
      <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
        <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span itemprop="name">Legal Seafood</span>
        <span itemprop="servesCuisine">Seafood</span>
        <span itemprop="priceRange">$$$</span>
        <span itemprop="telephone">1234567</span>
        <span itemprop="address">123 William St, New York</span>
      </div>
      <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
        <span itemprop="ratingValue">4</span>
      </span> stars -
      <b>"<span itemprop="name">A good seafood place.</span>" </b>
      <span itemprop="author" itemscope itemtype="https://schema.org/Person">
        <span itemprop="name">Bob Smith</span>
      </span>
      <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
        <meta itemprop="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

المراجعة المدمجة

إليك مثال على مراجعة مدمجة في Product. يمكنك نسخ المثال ولصقه في صفحة HTML.

JSON-LD


<html>
  <head>
    <title>The Catcher in the Rye</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Product",
      "brand": {
        "@type": "Brand",
        "name": "Penguin Books"
      },
      "description": "The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind.",
      "sku": "9780241984758",
      "mpn": "925872",
      "image": "https://www.example.com/catcher-in-the-rye-book-cover.jpg",
      "name": "The Catcher in the Rye",
      "review": [{
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "5"
        },
        "author": {
          "@type": "Person",
          "name": "John Doe"
        }
       },
      {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "1"
        },
        "author": {
          "@type": "Person",
          "name": "Jane Doe"
        }
      }],
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "88",
        "bestRating": "100",
        "ratingCount": "20"
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/offers/catcher-in-the-rye",
        "priceCurrency": "USD",
        "price": "5.99",
        "priceValidUntil": "2020-11-05",
        "itemCondition": "https://schema.org/UsedCondition",
        "availability": "https://schema.org/InStock",
        "seller": {
          "@type": "Organization",
          "name": "eBay"
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
    <body>
      <div vocab="https://schema.org/" typeof="Product">
        <div rel="schema:brand">
          <div typeof="schema:Brand">
            <div property="schema:name" content="Penguin"></div>
          </div>
        </div>
        <div property="schema:description" content="The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind."></div>
        <div property="schema:sku" content="9780241984758"></div>
        <div property="schema:mpn" content="925872"></div>
        <img property="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/>
        <span property="name">The Catcher in the Rye</span>
        <div property="review" typeof="Review"> Reviews:
          <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">5</span> -
          </span>
          <b>"<span property="name">A masterpiece of literature</span>" </b> by
          <span property="author" typeof="Person">
            <span property="name">John Doe</span></span>, written on
          <meta property="datePublished" content="2006-05-04">4 May 2006
          <div property="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div>
          <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
          </span>
        </div><div property="review" typeof="Review">
          <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">1</span> -
          </span>
          <b>"<span property="name">The worst thing I've ever read</span>" </b> by
          <span property="author" typeof="Person">
            <span property="name">Jane Doe</span></span>, written on
          <meta property="datePublished" content="2006-05-10">10 May 2006
          <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
          </span>
        </div>
        <div rel="schema:aggregateRating">
          <div typeof="schema:AggregateRating">
            <div property="schema:reviewCount" content="89"></div>
            <div property="schema:ratingValue" content="4.4">4,4</div> stars
          </div>
        </div>
        <div rel="schema:offers">
          <div typeof="schema:Offer">
            <div property="schema:price" content="4.99"></div>
            <div property="schema:availability" content="https://schema.org/InStock"></div>
            <div property="schema:priceCurrency" content="GBP"></div>
            <div property="schema:priceValidUntil" datatype="xsd:date" content="2020-11-21"></div>
            <div rel="schema:url" resource="https://example.com/catcher"></div>
            <div property="schema:itemCondition" content="https://schema.org/UsedCondition"></div>
          </div>
        </div>
    </div>
  </body>
</html>

البيانات الجزئية


 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="Penguin" />
      </div>
      <meta itemprop="description" content="The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind." />
      <meta itemprop="sku" content="0446310786" />
      <meta itemprop="mpn" content="925872" />
      <img itemprop="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/>
      <span itemprop="name">The Catcher in the Rye</span>
      <div itemprop="review" itemscope itemtype="https://schema.org/Review"> Reviews:
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
          <span itemprop="ratingValue">5</span> -
        </span>
        <b>"<span itemprop="name">A masterpiece of literature</span>" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">John Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-04">4 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
            <meta itemprop="name" content="Washington Times">
        </span>
      </div><div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span> -
        </span>
        <b>"<span itemprop="name">The worst thing I've ever read</span>" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">Jane Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-10">10 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
          <meta itemprop="name" content="Washington Times">
        </span>
      </div>
      <div itemprop="aggregateRating" itemtype="https://schema.org/AggregateRating" itemscope>
        <meta itemprop="reviewCount" content="89" />
        <span itemprop="ratingValue" content="4.4">4,4</span> stars
      </div>
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://example.com/catcher" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="priceCurrency" content="GBP" />
        <meta itemprop="itemCondition" content="https://schema.org/UsedCondition" />
        <meta itemprop="price" content="4.99" />
        <meta itemprop="priceValidUntil" content="2020-11-21" />
      </div>
    </div>
  </body>
</html>

التقييم المجمَّع

في ما يلي مثال لتقييم مجمَّع.

JSON-LD


<html>
  <head>
    <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "AggregateRating",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://www.example.com/seafood-restaurant.jpg",
        "name": "Legal Seafood",
        "servesCuisine": "Seafood",
        "telephone": "1234567",
        "address" : {
          "@type": "PostalAddress",
          "streetAddress": "123 William St",
          "addressLocality": "New York",
          "addressRegion": "NY",
          "postalCode": "10038",
          "addressCountry": "US"
        }
      },
      "ratingValue": "88",
      "bestRating": "100",
      "ratingCount": "20"
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="AggregateRating">
      <div property="itemReviewed" typeof="Restaurant">
        <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span property="name">Legal Seafood</span>
        <span property="servesCuisine">Seafood</span>
        <span property="telephone">1234567</span>
        <span property="address">123 William St, New York</span>
      </div>
      <span property="ratingValue">4.2</span> out of <span property="bestRating">5</span> stars -
      <span property="ratingCount">123</span> votes
    </div>
  </body>
</html>

البيانات الجزئية


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/AggregateRating">
      <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
        <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span itemprop="name">Legal Seafood</span>
        <span itemprop="servesCuisine">Seafood</span>
        <span itemprop="telephone">1234567</span>
        <span itemprop="address">123 William St, New York</span>
      </div>
      <span itemprop="ratingValue">4.2</span> out of <span itemprop="bestRating">5</span> stars -
      <span itemprop="ratingCount">123</span> votes
    </div>
  </body>
</html>

التقييم المجمَّع المدمَج

إليك مثال على تقييم مجمّع مدمج في Product. يمكنك نسخ المثال ولصقه في صفحة HTML.

JSON-LD


<html>
  <head>
  <title>Executive Anvil</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "name": "Executive Anvil",
    "image": [
      "https://example.com/photos/1x1/photo.jpg",
      "https://example.com/photos/4x3/photo.jpg",
      "https://example.com/photos/16x9/photo.jpg"
     ],
    "brand": {
      "@type": "Brand",
      "name": "ACME"
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.4",
      "ratingCount": "89"
    },
    "offers": {
      "@type": "AggregateOffer",
      "lowPrice": "119.99",
      "highPrice": "199.99",
      "priceCurrency": "USD"
    }
  }
  </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Product">
     <span property="brand" typeof="Brand">ACME</span> <span property="name">Executive Anvil</span>
     <img property="image" src="https://example.com/photos/1x1/anvil_executive.jpg" alt="Executive Anvil logo" />
     <span property="aggregateRating"
           typeof="AggregateRating">
      Average rating: <span property="ratingValue">4.4</span>, based on
      <span property="ratingCount">89</span> reviews
     </span>
     <span property="offers" typeof="AggregateOffer">
      from $<span property="lowPrice">119.99</span> to
      $<span property="highPrice">199.99</span>
      <meta property="priceCurrency" content="USD" />
     </span>
    </div>
  </body>
</html>

البيانات الجزئية


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <span itemprop="brand" itemtype="https://schema.org/Brand" itemscope>ACME</span> <span itemprop="name">Executive Anvil</span>
      <img itemprop="image" src="https://example.com/photos/1x1/anvil_executive.jpg" />
      <span itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
        Average rating: <span itemprop="ratingValue">4.4</span>, based on
        <span itemprop="ratingCount">89</span> reviews
      </span>
      <span itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer">
        from $<span itemprop="lowPrice">119.99</span> to
        $<span itemprop="highPrice">199.99</span>
        <meta itemprop="priceCurrency" content="USD" />
      </span>
    </div>
  </body>
</html>

الإرشادات

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

الإرشادات الفنية

  • يجب استخدام الترميز schema.org/AggregateRating مع التقييم المجمّع الذي منحه الكثير من الأشخاص للعنصر. وقد يعرض محرّك بحث Google التقييمات المجمّعة في نتائج البحث على شكل مقتطفات منسّقة أو إجابات لبعض أنواع العناصر.
  • يجب الإشارة بوضوح إلى منتج محدّد أو خدمة محدّدة من خلال دمج المراجعة في ترميز من نوع schema.org آخر، مثل schema.org/Book أو schema.org/Recipe أو من خلال استخدام نوع من schema.org كقيمة للسمة itemReviewed.
  • يجب التأكد من أن المراجعات والتقييمات التي تعمل على ترميزها متاحة للمستخدمين بسهولة من الصفحة التي تم ترميزها. ويجب أن يظهر بوضوح للمستخدمين أن محتوى الصفحة هو عبارة عن مراجعة.
  • يجب أن ترتبط المعلومات التي تقدّمها المراجعة بعنصر معيّن، وليس بفئة أو بقائمة من العناصر.
  • في حال تضمين مراجعات فردية متعدّدة، يجب أيضًا تضمين تقييم مجمَّع للمراجعات الفردية.
  • يجب عدم تجميع المراجعات أو التقييمات من مواقع إلكترونية أخرى.
  • إذا كان مقتطف المراجعة عن نشاط تجاري محلي أو مؤسسة، عليك اتّباع الإرشادات الإضافية التالية:
    • إذا كان الكيان الذي تتم مراجعته يتحكّم بالمراجعات المتعلّقة به، تكون صفحاته التي تستخدم LocalBusiness أو أي نوع آخر من بيانات Organization المنظّمة غير مؤهَّلة لاستخدام ميزة المراجعة بإشارات النجوم. ومن الأمثلة على ذلك إضافة مراجعة لإحدى المؤسسات على موقعها الإلكتروني إما مباشرةً عن طريق بياناتها المنظَّمة أو من خلال تطبيق مصغّر مضمَّن تابع لجهة خارجية.
    • يجب أن تصدر التقييمات عن المستخدمين مباشرةً.
    • لا تعتمد على المحرّرين لإنشاء معلومات التقييمات أو تنظيمها أو تجميعها للأنشطة التجارية المحلية.

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

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

Review

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

السمات المطلوبة
author

Person أو Organization

تمثّل هذه السمة مؤلف المراجعة. ويجب أن يكون اسم المُراجع صالحًا. على سبيل المثال، "خصم 50% حتى السبت المقبل" ليس اسمًا صالحًا لمُراجع.

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

لمساعدة محرّك بحث Google في التعرّف بشكل أفضل على المؤلفين عبر الميزات المتنوعة، ننصحك باتّباع أفضل الممارسات المتعلقة بترميز معلومات المؤلفين.

itemReviewed

أحد الأنواع الصالحة

تمثّل هذه السمة العنصر موضوع المراجعة. ويمكنك حذف السمة itemReviewed إذا تم دمج المراجعة في نوع schema.org آخر باستخدام السمة review.

إليك الأنواع الصالحة للعنصر موضوع المراجعة:

itemReviewed.name

Text

تمثّل هذه السمة اسم العنصر موضوع المراجعة. وإذا تم دمج المراجعة في نوع schema.org آخر باستخدام السمة review، تبقى السمة name للعنصر موضوع المراجعة مطلوبة. مثلاً:


{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "5"
    },
    "author": {
      "@type": "Person",
      "name": "John Doe"
    }
  }
}
reviewRating

Rating

تمثّل هذه السمة التقييم الممنوح في هذه المراجعة. يمكن أن يكون التقييم Rating مدمجًا أو نوعًا فرعيًا أكثر تحديدًا. والنوع الفرعي الأكثر شيوعًا هو AggregateRating.

reviewRating.ratingValue

السمة Number أو السمة Text

تمثّل هذه السمة تقييمًا رقميًا لجودة العنصر، إما رقمًا أو كسرًا أو نسبة مئوية (على سبيل المثال، 4 أو 60% أو 6 / 10). بإمكان محرّك بحث Google فهم مقياس الكسور والنسب المئوية، لأنّ المقياس مضمّن في الكسر نفسه أو في النسبة المئوية. ويتم استخدام مقياس مكوّن من 5 نقاط كمقياس تلقائي للأرقام، حيث يمثّل الرقم 1 أدنى قيمة والرقم 5 أعلى قيمة. وإذا كان المقصود مقياسًا آخر، يمكنك استخدام السمتَين bestRating وworstRating.

استخدِم نقطة بدلاً من الفاصلة للأرقام العشرية لتحديد القيمة (على سبيل المثال، استخدِم 4.4 بدلاً من 4,4). أما في البيانات الجزئية وRDFa، فيمكنك استخدام سمات content لإلغاء المحتوى المرئي. وبهذه الطريقة، يمكنك عرض أي نمط تريده للمستخدم، مع الالتزام أيضًا باستخدام النقطة في البيانات المنظّمة. مثلاً:


<span itemprop="ratingValue" content="4.4">4,4</span> stars

السمات المقترَحة
datePublished

Date

تمثّل هذه السمة تاريخ نشر المراجعة بتنسيق التاريخ ISO 8601.

reviewRating.bestRating

Number

تمثّل هذه السمة أعلى قيمة مسموح بها في نظام التقييم هذا. ويتم افتراض القيمة 5 في حال إسقاط السمة bestRating.

reviewRating.worstRating

Number

تمثّل هذه السمة أدنى قيمة مسموح بها في نظام التقييم هذا. ويتم افتراض القيمة 1 في حال إسقاط السمة worstRating.

AggregateRating

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

السمات المطلوبة
itemReviewed

أحد الأنواع الصالحة

تمثّل هذه السمة العنصر موضوع التقييم. ويمكنك حذف السمة itemReviewed إذا تم دمج التقييم المجمَّع في نوع schema.org آخر باستخدام السمة aggregateRating.

إليك الأنواع الصالحة للعنصر موضوع المراجعة:

itemReviewed.name

Text

تمثّل هذه السمة اسم العنصر موضوع المراجعة. وإذا تم دمج المراجعة في نوع schema.org آخر باستخدام السمة review، تبقى السمة name للعنصر موضوع المراجعة مطلوبة. مثلاً:


{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "88",
    "bestRating": "100",
    "ratingCount": "20"
  }
}
ratingCount

Number

تمثل هذه السمة إجمالي عدد تقييمات العنصر على موقعك. ويلزم توفير سمة واحدة على الأقل من ratingCount أو reviewCount.

reviewCount

Number

لتحديد عدد الأشخاص الذين قدّموا مراجعة مرفقة أو غير مرفقة بتقييم. ويلزم توفير سمة واحدة على الأقل من ratingCount أو reviewCount.

ratingValue

Number أو Text

تمثّل هذه السمة تقييمًا رقميًا لجودة العنصر، إما رقمًا أو كسرًا أو نسبة مئوية (على سبيل المثال، 4 أو 60% أو 6 / 10). بإمكان محرّك بحث Google فهم مقياس الكسور والنسب المئوية، لأنّ المقياس مضمّن في الكسر نفسه أو في النسبة المئوية. ويتم استخدام مقياس مكوّن من 5 نقاط كمقياس تلقائي للأرقام، حيث يمثّل الرقم 1 أدنى قيمة والرقم 5 أعلى قيمة. وإذا كان المقصود مقياسًا آخر، يمكنك استخدام السمتَين bestRating وworstRating.

استخدِم نقطة بدلاً من الفاصلة للأرقام العشرية لتحديد القيمة (على سبيل المثال، استخدِم 4.4 بدلاً من 4,4). أما في البيانات الجزئية وRDFa، فيمكنك استخدام سمات content لإلغاء المحتوى المرئي. وبهذه الطريقة، يمكنك عرض أي نمط تريده للمستخدم، مع الالتزام أيضًا باستخدام النقطة في البيانات المنظّمة. مثلاً:


<span itemprop="ratingValue" content="4.4">4,4</span> stars

السمات المقترَحة
bestRating

Number

تمثّل هذه السمة أعلى قيمة مسموح بها في نظام التقييم هذا. ويتم افتراض القيمة 5 في حال إسقاط السمة bestRating.

worstRating

Number

تمثّل هذه السمة أدنى قيمة مسموح بها في نظام التقييم هذا. ويتم افتراض القيمة 1 في حال إسقاط السمة worstRating.

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

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

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