Appearance
Структура оффера
Атрибуты тега offer
| Атрибут | Обязательность | Описание |
|---|---|---|
id | обязательно | Идентификатор товара. |
group_id | не обязательно | Идентификатор группы товаров. Необходим для объединения вариантов товаров в одну группу. В ответе блоков рекомендаций и поиска будет возвращен только один из вариантов. |
available | обязательно | Флаг наличия товара. Доступные значения: true, false. |
ignored | не обязательно | Флаг учета товара. Если передан false, товар не будет выводиться в результатах работы инструментов. Доступные значения: true, false. |
leftovers | не обязательно | Остаток товара. Может принимать одно из значений: one (товар доступен в единственном экземпляре), few (товар в ограниченном количестве (до 10 ед.)), lot (доступно от 10 и более единиц товара). |
Лайфхак
На самом деле нет смысла передавать в товарном фиде товары не в наличии. Платформа автоматически сделает не в наличии все товары, которые отсутствуют в фиде. Поэтому для ускорения обработки фида и уменьшения его размера, просто не добавляйте в него товары, которые не в наличии.
Пример тега с атрибутами:
xml
<offer id="R654FJH" group_id="ART41" available="true" ignored="false" leftovers="few">
...
</offer>Дочерние элементы offer
| Элемент | Обязательность | Описание |
|---|---|---|
name | обязательно | Полное название товара. Для раздельного написания названия см. элементы: typePrefix, vendor, model. |
picture | обязательно | Ссылка на изображение товара. |
price | обязательно | Базовая цена товара. |
price_with_promocode | обязательно | Базовая цена товара с учетом использования промокода. |
url | обязательно | Ссылка на страницу товара. |
categoryId | обязательно | Категория товара. Этих элементов может быть несколько. |
deeplink_android | не обязательно | Ссылка на страницу товара в приложении (Android). |
deeplink_ios | не обязательно | Ссылка на страницу товара в приложении (iOS). |
locations | не обязательно | Элемент, описывающий свойства товара в разных локациях: наличие, цена. См. таблицу и пример ниже. |
accessories | не обязательно | Элемент, описывающий список аксессуаров текущего товара. См. пример ниже. |
oldprice | не обязательно | Старая цена товара. |
discount_percent | не обязательно | Процент скидки. При отсутствии в импорте данного параметра и наличии oldprice, он будет автоматически рассчитан по формуле: целая часть от ((oldprice - price) / oldprice) * 100 (получается путём округления вниз до целого) |
price_margin | не обязательно | Относительная маржинальность (приоритет) товара (от 0 до 100). |
barcode | не обязательно | Штрих-код товара. |
typePrefix | не обязательно | Тип/категория товара (например, "мобильный телефон", "стиральная машина", "угловой диван"). |
vendor | не обязательно | Производитель/бренд. |
vendorCode | не обязательно | Код производителя для данного товара. |
model | не обязательно | Модель и название товара. |
seasonality | не обязательно | Сезонность товара. В качестве значения используется порядковый номер месяца ( от 1 до 12). Этих элементов может быть несколько. |
is_new | не обязательно | Может принимать только одно значение - "1", означающее, что товар является новинкой. |
rating | не обязательно | Рейтинг товара. Целочисленное значение от 1 до 5. |
description | не обязательно | Описание товара. |
stock_quantity | не обязательно | Количество товара. Целочисленное значение от 1 и более. |
tags | не обязательно | Элемент, описывающий связанные с товаром теги, для точного поиска. См. таблицу и пример ниже. |
merchant | не обязательно | ID продавца. (Актуально для маркетплейсов) |
param | не обязательно | Параметр. |
date | не обязательно | Дата добавления или обновления. |
gift | не обязательно | Информация о подарке. |
installment | не обязательно | Информация о рассрочке. |
promocode | не обязательно | Промокод. |
bonuses_accrual_allowed | не обязательно | Управление возможностью начисления бонусов за товар. Значения: true или false |
bonuses_spending_allowed | не обязательно | Управление возможностью списания бонусов за товар. Значения: true или false |
discounts_allowed | не обязательно | Управление возможностью применения скидок к товару. Значения: true или false |
Примите во внимание
При обработке url к ссылке добавляются параметры вида recommended_by, recommended_code и т.д. Они необходимы для работы трекинга событий и построения аналитики.
Если вам нужно передать в ссылке собственные параметры, их требуется закодировать. В противном случае некоторые символы будут некорректно обработаны, например, согласно спецификации RFC3986 знак + распознается как пробел. Если вам нужно, чтобы при переходе по ссылке в параметре передавался знак +, то его нужно экранировать в %2B.
Пример:
http://test.com?test=+-!ABC -> http://test.com?test=%2B-%21ABC
Сезонность seasonality
Если у товара указана сезонность, и она совпадает с текущим месяцем, он получает буст 1.2.
Если сезонность — следующий месяц, буст будет 1.1.
Если указаны оба месяца (текущий и следующий), коэффициенты умножаются. Например: сезонность — июнь и июль, сейчас июнь → буст: 1.2 × 1.1 = 1.32.
Если сезонность не указана — считается универсальным товаром, буст тоже 1.2.
Во всех других случаях — буст 1.0.
Элемент yml_catalog > shop > offers > offer > locations
Элемент locations содержит список локаций, а также доступность и цену текущего товара в локациях. Каждая локация описывается отдельным элементом location.
Атрибуты элемента location:
| Атрибут | Обязательность | Описание |
|---|---|---|
id | обязательно | Идентификатор, соответствующий локации (идентификатору) из элемента locations элемента shop. Подробнее об описании локации см. в соответствующем подразделе этого документа и в примере ниже. |
weight | не обязательно | Приоритет товара в локации (от 0 до 100). |
Обратите внимание
Товар будет считаться доступным к приобретению только в перечисленных в элементе offer локациях. Во всех остальных известных, но не перечисленных локациях, товар будет считаться не в наличии. Если же у offer отсутствует элемент locations, то товар считается в наличии во всех локациях магазина.
Дочерние элементы:
| Элемент | Обязательность | Описание |
|---|---|---|
price | не обязательно | Цена товара в локации. Если элемент отсутствует, то используется базовая цена товара. |
oldprice | не обязательно | Старая цена товара в локации. Если элемент отсутствует, то используется базовая старая цена товара (при наличии). |
stock_quantity | не обязательно | Количество товара. Целочисленное значение от 1 и более. |
Элемент yml_catalog > shop > offers > offer > tags
Элемент tags содержит список тегов, соотносящихся с товаром. Каждое значение описывается отдельным элементом tag.
| Элемент | Обязательность | Описание |
|---|---|---|
tag | обязательно | Значение тега. |
Расширения
Для обогащения пользовательских профилей и усиления эффекта персонализации рекомендуется добавлять нишевые параметры товаров в секцию offer.