Когда я впервые добавил разметку схемы на клиентский сайт, я вручную напечатал a Product заблокируйте заголовок темы, разверните его и продолжайте чувствовать себя умным. Две недели спустя тест Rich Results Test показал мне, что объект предложения не имеет своего @type, цена была числом, где Google хотел строку, и блуждающая запятая незаметно сделала недействительным весь блок. Google все время игнорировал это. Это то, о чем никто не предупреждает вас структурированными данными: недействительный JSON-LD не выдает ошибку и не краснеет. Это просто молча ничего не делает, и вы узнаете несколько месяцев спустя, когда богатый результат, на который вы рассчитывали, никогда не появится.
Сам словарь опубликован по адресу схема.org, и то, для чего Google на самом деле покажет богатый результат, - это более узкий список в своем списке структурированная документация данных, йо-
Я создаю инструменты для жизни - Toolz.dev, плагин WP Adminify, стек приложений Laravel и React - и структурированные данные - одна из тех задач, которые я делаю достаточно часто, чтобы возмущаться, делая это вручную, и достаточно редко, чтобы каждый раз забывать точные названия свойств. Поэтому я построил Генератор разметки схемы чтобы удалить два режима отказа, которые стоят мне больше всего: неправильное вложение и бесшумная недействительность. Это руководство рассказывает о том, что на самом деле делает разметка схемы, как генератор ее создает и о конкретных ошибках, которые не позволяют достоверно выглядящей разметке получать богатые результаты.
TL;DR: Разметка схемы - это структурированные данные (с использованием словаря schema.org), которые точно сообщают поисковым системам, о чем страница, что делает ее подходящей для получения богатых результатов, таких как аккордеоны часто задаваемых вопросов, цены на продукты и панировочные сухари. Google рекомендует формат JSON-LD - автономный
<script type="application/ld+json">блок. Генератор строит действительный JSON-LD для девяти распространенных типов, гнездит подобъекты типаPostalAddressаOfferправильно, флаги отсутствуют обязательные и рекомендуемые поля, и запускается 100% в вашем браузере, поэтому ничего из введенного вами текста не загружается.
Что такое разметка схемы и почему это имеет значение?
Разметка схемы - это стандартизированный способ описания содержимого страницы, чтобы машины могли его понять, а не просто отображать. словарь взят из schema.org, общего проекта, поддерживаемого Google, Microsoft, Yahoo и Яндекс. когда вы размечаете страницу как Article, вы говорите поисковой системе & quot;это новость или статья в блоге, вот ее заголовок, вот кто ее написал, вот когда она была опубликована. & quot; это структурированное описание - это то, что делает страницу подходящей для богатых результатов - расширенные списки со звездными рейтингами, ценами, раскрывающимися часто задаваемыми вопросами, датами событий и следами от хлебного кроха, которые занимают больше места и зарабатывают больше кликов, чем простая синяя ссылка.
Причина, по которой это важно, изменилась за последние несколько лет. Раньше это было чисто о богатых результатах в Google. Теперь структурированные данные также питают механизмы ответов ИИ и обзоры ИИ Google's. Когда ChatGPT, Perplexity или Gemini пытаются обобщить, что делает ваш бизнес или какой продукт соответствует запросу, чистые структурированные данные являются одним из сигналов, которые помогают им правильно излагать факты. Страница, которая четко объявляет себя Organization с именем, логотипом и социальными профилями любой машине гораздо легче рассуждать, чем с той, которая оставляет все неявным в HTML.
Загвоздка в том, что структурированные данные неумолимы Это код, и код должен быть точно правильным. Свойство написано datePublish вместо datePublished просто игнорируется. Ан Offer без ан @type не признается как предложение. и поскольку ни одна из этих ошибок не ломает видимую страницу, они скрываются в производстве бесконечно. это пробел, который заполняет генератор - не писать концепции для вас, а каждый раз правильно использовать синтаксис и структуру.
Почему JSON-LD вместо Microdata или RDFa?
Существует три способа добавления данных schema.org на страницу, и это помогает понять, почему генератор выдает только один из них.
Микроданные а РДФа вплетайте структурированные данные непосредственно в видимый HTML, используя дополнительные атрибуты - itemscope, itemprop, propertyи так далее. Ваш <div> для обзора продукта получает атрибуты, которые маркируют каждый фрагмент видимого текста Это работает, но он плотно соединяет вашу разметку со структурой вашей страницы Изменить макет и вы рискуете сломать схему, Это также многословно и трудно читать.
ДЖСОН-ЛД использует противоположный подход. Он помещает все структурированные данные в единый автономный <script type="application/ld+json"> блок, обычно в <head>, полностью отделенный от видимого HTML. Google рекомендовал JSON-LD в течение многих лет именно из-за этого разделения: вы можете добавить его, обновить или внедрить через менеджер тегов, не касаясь ваших шаблонов. Это формат, которому учит каждый современный учебник по схемам, и это то, что генератор выводит.
| формат | Где живет | Простота обслуживания | Google's позиция |
|---|---|---|---|
| ДЖСОН-ЛД | Одиночный <script> блокировать, отдельно от HTML |
Легче всего - отредактировать один блок | рекомендуемый |
| Микроданные | Атрибуты внутри видимого HTML | Более сложный - в сочетании с компоновкой | поддерживаемый |
| РДФа | Атрибуты внутри видимого HTML | Более сложный - в сочетании с компоновкой | поддерживаемый |
Если вы работаете в WordPress, JSON-LD также является тем, что внедряется большинством плагинов SEO, и то, что инструмент, такой как WP Adminify, находится рядом с чисто. Поскольку это автономный блок, вы можете сгенерировать его здесь и вставить в пользовательское поле HTML, менеджер тегов или макет лезвия Ларавеля без какой-либо гимнастики, специфичной для конкретной платформы.
Как использовать генератор разметки схемы?
Рабочий процесс построен на выборе типа и заполнении короткой формы с предварительным просмотром в реальном времени, чтобы вы видели сборку JSON-LD по мере ввода.
Шаг 1. Выберите тип схемы. Выберите из организации, LocalBusiness, WebSite, статьи, продукта, FAQPage, BreadcrumbList, человека или события. форма немедленно меняется на поля, которые требуют типа. Эти девять охватывают подавляющее большинство того, для чего на самом деле нужны небольшие и средние сайты.
Шаг 2 - Заполните поля. Обязательные поля отмечены звездочкой При вводе инструмент собирает JSON-LD и опускает любое поле, которое вы оставляете пустым, поэтому вы никогда не останетесь пустым "" свойства, загрязняющие вывод. для типов, основанных на адресах, таких как LocalBusiness и Event, отдельные поля адреса складываются в правильно напечатанные PostalAddress объект автоматически.
Шаг 3 - Следите за проверкой. Генератор отмечает два вида проблем Ошибки (отсутствуют обязательные поля, неверные URL-адреса) блокируют чистый результат и отображаются красным. Предупреждения (отсутствуют рекомендованные Google поля, например image или datePublished, или шаблон URL поиска, у которого отсутствует заполнитель) показаны янтарным цветом - разметка все еще действительна, но вы оставляете на столе богатый потенциал результата.
Шаг 4 - Скопируйте и разверните. Переключайтесь между полным <script> тег (готовый к вставке в ваш <head>) и необработанный JSON (для менеджеров тегов и полей CMS).Выход сценария ускользает от персонажей, которые в противном случае позволили бы отклониться </script> в ваших данных разбить страницу. Затем проверить живую страницу с помощью Google's Rich Results Test.
Поскольку все работает на стороне клиента, это безопасно использовать на неопубликованных страницах продуктов, средах постановки и работе с клиентами в рамках NDA. Ваши цены, детали событий и внутренние URL-адреса никогда не покидают браузер - та же позиция конфиденциальности за каждым инструментом на сайте, о которой я писал в Руководство по конфиденциальности данных, йо-
Какие типы схем мне действительно следует использовать?
Не каждая страница нуждается в разметке, и нагромождение типов, которые вы не можете поддерживать, хуже, чем отсутствие. Вот как я думаю о девяти, которые охватывает генератор.
Организация принадлежит вашей домашней странице или странице о компании - это схема, которая питает панели знаний и помогает Google подключить ваш бренд к своим социальным профилям sameAs, йо- Веб-сайт соединяется с ним и может объявить поле поиска Sitelinks через a SearchAction, позволяя пользователям искать ваш сайт прямо со страницы результатов. МестныйБизнес это важно, если у вас есть физическое местоположение: он содержит ваш адрес, телефон, ценовой диапазон и часы работы, а также подтверждает результаты локального пакета и карты.
Статья (с которым излучает генератор Article тип, одинаково действительный для сообщений в блоге), отмечает редакционный контент заголовком, автором, издателем и датами публикации. Продукт описывает что-то продаваемое, с вложенным Offer цена переноса, валюта и доступность - вот что определяет цены и доступность. Событие охватывает все, что угодно, с датой и местом, от конференции до вебинара.
FAQPage а Список хлеба являются структурными, а не о & quot;thing. & quot; FAQPage отмечает содержание вопросов и ответов; обратите внимание, что Google сузил часто задаваемые вопросы богатые результаты до авторитетных правительственных и медицинских сайтов, но разметка по-прежнему помогает другим поисковым системам и ИИ-системам ответов анализировать ваши вопросы и ответы;A. BreadcrumbList производит следы хлебного кроха, показанные под вашим названием в результатах, что улучшает чтение структуры вашего URL-адреса. Персона отмечает человека - автора, основателя или общественного деятеля - и полезен для авторских биографий и сигналов EET.
Правило, которому я следую: разметьте, о чем действительно страница, и заявляйте только свойства, которые отражают контент, действительно видимый на странице. Рекомендации Google's четко указывают, что структурированные данные должны описывать реальный, видимый контент - выставление цены, которая не отображается на странице, является нарушением, а не ярлыком.
Как генератор сохраняет действительную разметку?
Ценность в деталях, которые легко ошибиться вручную. стоит окликнуть несколько.
Правильное гнездование с @type, йо- В JSON-LD вложенные объекты не являются простыми подобъектами - каждому нужен свой собственный @type. Адрес - это а PostalAddressпредложение есть Offer, статья's автор - а Personего издатель - Organization чей логотип является ImageObject. Генератор строит каждый из них правильного типа, поэтому синтаксический анализатор распознает их, а не рассматривает как анонимные капли.
Обрезка пустот. Оставление поля пустым должно удалить свойство, а не излучать "telephone": "". Пустые строки и пустые массивы удаляются с вывода автоматически, поэтому то, что вы копируете, всегда чисто.
Безопасный для сценариев побег. Единственный самый опасный персонаж встроенного JSON-LD - это a < - конкретно последовательность </script> появление внутри ваших данных (скажем, в описании), что приведет к досрочному завершению блока сценариев и разрыву страницы. Генератор убегает <, >, и & в выводе тегов сценариев с использованием unicode escapes, что именно и делают собственные примеры Google's.
Требуемая и рекомендуемая осведомленность. Каждый тип несет свой собственный список того, что Google требует от рекомендаций. Статья действительно хочет image а datePublished; Продукт хочет а price; Событию нужен а startDate. Инструмент отличает жесткие требования (которые он рассматривает как ошибки) от рекомендаций (предупреждений), поэтому вы знаете разницу между & quot; это не будет работать & quot; и & quot; это может работать лучше. & quot;
Если вы собираете более широкий технический рабочий процесс, генератор схем естественным образом располагается рядом с другими утилитами SEO - Генератор метатегов для вашего названия, описания и тегов Open Graph, и Генератор карты сайта XML для отправки ваших URL-адресов. Вместе они охватывают большую часть технической поверхности SEO на странице, и по этой причине я сгруппировал их в обзор инструментария веб-разработчика, йо-
Как протестировать и развернуть структурированные данные?
Создание действительного JSON-LD - это половина работы; другая половина подтверждает, что Google читает его так, как вы задумали.
Начните с Google's Тест на богатые результаты, который получает URL-адрес или принимает вставленный код и отчеты, для которых тип результатов с богатым уровнем соответствует требованиям страницы, а также любые ошибки или предупреждения. Затем выполните ту же разметку через Проверка разметки схемы на validator.schema.org, который проверяет соответствие самому словарю schema.org, а не требованиям Google's rich-result.The two catch different things: Rich Results Test говорит вам, имеете ли вы право на конкретную функцию Google, в то время как валидатор сообщает, является ли разметка структурно обоснованной schema.org.
Как только страница будет открыта, об улучшении будет сообщено Консоль поиска Google отслеживайте производительность с течением времени и отмечайте ошибки, которые Google находит во время сканирования. Здесь вы обнаруживаете проблемы, которые появляются только в масштабе - шаблон, который, скажем, излучает дублированные позиции хлебного крошка, или канал продукта, в котором иногда отсутствует необходимое поле.
Для развертывания вставьте <script> блокировать в <head> о конкретной странице, которую он описывает. не помещайте ни одного блока Продукта в глобальный шаблон, который работает на каждой странице - разметка должна соответствовать странице, на которой он живет. в CMS, использовать любое пользовательское поле-HTML или SEO, которое дает вам платформа. в менеджере тегов, использовать пользовательский тег HTML и копировать JSON. в приложении React или Laravel, внедрить блок сервер-сторону, чтобы сканеры видели его в начальном HTML, а не после гидратации.
Общие ошибки, которые я вижу до сих пор
Несколько ошибок появляются снова и снова, и каждая из них создает наценку, которая выглядит хорошо, но ничего не делает.
Классика есть маркировка невидимого контента - добавление рейтинга обзора или цены, которая нигде не отображается на странице. Google прямо запрещает это и может выполнить ручное действие для него. Второй неправильный тип на вложенном объектеобычно отсутствует @type по адресу или предложению Третий объединение подобных типовнапример, использование Product наценка на странице списка категорий, а не на одном товаре. И четвертый, мой личный враг, есть синтаксическая ошибка ручного редактирования - конечная запятая или неэкранированная цитата, которая делает недействительным весь блок.
Каждый из них является почему генератор зарабатывает свою крепость, Он не может знать, видна ли ваша цена на странице - то есть на вас - но он никогда не будет излучать конечную запятую, недостающую @type, или пустое свойство. Уже одно это устраняет большинство способов бесшумного сбоя структурированных данных. Для более глубокого изучения рабочих процессов разработчика вокруг такого рода инструментов Руководство по инструментам кодирования хорошее чтение для компаньона.
Часто задаваемые вопросы
Что такое разметка схемы?
Разметка схемы - это структурированные данные, которые описывают контент страницы & #39;s для поисковых систем, использующих общий словарь schema.org. добавление может сделать страницу подходящей для получения богатых результатов, таких как аккордеоны часто задаваемых вопросов, цены на продукты, звезды обзоров и панировочные сухари.JSON-LD, формат, который производит этот инструмент, является синтаксисом, который рекомендует Google, поскольку он живет в одном теге сценария, отдельном от вашего видимого HTML.
В чем разница между JSON-LD, MicroData и RDFA?
Все три способа добавить структурированные данные Schema.org на страницу. Микроданные и RDFA — это атрибуты, вплетенные в ваш видимый HTML, а JSON-LD — это автономный блок JSON в теге скрипта. Google рекомендует JSON-LD, потому что его проще добавлять, обновлять и хранить отдельно от разметки страницы. По этой причине этот инструмент выводит JSON-LD.
Куда поместить сгенерированный JSON-LD?
Вставьте полную <script type="application/ld+json"> тег в <head> страницы, которую он описывает, или где-либо еще <body> - Google читает его в любом месте. Если вы используете Google Tag Manager, скопируйте JSON и добавьте его через пользовательский HTML-тег. Всегда размещайте разметку на той же странице, содержимое которой оно описывает, а не на шаблоне, который применяет ее повсюду.
Гарантирует ли добавление разметки схемы богатые результаты?
нет Достоверные структурированные данные позволяют странице иметь право на получение богатых результатов, но Google решает, следует ли показывать их на основе качества, актуальности и собственных руководящих принципов. Ваша разметка также должна отражать контент, который действительно виден на странице. Думайте о схеме как о требованиях к богатым результатам, а не как о коммутаторе, который их включает.
Как проверить структурированные данные?
Запустите сгенерированную разметку через Google's Rich Results Test и средство проверки разметки схемы (schema.org's validator).И анализируйте свой JSON-LD, и сообщайте об отсутствии необходимых полей или синтаксических ошибках.После того, как страница находится в реальном времени, отчеты об улучшениях консоли поиска Google отслеживают, как ваши структурированные данные работают с течением времени.
Какие поля необходимы для каждого типа?
Требования варьируются в зависимости от типа: статья нуждается в заголовке, продукту нужно имя, событие требует имени и даты начала, а FAQPAGE — хотя бы один вопрос и ответ. Этот инструмент отмечает обязательные поля и блоки, пока они не будут заполнены, а также предупреждают о рекомендуемых полях, которые повышают ваши шансы на получение богатого результата.
Могу ли я создать схему часто задаваемых вопросов для моей страницы?
да. Выберите тип FAQpage, добавьте каждый вопрос с его ответом, и инструмент автоматически создаст массив MainEntity для объектов вопросов и ответов. Обратите внимание, что Google теперь показывает богатые FAQ результаты в основном для авторитетных правительственных сайтов и сайтов здравоохранения, но эта разметка остается действительной и полезной для других поисковых систем и систем ответов на ИИ.
Являются ли мои данные закрытыми?
Да. JSON-LD полностью собран в вашем браузере с простым JavaScript. Ничто из того, что вы вводите - включая неопубликованные цены, сведения о событиях или частные URL-адреса - не передается, не регистрируется и не сохраняется, и генератор продолжает работать без сетевого соединения после загрузки.
