Описание элементов, обрабатываемых Яндексом

Партнерские программы

Семантическая разметка страниц

Описание элементов, обрабатываемых Яндексом

Обязательные элементы

Чтобы карточка организации корректно обрабатывалась Яндексом, она должна строго соответствовать формату hCard. В частности, корневым элементом карточки должен быть элемент класса vcard. Остальные элементы (называемые свойствами) располагаются внутри корневого.

Подробные сведения о том, какие фрагменты HTML-кода рассматриваются как значения свойств, приведены в разделе Правила обработки разметки.

Кроме того, чтобы карточка могла быть загружена в базу данных Яндекс Бизнеса, она обязательно должна содержать следующие свойства:

fn и org

Название организации.

Согласно стандарту hCard, для карточек, описывающих организации, значения свойств fn и org должны совпадать между собой. Рекомендуется пометить название организации сразу двумя этими классами в одном элементе:

<span class="fn org">...</span>

adr

Адрес организации.

Адрес должен быть достаточно подробным, чтобы его можно было найти на карте. Обратите внимание, что карточки обрабатываются только для четырех стран: Россия, Украина, Беларусь, Казахстан

Для элемента класса adr будут обработаны следующие вложенные свойства (каждое из них может быть указано не более одного раза):

country-name — страна;
region — субъект федерации + район;
locality — населенный пункт;
street-address — улица, дом, корпус, строение и т. п. (то есть адрес с точностью до здания);
extended-address — здесь можно указать подъезд, этаж, офис и т. п. (то есть сведения о местонахождении внутри здания), название торгового или бизнес-центра, а также любое описание, не являющееся точным адресом;
postal-code — почтовый индекс.

Для правильного распознавания адреса необходимо указание населенного пункта (свойство locality). Если название не определяет населенный пункт однозначно (например, деревня Дубки), требуется также указание региона (свойство region).

Примечание.

Мы рекомендуем размечать только фактические (как вас найти), а не юридические адреса.

Карточка может содержать несколько адресов. Это возможно в случае, если организация имеет несколько отделений или филиалов, которые называются одинаково и имеют идентичные контактные данные (общий сайт, единый call-центр и т.п.). Если же филиалы имеют различные названия, телефоны, email-адреса, мы рекомендуем создать отдельную карточку (элемент класса vcard) для каждого филиала.

tel

Номер телефона (с кодом города).

Предпочтительный формат: +{код страны} ({код города}) {номер}, например: +7 (890) 123-45-67, +375 (12) 345-67-89. Если для пользователей необходимо отображать номер телефона в другом формате, можно использовать элемент <abbr>.

В одной карточке можно указать несколько телефонных номеров.

Пример:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="tel">Телефон: 
    <abbr class="value" title="+ 7 (890) 123-45-67">123-45-67</abbr>
  </div>
  <div class="tel">
    <abbr class="type" title="fax">Факс:</abbr> 
    <abbr class="value" title="+ 7 (890) 123-45-89">123-45-89</abbr>
  </div>
</div>

Примеры карточек, содержащих минимально необходимую информацию

<div class="vcard">
  <div>Кафе <span class="fn org">Ромашка</span></div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="tel">Телефон: 
    <abbr class="value" title="+ 7 (890) 123-45-67">123-45-67</abbr>
  </div>
</div>

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="postal-code">111222</span>,
    <span class="country-name">Россия</span>,
    <span class="region">Абрикосовский край</span>,
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>,
    <span class="extended-address">эт. 7, оф. 701</span>
    <div class="tel">Телефон: 
      <abbr class="value" title="+ 7 (890) 123-45-67">123-45-67</abbr>
    </div>
  </div>
</div>

Поддерживаемые элементы

Кроме обязательных свойств fn и org, adr, tel, Яндекс обрабатывает следующие свойства:

Мы рекомендуем по возможности указывать как можно большее количество из этих свойств. Это позволит показывать пользователям Яндекса максимально полную информацию о вашей компании.

email

Электронный адрес.

В одной карточке можно указать несколько электронных адресов.

Электронный адрес можно отображать как простой текст или как ссылку.

