Требования к YML файлу (фиду)

YML-файл (Yandex Market Language, «Язык Яндекс.Маркета») — это документ с данными о товарах, которые планируется размещать на Яндекс Маркете. Он создаётся с помощью собственного языка разметки Яндекса на базе стандарта XML.

Большинство CMS платформ для создания интернет-магазинов имеют модули для автоматической генерации YML файла (фида), поэтому очень удобно использовать этот формат для быстрой интеграции вашего интернет магазина с нашим сервисом Умного поиска.

Пример YML файла для умного поиска:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2025-01-01T09:31:59+00:00">
    <shop>
        <categories>
            <category 
                id="{идентификатор категории}" 
                url="{ссылка на страницу категории}" 
                image="{ссылка на изображение категории}"
            >
                Название категории
            </category>
            <category 
                id="{уникальный идентификатор категории}" 
                parentdId="{идентификатор родительской категории}" 
                url="{ссылка на страницу категории}" 
                image="{ссылка на изображение категории}"
            >
                Название подкатегории
            </category>
        </categories>
        <brands>
            <brand 
                url="{ссылка на страницу с брендом}" 
                image="{ссылка на изображение бренда}"
            >
            </brand>
        </brands>
        <offers>
            <offer id="{уникальный артикул товара}">
                <url>{ссылка на страницу с товаром}</url>
                <price>{цена товара}</price>
                <categoryId>{идентификатор категории}</categoryId>
                <picture>{ссылка на изображение товара}</picture>
                <vendor>{производитель}</vendor>
                <vendorCode>{артикул товара от производителя}</vendorCode>
                <name>{название товара}</name>
                <description>{описание товара}</description>
            </offer>
        </offers>
    </shop>
</yml_catalog>

Возможности умного поиска могут быть расширены за счет добавления в YML файл дополнительных элементов, которые не предусмотрены стандартом YML от Яндекса.

Дополнительные элементы

1. Для поиска по категориям добавьте атрибуты url и image для элементов <category>. Без указания url категория не будет попадать в результаты поиска, без image будет выводиться в результатах без изображения.
2. Для поиска по брендам добавьте элемент <brands> со списком брендов. Укажите атрибуты url (обязательно) и image (опционально) для каждого элемента <brand>

Артикул товара

Атрибут id элемента offer — это уникальный артикул товара, по которому он однозначно идентифицируется в вашем магазине. В качестве значения можно указать как артикул производителя, так и внутренний артикул магазина. Владелец магазина сам выбирает, какой артикул использовать в зависимости от своей системы учета.

Дочерний элемент vendorCode элемента offer — дополнительный артикул товара от производителя.

Наш умный поиск одинаково хорошо ищет по артикулам товаров, указанных в любом из перечисленных выше элементов.