Подключение ленты RSS

Зачем адаптировать RSS для Дзена?

Если вы адаптируете RSS для Дзена:

  • В ленту Дзена не попадут посторонние материалы. Если на сайте нет RSS, робот забирает с сайта контент, похожий на статьи, и по ошибке туда могут попасть объявления или профили пользователей.
  • Заголовки, описания и иллюстрации в ваших статьях останутся в Дзене на своих местах. Наш робот учится и пока еще совершает ошибки.
  • «Взрослый» контент на вашем сайте не ухудшит ранжирование в Дзене других материалов сайта.
  • Читатели получат статьи, которые их интересуют. Чем больше у Дзена будет информации о статье, тем выше вероятность показа статьи той аудитории, которой она действительно нужна. Поэтому RSS-лента должна обязательно содержать дату выпуска, полный текст статьи и ссылки на все иллюстрации к статье.

Как подключить ленту RSS к Дзену?

  1. Разметьте ленту RSS в соответствии с требованиями Дзена.
  2. Напишите в службу поддержки Дзена:

После технической и редакционной модерации лента будет подключена. Если лента не прошла модерацию, вы получите письмо о допущенных ошибках, которые необходимо будет исправить. Когда вы их исправите, напишите нам повторно.

Описание разметки RSS для Дзена

Примечание. RSS-лента, подготовленная для сервиса Яндекс.Новости, для Дзена не подойдет. В Дзене используется другой набор обязательных атрибутов и другие требования к размеру иллюстраций.

Транслируемые через RSS данные должны находиться в свободном бесплатном доступе в интернете. Необходимость регистрации считается ограничением свободного доступа.

После разметки RSS-ленты мы рекомендуем проверить ее валидатором.

Тэги <rss>, <channel>, <title>, <link>, <description>, <language> и <item>

Пример использования:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:georss="http://www.georss.org/georss">
<channel>
<title>Пастернак</title>
<link>http://example.com/</link>
<description>
Проект о фруктах и овощах. Мы рассказываем о том, как выращивать, готовить и правильно есть.
</description>
<language>ru</language>
<item>
...
</item>
</channel>

Описание тегов:

  1. <rss> — используемый формат данных. Экспорт данных для размещения материалов в Дзене осуществляется в XML-based формате RSS 2.0. Мы поддерживаем RSS, HTML5 и микроформаты, Media RSS, GeoRSS.
  2. <channel> — информация об источнике и его содержании. Содержит внутри тэги:
    • <title> — название издания.
    • <link> — адрес сайта издания.
    • <description> — описание издания.
    • <language> — язык статьи в стандарте ISO 639-1.
    • <item> — внутри этого тега содержится материал издателя. Таких материалов в RSS-ленте для Дзена может быть до 50.
Тэги <title>, <link>, <pubDate>, <author>, <category>, <description> и <content:encoded>

Пример: использования:

<title>Андроид восстановит ферму в Японии</title>
<link>http://example.com/2023/07/04/android-happy-farmer</link>
<guid>2fd4e1c67a2d28fced849ee1bb76e7391b93eb12</guid>
<pubDate>Tue, 4 Jul 2023 04:20:00 +0300</pubDate>
<author>Петр Стругацкий</author>
<category>Технологии</category>
<description><![CDATA[
Заброшенную землю рядом с токийским университетом Нисёгакуся передали андроиду
с внешностью известного японского хозяйственника.
]]></description>
<content:encoded><![CDATA[
<p>
Здесь находится полный текст статьи.
</p>
]]></content:encoded>

