Товарный фид

Обновлено 24/01/2023 09:51

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

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

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

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

В чем польза товарных фидов

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

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

Порядок создания и загрузки товарных фидов

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

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

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

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

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

Подготовка файла товарного фида

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

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

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

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

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

Чтобы товарный фид в формате YML успешно загружался в Admitad Partner Network и корректно обрабатывался системой, ваш файл должен соответствовать:

стандартным требованиям к YML‑формату;
дополнительным требованиям Admitad Partner Network.

Стандартные требования к YML‑формату

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

Требования Admitad Partner Network к YML‑формату

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

Основные требования к файлу
Требования к разметке
Обязательные элементы
Дополнительные элементы, которые поддерживает Admitad Partner Network
Пример YML-файла

Основные требования к файлу

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

ID товара соответствует product_id в информации о заказе.
Кодировка файла: либо UTF-8, либо windows-1251.
В файле не используются:

непечатаемые символы с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки);
эмодзи и другие специальные символы Юникода.

Символы в тексте заменены на эквивалентные коды:
Символ в тексте Код для YML-файла
"
"
&
&
<
<
>
>
'
'
В качестве разделителя целой и дробной частей всех числовых значений используется только точка (правильно: 2.56; неправильно: 2,56).
MIME-тип файла должен быть application/xml.
Фиды с другими MIME-типами (например, text/xml или text/html) не загрузятся в Admitad Partner Network.

Особенности разметки

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

Можно использовать атрибут 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 товара на сайте, иначе инструмент будет работать некорректно. При этом в выгрузке допускается наличие дублей.

Обязательные элементы

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

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

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

Дополнительные элементы, которые поддерживает Admitad Partner Network

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

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

Элемент	Описание
<oldprice>	Элемент со значением старой цены, т.е. цены до скидки или распродажи. Возможные варианты: <old_price>, <price_old>.
<typePrefix>	Группа или категория товаров.
<model>	Модель.
<vendorCode>	Код товара, код производителя.
<param>	Характеристики товара.
<store>	Возможность купить товар в розничном магазине.
<pickup>	Возможность зарезервировать товар и забрать его самостоятельно.
<delivery>	Возможность доставки товара.
<local_delivery_cost>	Стоимость доставки товара в своем регионе.
<sales_notes>	Информация о минимальной сумме заказа, минимальной партии товара или необходимости предоплаты, а также описание акций, скидок и распродаж.
<adult>	Обозначение товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу.
<barcode>	Штрихкод товара, указанный производителем.

Пример YML-файла

<?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>RUR</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>

Чтобы товарный фид Google Merchant успешно загружался в Admitad Partner Network и корректно обрабатывался системой, ваш файл должен соответствовать:

стандартным требованиям к файлам Google Merchant;
дополнительным требованиям Admitad Partner Network.

Стандартные требования к формату Google Merchant

Стандартные требования к оформлению таких фидов подробно описаны в статье «Спецификация сведений о товарах» Справки Google Merchant.

Требования Admitad Partner Network к формату Google Merchant

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

Особенности разметки
Обязательные атрибуты
Дополнительные атрибуты, которые поддерживает Admitad Partner Network
Пример файла Google Merchant

Особенности разметки

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

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

Обязательные атрибуты

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

Атрибут	Описание
<title>	Наименование товара.
<link>	URL-адрес страницы с товаром.
<g:id>	Идентификатор товара.
<g:image_link>	Фото товара.
<g:price>	Цена товара.
<google_product_category>	ID категории товара. Возможный вариант: <product_type>

Дополнительные атрибуты, которые поддерживает Admitad Partner Network

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

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

Атрибут	Описание
<g:availability>	Доступность для заказа.
<g:description>	Описание товара.
−	Код валюты. Можно получить из тега price: (<g:price>80 UAH</g:price>) YML-аналог — <currencyId>.
<g:brand>	Бренд товара.
<param>	Параметры товара.

Пример файла Google Merchant

<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>

Чтобы товарный фид в формате CSV успешно загружался в Admitad Partner Network и корректно обрабатывался системой, ваш файл должен:

соответствовать требованиям Admitad Partner Network;
содержать обязательные параметры.

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

Требования Admitad Partner Network

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

В CSV-файле можно использовать только один из типов разделителей между полями данных:

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

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

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

Обязательные параметры

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

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

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

Параметр	Описание
category_name	Название категории товара.
offer_id	Идентификатор товара.
url	URL-адрес страницы с товаром.
price	Цена товара.

Дополнительные параметры, которые поддерживает Admitad Partner Network

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

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

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

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

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

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

Пример CSV-файла

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

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

  link","condition","availability","price","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 AED","2022-02-22T10:58:55+04:00/2022-02-24T10:58:55+04:00",

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

Символ в тексте	Код для YML-файла
"	"
&	&
<	<
>	>
'	'

В чем польза товарных фидов

Порядок создания и загрузки товарных фидов

Подготовка файла товарного фида

Стандартные требования к YML‑формату

Требования Admitad Partner Network к YML‑формату

Основные требования к файлу

Особенности разметки

Обязательные элементы

Дополнительные элементы, которые поддерживает Admitad Partner Network

Пример YML-файла

Стандартные требования к формату Google Merchant

Требования Admitad Partner Network к формату Google Merchant

Особенности разметки

Обязательные атрибуты

Дополнительные атрибуты, которые поддерживает Admitad Partner Network

Пример файла Google Merchant

Требования Admitad Partner Network

Обязательные параметры

Дополнительные параметры, которые поддерживает Admitad Partner Network

Пример CSV-файла

Была ли эта статья полезной?