Микроразметка внедрена.
Главная проходит проверку.
Карточка товара тоже.
Кажется, что задача закончена.
Но затем находится другая карточка — и в ней уже отсутствует изображение. У третьей неправильно сформирована цена. На четвёртой в JSON-LD появляется старый URL. А где-то одновременно выводятся две версии одного и того же объекта.
Для сайта на CMS это вполне реальный сценарий.
Главная сложность динамической микроразметки на 1С-Битрикс не в том, чтобы однажды написать правильный JSON-LD.
Нужно сделать так, чтобы он оставался правильным на разных страницах, с разным набором данных и при работающем кешировании.
Почему одна успешная проверка ничего не гарантирует
Представим каталог из 500 товаров.
Разработчик открывает первую карточку:
- название заполнено;
- изображение есть;
- цена есть;
- описание есть;
- URL корректный.
JSON-LD формируется идеально.
Но шаблон работает не с одним товаром.
Он должен корректно обработать ещё 499 вариантов данных.
У одного элемента нет изображения.
У другого не заполнено описание.
У третьего несколько цен.
У четвёртого свойство содержит кавычки.
У пятого используется другая единица измерения.
Именно поэтому для динамического сайта проверяется не только код шаблона, но и то, как он ведёт себя на разных данных.
Ошибка №1. Пустые свойства превращаются в пустую микроразметку
Одна из самых распространённых проблем возникает, когда шаблон рассчитывает на данные, которых у конкретного элемента нет.
Например:
-
imageсуществует не у всех товаров; -
descriptionне заполнен у части услуг; - цена доступна только для некоторых предложений;
- статья не имеет изображения;
- контактный телефон отсутствует у конкретного подразделения.
Если код без проверки переносит такие значения в JSON-LD, появляются пустые или бессмысленные свойства.
Яндекс Валидатор отдельно сообщает об обязательных полях, которые отсутствуют или пусты.
Что делать
Не нужно автоматически создавать пустое свойство только потому, что оно предусмотрено шаблоном.
Логика должна выглядеть примерно так:
есть значение → добавляем свойство;
нет значения → решаем, допустимо ли отсутствие этого свойства для конкретной сущности.
Это особенно важно для обязательных полей поисковых функций.
Ошибка №2. JSON-LD собирается конкатенацией строк
На тестовой странице всё может работать:
название товара простое;
описание короткое;
никаких кавычек.
Затем появляется элемент с названием вроде:
«Стол “Лофт” 1200 × 600 мм».
И ручная сборка JSON начинает создавать проблемы.
Кавычки, обратные слеши, переносы строк и другие символы должны корректно экранироваться.
Поэтому JSON-LD надёжнее формировать как PHP-массив, а затем кодировать штатным JSON-механизмом, а не собирать большую строку вручную.
Почему ошибка опасна
Проблема может быть незаметной месяцами.
Все старые товары проходят проверку.
Добавляется один новый элемент с необычным символом — и структурированные данные конкретной страницы перестают корректно разбираться.
То есть причина находится не в Schema.org как таковой.
Она находится в способе генерации JSON.
Ошибка №3. URL формируются неправильно
В Schema.org много ссылок:
-
url; -
@id; -
image; - адреса элементов BreadcrumbList;
- ссылки предложений;
- ссылки организации.
На динамическом сайте эти адреса обычно формируются автоматически.
И здесь появляются варианты:
- относительный путь вместо полного URL;
- неправильный домен;
- HTTP вместо HTTPS;
- тестовый домен;
- ссылка на раздел вместо текущей карточки;
- URL предыдущего элемента;
- неправильный canonical.
Особенно внимательно стоит проверять разметку после переноса сайта, смены домена или изменения структуры каталога.
Не путать URL страницы и идентификатор сущности
@id часто используется как стабильный идентификатор объекта.
При этом разработчик может автоматически собрать его из текущего URL.
Сам подход допустим, но результат должен быть стабильным и логичным.
Если URL страницы поменялся, а где-то продолжает формироваться старое значение, поисковая система получает противоречивую информацию.
Поэтому полезно проверять не только типы и названия, но и все ссылки внутри JSON-LD.
Ошибка №4. На странице остаётся старая микроразметка
Распространённый сценарий при доработке существующего сайта:
разметка уже была.
Например, её когда-то:
- добавили в шаблон сайта;
- встроили в шаблон компонента;
- установили через готовое решение;
- вывели отдельным модулем;
- добавили через SEO-инструмент.
Потом внедряется новая система JSON-LD.
В результате на странице могут одновременно существовать две версии одной сущности.
Например:
старый Product со старой ценой;
новый Product с актуальными данными.
Или две Organization с разными телефонами.
Почему валидатор может не показать очевидную «ошибку»
Оба объекта могут быть синтаксически корректными.
Проблема уже смысловая:
поисковику передаются противоречивые данные.
Поэтому перед внедрением стоит проверить исходный код страницы и понять, какая микроразметка там уже существует.
Ошибка №5. Не учитывается кеш компонентов 1С-Битрикс
Для Битрикса это особенно важный момент.
Компоненты умеют кешировать результат работы.
При первом запросе сформированный HTML может попасть в кеш, а при следующих запросах использоваться уже готовый результат. В официальном курсе 1С-Битрикс отдельно отмечается, что при попадании в кеш код шаблона компонента и result_modifier.php повторно не выполняются.
Если микроразметка связана с данными компонента, нужно понимать, на каком этапе она формируется и какие данные доступны при кеш-хите.
Особенность component_epilog.php
component_epilog.php, наоборот, может выполняться независимо от наличия кеша.
Но доступные в нём значения $arResult берутся из кеша, а необходимые дополнительные ключи должны быть туда сохранены. Официальная документация 1С-Битрикс отдельно описывает этот механизм.
Это важно, если микроразметка выводится или дополняется после работы кешируемого компонента.
Непонимание жизненного цикла компонента может дать очень неприятный эффект:
HTML страницы выглядит правильно,
а структурированные данные формируются не из того набора информации, на который рассчитывал разработчик.
Не нужно лечить проблему отключением кеша
Самое простое решение:
«Выключим кеш — и всё заработает».
Иногда это действительно помогает подтвердить источник проблемы.
Но превращать отключенный кеш в постоянное решение неправильно.
Микроразметка должна нормально работать вместе с механизмами кеширования сайта.
Иначе исправление SEO-разметки может закончиться ухудшением производительности.
Ошибка №6. Один шаблон Schema.org используется для разных по смыслу страниц
Есть ещё одна проблема, которая технически может вообще не вызывать ошибок.
Например, разработчик сделал один большой JSON-LD и выводит его:
- на странице услуги;
- в разделе услуг;
- в каталоге;
- на карточке товара.
Все обязательные поля заполнены.
JSON валиден.
Но сущность не соответствует странице.
Google прямо требует, чтобы структурированные данные представляли основное содержание конкретной страницы и не описывали скрытую или нерелевантную информацию.
Типичный пример
Карточка конкретного товара:
Product.
Раздел с двадцатью товарами:
это уже не один Product.
То же самое с услугами.
Детальная страница конкретной услуги и список всех услуг сайта выполняют разные функции.
Поэтому динамическая микроразметка должна учитывать тип страницы, а не только наличие данных.
Ошибка №7. Проверяется только «идеальный» элемент
Это одна из самых коварных ошибок.
Для тестирования выбирают карточку, где заполнено абсолютно всё.
Она проходит валидаторы.
Работа принимается.
А реальные проблемы находятся в других элементах.
Что стоит включить в тестовую выборку
Для товара:
- полностью заполненная карточка;
- карточка без изображения;
- товар с одной ценой;
- товар с несколькими предложениями;
- элемент с длинным названием;
- элемент со специальными символами.
Для статьи:
- материал с изображением;
- без изображения;
- с автором;
- с минимальным набором данных.
Для услуг — тот же принцип.
Проверять нужно не только тип страницы, но и краевые варианты заполнения данных.
Дополнительная проблема: данные микроразметки расходятся с видимой страницей
Это особенно опасно для динамических данных.
Например:
на странице цена изменилась;
в JSON-LD осталась старая.
Или:
товар закончился;
видимая часть сайта показывает отсутствие товара;
структурированные данные продолжают передавать старый статус.
Google требует, чтобы структурированные данные соответствовали видимому содержимому и оставались актуальными.
Поэтому при изменении бизнес-данных должна обновляться не только страница, но и связанная с ней разметка.
Практика: почему мы проверяли несколько типов страниц
При недавнем внедрении микроразметки на сайте 1С-Битрикс проверка выполнялась не на одном URL.
В контрольную выборку вошли восемь адресов разных типов:
- главная;
- разделы;
- детальные страницы;
- контакты;
- продукция;
- информационные материалы;
- другие характерные страницы проекта.
Проверяли Google и Яндекс.
Причина именно в динамической природе сайта.
Корректный WebSite на главной ничего не говорит о Product.
Правильный Product ничего не говорит о CollectionPage.
А корректная статья не подтверждает работу ContactPage.
То есть единицей проверки должен быть не просто сайт.
Нужно проверять архитектуру шаблонов сайта.
Как проверять динамическую микроразметку после разработки
Я бы использовал такой порядок.
1. Составить карту типов страниц
Например:
- главная;
- товар;
- раздел каталога;
- услуга;
- раздел услуг;
- статья;
- контакты;
- портфолио.
2. Определить основной тип Schema.org для каждого шаблона
Не начинать с кода.
Сначала определить смысл страницы.
3. Проверить источники данных
Для каждого свойства понимать:
откуда берётся название;
откуда изображение;
как формируется цена;
откуда URL;
что происходит при пустом значении.
4. Проверить JSON на разных данных
Не только на одном элементе.
5. Проверить кеш
Убедиться, что после кеш-хита разметка остаётся корректной.
6. Проверить страницу после изменения данных
Поменять тестовое значение и убедиться, что HTML и JSON-LD обновились согласованно.
7. Проверить отсутствие дублей
Посмотреть исходный HTML целиком.
8. Проверить реальные URL валидаторами
Не ограничиваться JSON, скопированным из PHP-кода.
Google рекомендует после внедрения протестировать несколько опубликованных страниц и через URL Inspection убедиться, что поисковик видит структурированные данные.
Самая важная проверка выполняется не в валидаторе
Валидатор отлично обнаруживает многие технические проблемы.
Но он не знает архитектуру вашего проекта.
Он не понимает, что:
- цена должна браться из другого типа цены;
- изображение устарело;
- URL ведёт не на тот элемент;
- эта страница на самом деле является разделом, а не Product;
- рядом существует второй JSON-LD из старого модуля.
Поэтому микроразметку нельзя свести к задаче:
«Добиться зелёного результата теста».
Нужно добиться того, чтобы данные правильно описывали реальную страницу и стабильно формировались CMS.
Что в итоге
Для статического HTML достаточно один раз написать правильный JSON-LD.
На динамическом сайте задача сложнее.
Нужно учитывать:
- разные типы страниц;
- разное заполнение элементов;
- пустые свойства;
- генерацию JSON;
- URL;
- кеш;
- дубли;
- актуальность данных;
- жизненный цикл компонентов.
Поэтому качественная микроразметка на 1С-Битрикс — это не отдельный <script>.
Это небольшой слой интеграции между структурой сайта, данными CMS и поисковыми системами.
И проверять его нужно именно так.