Требования к YML-фиду

Товары

Общие требования для товарных фидов:

Каждый товар должен иметь уникальный идентификатор.
Идентификаторы одного товара в разных фидах должны быть одинаковы, в том числе и в фидах разных типов. Например, один и тот же товар в фиде Яндекс Маркета и в фиде Google Shopping должен иметь один и тот же идентификатор.

Подробнее о формате YML для фида Яндекс Маркета в Справке Яндекс Маркета.

Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне заказчика. Дата должна иметь формат YYYY-MM-DD hh:mm.

Список товарных предложений содержится в элементе <offers>. Каждое товарное предложение описывается отдельным элементом <offer>. Элементы <currencies> и <categories> в элементе <shop> нужно указать перед списком товарных предложений. Подробнее о входящих в <shop> элементах в Справке Яндекс Маркета.

Типы описания офера

Есть два типа описания офера — упрощенный и произвольный. Типы описания оферов отличаются только способом передачи названия товара:

в оферах упрощенного типа название товара передается с помощью одного элемента <name>;
в оферах произвольного типа название товара передается с помощью трех элементов: <typePrefix>, <vendor> и <model>.

Можно применить комбинированный тип описания, где одновременно используются элементы для упрощенного и произвольного типов. Преимущество: больше элементов для генерации релевантного объявления.

Упрощенный тип	Произвольный тип	Комбинированный тип
`<name>`Смартфон Samsung Galaxy S22 Ultra 8/128 ГБ, синий`</name>`	`<typePrefix>`Cмартфон`</typePrefix>` `<vendor>`Samsung`</vendor>` `<model>`Galaxy S22 Ultra 8/128 ГБ, синий`</model>`	`<name>`Смартфон Samsung Galaxy S22 Ultra 8/128 ГБ, синий`</name>` `<typePrefix>`Cмартфон`</typePrefix>` `<vendor>`Samsung`</vendor>` `<model>`Galaxy S22 Ultra 8/128 ГБ, синий`</model>`

Внутри одного фида могут одновременно присутствовать оферы упрощенного и произвольного типа.

Примеры оферов

Упрощенный тип описания

Произвольный тип описания (vendor.model)

Базовый, более простой тип описания.

Пример:

  <offer id="0123456" available="true">
    <url>http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc</url>
    <price>1620.00</price>
    <oldprice>1800.00</oldprice>
    <currencyId>RUB</currencyId>
    <categoryId>19</categoryId>
    <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture>
    <picture>http://89.123.45.678/catalog/photo/19/7.JPG</picture>
    <store>false</store>
    <pickup>true</pickup>
    <delivery>false</delivery>
    <name>Антивирус ESET NOD32 Platinum Edition</name>
    <vendor>Eset</vendor>
    <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
    <description>Антивирус ESET NOD32 Platinum Edition - лицензия на 2 года NOD32-ENA-NS(BOX)-2-1</description>
    <video>http://89.123.45.678/catalog/video/19/6.MP4</video>
    <sales_notes>Оплата: Наличные, Б/Н, пластиковые карты, кредит</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Россия</country_of_origin>
    <age unit="year">18</age>
    <property name="Операционная система">Для Windows</property>
  </offer>

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

Пример:

  <offer id="1234567" type="vendor.model" available="true">
    <url>http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc</url>
    <price>889.00</price>
    <oldprice>17000.00</oldprice>
    <currencyId>RUR</currencyId>
    <categoryId>1111</categoryId>
    <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture>
    <picture>http://89.123.45.678/catalog/photo/19/7.JPG</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <typePrefix>Принтер</typePrefix>
    <vendor>НP</vendor>
    <model>Deskjet D2663</model>
    <description>Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати...</description>
    <sales_notes>Необходима предоплата.</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Япония</country_of_origin>
    <property name="Форматы бумаги">A4, A5</property>
  </offer>

Атрибуты элемента <offer>

У атрибута type может быть только одно значение — "vendor.model", которое означает, что офер произвольного типа.

Произвольный тип: <offer id="1234567" type="vendor.model" available="true">
Упрощенный тип: <offer id="0123456" available="true">

Атрибут type влияет на то, наличие каких элементов будет проверять робот Директа при загрузке фида:

Не передаете атрибут type — офер упрощенного типа. Робот проверяет, присутствует ли элемент <name>. При его отсутствии офер будет проигнорирован и объявления для товара не сгенерируются.

Передаете атрибут type — офер произвольного типа. Обязательно наличие элементов <vendor> и <model>. При их отсутствии также возникнет ошибка и офер будет проигнорирован, объявления не сформируются.

