Uporządkowane dane dotyczące fragmentu opinii (Review, AggregateRating)

Fragment opinii to krótki cytat z opinii lub oceny pochodzącej z witryny z opiniami, odzwierciedlający średnią ocen przyznanych przez wielu recenzentów. Gdy wyszukiwarka Google znajdzie prawidłowe znaczniki opinii lub ocen, może wyświetlić fragment rozszerzony, który zawiera gwiazdki i inne informacje podsumowujące wygenerowane na podstawie opinii lub ocen. Razem z treścią opinii wyświetla się też ocena numeryczna w określonej skali (np. od 1 do 5). Fragmenty opinii mogą pojawiać się w wynikach z elementami rozszerzonymi lub w Panelu wiedzy Google. Możesz zamieszczać oceny tych funkcji:

Fragment opinii w wyszukiwarce Google

Google obsługuje też opinie w tych typach schema.org (i ich podtypach):

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据，可以详细了解结构化数据的运作方式。

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南，请查看结构化数据 Codelab。

  1. 添加必要属性。根据您使用的格式，了解在网页上的什么位置插入结构化数据。
  2. 遵循指南。
  3. 使用富媒体搜索结果测试验证您的代码，并修复所有严重错误。此外，您还可以考虑修正该工具中可能会标记的任何非严重问题，因为这些这样有助于提升结构化数据的质量（不过，要使内容能够显示为富媒体搜索结果，并非必须这么做）。
  4. 部署一些包含您的结构化数据的网页，然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问，不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题，您可以请求 Google 重新抓取您的网址。
  5. 为了让 Google 随时了解日后发生的更改，我们建议您提交站点地图。Search Console Sitemap API 可以帮助您自动执行此操作。

Przykłady

Możesz dodać do strony uporządkowane dane Review na kilka sposobów:

  • Dodaj prostą opinię.
  • Umieść opinię w obrębie innego typu schema.org, zapisując ją we właściwości review.
  • Dodaj oceny zbiorcze. Możesz pominąć ocenę w danej opinii, jeśli znaczniki dodane do treści zawierają informacje o autorze opinii i dacie jej publikacji. W przypadku opinii zbiorczych musisz podać średnią ocenę, która będzie wyświetlana we fragmencie rozszerzonym.
  • Umieść oceny zbiorcze w obrębie innego typu schema.org za pomocą właściwości aggregateRating.

Prosta opinia

Oto przykład prostej opinii.

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
      },
      "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>"A good seafood place." </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>

Mikrodane


 <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>"A good seafood place." </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>

Opinia zagnieżdżona

Oto przykład opinii zagnieżdżonej we właściwości Product. Możesz skopiować przykład i wkleić go na własnej stronie 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": "2024-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>"A masterpiece of literature" </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>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>"The worst thing I've ever read" </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="2024-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>

Mikrodane


 <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>"A masterpiece of literature" </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
        <div>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 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>"The worst thing I've ever read" </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="2024-11-21" />
      </div>
    </div>
  </body>
</html>

Ocena zbiorcza

Oto przykład oceny zbiorczej.

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>

Mikrodane


 <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>

Zagnieżdżona ocena zbiorcza

Oto przykład oceny zbiorczej, zagnieżdżonej we właściwości Product. Możesz skopiować przykład i wkleić go na własnej stronie 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>

Mikrodane


 <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>

Wytyczne

Aby treści mogły się wyświetlać w wynikach z elementami rozszerzonymi, musisz przestrzegać tych wytycznych.

Wskazówki techniczne

  • Dodaj zbiorczą ocenę elementu wynikającą z opinii wielu użytkowników, stosując znaczniki schema.org/AggregateRating. Google może wyświetlać w wynikach wyszukiwania oceny zbiorcze jako fragmenty rozszerzone lub – w przypadku określonych rodzajów elementów – jako odpowiedzi.
  • Odwołuj się wyraźnie do konkretnego produktu lub konkretnej usługi, umieszczając opinię w obrębie znaczników innego typu schema.org, np. schema.org/Book lub schema.org/Recipe, albo używając typu schema.org jako wartości właściwości itemReviewed.
  • Upewnij się, że opinie objęte znacznikami są dostępne dla użytkowników z poziomu strony zawierającej znaczniki. Dla użytkowników powinno być natychmiast jasne, że strona zawiera opinie. Jeśli na przykład oznaczysz opinie, użytkownicy powinni widzieć tekst opinii i powiązaną z nią ocenę. Jeśli używasz AggregateRating, użytkownicy powinni widzieć tę ocenę zbiorczą na stronie.
  • Zalecamy akceptowanie tylko ocen, do których dołączony jest komentarz zawierający opinię oraz imię i nazwisko autora. Chociaż nie jest to wymagane, może to pomóc użytkownikom w poznaniu szczegółów uzasadniających ocenę.
  • Podawaj opinie o konkretnym elemencie, a nie o kategorii czy liście elementów.
  • Jeśli dołączasz wiele odrębnych opinii, dołącz też ich zbiorczą ocenę.
  • Nie zbieraj opinii ani ocen z innych witryn.
  • Jeśli fragment opinii dotyczy lokalnej firmy lub organizacji, musisz przestrzegać tych dodatkowych wskazówek:
    • Jeśli oceniany podmiot ma wpływ na opinie na swój temat, na stronach, na których używa się uporządkowanych danych LocalBusiness lub innych typów danych Organization, nie można umieszczać opinii z gwiazdką. Przykładem jest opinia o danym podmiocie umieszczona na stronie tego podmiotu – bezpośrednio w jego uporządkowanych danych lub przez umieszczony widżet innej firmy (taki jak widżet opinii o firmie w Google lub na Facebooku).
    • Oceny muszą pochodzić bezpośrednio od użytkowników.
    • Nie korzystaj z informacji o ocenach firm lokalnych, które zostały przygotowane, opracowane lub skompilowane przez redaktorów.

