Описание элементов RSS 2.0

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

Примечание. Для создания RSS-канала вы можете использовать специальный плагин. Плагины разработаны для систем 1С-Битрикс, Drupal, Joomla, WordPress и OpenCart.

Данные для Турбо-страниц экспортируются в XML-based формате 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>

Для формирования Турбо-страницы передайте следующие данные:

...
    <channel><!--Информация о сайте-источнике (RSS-канале)-->
        ...
        <item turbo="true"><!--Информация о странице-->
            ...
            <turbo:content>...</turbo:content><!--Содержимое страницы-->
            ...
        </item>
    </channel>
</rss>
  1. Передача информации о сайте-источнике
    1. Подключение систем веб-аналитики
    2. Подключение рекламы
  2. Передача информации о странице
  3. Передача содержимого страницы
  4. Символы и кодировки

Передача информации о сайте-источнике

Сведения передаются в элементе channel.

ЭлементОписание
title

Название RSS-канала.

Если экспортируется содержимое всего сайта, укажите название сайта. Если экспортируется раздел сайта, укажите только название раздела.

<title>Название канала</title>
link

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

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

Описание канала одним предложением. Не используйте HTML-разметку.

<description>Краткое описание потока</description>
language
Язык статьи по стандарту ISO 639-1.
<language>ru</language>
turbo:analytics | yandex:analytics

Счетчик системы веб-аналитики для учета посещаемости Турбо-страниц. Подробнее

turbo:adNetwork | yandex:adNetwork

Используйте для отображения блоков Рекламной сети Яндекса и сторонней рекламы, подключенной через ADFOX на Турбо-страницах. А также для учета доходов от рекламы при использовании Турбо-страниц. Подробнее

item *

Информация о странице и ее содержимом.

Чтобы использовать формат Турбо-страниц, добавьте атрибут turbo со значением true. Чтобы отключить отображение Турбо-страницы, используйте значение false. Подробнее см. в разделе Управление показом Турбо-страниц.

...
    <item turbo="true">
        ... 
    </item>

Один элемент item описывает одну страницу.

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

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

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

  1. Подключение поддерживаемых систем веб-аналитики
  2. Подключение произвольной системы веб-аналитики

Подключение поддерживаемых систем веб-аналитики

Вы можете подключить некоторые системы веб-аналитики с помощью специальных значений атрибута type элемента turbo:analytics.

Чтобы трафик на Турбо-страницах учитывался в разных системах статистики, в элемент channel добавьте сразу несколько элементов turbo:analytics. Также вы можете указывать неограниченное количество счетчиков каждой системы веб-аналитики.

Где найти идентификатор или номер счетчика.

Подключение произвольной системы веб-аналитики

Если ваша система веб-аналитики поддерживает установку в виде изображения (пикселя), вы можете подключить ее к Турбо-странице:
  1. Добавьте в элемент turbo:analytics атрибуты:
    • type * — со значением custom;
    • url * — с адресом пикселя системы статистики.
  2. Укажите в URL дополнительные параметры, которые хотите передавать в систему веб-аналитики:
    • {referrer} — реферер;
    • {referrerStarsEscaped} — реферер для Mediascope (с экранированным символом *), если вы хотите подключить эту систему, не указывая идентификатор;
    • {pageTitle} — заголовок страницы;
    • {originalURL} — URL местоположения оригинальной страницы;
    • {screenWidth} — ширина экрана;
    • {screenHeight} — высота экрана;
    • {random} — псевдослучайное число (на каждое вхождение в строке генерируется новое значение);
    • {requestId} — идентификатор запроса (одинаковый в рамках страницы);
    • {clientId} — идентификатор клиента (одинаковый для браузера пользователя).
<rss
    xmlns:yandex="http://news.yandex.ru"
    xmlns:media="http://search.yahoo.com/mrss/"
    xmlns:turbo="http://turbo.yandex.ru"
    version="2.0"
>
    <channel>
        <turbo:analytics
         type="custom"
         url="http://some.doma.in/{screenWidth}*{clientId}/{random}/{originalURL}?title={pageTitle}" >
        </turbo:analytics>
        <item turbo="true">
            <link>http://www.example.com/page1.html</link>
            <turbo:content>
                ...
            </turbo:content>
        </item>
    </channel>
</rss>

Подключение рекламы

  1. В партнерском интерфейсе создайте рекламный блок для Турбо-страниц.
  2. В RSS-файл добавьте в элемент turbo:adNetwork атрибуты:
    • type со значением Yandex;
    • id с буквенно-числовым идентификатором рекламного блока;
    • turbo-ad-id с произвольным ID, указывающим место размещения рекламы.
<rss
    xmlns:yandex="http://news.yandex.ru"
    xmlns:media="http://search.yahoo.com/mrss/"
    xmlns:turbo="http://turbo.yandex.ru"
    version="2.0"
>
    <channel>
        <turbo:adNetwork
         type="Yandex"
         id="идентификатор блока 1"
         turbo-ad-id="first_ad_place">
        </turbo:adNetwork>
        <turbo:adNetwork
         type="Yandex"
         id="идентификатор блока 2"
         turbo-ad-id="second_ad_place">
        </turbo:adNetwork>  
        <item turbo="true">
            ...
            <turbo:content>
                ...
                <figure data-turbo-ad-id="second_ad_place"></figure> 
            </turbo:content> 
        </item>
    </channel>
</rss>

Чтобы добавить несколько рекламных блоков, для каждого блока укажите отдельный элемент turbo:adNetwork с уникальным значением атрибута id. Если вы укажете одинаковое значение, отобразится только первый блок.

Чтобы указать место размещения рекламы на странице:
  1. Задайте для рекламного блока произвольный ID в качестве значения атрибута turbo-ad-id. Например, first_ad_place, second_ad_place.
  2. Укажите этот ID в качестве значения атрибута data-turbo-ad-id в элементе figure внутри элемента turbo:content.
Примечание. Если атрибут turbo-ad-id или его значение отсутствует, то отобразится только первый рекламный блок внизу Турбо-страницы. Если атрибут turbo-ad-id указан только для нескольких рекламных блоков, реклама не отобразится.

Где найти идентификатор рекламного блока или код вставки.

Передача информации о странице

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

ЭлементОписание
link *

URL страницы сайта, для которой нужно сформировать Турбо-страницу.

<link>http://www.example.com/page1.html</link>
Требования:
  • ссылка должна содержать схему HTTP или HTTPS;
  • домен, указанный в ссылке, должен соответствовать домену сайта-источника;
  • максимальная длина URL — 243 ASCII-символа;
  • по одному URL должна быть доступна одна статья.

При переходе по ссылке заголовок и начало текста должны быть видны на первом экране при разрешении 1024 × 768.

turbo:sourceURL страницы-источника, который можно передать в Яндекс.Метрику.
turbo:topicЗаголовок страницы, который можно передать в Яндекс.Метрику.
pubDate

Время публикации контента на сайте источника.

Передается в формате RFC-822.

<pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
authorАвтор статьи, размещенной на странице.
<author>Иван Иванов</author>
turbo:content *

Содержимое страницы.

yandex:related

Вы можете разместить ссылки на другие ресурсы или настроить отображение непрерывной ленты статей, реализованной, например с помощью AJAX.

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

<rss
    xmlns:yandex="http://news.yandex.ru"
    xmlns:media="http://search.yahoo.com/mrss/"
    xmlns:turbo="http://turbo.yandex.ru"
    version="2.0"
>
    <channel>
        <item turbo="true">
           <link>http://www.example.com/page1.html</link>
           <turbo:content>
               ...
           </turbo:content>
           <yandex:related type="infinity">
               <link
                url="http://www.example.com/page.html"
                img="http://www.example.com/image.png">Текст ссылки
               </link>
               <link
                url="http://www.example.com/page2.html"
                img="http://www.example.com/image2.png">Текст ссылки
               </link>
           </yandex:related>
        </item>
    </channel>
</rss>

Передача содержимого страницы

Контент для Турбо-страницы передается с помощью элемента turbo:content. Содержимое необходимо обернуть в тег <![CDATA[]]>.

Символы и кодировки

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

Во всех элементах RSS-файла, кроме содержимого тега <![CDATA[]]>, необходимо кодировать следующие символы:

СимволНазваниеКод замены
&Амперсанд&amp;
>Правая угловая скобка&gt;
<Левая угловая скобка&lt;
"Кавычки&quot;
'Апостроф&apos;

Например, ссылка http://example.com/?id=1&page=10 должна быть приведена к виду http://example.com/?id=1&amp;page=10.