Навчання
Structured data errors: як виправити JSON-LD, schema markup і rich results
Практичний гайд про structured data errors: що блокує rich results, а що лише warning, типові помилки JSON-LD і як перевірити виправлення.
Запусти свіжий аудит DomainLens і використовуй звіт як список пріоритетів.
Що робить structured data і де воно ламається
Structured data — це машиночитна розмітка (майже завжди JSON-LD), яка каже пошуковикам, про що сторінка: товар із ціною, стаття з автором, рецепт із часом приготування. Коли вона валідна й відповідає видимому контенту, сторінка стає придатною до rich results: зірочки рейтингу, ціни, FAQ, breadcrumbs та інші розширені сніпети.
Ламається воно двома способами. Технічно JSON-LD може бути некоректним або без обовʼязкових властивостей, тож Google не може його розпарсити. Редакційно розмітка може описувати те, чого сторінка насправді не показує — це порушення guidelines, що може спричинити manual action. Обидва прибирають придатність до rich results, але дебажаться зовсім по-різному.
Errors проти warnings: що справді блокує rich results
І Rich Results Test, і Search Console ділять проблеми на errors і warnings, і різниця має значення:
- Errors — це відсутні обовʼязкові властивості (напр. Product без name, Offer без price). Вони роблять елемент непридатним до rich result — виправляй їх першими.
- Warnings — це відсутні рекомендовані властивості (напр. немає aggregateRating чи image). Елемент усе ще придатний, але повніший результат може виграти місце.
- Невалідні значення — неправильні типи, погані формати дат, ціни як текст — трактуються як errors для відповідного поля.
- Сторінка може мати валідний синтаксис і все одно бути непридатною, якщо тип елемента не з тих, які Google підтримує для rich results.
Найтиповіші помилки JSON-LD
- Розмітка, що не відповідає видимій сторінці — рейтинг чи ціна в JSON-LD, яких користувач не бачить, це порушення політики.
- Відсутні обовʼязкові поля: Product без offers/price, Article без headline, BreadcrumbList без position на кожному елементі.
- Неправильні типи даних: price чи rating як рядок із символом валюти, дати не в ISO 8601, відносні URL замість абсолютних.
- Кілька суперечливих блоків — два Organization чи два Product на одній сторінці з різними значеннями.
- JSON-LD, вставлений JavaScript-ом, який не потрапляє в rendered HTML, що індексує crawler.
Як знайти й виправити помилки schema
- Прожени URL через Google Rich Results Test на живій сторінці й прочитай кожен error і warning по елементах.
- Перехресно перевір Schema Markup Validator (schema.org) на суто синтаксичні й словникові проблеми.
- У Search Console користуйся звітами enhancement (Products, Breadcrumbs, FAQ), щоб бачити помилки масштабно по шаблонах.
- Спершу виправ обовʼязкові властивості, потім узгодь кожне значення з тим, що сторінка реально показує, а тоді додай рекомендовані властивості, щоб посилити придатність.
- Якщо розмітку вставляє JS, підтверди, що вона є в rendered HTML, або перенеси її на сервер.
Помилки, через які rich results знижують або прибирають
- Розмічати контент, якого немає на сторінці, або додавати review-розмітку на не-review сторінки — обидва можуть спричинити manual action.
- Виправити один шаблон товару й вважати, що весь каталог чистий; помилки schema рахуються за шаблоном і швидко масштабуються.
- Гнатися за warnings, ігноруючи той єдиний error, що робить елемент непридатним.
- Додавати schema для типів, які Google не рендерить, а потім дивуватися, чому rich result не зʼявляється.
Як перевірити schema markup
Після виправлення знову прожени Rich Results Test на живому URL і переконайся в нулі errors для потрібного типу елемента, а потім стеж за відповідним звітом enhancement у Search Console, поки виправлення розкочується по шаблонах наступні дні.
У DomainLens structured data перевіряється в тому ж аудиті, що й title, canonical і рендеринг — тож блок Product чи Article, який некоректний, відсутній або зʼявляється лише після JavaScript, спливає поруч із рештою технічного SEO сторінки, а не в окремому силосі.