Технічні вимоги

Експорт даних для розміщення заголовків і анотацій новин на yandex.ua (зокрема й на сайтах Яндекс.Новини) здійснюється в XML-based форматі RSS 2.0.

  1. Опис елементів RSS 2.0
  2. Символи та кодування
  3. Механізм експорту даних
  4. Приклад експортного файлу

Опис елементів RSS 2.0

Кореневим елементом RSS-файлу є rss, атрибут version якого повинен мати значення 2.0.

<rss 
   xmlns:yandex="http://news.yandex.ru" 
   xmlns:media="http://search.yahoo.com/mrss/"
   xmlns:turbo="http://turbo.yandex.ru"
   version="2.0">
   ...
</rss>

Усередині елемента rss міститься елемент channel, який, зокрема, має інформацію про джерело і його вміст.

  1. Передавання інформації про сайт-джерело
  2. Передавання інформації про повідомлення
  3. Турбо-сторінки
  4. Опис елементів для відео- та фоторепортажів

Передавання інформації про сайт-джерело

Відомості передаються в елементі channel.

ЕлементОпис
title

Назва RSS-каналу.

Якщо експортується вміст усього сайту, зазначте його назву.

<title>Українські новини</title>

Якщо експортується розділ сайту, зазначте назву сайту і розділу через двокрапку.

<title>Українські новини: технології</title>
Примітка. На yandex.ua назву RSS-каналу не показано, дані, що експортуються, маркуються тією назвою джерела, яку було зазначено в анкеті під час підключення до сервісу Яндекс.Новини.
link

Домен сайту, дані якого транслюються.

<link>http://www.example.com</link>
description

Опис каналу одним реченням. Не використовуйте HTML-розмітку.

<description>Щоденна газета</description>
language

Мова статті за стандартом ISO 639-1.

<language>uа</language>
yandex:analytics

Лічильник системи статистики для обліку відвідуваності Турбо-сторінок.

Обов’язковий елемент, якщо використано атрибут turbo зі значенням true.

Докладно

yandex:adNetwork

Ідентифікатор рекламного блока.

Використовується для відображення блоків Рекламної мережі Яндекса і сторонньої реклами, підключеної через ADFOX на Турбо-сторінках. А також для обліку доходів від реклами за умови використання Турбо-сторінок.

Докладно

item *

Інформація про сторінку та її вміст.

Кожен item описує лише одне новинне повідомлення. У channel може міститися будь-яка кількість елементів item.

Щоб використовувати формат Турбо-сторінок, додайте атрибут turbo зі значенням true. Щоб вимкнути відображення Турбо-сторінки, використайте значення false. Докладніше див. у розділі Керування відображенням Турбо-сторінок.

Для передавання новинних повідомлень у item зазначаються такі обов’язкові елементи:

  • title* — заголовок повідомлення;
  • link* — URL повідомлення;
  • pubDate* — час публікації повідомлення на сайті джерела;
  • yandex:full-text* — повний текст повідомлення.
<item turbo="true">
  <title>Заголовок повідомлення</title>
  <link>http://www.example.com/page.html</link>
  <pubDate>Sun, 29 Sep 2002 19:59:01 +0300</pubDate> 
  <yandex:full-text>Повний текст повідомлення</yandex:full-text>
</item>

* Обов’язковий елемент.

Передавання інформації про повідомлення

Дані передаються в елементі item.

ЕлементОпис
title *

Заголовок повідомлення.

<title>Яндекс шукає на президентському сайті</title>

Елемент title повинен містити актуальний варіант заголовка повідомлення, такий як на сторінці з новиною на сайті.

Максимальна довжина заголовка — 200 символів.

Заборонено:

  • передавати заголовок повідомлення, написаний повністю прописними літерами;
  • ставити крапку в кінці заголовка;
  • зазначати у заголовку назву джерела, дату або час повідомлення;
  • додавати до заголовка службові примітки (наприклад, «оновлено», «доповнено», «фоторепортаж», «відео») і неінформативні звороти, які не є невід’ємною частиною заголовка (наприклад, «Терміново!» або «Сенсація»).
turbo

Ознака Турбо-сторінки.

Щоб показувати повідомлення в форматі Турбо, додайте до елемента item атрибут turbo зі значенням true.

...
  <item turbo="true">
    ... 
  </item>
turbo:topicЗаголовок повідомлення, який можна передати у систему веб-аналітики. Підтримується тільки Яндекс.Метрикою.
link *

URL сторінки-джерела.

<link>http://www.example.com/page1.html</link>
Вимоги:
  • посилання повинно містити схему HTTP або HTTPS;
  • домен, зазначений у посиланні, повинен відповідати домену сайту-джерела;
  • максимальна довжина URL — 243 ;
  • за одним URL повинна бути доступною одна стаття;
  • URL не повинні повторюватися або відрізнятися лише адресою після символу # або !#. Наприклад, http://www.some-host.ru/news.html#2545 і http://www.some-host.ru/news.html#5794. Такі посилання вважаються ідентичними і не допускаються до передавання усередині одного елемента item.
  • У разі переходу із заголовка, розміщеного на Яндекс.Новинах, повинна відкриватися сторінка, що містить лише одне повідомлення, що відповідає заголовку. Водночас заголовок і початок тексту повинно бути видно на першому екрані за роздільної здатності 1024 × 768.
turbo:sourceURL сторінки-джерела, який можна передати у систему веб-аналітики. Підтримується тільки Яндекс.Метрикою.
pubDate *

Час публікації повідомлення на сайті джерела. Передається у форматі RFC-822.

<pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
<!-- Значення «+0300» визначає часовий пояс. 
Запис означає, що новина датована 21 квітня 2015 року, 
14:15 за московським часом. -->

Час, зазначений в експортному файлі, має збігатися з фактичним часом публікації на сайті. Актуальними вважаються повідомлення за останні 8 днів. Решту проіндексовано не буде.

author

Автор повідомлення.

<author>Іван Петров</author>
turbo:content *

Вміст Турбо-сторінки.

yandex:related

Ви можете розмістити посилання на інші ресурси або налаштувати відображення безперервної стрічки статей, реалізованої, наприклад, за допомогою AJAX.

Блок з посиланнями на інші сторінки сайту
Примітка. Відображається лише на Турбо-сторінках.

Додайте до yandex:related елемент link. Кількість вкладених елементів необмежена.

Щоб додати до статті зображення, використайте атрибут img з URL, за яким доступна ілюстрація.

Перетворюваний в елемент link текст не повинен містити HTML-елементи.

<yandex:related>
  <link
   url="http://www.example.com/page.html"
   img="http://www.example.com/image.png">Текст посилання
  </link>
</yandex:related>
Безперервна стрічка статей

Додайте до елемента yandex:related атрибут type зі значенням infinity. Усередині елемента yandex:related зазначте елемент link із посиланням на статтю.

Щоб додати до статті зображення, використайте атрибут img з URL, за яким доступна ілюстрація.

Перетворюваний в елемент link текст не повинен містити HTML-елементи.

<yandex:related type="infinity">
  <link
   url="http://www.example.com/page.html"
   img="http://www.example.com/image.png">Текст посилання
  </link>
</yandex:related>

Якщо ви підключили до Турбо-сторінок рекламу за допомогою ADFOX, на вкладці Сайти виберіть у параметрі Тип банерів значення <неповторювані банери>.

Якщо ви підключили до Турбо-сторінок рекламу за допомогою ADFOX:

  1. Перейдіть на вкладку Сайти.
  2. Відкрийте Розділи проекту.
  3. Виберіть майданчик.
  4. Відкрийте Параметри майданчика.
  5. У полі Тип коду виберіть значення <неповторювані банери>.
Приклад
yandex:full-text *

Текст новини.

Елемент yandex:full-text повинен містити повний актуальний текст новини. Він використовується для індексування пошуковим роботом, на yandex.ua текст не розміщується. Якщо текст новини на сайті було змінено після публікації, його необхідно оновити й у yandex:full-text.

<yandex:full-text>повний текст новини</yandex:full-text>

В елементі yandex:full-text заборонено передавати:

  • назву джерела;
  • дату або час повідомлення;
  • контактну інформацію;
  • посилання на зображення, аудіо- та відеофайли (для цих посилань потрібно формувати окремі теги enclosure, media:group).
pdalink

Посилання на версію повідомлення, адаптовану для мобільних пристроїв.

Щоб мобільна версія повідомлення була доступною на https://m.news.yandex.ru/, передайте в елементі pdalink посилання на відповідне повідомлення в мобільній версії сайту джерела.
<pdalink>http://www.m.rossiyskie-novosti.ru/page.html</pdalink>
amplink

Посилання на AMP-версію повідомлення.

Посилання на сторінки в форматі AMP, якщо вони є у вашому експортному файлі, буде використано у версії Яндекс.Новин для пристроїв з тачскрином замість посилань на звичайні мобільні і адаптивні сторінки.

Щоб передавати AMP-версії новин, зазначте в елементі amplink посилання на AMP-версію сторінки з відповідним повідомленням.

<amplink>http://amp.vesti.ru/doc.html?id=27</amplink>
description

Короткий опис повідомлення (анотація, лід). Не використовуйте HTML-розмітку.

<description>Продукт Яndex.Site встановлено на сайті 
президента Росії</description>
yandex:genre

Жанр повідомлення.

Зазначається латиницею:

  • lenta — коротке новинне повідомлення (50–80 символів);
  • message — більш розгорнуте новинне повідомлення;
  • article — стаття;
  • interview — інтерв’ю.
<yandex:genre>article</yandex:genre>
category

Рубрика (розділ, категорія).

Зазначається оригінальна (як у виданні) назва рубрики, у якій опубліковано повідомлення. Одному повідомленню може відповідати лише одна рубрика.

<category>Технології</category>
Увага. Про зміну рубрикації видання або про додавання до експортного файлу матеріалів нових рубрик слід повідомляти за адресою info@news.yandex.ru. Інакше повідомлення, які стосуються раніше не існуючих або перейменованих рубрик видання, проіндексовані не будуть.
enclosure

Ілюстрації, аудіо- та відеофайли.

В одному елементі зазначається посилання на одну ілюстрацію, аудіо або відео. Якщо в повідомленні є кілька ілюстрацій, або ілюстрація та відеофайл, використовуйте кілька елементів enclosure.

Вимоги до ілюстрацій:

  • Ширина не менше ніж 240 пікселів, довжина не менше ніж 300 пікселів. Ілюстрації меншого розміру не індексуються.

    Якщо є кілька варіантів однієї ілюстрації, що відрізняються за розміром, в enclosure повинно бути зазначено URL зображення найбільшого розміру.

  • Ілюстрації повинно бути дозволено індексувати у файлі robots.txt.

Для зображень параметр type повинен збігатися з тим, що віддається за зазначеним URL. Значення url обов’язкове. Значення type вкрай рекомендоване, а якщо неможливо визначити тип контенту за розширенням файлу, то обов’язкове.

<enclosure 
  url="http://www.rossiyskie-novosti.ru/01.jpg" 
  type="image/jpeg"/>
media:group

Група пов’язаних медіаоб’єктів.

Можна зазначити будь-яку кількість елементів media:group. Вкладені групи не допускаються. Атрибутів у елемента немає.

Елемент media:group застосовується у таких випадках:

  • Для об’єднання двох відео, що відрізняються форматами. Різні за змістом відео об’єднувати не рекомендовано.
  • Для об’єднання плеєра і тумбнейла. Ширина тумбнейла повинна бути не менше ніж 240 пікселів, а довжина — не менше ніж 300 пікселів. Відео, що супроводжується тумбнейлом розміром менше ніж 300 × 240 пікселів, проіндексовано не буде.
  • Для групування відео й аудіо, якщо аудіофайл є звуковою доріжкою до відео.
  • Для якіснішого індексування відеофайлів, які супроводжують повідомлення, разом із елементом enclosure або замість нього.

У media:group може бути вкладено такі елементи:

  • Один або кілька елементів media:content, в одному з яких може бути проставлено атрибут isDefault.
  • Лише один елемент media:player. Якщо в групі міститься media:player, замість прямого посилання на файл зазначте посилання на плеєр.
  • Один або кілька елементів media:thumbnail, їх слід зазначати в порядку спадання пріоритету.
Увага. Елемент media:group обов’язково повинен містити media:thumbnail, а також хоча б один елемент media:content або media:player. Використовувати всі три елементи не потрібно.
<media:group>
  <media:content
   url="посилання на відеофайл на вашому сайті"/>
  <media:player
   url="посилання на плеєр на вашому сайті"/>
  <media:thumbnail
   url="посилання на ілюстрацію, яка повинна 
 бути використана як preview"/>
</media:group>

* Обов’язковий елемент.

Турбо-сторінки

Опис елементів, що передають вміст Турбо-сторінки

Контент для Турбо-сторінки передається за допомогою елемента turbo:content.

Увага. Обов’язкові вимоги:
  • Перетворіть вміст елемента turbo:content на тег ![CDATA []].
  • Додайте в turbo:content елемент header з текстом заголовка повідомлення. Заголовок потрібно перетворити на тег h1. Він повинен відповідати заголовку в title.
  • Додайте до turbo:content повний текст повідомлення. Цей текст повинен відповідати тексту в yandex:full-text.
  • Зображення та відеоматеріали продублюйте в елементі enclosure.
Шапка сторінки (верхня частина сторінки)

Використовуйте елемент header, який може містити:

ЕлементОпис
figureМістить елемент img з адресою зображення, яке використовується як обкладинка. Зображення може бути в будь-якому форматі.
<header>
    <figure>
        <img src="http://example.com/img.jpg" />
    </figure>
    ...
</header>
h1 *Заголовок першого рівня.
<h1>Текст заголовка</h1>
h2

Заголовок другого рівня.

<h2>Текст заголовка</h2>
menu

Елементи меню.

Оформлення тексту
ЕлементОпис
h1
Заголовок першого рівня.
<h1>Заголовок сторінки</h1>

Підтримується шість рівнів заголовків.

p
Параграф.
<p>Параграф тексту</p>
br
Перенесення рядка без відступу.
<br>Текст</br>
ul
Маркований список.
<ul>
    <li>перший пункт списку</li>
</ul>
ol
Нумерований список.
<ol>
    <li>перший пункт списку</li>
</ol>
b
Виділення тексту жирним.
<b>Текст</b>
strongВиділення тексту. Зазвичай браузери відображають його жирним.
<strong>Текст</strong>
iВиділення тексту курсивом.
<i>Текст</i>
emВиділення тексту. Зазвичай браузери відображають його курсивом.
<em>Текст</em>
supВерхній індекс.
2<sup>3</sup>
subНижній індекс.
H<sub>2</sub>O
ins

Виділення тексту, який було додано до нової версії статті. Більшість браузерів відображають його підкресленим.

Основний текст, <ins>новий текст</ins>
del

Виділення тексту, який було видалено у новій версії статті. Більшість браузерів відображають його закресленим.

Основний текст, <del>видалений текст</del>
small
Зменшення розміру шрифту на одну умовну одиницю.
<small>Текст</small>
bigЗбільшення розміру шрифту на одну умовну одиницю.
<big>Текст</big>
pre
Виділення попередньо форматованого тексту.
<pre>Текст</pre>
abbrВиділення абревіатури в тексті.
<abbr title="Пояснення">HTML</abbr>
u
Підкреслення тексту.
<u>Текст</u>
Зображення в тексті

Підтримуються формати JPEG і PNG. Ви можете розмістити зображення всередині абзацу (елемент p) або між абзацами. Для цього використайте елемент img, в атрибуті src зазначте URL зображення.

...
    <img src="http://example.com/img.jpg" />
...

Щоб розмістити зображення з підписом, використовуйте елемент figure, який може містити:

ЕлементОпис
figcaptionВидимий підпис до зображення.
 ...
    <figure>
        <img src="http://example.com/img.jpg" />
        <figcaption>Підпис</figcaption>
    </figure>
...
Відео в тексті
Ви можете додати на Турбо-сторінку відео, розміщені на вашому сайті або на сторонніх ресурсах.

Підтримується формат MP4. Використовуйте елемент figure, який може містити:

ЕлементОпис
videoВключає в себе елемент source з атрибутами:
  • src — посилання на відео. Відео має бути доступне за протоколом HTTPS.
  • type — тип медіаматеріалу і його формат.
...
<figure>
    <video>
        <source
         src="https://example.com/video.mp4"
         type="video/mp4" />
    </video>
    ...
</figure>
imgПрев’ю відео (зображення) у будь-якому форматі.
...
<figure>
    <video>
        <source
         src="https://example.com/video.mp4"
         type="video/mp4" />
    </video>
    <img src="http://example.com/img.jpg" />
    ...
</figure>
figcaptionПідпис до відео.
...
<figure>
    <video>
        <source
         src="https://example.com/video.mp4"
         type="video/mp4" />
    </video>
    <img src="http://example.com/img.jpg" />
    <figcaption>Підпис до відео</figcaption>
</figure>
Кнопка «Поділитися»

Щоб розмістити на Турбо-сторінці кнопку «Поділитися», використовуйте елемент div, який може містити:

ЕлементОпис
data-block *

Приймає значення share.

data-networkВи можете зазначити одне або кілька значень через кому:
  • facebook;
  • google;
  • odnoklassniki;
  • telegram;
  • twitter;
  • vkontakte.

Якщо атрибут data-network не зазначено, буде підключено всі перераховані вище сервіси.

<div data-block="share" data-network="twitter, facebook"></div> 
Цитати в тексті
Для оформлення цитати в тексті використовуйте елемент blockquote. Він може містити HTML-елементи, що підтримуються. Щоб розмістити в цитаті зображення, використовуйте елемент figure.
...
    <blockquote>
        <p>Текст</p>
        <figure>
            <img src="http://example.com/img.jpg"/>
            <figcaption>Підпис</figcaption>
        </figure>
        ...
    </blockquote>
...
Таблиці в тексті
Таблиця може містити:
...
    <table>
      <tr>
        <th>Перший стовпчик</th>
        <th>Другий стовпчик</th>
      </tr>
      <tr>
        <td>Перший стовпчик</td>
     <td>Другий стовпчик</td>
      </tr>
    </table>
...
Елементи меню

Щоб розмістити на Турбо-сторінці меню, додайте елемент menu до header.

Елемент menu може містити елемент a, в атрибуті href якого потрібно зазначити як значення посилання на сторінку сайту. У меню можна розмістити до 10 посилань.

На Турбо-сторінці з’явиться значок . Коли користувач натисне на нього, елементи навігації відобразяться на Турбо-сторінці у вигляді блоку посилань із заголовком Меню.

...
    <menu>
      <a href="http://example.com/page1.html">Текст посилання</a>
      <a href="http://example.com/page2.html">Текст посилання</a>
      ...
    </menu>
...
Вбудований контент Instagram і Twitter
Щоб розмістити на Турбо-сторінці контент зі сторонніх ресурсів:
  1. Скопіюйте код для вбудовування ресурсу.
  2. Додайте скопійований код у тег <![CDATA[]]> в елементі turbo:content.

Приклад:

...
<turbo:content>
    <![CDATA[
        <!--Код для вбудовування-->
    ]]>
</turbo:content>
...
Коментарі

Використовуйте деревоподібну структуру елемента div. Кількість рівнів вкладення не обмежена.

ЕлементОпис
data-block *
Приймає значення:
  • comments — блок зі списком коментарів;
  • comment — коментар у списку;
  • contentвміст коментаря.
data-author *Приймає значення author — ім’я автора коментаря.
data-avatar-urlПосилання на аватар автора коментаря. Зображення повинно бути у форматі JPG або PNG, не менше ніж 64 × 64 пікселі.
data-subtitleДодатковий рядок інформації, наприклад, дата коментаря. Розташовується під ім’ям автора.
data-urlВикористовується лише в елементі div верхнього рівня. Посилання на сторінку додавання коментарів.

Вміст коментаря:

ЕлементОпис
header

Заголовок коментаря. Розташовується над текстом коментаря.

HTML-елементиПідтримувані HTML-елементи.
<div data-block="comments" data-url="http://example.com/comments">
  <div
   data-block="comment"
   data-author="author" 
   data-avatar-url="http://example.com/img.png" 
   data-subtitle="2017-12-10">
    <div data-block="content">
      <header>Заголовок першого коментаря</header>
      <p>
        <b>Текст</b> коментаря
        <a href="https://example.com">Текст посилання</a>
      </p>
    </div>
    <div data-block="comments"> 
      <div data-block="comment" data-author="author2">
        Відповідь на перший коментар
      </div>
        ... 
    </div>  
  </div>
  <div
   data-block="comment"
   data-author="author"> 
     <div data-block="content">
      Вміст другого коментаря
     </div>
  </div> 
  ... 
</div>
Місце розміщення реклами
Увага. Не додавайте рекламні блоки частіше, ніж через кожні 250 слів сторінки. Часте розташування реклами погіршує читабельність повідомлень на Турбо-сторінках. Через це з часом користувачі можуть перестати переходити на ваші сторінки.
Щоб зазначити місце на сторінці, де повинен розміщуватися рекламний блок, використовуйте елемент figure. Він повинен містити атрибут data-turbo-ad-id зі значенням, зазначеним у елементі yandex:adNetwork.
<figure data-turbo-ad-id="first_ad_place"></figure>
Приклад використання елемента turbo:content
<turbo:content><![CDATA[
    <header>
        <figure>
            <img src="http://mydomain.com/path/to/img.jpg"/>
        </figure>
        <menu>
          <a href="http://example.com/page1.html">Текст посилання</a>
          <a href="http://example.com/page2.html">Текст посилання</a>
          ...
        </menu>
        <h1>Заголовок новини</h1>
        <h2>Підзаголовок новини</h2>
    </header>
    <a href="http://mydomain.com/path/to/newspage_1.shtml">Зовнішнє посилання</a>
    <p>Текст новини</p>
    <p>Текст новини</p>
    <figure>
        <img src="http://mydomain.com/path/to/img.jpg"/>
        <figcaption>Підпис до фото</figcaption>
    </figure>
    <figure data-turbo-ad-id="first_ad_place"></figure>
    <p>Текст новини</p>
    <figure data-turbo-ad-id="second_ad_place"></figure>
    <figure>
        <video>
            <source 
               src="https://mysite.ru/video.mp4" 
               type="video/mp4" />
        </video>
        <img src="http://mysite.ru/path/to/img2.jpg"/>
        <figcaption>Підпис до відео</figcaption>
    </figure>
]]></turbo:content>

Підключення систем веб-аналітики

Підключення підтримуваних систем веб-аналітики

Ви можете підключити деякі системи веб-аналітики за допомогою спеціальних значень атрибута type елемента yandex:analytics.

Щоб трафік на Турбо-сторінках враховувався у різних системах статистики, в елемент channel можна додати одразу кілька елементів yandex:analytics.

Для кожної системи можна зазначити необмежену кількість лічильників. Кожен лічильник передається в окремому елементі yandex:analytics.

Яндекс.Метрика
ЕлементОпис
type *Приймає значення Yandex.
id *Номер лічильника Яндекс.Метрики.
paramsВикористовуйте для передавання параметрів візитів.
<yandex:analytics
 id="номер лічильника"
 type="Yandex"
 params="{ 'param' : 'val' }">
</yandex:analytics>
  ...
<yandex:analytics
 id="номер іншого лічильника"
 type="Yandex"
 params="{ 'param' : 'val' }">
</yandex:analytics>
LiveInternet
Зазначте атрибут type зі значенням LiveInternet.
<yandex:analytics
 type="LiveInternet">
</yandex:analytics>

Якщо лічильник використовується для кількох хостів, додайте атрибут params із назвою лічильника.

<yandex:analytics
 type="LiveInternet"
 params="Назва лічильника">
</yandex:analytics>
Google Analytics

Зазначте атрибут type зі значенням Google і атрибут id з ідентифікатором відстеження.

<yandex:analytics
 id="ідентифікатор відстеження"
 type="Google">
</yandex:analytics>
  ...
<yandex:analytics
 id="інший ідентифікатор відстеження"
 type="Google">
</yandex:analytics>
Рейтинг Mail.RU

Зазначте атрибут type зі значенням MailRu і атрибут id з ідентифікатором лічильника.

<yandex:analytics
 id="ідентифікатор лічильника"
 type="MailRu">
</yandex:analytics>
Rambler Топ-100

Зазначте атрибут type зі значенням Rambler і атрибут id з ідентифікатором лічильника.

<yandex:analytics
 id="ідентифікатор лічильника"
 type="Rambler">
</yandex:analytics>
  ...
<yandex:analytics
 id="ідентифікатор іншого лічильника"
 type="Rambler">
</yandex:analytics>
Mediascope (TNS)
Зазначте атрибут type зі значенням Mediascope і атрибут id з ідентифікатором лічильника.
<yandex:analytics
 id="ідентифікатор tmsec від Mediascope"
 type="Mediascope">
</yandex:analytics>
  ...
<yandex:analytics
 id="інший ідентифікатор tmsec від Mediascope"
 type="Mediascope">
</yandex:analytics>

Де знайти ідентифікатор або номер лічильника?

Передавання в систему веб-аналітики адреси сторінки-джерела і заголовка Турбо-сторінки

Передайте в елементі item елементи turbo:source і turbo:topic.

Примітка. Підтримується тільки Яндекс.Метрикою.

Підключення реклами

РСЯ
  1. У партнерському інтерфейсі створіть рекламний блок для Турбо-сторінок.
  2. У RSS-файл додайте в елемент yandex:adNetwork атрибути:
    • type зі значенням Yandex;
    • id з буквено-числовим ідентифікатором рекламного блоку;
    • turbo-ad-id з довільним ідентифікатором, що визначає місце розміщення реклами.
...
<yandex:adNetwork
 type="Yandex"
 id="ідентифікатор блоку 1"
 turbo-ad-id="first_ad_place">
</yandex:adNetwork>
...
<yandex:adNetwork
 type="Yandex"
 id="ідентифікатор блоку 2"
 turbo-ad-id="second_ad_place">
</yandex:adNetwork>
...
Сторонні мережі та прямі рекламодавці через ADFOX
  1. В інтерфейсі ADFOX . Ви можете використати безперервну стрічку статей.
  2. У RSS-файл додайте в елемент yandex:adNetwork:
    • атрибут type зі значенням AdFox;
    • атрибут turbo-ad-id з довільним ідентифікатором, що визначає місце розміщення реклами;
    • код блоку, перетворений на тег <![CDATA[]]>.
<yandex:adNetwork
 type="AdFox"
 turbo-ad-id="first_ad_place">
    <![CDATA[
        <div id="ідентифікатор контейнера 1"></div>
        <script>
            window.Ya.adfoxCode.create({
                ownerId: 123456,
                containerId: 'ідентифікатор контейнера 1',
                params: {
                    pp: 'g',
                    ps: 'cmic',
                    p2: 'fqem'
                }
            });
        </script>
    ]]>
</yandex:adNetwork>
...
<yandex:adNetwork
 type="AdFox"
 turbo-ad-id="second_ad_place">
    <![CDATA[
        <div id="ідентифікатор контейнера 2"></div>
        <script>
            window.Ya.adfoxCode.create({
                ownerId: 123456,
                containerId: 'ідентифікатор контейнера 2',
                params: {
                    pp: 'g',
                    ps: 'cmic',
                    p2: 'fqem'
                }
            });
        </script>
    ]]>
</yandex:adNetwork>

Щоб додати кілька рекламних блоків, для кожного блоку зазначте окремий елемент yandex:adNetwork з унікальним значенням атрибута id. Якщо ви зазначите однакові значення, буде відображено лише перший блок.

Щоб визначити місце розміщення реклами на сторінці:

  1. Задайте для кожного рекламного блоку довільний ідентифікатор як значення атрибута turbo-ad-id. Наприклад, first_ad_place, second_ad_place.

    Якщо атрибут turbo-ad-id не зазначено, буде відображено лише один блок у кінці статті. Якщо turbo-ad-id не зазначено для всіх блоків, рекламу не буде відображено на Турбо-сторінці.

  2. Зазначте цей ідентифікатор усередині елемента turbo:content як значення атрибута data_turbo_ad_id в елементі figure. Якщо ідентифікатори в turbo-ad-id і data-turbo-ad-id не збігаються, рекламу не буде відображено на Турбо-сторінці.

Де знайти ідентифікатор рекламного блоку або код вставки?

Опис елементів для відео- та фоторепортажів

Відео- і фоторепортажі можна транслювати в Яндекс.Новини навіть у тому випадку, коли вони не супроводжуються опублікованим на вашому сайті текстом або розшифровкою.

Для трансляції відео необхідно у відповідному item:

  1. Зазначити посилання на відео в елементі enclosure або media:group.
  2. Зазначити жанр повідомлення video в елементі yandex:genre.
  3. Сформувати елемент description, який повинен містити короткий опис (лід) відеорепортажу.
  4. Сформувати елементи yandex:tags і помістити у них ключові слова для відео. Кожне ключове слово має бути в окремому елементі yandex:tags. Мінімальна кількість — 5 ключових слів.

    Ви можете не публікувати ключові слова на вашому сайті, вони потрібні для належного функціонування алгоритму кластеризації.

    <yandex:tags>путін</yandex:tags>
    <yandex:tags>порошенко</yandex:tags>
    <yandex:tags>меркель</yandex:tags> 
    <yandex:tags>лукашенко</yandex:tags>
    <yandex:tags>мінськ</yandex:tags>

Символи та кодування

В експортному файлі зазначте кодування, що віддає ваш сервер. Найчастіше використовуються: UTF-8, Windows-1251, KOI8-R.

У всіх елементах channel і item слід кодувати такі символи:

СимволНазваКод заміни
&Амперсанд&amp;
>Права кутова дужка>
<Ліва кутова дужка<
"Знак лапок&quot;
'Апостроф'

Наприклад, посилання http://some.host.ru/?id=1&page=10 повинно бути приведене до такого вигляду http://some.host.ru/?id=1&amp;page=10.

Механізм експорту даних

Щоб передавати інформацію про новинні повідомлення, розмістіть RSS-файл на сервері вашого сайту й оновлюйте його з необхідною періодичністю (наприклад, файл може поповнюватися протягом дня і перезаписуватися вранці). Робот завантажує файл кожні дві хвилини.

Примітка. Файл повинен бути доступним за протоколом HTTP або HTTPS. Експортний файл, який не вдалося повністю завантажити за 10 секунд, вважається недоступним.

Щоб основний робот Яндекса проіндексував файл, додайте директиву в robots.txt:

User-agent: YandexNews
Allow: шлях до експортного файлу без імені хоста (наприклад, /file.rss)
...
#останній рядок повинен бути порожнім

Перевірити коректність додавання рядків можна у Яндекс.Вебмайстрі.

Якщо ви використовуєте в robots.txt директиву Crawl-delay, зазначте її для робота YandexNews окремо (зі значенням від 0.1 до 2).

User-agent: YandexNews
Allow: /file.rss
Crawl-delay: 0.1
...
#останній рядок повинен бути порожнім

Приклад експортного файлу

<?xml version="1.0" encoding="windows-1251"?>
  <rss 
    xmlns:yandex="http://news.yandex.ru" 
    xmlns:media="http://search.yahoo.com/mrss/" 
    xmlns:turbo="http://turbo.yandex.ru"
    version="2.0">
    <channel>
      <title>Російські новини</title>
      <link>http://www.rossiyskie-novosti.ru/</link>
      <description>Щоденна московська газета</description>
      <yandex:analytics type="Yandex" id="00000000"></yandex:analytics>
      <yandex:adNetwork type="Yandex" id="111111111" 
        turbo-ad-id="first_ad_place"></yandex:adNetwork>
      <yandex:adNetwork type="Yandex" id="222222222" 
        turbo-ad-id="second_ad_place"></yandex:adNetwork>
      <item turbo="true">
        <title>Яндекс шукає на президентському сайті</title>
        <link>http://www.rossiyskie-novosti.ru/2003/03/25/yandex.html</link>
        <pdalink>http://www.m.rossiyskie-novosti.ru/2003/03/25/yandex.html</pdalink>
        <description>Яndex.Site встановлено на сайті президента</description>
        <author>Іван Петров</author>
        <category>Технології</category>
        <enclosure 
          url="http://www.rossiyskie-novosti.ru/2003/03/25/yandex.jpg" 
          type="image/jpeg"/>
        <media:group>
          <media:content 
            url="http://www.rossiyskie-novosti.ru/video/100237" 
            type="video/x-ms-asf"/>
          <media:thumbnail 
            url="http://www.rossiyskie-novosti.ru/2003/03/25/yandex1.jpg" 
            type="image/jpeg"/>
        </media:group>        
        <pubDate>Sun, 29 Sep 2002 19:59:01 +0300</pubDate>
        <yandex:genre>message</yandex:genre>
        <yandex:full-text>Для пошуку на сайті www.kremlin.ru вибрано програму Яndex.Site. 
          Цей програмний продукт було досліджено провайдером президентського сайту — 
          Федеральним агентством урядового зв’язку та інформації. ФАУЗІ визнало
          можливим використання пошукової системи <Яндекса> на www.kremlin.ru. 
          За результатами дослідження програму було скомпільовано, протестовано і встановлено
          на сайт.</yandex:full-text>
        <turbo:content>
          <![CDATA[
            <header>
              <menu>
                <a href="http://www.rossiyskie-novosti.ru/contacts.html">Редакція</a>
                <a href="http://www.rossiyskie-novosti.ru/hi-tech.html">Технології</a>
              </menu>
              <h1>Яндекс шукає на президентському сайті</h1>
              <h2>Яndex.Site встановлено на сайті президента</h2>
            </header>
           <p>Для пошуку на сайті www.kremlin.ru вибрано програму Яndex.Site.</p>
           <p>Цей програмний продукт було досліджено провайдером президентського сайту &ndash; 
              Федеральним агентством урядового зв’язку та інформації. ФАУЗІ визнало можливим 
              використання пошукової системи <Яндекса> на www.kremlin.ru.</p>
      <figure data-turbo-ad-id="first_ad_place"></figure>
           <p>За результатами дослідження програму було скомпільовано, протестовано 
              і встановлено на сайт.</p>
           <figure>
             <img src="http://www.rossiyskie-novosti.ru/2003/03/25/yandex.jpg"/>
             <figcaption>Логотип Яндекса в офісі компанії</figcaption>
           </figure>
           <figure>
             <video>
               <source 
                 src="http://www.rossiyskie-novosti.ru/video/100237" 
                 type="video/mp4" />
             </video>
             <img src="http://www.rossiyskie-novosti.ru/2003/03/25/yandex1.jpg"/>
             <figcaption>Репортаж із місця подій</figcaption>
           </figure>
           <figure data-turbo-ad-id="second_ad_place"></figure>
         ]]>
       </turbo:content>
         <yandex:related type="infinity">
           <link 
             url="http://www.rossiyskie-novosti.ru/2002/10/11/yandex-start.html" 
             img="http://www.rossiyskie-novosti.ru/yndx-old-logo.jpg">
             Новий сервіс Яндекса</link>
           <link 
             url="http://www.rossiyskie-novosti.ru/2002/12/05/new-internet-giants.html"
             img="http://www.rossiyskie-novosti.ru/searchengines-compilation.png">
             Нові гравці на ринку e-commerce</link>
         </yandex:related>
       </item>
     </channel>
  </rss>