Товарный фид

  • Обновлено

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

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

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

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

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

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

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

  • упрощают работу веб-мастерам и тем самым делают вашу программу более привлекательной для сотрудничества.

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

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

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

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

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

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

feed

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

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

  • Обязательно указывайте ссылки на страницы с товарами без 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.

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

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

    • ID товара соответствует product_id в информации о заказе.

    • Кодировка файла: либо UTF-8, либо windows-1251.

    • В файле не используются:

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

    • Символы в тексте заменены на эквивалентные коды:

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


    • В качестве разделителя целой и дробной частей всех числовых значений используется только точка (правильно: 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.

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

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

    • Сведения о товаре должны располагаться в атрибутах <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

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