Товарный фид

Обновлено 05/08/2022 15:14

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Основные требования к файлу
Требования к разметке
Обязательные элементы
Дополнительные элементы, которые поддерживает Admitad Affiliate
Пример 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 Affiliate.

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

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

Можно использовать атрибут 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 Affiliate элементы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Требования Admitad Affiliate

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Например, ссылку на изображение товара можно передать в параметре 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 Affiliate к YML‑формату

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

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

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

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

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

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

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

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

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

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

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

Требования Admitad Affiliate

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

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

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

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