Разметка и подключение ленты RSS

Чтобы материалы с вашего сайта корректно отображались в ленте рекомендаций, вам нужно разметить ленту RSS и добавить туда специальные теги.

Требования и рекомендации

Примечание

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

Рекомендации

  • Вы можете редактировать публикации, ранее отправленные в ленту RSS. Для этого надо указать изначальный guid, чтобы не создавать дубликаты. Ограничений на количество обновлений нет. При этом если вы внесёте изменение в публикацию вручную в Студии Дзена, то следующие изменения через RSS отображаться не будут.

  • Перед тем, как отправлять размеченную RSS-ленту в Дзен, проверьте её валидатором. Критических ошибок быть не должно, но остальные ошибки допустимы из-за специфики нашей разметки.

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

  • Чтобы познакомиться с основами RSS-ленты для Дзена, рекомендуем вам посмотреть вебинар на эту тему.

Требования к контенту

Все публикации в RSS-ленте должны соответствовать требованиям Дзена. Мы также просим издателей размечать материалы специальными элементами. Технические подробности — в разделе Описание материала.

Технические требования

  • Для разметки содержимого статей используйте только HTML, который указан в настоящих рекомендациях к RSS — это гарантирует корректное отображение материалов на платформе.

  • При первой разметке лента должна содержать минимум 10 материалов. При этом на сайте должно быть размещено не менее 3 публикаций за последний месяц.

  • Если ваша публикация содержит картинки, для их добавления используйте элементы img и figure. Минимальная ширина картинки — 700 пикселей. Для наилучшего отображения в ленте присылайте изображения большого размера. В формате статей для обложки публикации используйте элемент enclosure.

  • URL материалов должен быть ЧПУ (человеко-понятным), без UTM-меток и других параметров.

  • Откройте роботу доступ к материалам, чтобы они показывались в RSS-ленте. Убедитесь, что в текстовом файле robots.txtrobots.txt адрес RSS не запрещен директивой Disallow, или явно разрешите его директивой Allow RSS_URL.

    Пример:

    # Если в robots.txt
    прописана директива Disallow /feed # то робот не проиндексирует страницу
    your-site.ru/feed/some_url/rss.xml # Чтобы разрешить индексацию, добавьте директиву Allow
    /feed/some_url/rss.xml
    

Ограничения

  • Все параметры, предназначенные для дополнительного оформления и сложной вёрстки, не обрабатываются. Для корректного отображения вашего контента на платформе советуем придерживаться набора элементов, указанного в таблицах ниже.
  • Обрабатываются только изображения: видео и другой медиаконтент обработаны не будут и не попадут на платформу. Вы можете загрузить материал на платформу как черновик и добавить видео и другой контент вручную. Подробнее о том, как это сделать при помощи элемента category — в таблице ниже.
Пример разметки видео, который мы не обрабатываем
<figure> <video width="1200" height="900"> <source
src="http://example.com/42420" type="video/mp4"> </video> <figcaption>
Андроид-фермер вспахивает землю при помощи собственного изобретения <span
class="copyright">Михаил Родченков</span> </figcaption>
</figure>
Пример формата изображений и видео, который мы не принимаем
<media:content type="image/jpeg" medium="image" width="900" height="300"
url="http://example.com/2023/07/04/pic1.jpg"> <media:description type="plain">
Андроид-фермер смотрит на свои угодья </media:description>
<media:copyright>Михаил Родченков</media:copyright>
</media:content>

Описание материала

Набор элементов, описывающих материал, располагается внутри элемента item. Обязательные элементы отмечены значком .

Элемент

Описание

title 

Заголовок. Это тег обязателен, но игнорируется при конвертации материала в пост. Если вы хотите, чтобы заголовок отображался в посте, продублируйте его внутри элемента content:encoded.

category 

Способ публикации

Выберите способ размещения материала на платформе. Если этого не сделать, материал будет автоматически опубликован и сразу появится на канале.

  • native-draft — материал сохранится на платформе в качестве черновика. Вы можете отредактировать черновик по своему усмотрению и опубликовать. Для материалов, отправленных в native-draft, не действует время публикации из pubDate, т. к. материал находится в черновике.

Тип публикации

Выберите тип публикации: format-article — статья или format-post — пост. Если вы выберете format-post, но в нём будет больше 4000 символов и больше 10 картинок, публикация будет преобразована в статью. Если не выбрать формат, конвертация произойдет автоматически. Особенности конвертации:

  • Меньше 800 символов и нет картинок — конвертация в пост.
  • Меньше 600 символов и до 10 картинок — конвертация в пост.
  • Материал содержит код вставки или эмбед — конвертация в статью.
  • Во всех остальных случаях материал будет автоматически опубликован как статья.

Индексация материала, созданного на платформе

  • index — материал индексируется в поисковых системах.
  • noindex — материал не индексируется в поисковых системах.

Способ комментирования

  • comment-all — комментировать могут все пользователи.
  • comment-subscribers — комментировать могут только подписчики.
  • comment-none — комментарии закрыты для всех.

Отключение рекламы

  • advertisement-off — реклама в публикации показываться не будет.

Нативная реклама

  • native_ads — пометка о том, что в публикации есть нативная реклама.

guid 

Уникальный идентификатор статьи.

Если вы хотите отредактировать уже отправленную статью или повторно отправить статью в ленту RSS, укажите её изначальный guid или URL, чтобы не создавать дубликаты.

pubDate 