Definicje typów uporządkowanych danych

Aby uporządkowane dane mogły się wyświetlać w wynikach wyszukiwania, musisz w nich stosować wymagane właściwości. Możesz też dodawać do nich właściwości zalecane, aby wzbogacać informacje podawane w uporządkowanych danych i zwiększać w ten sposób wygodę użytkowników.

Review

Pełną definicję znaczników Review znajdziesz na schema.org/Review.

Właściwości obsługiwane przez Google:

Właściwości wymagane
author

Person lub Organization

Autor opinii. Musisz podać prawidłowe imię i nazwisko recenzenta. Na przykład: „50% zniżki do soboty” nie jest prawidłowym imieniem i nazwiskiem recenzenta.

To pole musi zawierać mniej niż 100 znaków. Jeśli zawiera ich więcej, nie będzie można dodać fragmentu opinii danego autora.

Aby pomóc Google w lepszym rozpoznawaniu autorów w różnych funkcjach, postępuj zgodnie ze sprawdzonymi metodami dodawania znaczników autora.

itemReviewed (jeśli opinia nie jest opinią zagnieżdżoną)

Jeden z prawidłowych typów

Przedmiot opinii. Jeśli jednak opinia jest umieszczona w obrębie innego typu schema.org za pomocą właściwości review, pomiń właściwość itemReviewed (zakładamy, że element nadrzędny jest ocenianym elementem).

Prawidłowe typy ocenianego elementu to:
itemReviewed.name lub element nadrzędny name w zagnieżdżonej opinii.

Text

Nazwa elementu, którego dotyczy opinia. Nawet jeśli opinia jest umieszczona w obrębie innego typu schema.org za pomocą właściwości review, nadal musisz podać właściwość name ocenianego elementu, Na przykład:

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

Rating

Ocena przyznana w tej opinii. Ocenę można podać w formie umieszczonej właściwości Rating lub za pomocą jej bardziej szczegółowego podtypu. Najpopularniejszym podtypem jest AggregateRating.
reviewRating.ratingValue

Number lub Text

Numeryczna ocena jakości elementu: liczba, ułamek lub procent (np. 4, 60% lub 6 / 10). Google potrafi interpretować skalę ułamkową i procentową, ponieważ skala jest określana w postaci ułamka lub procentu. W przypadku wartości liczbowych domyślna jest skala 5-punktowa, gdzie 1 to wartość najniższa, a 5 – najwyższa. Jeśli stosowana jest inna skala, użyj właściwości bestRating i worstRating.

W przypadku cyfr dziesiętnych, aby podać wartość, użyj nie przecinka, lecz kropki (na przykład 4.4, a nie 4,4). W Mikrodanych i RDFa możesz zastąpić widoczne treści za pomocą atrybutów content. Dzięki temu możesz przedstawić użytkownikowi dowolną konwencję stylu, a jednocześnie spełnić wymaganie dotyczące kropki w uporządkowanych danych. Na przykład:

<span itemprop="ratingValue" content="4.4">4,4</span> stars
Właściwości zalecane
datePublished

Date

Data publikacji opinii podana w formacie ISO 8601.

reviewRating.bestRating

Number

Najwyższa wartość dopuszczalna w tym systemie ocen. Jeśli pominiesz właściwość bestRating, zostanie domyślnie przyjęta wartość 5.
reviewRating.worstRating

Number

Najniższa wartość dopuszczalna w tym systemie ocen. Jeśli pominiesz właściwość worstRating, zostanie domyślnie przyjęta wartość 1.

AggregateRating

Pełną definicję znaczników AggregateRating znajdziesz na schema.org/AggregateRating.

Właściwości obsługiwane przez Google:

Właściwości wymagane
itemReviewed (jeśli ocena zbiorcza nie jest zagnieżdżoną oceną zbiorczą)

Jeden z prawidłowych typów

Oceniany element. Jeśli jednak ocena zbiorcza jest umieszczona w obrębie innego typu schema.org za pomocą właściwości aggregateRating, możesz pominąć właściwość itemReviewed.

