В этой статье (~5 минут):
- Что такое фид и как он используется?
- Как подготовить фид для интеграции с Competera?
- CSV или Excel
- XML или YML
Что такое фид и как он используется?
Чтобы упростить интеграцию с нашим сервисом и избавить вас от необходимости обновлять список товаров в кабинете вручную, мы предлагаем нашим клиентам использовать товарный фид — файл, где находятся данные обо всех товарах в магазине. Сам файл состоит из дерева родительских и дочерних категорий со всеми товарами, которые необходимо мониторить. Вы всегда сможете корректировать ассортимент в мониторинге самостоятельно: изменять цены и наличие товаров, удалять устаревшие или неактуальные товары, устанавливать метки, вносить информацию по брендам или вендорам в структуру фида, а также передавать ссылки на товары на вашем сайте.
Competera поддерживает 3 стандартных формата фида: XML, CSV, Excel. Тем не менее, мы можем обработать любой другой тип файлов, но в данном случае процесс настройки будет более продолжительным. Также при интеграции необходимо указать частоту обновления фида, то есть дни и время, когда данные из фида будут попадать в ваш кабинет. После этого наши специалисты подключат автоматическое обновление вашего товарного списка в кабинете, вплоть до нескольких раз в день — в зависимости от потребностей вашего бизнеса, и вам больше не понадобится вносить изменения вручную.
Как подготовить фид для интеграции с Competera
Предлагаем ознакомиться с необходимым форматом данных для интеграции с Competera.
CSV или Excel
Данный формат подразумевает, что в каждой строке будет информация об одном продукте. Также обратите внимание, что файл формата CSV, должен иметь разделитель TAB(\t) — такой формат файлов ещё называют TSV. Название колонок в файле передавать НЕ нужно.
Обязательные поля | |
Поле | Описание |
Артикул (SKU) | Уникальный код товара в вашем кабинете. |
Ссылка на товар (URL) | Адрес страницы с карточкой товара на вашем сайте. |
Название товара (Title) | Название вашего товара. |
Категория (Category) | Если продукт находится в дочерней категории, то нужно указать все дерево категорий через разделитель ( ">" , "/" или другой), например: Category 1 > Subcategory 11 > Subcategory 12 |
Цена (Price) | Должно содержать только цифры и может иметь точку для отделения копеек. Запятые, пробелы и другие символы НЕ должны присутствовать. |
Поставщик (Vendor) | Дополнительное поле для фильтрации товаров по брендам. |
Опциональные поля | |
Поле | Описание |
Наличие (Availability) |
Показывает статус наличия товара в вашем магазине. Если указано InStock, 1, true, yes — то товар в наличии, OutOfStock, 0, false, no — не в наличии. Если это поле отсутствует, то данные о наличии формируются из колонки price: если цена есть — то товар в наличии, если цена отсутствует — не в наличии. |
MAP (рекомендованная розничная цена, РРЦ) |
Допускаются только цифры и точка для отделения копеек. Запятые, пробелы и другие символы не должны присутствовать. Пример: 278.07. Вы сможете определять товары, где вы либо ваши конкуренты нарушили РРЦ. |
Теги (Tags) | Может быть несколько, разделителем будет запятая. Используется для идентификации специальных групп товаров. Например: бестселлеры, А-группа и т.д. Есть возможность фильтрации товаров в отчетах по тегам, настройки сканирования. |
MPN / UPC | Уникальный код товара (например, EAN-13 или ISBN) для более качественных и быстрых сопоставлений с конкурентами. |
Стоимость товара у поставщика (Cost) | Может содержать только цифры и иметь точку для отделения копеек. Запятые, пробелы и другие символы не должны присутствовать. Дает возможность отслеживать ситуации, когда цены конкурентов ниже вашей закупочной, и быстро проанализировать собственную маржу или наценку товара. |
Другие специальные поля |
Если вы хотите видеть в кабинете другие поля, которые предоставите в фиде, мы можем загрузить их в кастомные поля, название и тип которых вы выбираете сами. |
Примеры такого фида: 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>
Обязательные поля | |
Поле | Описание |
Артикул (SKU) | По умолчанию берется из <offer id>, но также может быть в другом теге внутри тега <offer>. |
Ссылка на товар (URL) | Берется из тега <url>. |
Название товара (Title) | Берется из тега <name> или если указано <offer type="vendor.model">, то имя формируется объединением данных из тегов <vendor> и <model>. |
Категория (Category) | Берется из тега <categoryId>, в котором указывается id категории установленное в дереве категорий. |
Цена (Price) | Берется из тега <price> и должно содержать только цифры и может иметь точку для отделения копеек. Запятые, пробелы и другие символы не должны присутствовать. |
Доступность (Availability) | Берется из <offer available>, если указано "true" — то товар в наличии, "false" — не в наличии. |
Поставщик (Vendor) | Берется из указанного вами тега. |
Опциональные поля | |
Поле | Описание |
MAP (рекомендуемая розничная цена, РРЦ) | Берется из указанного вами тега. Должно содержать только цифры и может иметь точку для отделения копеек. Запятые, пробелы и другие символы не должны присутствовать. |
MPN / UPC | Берется из указанного вами тега. Уникальный код (например, EAN-13 или ISBN) товаров для более качественных и быстрых сопоставлений |
Теги (Tags) | Берется из указанного вами тега, может быть несколько, но их нужно указывать отдельно. Используется для идентификации специальных групп товаров. Например: бестселлеры, А-группа и т.д. Есть возможность фильтрации товаров в отчетах по тегам, настройки сканирования. Пример:
<tag>tag1</tag> |
Стоимость (Сost) | Берется из указанного вами тега. Должно содержать только цифры и может иметь точку для отделения копеек. Запятые, пробелы и другие символы не должны присутствовать. Дает возможность отслеживать ситуации, когда цены конкурентов ниже вашей закупочной и быстро проанализировать собственную маржу или наценку товара. |
Другие специальные поля |
Если вы хотите видеть в кабинете другие поля, которые предоставите в фиде, мы можем загрузить их в кастомные поля, название и тип которых вы выбираете сами. |
Пример такого фида:
<?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>
Мы приветствуем диалог и всегда рады обратной связи. Дайте нам знать, был ли этот материал полезен для вас, а также делитесь комментариями в соответствующей секции внизу 👇.
Комментарии
0 комментариев
Войдите в службу, чтобы оставить комментарий.