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. Перед использованием убедитесь, что выбранный плагин позволяет передать в код страницы все нужные элементы разметки.

Мы не рекомендуем использовать для разметки материалов системы управления тегами — в этом случае Метрика не сможет корректно обработать размеченные данные. Но такие системы можно использовать для других целей, например, для установки счетчика на сайт.

Внимание. Все размеченные сущности Schema.org должны быть внутри тега body. Если на странице несколько материалов, каждый из них должен быть размечен отдельно. Важно учесть эти требования, чтобы статистика собиралась правильно.

Выберите тип материала:

Для разметки статьи, новости или поста используйте любую из сущностей Article, NewsArticle или BlogPosting. Разметьте следующие элементы материала (обязательные элементы отмечены звездочкой):

Идентификатор*
Идентификатор указывается с помощью свойства identifier. Он позволяет Метрике отличать материалы друг от друга. Идентификатор не отображается в отчетах.
<meta itemprop="identifier" content="12345">
Также идентификатор можно указать с помощью свойства mainEntityOfPage. Оно будет использоваться, если не найдено свойство identifier. В нем ищется значение атрибута itemid, которое будет использоваться в качестве идентификатора.
<meta itemscope itemprop="mainEntityOfPage" 
  itemType="https://schema.org/WebPage" itemid="/life/weather/12345.html"/>

Если не найдено ни одно из свойств выше, в качестве идентификатора будет использоваться заголовок наивысшего уровня из тегов <h1>...<h6> или значение атрибута href канонической ссылки.

Если размечено несколько идентификаторов, будет использоваться первое найденное значение.
Заголовок*
Заголовок может быть указан с помощью свойств headline или alternativeHeadline и отображается в отчетах Метрики. Если заданы оба свойства, их значения будут записаны чере