Товарные фиды
Можно не читать, а смотреть
Товарный фид — это файл в формате 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&mclid=1002&pp=940&sku=6508987</url>
<group_id>6508987</group_id>
<vendor>CASIO</vendor>
<oldprice>3980</oldprice>
<description>Стильные часы Casio произведены из нержавеющей стали и минерального стекла, устойчивого к царапинам.<br />Корпус часов выполнен из нержавеющей стали. Часы имеют степень влагозащиты Water Resist 50 m ( 5 bar) и выдерживают плавание (без ныряния). Ремешок часов выполнен из натуральной кожи<br />Наручные часы CASIO<br />Оригинальные часы CASIO</description>
<barcode>2008252547371</barcode>
<barcode>4971850070481</barcode>
<param name="Цвет">черный</param>
<param name="Пол">male</param>
<param name="Материал">кожа</param>
</offer>
Элементы для описания товарного предложения указаны в таблице.
Поле |
Описание |
|
Идентификатор предложения. |
|
Наличие товара. |
|
Название товара. |
|
Цена товара. |
|
Валюта. Всегда принимает значение |
|
Идентификатор категории. Примечание Все идентификаторы категорий указаны в XML-файле в поле |
|
Ссылка на изображение. |
|
Cсылка на товар. Важно Cсылки в исходном фиде не содержат параметра |
|
Идентификатор модели товара. |
|
Наименование производителя. |
|
Старая цена товара. |
|
Описание товара. |
|
Международный номер для идентификации товара. Доступные параметры:
У одного товара может быть несколько штрихкодов. Для книжного издания — несколько EAN и один ISBN. |
|
Характеристика товара. Доступные параметры:
|
Как получить фид
-
Убедитесь, что у вас заключен договор с партнерской сетью Яндекс Маркета.
-
Запросите фид через форму обратной связи — выберите тему Получить товарные фиды.
-
Подготовьте фид к размещению на своей площадке.
Важно
Cсылки в исходном фиде не содержат параметра
clid
. Чтобы получить вознаграждение, вам необходимо добавить этот параметр самостоятельно.
Как подготовить фид
-
Откройте XML-файл.
-
Проверьте, что в ссылках из тега
url
после знака вопроса указаны параметры. Их удалять не нужно. -
Добавьте после них знак амперсанда
&
, а затем параметрclid=1234567
, где1234567
— ваш персональныйclid
.Скопировать
clid
можно в интерфейсе Яндекс Дистрибуции, в разделе Продукты → Яндекс Маркет (маркетплейс) → Товарный фид или узнать у вашего менеджера. -
Добавьте после
clid
знак амперсанда&
, а затем параметрerid=xxxx
, гдеxxxx
— идентификатор ERID, полученный в ОРД Яндекса или другом ОРД. Как получить ERID в ОРД Яндекса
Допустим, вы скопировали ссылку:
Когда вы добавите параметры clid
и erid
, ссылка будет выглядеть так:
Узнать больше о параметрах и составе ссылки можно в гиде по Яндекс Метрике.
Дополнительный идентификатор VID
Если нужно, добавьте дополнительный идентификатор для ссылки в параметре vid
. Он позволяет:
- смотреть статистику отдельно по этой ссылке;
- сравнивать статистику по одинаковым ссылкам на разных страницах.
Идентификатор VID может содержать строку длиной до 150 символов только из латинских букв и цифр.
Допишите идентификатор в конце ссылки. Для этого поставьте знак амперсанда &
и после него добавьте vid
.
Пример партнерской ссылки: