# Товарный фид: что это и как загрузить фид в партнерскую программу
Товарный фид — это файл, который содержит данные о товарах из каталога вашего сайта. Использование товарных фидов актуально только для партнерских программ из категории «Интернет-магазины».

Веб-мастера используют предоставленные вами товарные фиды для создания сервисов сравнения товаров, партнерских интернет-магазинов, сайтов-витрин, email-рассылок с описанием и изображением товара.

С помощью собственных или готовых парсеров и плагинов они приводят информацию из фидов к нужному им виду и загружают ее на свои площадки, формируя собственные товарные каталоги.

:::tip
В системе Admitad Partner Network фиды обновляются каждые 6 часов.
:::

# В чем польза товарных фидов  <span id="feed-profit" />

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

*   позволяют вовремя актуализировать информацию по товарам из вашего каталога — цену, наличие, характеристики и пр. — на площадке веб-мастера;
*   упрощают работу веб-мастерам и тем самым делают вашу программу более привлекательной для сотрудничества.

## Порядок создания и загрузки товарных фидов <span id="feed-creation" />

Чтобы загрузить фид в программу, вам необходимо:

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

Загрузкой и настройкой фида занимается специалист Admitad.

:::tip
При необходимости вы можете добавить в программу несколько фидов: на разных языках, с разными категориями товаров, для разных ценовых категорий или в разных форматах (YML, CSV и пр.). В этом случае для каждого фида нужно создать отдельный файл.
:::

Ссылка на фид будет указана в поле «Товарные фиды» в разделе «Общие настройки программы».

