Отзыв

Отзыв представляет собой краткую информацию с сайта потребительских рейтингов. Обычно это усредненная оценка, которая рассчитана на основании оценок множества пользователей. Обнаружив корректную разметку отзывов или оценок, мы можем показывать расширенное описание веб-страницы с различными сведениями, например текстом отзыва и оценкой по пятибалльной шкале. Отзывы размещаются под результатами поиска или на карточках Сети знаний Google. Оценки можно предоставлять для следующих типов контента:

Google также поддерживает отзывы следующих типов schema.org:

Примеры

Структурированные данные для отзывов можно разместить на странице несколькими способами:

Добавить обычный отзыв.
Встроить отзыв в разметку другого типа schema.org при помощи ее свойства review.
Добавить оценки в свои отзывы.
Добавить сводные оценки. Оценку в отдельном отзыве можно опустить, если размеченный контент содержит сведения об авторе и дате отзыва. В случае со сводными отзывами необходимо предоставить среднюю оценку для расширенного описания веб-страницы в результатах поиска.

Обычный отзыв

JSON-LD

Пример кода JSON-LD для обычного отзыва:

<html>
  <head>
  <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Review",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "http://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"
      },
      "reviewBody": "The seafood is great.",
      "publisher": {
        "@type": "Organization",
        "name": "Washington Times"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa

Пример кода 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>
      <span property="reviewBody">The seafood is great.</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>
      <span itemprop="reviewBody">The seafood is great.</span>
      <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
        <meta itemprop="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Встроенный отзыв

JSON-LD

Пример кода 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": "http://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"
        },
        "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."
      },
      "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

Пример кода RDFa для встроенного отзыва:

<html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Product">
      <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"> Review:
        <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">May 4, 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>
  </body>
</html>

Микроданные

Пример микроданных для встроенного отзыва:

<html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <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"> Review:
        <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">May 4, 2006
        <div itemprop="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 itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
            <meta itemprop="name" content="Washington Times">
        </span>
      </div>
    </div>
  </body>
</html>

Отзыв с оценками

JSON-LD

Пример кода JSON-LD для отзыва с оценками:

RDFa

Пример кода RDFa для отзыва с оценками:

Микроданные

Пример микроданных для отзыва с оценками:

Сводная оценка

JSON-LD

Пример кода JSON-LD для сводной оценки:

RDFa

Пример кода RDFa для сводной оценки:

Микроданные

Пример микроданных для сводной оценки:

Правила

Чтобы ваш контент мог появляться в виде расширенного результата, он должен соответствовать требованиям, изложенным ниже.

Технические требования

Используйте для сводных оценок от нескольких пользователей разметку schema.org/AggregateRating. Мы можем показывать сводные оценки в виде расширенных описаний веб-страниц, а для некоторых типов контента – в виде ответов в результатах поиска.
Отзыв следует явным образом связать с определенным товаром или услугой с помощью подходящего типа разметки с сайта schema.org, например schema.org/Book или schema.org/Recipe. Также можно использовать тот или иной тип разметки с сайта schema.org в качестве значения свойства itemReviewed.
Убедитесь, что отзывы и оценки, которые вы добавляете в разметку, доступны пользователям на размеченной странице. Отзывы должны быть видны сразу же при загрузке сайта.
Указывайте отзывы не для всего списка, а для каждого его элемента. Примеры можно найти здесь.
Если отзыв относится к местной компании или организации, необходимо соблюдать следующие требования:
- Страницы, на которых используется LocalBusiness или другой тип структурированных данных Organization, не могут оцениваться количеством баллов, если организация может управлять посвященными ей отзывами. Например, отзыв об организации А размещен на ее сайте – непосредственно в разметке или через сторонний виджет.
- Оценки должны быть получены непосредственно от пользователей.
- Не обрабатывайте связанные с оценками данные вручную, а используйте структурированные данные Отзывы критиков.
- Оценки должны поступать на сайт от пользователей, а не с других ресурсов.

Типы структурированных данных

Чтобы ваш контент мог появляться в результатах поиска, необходимо задать все обязательные свойства. Советуем задать и рекомендуемые нами свойства – так пользователям будет удобнее.

