Работа с фидами в Competera

В этой статье (~5 минут):

• Что такое фид и как он используется?
• Как подготовить фид для интеграции с Competera?
  • CSV или Excel
  • XML или YML

Что такое фид и как он используется?

Чтобы упростить интеграцию с нашим сервисом и избавить вас от необходимости обновлять список товаров в кабинете вручную, мы предлагаем нашим клиентам использовать товарный фид — файл, где находятся данные обо всех товарах в магазине. Сам файл состоит из дерева родительских и дочерних категорий со всеми товарами, которые необходимо мониторить. Вы всегда сможете корректировать ассортимент в мониторинге самостоятельно: изменять цены и наличие товаров, удалять устаревшие или неактуальные товары, устанавливать метки, вносить информацию по брендам или вендорам в структуру фида, а также передавать ссылки на товары на вашем сайте.

Competera поддерживает 3 стандартных формата фида: XML, CSV, Excel. Тем не менее, мы можем обработать любой другой тип файлов, но в данном случае процесс настройки будет более продолжительным. Также при интеграции необходимо указать частоту обновления фида, то есть дни и время, когда данные из фида будут попадать в ваш кабинет. После этого наши специалисты подключат автоматическое обновление вашего товарного списка в кабинете, вплоть до нескольких раз в день — в зависимости от потребностей вашего бизнеса, и вам больше не понадобится вносить изменения вручную.

Как подготовить фид для интеграции с Competera

Предлагаем ознакомиться с необходимым форматом данных для интеграции с Competera.

CSV или Excel

Данный формат подразумевает, что в каждой строке будет информация об одном продукте. Также обратите внимание, что файл формата CSV, должен иметь разделитель TAB(\t) — такой формат файлов ещё называют TSV. Название колонок в файле передавать НЕ нужно.

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

XML или YML (Yandex Market Language)

Для использования этого формата необходимо иметь 2 основных блока информации: categories (дерево категорий) и offers (список товаров). 

За описание категории ответствечает тег <category>. Например:

<category id="1">Category 1</category>
<category id="10" parentId="1">Category 10</category>

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

Пример дерева категорий:

За описание товара отвечает тег <offer>. Например:

  <offer id="1" available="true">
    <url>http://best.seller.com/1</url>
    <price>1490.12</price>
    <oldprice>1620</oldprice>
    <categoryId>101</categoryId>
    <name>Best product 1</name>
    <vendor>Vendor 1</vendor>
    <vendorCode>A1234567B</vendorCode>
    <barcode>0156789012</barcode>
  </offer>

<tag>tag1</tag>
<tag>tag2</tag>
<tag>tag3</tag>

Пример такого фида:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2019-02-05 17:22">
 <shop>
 <categories>
 <category id="1">Category 1</category>
 <category id="10" parentId="1">Category 10</category>
 <category id="101" parentId="10">Category 101</category>
 <category id="102" parentId="10">Category 102</category>
 <category id="2">Category 2</category>
 <category id="21" parentId="2">Category 21</category>
 <category id="22" parentId="2">Category 22</category>
 <category id="200" parentId="22">Category 200</category>
 </categories>
 <offers>
 <offer id="1" available="true">
 <url>http://best.seller.com/1</url>
 <price>1490.12</price>
 <oldprice>1620</oldprice>
 <categoryId>101</categoryId>
 <name>Best product 1</name>
 <vendor>Vendor 1</vendor>
 <vendorCode>A1234567B</vendorCode>
 <barcode>0156789012</barcode>
 </offer>
 <offer id="2" available="true">
 <url>http://best.seller.ru/2</url>
 <price>8990</price>
 <categoryId>102</categoryId>
 <vendor>Vendor 1</vendor>
 <name>Best product 2</model>
 <barcode>0123456789379</barcode>
 </offer>
 <offer id="3" available="false">
 <url>http://best.seller.ru/3</url>
 <price>223.32</price>
 <oldprice>1620</oldprice>
 <categoryId>2</categoryId>
 <name>Best product 3</name>
 <vendor>Vendor 2</vendor>
 <mpn>Z00019NM</mpn>
 <barcode>0156789012</barcode>
 </offer>
 <offer id="4" available="true">
 <url>http://best.seller.ru/4</url>
 <price>111</price>
 <cost>100</cost>
 <categoryId>200</categoryId>
 <vendor>Vendor 3</vendor>
 <name>Best product 4</model>
 <barcode>0123456789379</barcode>
 </offer>
 </offers>
 </shop>
</yml_catalog>

Мы приветствуем диалог и всегда рады обратной связи. Дайте нам знать, был ли этот материал полезен для вас, а также делитесь комментариями в соответствующей секции внизу 👇.