Элементы внутри offer в упрощенном типе
Упрощенный и произвольный типы подходят для большинства товаров. Оба типа предоставляют равные возможности и обеспечивают одинаковое качество привязки к карточкам модели и отображению в Поиске.
В упрощенном типе производитель, тип и название товара указываются в одном элементе. В произвольном типе эти данные надо указывать в отдельных элементах.
Формат фида для подключения интернет-магазина к Поиску создан на основе формата для интеграции с Яндекс Маркетом. При этом некоторые элементы в описанном формате необязательны или не используются для формирования результатов в Поиске.
Если для подключения к Поиску вы используете уже сформированный фид для Маркета или сгенерированный с помощью плагина для CMS, посмотрите список элементов.
Ниже перечислены элементы, необходимые для подключения магазина к Поиску.
Список и описание элементов
Элементы, специфичные для упрощенного типа описания |
Описание элемента |
Примечание |
Обязателен |
На что влияет |
|
Полное название товара. Рекомендуем ознакомиться с разделом подробным описанием элемента. |
Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке. Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей. Оптимальная длина — 50‑60 символов, максимальная — 150. Составлять хорошие названия помогут рекомендации. Пример: Ударная дрель Makita HP1630, 710 Вт |
Да |
Используется для формирования объединенной карточки товара. |
Стандартные элементы |
Описание |
Примечание |
Обязателен |
На что влияет |
|
Название производителя. |
Указывайте название так, как его пишет сам бренд. |
Нет |
Используется для формирования объединенной карточки товара. |
|
Артикул производителя. Код товара, который ему присвоил производитель. |
Если артикулов несколько, укажите их через запятую. Пример: |
Нет |
Используется для формирования объединенной карточки товара. |
|
Атрибут элемента У каждого товара SKU должен быть свой. После добавления товара поменять его SKU нельзя. |
Любая последовательность длиной до 80 знаков. В нее могут входить английские и русские (кроме ё) буквы, цифры и символы . , / \ ( ) [ ] - = Идентификатор должен быть уникальным для каждого товара, при этом это должны быть разные товары. Под разными идентификаторами может быть один и тот же товар, если он продается в разных регионах или у товара есть признак бывшего в употреблении (б/у). Пример: belaya-kofta-12345 |
Да |
|
|
Адрес страницы на вашем сайте с фотографиями и описанием товара. |
Максимальная длина URL — 512 символов. Записывайте его согласно стандарту RFC 3986. Пример: |
Да |
|
|
Цена одной единицы товара, включая все налоги. |
Основная часть данных обновляется в Поиске раз в 4 часа. Чтобы быстро обновить цену, используйте API Поиска. |
Да |
|
|
Цена до скидки. Если товар продается со скидкой, укажите в этом поле цену без учета скидки. |
Цена указывается в рублях. Число должно быть целым. Можно указать цену со скидкой от 5 до 75%.
|
Нет |
|
|
Валюта, в которой указана цена товара. |
Поддерживаются российские рубли (RUR). |
Да |
|
|
Категория в магазине. Элемент |
Старайтесь указать категорию более конкретно. Например, тушь для ресниц лучше отнести к категории Декоративная косметика, а не просто Косметика. |
Да |
|
|
Атрибут элемента |
Для участия в Поиске используйте только со значением |
Нет |
|
|
Изображение товара. |
Принимаются изображения в формате JPEG или PNG. Вес до 10 МБ, размер не меньше 300 × 300 пикселей. Укажите ссылку на изображение или несколько изображений. Первое фото становится основным. |
Да |
Используется для формирования объединенной карточки товара. |
|
Наличие курьерской доставки. |
Принимает значения Указывает на условия, специфичные для товара. Условия доставки, которые действуют для магазина в целом, указывайте внутри элемента |
Нет |
|
|
Количество дней, требуемых на доставку. Может содержать до 5 элементов |
Указывает на условия, специфичные для товара. Условия доставки, которые действуют для магазина в целом, указывайте внутри элемента |
Нет |
|
|
Наличие самовывоза. |
Принимает значения Указывает на условия, специфичные для товара. Условия самовывоза, которые действуют для магазина в целом, указывайте внутри элемента |
Нет |
|
|
Стоимость и сроки доставки до пункта выдачи заказов. |
Указывает на условия, специфичные для товара. Условия самовывоза, которые действуют для магазина в целом, указывайте внутри элемента |
Нет |
|
|
Описание товара. |
Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок», «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте контактную информацию и не размещайте ссылки. Можно использовать теги Оптимальная длина — 400‑600 символов, максимальная — 3000. Пример: В комплекте с детским микроскопом есть все, что нужно вашему ребенку для изучения микромира. |
Да |
Используется для формирования объединенной карточки товара. |
|
Условия продажи, доставки. Рассказывает о дополнительных услугах (в свободной форме). |
Условия для конкретного товара. Параметры доставки и самовывоза есть не только у товара, но и у магазина. Если для товара условия не заданы, действуют настройки, заданные для магазина. |
Нет |
|
|
Товар имеет отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирует интерес к сексу. Возможные значения — |
Используйте этот элемент вместо элемента |
Нет |
|
|
Штрихкод товара от производителя. Если товар продается упаковками — нужен штрихкод упаковки. |
Указывайте в виде последовательности цифр. Подойдут коды Для товаров определенных категорий и торговых марок обязательно передавайте код GTIN. Внутренние коды, которые начинаются на 2 или 02, не подходят. Для книг указывайте ISBN. Если штрихкодов несколько, напишите все через запятую. Пример: 4601230000000 |
Нет |
Используется для формирования объединенной карточки товара. |
|
Характеристики товара. |
Каждый имеет обязательный атрибут
|
Нет |
|
|
Вес товара с упаковкой. |
Указывайте в килограммах. Можно использовать дроби: разделитель — точка или запятая, не больше трех цифр после него. Пример: 3.1 |
Нет |
|
|
Длина, ширина, высота в упаковке. |
Указывайте в сантиметрах. Можно использовать дроби: разделитель — точка или запятая, не больше трех цифр после него. Пишите числа через / без пробелов. Пример: 20.1/20.551/22.5 |
Нет |
|
|
Срок годности. Период, по прошествии которого товар становится непригоден. Отсчитывается от даты изготовления, а не от даты добавления на маркетплейс. |
Срок можно указывать в годах, месяцах, днях, неделях и часах. Обязательно указывайте срок, если он есть. Продолжительность указывается согласно ISO 8601, то есть в виде строчки, начинающейся буквой P:
|
Нет |
|
|
Комментарий к сроку годности. Поле предназначено для описаний условий хранения. |
Не длиннее 250 знаков и без спецсимволов. Пример: Хранить в сухом помещении. |
Нет |
|
|
Срок службы. В течение срока службы товар должен исправно выполнять свою функцию. Обязательно указывайте срок, если он есть. |
Срок можно указывать в годах, месяцах и днях. Продолжительность указывается согласно ISO 8601, то есть в виде строчки, начинающейся буквой P:
|
Нет |
|
|
Комментарий к сроку службы. Поле предназначено для описаний условий использования. |
Не длиннее 250 знаков и без спецсимволов. Пример: Использовать при температуре не ниже -10 градусов. |
Нет |
|
|
Гарантийный срок. В течение какого времени можно бесплатно заменить или починить товар. |
Срок можно указывать в годах, месяцах или днях. Продолжительность указывается согласно ISO 8601, то есть в виде строчки, начинающейся буквой P:
|
Нет |
|
|
Комментарий к гарантийному сроку. Поле предназначено для описания особенностей гарантийных условий. Указывайте только то, что относится к гарантии изготовителя. |
Не длиннее 250 знаков и без спецсимволов. Пример: Гарантия на аккумулятор — 6 месяцев |
Нет |
|
|
Номер документа. Номер документа на товар: сертификата, декларации соответствия и т. п. |
Пример: 6241421. |
Нет |
|
|
Код ТН ВЭД. Обязательно укажите, если он есть. |
10 или 14 цифр без пробелов. Пример: 8517610008 |
Нет |
|
|
Признак товара бывшего в употреблении (б/у). |
Обязательно указывайте атрибут
|
Нет |
condition
Элементы внутри
|
Элемент внутри |
Возможные значения:
|
Да |
|
|
Элемент внутри |
|
Да |
Пример файла
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2020-11-22T14:37:38+03:00">
<shop>
<name>BestSeller</name>
<company>Tne Best inc.</company>
<url>http://best.seller.ru</url>
<platform>uCoz</platform>
<categories>
<category id="1">Бытовая техника</category>
<category id="10" parentId="1">Мелкая техника для кухни</category>
<category id="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
</categories>
<delivery-options>
<option cost="200" days="1"/>
</delivery-options>
<offers>
<offer id="9012">
<name>Мороженица Brand 3811</name>
<vendor>Brand</vendor>
<vendorCode>A1234567B</vendorCode>
<url>http://best.seller.ru/product_page.asp?pid=12345</url>
<price>8990</price>
<oldprice>9990</oldprice>
<enable_auto_discounts>true</enable_auto_discounts>
<currencyId>RUR</currencyId>
<categoryId>101</categoryId>
<picture>http://best.seller.ru/img/model_12345.jpg</picture>
<description>
<![CDATA[
<p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей</p>
<p>С его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
]]>
</description>
<sales_notes>Необходима предоплата.</sales_notes>
<manufacturer_warranty>true</manufacturer_warranty>
<barcode>4601546021298</barcode>
<param name="Цвет">белый</param>
<weight>3.6</weight>
<dimensions>20.1/20.551/22.5</dimensions>
<condition type="preowned">
<quality>excellent</quality>
<reason>
Повреждена заводская упаковка, незначительные следы эксплуатации (грязные следы на задней крышке). Есть гарантия производителя.
</reason>
</condition>
</offer>
</offers>
</shop>
</yml_catalog>
Можно использовать только: . , ; ( ) - ? ! ' " « » ﹠ % / °
Описание элемента
Полное название товара. Рекомендуем ознакомиться с разделом подробным описанием элемента.
Примечание
Составляйте название по схеме: тип + бренд или производитель + модель + особенности, если есть (например, цвет, размер или вес) и количество в упаковке.
Не включайте в название условия продажи (например, «скидка», «бесплатная доставка» и т. д.), эмоциональные характеристики («хит», «супер» и т. д.). Не пишите слова большими буквами — кроме устоявшихся названий брендов и моделей.
Оптимальная длина — 50‑60 символов, максимальная — 150.
Составлять хорошие названия помогут рекомендации.
Пример: Ударная дрель Makita HP1630, 710 Вт
Обязателен
Да
На что влияет
Используется для формирования объединенной карточки товара.
Описание элемента
Адрес страницы на вашем сайте с фотографиями и описанием товара.
Примечание
Максимальная длина URL — 512 символов. Записывайте его согласно стандарту RFC 3986.
Пример: http://best.seller.ru/product_page.asp?pid=12346
Обязателен
Да
На что влияет
Описание элемента
Количество дней, требуемых на доставку.
Может содержать до 5 элементов option
, каждый из которых описывает один из способов курьерской доставки (например, обычная, ускоренная и т. п).
Примечание
Указывает на условия, специфичные для товара. Условия доставки, которые действуют для магазина в целом, указывайте внутри элемента shop
. Подробное описание элемента.
Обязателен
Нет
На что влияет
Описание элемента
Название производителя.
Примечание
Указывайте название так, как его пишет сам бренд.
Обязателен
Нет
На что влияет
Используется для формирования объединенной карточки товара.
Описание элемента
Артикул производителя. Код товара, который ему присвоил производитель.
Примечание
Если артикулов несколько, укажите их через запятую.
Пример: VNDR-0005A
, VNDR-0005B
Обязателен
Нет
На что влияет
Используется для формирования объединенной карточки товара.
Описание элемента
Цена одной единицы товара, включая все налоги.
Примечание
Основная часть данных обновляется в поиске по товарам раз в 4 часа. Чтобы быстро обновить цену, используйте API поиска по товарам.
Обязателен
Да
На что влияет
—
Описание элемента
Цена до скидки. Если товар продается со скидкой, укажите в этом поле цену без учета скидки.
Примечание
Цена указывается в рублях. Число должно быть целым.
Можно указать цену со скидкой от 5 до 75%.
oldprice
должна быть выше price
.
Обязателен
Нет
На что влияет
—
Описание элемента
Валюта, в которой указана цена товара.
Примечание
Поддерживаются российские рубли (RUR).
Обязателен
Да
На что влияет
Описание элемента
Категория в магазине. Элемент categoryId
содержит номер категории, а не ее название. Список категорий с номерами разместите в элементе categories.
Примечание
Старайтесь указать категорию более конкретно. Например, тушь для ресниц лучше отнести к категории Декоративная косметика, а не просто Косметика.
Обязателен
Да
На что влияет
Описание элемента
Изображение товара.
Примечание
Принимаются изображения в формате JPEG или PNG.
Вес до 10 МБ, размер не меньше 300 × 300 пикселей.
Укажите ссылку на изображение или несколько изображений. Первое фото становится основным.
Обязателен
Да
На что влияет
Используется для формирования объединенной карточки товара.
Описание элемента
Описание товара.
Примечание
Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок», «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте контактную информацию и не размещайте ссылки.
Можно использовать теги br
и p
для переноса строки.
Оптимальная длина — 400‑600 символов, максимальная — 3000.
Пример: В комплекте с детским микроскопом есть все, что нужно вашему ребенку для изучения микромира.
Обязателен
Да
На что влияет
Используется для формирования объединенной карточки товара.
Описание элемента
Условия продажи, доставки. Рассказывает о дополнительных услугах (в свободной форме).
Примечание
Условия для конкретного товара.
Параметры доставки и самовывоза есть не только у товара, но и у магазина. Если для товара условия не заданы, действуют настройки, заданные для магазина.
Обязателен
Нет
На что влияет
Описание элемента
Штрихкод товара от производителя. Если товар продается упаковками — нужен штрихкод упаковки.
Примечание
Указывайте в виде последовательности цифр. Подойдут коды EAN-13
, EAN-8
, UPC-A
, UPC-E
.
Для товаров определенных категорий и торговых марок обязательно передавайте код GTIN. Внутренние коды, которые начинаются на 2 или 02, не подходят.
Для книг указывайте ISBN.
Если штрихкодов несколько, напишите все через запятую.
Пример: 46012300000000
Обязателен
Нет
На что влияет
Используется для формирования объединенной карточки товара.
Описание элемента
Характеристики товара.
Примечание
Каждый имеет обязательный атрибут name
для названия характеристики и необязательный units
для единиц измерения.
<offer>
...
<param name="Размер экрана" unit="дюйм">27</param>
<param name="Материал">алюминий</param>
<param name="Wi-Fi">есть</param>
</offer>
Обязателен
Нет
На что влияет
Описание элемента
Вес товара с упаковкой.
Примечание
Указывайте в килограммах. Можно использовать дроби: разделитель — точка или запятая, не больше трех цифр после него.
Пример: 3.1
Обязателен
Нет
На что влияет
Описание элемента Длина, ширина, высота в упаковке.
Примечание
Указывайте в сантиметрах. Можно использовать дроби: разделитель — точка или запятая, не больше трех цифр после него.
Пишите числа через / без пробелов.
Пример: 20.1/20.551/22.5
Обязателен
Нет
На что влияет
Описание элемента
Признак товара бывшего в употреблении (б/у).
Примечание
Обязательно указывайте атрибут type
:
-
preowned
— бывший в употреблении, раньше принадлежал другому человеку. -
showcasesample
— витринный образец. -
reduction
— уцененный товар.
<condition type="preowned">
<quality>excellent</quality>
</condition>
Обязателен
Нет
На что влияет
Описание элемента
Элемент внутри condition
. Состояние, внешний вид товара.
Примечание
Возможные значения:
-
perfect
— как новый, товар в идеальном состоянии. -
excellent
— отличный, следы использования или дефекты едва заметные. -
good
— хороший, есть заметные следы использования или дефекты.
Обязателен
Да
На что влияет
Описание элемента
Элемент внутри condition
. Короткое описание следов использования или дефектов товара.
Примечание
<condition type="preowned">
<quality>excellent</quality>
<reason>Повреждена заводская упаковка, незначительные следы эксплуатации (грязные следы на задней крышке). Есть гарантия производителя.</reason>
</condition>
Обязателен
Да
На что влияет