Требования к 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&amp;utm_source=ya_market&amp;utm_medium=cpc&amp;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;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` может быть числовым, буквенным или буквенно-числовым. Допускается использование символов. Максимальная длина — 100 знаков. Пример 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 или 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 можно задать фильтр по маржинальности предложения.

да

нет

Каталоги

В 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>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>

Элемент

Описание

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

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 и настроили автоматическое обновление фида, то в него добавится информация о каталогах — дополнительных действий не требуется. Также вы можете сформировать фид с каталогами с помощью произвольной выгрузки для Яндекс Маркета по инструкции.

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

Внимание

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

Написать в WhatsApp

Перейти в WhatsApp

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

Позвонить

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

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

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

Беларусь: 8 820 00-73-00-52 (звонок из Беларуси бесплатный), +375 17 336-31-36

Узбекистан: +998 71 205-58-05

Казахстан: +7 727 313-28-05

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

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

Клиентам

Агентствам

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

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

Товары

Каталоги

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

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

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

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

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

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