Атрибут	Описание	Доступен для настройки фильтров	Обязательный элемент
`id`	Идентификатор товара. Идентификаторы для каждого товара должны быть уникальными. Убедитесь, что `ID` товаров в электронной коммерции совпадают с `offer id`, которые указаны в фиде. Это необходимо для корректного показа по офферному ретаргетингу в РСЯ. Офферный ретаргетинг доступен только для продвижения товаров сайта. Значение `ID` может быть числовым, буквенным или буквенно-числовым. Допускается использование символов. Максимальная длина — 100 знаков. Совет Если вы планируете настраивать фильтр, используйте только числовые значения `ID`. Пример 18295 1223abc a12b34fq	да	да
`type`	Тип описания предложения. Значение должно быть `vendor.model.` Если вы передаете атрибут `type`, то обозначаете, что используется произвольный тип описания. Директ проверяет, присутствуют ли элементы `<vendor>` и `<model>`. При их отсутствии офер будет проигнорирован и объявления для товара не сгенерируются.	нет	для произвольного типа описания
`available`	Возможность купить товар: `true` — товар есть в наличии; `false` — товара нет в наличии. По умолчанию система Директа считает, что все товары, присутствующие в фиде, есть в наличии. Если в фиде есть товары не в наличии, то необходимо указать для каждого офера атрибут `available`. С его помощью можно отфильтровать оферы для генерации объявлений. Сведения о наличии товара, указанные в фиде, должны совпадать с информацией на странице перехода и на страницах оформления покупки.	да	обязательный, если используется фильтр по наличию товара

Элементы, входящие в <offer>

Элемент

Описание

Доступен для настройки фильтров

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

name

Название товарного предложения.

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

Для составления названия товара можно использовать универсальную формулу: ЧТО + КТО + МОДЕЛЬ и МОДИФИКАЦИЯ, где:

«ЧТО» — категория (тип) или подкатегория товара;
«КТО» — производитель, бренд, марка товара;
«МОДЕЛЬ» — название товара, серия, коллекция товара, артикул;
«МОДИФИКАЦИЯ» — важнейшие характеристики товара.

Чтобы Директ корректно создавал объявления, название товара должно совпадать с тем, что указано на странице перехода.

Название не должно содержать рекламный текст, например «бесплатная доставка». Также нельзя писать его заглавными буквами и использовать специальные символы для привлечения внимания.

Пример

<name>Смартфон Samsung Galaxy S22 Ultra 8/128 ГБ, синий</name>
<name>NOW — комплекс витаминов B-50, 100 капс</name>
<name>Длинное приталенное трикотажное черное платье бюстье</name>
<name>Диван Лофт Еллоу механизм еврокнижка Фабрика монолит</name>

да

для упрощенного типа

typePrefix

Тип / категория товара.

Указывая тип товара, руководствуйтесь тем, как этот товар позиционирует производитель. Например, «мобильный телефон», «стиральная машина», «угловой диван». Не используйте слишком общее обозначение типа товара и двусмысленные слова.

Пример

Кроссовки Adidas (VLNEO) V RACER NYLON

<typePrefix>Кроссовки</typePrefix>
Смартфон Apple iPhone 15 Pro 1TB Natural Titanium

<typePrefix>Смартфон</typePrefix>

да

для произвольного типа

vendor

Производитель или бренд (торговая марка). Корректное указание бренда важно для удобства пользователей и способствует эффективности продаж.

Указывайте в качестве бренда название собственного бренда только в том случае, если продаете товар собственного производства или немарочный товар других производителей.

Пример

Кроссовки Adidas (VLNEO) V RACER NYLON

<vendor>Adidas</vendor>
Смартфон Apple iPhone 15 Pro 1TB Natural Titanium

<vendor>Apple</vendor>

да

для произвольного типа

model

Модель и важные параметры (например, название, индекс модели, особенности модификации и т. д.).

Пример

Кроссовки Adidas (VLNEO) V RACER NYLON

<model>(VLNEO) V RACER NYLON</model>
Смартфон Apple iPhone 15 Pro 1TB Natural Titanium

<model>iPhone 15 Pro 1TB Natural Titanium</model>

да

для произвольного типа

categoryId

