Тег <param> в YML: как правильно описывать характеристики товаров

При работе с YML-фидами (например, для Яндекс.Маркета или Директа) тег <param> является основным инструментом для передачи характеристик товара. Через него передаются такие параметры, как цвет, размер, мощность, материал и другие свойства. Рассмотрим, как он устроен и как его правильно использовать.

Что такое <param> и зачем он нужен

Тег <param> используется для описания характеристик товара внутри <offer>. Фактически это аналог блока «Характеристики» в карточке товара. Примеры параметров:

• цвет
• размер
• вес
• материал
• мощность
• напряжение Каждая характеристика передаётся отдельным тегом <param>.

Базовая структура тега

Минимальный вариант выглядит так:

<param name="Цвет">Черный</param>

Структура:

• param — тег характеристики;
• name — название параметра (обязательный атрибут);
• содержимое тега — значение параметра.

Использование единиц измерения (unit)

Если параметр числовой, рекомендуется указывать единицу измерения:

<param name="Вес" unit="кг">2.5</param>
<param name="Длина" unit="мм">450</param>

Это позволяет:

• корректно обрабатывать данные на стороне маркетплейсов;
• использовать параметры в фильтрах и сравнении товаров.

Пример внутри <offer>

Пример использования в реальном YML:

<offer id="12345">
    <name>Дрель ударная Bosch</name>
    <price>5990</price>
    <currencyId>RUR</currencyId>
    <categoryId>12</categoryId>
    <param name="Мощность" unit="Вт">700</param>
    <param name="Тип патрона">Быстрозажимной</param>
    <param name="Вес" unit="кг">1.8</param>
    <param name="Цвет">Зеленый</param>
</offer>

Важные правила использования

1. Один параметр — один тег

Не рекомендуется объединять несколько характеристик в один тег. ❌ Неправильно:

<param name="Характеристики">Вес 2 кг, цвет черный</param>

✅ Правильно:

<param name="Вес" unit="кг">2</param>
<param name="Цвет">Черный</param>

2. Единообразие названий

Названия параметров должны быть консистентными. ❌ Неправильно:

<param name="Вес">2</param>
<param name="вес">2</param>
<param name="Масса">2</param>

✅ Правильно:

<param name="Вес" unit="кг">2</param>

3. Разделение значения и единицы измерения

Единицы измерения не следует включать в значение. ❌ Неправильно:

<param name="Вес">2 кг</param>

✅ Правильно:

<param name="Вес" unit="кг">2</param>

4. Избегание неточных формулировок

Следует избегать неопределённых значений. ❌ Неправильно:

<param name="Вес">примерно 2 кг</param>

✅ Правильно:

<param name="Вес" unit="кг">2</param>

5. Приоритет фильтруемых параметров

Особое внимание следует уделять параметрам, которые используются в фильтрах:

• цвет;
• размер;
• пол;
• материал.

Когда использовать <param>, а когда нет

Тег <param> следует использовать, если:

• параметр является характеристикой товара;
• его можно выделить в отдельное поле;
• он используется для фильтрации или сравнения. Не следует использовать <param>, если:
• это описание товара (используется <description>);
• это название товара (используется <name>);
• это бренд (используется <vendor>).

Итог

Тег <param> — важный элемент структуры YML-фида. Ключевое правило: 👉 одна характеристика — один тег <param> Рекомендуемый шаблон:

<param name="Название" unit="ЕдИзм">Значение</param>

Корректное использование <param> обеспечивает:

• валидность фида;
• корректную индексацию товаров;
• работу фильтров и поиска на стороне маркетплейсов.