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

Товары

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

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

Фид Яндекс Маркета в формате YML (Yandex Market Language) может использоваться для типов бизнеса «Розничная торговля» и «Другой бизнес». Подробнее о формате 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>

Упрощенный тип	Произвольный тип	Комбинированный тип
<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&amp;utm_source=ya_market&amp;utm_medium=cpc&amp;</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>
</offer>

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

Пример:

<offer id="1234567" type="vendor.model" available="true"> 
  <url>http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&amp;utm_source=ya_market&amp;utm_medium=cpc&amp;</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> 
</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 может быть числовым, буквенным, так и буквенно-числовым. Пример 18295 1223abc a12b34fq	да	да
type	Тип описания предложения. Значение должно быть vendor.model. Если вы передаете атрибут type, то обозначаете, что используется произвольный тип описания. Директ проверяет, присутствуют ли элементы <vendor> и <model>. При их отсутствии офер будет проигнорирован и объявления для товара не сгенерируются.	нет	для произвольного типа описания
available	Возможность купить товар: true — товар есть в наличии; false — товара нет в наличии. По умолчанию система Директа считает, что все товары, присутствующие в фиде, есть в наличии. Если в фиде есть товары не в наличии, то необходимо указать для каждого офера атрибут available. С его помощью можно отфильтровать оферы для генерации объявлений. Сведения о наличии товара, указанные в фиде, должны совпадать с информацией на странице перехода и на страницах оформления покупки.	да	обязательный, если используется фильтр по наличию товара

Атрибут	Описание	Доступен для настройки фильтров	Обязательный элемент
id	Идентификатор товара. Идентификаторы для каждого товара должны быть уникальными. Убедитесь, что ID товаров в электронной коммерции совпадают с offer id, которые указаны в фиде. Это необходимо для корректного показа по оферному ретаргетингу в РСЯ. Значение 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 обязательно указать протокол http или https. Пример <url>https://www.example.ru/myagkaya-mebel/loft-ellou/</url> <url>https://www.example.ru/myagkaya-mebel/loft-ellou/?product_id=351354&amp;product_category_id=79&amp;category_name=divan</url> Как кодировать символы в URL? Символ в тексте Код для YML-файла " &quot; & &amp; > &gt; < &lt; ' &apos; Символ в тексте Код для YML-файла " &quot; & &amp; > &gt; < &lt; ' &apos; URL не должен содержать пробелов. Их нужно преобразовать в %20.	да	да
picture	Ссылка на изображение. Рекомендуем добавлять в фид 5 изображений. Например, в разных ракурсах или интерьерах. Товар должен занимать не менее 2/3 всей площади изображения. В РСЯ однотоварный баннер может быть показан в формате карусели. Если в формате может показываться только одна картинка, то выбирается первое изображение, при условии что его ширина и высота больше или равны размерам рекламного блока. Если первая картинка не подходит под эти требования, то рассматривается следующая. Используйте изображение товара на белом фоне с белой рамкой минимум в один пиксель, без текстов и ярких шрифтов. В URL картинки нужно включить префикс http или https. Технические требования: размер в пикселях — от 450 по каждой стороне; формат — JPG, PNG или 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	Возможность купить товар в розничном магазине: true — товар можно купить в розничном магазине; false — возможность покупки в розничном магазине отсутствует.	да	нет
pickup	Возможность самовывоза из пунктов выдачи: true — товар можно забрать самостоятельно; false — возможность самовывоза отсутствует.	да	нет
delivery	Возможность курьерской доставки товара: true — возможна курьерская доставка; false — товар не может быть доставлен курьером.	нет	нет
manufacturer_warranty	Наличие гарантии: true — товар имеет официальную гарантию; 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	Товар относится к категории «для взрослых»: true — да; false — нет.	да	нет
downloadable	Возможность скачать товар: true — товар можно скачать; 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 можно задать фильтр по маржинальности предложения.	да	нет

Элемент	Описание	Доступен для настройки фильтров	Обязательный элемент
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 обязательно указать протокол http или https. Пример <url>https://www.example.ru/myagkaya-mebel/loft-ellou/</url> <url>https://www.example.ru/myagkaya-mebel/loft-ellou/?product_id=351354&amp;product_category_id=79&amp;category_name=divan</url> Как кодировать символы в URL? Символ в тексте Код для YML-файла " &quot; & &amp; > &gt; < &lt; ' &apos; Символ в тексте Код для YML-файла " &quot; & &amp; > &gt; < &lt; ' &apos; URL не должен содержать пробелов. Их нужно преобразовать в %20.	да	да
picture	Ссылка на изображение. Рекомендуем добавлять в фид 5 изображений. Например, в разных ракурсах или интерьерах. Товар должен занимать не менее 2/3 всей площади изображения. В РСЯ однотоварный баннер может быть показан в формате карусели. Если в формате может показываться только одна картинка, то выбирается первое изображение, при условии что его ширина и высота больше или равны размерам рекламного блока. Если первая картинка не подходит под эти требования, то рассматривается следующая. Используйте изображение товара на белом фоне с белой рамкой минимум в один пиксель, без текстов и ярких шрифтов. В URL картинки нужно включить префикс http или https. Технические требования: размер в пикселях — от 450 по каждой стороне; формат — JPG, PNG или 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	Возможность купить товар в розничном магазине: true — товар можно купить в розничном магазине; false — возможность покупки в розничном магазине отсутствует.	да	нет
pickup	Возможность самовывоза из пунктов выдачи: true — товар можно забрать самостоятельно; false — возможность самовывоза отсутствует.	да	нет
delivery	Возможность курьерской доставки товара: true — возможна курьерская доставка; false — товар не может быть доставлен курьером.	нет	нет
manufacturer_warranty	Наличие гарантии: true — товар имеет официальную гарантию; 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	Товар относится к категории «для взрослых»: true — да; false — нет.	да	нет
downloadable	Возможность скачать товар: true — товар можно скачать; 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 можно задать фильтр по маржинальности предложения.	да	нет

Каталоги

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

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

Чтобы объявления показывались в комбинированном формате (объявление для страниц каталога и товарное объявление), внутри элементов <offer> укажите связи с каталогами — добавьте элемент <collectionId> со значением <collection id>. Один <offer> может содержать несколько <collectionId>.

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

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