---
source: https://yandex.ru/support/direct/ru/feeds/mobile-apps-requirements-yml
---


# Требования к YML-фиду для продвижения приложений

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

Подробнее о формате YML для фида Яндекс Маркета в [Справке Яндекс Маркета](https://yandex.ru/support/marketplace/ru/assortment/auto/yml?lang=ru).

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

Список товарных предложений содержится в элементе `<offers>`. Каждое товарное предложение описывается отдельным элементом `<offer>`. Элементы `<currencies>` и `<categories>` в элементе `<shop>` нужно указать перед списком товарных предложений. Подробнее о входящих в `<shop>` элементах в [Справке Яндекс Маркета](https://yandex.ru/support/marketplace/ru/assortment/auto/yml).

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

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

- в оферах упрощенного типа название товара передается с помощью одного элемента `<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>https://app.appsflyer.com/com.your.app?advertising_id={google_aid%}&amp;pid=yandexdirect_int&amp;clickid=%{logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>
    <price>1620.00</price>
    <oldprice>1800.00</oldprice>
    <currencyId>RUB</currencyId>
    <categoryId>19</categoryId>
    <picture>https://site.ru/images/1.png</picture>
    <picture>https://site.ru/images/2.png</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>
  </offer>
```

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

**Пример:**

```
  <offer id="1234567" type="vendor.model" available="true">
    <url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid%}&amp;pid=yandexdirect_int&amp;clickid=%{logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>
    <price>889.00</price>
    <oldprice>17000.00</oldprice>
    <currencyId>RUR</currencyId>
    <categoryId>1111</categoryId>
    <picture>https://site.ru/images/1.png</picture>
    <picture>https://site.ru/images/2.png</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>
  </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` может быть числовым, буквенным или буквенно-числовым. Допускается использование символов. Максимальная длина — 100 знаков.  Совет  Если вы планируете настраивать фильтр, используйте только числовые значения `ID`. Пример - 18295 - 1223abc - a12b34fq | да | да |
  | `type` | Тип описания предложения.  Значение должно быть `vendor.model.`  Если вы передаете атрибут `type`, то обозначаете, что используется произвольный тип описания. Директ проверяет, присутствуют ли элементы `<vendor>` и `<model>`. При их отсутствии офер будет проигнорирован и объявления для товара не сгенерируются. | нет | для произвольного типа описания |
  | `available` | Возможность купить товар:  `true` — товар есть в наличии; `false` — товара нет в наличии.  По умолчанию система Директа считает, что все товары, присутствующие в фиде, есть в наличии. Если в фиде есть товары не в наличии, то необходимо указать для каждого офера атрибут `available`. С его помощью можно отфильтровать оферы для генерации объявлений.  Сведения о наличии товара, указанные в фиде, должны совпадать с информацией на странице перехода и на страницах оформления покупки. | да | обязательный, если используется фильтр по наличию товара |

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

|  |  |  |  |
| --- | --- | --- | --- |
| **Элемент** | **Описание** | **Доступен для настройки фильтров** | **Обязательный элемент** |
| `name` | Название товара или услуги. Длина — до 56 символов.  В названии упрощенного предложения рекомендуется указывать наименование и код производителя, основные характеристики, важные для пользователя.  Для составления названия товара можно использовать универсальную формулу: `ЧТО + КТО + МОДЕЛЬ и МОДИФИКАЦИЯ`, где:   - «ЧТО» — категория (тип) или подкатегория товара; - «КТО» — производитель, бренд, марка товара; - «МОДЕЛЬ» — название товара, серия, коллекция товара, артикул; - «МОДИФИКАЦИЯ» — важнейшие характеристики товара.   Чтобы Директ корректно создавал объявления, название товара должно совпадать с тем, что указано на странице перехода.  Название не должно содержать рекламный текст, например «бесплатная доставка». Также нельзя писать его заглавными буквами и использовать специальные символы для привлечения внимания. Пример - `<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` | [Стандартная трекинговая ссылка](../products-mobile-apps-ads/tracking-systems.md) или трекинговая ссылка в формате OneLink. Рекомендуем добавить к трекинговой ссылке [отложенный диплинк](../products-mobile-apps-ads/tracking-systems.md#delayed-deeplink), чтобы пользователь после установки приложения сразу переходил на карточку товара.  Максимальная длина ссылки — 2048 символов.  Допускаются кириллические ссылки. (Кириллические ссылки рекомендуем преобразовать с помощью [Punycode](https://www.punycoder.com/).) URL‑адрес формируется на основе стандарта [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986). Пример `<url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid}&amp;pid=yandexdirect_int&amp;clickid={logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116<url>` Как кодировать символы в URL? |  |  | | --- | --- | | **Символ в тексте** | **Код для YML-файла** | | `"` | `&quot;` | | `&` | `&amp;` | | `>` | `&gt;` | | `<` | `&lt;` | | `'` | `&apos;` |   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` | Описание товара. Длина — до 81 символа.  Передавайте подробное описание важных характеристик товара, по которым пользователь делает выбор.  Описание не должно содержать рекламный текст, например «бесплатная доставка», ссылки на сайт магазина, сведения о продаже, а также информацию о конкурентах, других товарах и аксессуарах к ним. Пример `<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`. | нет | да |
| `video` | Ссылка на видео с товаром.  Видео должно быть в формате MP4, до 45 с и отвечать прочим [техническим требованиям](../moderation/technical-restrictions.md#video__product-video).  Примечание  Если видео размещено на хостинге с 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` — товар нельзя скачать. | нет | нет |
| - `custom_label_0` - `custom_label_1` - `custom_label_2` - `custom_label_3` - `custom_label_4` | Кастомные элементы. Произвольное описание. Латинские и кириллические буквы, цифры. Длина одного элемента — до 175 символов.  Кастомные элементы фида могут использоваться только для создания фильтров. На генерацию креативов они не влияют. Фильтры используются для сегментирования оферов по специфичным параметрам, для которых не предусмотрены стандартные фильтры. Например, можно задать фильтр по принадлежности товара к конкретной акции. | да | нет |