![feed](https://static.useresponse.com/public/admitadru/attachments/5de4c48c4eace5ffc13da45cc8d5ddba)

# Подготовка файла товарного фида <span id="feed-preparation" />

При подготовке товарного фида придерживайтесь следующих рекомендаций:

*   **Обязательно указывайте ссылки на страницы с товарами без UTM-меток.**
    После загрузки фида к ссылкам на товары автоматически будут добавлены параметры Admitad. Если ссылки уже содержат метки, то это может привести к возникновению конфликтов и/или нарушить работоспособность партнерских ссылок веб-мастеров.
*   **Загружайте изображения с максимально доступным разрешением.**
    Так ваши товары будут выглядеть наиболее привлекательно на любых устройствах покупателей. Веб-мастера сами изменят размер изображения при необходимости.
    Минимальное разрешение: 250х250 пикселей.
*   **По возможности добавляйте в фид все товары, которые есть в вашем каталоге.**
    Чем полнее ваш фид, тем эффективнее будет реклама.

Admitad поддерживает следующие форматы товарных фидов:

*   YML (Yandex Market Language);
*   Google Merchant;
*   CSV (Comma-Separated Values).

Нажмите на название формата, чтобы развернуть требования к нему.

::::cut{title="YML-фид"}
Чтобы товарный фид в формате YML успешно загружался в Admitad и корректно обрабатывался системой, ваш файл должен соответствовать:

*   [стандартным требованиям к YML‑формату](#standart-yml-requirements);
*   [дополнительным требованиям Admitad](#admitad-yml-requirements).

## Стандартные требования к YML‑формату <span id="standart-yml-requirements" />

Стандартные требования к YML-файлам представлены в Справке Яндекс.Маркета:

*   [Требования и основные элементы YML](https://yandex.ru/support/partnermarket/export/yml.html#yml-format)
*   [Структура YML-файла](https://yandex.ru/support/marketplace/assortment/auto/yml.html)

## Требования Admitad к YML‑формату <span id="admitad-yml-requirements" />

После создания YML-файла нужно проверить и доработать его в соответствии с требованиями Admitad.

*   [Основные требования к файлу](#common-yml-admitad-requirements)
*   [Требования к разметке](#markup-yml-features)
*   [Обязательные элементы](#required-yml-elements)
*   [Дополнительные элементы, которые поддерживает Admitad](#additional-yml-elements)
*   [Пример YML-файла](#yml-example)

### Основные требования к файлу <span id="common-yml-admitad-requirements" />

Проверьте, что ваш YML-файл соответствует требованиям ниже.

*   ID товара соответствует product\_id в информации о заказе.
*   Кодировка файла: либо UTF-8, либо windows-1251.
*   В файле не использутся:
    *   непечатаемые символы с ASCII-кодами от 0 до 31 (*за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки*);
    *   эмодзи и другие специальные символы Юникода.
*   Символы в тексте заменены на эквивалентные коды:

| Символ в тексте | Код для YML-файла |
| --------------- | ----------------- |
| "               | \&quot;           |
| &               | \&amp;            |
| \<              | \&lt;             |
| >               | \&gt;             |
| '               | \&apos;           |

*   В качестве разделителя целой и дробной частей всех числовых значений используется
*   MIME-тип файла должен быть application/xml.
    Фиды с другими MIME-типами (например, text/xml или text/html) не загрузятся в Admitad Partner Network.

### Особенности разметки <span id="markup-yml-features" />

В файле должны быть соблюдены особенности разметки, перечисленные ниже.

*   Можно использовать атрибут **available** в теге \<offer>, чтобы указать наличие товара (в наличии или под заказ).
    **Пример**: \<offer available\="true">;
    или \<offer available\="false">.

*   По возможности распределите товары на категории так, чтобы разбивка соответствовала категоризации товаров на сайте.

*   Каждый товар должен принадлежать только одной категории, т.е. в элементе \<categoryId> должно быть одно значение.
    Если есть вложенные категории для товаров, то для элементов \<categoryId> нужно добавить атрибут **parentId** и указать в нем id категории более высокого уровня. При этом в \<categoryId> нужно указывать номер категории, которая наиболее конкретно описывает товар. В описании товара атрибут parentId указывать не нужно.
    **Пример:**
    \<categories>
    \<category id\="1">Книги\</category>
    \<category id\="2" parentId\="1">Детективы\</category>
    \<category id\="3" parentId\="1">Боевики\</category>

*   Если вы **не используете инструмент ReTag**, то необходимо исключать из выгрузки дубликаты товаров, а также объединять одинаковые товары со схожими характеристиками (например, по цвету и/или размеру), используя \<param name\="Размеры">x, y, z\</param> и \<param name\="Цвет">x, y, z\</param> (см. пример).

*   Если **вы** **используете инструмент ReTag**, то ID каждого товара в фиде должен быть уникальным и соответствовать ID товара на сайте, иначе инструмент будет работать некорректно. При этом в выгрузке допускается наличие дублей.

### Обязательные элементы <span id="required-yml-elements" />

Убедитесь, что YML-файл содержит обязательные для Admitad элементы.

Порядок элементов в файле может быть любым.

| Элемент        | Описание                                                                                                                                                                                               |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| \<url>         | URL-адрес страницы с товаром.                                                                                                                                                                          |
|                | URL-адрес должен содержать только те метки, которые относятся к описанию товара.                                                                                                                       |
| \<price>       | Цена товара.                                                                                                                                                                                           |
| \<picture>     | Адрес страницы с фото товара.                                                                                                                                                                          |
|                | Чтобы разместить несколько фото, добавьте каждое из них с помощью элемента \<picture>, не используя массив \<pictures>.                                                                                |
| \<categoryId>  | Идентификатор категории товара (целое число не более 18 знаков). Товар может принадлежать только одной категории.                                                                                      |
| \<currencyId>  | Идентификатор валюты товара в формате ISO 4217 (RUB, USD, UAH, KZT). Допускается указание общего \<currencyId> для всего файла. При этом элемент размещается в пределах \<shop> перед тегом \<offers>. |
| \<name>        | Наименование товара.                                                                                                                                                                                   |
| \<vendor>      | Производитель товара.                                                                                                                                                                                  |
| \<description> | Описание товара.                                                                                                                                                                                       |

### Дополнительные элементы, которые поддерживает Admitad <span id="additional-yml-elements" />

При желании вы можете добавить дополнительные элементы, чтобы предоставить веб-мастерам более подробную информацию о товаре.

:::tip
Admitad может обработать только дополнительные элементы, перечисленные ниже.
:::

| Элемент                  | Описание                                                                                                                                   |   |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ | - |
| \<oldprice>              | Элемент со значением старой цены, т.е. цены до скидки или распродажи.Возможные варианты: \<old\_price>, \<price\_old>.                     |   |
| \<typePrefix>            | Группа или категория товаров.                                                                                                              |   |
| \<model>                 | Модель.                                                                                                                                    |   |
| \<vendorCode>            | Код товара, код производителя.                                                                                                             |   |
| \<param>                 | Характеристики товара.                                                                                                                     |   |
| \<store>                 | Возможность купить товар в розничном магазине.                                                                                             |   |
| \<pickup>                | Возможность зарезервировать товар и забрать его самостоятельно.                                                                            |   |
| \<delivery>              | Возможность доставки товара.                                                                                                               |   |
| \<local\_delivery\_cost> | Стоимость доставки товара в своем регионе.                                                                                                 |   |
| \<sales\_notes>          | Информация о минимальной сумме заказа, минимальной партии товара или необходимости предоплаты, а также описание акций, скидок и распродаж. |   |
| \<adult>                 | Обозначение товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу.      |   |
| \<barcode>               | Штрихкод товара, указанный производителем.                                                                                                 |   |

### Пример YML-файла <span id="yml-example" />

```txt
<?xml version="1.0" encoding="windows-1251"?>

<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

<yml_catalog date="2016-11-21 11:01">

  <shop>

  <name>CompanyName</name>

  <company>CompanyName</company>

  <url>http://yourweb.ru</url>

  <categories>

    <category id="6">Jeans</category>

    <category id="7">T-shorts</category>

    <category id="27">Shoes</category>

    <category id="25">Bags</category>

  </categories>

  <offers>

    <offer id="12346" available="true" bid="21">

    <url>http://www.levi.com/RU/ru_RU/men-jeans/p/005011594</url>

    <price>6300</price>

    <oldprice>7300</oldprice>

    <currencyId>RUB</currencyId>

    <categoryId>6</categoryId>

    <picture>http://lsco.scene7.com/is/image/lsco/Levi/

    clothing/005011594-2013-spring-front-pdp.jpg</picture>

    <picture>http://lsco.scene7.com/is/image/lsco/Levi/

    clothing/005011594-2013-spring-back-pdp.jpg</picture>

    <picture>http://lsco.scene7.com/is/image/lsco/Levi/

    clothing/005011594-2013-spring-side-pdp.jpg</picture>

    <picture>http://lsco.scene7.com/is/image/lsco/Levi/

    clothing/005011594-2013-spring-detail1-pdp.jpg</picture>

    <store>true</store>

    <pickup>true</pickup>

    <delivery>true</delivery>

    <local_delivery_cost>300</local_delivery_cost>

    <name>Джинсы</name>

    <model>501 Original</model>

    <vendor>Levi's</vendor> 

    <vendorCode>005011594</vendorCode> 

    <typePrefix>Джинсы Levi's</typePrefix> 

    <sales_notes>Весенние скидки!</sales_notes>

    <description>Бесспорный артефакт американской культуры, с которого все началось, — 

    джинсы 501® Original Fit. Прямой крой по всему объему бедер, слегка зауженные книзу 

    брючины и фирменная ширинка на пуговицах. Эти джинсы сделаны из сырого селвидж-денима, 

    изготовленного в соответствии с оригинальной технологией на станках старого образца, 

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

    принимаются как проявление индивидуальности одежды, еще более усиливающееся в 

    процессе носки. Проверенные и надежные, оригинальные и простые, 

    единственные и неповторимые.</description> 

    <param name="Цвет">голубой, светло-синий, темно-синий, черный</param> 

    <param name="Размер">36, 40, 44, 48</param> 

    </offer> 

  </offers> 

</shop> 

</yml_catalog>
```


::::

:::cut{title="Фид Google Merchant"}
Чтобы товарный фид Google Merchant успешно загружался в Admitad и корректно обрабатывался системой, ваш файл должен соответствовать:

*   [стандартным требованиям к файлам Google Merchant](#standart-gm-requirements);
*   [дополнительным требованиям Admitad](#admitad-gm-requirements).

## Стандартные требования к формату Google Merchant  <span id="standart-gm-requirements" />

Стандартные требования к оформлению таких фидов подробно описаны в статье [«Спецификация сведений о товарах»](https://support.google.com/merchants/answer/7052112?hl=ru) Справки Google Merchant.

## Требования Admitad к формату Google Merchant <span id="admitad-gm-requirements" />

После создания файла в формате Google Merchant нужно проверить и доработать его в соответствии с требованиями Admitad.

*   [Особенности разметки](#common-yml-admitad-requirements)
*   [Обязательные атрибуты](#required-gm-attributes)
*   [Дополнительные атрибуты, которые поддерживает Admitad](#additional-gm-attributes)
*   [Пример файла Google Merchant](#gm-example)

### Особенности разметки <span id="gm-markup-features" />

В файле должны быть соблюдены особенности разметки, перечисленные ниже.

*   Сведения о товаре должны располагаться в атрибутах \<item> или \<entry> — обработчик обращается к фиду и забирает данные о товарах из этих тегов.
*   Если в товарном фиде присутствуют атрибуты \<size>, \<gender> или \<color>, их нужно передавать в теге \<param> (см. [пример](#gm-example)).
*   Атрибуты в файле можно указывать без префикса «g:» — файл все равно будет корректно обработан системой.

### Обязательные атрибуты <span id="required-gm-attributes" />

Убедитесь, что файл Google Merchant содержит обязательные для Admitad атрибуты.

Убедитесь, что файл Google Merchant содержит обязательные для Admitad атрибуты.

| Атрибут                      | Описание                                                       |
| ---------------------------- | -------------------------------------------------------------- |
| \<title>                     | Наименование товара.                                           |
| \<link>                      | URL-адрес страницы с товаром.                                  |
| \<g\:id>                     | Идентификатор товара.                                          |
| \<g\:image\_link>            | Фото товара.                                                   |
| \<g\:price>                  | Цена товара с валютой в формате ISO 4217 (RUB, USD, UAH, KZT). |
| \<google\_product\_category> | ID категории товара. Возможный вариант: \<product\_type>       |

### Дополнительные атрибуты, которые поддерживает Admitad <span id="additional-gm-attributes" />

При желании вы можете добавить дополнительные атрибуты, чтобы предоставить веб-мастерам более подробную информацию о товаре.

Admitad может обработать только дополнительные атрибуты, перечисленные ниже.

| Атрибут            | Описание                |
| ------------------ | ----------------------- |
| \<g\:availability> | Доступность для заказа. |
| \<g\:description>  | Описание товара.        |
| \<g\:brand>        | Бренд товара.           |
| \<param>           | Параметры товара.       |

### Пример файла Google Merchant <span id="gm-example" />

```txt
<item>

   <link>https://test.by/smartwatch/apple-watch-series-6-gps-40mm-red-red-sport-band-m00a3</link>

   <title>Apple Watch Series 6 GPS, 40mm, Red, Red Sport Band</title>

   <g:description>Внутренняя память: 32 гб, NFC: да, Размер: 40 мм,

   Серия: Apple watch series 6 gps, Производитель: Apple, Состояние: Б/У</g:description>

   <g:price>939.00 BYN</g:price>

   <g:brand>apple</g:brand>

   <g:image_link>https://test.by/storage/models/M00A3GK-A/large/j/200916180030597210.jpg</g:image_link>

   <g:id>M00A3</g:id>

   <g:availability>in stock</g:availability>

   <g:condition>used</g:condition>

   <g:identifier_exists>yes</g:identifier_exists>

   <param name="Внутренняя память">32 гб</param>

   <param name="NFC">да</param>

   <param name="Размер">40 мм</param>

   <param name="Серия">Apple watch series 6 gps</param>

   <param name="Производитель">Apple</param>

   <param name="Состояние">Б/У</param>

 </item>
```
:::

::::cut{title="CSV-фид"}
Чтобы товарный фид в формате CSV успешно загружался в Admitad и корректно обрабатывался системой, ваш файл должен:

*   [соответствовать требованиям Admitad](#admitad-csv-requirements);
*   [содержать обязательные параметры](#csv-required-parameters).

:::tip
При желании вы также можете добавить в файл [дополнительные параметры](#csv-additional-parameters), чтобы предоставить веб-мастерам более подробную информацию о товаре.
:::

## Требования Admitad <span id="admitad-csv-requirements" />

Проверьте, что ваш CSV-файл соответствует требованиям ниже.

*   В CSV-файле можно использовать только один из типов разделителей между полями данных:
    *   запятая ( , )
    *   точкка с запятой ( ; )
    *   вертикальная черта ( | )
    *   горизонтальная табуляция ( tab )
    *   двойной дефис ( -- )

:::tip
Символ, который вы выбрали в качестве разделителя, нельзя использовать для других целей.
Т.е. если в качестве разделителя вы выбрали запятую ( , ), то, например, в описании товара запятых быть не должно.
:::

*   Информацию о каждом товаре нужно передавать в отдельной строке.
    При этом все строки должны иметь одинаковое количество значений (параметров).
    Поэтому, если у одного из товаров отсутствует значение параметра, его все равно нужно указать как ””. Например: *"vitamins","","adult".*

*   Необязательно использовать кавычки для оформления параметров в CSV-файле.

:::tip
Наименования параметров фида, который вы хотите загрузить в Admitad, могут быть любыми, т.к. наши специалисты обрабатывают файл и переносят его в систему вручную.
:::

## Обязательные параметры <span id="csv-required-parameters" />

Убедитесь, что CSV-файл содержит обязательные для Admitad параметры.

**Некоторые наименования параметров могут отличаться от представленных ниже.**

Например, URL-адрес страницы с товаром можно передать в параметре url, link или url\_address.

| Параметр       | Описание                                                             |
| -------------- | -------------------------------------------------------------------- |
| category\_name | Название категории товара.                                           |
| offer\_id      | Идентификатор товара.                                                |
| url            | URL-адрес страницы с товаром.                                        |
| price          | Цена товара.                                                         |
| currencyId     | Идентификатор валюты товара в формате ISO 4217 (RUB, USD, UAH, KZT). |

## Дополнительные параметры, которые поддерживает Admitad <span id="csv-additional-parameters" />

При желании вы можете добавить дополнительные параметры, чтобы предоставить веб-мастерам более подробную информацию о товаре.

:::tip
Admitad может обработать только дополнительные параметры, перечисленные ниже.
:::

Некоторые наименования параметров могут отличаться от представленных ниже.

Например, ссылку на изображение товара можно передать в параметре picture, photo или image.

Несмотря на то, что для CSV-фидов параметры «name», «picture» и «description» — это дополнительные параметры, рекомендуется добавлять их в фид. Это сделает ваш фид более привлекательным для веб-мастеров, а также увеличит количество продаж: пользователи более охотно покупают товары, у которых есть описание и изображение.

| Параметр    | Описание                              |
| ----------- | ------------------------------------- |
| name        | Название товара.                      |
| picture     | Ссылка на изображение товара.         |
| description | Описание товара.                      |
| oldprice    | Цена товара без учета скидок и акций. |
| vendor      | Производитель товара.                 |
| available   | Доступность товара для заказа.        |

## Пример CSV-файла <span id="csv-example" />

Наименования параметров фида могут быть любыми, поэтому поля в примере могут не совпадать с параметрами, указанными в таблицах выше.

```txt
"id","title","description","google product category","product type","link","image

  link","condition","availability","price","currencyId","sale price","sale price effective

  date","gtin","brand","mpn","item group id","gender","age

  group","color","size","shipping","shipping weight" // названия полей товарного фида

      

  "129914","Sunshine Nutrition Vitamin C Energy Apple Chewable Tablets 14's x 24","Sunshine

  Nutrition Vitamin C Energy Apple Chewable Tablets 14's x 24","0","Vitamin C",

  "https://www.testtest.com/product/sunshine-nutrition-vitamin-c-energy-apple-chewable-tablets-14-s-x-24",

  "https://test-cdn.testtest.com/archieved-images/media/catalog/product/v/i/vit-c-apple.jpg","new",

  "in stock","216","AED","","2022-02-22T10:58:55+04:00/2022-02-24T10:58:55+04:00",

  "","SUNSHINE","","","","adult","","","","" // информация о товаре 1

      

  "125711","Loreal Infaillible Primer Pore

  Refining","Loreal Infaillible Primer Pore Refining","0","0",

  "https://www.testtest.com/product/lor-infaillible-primer-pore-refining",

  "https://test-cdn.testtest.com/archieved-images/media/catalog/product","new",

  "in stock","65","AED","21","2022-02-22T10:58:55+04:00/2022-02-24T10:58:55+04:00",

  "","LOREAL MAKEUP","","","","adult","","","","" // информация о товаре 2
    
```
::::