Описание тегов:

  1. <title> — заголовок статьи.
  2. <link> — адрес (URL) статьи, данные которой транслируются в потоке. Ссылка в RSS должна быть идентичной ссылке на сайте. Это условие поможет нашему рекомендатору.

    Например, эти URL считаются идентичными:

    • http://example.com/2023/07/04/android-happy-farmer
    • http://example.com/2023/07/04/android-happy-farmer

    А эти нет:

    • http://example.com/2023/07/04/android-happy-farmer
    • http://example.com/2023/07/04/android-happy-farmer/
    • http://example.com/2023/07/04/android-happy-farmer?utm_medium=cpc&utm_source=yandex. {source_type}&utm_campaign={campaign_id}&utm_content={ad_id}&utm_term={keyword}
    Примечание. Чтобы трафик из Дзена отображался в вашей системе аналитики, не нужно добавлять в RSS метки. Мы автоматически добавляем referrer при переходе пользователей из Дзена на ваш сайт.
  3. <pubDate> — дата публикации в формате RFC822, то есть «Wed, 02 Oct 2002 15:00:00 +0300». Если этого тега нет, то Дзен будет считать дату по моменту загрузки RSS, а это не всегда верно.
  4. <author> — автор статьи.
  5. <category> — тематика сообщения. Разметка сообщений позволит Дзену рекомендовать их заинтересованным читателям. Статья может относиться сразу к нескольким тематикам.
    Используемые в Дзене тематики
    • Происшествия
    • Политика
    • Война
    • Общество
    • Экономика
    • Спорт
    • Технологии
    • Наука
    • Игры
    • Музыка
    • Литература
    • Кино
    • Культура
    • Мода
    • Знаменитости
    • Психология
    • Здоровье
    • Авто
    • Дом
    • Хобби
    • Еда
    • Дизайн
    • Фотографии
    • Юмор
    • Природа
    • Путешествия
  6. <description> — краткая аннотация статьи.
  7. <content:encoded> — полный текст статьи. Мы принимаем статьи не короче 300 знаков.
Тэг <media:rating>

Мы просим использовать этот тег для разметки «взрослого» контента, чтобы в случае нарушения правил сервиса Дзен ограничивал показ не всех статей сайта, а только откровенных материалов.

Так должна выглядеть разметка контента, который можно показывать подросткам от 13 лет:

<media:rating scheme="urn:simple">nonadult</media:rating>

Так должна выглядеть разметка «взрослого» контента:

<media:rating scheme="urn:simple">adult</media:rating>
Тэги <figure>, <img>, <video> и <figcaption>

Мы просим прислать ссылки на все иллюстрации и видео, которые есть в статье. Статья должна содержать как минимум одну картинку шириной не менее 400 пикселей.

Пример использования:

<figure>
<img src="http://example.com/2023/07/04/pic1.jpg" width="1200" height="900">
<figcaption>
Первый андроид-фермер смотрит на свои угодья
<span class="copyright">Михаил Родченков</span>
</figcaption>
</figure>

Описание тегов:

  1. <figure> — иллюстрация или видео. Каждая иллюстрация или видеоролик размечаются отдельным тегом <figure>.
  2. <figcaption> — подпись под иллюстрацией или видео.
  3. <img> — иллюстрация в формате JPEG, GIF, PNG, размером не меньше 600 пикселей в ширину. Первая иллюстрация в статье, размеченная этим тегом, используется для превью в ленте Дзена.
  4. <video> — видео поддерживаемых форматов (MP4 (H.264), YouTube, Vimeo).
Тэги <media:content>, <media:description>, <media:copyright>

Вы можете использовать альтернативный способ вставки медиа-контента в RSS с этими тегами.

Пример использования:

<item>
<media:content type="image/jpeg" medium="image" width="900" height="600"
url="http://example.com/2023/07/04/pic1.jpg">
<media:description type="plain">Первый андроид-фермер смотрит на свои угодья</media:description>
<media:copyright>Михаил Родченков</media:copyright>
</media:content>
</item>

Описание тегов:

  1. <media:content> — иллюстрации, аудио- или видеоролики поддерживаемых форматов:
    • Изображения в формате JPEG, GIF, PNG.
    • Видеоролики в формате MP4 (H.264), YouTube, Vimeo.
    • Аудиоролики в формате MP3, SoundCloud.
  2. <media:description> — подпись под иллюстрацией или видео.
  3. <media:copyright> — авторские права на иллюстрации или видео.
Тэг <enclosure>

Это обязательный элемент для иллюстраций, аудио- и видеофайлов.

Если в сообщении содержится несколько иллюстраций или иллюстрация и видеофайл, элемент <enclosure> должен быть повторен. Если в статье есть несколько вариантов одной иллюстрации, отличающихся размером, то в <enclosure> нужно указать URL изображения наибольшего размера. Тег <enclosure> дублирует тэг <figure>, но оба тега обязательны. Второй находится в теле статьи, первый — вне тела в описании.

