Отзыв

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

Примеры

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

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

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

JSON-LD

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

RDFa

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

Микроданные

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

<div itemscope itemtype="https://schema.org/Review">
  <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
    <img itemprop="image" src="https://developers.google.com/search/docs/data-types/markup/seafood-restaurant.jpg?hl=ru" alt="Catcher in the Rye"/>
    <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="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>

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

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 для встроенного отзыва:

Микроданные

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

<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="https://developers.google.com/search/docs/data-types/markup/catcher-in-the-rye-book-cover.jpg?hl=ru" 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>

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

JSON-LD

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

RDFa

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

Микроданные

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

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

JSON-LD

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

RDFa

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

Микроданные

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

Правила

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

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

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

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

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

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

Отзыв

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

Обязательные свойства
`author`	`Person` или `Organization` Автор отзыва. Указывать можно только допустимые имена. Например, имя "Скидка 50 % до субботы" является недопустимым.
`itemReviewed`	`Thing` Чему посвящен отзыв. Необходимо использовать допустимый тип разметки schema.org. Если отзыв встроен в другой тип разметки schema.org при помощи свойства `review`, то свойство `itemReviewed` можно опустить.
`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. Если общая оценка встроена в другой тип разметки schema.org при помощи свойства `aggregateRating`, то помечать свойство `itemReviewed` не обязательно.
`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