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.

使用 Search Console 监控富媒体搜索结果

Search Console 是一款工具，可帮助您监控网页在 Google 搜索结果中的显示效果。即使没有注册 Search Console，您的网页也可能会显示在 Google 搜索结果中，但注册 Search Console 能够帮助您了解 Google 如何查看您的网站并做出相应的改进。建议您在以下情况下查看 Search Console：

  1. 首次部署结构化数据后
  2. 发布新模板或更新代码后
  3. 定期分析流量时

首次部署结构化数据后

等 Google 将网页编入索引后，请在相关的富媒体搜索结果状态报告中查看是否存在问题。 理想情况下，有效项目数量会增加，而无效项目数量不会增加。如果您发现结构化数据存在问题，请执行以下操作：

  1. 修正无效项目。
  2. 检查实际网址，核实问题是否仍然存在。
  3. 使用状态报告请求验证。

发布新模板或更新代码后

如果对网站进行重大更改，请监控结构化数据无效项目的增幅。
  • 如果您发现无效项目增多了，可能是因为您推出的某个新模板无法正常工作，或者您的网站以一种新的错误方式与现有模板交互。
  • 如果您发现有效项目减少了（但无效项目的增加情况并不对应），可能是因为您的网页中未再嵌入结构化数据。请通过网址检查工具了解导致此问题的原因。

定期分析流量时

请使用效果报告分析您的 Google 搜索流量。数据将显示您的网页在 Google 搜索结果中显示为富媒体搜索结果的频率、用户点击该网页的频率以及网页在搜索结果中的平均排名。您还可以使用 Search Console API 自动提取这些结果。

问题排查

如果您在实施或调试结构化数据时遇到问题，请查看下面列出的一些实用资源。

  • 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站，请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
  • Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因，请参阅结构化数据常规指南。
  • 您的结构化数据可能存在错误。请参阅结构化数据错误列表。
  • 如果您的网页受到结构化数据手动操作的影响，其中的结构化数据将会被忽略（但该网页仍可能会出现在 Google 搜索结果中）。如需修正结构化数据问题，请使用“人工处置措施”报告。
  • 再次查看相关指南，确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过，问题可能不是语法问题，因此富媒体搜索结果测试无法识别这些问题。
  • 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
  • 请等待一段时间，以便 Google 重新抓取您的网页并重新将其编入索引。请注意，网页发布后，Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题，请参阅 Google 搜索抓取和索引编制常见问题解答。
  • 在 Google 搜索中心论坛中发帖提问。