Пример использования:

<enclosure url="http://example.com/2023/07/04/pic1.jpg" type="image/jpeg"/>
<enclosure url="http://example.com/2023/07/04/pic2.jpg" type="image/jpeg"/>
<enclosure url="http://example.com/2023/07/04/video/42420" type="video/x-ms-asf"/>
Тэги <pdalink> и <amplink>

Пример использования:

<pdalink>http://m.example.com/2023/07/04/android-happy-farmer</pdalink>
<amplink>http://amp.example.com/2023/07/04/android-happy-farmer</amplink>

Описание тегов:

  1. <pdalink> — ссылка на адаптированную для мобильных устройств версию сообщения.
  2. <amplink> — ссылка на AMP-версию сообщения.
Встроенный код

Мы просим вырезать весь HTML, который не описан в настоящих рекомендациях к RSS, например:

  • Видео
    <iframe src="URL Vimeo или YouTube" height="480" width="640"/>
  • Инстаграм, твиттер и фейсбук
    <iframe src="//instagram.com/p/INSTID/" ...>
    </iframe>
    <blockquote class=“twitter-tweet” ...>
    <p>Status text</p>
    <a href=“https://t.co/...”>media reference</a>
    </blockquote>
    <script async src=“//platform.twitter.com/widgets.js” charset=“utf-8”></script>
    <div class=“fb-post” data-href=“facebook_url_to_the_post”> ... </div>
    <div class=“fb-video” data-href=“facebook_url_to_video”> ... </div>

Пример RSS-ленты со всеми элементами

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:georss="http://www.georss.org/georss">
<channel>
<title>Пастернак</title>
<link>http://example.com/</link>
<description>
Проект о фруктах и овощах. Мы рассказываем о том, как выращивать, готовить и правильно есть.
</description>
<language>ru</language>
<item>
<title>Андроид восстановит ферму в Японии</title>
<link>http://example.com/2023/07/04/android-happy-farmer</link>
<pdalink>http://m.example.com/2023/07/04/android-happy-farmer</pdalink>
<amplink>http://amp.example.com/2023/07/04/android-happy-farmer</amplink>
<guid>2fd4e1c67a2d28fced849ee1bb76e7391b93eb12</guid>
<pubDate>Tue, 4 Jul 2023 04:20:00 +0300</pubDate>
<media:rating scheme="urn:simple">nonadult</media:rating>
<author>Петр Стругацкий</author>
<category>Технологии</category>
<enclosure url="http://example.com/2023/07/04/pic1.jpg" type="image/jpeg"/>
<enclosure url="http://example.com/2023/07/04/pic2.jpg" type="image/jpeg"/>
<enclosure url="http://example.com/2023/07/04/video/42420" type="video/x-ms-asf"/>
<description><![CDATA[
Заброшенную землю рядом с токийским университетом Нисёгакуся передали андроиду
с внешностью известного японского хозяйственника.
]]></description>
<content:encoded><![CDATA[
<p>Здесь находится полный текст статьи.
Этот текст может прерываться картинками, видео и другим медиа-контентом так же,
как в оригинальной статье. Пример вставленной картинки ниже.</p>
<figure>
<img src="http://example.com/2023/07/04/pic1.jpg" width="1200" height="900">
<figcaption>
Первый андроид-фермер смотрит на свои угодья
<span class="copyright">Михаил Родченков</span>
</figcaption>
</figure>
<p>Продолжение статьи после вставленной картинки. В статье рассказывается
о технологии вспахивании земли, которую использует японский андроид-фермер.
Поэтому в материале не обойтись без видеоролика. Пример видеоролика ниже.</p>
<figure>
<video width="1200" height="900">
<source src="http://example.com/2023/07/04/video/42420" type="video/mp4">
</video>
<figcaption>
Андроид-фермер вспахивает землю при помощи собственного изобретения
<span class="copyright">Михаил Родченков</span>
</figcaption>
</figure>
<p>Статья продолжается после видео. Андроид копает картошку.
Фермы развиваются. Япония продолжает удивлять.</p>
]]></content:encoded>
</item>
</channel>
</rss>