Идентификатор категории товара, присвоенный пользователем (положительное целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории.

Пример

<categoryId>12345</categoryId>

да

Элемент <offer> может содержать только один элемент <categoryId>.

url

URL страницы товара для продвижения сайта.

Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. (Кириллические ссылки рекомендуем преобразовать с помощью Punycode.) URL‑адрес формируется на основе стандарта RFC 3986.

Пример

<url>https://www.example.ru/myagkaya-mebel/loft-ellou/</url>
<url>https://www.example.ru/myagkaya-mebel/loft-ellou/?product_id=351354&product_category_id=79&category_name=divan</url>

Как кодировать символы в URL?

Символ в тексте	Код для YML-файла
`"`	`"`
`&`	`&`
`>`	`>`
`<`	`<`
`'`	`'`

URL не должен содержать пробелов. Их нужно преобразовать в %20.

да

picture

Ссылка на изображение.

Рекомендуем добавлять в фид 5 изображений. Например, в разных ракурсах или интерьерах. Товар должен занимать не менее 2/3 всей площади изображения.

В РСЯ однотоварный баннер может быть показан в формате карусели. Если в формате может показываться только одна картинка, то выбирается первое изображение, при условии, что его ширина и высота больше или равны размерам блока. Если первая картинка не подходит под эти требования, то рассматривается следующая.

Используйте изображение товара на белом фоне с белой рамкой минимум в один пиксель, без текстов и ярких шрифтов. В URL картинки нужно включить префикс http или https.

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

размер в пикселях — от 450 по каждой стороне;
формат — JPG, PNG, WebP или GIF;
максимальный объем файла — 10 МБ.

Как изменить картинку в объявлении?

Чтобы робот Яндекса обновил изображение товара в объявлениях, нужно изменить ссылку на него в фиде. Например:

ссылка на текущее изображение — <picture>https://ikea.ru/images/1.png</picture>
ссылка на новое изображение — <picture>https://ikea.ru/images/1-new.png</picture>

нет

для товарных объявлений в ЕПК;
для показов в товарной галерее.

description

Описание товарного предложения.

Передавайте подробное описание важных характеристик товара, по которым пользователь делает выбор.

Описание не должно содержать рекламный текст, например «бесплатная доставка», ссылки на сайт магазина, сведения о продаже, а также информацию о конкурентах, других товарах и аксессуарах к ним.

Пример

<description>Односторонний матрас средней жесткости на основе блока независимых пружин EVS 500. Наполнители: пенополиуретан и латексированная кокосовая койра. Размер: 90x195 см, высота: 17 см. Максимальный вес на одно спальное место: 100 кг.</description>

да

нет

sales_notes

Информация о заказе:

минимальной сумме заказа, минимальной партии товара, необходимости предоплаты;
вариантах оплаты, описания акций и распродаж.

Пример

<sales_notes>Наличные, МИР, Visa/Mastercard, б/н расчет</sales_notes>
<sales_notes>Необходима предоплата</sales_notes>
<sales_notes>Скидки до 60%</sales_notes>

нет

param

Передача характеристик и параметров товара.

В атрибуте name обязательно укажите название параметра.

Яндекс Директ учитывает при подборе запросов следующие 4 типа param: материал, цвет, пол, размер. Если используется ручное управление заголовками и текстами, то param не влияют на генерацию объявлений. Если используется автоматическая генерация, то генерируются несколько вариантов текстов на основе элементов офера, в том числе param.

Если производитель использует собственные обозначения цветов, например mineral purple, то дополнительно передайте общепринятое название этого цвета.

Пример

Цвет:

<param name="Цвет">серый</param>

<param name="Цвет">grey</param>
Материал:

<param name="Материал">алюминий</param>

<param name="Материал">titanium</param>
Размер (одежды):

<param name="Размер" unit="INT">S</param>

<param name="Размер" unit="RU">40</param>

При передаче размера обязательно указывайте размерную сетку: RU, EU, US, INT — международные обозначения (для одежды: XS, S, M, L, XL, XXL, 2XL и т. д.; для бюстгальтеров: AA, A, B, C и т. д.).
Габариты:

<param name="Ширина" unit="см">180</param>

<param name="Глубина" unit="см">70</param>

<param name="Высота" unit="см">90</param>

Можно передать габариты товара через ширину, глубину, высоту и диаметр. При этом обязательно нужно указать единицы измерения: мм, см, м.
Пол:

<param name="Пол">женский</param>

Например:

женский, для женщин

мужской, для мужчин

унисекс, для мужчин и женщин

нет

price

Цена, по которой данный товар можно приобрести.

Формат: целое или дробное число.

Разделитель целой и дробной части — точка.

Цена не должна равняться нулю и должна соответствовать стоимости товара на сайте.

Рекомендуемый элемент для Единой перфоманс-кампании.

Пример

<price>1234</price>
<price>1234.56</price>

да

для показов в товарной галерее

oldprice

Старая цена на товар, которая обязательно должна быть выше новой цены (price).

Формат: целое или дробное число.

Разделитель целой и дробной части — точка.

Цена не должна равняться нулю.

На сайте должны быть указаны обе цены: старая и текущая.

В объявлении может быть показана скидка, если в фиде присутствуют теги price и oldprice, и разница между ними 5% и более.

Пример

<price>1620</price>

<oldprice>1800</oldprice>
Размер скидки не покажем, потому что разница между price и oldprice меньше 5%:

<price>1760</price>

<oldprice>1800</oldprice>

да

нет

currencyId

Код валюты.

Поддерживаемые значения

RUR, RUB, USD, EUR, UAH, KZT, BYN, GBP, TRY, ALL, AFN, ARS, AWG, AUD, AZN, BBD, BZD, BMD, BOB, BAM, BWP, BGN, BRL, BND, KHR, CAD, KYD, CLP, CNY, COP, CRC, HRK, CUP, CZK, DKK, DOP, XCD, EGP, SVC, FKP, FJD, GHS, GIP, GTQ, GYD, HNL, HKD, HUF, ISK, INR, IDR, IRR, ILS, JMD, JPY, KPW, KRW, KGS, LAK, LBP, LRD, MKD, MYR, MUR, MXN, MNT, MAD, MZN, NAD, NPR, ANG, NZD, NIO, NGN, NOK, OMR, PKR, PAB, PYG, PEN, PHP, PLN, QAR, RON, SHP, SAR, RSD, SCR, SGD, SBD, SOS, ZAR, LKR, SEK, CHF, SRD, SYP, TWD, THB, TTD, AED, UYU, UZS, VEF, VND, YER, MDL, TJS, GEL, AMD, BHD, KWD.

нет

если есть элемент price

video

Ссылка на видео с товаром.

Видео должно быть в формате MP4, до 45 с и отвечать прочим техническим требованиям.

Примечание

Если видео размещено на хостинге с http-протоколом, то на ресурсах с https-протоколом оно не будет показываться.

Лучше использовать ролик, снятый на стабильную камеру.

Рекомендации по содержанию:

Про товар, а не про бренд.
Без чрезмерного количества надписей, виньеток, блюра, без создания иллюзии, что на видео можно нажать кнопку либо взаимодействовать со звуком.
Демонстрируйте продукт и преимущества предложения в первом кадре видео.
Брендируйте видео — добавляйте в ролики логотип компании.

Подготовьте отдельные видео для каждого товара: так они будут соответствовать заголовку и тексту объявления. Для одного товара может быть только одно видео.

Показы только в РСЯ.

Пример

<video>http://example.ru/catalog/video/19/6.MP4</video>

нет

vendorCode

Код товара (указывается код производителя).

Пример

<vendorCode>A4068LM-12SG</vendorCode>

нет

market_category

Категория товара, в которой он должен быть размещен на Яндекс Маркете.

да

нет

store

Возможность купить товар в розничном магазине:

да, 1, +, true — товар можно купить в розничном магазине;
нет, 0, −, false — возможность покупки в розничном магазине отсутствует.

да

нет

pickup

Возможность самовывоза из пунктов выдачи:

да, 1, +, true — товар можно забрать самостоятельно;
нет, 0, −, false — возможность самовывоза отсутствует.

да

нет

delivery

Возможность курьерской доставки товара:

да, 1, +, true — возможна курьерская доставка;
нет, 0, −, false — товар не может быть доставлен курьером.

нет

manufacturer_warranty

Наличие гарантии:

да, 1, +, true — товар имеет официальную гарантию;
нет, 0, −, false — товар не имеет официальной гарантии.

да

нет

country_of_origin

Страна производства товара.

Пример

<country_of_origin>Россия</country_of_origin>
<country_of_origin>Беларусь</country_of_origin>
<country_of_origin>Вьетнам</country_of_origin>

нет

age

Возрастная категория товара.

Целое неотрицательное число, может быть представлено с префиксом «+» или без него. Если используется «+», он должен располагаться перед числом.

Рекомендуем указывать для товаров, которые предназначены для определенных возрастных групп.

Пример

<age>+6</age>
<age>18</age>

да

нет

adult

Товар относится к категории «для взрослых»:

да, 1, +, true — да;
нет, 0, −, false — нет.

да

нет

downloadable

Возможность скачать товар:

да, 1, +, true — товар можно скачать;
нет, 0, −, false — товар нельзя скачать.

нет

collectionId

Чтобы объявления показывались в комбинированном формате (объявление каталогов и товаров в товарном объявлении), передавайте связь товара с каталогом. Значение равно <collection id> в элементе <collections>.

Значение может быть числовым, буквенным или буквенно-числовым.

Один <offer> может содержать несколько <collectionId>.

да

рекомендуется, если в фиде используются <collections>

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

Кастомные элементы. Произвольное описание. Латинские и кириллические буквы, цифры. Длина одного элемента — до 175 символов.

Кастомные элементы фида могут использоваться только для создания фильтров в Единой перфоманс-кампании. На генерацию креативов они не влияют. Фильтры используются для сегментирования оферов по специфичным параметрам, для которых не предусмотрены стандартные фильтры. Например, для e-com можно задать фильтр по принадлежности товара к конкретной акции.

да

нет

custom_score

Кастомный элемент. Значение — ноль или любое целое положительное число.

Кастомные элементы фида могут использоваться только для создания фильтров в Единой перфоманс-кампании. На генерацию креативов они не влияют. Фильтры используются для сегментирования оферов по специфичным параметрам, для которых не предусмотрены стандартные фильтры. Например, для e-com можно задать фильтр по маржинальности предложения.

да

нет

property name

Характеристика товара, например диагональ экрана телевизора, цвет одежды, условия оплаты и другое. Можно добавить до 10 характеристик.

В характеристиках рекомендуется указывать параметры, которые могут быть важны для принятия решения о покупке.

Характеристики отображаются только в объявлениях в Товарной галерее, если система посчитает, что они могут увеличить вероятность клика и дальнейшей конверсии. В объявлении могут отобразиться характеристики из фида, а также найденные на сайте или у аналогичных товаров в других магазинах. Подробнее о характеристиках товара.

Пример

<property name="Управление">сенсорное</property>

нет

Каталоги

В YML-фиде можно передать информацию о каталогах товаров. В общей структуре файла элемент <collections> идет после элемента <offers>.

Информация о каталогах используется в Единой перфоманс-кампании только для продвижения сайтов. Если продвигается мобильное приложение, показов не будет.

Пример фида для продажи товаров:

  <?xml version="1.0" encoding="utf-8"?>
  <yml_catalog>
    <shop>

      <categories> ... </categories>
      <offers>
        <offer>...
          <collectionId>dukhi1</collectionId>
          <collectionId>kosmetika2</collectionId>
        </offer>
        <offer> ... </offer>
      </offers>

      <collections>
        <collection id="dukhi1">
          <url>https://example.ru/catalog/dukhi</url>
          <picture>https://example.ru/img/1.jpg</picture>
          <picture>https://example.ru/img/2.jpg</picture>
          <name>Мужские духи в интернет-магазине Example</name>
          <description>Мужские духи – подчеркните свой стиль </description>
        </collection>
        <collection id="kosmetika2">
          <url>https://example.ru/catalog/kosmetika</url>
          <picture>https://example.ru/img/3.jpg</picture>
          <picture>https://example.ru/img/4.jpg</picture>
          <name>Косметика для бритья в интернет-магазине Example</name>
          <description>Косметика для бритья: приятный ежедневный уход</description>
        </collection>
      </collections>

    </shop>
  </yml_catalog>

Элементы, входящие в <collections>

Элемент

Описание

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

collection id

Уникальный ID каталога, не более 60 символов. Может быть числовым, буквенным, буквенно-числовым.

Идентификаторы для каждого каталога должны быть уникальны.

да

url

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

В URL обязательно указать протокол http или https.

Как кодировать символы в URL?

Символ в тексте	Код для YML-файла
`"`	`"`
`&`	`&`
`>`	`>`
`<`	`<`
`'`	`'`

URL не должен содержать пробелов. Их нужно преобразовать в %20.

да

picture

Ссылка на изображение.

Можно добавить несколько ссылок на изображения, каждую в собственном элементе picture.

Как изменить картинку в объявлении?

Чтобы робот Яндекса обновил изображение каталога в объявлениях, нужно изменить ссылку на него в фиде. Например:

ссылка на текущее изображение — <picture>https://ikea.ru/images/1.png</picture>
ссылка на новое изображение — <picture>https://ikea.ru/images/1-new.png</picture>

для показов в РСЯ и в Товарной галерее

name

Название каталога.

да

description

Описание каталога.

нет

Пользователи 1С-Битрикс могут быстро сформировать фид со страницами каталога с помощью инструкции.

Если вы работаете с платформой InSales и настроили автоматическое обновление фида, то в него добавится информация о каталогах — дополнительных действий не требуется. Также вы можете сформировать фид с каталогами с помощью произвольной выгрузки для Яндекс Маркета по инструкции.

Пользователи HostCMS могут включить выгрузку фида со страницами каталога по инструкции, см. раздел Коллекции.

Образование

Подготовьте фид в формате YML с информацией об онлайн-курсах и уроках. Каждый курс опишите отдельным элементом <offer>.

При создании товарного объявления на основе данного фида заголовок и текст генерируются автоматически.

Пример фида для образовательных услуг:

<?xml version="1.0" encoding="utf-8"?>
<yml_catalog date="2026-09-25 12:00">
  <shop>
    <name>Школа программирования</name>
    <company>ООО Пример</company>
    <url>https://example.org/</url>
    <email>courses@example.org</email>
    <currencies>
      <currency id="RUR" rate="1"/>
    </currencies>
    <categories>
      <category id="104">Python</category>
    </categories>
    <offers>
      <offer id="python-basic">
        <name>Python для начинающих</name>
        <url>https://example.org/courses/python-basic</url>
        <categoryId>104</categoryId>
        <price>30000</price>
        <currencyId>RUR</currencyId>
        <picture>https://example.org/images/python-basic.jpg</picture>
        <description>Основы Python, работа с данными и итоговый проект.</description>
        <param name="Продолжительность" unit="месяц">3</param>
        <param name="План" order="1" unit="Основы языка" hours="24">Переменные, условия, циклы и функции.</param>
        <param name="План" order="2" unit="Работа с данными" hours="24">Коллекции, файлы и обработка данных.</param>
        <param name="План" order="3" unit="Итоговый проект" hours="24">Разработка и защита учебного проекта.</param>
        <param name="Формат обучения">Самостоятельно с наставником</param>
        <param name="Сложность">Для новичков</param>
        <param name="Тип обучения">Курс</param>
        <param name="Есть домашние работы">true</param>
        <param name="Результат обучения">Сертификат</param>
        <param name="Часы в неделю">6</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Структура файла

Корневой элемент — <yml_catalog>. Внутри него размещена группа <shop> с данными площадки и разделом <offers> с предложениями курсов.

Перед <offers> добавляется группа <categories> с категориями предложений. В каждом предложении указывается <categoryId>, соответствующий идентификатору из этого раздела. Самого <categoryId> внутри предложения недостаточно — раздел <categories> также должен присутствовать в файле.

В данных площадки можно передавать <name>, <company>, <url> и <email>. Директ не использует элементы <picture> и <description> на уровне <shop>. Изображение и описание курса передавайте внутри соответствующего <offer>. Если используете наборы курсов, разместите раздел <sets> перед <offers>. У каждого набора укажите:

<set id> — идентификатор набора;
<name> — название;
<url> — ссылку.

Данные курса

Для распознавания образовательного фида добавьте параметры Продолжительность и План в каждое предложение. Для каждого курса передавайте следующие данные:

Атрибут	Что передается
`name`	Название курса.
`url`	Ссылка на страницу курса.
`description`	Описание курса.
`picture`	Ссылка на изображение курса.
`price`	Стоимость курса. Если указана стоимость, в атрибуте `currencyId` укажите валюту, например RUR.
`param name="Продолжительность"`	Целое неотрицательное число. Единицу измерения укажите в атрибуте `unit`: `час`; `день`; `месяц`.
`param name="План"`	Описание этапа обучения для каждого этапа: `unit` — название этапа; `hours` — длительность в часах; `order` — порядковый номер.

Примечание

Не смешивайте в одном фиде предложения разных категорий бизнеса.

Дополнительные параметры

Параметры передаются внутри группы <offer> в элементах <param name="…">.

Параметр	Формат значения
`Дополнительная категория`	Идентификатор дополнительной категории курса.
`Ссылка на контент курса`	URL страницы с материалами курса. Можно передать несколько элементов.
`Цена по скидке` `Ежемесячная цена` `Ежемесячная цена по скидке`	Целое неотрицательное число.
`Дата окончания скидки` `Дата окончания ежемесячной скидки` `Ближайшая дата`	Дата в формате ISO 8601, например `2026-12-01`.
`Цена за подписку`	Значение `true` или `false`.
`Оплата в рассрочку`	Продолжительность рассрочки в виде целого неотрицательного числа. В атрибуте `unit` укажите единицу измерения, например `месяц`.
`Формат обучения`	Варианты обучения: `Самостоятельно`; `Самостоятельно с наставником`; `В группе с наставником`; `С преподавателем`.
`Есть видеоуроки` `Есть текстовые уроки` `Есть вебинары` `Есть домашние работы` `Есть тренажеры` `Есть сообщество`	Значение `true` или `false`.
`Сложность`	Уровень сложности: `Для новичков`; `Для опытных`.
`Тип обучения`	`Курс` или `Профессия`.
`Есть бесплатная часть` `С трудоустройством`	Значение `true` или `false`.
`Результат обучения`	Вид документа после окончания обучения: `Сертификат`; `Диплом`; `Удостоверение`.
`Часы в неделю`	Целое неотрицательное число.
`Классы`	Строка со списком классов, например `1,2,5-7,9`.

Медицина

Для продвижения услуг врачей подготовьте файл в формате YML. Для каждого места или типа приема создайте отдельное предложение. В каждом предложении указывайте данные об одном враче, клинике и виде приема.

При создании товарного объявления на основе данного фида заголовок и текст генерируются автоматически.

Пример фида для медицинских услуг:

В примере раздел <currencies> сохранен для привычной структуры YML. Директ определяет валюту цены по элементу <currencyId> в предложении.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2026-09-25 12:00">
  <shop>
    <name>Пример клиники</name>
    <company>ООО «Пример клиники»</company>
    <url>https://example.com/</url>
    <currencies>
      <currency id="RUR" rate="1"/>
    </currencies>
    <categories>
      <category id="1">Приемы врачей</category>
    </categories>
    <sets>
      <set id="nevrolog">
        <name>Невролог</name>
        <url>https://example.com/doctors/neurology/</url>
      </set>
    </sets>
    <offers>
      <offer id="doctor-1-clinic-1-primary" group_id="doctor-1">
        <name>Иванов Иван Иванович</name>
        <url>https://example.com/doctors/ivanov/</url>
        <price>3000</price>
        <currencyId>RUR</currencyId>
        <sales_notes>Первичный прием</sales_notes>
        <set-ids>nevrolog</set-ids>
        <picture>https://example.com/images/ivanov.jpg</picture>
        <description>Первичный прием невролога в клинике.</description>
        <categoryId>1</categoryId>
        <param name="Годы опыта">17</param>
        <param name="Город">Клин</param>
        <param name="Адрес клиники">ул. Примерная, д. 1</param>
        <param name="Название клиники">Пример клиники</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Структура файла

Корневой элемент файла — <yml_catalog>. Внутри него размещена группа <shop> с данными о клинике или сервисе и <offers> с предложениями.

Перед <offers> добавляется группа <categories> с категориями предложений. В каждом предложении указывается <categoryId> со ссылкой на соответствующую категорию.

Специальности врачей перечисляются в группе <sets>. Если используете эту группу, разместите ее перед <offers>. У каждой специальности указывается:

<set id> — идентификатор специальности (можно указать до 20 идентификаторов через запятую);
<name> — название специальности;
<url> — ссылка на страницу этой специальности (если есть).

Данные о враче, клинике и приеме передаются внутри <offer>. Отдельные справочники <doctors>, <clinics> и <services> в этом формате не используются.

Данные предложения

Атрибут	Что передается
`offer/@id`	Уникальный идентификатор предложения.
`offer/@group_id`	Общий идентификатор врача. Используйте одинаковое значение для одного врача.
`<name>`	Фамилия, имя и отчество врача.
`<url>`	Ссылка на страницу предложения для перехода из объявления. Предложения без корректной ссылки не обрабатываются.
`<price>`	Стоимость приема — число больше нуля. Для цены «от» добавьте `from="true"`. Если стоимость не передается, не добавляйте элемент.
`<currencyId>`	Валюта цены. При заполненном `price` передайте валюту, например `RUR` или `RUB` для рублей.
`<oldprice>`	Старая цена, если она есть.
`<categoryId>`	Идентификатор категории из `categories`.
`<sales_notes>`	Тип приема.
`<set-ids>`	Идентификаторы специальностей из `sets`.
`<picture>`	Ссылка на изображение врача.
`<description>`	Описание врача или предложения.

Примечание

Для нескольких специальностей Директ обрабатывает предложение по отдельности. Поэтому количество обработанных предложений может быть больше числа элементов offer в файле.

Параметры для определения медицинского фида

В каждом предложении, включая первое, передайте следующие параметры:

Название параметра	Значение
`Годы опыта`	Стаж врача в годах: целое неотрицательное число
`Город`	Город врача
`Адрес клиники`	Адрес места приема
`Название клиники`	Название места приема

<param name="Годы опыта">17</param>
<param name="Город">Клин</param>
<param name="Адрес клиники">ул. Примерная, д. 1</param>
<param name="Название клиники">Пример клиники</param>

По названиям параметров Директ определяет медицинский подтип YML-фида. Заполняйте значения параметров и не смешивайте медицинские предложения с предложениями другого типа в одном файле.

Если первое обрабатываемое предложение определено как медицинское, следующие предложения без полного набора этих параметров будут пропущены с предупреждением. Если у первого предложения подтип не определен, последующие предложения не переключат фид на медицинский подтип.

Дополнительные параметры

Параметры передаются внутри <offer> в элементах <param name="…">. Для логических значений используйте true или false, для дробных чисел — точку в качестве разделителя.

Название параметра	Формат значения
`Фамилия` `Имя` `Отчество`	Текст
`Начало карьеры`	Дата в формате ISO 8601, например `2005-01-01`
`Взрослый врач` `Детский врач`	Значение `true` или `false`
`Средняя оценка` `Профессиональный рейтинг`	Число больше нуля
`Число отзывов`	Целое неотрицательное число
`Степень`	`Кандидат наук` `Доктор наук`
`Звание`	`Профессор` `Доцент`
`Категория`	`Первая категория` `Вторая категория` `Высшая категория`
`Прочие титулы`	Текст
`Город клиники`	Текст
`Возможность записи` `Онлайн-расписание`	Значение `true` или `false`
`Телефон для записи`	Текст
`Внутренний идентификатор врача` `Внутренний идентификатор клиники` `Внутренний идентификатор услуги`	Текстовые идентификаторы
`Прием по омс` `Вызов на дом` `Прием по видеосвязи`	Значение `true` или `false`

Для образования, мест работы, сертификатов и отзывов используйте составные параметры. Номер после - объединяет поля одной записи, а атрибут unit указывает поле:

<param name="Образование - 1" unit="Организация">Пример медицинского университета</param>
<param name="Образование - 1" unit="Дата">2009</param>
<param name="Образование - 1" unit="Название">Базовое образование</param>
<param name="Образование - 1" unit="Специализация">Лечебное дело</param>

Группа	Название параметра	Формат
`Образование - N`	`Организация` `Дата` `Название` `Специализация`	Текст
`Место работы - N`	`Организация` `Дата` `Название`	Текст
`Сертификат - N`	`Организация` `Дата` `Название`	Текст
`Отзыв - N`	`Автор` `Идентификатор автора` `Аватар автора` `Дата` `Отзыв проверен` `Отзыв участвует в рейтинге` `Оценка` `Понравилось` `Не понравилось` `Комментарий` `Ответ` `Ссылка`	Текст, кроме: `Аватар автора` — ссылка на изображение `Ссылка` — URL отзыва `Отзыв проверен` — значение `true` или `false` `Отзыв участвует в рейтинге` — значение `true` или `false` `Оценка` — целое неотрицательное число

Остались вопросы?

Внимание

Специалисты отдела клиентского сервиса могут вас проконсультировать только по кампаниям того логина, с которого вы обращаетесь. Логин можно увидеть, если открыть ya.ru на соседней вкладке браузера. Специалист получит доступ к вашим данным только при обработке обращения.

Сканируйте QR-код или нажмите на него для перехода по ссылке.

При выборе Telegram, WhatsApp, MAX учитывайте, что Яндекс не контролирует, как сторонние мессенджеры хранят ваши данные и переписку на своей стороне, и не несет за это ответственность.

Написать в Viber

Для обращений из Республики Беларусь

Написать в чат

Позвонить

Клиентам и представителям агентств можно связаться с нами круглосуточно по телефонам:

Регионы России: 8 800 700-47-45 (звонок из России бесплатный)

Москва: +7 495 139-91-93

Беларусь: +375 17 336-31-36

Для доступа к кампаниям специалисту потребуется PIN-код

Написать письмо

Клиентам

Агентствам

Формы обратной связи

Требования к YML-фиду

Товары

Каталоги

Образование

Медицина

Остались вопросы?

Полезные ссылки

Правовые документы

Онлайн-обучение

Узнайте больше

Была ли статья полезна?