Microdata
Microdata — это способ разметки, при котором данные передаются в стандартных элементах языка HTML.
Принципы разметки
Для разметки материала добавьте атрибут itemscope к любому тегу, в котором содержится описываемая сущность. Чтобы указать, что это за сущность, сразу после itemscope добавьте атрибут itemtype и в качестве его значения пропишите нужный класс в видеitemtype="http://schema.org/<Имя класса>"
. Сущности также можно вкладывать друг в друга. Например, так можно указать, что содержимое тега div описывает новостную статью (класс NewsArticle), а тега p — персону (класс Person):<div itemscope itemtype="http://schema.org/NewsArticle">
<h1>В Москве побит температурный рекорд 1922 года</h1>
<p itemscope itemtype="http://schema.org/Person">
Автор: <span>Иван Иванов</span> — <span>специальный корреспондент</span></p>
<p>В среду, 6 ноября, в Москве был побит температурный рекорд,
зафиксированный в 1922 году. Температура воздуха составила плюс 12,1 градуса
по Цельсию, как сообщает центр «Фобос».</p>
</div>
Чтобы указать свойства сущности, используйте атрибут itemprop. Список доступных свойств можно найти в описании соответствующего класса на сайте стандарта. В примере ниже с помощью свойств NewsArticle размечены элементы, описывающие заголовок статьи, ее автора и текст, а с помощью Person — имя и должность автора:
<div itemscope itemtype="http://schema.org/NewsArticle">
<h1 itemprop="headline">В Москве побит температурный рекорд 1922 года</h1>
<p itemprop="author" itemscope itemtype="http://schema.org/Person">
Автор: <span itemprop="name">Иван Иванов</span> —
<span itemprop="jobTitle">специальный корреспондент</span> </p>
<p itemprop="articleBody">В среду, 6 ноября, в Москве был побит температурный рекорд,
зафиксированный в 1922 году. Температура воздуха составила плюс 12,1 градуса
по Цельсию, как сообщает центр «Фобос».</p>
</div>
Машиночитаемая информация
При разметке материала можно использовать не только сущности Schema.org, но и машиночитаемую информацию. Ее не видят читатели, но могут обработать браузеры, поисковые системы или роботы.
- Тег meta
-
Иногда важная информация не может быть размечена из-за способа ее отображения на странице. Например, когда информация представлена на рисунке, во Flash-объекте или явно не указана на странице. В таких случаях можно использовать тег meta с атрибутом content. В примере ниже с помощью meta и свойства класса Article указана тематика материала:
<meta itemprop="about" content="Погода">
Этим приемом не следует злоупотреблять. Используйте тег meta с атрибутом content только для той информации, которую невозможно разметить иным способом.
Внимание. В размеченных сущностях Метрика сначала ищет значение в атрибуте content, а затем — в содержимом тега. - Дата и время
-
Для записи времени можно использовать атрибут datetime тега time. Даты записываются в формате ISO 8601. В примере ниже на странице будет отображена дата 10:30, 6 ноября 2018, а роботу передана 2018-12-11T07:30:00Z.
<time itemprop="datePublished" datetime="2018-11-06T07:30:00Z"> 10:30, 6 ноября 2018</time>
Какие материалы можно разметить
Метрика поддерживает разметку следующих материалов:
- Статья, новость или пост в блоге (Article, NewsArticle или BlogPosting)
- Описание фильма (Movie)
- Обзор или отзыв (Review)
- Рецепт (Recipe)
- Вопрос-ответ (Question)
Другие материалы, размеченные по стандарту, не попадут в отчеты Метрики.
Как разметить материал
При разметке материала вы можете использовать как сущности Schema.org, так и машиночитаемые данные, описанные выше.
Разметьте материал в соответствии с приведенными ниже правилами, чтобы он корректно обрабатывался Метрикой. Для получения более полной статистики рекомендуем разметить все элементы материала, но обязательными являются только три — идентификатор, заголовок и текст. Если вы уже используете Schema.org, проверьте, соответствует ли разметка на вашем сайте этим требованиям. Примеры кода в правилах не являются единственно правильным вариантом разметки.
Разметку можно добавить на сайт автоматически — например, с помощью плагинов для WordPress. Перед использованием убедитесь, что выбранный плагин позволяет передать в код страницы все нужные элементы разметки.
Мы не рекомендуем использовать для разметки материалов системы управления тегами — в этом случае Метрика не сможет корректно обработать размеченные данные. Но такие системы можно использовать для других целей, например, для установки счетчика на сайт.
Выберите тип материала:
Для разметки статьи, новости или поста используйте любую из сущностей Article, NewsArticle или BlogPosting. Разметьте следующие элементы материала (обязательные элементы отмечены звездочкой):
- Идентификатор*
- Идентификатор указывается с помощью свойства identifier. Он позволяет Метрике отличать материалы друг от друга. Идентификатор не отображается в отчетах.Также идентификатор можно указать с помощью свойства mainEntityOfPage. Оно будет использоваться, если не найдено свойство identifier. В нем ищется значение атрибута itemid, которое будет использоваться в качестве идентификатора.
<meta itemprop="identifier" content="12345">
<meta itemscope itemprop="mainEntityOfPage" itemType="https://schema.org/WebPage" itemid="/life/weather/12345.html"/>
Если не найдено ни одно из свойств выше, в качестве идентификатора будет использоваться заголовок наивысшего уровня из тегов <h1>...<h6> или значение атрибута href канонической ссылки.
Если размечено несколько идентификаторов, будет использоваться первое найденное значение. - Заголовок*
- Заголовок может быть указан с помощью свойств headline или alternativeHeadline и отображается в отчетах Метрики. Если заданы оба свойства, их значения будут записаны чере