Дата и время публикации в формате RFC822: Wed, 02 Oct 2002 15:00:00 +0300.

Вы можете запланировать время публикации материала: для этого укажите нужную дату и время. Минимальное время для отложенной публикации — 1 час. Дата публикации не будет работать для материалов, отправленных в черновики.

enclosure

Описание изображения, которое будет на обложке статьи. Может быть как единственным упоминанием медиаконтента, так и дублировать элементы figure или img, размещаемые внутри content:encoded. Если вы опубликовали контент в формате поста, и картинок в элементах figure или img нет, но картинки есть в элементе enclosure, они опубликуются в посте как обычные изображения (до 10 штук).

Для лучшего отображения на карточке в ленте рекомендации рекомендуем присылать URL изображения наибольшего размера. Минимальная ширина изображения — 700 пикселей.

content:encoded 

Полный текст (рекомендуемый объём — не менее 300 знаков с пробелами). Содержит элементы для размещения медиаконтента.

Внимание

Материалы из RSS-ленты, не размеченные по этим критериям, могут не попадать в Дзен, либо отображаться на платформе некорректно.

Параметры, которые поддерживаются внутри этого элемента:

  • p — абзац;

  • a — ссылки;

  • b — жирный;

  • i — курсив;

  • u — подчеркивание;

  • s — зачеркивание;

  • h1, h2, h3, h4 — заголовки;

  • blockquote — цитата;

  • <ul><li>— маркированный список (внутри списка не поддерживается другое форматирование);

  • <ol><li> — нумерованный список (внутри списка не поддерживается другое форматирование);

  • h1, h2 — заголовки первого уровня;

  • h3, h4 — заголовки второго уровня;

    В текст можно добавить оглавление: для этого заголовку h2, h3 или h4 присвойте идентификатор id.

    Пример оглавления с якорем <h2 id="neravnoznachne_po_smsly">Неравнозначные по смыслу</h2>

    Пример ссылки на якорь <a href="#neravnoznachne_po_smsly">Неравнозначные по смыслу</a>

    Элемент content:encoded поддерживает коды вставки разных платформ и соцсетей. Примеры таких вставок:

    YouTube
    <iframe width="560" height="315" src="https://www.youtube.com/embed/CD9BIkXwR1U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> 
    
    Яндекс Музыка
    <iframe frameborder="0" style="border:none;width:100%;height:450px;" width="100%" height="450" src="https://music.yandex.ru/iframe/#album/13233340">Слушайте <a href='https://music.yandex.ru/album/13233340'>Страдающее Средневековье</a> на Яндекс.Музыке</iframe> 
    

    Ссылка на сервисы, не оформленная как код вставки, также превратится в виджет.

    Чтобы добавить публикацию в виде виджета, необязательно копировать и добавлять код вставки — RSS-лента автоматически превращает в виджет следующие ссылки:

    • Видео Дзена
    • Яндекс Музыка
    • Youtube

    Внимание

    В формате постов поддерживается форматирование только гиперссылок и списков. Другое форматирование в постах не поддерживается.

link 

URL статьи, данные которой транслируются в ленте RSS.

pdalink

Ссылка на версию, адаптированную для мобильных устройств.

description

Описание статьи, которое будет отображаться в карточке материала в ленте.

Описание изображений

Элементы, описывающие медиаконтент, располагаются внутри элемента content:encoded. Обязательные элементы отмечены значком .

Внимание

Для изображений выбирайте файлы в формате JPEG, GIF или PNG. Первое изображение, размеченное этим элементом, появится на карточке в ленте Дзена. Для лучшего отображения на карточке в ленте рекомендаций желательно присылать URL изображения наибольшего размера. Минимальная ширина изображения — 700 пикселей. Если изображение пришло в некорректном формате, публикация отправится в черновики — там вы сможете вручную вставить подходящую картинку.

Элемент

Описание

figure 

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

<figure> <img src="http://example.com/pic1.jpg"> 
<figcaption> Первый андроид-фермер смотрит на свои угодья </figcaption> </figure> 

img 

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

Пример размеченной ленты

<?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> <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>
<guid>2fd4e1c67a2d28fced849ee1bb76e7391b93eb12</guid> <pubDate>Tue, 4
Jul 2023 04:20:00 +0300</pubDate> <media:rating
scheme="urn:simple">nonadult</media:rating>
<category>native-yes</category> <enclosure
url="http://example.com/2023/07/04/big_pic1.jpg" type="image/jpeg"/>
<content:encoded> <![CDATA[<p>Здесь находится полный текст статьи. Его
могут прерывать картинки.</p> <figure> <img
src="http://example.com/2023/07/04/big_pic1.jpg"> <figcaption> Первый
андроид-фермер смотрит на свои угодья <span class="copyright">Михаил
Родченков</span> </figcaption> </figure> <p>Продолжение статьи
после вставленной картинки. В статье рассказывается о&nbsp;<a
href="https://ru.wikipedia.org/wiki/Вспашка">технологии вспахивания земли</a>,
которую использует японский андроид-фермер.</p> <p>Что фермеры используют для
работы: <ul> <li><i>тяпки</i>;</li>
<li><b>грабли</b>;</li>
<li><u>велосипеды</u>;</li>
<li><s>плуги</s>;</li> </p> <p>Статья продолжается.
Андроид копает картошку. Фермы развиваются. Япония продолжает удивлять.</p>]]>
</content:encoded> </item> </channel> </rss>