Отзывы и рейтинг по schema.org

Разметка Review служит для описания отзыва о продукте, организации или заведении.

Отзыв о работе организации

Для начала, я покажу вам пример отзыва о работе организации. Сама разметка:

<div itemscope itemtype="https://schema.org/Review">
    <meta itemprop="datePublished" content="2012-07-15"/>
    <h2 itemprop="name">
        <link itemprop="url" href="https://example.com/review?10231">
    </h2>
    <div itemprop="reviewBody">
        <p>Заказ был готов сравнительно быстро, а напитки приготовили практически сразу.
            Обслуживание на уровне, хотя грязная посуда иногда застаивалась.</p>
        <p>Рекомендую русскую кухню, особенно супы.</p>
    </div>
    <div>
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
            <p itemprop="name">Имя</p>
            <p itemprop="additionalName">Отчество</p>
            <p itemprop="familyName">Фамилия</p>
            <link itemprop="url" href="http://example.com/users/vasya">
        </span>
    </div>
    <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Organization">
        <meta itemprop="name" content="Отзыв о компании Название фирмы">
        <meta itemprop="telephone" content="123-45-12">
        <link itemprop="url" href="https://example.ru/"/>
        <meta itemprop="email" content="mail@example.ru">
        <p itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
            <meta itemprop="addressLocality" content="Москва">
            <meta itemprop="streetAddress" content="Тверская, 7">
        </p>
    </div>
    <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
        <meta itemprop="worstRating" content="1">
        <meta itemprop="ratingValue" content="3">
        <meta itemprop="bestRating" content="5"/>
    </div>
</div>

Это базовая разметка, которая содержит в себе все необходимые атрибуты и свойства для составления разметки отзывов. Давайте её разберем:

• itemtype="https://schema.org/Review" — Базовый объект разметки.
  • itemprop="datePublished" — Дата первой публикации отзыва.
  • itemprop="name" — Имя отзыва.
  • itemprop="url" — Ссылка на страницу отзыва.
  • itemprop="reviewBody" — Тело отзыва.
  • itemprop="author" — Автор отзыва, далее ссылаемся на объект Person.
  • itemtype="https://schema.org/Person" — Объект автора отзыва.
    • itemprop="name" — Имя автора отзыва.
    • itemprop="additionalName" — Отчество автора отзыва (необязательно).
    • itemprop="familyName" — Фамилия автора отзыва (необязательно).
    • itemprop="url" — Ссылка на страницу автора отзыва (необязательно).
  • itemprop="itemReviewed" — То, очем будет отзыв, ссылаемся на объект Organization.
  • itemtype="https://schema.org/Organization" — Объект организации.
    • itemprop="name" — Название организации.
    • itemprop="telephone" — Телефон организации.
    • itemprop="url" — Ссылка на сайт организации.
    • itemprop="email" — Email адрес организации.
    • itemprop="address" — Адрес организации, ссылаемся на объект PostalAddress.
    • itemtype="https://schema.org/PostalAddress" — Объект почтового адреса.
      • itemprop="addressLocality" — Город организации.
      • itemprop="streetAddress" — Улица и дом организации.
  • itemprop="reviewRating" — Оценка данная в этом отзыве, ссылаемся на объект Rating.
    • itemprop="worstRating" — Самая низкая оценка, возможная в системе. Если worstRating не указан, предполагается что он равен 1.
    • itemprop="ratingValue" — Сама оценка.
    • itemprop="bestRating" — Самая высокая оценка, возможная в системе. Если bestRating не указан, предполагается что он равен 5.

Данную разметку можно развивать, например указать общую оценку организации и т. д. Но для большинства отзывов, данная разметка подойдет и в таком виде.