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

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

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

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

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

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

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

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

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

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

  1. Убедитесь, что у вас заключен договор с партнерской сетью Яндекс Маркета.

  2. Запросите фид через форму обратной связи — выберите тему Получить товарные фиды.

  3. Подготовьте фид к размещению на своей площадке.

    Важно

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

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

  1. Откройте XML-файл.

  2. Проверьте, что в ссылках из тега url после знака вопроса указаны параметры. Их удалять не нужно.

  3. Добавьте после них знак амперсанда &, а затем параметр clid=1234567, где 1234567 — ваш персональный clid.

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

  4. Добавьте после clid знак амперсанда &, а затем параметр erid=xxxx, где xxxx — идентификатор ERID, полученный в ОРД Яндекса или другом ОРД. Как получить ERID в ОРД Яндекса

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

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

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

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

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

Если нужно, добавьте дополнительный идентификатор для ссылки в параметре 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


Полезные ссылки