Товарные фиды

Можно не читать, а смотреть

Открыть на YouTube

Товарный фид — это файл в формате XML, который содержит ссылки и краткие описания для товаров определенной категории. Данные обновляются каждые 6-7 часов.

Разместите на вашей площадке информацию о товарах Яндекс Маркета и получайте вознаграждение за заказы, которые сделают покупатели после перехода по вашим ссылкам.

Фиды включают все товары Маркета с доставкой в Москву. Сформировать фид с частью товаров, товарами некоторых категорий или с доставкой в другой город нельзя.

Если вы знаете, как улучшить фид, напишите нам через форму обратной связи.

  1. Структура фида
  2. Как получить фид
  3. Как подготовить фид
  4. Дополнительный идентификатор VID

Структура фида

XML-файл имеет следующую структуру.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="YYYY-MM-DD hh:mm">
 <shop>
  <name>Yandex Market</name>
  <company>Yandex</company>
  <url>https://market.yandex.ru/</url>
  <currencies>
   <currency id="RUB" rate="1"/>
  </currencies>
  <categories>
   <category id="90401">Все товары</category>
   <category id="198118" parentId="90401">Бытовая техника</category>
   <category id="198119" parentId="90401">Электроника</category>
   ...
  </categories>
  <offers>
   <offer id="..." available="true">
    <name>...</name>
    <price>...</price>
    <currencyId>RUB</currencyId>
    <categoryId>...</categoryId>
    <picture>...</picture>
    <url>...</url>
    <group_id>...</group_id>
    <vendor>...</vendor>
    <oldprice>...</oldprice>
    <description>...</description>
    <barcode>...</barcode>
    ...
    <barcode>...</barcode>
    <param name="...">...</param>
    ...
    <param name="...">...</param>
   </offer>
   ...
  </offers>
 </shop>
</yml_catalog>
Примечание. В поле categories указаны все категории товаров Маркета, несмотря на то, что для каждой из них (например: детские товары, электроника, товары для дома) существует свой фид.

В XML-файл выгружаются отдельные варианты товаров — sku. Если у одного товара есть несколько вариантов (например, разного цвета, размера, объема памяти), то каждый из них выгружается в виде товарного предложения — offer. Такие предложения объединены идентификатором group_id. По его значению вы можете найти и объединить в карточке все варианты товара.

Пример товарного предложения приведен ниже.

   <offer id="6508987" available="true">
    <name>Часы наручные CASIO MTP-1308L-1A</name>
    <categoryId>91259</categoryId>
    <picture>https://avatars.mds.yandex.net/get-mpic/200316/img_id4632133598649289442/9</picture>
    <price>3120</price>
    <currencyId>RUB</currencyId>
    <url>https://market.yandex.ru/product--chasy-naruchnye-casio-mtp-1308l-1a/6508987?distr_type=7&amp;mclid=1002&amp;pp=940&amp;sku=6508987</url>
    <group_id>6508987</group_id>
    <vendor>CASIO</vendor>
    <oldprice>3980</oldprice>
    <description>Стильные часы Casio произведены из нержавеющей стали и минерального стекла, устойчивого к царапинам.&lt;br /&gt;Корпус часов выполнен из нержавеющей стали. Часы имеют степень влагозащиты Water Resist 50 m ( 5 bar) и выдерживают плавание (без ныряния). Ремешок часов выполнен из натуральной кожи&lt;br /&gt;Наручные часы CASIO&lt;br /&gt;Оригинальные часы CASIO</description>
    <barcode>2008252547371</barcode>
    <barcode>4971850070481</barcode>
    <param name="Цвет">черный</param>
    <param name="Пол">male</param>
    <param name="Материал">кожа</param>
   </offer>

Элементы для описания товарного предложения указаны в таблице.

Поле Описание
id

Идентификатор предложения.
available

Наличие товара.

Всегда принимает значение true.
name

Название товара.
price

Цена товара.
currencyId

Валюта.

Всегда принимает значение RUB.
categoryId

Идентификатор категории.

