Разметка WebPage — граф Schema.org, который описывает одну веб-страницу и её связь с сайтом, издателем и другими сущностями.
Смысл и границы
WebPage — широкий тип. Более конкретный тип может точнее описать страницу, а свойства вроде URL, name и breadcrumb должны совпадать с тем, что пользователь может проверить в отрисованном документе.
Выбирайте самый конкретный честный тип, генерируйте JSON-LD из тех же данных, что и видимая страница, последовательно задавайте канонический URL, затем проверяйте синтаксис и изучайте связи графа. Обновляйте даты, только если задокументированное содержимое изменилось.
Как это проверить
Проверяйте отдельно друг от друга отрисованную страницу, канонический URL, результат разбора JSON-LD, идентификаторы сущностей, видимые названия и даты, а также возможность получить расширенный результат. Сохраняйте результат валидации вместе с границами деплоя.
Для разметки WebPage возьмите один основной маршрут и сравните объект JSON-LD с отрисованным документом поле за полем: название страницы, канонический URL, язык, даты, хлебные крошки и связь с издателем. Если страница по сути статья, товар или другой более конкретный тип, описывайте именно этот тип, а не добавляйте не связанные с ним типы. По возможности генерируйте идентификаторы и URL из того же источника, что и видимая страница.
Ограничения, проверка и частые ошибки
Не добавляйте типы и свойства только ради того, чтобы получить функцию в поиске. Неподтверждённые или невидимые утверждения делают граф менее надёжным и усложняют отладку.
Сначала проверьте синтаксис, затем изучите граф как данные: ссылки должны разрешаться, даты должны описывать реальные события публикации или обновления, а видимые факты должны совпадать с разметкой. Наконец, отдельно проверьте живой отрисованный HTML и нужный инструмент проверки результатов. Валидный граф описывает страницу, а право на показ в поиске остаётся отдельным решением поисковой системы.
Сначала я сверяю структурированные данные с видимой страницей и только потом изучаю граф: результат валидатора сам по себе не повод менять факты.