Обязательные поля
| Название, тип и описание | Требования |
|---|---|
| offer.id (строка) - уникальный ID товара | Максимальное число символов: 128 ID товара должен быть уникальным в рамках одного товарного фида ID товара может включать все символы латинского алфавита в верхнем и нижнем регистре, символы нижнего подчеркивания и дефис, а также цифры Например: 10000000179185 |
| model (строка) - модель товара | Максимально число символов: 256 Рекомендуемое: до 40 Например: Onitsuka Tiger |
| vendor (строка) - название производителя товара | Максимальное число символов: 256 Например: ASICS |
| price (строка) - цена товара | В качестве десятичного разделителя необходимо использовать точку (.), а не запятую (,) Не указывайте валюту с помощью символов $, € или £ Значение поля должно быть более 0 Например: 900 |
| currencyId (строка) - идентификатор валюты товара | Допустимые значения:
Например: RUB |
| url (строка) - URL страницы товара на сайте компании, где можно узнать больше о товаре или купить его | Ссылки должны быть рабочими, начинаться с http:// или https:// и размещаться на домене сайта вашей компании. Они должны вести на правильную страницу каждого из товаров Например: https://aliexpress.ru/item/10000000188131.html |
| picture (строка) - URL основного изображения товара | Допустимые форматы файла изображения — JPEG, PNG, GIF, WEBP Рекомендуемый размер: 600px по большей стороне Минимальный размер: 300px по большей стороне Максимальный размер: 6000px по большей стороне Фон изображения должен быть однотонным, мы рекомендуем использовать белый цвет для фона На картинке должен быть изображен только сам продукт без дополнительных надписей, водяных знаков и логотипов Например: https://aliexpress.ru/item/10000000188131.jpeg При обновлении изображения обязательно измените ссылку на него, иначе изменения не будут распознаны. Изображение товара должно соответствовать требованиям Правил размещения рекламы. См. также Пояснения к Правилам размещения рекламы |
Необязательные поля
| Название, тип и описание | Требования |
|---|---|
| typePrefix (строка) - тип продукта | Максимальное число символов: 256 Например: Кроссовки |
| offer.available (строка) - текущая доступность товара | Одно из значений:
Например: True |
| name (строка) - название товара в упрощенном типе описания товара | Используйте элемент name только в том случае, если невозможно использование элементов typePrefix, vendor и model По умолчанию название продукта формируется именно исходя из значений элементов typePrefix, vendor и model Например: Ноутбук HP Pavilion 15-n064sr |
| description (строка) - описание товара | Максимальное число символов: 256 Описания товаров не должны содержать:
Например: Женская футболка из органического хлопка в королевском синем цвете. Свободная посадка |
| oldprice (строка) - старая цена товара | Требования к содержимому поля и форматированию аналогичны полю price Например: 900 |
custom_label (строка) - пользовательские поля с дополнительной информацией. Используются при создании групп продуктов Варианты: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
| Максимальное число символов: 256 Например: Летняя распродажа |
| param name="Пол" ИЛИ param name="Gender" (строка) - пол, для которого предназначен товар | Одно из значений, допустимо написание на русском или английском языке:
Значения тега могут быть как в верхнем регистре, так и в нижнем. Например: ЖЕНСКИЙ, Женский или женский. |
| rating (float) - пользовательский рейтинг товара | Допускается использовать только положительное float-число от 1 до 5 включительно Например: 4.0 |
| currencies (строка) - содержит список идентификаторов валют | Допустимые значения:
Например: RUB |
Обязательные поля для мобильных приложений
| Название, тип и описание | Требования |
|---|---|
| android_tracking_url (строка) - трекинг-ссылка для Android | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/goldapple.ru.goldapple.customers?pid=mail.ru_int |
| ios_tracking_url (строка) - трекинг-ссылка для iOS | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/id1154436683?pid=mail.ru_int |
| bundle_id (строка) - идентификатор Android приложения | Требований нет Например: ru.sunlight.sunlight |
| ios_app_store_id (строка) - идентификатор iOS приложения | Требований нет Например: 1068913968 |
| android_url (строка) - диплинк для Android | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
| ios_url (строка) - диплинк для iOS | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
Пример каталога для товаров в формате XML
Обратите внимание, если фид создан по спецификации Яндекс и товарные позиции имеют произвольный тип, то в теге <offer> обязательно должен быть указан атрибут type="vendor.model"
<offer id="12346" type="vendor.model" >...</offer>
Пример каталога:
<?xml version="1.0" encoding="UTF-8"?><yml_catalog date="2020-11-22T14:37:38+03:00"> <shop> <name>BestSeller</name> <company>The Best inc.</company> <currencies> <currency id="RUR" rate="1"/> </currencies> <categories> <category id="1">Бытовая техника</category> <category id="10" parentId="1">Мелкая техника для кухни</category> </categories> <offers> <offer id="0123456" available="true"> <name>Антивирус ESET NOD32 Platinum Edition</name> <description>Антивирус ESET NOD32 Platinum Edition - лицензия на 2 года NOD32-ENA-NS(BOX)-2-1</description> <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>RUR</currencyId> <categoryId>10</categoryId> <param name="Пол">женский</param> <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture> <rating>4.3</rating> </offer> </offers> </shop></yml_catalog>
Пример фида с мобильными параметрами
<offer id="NI464AMDNAN4" available="true"<url>https://www.somesite.ru/q/lorem/ipsumdolorsitamet/</url<price>3860</price><oldprice>4290</oldprice><currencyId>RUB</currencyId<picture>https://somesite.ru/pics/loremipsumdolorsitamet.jpg</picture<typePrefix>loremipsumdolorsitamet</typePrefix><vendor>abc</vendor><model>abc</model><description>Lorem ipsum dolor sit amet, consectetur adipiscing elit</description><ios_url>clips//clip/105207/</ios_url><android_url>clips://clip/105207/</android_url<bundle_id>com.vk.clips</bundle_id><ios_app_store_id>1615733452</ios_app_store_id><ios_tracking_url>https://app.adjust.com/abcd?campaign=&creative=&deep_link=ozon://products/105207/</ios_tracking_url><param name="Пол">женский</param><android_tracking_url>https://app.adjust.com/abcd?campaign=&creative=&deep_link=ozon://products/105207/</android_tracking_url></offer>