Примечание. Все идентификаторы категорий указаны в XML-файле в поле categories.
picture

Ссылка на изображение.
url

Cсылка на товар.

Внимание. Cсылки в исходном фиде не содержат параметра clid. Чтобы получить вознаграждение, вам необходимо добавить этот параметр самостоятельно.
group_id

Идентификатор модели товара.
vendor

Наименование производителя.
oldprice

Старая цена товара.
description

Описание товара.
barcode

Международный номер для идентификации товара. Доступные параметры:

  • EAN — штрихкод.
  • ISBN — уникальный номер книжного издания.

У одного товара может быть несколько штрихкодов. Для книжного издания — несколько EAN и один ISBN.
param

Характеристика товара. Доступные параметры:

  • Возраст
  • Материал
  • Пол
  • Размер
  • Цвет
Поле Описание
id

Идентификатор предложения.
available

Наличие товара.

Всегда принимает значение true.
name

Название товара.
price

Цена товара.
currencyId

Валюта.

Всегда принимает значение RUB.
categoryId

Идентификатор категории.

Примечание. Все идентификаторы категорий указаны в XML-файле в поле categories.
picture

Ссылка на изображение.
url

Cсылка на товар.

Внимание. Cсылки в исходном фиде не содержат параметра clid. Чтобы получить вознаграждение, вам необходимо добавить этот параметр самостоятельно.
group_id

Идентификатор модели товара.
vendor

Наименование производителя.
oldprice

Старая цена товара.
description

Описание товара.
barcode

Международный номер для идентификации товара. Доступные параметры:

  • EAN — штрихкод.
  • ISBN — уникальный номер книжного издания.

У одного товара может быть несколько штрихкодов. Для книжного издания — несколько EAN и один ISBN.
param

Характеристика товара. Доступные параметры:

  • Возраст
  • Материал
  • Пол
  • Размер
  • Цвет

Как получить фид

  1. Убедитесь, что вы партнер Яндекс Маркета.
  2. Запросите фид через форму обратной связи:
  3. Подготовьте фид к размещению на своей площадке.
    Внимание. Cсылки в исходном фиде не содержат параметра clid. Чтобы получить вознаграждение, вам необходимо добавить этот параметр самостоятельно.

Как подготовить фид

  1. Откройте XML-файл.
  2. Проверьте, что в ссылках из тега url после знака вопроса указаны параметры. Их удалять не нужно.
  3. Добавьте после них знак амперсанда &, а затем параметр clid=1234567, где 1234567 — ваш персональный clid.

    Скопировать clid можно в интерфейсе Яндекс Дистрибуции, в разделе Продукты → Яндекс Маркет (маркетплейс) → Товарный фид или узнать у вашего менеджера.

    Допустим, вы скопировали ссылку:

    https://market.yandex.ru/product--elektricheskii-chainik-scarlett-sc-ek18p49-belyi-seryi/1463592381?distr_type=7&mclid=1002&pp=940&sku=101381751994

    Когда вы добавите параметр clid, ссылка станет партнерской и будет выглядеть так:

    https://market.yandex.ru/product--elektricheskii-chainik-scarlett-sc-ek18p49-belyi-seryi/1463592381?distr_type=7&mclid=1002&pp=940&sku=101381751994&clid=2337934

    Узнать больше о параметрах и составе ссылки можно в гиде по Яндекс Метрике.

Дополнительный идентификатор VID

Если нужно, добавьте дополнительный идентификатор для ссылки в параметре vid. Он позволяет:

  • смотреть статистику отдельно по этой ссылке;

  • сравнивать статистику по одинаковым ссылкам на разных страницах.

Идентификатор VID может содержать строку из латинских букв и цифр длиной до 150 символов.

Допишите идентификатор в конце ссылки. Для этого поставьте знак амперсанда & и после него добавьте vid.

Пример партнерской ссылки:

https://market.yandex.ru/product--umnaia-kolonka-yandex-stantsiia-mini-chernaia/521440226?distr_type=7&mclid=1002&pp=940&sku=100783340857&clid=2405959&vid=marketDeal