Prawidłowe typy ocenianego elementu to:
itemReviewed.name lub element nadrzędny name w zagnieżdżonej ocenie zbiorczej.

Text

Nazwa elementu, którego dotyczy opinia. Nawet jeśli opinia jest umieszczona w obrębie innego typu schema.org za pomocą właściwości aggregateRating, nadal musisz podać właściwość name ocenianego elementu, Na przykład:

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

Number

Łączna liczba ocen elementu w Twojej witrynie. Trzeba określić co najmniej jedną z tych właściwości: ratingCount lub reviewCount.
reviewCount

Number

Określa liczbę osób, które wyraziły opinię, bez względu na to, czy dodały do niej ocenę. Trzeba określić co najmniej jedną z tych właściwości: ratingCount lub reviewCount.

ratingValue

Number lub Text

Średnia ocena jakości produktu wyrażona liczbą, ułamkiem lub procentem (np. 4, 60% lub 6 / 10). Google potrafi interpretować skalę ułamkową i procentową, ponieważ skala jest określana w postaci ułamka lub procentu. W przypadku wartości liczbowych domyślna jest skala 5-punktowa, gdzie 1 to wartość najniższa, a 5 – najwyższa. Jeśli stosowana jest inna skala, użyj właściwości bestRating i worstRating.

W przypadku cyfr dziesiętnych, aby podać wartość, użyj nie przecinka, lecz kropki (na przykład 4.4, a nie 4,4). W Mikrodanych i RDFa możesz zastąpić widoczne treści za pomocą atrybutów content. Dzięki temu możesz przedstawić użytkownikowi dowolną konwencję stylu, a jednocześnie spełnić wymaganie dotyczące kropki w uporządkowanych danych. Na przykład:

<span itemprop="ratingValue" content="4.4">4,4</span> stars
Właściwości zalecane
bestRating

Number

Najwyższa wartość dopuszczalna w tym systemie ocen. Jeśli pominiesz właściwość bestRating, zostanie domyślnie przyjęta wartość 5.

worstRating

Number

Najniższa wartość dopuszczalna w tym systemie ocen. Jeśli pominiesz właściwość worstRating, zostanie domyślnie przyjęta wartość 1.

Monitorowanie wyników z elementami rozszerzonymi w Search Console

Search Console to narzędzie, które pomaga monitorować skuteczność stron w wyszukiwarce Google. Aby Twoja witryna mogła pojawiać się w wynikach wyszukiwania Google, nie musisz rejestrować jej w Search Console. Jeśli jednak to zrobisz, lepiej zrozumiesz, jak robot Google widzi Twoją witrynę i jak możesz mu ułatwić jej skanowanie. Zalecamy sprawdzenie danych w Search Console w tych przypadkach:

  1. po pierwszym wdrożeniu uporządkowanych danych,
  2. po opublikowaniu nowych szablonów lub zaktualizowaniu kodu,
  3. podczas okresowego analizowania ruchu.

Po pierwszym wdrożeniu uporządkowanych danych

Gdy Google zindeksuje Twoje strony, poszukaj problemów w odpowiednim raporcie o stanie wyników z elementami rozszerzonymi. W idealnej sytuacji powinno się pojawić więcej elementów prawidłowych, a liczba elementów nieprawidłowych nie powinna się zwiększyć. Jeśli zauważysz problemy w uporządkowanych danych:

  1. Napraw nieprawidłowe elementy
  2. Sprawdź opublikowany adres URL, by zobaczyć, czy problem nadal występuje.
  3. Poproś o weryfikację, korzystając z raportu o stanie.

Po opublikowaniu nowych szablonów lub zaktualizowaniu kodu

Po wprowadzeniu istotnych zmian w witrynie monitoruj wzrost liczby nieprawidłowych elementów w uporządkowanych danych.
  • Możesz zauważyć większą liczbę elementów nieprawidłowych, jeśli wprowadzisz nowy szablon, który nie działa, lub jeśli Twoja witryna wykorzystuje istniejący szablon w nowy i nieprawidłowy sposób.
  • Jeśli okaże się, że jest mniej prawidłowych elementów (ale liczba nieprawidłowych elementów się nie zwiększyła), być może na swoich stronach nie umieszczasz już uporządkowanych danych. Użyj narzędzia do sprawdzania adresów URL, by dowiedzieć się, co jest przyczyną problemu.

Okresowe analizowanie ruchu

Analizuj ruch w wyszukiwarce Google za pomocą raportu skuteczności. Zawarte w nim dane pokazują, jak często Twoja strona wyświetla się w wyszukiwarce jako wynik z elementami rozszerzonymi, jak często użytkownicy ją klikają i jaka jest jej średnia pozycja w wynikach wyszukiwania. Możesz też pobrać te wyniki automatycznie za pomocą interfejsu Search Console API.

Rozwiązywanie problemów

Jeśli masz problem z zastosowaniem lub debugowaniem uporządkowanych danych, skorzystaj z tych rozwiązań: