Разметка RSS-канала

Структура RSS-канала

<?xml version="1.0" encoding="UTF-8"?>
<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.example.com/</link>
        <description>Краткое описание канала</description>
        <language>ru</language>
        <turbo:analytics></turbo:analytics>
        <turbo:adNetwork></turbo:adNetwork>
        <item turbo="true">
            <!-- Информация о странице -->
            <link>http://www.example.com/category/sub-category/page1.html</link>
            <turbo:source></turbo:source>
            <turbo:topic></turbo:topic>
            <pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
            <author>Иван Иванов</author>
            <metrics>
                <yandex schema_identifier="Идентификатор">
                    <breadcrumblist>
                        <breadcrumb url="http://example.com/" text="Домашняя"/>
                        <breadcrumb url="http://example.com/category/" text="Категория"/>
                        <breadcrumb url="http://example.com/category/sub-category/" text="Подкатегория"/>
                        <breadcrumb url="http://example.com/category/sub-category/page1.html" text="Пример страницы"/>
                    </breadcrumblist>
                </yandex>
            </metrics>
            <yandex:related></yandex:related>
            <turbo:content>
                <![CDATA[
                    <!-- Содержимое 1 страницы -->
                ]]>
            </turbo:content>
        </item>
        <item turbo="true">
            ...
            <turbo:content>
                <![CDATA[
                    <!-- Содержимое 2 страницы --> 
                ]]>
            </turbo:content>
        </item>
        ...
    </channel>
</rss>
channel *
Информация о сайте-источнике.
title
Название RSS-канала.

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

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

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

language

Язык статьи по стандарту ISO 639-1.

turbo:analytics

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

Подробнее.

turbo:adNetwork

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

Подробнее.

item *

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

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

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

link *

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

Требования:
  • ссылка должна содержать схему HTTP или HTTPS;
  • домен, указанный в ссылке, должен соответствовать домену сайта-источника;
  • максимальная длина URL — 243 ASCII-символа;
  • по одному URL должна быть доступна одна статья.

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

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

Заголовок страницы, который можно передать в Яндекс.Метрику.

pubDate

Время публикации в формате RFC-822.

Обязательный элемент для формирования автоматической главной страницы.

author

Автор статьи, размещенной на странице.

metrics
Внимание. Вложенные элементы metrics необходимо передавать, если вы используете Отчеты по контенту на основных страницах сайта.

Дополнительная информация о странице. Используется для связывания контентной информации на основной и Турбо‑странице сайта.

yandex
Информация для Яндекс.Метрики. Допустимые атрибуты:
breadcrumblist
Внимание. Элементы breadcrumblist не используются для построения «хлебных крошек». Они используются только для идентификации рубрики.

Блок с рубриками, который указан на основной странице сайта.

breadcrumb
Информация о странице. Допустимые атрибуты:
  • url — URL рубрики/страницы.
  • text — название рубрики/страницы.
yandex:related

Вы можете разместить ссылки на другие ресурсы или настроить отображение бесконечной ленты статей.

Такие ссылки будут располагаться внизу Турбо‑страницы. Чтобы добавить ссылки в любом месте страницы, используйте Блок ссылок на дополнительные материалы.

Бесконечная лента рекомендаций

Посмотрите пример отображения бесконечной ленты.

Внимание. Бесконечную ленту можно сформировать только из статей, для которых уже сформированы Турбо‑страницы.
Чтобы задать набор страниц вручную:
  1. В элементе item нужной страницы добавьте элемент yandex:related с атрибутом type="infinity".
  2. Внутри элемента yandex:related добавьте ссылки на страницы, из которых будет формироваться лента. Ссылки необходимо задавать с помощью элемента link с атрибутом url.
    Пример:
    ...
        <yandex:related type="infinity">
            <link url="http://www.example.com/page.html"></link>
            <link url="http://www.example.com/page2.html"></link>
            ...
        </yandex:related>
    ...
    Скопировано
Чтобы реклама ADFOX отображалась на Турбо‑страницах с бесконечной лентой:
  1. В интерфейсе ADFOX перейдите на вкладку Параметры.
  2. В списке Тип кода выберите пункт <неповторяющиеся баннеры>.
Подробнее о настройке в Помощи ADFOX.

Обязательный параметр

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

Содержимое для Турбо‑страницы передается с помощью элемента turbo:content. Содержимое необходимо обернуть в раздел <![CDATA[]]>
...
    <turbo:content>
        <![CDATA[
            <!-- Содержимое страницы -->
        ]]> 
    </turbo:content>
