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

Dodawanie uporządkowanych danych

Uporządkowane dane to standardowy format udostępniania informacji o stronie i klasyfikowania jej zawartości. Jeśli dopiero zaczynasz, dowiedz się, jak działają uporządkowane dane.

Poniżej omawiamy sposób tworzenia, testowania i udostępniania uporządkowanych danych.

  1. Dodaj wymagane właściwości. Dowiedz się, w którym miejscu na stronie umieścić uporządkowane dane w zależności od używanego formatu.
  2. Przestrzegaj wskazówek.
  3. Zweryfikuj kod za pomocą testu wyników z elementami rozszerzonymi i napraw błędy krytyczne. Rozważ też usunięcie niekrytycznych problemów, które mogą zostać zgłoszone w narzędziu – to może poprawić jakość uporządkowanych danych (ale nie jest to konieczne, aby witryna kwalifikowała się do wyników z elementami rozszerzonymi).
  4. Możesz wdrożyć kilka stron z uporządkowanymi danymi i dzięki narzędziu do sprawdzania adresów URL zobaczyć, jak Google je odczytuje. Upewnij się, że Twoja strona jest dostępna dla Google i nie jest blokowana przez plik robots.txt lub tag noindex ani nie wymaga logowania. Jeśli strona wygląda dobrze, możesz poprosić Google o ponowne zindeksowanie adresów URL.
  5. Aby na bieżąco informować Google o przyszłych zmianach, prześlij mapę witryny. Możesz zautomatyzować ten proces za pomocą interfejsu 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

Jeden z prawidłowych typów

Element, którego dotyczy opinia. Jeśli jednak opinia jest umieszczona w obrębie innego typu schema.org za pomocą właściwości review, możesz pominąć właściwość itemReviewed.

Prawidłowe typy ocenianego elementu to:
itemReviewed.name

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

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

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",
  "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.

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.

Troubleshooting

If you're having trouble implementing or debugging structured data, here are some resources that may help you.

  • If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
  • Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
  • You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report.
  • If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
  • Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
  • Troubleshoot missing rich results / drop in total rich results.
  • Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
  • Post a question in the Google Search Central forum.