Список отзывов и итоговый рейтинг стройте по одной явно определённой выборке. Если в счётчик попали записи на модерации, а в список — только опубликованные, посетитель увидит расхождение. До оформления звёзд запишите, какие статусы, объекты и оценки участвуют в расчёте. На тестовом наборе сравните результат вручную.
Сразу различайте текстовый отзыв и числовую оценку. Отзыв без оценки может быть опубликован, но не должен автоматически превращаться в максимальный балл. Когда оценок нет, показывайте отсутствие рейтинга вместо выдуманного среднего. Это правило вашего продукта; его нужно одинаково применять в интерфейсе, API и кеше.
Маленький набор выявляет разные знаменатели
| Условная запись | Участие в среднем |
|---|---|
| Опубликована, оценка 5 | да |
| Опубликована, оценка 3 | да |
| На модерации, оценка 1 | нет при выбранной политике |
| Опубликована, оценка отсутствует | нет, но может участвовать в числе отзывов |
Для этого условного набора средняя оценка опубликованных числовых оценок равна 4: сумма 8 делится на 2. Опубликованных текстовых записей при этом может быть 3. Подпишите, что именно считает каждое число. «Три отзыва» и «две оценки» совместимы; «рейтинг по трём оценкам» уже противоречит данным примера.
Полная выборка предшествует странице списка
// Условный алгоритм, не код конкретной CMS
visible = reviewsForItem.filter(r => r.status === 'published');
rated = visible.filter(r => r.rating !== null);
count = rated.length;
average = count ? sum(rated.map(r => r.rating)) / count : null;
page = paginate(visible);Переменная reviewsForItem должна быть ограничена одним объектом и допустимыми данными. sum и paginate в примере — условные функции. Рейтинг вычисляют до разбивки на страницы: иначе при открытии следующей десятки значение будет меняться. Проверку диапазона и типа оценки выполняют на сервере при записи, а не доверяют числу из формы.
Если в базе хранится агрегат, после публикации, снятия с публикации или редактирования оценки он должен обновиться согласованно. Повторная задача не должна второй раз прибавлять тот же балл. Для небольшого набора проще начать с пересчёта по исходным записям; для большого объёма понадобится явно проверенный механизм обновления и восстановления агрегата.
Разметка не обещает звёзды в поиске
Google разделяет ratingCount и reviewCount и описывает требования к AggregateRating. Не подставляйте число текстовых записей в поле количества оценок без соответствующего определения. Для другой шкалы указывают её границы; дробные значения в структурированных данных используют точку. Показать человеку «4,5» можно отдельно от машинного числового значения.
Отзывы о собственной Organization или LocalBusiness на контролируемом ею сайте не становятся подходящими для review-сниппета просто после добавления виджета. У Google есть ограничения для self-serving reviews. Подберите разметку под реальный объект и актуальные правила, затем проверьте Rich Results Test. Валидный синтаксис не гарантирует расширенное отображение результата.
- Сравнить видимый рейтинг с исходной выборкой.
- Проверить объект, статус и число оценок.
- Сверить HTML и JSON-LD после обновления кеша.
- Повторить модерацию без повторного учёта балла.
- Проверить отсутствие оценок и отзыв без балла.
Модерация меняет данные, а не только карточку
При снятии записи с публикации проверьте список, агрегат, API и структурированные данные. Старая версия в кеше может оставить прежнее число даже при правильной базе. Обновляйте связанные представления по принятому механизму; не редактируйте вручную отдельный счётчик, который следующий пересчёт вернёт назад. Храните историю решения модератора отдельно от публичного текста.
Для согласования блока нужны обезличенный тестовый набор, правило публикации, шкала и определение каждого счётчика. Не добавляйте демонстрационные похвалы под видом реальных отзывов. По этим материалам можно проверить расчёт и оформить список так, чтобы читатель понимал происхождение оценки без обещаний поисковых звёзд.