Спецификация на продуктовия фийд
Как да подготвите продуктовия си фийд
1. Една спецификация, два формата
Marketise Me приема продуктовия ви фийд в два формата: Google Shopping XML (съществуващ фийд за Google Merchant Center работи без промяна) или CSV със същите имена на колоните. Няма отделно съпоставяне на колони за всеки търговец.
Всички цени се подават в евро (EUR) с включено ДДС.
2. Задължителни полета
| Име | Значение | Пример |
|---|---|---|
| id | Уникален идентификатор на продукта във вашия магазин. | SKU-1001 |
| title | Заглавие на продукта. | Lattafa Asad EDP 100ml |
| link | Адрес на продуктовата страница в магазина. | https://example.bg/produkt-1001 |
| image_link | Адрес на основното изображение на продукта. | https://example.bg/images/1001.jpg |
| price | Цена на дребно с включено ДДС, в евро с код на валутата. | 36.99 EUR |
| availability | Наличност на продукта. | in_stock |
| brand | Марка на продукта. | Lattafa |
3. Идентификация на продукта
Всеки продукт трябва да съдържа полето brand. Продукт, който няма нито gtin, нито mpn, се показва на сайта, но не може да бъде сравнен с други магазини.
| Име | Значение | Пример |
|---|---|---|
| gtin | Баркод на продукта (GTIN, EAN или UPC). | 6291108735411 |
| mpn | Номер на продукта, определен от производителя. | MPN-1002 |
4. Незадължителни полета
| Име | Значение | Пример |
|---|---|---|
| description | Кратко описание на продукта. | Кратко описание на продукта |
| condition | Състояние на продукта. | new |
| shipping | Цена на доставка по държава. | BG:::4.50 EUR |
| sale_price | Намалена цена, ако е по-ниска от цената в price. | 29.99 EUR |
| sale_price_effective_date | Период, в който намалената цена е валидна. | 2026-09-01T00:00+03:00/2026-09-30T23:59+03:00 |
| item_group_id | Общ идентификатор за варианти на един и същ продукт. | GROUP-1001 |
| google_product_category | Категория на продукта според Google. | 469 |
| product_type | Категория на продукта според вашия магазин. | Парфюми/Дамски |
| color | Цвят на продукта. | Black |
| colour | Цвят на продукта (британско изписване на полето). | Black |
| size | Размер на продукта. | M |
| size_system | Система за размери. | EU |
| size_type | Вид размер. | regular |
| material | Материал на продукта. | Памук |
| pattern | Десен на продукта. | Каре |
| multipack | Брой продукти в комплект за препродажба. | 2 |
| is_bundle | Дали продуктът е комплект от различни артикули. | no |
| model | Модел на продукта. | A2000 |
| model_number | Номер на модела. | A2000-BLK |
| region | Регион, за който важи офертата. | BG |
| storage | Обем на вградената памет. | 128GB |
| identifier_exists | Дали продуктът има баркод или производителски номер. | yes |
| quantity | Налично количество. Не замества availability, което остава задължително. | 75 |
5. Формат на стойностите
priceиsale_price: число с точка като десетичен разделител и код на валутата, например36.99 EUR.availability:in_stock,out_of_stock,preorderилиbackorder.condition:new,refurbishedилиused.gtin: пазете цифрите като текст (Excel премахва водещите нули).shipping:BG:::4.50 EUR(държава:регион:услуга:цена).sale_price_effective_date:2026-09-01T00:00+03:00/2026-09-30T23:59+03:00.quantityне заместваavailability: наличността трябва винаги да е посочена изрично.
6. Правила за CSV файла
- Кодиране UTF-8.
- Първият ред съдържа имената на колоните в произволен ред.
- Разделител: запетая, точка и запетая или табулация.
- Кавички по стандартния CSV формат.
- Допълнителни колони се пропускат.
- Липсваща задължителна колона спира целия импорт и изброява липсващите колони.
- Най-много 50 MB и 100 000 продукта.
7. Пример за Google Shopping XML
<item>
<g:id>SKU-1001</g:id>
<title>Примерен продукт 100 мл</title>
<link>https://example.bg/produkt-1001</link>
<g:image_link>https://example.bg/images/1001.jpg</g:image_link>
<g:price>36.99 EUR</g:price>
<g:availability>in_stock</g:availability>
<g:brand>Примерна марка</g:brand>
<g:gtin>4006381333931</g:gtin>
<g:condition>new</g:condition>
<g:product_type>Парфюми/Дамски</g:product_type>
<g:shipping>
<g:country>BG</g:country>
<g:price>4.50 EUR</g:price>
</g:shipping>
</item>8. Примерен CSV файл
Изтеглете примерен CSV файл със задължителните и част от незадължителните колони.
Изтегли feed-template.csv9. Следващи стъпки
- Подайте формуляра за кандидатстване и посочете XML или CSV.
- Проверете фийда с инструмента за диагностика в търговския панел.
- Изчакайте преглед от нашия екип.
- След одобрение първият импорт се стартира автоматично.
10. Контакт
При въпроси относно фийда пишете на support@marketiseme.com.