Сформировать товарный фид
Товарный фид — это файл формата YML с информацией о магазине и товарах. YML (Yandex Market Language) — это собственный стандарт Яндекса, основанный на XML. В товарном фиде можно описать каталог магазина в формате, удобном для автоматической генерации.
Пример фида
<?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>
<pickup-options>
<option cost="200" days="1"/>
</pickup-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>
</condition>
</offer>
</offers>
</shop>
</yml_catalog>
1. Формирование фида
Сформировать фид можно несколькими способами:
Через CMS
Для популярных CMS доступны модули подключения. Они разработаны для интеграции с Яндекс Маркетом и подходят для подготовки фида для Яндекс Товаров.
Используйте модули и компоненты только для формирования фида и генерации URL, по которому он доступен для скачивания. URL-адрес нужен для загрузки фида в Яндекс Товары.
Примечание
Все модули, кроме модуля для 1C‑Битрикс, разработаны сторонними компаниями или специалистами. Яндекс не несет ответственности за качество их работы.
Указанные названия и логотипы CMS используются в соответствии с политикой правообладателей в отношении этих торговых марок. Их использование не означает, что правообладатели имеют какое-либо отношение к перечисленным модулям, одобряют их или иным образом связаны с Яндексом.
Система |
Версия системы |
Модуль / компонент системы |
Дополнительная информация |
— |
Компонент системы |
||
3.0.0.0 – 3.0.3.7 ocStore 3.0.2.0 OcStore 3.0.3.7 |
Платно Автор: Opencart |
||
Любая |
Компонент системы |
||
3.6.5, 3.7, 3.8, 3.9 |
Компонент Yandex Market XML для HikaShop, JoomShopping, VirtueMart |
Автор: JoomLine |
|
4.4.2 – 5.2.2 |
Бесплатно |
Другие CMS
Система |
Версия системы |
Модуль / компонент системы |
Дополнительная информация |
10.0 |
Компонент системы |
||
Любая |
Компонент системы |
||
Любая |
Компонент системы |
||
Любая |
Компонент системы |
||
Любая |
Компонент системы |
Платно |
|
Любая |
Компонент системы |
||
Любая |
Компонент системы |
||
1.7.0.2 – 1.9.4.0 2.3 – 2.4.x |
Модуль выгрузки товаров на Яндекс Маркет (для 1.7.0.2 – 1.9.4.0) М2:Модуль выгрузки товаров на Яндекс Маркет (для 2.3 – 2.4.x) |
Платно Автор: Rugento |
|
Любая |
Компонент системы |
||
Любая |
Бесплатно |
||
Любая |
Бесплатно |
||
1.7.0 – 1.7.8.7 |
Платно Автор: SeoSA |
||
3.x |
Компонент системы |
||
7.1.1.60 + |
Бесплатно Автор: Webasyst |
||
Любая |
Компонент системы |
||
2.9.5+ |
Бесплатно |
Вручную
Если у вас небольшой магазин, фид можно создать вручную по описанию формата.
2. Настройка автообновления фида
Большинство ошибок качества происходят из-за неактуальной информации в фиде. Необходимо, чтобы информация на сайте и в Поиске была одинаковой и не вводила пользователей в заблуждение.
Настройте автообновление фида или обновляйте его вручную, чтобы избежать ошибок в фиде в будущем. Во многих CMS, например в Битрикс24, это можно сделать при его создании и редактировании. В настройках задайте необходимую частоту обновлений.
Как настроить автообновление фида в Битрикс24
Примечание
Если информация в фиде и на сайте разная, предложения могут быть заблокированы. Если таких предложений большинство, может быть заблокирован весь фид.
Требования к фиду
Примечание
Если вы пользуетесь популярной CMS, посмотрите список модулей, которые помогут сформировать товарный фид.
-
Не используйте непечатаемые символы с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
-
Замените символы
" & > < '
на эквивалентные коды:Символ в тексте
Код для фида
" & > < '
" & > < '
-
Используйте кодировку UTF-8 или windows-1251.
Ограничения
Размер фида |
2 ГБ |
Количество всех фидов (товарные фиды, фиды услуг и предложений, RSS для контентных Турбо‑страниц) суммарно для сайта и его поддоменов |
1000 |
Примечание
Вы можете использовать символы " & > < '
и HTML-теги H1-H6, p, br в блоке CDATA в элементе description.
Структура фида
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05T17:22">
<shop>
...
<offers>
...
</offers>
</shop>
</yml_catalog>
Элемент |
Описание |
Примечание |
|
Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа. |
— |
|
Корневой элемент. В атрибуте Дату и время нужно указать согласно стандарту RFC 3339. Обязательно укажите атрибут |
Обязательно указывайте часовой пояс. Он отсчитывается от UTC. Дату и время в будущем указывать нельзя. Если файл долго генерируется, указывайте в атрибуте момент начала генерации. Почему? |
|
Элемент содержит: |
Если указывать время завершения генерации, можно потерять изменения, внесенные вручную. Допустим, магазин начал генерировать файл в 12:00. В 12:05 вы через API изменили цену товара. В 12:10 магазин сформировал файл, и его скачал индексирующий робот. Если в файле будет стоять время 12:10, мы заменим внесенную вами цену на неактуальную из файла. Если же в нем будет стоять 12:00, ваше изменение будет считаться более поздним и никуда не денется.