...
Скопировано
Содержимое страницы обязательно должно содержать шапку страницы и контентную часть:
...
    <!-- Шапка -->
    <header>
        <h1>Заголовок страницы</h1>
        <figure>
            <img src="http://example.com/img.jpg"/>
        </figure>
        <h2>Заголовок второго уровня</h2>
        <menu>
            <a href="http://example.com/page1.html">Текст ссылки</a>
            <a href="http://example.com/page2.html">Текст ссылки</a>
        </menu>
    </header>
    <!-- Контентная часть -->
...
Скопировано
header *
h1 *

Заголовок страницы.

figure
Элемент, который используется для формирования превью в шапке. Может использоваться для формирования картинки с подписью.
img
Атрибут src должен содержать URL изображения. Поддерживаются форматы JPEG, PNG, GIF.
h2

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

menu
Навигационное меню.
a

Пункт меню. Атрибут href должен содержать ссылку на страницу сайта.

Обязательный параметр

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

В экспортном файле укажите кодировку, отдаваемую вашим сервером. Наиболее часто используются: 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.

Пример RSS-канала

<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>Название RSS-канала</title>
        <link>http://www.example.com/</link>
        <description>Краткое описание RSS-канала</description>
        <turbo:analytics type="Yandex" id="123456"></turbo:analytics>
        <turbo:adNetwork type="Yandex" id="идентификатор блока" turbo-ad-id="first_ad_place"></turbo:adNetwork>
        <turbo:adNetwork type="AdFox" turbo-ad-id="second_ad_place">
            <![CDATA[
                <div id="идентификатор контейнера"></div>
                <script>
                    window.Ya.adfoxCode.create({
                        ownerId: 123456,
                        containerId: 'идентификатор контейнера',
                        params: {
                            pp: 'g',
                            ps: 'cmic',
                            p2: 'fqem'
                        }
                    });
                </script>
            ]]>
        </turbo:adNetwork>
        <yandex:related type="infinity">
            <link url="http://www.example.com/other-page1.html">Текст ссылки</link>
            <link url="http://www.example.com/other-page2.html">Текст ссылки</link>
        </yandex:related>
        <item turbo="true">
            <link>http://www.example.com/page1.html</link>
            <author>Иван Иванов</author>
            <category>Технологии</category>
            <pubDate>Sun, 29 Sep 2002 19:59:01 +0300</pubDate>
            <turbo:content>
                <![CDATA[
                    <header>
                        <h1>Ресторан «Полезный завтрак»</h1>
                        <h2>Вкусно и полезно</h2>
                        <figure>
                            <img src="https://avatars.mds.yandex.net/get-sbs-sd/403988/e6f459c3-8ada-44bf-a6c9-dbceb60f3757/orig">
                        </figure>
                        <menu>
                            <a href="http://example.com/page1.html">Пункт меню 1</a>
                            <a href="http://example.com/page2.html">Пункт меню 2</a>
                        </menu>
                    </header>
                    <p>Как хорошо начать день? Вкусно и полезно позавтракать!</p>
                    <p>Приходите к нам на завтрак. Фотографии наших блюд ищите <a href="#">на нашем сайте</a>.</p>
                    <h2>Меню</h2>
                    <figure>
                        <img src="https://avatars.mds.yandex.net/get-sbs-sd/369181/49e3683c-ef58-4067-91f9-786222aa0e65/orig">
                        <figcaption>Омлет с травами</figcaption>
                    </figure> 
                    <p>В нашем меню всегда есть свежие, вкусные и полезные блюда.</p>
                    <p>Убедитесь в этом сами.</p>
                    <button formaction="tel:+7(123)456-78-90" data-background-color="#5B97B0" data-color="white" data-primary="true">Заказать столик</button>
                    <div data-block="widget-feedback" data-stick="false">
                        <div data-block="chat" data-type="whatsapp" data-url="https://whatsapp.com"></div>
                        <div data-block="chat" data-type="telegram" data-url="http://telegram.com/"></div>
                        <div data-block="chat" data-type="vkontakte" data-url="https://vk.com/"></div>
                        <div data-block="chat" data-type="facebook" data-url="https://facebook.com"></div>
                        <div data-block="chat" data-type="viber" data-url="https://viber.com"></div>
                    </div>
                    <p>Наш адрес: <a href="#">Nullam dolor massa, porta a nulla in, ultricies vehicula arcu.</a></p>
                    <p>Фотографии — http://unsplash.com</p>
                ]]>
            </turbo:content>
        </item>
    </channel>
</rss>
Скопировано