Примеры:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="email">cafe@cafe.com</div>
</div>

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.romashka-cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div>Электронная почта:
    <a class="email" href="mailto:cafe@cafe.com">
      romashka@romashka-cafe.ru
    </a>
  </div>
  <div>По вопросам трудоустройства:
    <a class="email" href="mailto:hr@cafe.com">
      hr@romashka-cafe.ru
    </a>
  </div>
  <div>По вопросам закупок:
    <a class="email" href="mailto:buy@cafe.com">
      buy@romashka-cafe.ru
    </a>
  </div>
</div>

geo

Географические координаты, соответствующие адресу. Указываются в градусах.

Если у вас есть эта информация, рекомендуем включить ее в карточку, поскольку она облегчает геокодирование вашего местоположения.

В карточке может быть не более одного элемента класса geo.

Для данного свойства необходимо задать вложенные свойства:

latitude — широта;
longitude — долгота.

Координаты обычно делают невидимыми для посетителей сайта, например с помощью вложенного элемента класса value-title с атрибутом title:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <span class="geo">
    <span class="latitude">
      <span class="value-title" title="55.792188"> </span>
    </span>
    <span class="longitude">
      <span class="value-title" title="37.764956"> </span>
    </span>
  </span>
</div>

Если же необходимо показывать координаты на странице, их целесообразно указать в градусах, минутах и секундах:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="geo">
   <abbr class="latitude" title="55.792188">Широта: 55°47&#8242;31.88&#8243; с. ш.</abbr> 
   <abbr class="longitude" title="37.764956">Долгота: 37°45&#8242;53.84&#8243; в. д.</abbr>
  </div>
</div>

url

Ссылка на официальный сайт организации.

Предпочтительно, ссылка должна вести на главную страницу сайта (или на страницу филиала, если карточка содержит информацию о филиале). Например, карточка находится на странице http://www.romashka-cafe.ru/contacts.html, а значение свойства url — http://www.romashka-cafe.ru.

Стандарт hCard допускает наличие нескольких элементов класса url, однако при добавлении карточки в Яндекс Бизнесе будет выбран только один из них, наиболее подходящий.

Если вы отображаете адрес сайта в блоке с контактной информацией, то класс url можно присвоить элементу <a>:

<a class="url" href="...">...</a>

Если же ваша контактная информация не содержит URL, вы можете сделать свойство url невидимым для посетителей сайта с помощью следующей конструкции:

<span class="url"><span class="value-title" title="..."> </span></span>

workhours

Время работы организации.

Свойство не предусмотрено стандартом hCard, оно добавлено Яндексом в качестве расширения.

Для указания времени работы мы рекомендуем формат, используемый в Яндекс Бизнесе, например:

пн-пт 9:00-18:00
пн-пт 9:00-18:00, обед 13:00-14:00, сб-вс 10:00-17:00, обед 13:30-14:00
пн-сб 11:00-20:00, вс 12:00-24:00
ежедн. 10:00-24:00
круглосуточно

Допустимо указывать время работы в произвольном формате.

Пример:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div>
    Мы работаем <span class="workhours">ежедневно с 11:00 до 24:00</span>
  </div>
</div>

Прочие элементы

Остальные свойства, предусмотренные форматом hCard, в настоящее время игнорируются Яндексом. Однако вы можете включить их в карточку организации, если хотите сделать эти данные доступными другим сервисам. Например, если ваша контактная информация содержит логотип организации, используйте свойство logo.

Полный список свойств представлен в официальной спецификации формата, в разделе Property List.

Чтобы ваш вопрос быстрее попал к нужному специалисту, уточните тему:

Разметка формируется в течение двух недель. Если Яндекс не поддерживает какой-то из видов разметки на странице или в разметке ошибки, то просто пропускает ее.

Робот Яндекса сможет проиндексировать информацию с сайта и без разметки, на показ страниц в поиске это не повлияет. Чтобы задать желаемое описание страницы в результатах поиска, используйте метатег description.

Подробное описание возможных ошибок см. в разделе Валидатор микроразметки.

Данная форма обратной связи предназначена для вопросов о партнерских программах Яндекса и разметке. Если вы сомневаетесь, стоит ли использовать ту или иную партнерскую программу, которую предоставляют другие сервисы (не Яндекс), то мы никак не можем прокомментировать ее возможное влияние на состояние вашего сайта в поиске.

Микроформат hCard

Правила обработки разметки