Отзыв

Полное описание типа Review приведено на странице schema.org/Review.

Обязательные свойства
`author`	`Person` или `Organization` Автор отзыва. Указывать можно только допустимые имена. Например, имя "Скидка 50 % до субботы" является недопустимым.
`itemReviewed`	`Thing` Чему посвящен отзыв. Если отзыв встроен в другой тип разметки schema.org при помощи свойства `review`, то свойство `itemReviewed` можно опустить. О чем можно публиковать отзывы. `Book` `Course` `CreativeWorkSeason` `CreativeWorkSeries` `Episode` `Event` `Game` `HowTo` `LocalBusiness` `MediaObject` `Movie` `MusicPlaylist` `MusicRecording` `Organization` `Product` `Recipe` `SoftwareApplication`
`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" }, "reviewBody": "I really enjoyed this game. You get to capture fireflies and put them in jars." } }
`reviewRating`	`Rating` Оценка, которая содержится в отзыве. Оценка может быть реализована с помощью разметки типа Rating или более конкретного подтипа. Наиболее распространенным подтипом является AggregateRating.
`reviewRating.ratingValue`	`Number` или `Text` Оценка, выраженная простым числом, дробью или процентом (например, "4", "60 %" или "6/10"). Если значение явно не подразумевает конкретный тип шкалы (как, например, "4"), то по умолчанию используется пятибалльная. Чтобы выбрать другую, задайте свойства `bestRating` и `worstRating`.

Рекомендуемые свойства

Рекомендуемые свойства
`datePublished`	`Date` Дата публикации отзыва, указанная в формате ISO 8601.
`reviewRating.bestRating`	`Number` Самая высокая оценка в этой системе рейтинга. Свойство `bestRating` является обязательным, если не используется пятибалльная шкала. Если значение `bestRating` не указано, по умолчанию оно равно 5.
`reviewRating.worstRating`	`Number` Самая низкая оценка в этой системе рейтинга. Свойство `worstRating` является обязательным, если не используется пятибалльная шкала. Если значение `worstRating` не указано, по умолчанию оно равно 1.

datePublished

Date

Дата публикации отзыва, указанная в формате ISO 8601.

reviewRating.bestRating

Number

Самая высокая оценка в этой системе рейтинга. Свойство bestRating является обязательным, если не используется пятибалльная шкала. Если значение bestRating не указано, по умолчанию оно равно 5.

reviewRating.worstRating

Number

Самая низкая оценка в этой системе рейтинга. Свойство worstRating является обязательным, если не используется пятибалльная шкала. Если значение worstRating не указано, по умолчанию оно равно 1.

AggregateRating

Полное описание типа AggregateRating приведено на странице schema.org/AggregateRating.

Обязательные свойства
`itemReviewed`	`Thing` Оцениваемый элемент. Если общая оценка встроена в другой тип разметки schema.org при помощи свойства `aggregateRating`, то помечать свойство `itemReviewed` не обязательно. О чем можно публиковать отзывы. `Book` `Course` `CreativeWorkSeason` `CreativeWorkSeries` `Episode` `Event` `Game` `HowTo` `LocalBusiness` `MediaObject` `Movie` `MusicPlaylist` `MusicRecording` `Organization` `Product` `Recipe` `SoftwareApplication`
`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"). Если значение явно не подразумевает конкретный тип шкалы (как, например, "4"), то по умолчанию используется пятибалльная. Чтобы выбрать другую, задайте свойства `bestRating` и `worstRating`.

Рекомендуемые свойства

Рекомендуемые свойства
`bestRating`	`Number` Самая высокая оценка в этой системе рейтинга. Свойство `bestRating` является обязательным, если не используется пятибалльная шкала. Если значение `bestRating` не указано, по умолчанию оно равно 5.
`worstRating`	`Number` Самая низкая оценка в этой системе рейтинга. Свойство `worstRating` является обязательным, если не используется пятибалльная шкала. Если значение `worstRating` не указано, по умолчанию оно равно 1.

bestRating

Number

worstRating

Number