Товарный фид — это файл, который содержит данные о товарах из каталога вашего сайта. Использование товарных фидов актуально только для партнерских программ из категории «Интернет-магазины».
Веб-мастера используют предоставленные вами товарные фиды для создания сервисов сравнения товаров, партнерских интернет-магазинов, сайтов-витрин, 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‑формату
Стандартные требования к 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
Стандартные требования к оформлению таких фидов подробно описаны в статье «Спецификация сведений о товарах» Справки 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
Проверьте, что ваш CSV-файл соответствует требованиям ниже.
- В CSV-файле можно использовать только один из типов разделителей между полями данных:
- запятая ( , )
- точкка с запятой ( ; )
- вертикальная черта ( | )
- горизонтальная табуляция ( tab )
- двойной дефис ( -- )
Символ, который вы выбрали в качестве разделителя, нельзя использовать для других целей.
Т.е. если в качестве разделителя вы выбрали запятую ( , ), то, например, в описании товара запятых быть не должно.- Информацию о каждом товаре нужно передавать в отдельной строке.
При этом все строки должны иметь одинаковое количество значений (параметров).
Поэтому, если у одного из товаров отсутствует значение параметра, его все равно нужно указать как ””. Например: "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 - В CSV-файле можно использовать только один из типов разделителей между полями данных:
