Усе, що потрібно знати про власний формат фіду (Custom Format)#

1. Вступ до власного формату (Custom Format)#

Що таке власний формат#

Власний формат — це функція, за допомогою якої ви навчите Mergado розпізнавати й обробляти майже будь-який файл XML або CSV. Вона дає змогу завантажити в Mergado будь-який фід, визначити його структуру, а потім працювати з даними так само, як зі звичайними інтегрованими форматами. Крім того, дає змогу створити в Mergado фід у форматі, якого немає серед офіційних інтеграцій.

Власний формат визначаєте ви – описуєте Mergado, які елементи воно має імпортувати чи експортувати і як із ними поводитися. Ця функціональність призначена передусім для менш поширених, змінених або машинно нерозпізнаваних форматів, які Mergado без вашого визначення не змогло б завантажити.

Для чого він слугує?#

Власний формат має кілька ключових застосувань:

1. Пристосування входу й виходу#

Дає змогу пристосувати структуру даних до ваших потреб – на вході й на виході проєкту.

2. Більший контроль над даними#

Допомагає точно визначити, як дані товарів мають оброблятися, відображатися й експортуватися в Mergado.

3. Імпорт невідомих фідів#

Підходить для роботи з форматами, яких Mergado не розпізнає: фіди постачальників, застарілі чи суттєво змінені структури, індивідуальні фіди або додаткові фіди (наприклад, складські, туристичні пропозиції, відгуки).

4. Збереження початкової структури фіду#

Якщо вхідний XML містить одразу після кореневого елемента окремі товари, за допомогою власного формату можна зберегти початкову структуру без змін – корисно для нестабільних джерел постачальників.

5. Експорт у власний формат#

Слугує також для створення вихідного фіду у форматі, який Mergado поки що офіційно не підтримує. Це типово під час виходу на нові маркетплейси або для менших сервісів порівняння цін. Достатньо використати шаблон фіду, що містить принаймні одну зразкову позицію.

Як Mergado працює з даними (Mergado XML і конвертер)?#

Mergado XML#

Усі перетворення даних у Mergado проходять через єдиний проміжний формат Mergado XML. Він слугує «універсальною мовою», на яку перетворюються вхідні дані і з якої потім генеруються вихідні формати.

Конвертер#

Конвертер — це механізм, який перетворює дані між форматами. Він застосовується завжди, коли вхідний і вихідний формати відрізняються. Конвертер активується і тоді, коли на вході й на виході формат Google Merchants.

Роль власного формату#

Власний формат дає вам змогу створити власний конвертер. Під час визначення CF ви пояснюєте Mergado, що означає кожна частина вашого фіду і з яким еквівалентом у Mergado XML її слід зіставити.

Найважливіший крок (стосується лише роботи з XML-фідом) — правильний вибір елементів для:

• CHANNEL (назва елемента в Mergado XML)
  • так званий Root, тобто кореневий елемент, що обгортає всі товари в XML-фіді
  • у XML-фіді такий елемент лише один,
  • зазвичай його відкривальний тег стоїть на самому початку фіду, а закривальний тег — у самому кінці фіду
  • назва кореневого елемента може бути в кожному фіді інша, приклади за форматом:
    • Google:
    • Heureka
    • Mergado XML
• ITEM (назва елемента в Mergado XML)
  • елемент, що обгортає одну позицію (товар)
  • у XML-фіді такий елемент трапляється стільки разів, скільки у вас позицій/товарів,
  • Кожен товар/позиція фіду має рівно один обгортковий елемент
  • назва обгорткового елемента товару може бути в кожному фіді інша, приклади за форматом:
    • Google:
    • Heureka
    • Mergado XML

Ці два елементи визначають структуру, у якій Mergado обробляє дані.

Коли має сенс використовувати власний формат?#

На вході#

• Mergado не розпізнає формат фіду.
• Ви працюєте з невідомим, зміненим або індивідуальним форматом.
• Потрібно зберегти початкову структуру фіду.
• Підключаєте додаткові дані, які не інтегровані (склад, послуги, відгуки).

На виході#

• Вам потрібен фід у непідтримуваному форматі.
• Хочете контролювати кореневі елементи та структуру вихідного XML.
• Маєте в розпорядженні зразковий фід, з якого можна створити шаблон.

Обмеження і на що звернути увагу#

1. Ігнорування елементів поза ITEM#

Власний формат не може обробити елементи, розміщені над обгортковим елементом позиції. Усе, що не лежить під ITEM, редактор у фіді, обробленому через власний формат, не бачить. Це означає, що інформація, розміщена між CHANNEL та ITEM, може бути втрачена.

Рішення для складних структур: Розділення фіду на два проєкти та їх повторне об’єднання за допомогою розширення Blending Bull.

2. Перетворення може спричинити втрату даних#

Конвертер застосовується і тоді, коли перетворюєте з того самого власного формату на той самий. Якщо зіставлення неповне, у новому фіді може статися втрата інформації (у початковому фіді вона залишиться, лише Mergado з нею не працює).

3. Кореневі елементи на виході#

Кореневі елементи Mergado Editor створює автоматично відповідно до вибраного вихідного формату. Тож створити їх вручну не можна, як стандартні елементи в редакторі. Якщо ж вам потрібні нестандартні кореневі елементи у вихідному фіді, єдиний спосіб вплинути на кореневі елементи — вибрати правильний шаблон для власного формату, який потім використаєте на виході.

4. Потреба оновлювати формат у разі змін#

Якщо у вхідному файлі з’явиться новий елемент, власний формат не має для нього налаштованої поведінки. Mergado такий елемент автоматично імпортує і не приховає, тож він автоматично потрапить у вихідний фід без змін. У такому разі потрібно оновити структуру власного формату і доповнити налаштування зіставлення нового елемента. Після збереження та перегенерування проєкту зміни автоматично наберуть чинності.

Або ж, якщо нові елементи спричинять невалідність вихідного фіду, найшвидше це виправити, вручну приховавши нові елементи на сторінці Elements і запустивши Export проєкту (без застосування правил).

Часті запитання#

Що таке власний формат у Mergado?#

Власний формат — це функція, завдяки якій ви навчите Mergado обробляти майже будь-який файл XML або CSV, незалежно від того, чи Mergado зазвичай його підтримує. Вона дає змогу визначити, які елементи містить фід і як система має з ними працювати під час імпорту та експорту. Слугує також для створення вихідного фіду у власному форматі, наприклад для платформ або каналів, які Mergado стандартно не підтримує.

Для чого слугує власний формат?#

Власний формат дає змогу пристосувати структуру даних проєкту до ваших потреб. Допомагає точно керувати тим, як Mergado завантажує, відображає й експортує дані товарів. Корисний передусім для імпорту нестандартних або змінених фідів і для експорту у формати, які не входять до інтегрованих каналів.

Коли має сенс використовувати власний формат на вході?#

Власний формат підходить, коли Mergado не може розпізнати фід або коли ви працюєте з індивідуальним, зміненим чи додатковим фідом, який не вписується в наявні інтеграції. Допомагає також там, де потрібно зберегти початкову структуру фіду, якщо XML містить позиції безпосередньо під кореневим елементом. Можете використати його й для вхідних додаткових даних, як-от склад, послуги або відгуки.

Коли має сенс використовувати власний формат на виході?#

Власний формат на виході знадобиться, коли потрібно створити фід у вигляді, який Mergado стандартно не генерує. Часто йдеться про вихід на нові платформи або підключення до внутрішніх систем із власною структурою XML. Достатньо мати зразковий фід, за яким Mergado створить вихідний шаблон.

Що таке Mergado XML і чому він важливий?#

Mergado XML — це внутрішній проміжний формат, через який проходять усі перетворення даних. Він працює як «універсальна мова», на яку перекладаються вхідні дані і з якої далі генеруються вихідні формати. Завдяки цьому не потрібно мати окремий конвертер для кожної пари форматів.

Що робить конвертер?#

Конвертер перетворює значення між форматами даних – з будь-якого вхідного формату на Mergado XML, а з нього на вихідний формат. У деяких форматів (наприклад, Google Merchants) він активується і тоді, коли на вході й на виході той самий формат. Якщо зіставлення неповне, конвертер може деякі значення пропустити, тому рекомендується приділяти зіставленню увагу.

Яку роль відіграє власний формат під час перетворення даних?#

Власний формат дає змогу створити власний конвертер, пристосований до вашого фіду. Ви точно визначаєте, що означають окремі елементи і як їх перетворити на Mergado XML. Завдяки цьому отримуєте контроль над структуруванням даних навіть для платформ, яких Mergado стандартно не знає.

Що означає правильно вибрати CHANNEL та ITEM?#

CHANNEL — це кореневий елемент фіду Mergado XML, який визначає, де починається й закінчується весь документ. ITEM — це обгортковий елемент однієї позиції, і в Mergado XML він трапляється стільки разів, скільки у вас товарів. Правильне зіставлення цих двох елементів — основна передумова для того, щоб Mergado змогло обробити ваш фід. CSV-фід цих елементів не має, тому їх зіставлення відпадає.

Які обмеження має власний формат?#

Власний формат не вміє обробляти елементи, що лежать поза ITEM, тобто, наприклад, інформацію, розміщену між CHANNEL та ITEM. Ці елементи Mergado ігнорує, і в проєкті з ними не можна безпосередньо працювати. Якщо потрібно їх зберегти, доведеться використати інший підхід, наприклад двопроєктну модель і об’єднання через Blending Bull.

Чому під час перетворення може статися втрата даних?#

Власний формат ігнорує елементи в XML-фідах, розміщені між CHANNEL та ITEM. Якщо такі елементи містять потрібну вам інформацію, слід використати інший підхід, наприклад двопроєктну модель і об’єднання через Blending Bull.

Як Mergado працює з кореневими елементами на виході?#

Кореневі елементи виникають відповідно до вибраного вихідного формату, і безпосередньо редагувати їх не можна. Якщо потрібна інша структура, слід використати власний формат, створений за зразковим фідом, або внести зміни через Blending Bull. Так ви забезпечите, щоб вихідний фід мав саме такий заголовок і обгортку, які вам потрібні.

Що робити, коли у вхідному фіді з’явиться новий елемент?#

Новий елемент автоматично імпортується в проєкт, але Mergado не знає, що з ним робити, бо він не входить до початкового зіставлення. У такій ситуації потрібно оновити структуру власного формату й доповнити зіставлення нового елемента. Потім перегенеруєте проєкт, і дані завантажаться та перетворяться правильно.

Як дізнатися, коли краще власний формат не використовувати?#

Власний формат не потрібен там, де є офіційна інтеграція. Якщо маєте сумніви, варто проконсультуватися з підтримкою.

Для чого слугує зразковий фід?#

Зразковий фід слугує шаблоном під час створення вихідного власного формату. За ним Mergado визначить структуру кореневих елементів, обгорткових тегів та інших складників, які мають зберегтися на виході. Достатньо мінімального прикладу – хоч би одного товару. Зразковий фід має бути доступний за URL-адресою.

Як зрозуміти, що власний формат налаштовано правильно?#

Що формат визначено правильно, зрозумієте з того, що проєкт завантажує всі потрібні елементи, а вихідний фід має очікувану структуру. Критичне місце — правильне зіставлення CHANNEL та ITEM, а також елемента для зіставлення в проєкті. Якщо вихідні дані відповідають потрібному шаблону і не відбувається втрата інформації, конфігурація в порядку.

Що робити, коли створення проєкту з власним форматом завершиться помилкою?#

Перевірте зіставлення власного формату. Частою помилкою в XML-фідах буває неправильно зіставлений кореневий елемент або елемент, що обгортає позицію. Обидва елементи можна зіставити лише один раз, з одним елементом у вашому фіді. Ще одна помилка — неправильно вибраний елемент для зіставлення. Найнадійніше вибрати елемент з ID товарів, комбінований, наприклад, з елементом з EAN-кодами або з URL товарів/зображень. Якщо маєте сумніви, як правильно налаштувати власний формат, варто проконсультуватися щодо налаштування з підтримкою.

2. Де можна створити власний формат і керувати ним#

Власний формат можна визначити в Mergado двома способами: безпосередньо під час створення проєкту або в окремому розділі, призначеному для роботи з власними форматами. Обидва підходи доповнюють один одного і дають змогу створити будь-яке визначення формату, а пізніше використати його знову.

Визначення під час створення проєкту#

Під час створення проєкту можна задати власний формат як для вхідного, так і для вихідного фіду. Ця можливість з’являється щоразу, коли Mergado не може призначити вхідному файлу жодного інтегрованого формату, або коли потрібно створити специфічний вихід.

Власний формат на вході#

До створення власного формату для вхідного фіду ви потрапите на 3-му кроці майстра створення проєкту. Якщо система розпізнає структуру підключеного фіду, вона запропонує змінити виявлений формат кнопкою Select different format, а потім можете або вибрати інший офіційний формат із випадного списку, або саме для вхідного фіду створити власний формат за допомогою кнопки Define custom format.

Якщо система не розпізнає структуру підключеного фіду, вона запропонує або вибрати офіційний формат із випадного списку вручну, або створити для вхідного фіду власний формат за допомогою кнопки Define custom format.

Під час створення власного формату для вхідного фіду система пропонує два підходи:

• Спрощений режим – підходить для швидкого налаштування базової структури.
• Детальне налаштування – дає змогу детально зіставити всі знайдені елементи.

Обидва способи ведуть до однієї мети: визначити, де починається фід, які елементи становлять окремі товари і який елемент містить унікальне значення в усіх товарів.

Для правильної обробки вхідного фіду потрібно зіставити принаймні:

• кореневий елемент (CHANNEL),
• обгортковий елемент товарів (ITEM),
• ідентифікатор товару (ITEM_ID) – елемент з унікальним значенням для кожної позиції.

Звісно, можете зіставити й усі елементи з вхідного фіду, що може полегшити подальшу роботу (наприклад, зменшити кількість потрібних правил). Для самого імпорту даних це, однак, не обов’язково.

Власний формат на виході#

До створення власного формату для вихідного фіду ви потрапите на 4-му кроці майстра створення проєкту. Скористайтеся кнопкою Define custom format. На наступному кроці потрібно вставити URL зразкового фіду, тобто шаблону, за яким налаштується власний формат і за яким буде створено вихідний фід.

Увага. Зразковий фід не можна завантажити як файл, URL-адреса обов’язкова. Тож якщо маєте шаблон як файл, створіть URL-адресу за допомогою хмарного сховища, наприклад Dropbox, або можете скористатися розширенням Mergado Files.

Якщо власний формат у вас уже підготовлений, можете вибрати його як вихідний формат проєкту. Так ви визначите, як виглядатиме фінальний XML або CSV, незалежно від того, чи Mergado цей формат зазвичай підтримує. Якщо формат створено зі зразкового фіду, Mergado збереже кореневі елементи і їх розташування.

Під час створення власного формату для вихідного фіду система пропонує лише один підхід:

• Детальне налаштування – дає змогу детально зіставити всі знайдені елементи.
• Спрощений режим тут недоступний

Для правильного створення вихідного фіду потрібно зіставити принаймні:

• кореневий елемент (CHANNEL),
• обгортковий елемент товарів (ITEM).

У цьому разі Mergado підготує вихідний фід, створить у проєкті всі елементи із шаблону, але оскільки не знає, що окремі елементи означають, елементи не заповнить, і це потрібно налаштувати вручну за допомогою правил.

Звісно, можете зіставити й усі інші елементи зі зразкового фіду, що може полегшити подальшу роботу (наприклад, зменшити кількість потрібних правил).

Розділ «Custom Formats» у головному меню #

Окреме керування власними форматами знайдете в лівому меню Mergado Editor на вкладці Custom formats, якщо перебуваєте на рівні користувача (ліве меню змінюється залежно від того, чи керуєте користувачем, інтернет-магазином або проєктом). Цей розділ слугує центральним місцем для роботи з усіма форматами, створеними в обліковому записі.

Тут можна:

• створити новий формат без прив’язки до конкретного проєкту,
• ввести URL зразкового файлу (example feed),
• виконати зіставлення елементів,
• змінити або повторно проаналізувати наявний формат.

Цей розділ слугує центральним місцем, де можна підтримувати, тестувати й готувати власні формати для використання в інших проєктах.

Повторне використання власних форматів#

Щойно створите власний формат – у майстрі чи в окремому розділі, – він збережеться в Mergado, і ви можете використовувати його скільки завгодно довго, а саме:

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

Якщо у вас уже збережено принаймні один власний формат, під час створення наступного нового власного формату доступна також функція Pre-fill from, яка дає змогу перейняти структуру (налаштоване зіставлення) наявного формату. Це прискорить роботу у випадках, коли працюєте з кількома форматами, що мають подібну схему.

Часті запитання#

Де в Mergado можна створити власний формат?#

Власний формат можна створити двома способами – безпосередньо під час створення проєкту або в окремому розділі Custom Formats у лівому меню. Обидва способи доповнюють один одного і дають змогу підготувати формат або швидко під час роботи над проєктом, або створити його заздалегідь. Після збереження формат доступний для повторного використання в усіх проєктах.

Як створити власний формат на вході під час створення проєкту?#

На 3-му кроці майстра створення проєкту Mergado запропонує створити власний формат тоді, коли не розпізнає структуру фіду або коли ви вручну виберете опцію “Select different format”. Потім можете використати або спрощений режим, або детальне налаштування. Достатньо зіставити CHANNEL, ITEM (для XML-фідів) і в ідеалі також ідентифікатор товару, щоб проєкт міг правильно працювати з позиціями.

Що потрібно зіставити як мінімум, щоб Mergado могло завантажити фід?#

Для мінімальної функціональності потрібно зіставити CHANNEL, ITEM (для XML-фідів) і один елемент з унікальним значенням (найчастіше ITEM_ID). Цього достатньо, щоб Mergado змогло визначити початок документа, окремі товари та їх однозначний ключ. Інші елементи можна доповнити пізніше.

Як створити власний формат на виході?#

Він створюється на 4-му кроці створення проєкту за допомогою опції Define custom format. Потрібно вставити URL зразкового XML-файлу (example feed), за яким Mergado складе структуру виходу. Потім зіставляєте принаймні основні елементи і зберігаєте формат для використання в проєкті.

Чому мені потрібно мати зразковий фід, доступний за URL-адресою?#

Mergado створює вихідний формат виключно з файлу, доступного через URL, бо під час аналізу має імпортувати структуру. Пряме завантаження файлу не підтримується. Якщо не маєте власного хостингу, можете скористатися хмарним сервісом (Dropbox, OneDrive) або створити файл за допомогою Mergado Files.

Чому для вихідного формату не пропонується спрощений режим?#

Для вихідного формату завжди доступне лише детальне налаштування. Це зроблено навмисно, бо цільова структура ґрунтується на зразковому фіді й потрібно повністю контролювати перетворення на шаблон. Спрощене зіставлення для виходу могло б бути недостатньо точним.

Що станеться, якщо під час створення вихідного формату зіставлю лише мінімум?#

Mergado створить вихідний фід із кореневими елементами із шаблону, у проєкті створить порожні елементи за шаблоном, але елементи без зіставлення не будуть заповнені жодними значеннями. Ці значення потім потрібно доповнити вручну правилами. Тому варто доповнити зіставлення для якомога більшої кількості елементів зі зразкового фіду.

Для чого слугує розділ «Custom Formats» у лівому меню? #

Цей розділ слугує для централізованого керування всіма власними форматами в обліковому записі. Тут можна створювати нові формати, змінювати наявні та оновлювати їх структуру. Це найзручніше місце для підготовки форматів, які в майбутньому використовуватимете повторно.

Чи можна використовувати один власний формат у різних проєктах?#

Так, кожен збережений власний формат доступний для повторного використання. Можете використати його на вході й на виході в будь-якій кількості проєктів. Це корисно передусім тоді, коли працюєте з кількома фідами, що мають однакову структуру.

Для чого слугує опція «Pre-fill from» під час створення нового формату? #

Дає змогу перейняти структуру (зіставлення елементів) з раніше створеного власного формату. Ідеально підходить, якщо працюєте з кількома форматами з однаковою або подібною схемою. Завдяки цьому не доводиться з кожним новим форматом починати з нуля.

3. Спрощений режим чи детальне налаштування під час визначення власного формату#

Під час створення власного формату на вході в межах майстра створення нового проєкту можна працювати двома способами: або скористаєтеся спрощеним режимом, або перейдете до детального налаштування. Обидва підходи слугують одній меті – пояснити Mergado структуру фіду, – але відрізняються тим, яку міру контролю і скільки можливостей пропонують користувачеві.

Спрощений режим підходить для швидкої обробки фідів. Детальне налаштування дає повний контроль над зіставленням елементів і конфігурацією формату.

1. Спрощений режим#

Спрощений режим з’являється лише під час створення власного формату на вході в межах майстра створення нового проєкту. Майстер пропонує користувачеві швидкий шлях, як визначити базову структуру. Мета — спростити налаштування власного формату для нових користувачів: запропонувати зіставлення лише найважливіших елементів і приховати розширені налаштування, які можна змінити пізніше.

Коли використовується#

• У межах майстра створення нового проєкту під час налаштування формату вхідного фіду.
• Коли хочете якнайшвидше створити робоче зіставлення.

Що пропонує спрощений режим#

• Відображення основних елементів у зрозумілому вигляді.
• Виділення ключових складників, які використовують рекламні канали.
• Зрозуміліші назви елементів, ніж у технічному поданні.
• Розумне зіставлення, яке намагається автоматично призначити елементи за назвами та змістом.

Як працює розумне зіставлення#

Система запропонує зіставлення — наприклад, description → DESCRIPTION, EAN → EAN, ID → ITEM_ID. Користувач потім лише перевірить правильність пропозицій і за потреби змінить окремі призначення.

Коли спрощений режим ідеальний#

• Коли потрібно швидко почати працювати з даними.
• Коли структура фіду здебільшого дотримується звичайних конвенцій.
• Коли йдеться про одноразове або менш складне зіставлення.

2. Детальне налаштування (повне визначення власного формату)#

Детальне налаштування — це повна версія інтерфейсу для визначення власного формату. Воно містить усі можливості, які можна використати під час зіставлення елементів.

Коли використовується#

• Фід має складну або нетипову структуру.
• Потрібно точно контролювати, як обробляється кожен елемент.
• Готуєте формат для повторного використання або для вихідного фіду.
• Потрібно визначити, що означають піделементи, варіанти або параметри.

Що охоплює детальне налаштування#

1. Параметри власного формату

Загальна конфігурація, яка визначає поведінку формату:

• доречна назва формату,
• налаштування країни (впливає на валюти),
• можливість перейняти налаштування з наявного формату,
• опція розділення варіантів на окремі товари,
• визначення власного дерева категорій.

2. Налаштування обробки даних (зіставлення елементів)

Ключова частина, яка визначає, як Mergado інтерпретує окремі частини фіду.

Основні елементи:

• кореневий елемент (наприклад, CHANNEL)
• обгортковий елемент товарів (наприклад, ITEM)
• ідентифікатор товару (наприклад, ITEM_ID) – елемент з унікальним значенням для кожної позиції

Інші можливості:

• пряме зіставлення з Mergado XML
• операції для елементів без піделементів (Pass as is, Hide, Element meaning)
• спеціальні операції для обгорткових елементів (наприклад, DELIVERY, PARAM, VARIANT)
• можливість зіставити будь-яку кількість елементів для зручнішої подальшої роботи в проєкті

Порівняння подань: спрощений режим і детальне налаштування#

Який підхід вибрати#

• Використайте спрощений режим, якщо потрібно швидко створити проєкт і фід має порівняно зрозумілу структуру.
• Виберіть детальне налаштування, якщо працюєте з комплексним фідом, готуєте шаблон для виходу або потрібно точно визначити, що означають окремі елементи.

Часті запитання#

Що таке спрощений режим під час створення власного формату?#

Спрощений режим — це варіант інтерфейсу на 3-му кроці майстра, який пропонує лише найважливіші елементи та швидший шлях до створення робочого зіставлення. Він розроблений так, щоб не перевантажувати користувача розширеними налаштуваннями і дати змогу швидко почати навіть із невідомими фідами. Пропонує розумне зіставлення, яке автоматично рекомендує призначення елементів за назвами та змістом.

Коли з’являється спрощений режим?#

Він з’являється виключно під час створення власного формату на вході й лише тоді, коли Mergado не розпізнає структуру фіду або користувач вибере визначення власного формату вручну. У таких ситуаціях мета — прискорити базове налаштування так, щоб проєкт був якнайшвидше готовий до роботи. Детальне налаштування можна відкрити будь-коли.

Як працює розумне зіставлення в межах спрощеного режиму?#

Розумне зіставлення намагається автоматично призначити елементи за їх назвою та типовим змістом. Користувач лише перевіряє запропоновані значення і за потреби вручну змінює, який елемент має бути пов’язаний з еквівалентом у Mergado XML. Цей крок значно прискорює роботу передусім зі звичайними або простішими структурами фідів.

Коли варто використати спрощений режим?#

Спрощений режим ідеальний, якщо потрібно швидко почати працювати з даними, а фід має порівняно стандартну структуру. Підходить також тоді, коли йдеться про одноразову обробку або коли не хочете одразу на початку займатися детальним налаштуванням. Якщо фід не містить складної ієрархії, часто достатньо саме цього варіанта.

Що таке детальне налаштування власного формату?#

Детальне налаштування — це повний варіант створення власного формату, який дає змогу зіставляти окремі елементи та їх піделементи з максимальною точністю. Воно також містить усі параметри формату, як-от країна, назва або розділення варіантів, і дає змогу визначити поведінку складніших структур. Цей підхід призначений для фідів із кількома рівнями або для підготовки вихідних форматів.

Коли варто використати детальне налаштування?#

Детальне налаштування — найкращий вибір тоді, коли фід містить складну, нестандартну або багаторівневу структуру. Так само воно підходить, якщо потрібно цілком точно контролювати, як дані оброблятимуться й експортуватимуться в проєкті. Воно також необхідне під час підготовки формату, який використовуватиметься повторно або на виході.

Які елементи потрібно зіставити в обох випадках?#

Хоч би що ви використали — спрощений режим чи детальне налаштування, — завжди потрібно визначити кореневий елемент (CHANNEL) (стосується XML-фідів), обгортковий елемент товару (ITEM) (стосується XML-фідів) і принаймні один ідентифікатор товару (найчастіше ITEM_ID). Ці елементи — ключ до того, щоб Mergado змогло правильно завантажити фід даних і визначити окремі позиції. Зіставлення інших елементів залежить від того, що вам знадобиться в проєкті.

Що детальне налаштування пропонує додатково порівняно зі спрощеним?#

Детальне налаштування дає змогу визначити, що означає кожен елемент і задавати спеціальні операції для елементів з піделементами, наприклад для параметрів, доставки або варіантів. Крім того, містить усі параметри формату і пропонує можливість перейняти структуру з наявного CF. Тож забезпечує найвищу можливу точність перетворення даних.

Який підхід вибрати – спрощений чи детальний?#

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

Чи може спрощений режим замінити детальне налаштування?#

Так, у багатьох простіших випадках його достатньо. Але якщо фід містить варіанти, параметри, багатоступеневу структуру або плануєте подальші експорти, детальне налаштування в результаті буде точнішим і стабільнішим. Тому рекомендується почати зі спрощеного підходу і перейти в детальний режим, якщо виявите, що потрібно більше контролю.

4. Створення власного формату – детальне налаштування#

Детальне налаштування власного формату — це крок, на якому ви точно визначаєте для Mergado, як інтерпретувати структуру вашого фіду. На основі цієї інформації виникає конвертер між вашим форматом даних і Mergado XML. Цей етап настає після аналізу структури джерельного файлу.

Аналіз структури фіду#

Під час створення власного формату Mergado спочатку завантажує й аналізує підключений файл. З його структури визначає, які елементи можна зіставити, і створює їх огляд.

Що робить аналіз#

• завантажує структуру XML або CSV із заданої URL-адреси
• визначає доступні елементи та їх структуру
• готує список елементів, які можна зіставити з Mergado XML

Оновлення структури#

Якщо пізніше у вхідному файлі з’явиться новий елемент, його потрібно доповнити в налаштуваннях власного формату. Для цього слугує опція Update structure from file, яка завантажить нові складники і дасть змогу визначити для них, як вони мають переноситися в Mergado.

Налаштування основних параметрів власного формату#

У цій частині ви визначаєте загальні параметри формату. Ці опції стосуються не окремих елементів, а поведінки формату як цілого.

Доступні параметри#

Зіставлення елементів (налаштування обробки даних)#

Ця частина визначає, як Mergado інтерпретуватиме елементи вашого фіду. Зіставлення визначає зв’язок між конкретним елементом і його еквівалентом у Mergado XML.

Обов’язкові елементи (стосується лише XML)#

Для робочої обробки фіду потрібно зіставити принаймні ці два складники:

• CHANNEL – коренева обгортка всього фіду,
• ITEM – обгортковий елемент однієї позиції.

Без цих двох елементів XML-фід імпортувати не можна.

Рекомендовані елементи#

Mergado дає змогу зіставляти будь-яку кількість інших елементів. Що більше складників зіставите, то менше роботи матимете пізніше з правилами і то краще фід можна перетворювати на інші вихідні формати.

Операції для простих елементів#

Для елементів, які не мають піделементів, можна використати три типи операцій:

Операції для обгорткових елементів#

Для елементів, які мають у собі подальшу структуру, можна вибрати спеціальні операції, що відкривають налаштування для їх піделементів.

Приклади:

• DELIVERY – задаєте ціну доставки, назву чи код перевізника,
• PARAM – визначення параметрів товару,
• VARIANT – робота з окремими варіантами позиції.

Якщо елемент не має піделементів, але містить атрибут (наприклад, <PARAM name="Колір">Червоний</PARAM>, де name — атрибут), Mergado тепер розпізнає його як обгортковий і у випадному списку запропонує як спеціальні операції (PARAM, DELIVERY, VARIANT…), так і звичайні операції / Element meaning. Ви самі виберете, як хочете обробити елемент. Це стосується як детального налаштування власного формату, так і майстра.

Наслідки зіставлення#

• Ширше зіставлення полегшить подальший експорт в інші формати.
• Мінімальне зіставлення вимагає більше роботи в правилах (копіювання та доповнення значень).
• Елементи, розміщені поза ITEM, обробити не можна – Mergado їх ігнорує.

Часті запитання#

Що означає аналіз структури фіду під час створення власного формату?#

Аналіз — це перший крок, на якому Mergado завантажує файл з URL-адреси і визначає всі доступні елементи. З їх ієрархії складає структуру, яку потім пропонує для зіставлення. Цей процес визначає, з чим можна працювати у власному форматі.

Що мені робити, коли у вхідному фіді з’явився новий елемент?#

Потрібно відкрити визначення збереженого власного формату і скористатися опцією «Update structure from file». Так новий елемент завантажиться до списку, і ви зможете визначити, як його слід обробляти в Mergado. Після збереження та перегенерування даних новий елемент стане частиною проєкту.

Для чого слугує основне налаштування власного формату?#

Ці параметри визначають поведінку формату як цілого і не стосуються окремих елементів. Сюди належать назва формату, налаштування країни, опція для роботи з варіантами або активація власного дерева категорій. Правильне налаштування параметрів спростить його подальше використання в інших проєктах.

Чому важливо правильно назвати власний формат?#

Назва формату відображається в списку форматів і полегшує орієнтацію, особливо коли їх у вас кілька. Добре вибрана назва дає змогу швидко визначити, для якого типу фіду формат створено. Так ви запобіжите помилкам під час повторного використання.

Як працює опція «Pre-fill from»? #

Ця опція робить доступними наявні власні формати і дає змогу перейняти їх структуру. Знадобиться, якщо потрібно створити подібний формат або працюєте з фідами з однаковою схемою. Завдяки цьому не доводиться зіставляти все з початку.

Що означають операції «Pass as is», «Hide» і «Element meaning»? #

• «Pass as is» - Елемент імпортується й експортується без змін, якщо правило Converter або користувач не позначить його як прихований.
• «Hide» забезпечить, що елемент імпортується і позначається як прихований. З ним можна працювати в межах правил, під час створення вибірок або за потреби вручну зробити його видимим.
• «Element meaning» слугує для зіставлення елемента з еквівалентом у Mergado XML

Коли варто зіставляти й інші елементи понад обов’язкові?#

Якщо плануєте експорт в інші формати або працюватимете з даними в правилах, детальне зіставлення дуже корисне. Менше зіставлених елементів означає більше роботи під час доповнення значень у проєкті. Що точніше зіставлення, то простіша подальша обробка.

Як працюють спеціальні операції для обгорткових елементів?#

Їх використовують тоді, коли елемент має власну вкладену структуру, наприклад параметри, доставку або варіанти. Вибором спеціальної операції ви відкриєте налаштування для їх піделементів. Це дає змогу детально визначити, як мають оброблятися значення цих структур.

Чому Mergado ігнорує елементи поза ITEM?#

Власний формат уміє працювати лише з тією частиною XML, яку утворюють окремі позиції товарів. Елементи над ITEM, наприклад інформація між CHANNEL та ITEM, не входять до моделі даних товарів. Тому під час імпорту вони ігноруються, і проєкт не має над ними контролю.

Як зрозуміти, що зіставлення достатнє?#

Якщо вдається завантажити фід, працювати з даними без потреби в численних правилах, а експорт відбувається без втрати інформації, зіставлення налаштовано правильно. Критичний момент — охопити всі елементи, які пізніше змінюватимете або експортуватимете. Якщо вам часто доводиться доповнювати значення правилами, зіставлення, імовірно, надто стисле.

Який зв’язок між зіставленням і конвертером?#

Зіставлення визначаєте ви, і саме за ним конвертер перетворює дані на Mergado XML. Якщо якийсь елемент не зіставите, конвертер про нього «не знає» і з ним не працює. Тож добре зіставлення визначає якість усього перетвореного фіду.

Що робити, коли мій елемент не має піделементів, але має атрибут – чи можна зіставити його як PARAM?#

Так. Mergado тепер розпізнає елементи, єдиними «нащадками» яких є атрибути, і пропонує для них у зіставленні як спеціальні операції (PARAM, DELIVERY, VARIANT), так і звичайні операції/Element meaning. Раніше такий елемент можна було зіставити лише як звичайний елемент.

5. Власний формат на вході#

Власний формат на вході слугує для завантаження фідів даних, які Mergado не розпізнає, і для їх перетворення на внутрішню структуру Mergado XML. Завдяки цьому в Mergado можна обробити майже будь-який файл XML або CSV.

Коли використовують власний формат на вході#

Потреба визначити власний формат виникає тоді, коли система не може визначити структуру вхідного фіду і показує інформацію, що формат невідомий. У такій ситуації вона запропонує створити власний формат.

Типові сценарії#

• Фіди постачальників або інакше структуровані XML/CSV,
• Індивідуальні фіди, створені на замовлення. Зазвичай у більших інтернет-магазинів.
• Застарілі або суттєво змінені варіанти відомих форматів,
• Додаткові фіди, наприклад складські або сервісні,
• Фіди, що надають інші типи послуг (відгуки, туристичні пропозиції).
• тощо.

Порядок створення власного формату під час імпорту фіду#

Визначення власного формату відбувається на 3-му кроці майстра створення проєкту.

1. Створіть новий проєкт і вставте URL вхідного фіду.
2. Якщо Mergado структуру не розпізнає, виберіть Define custom format.
3. Зіставте обов’язкові елементи:

• CHANNEL
• ITEM

4. Зіставте інші елементи, з якими працюватимете в проєкті (URL, NAME, ITEM_ID, …).
5. Формат назвіть і збережіть.
6. На 4-му кроці можете

• Залишити той самий власний формат і на виході, тож структура фіду не зміниться.
• Вибрати за допомогою випадного списку інший офіційний формат, наприклад Google, Meta тощо.
• Створити новий власний формат для виходу.

7. На останньому кроці перевірте, чи вибрано елементи для зіставлення. Якщо ні, їх потрібно налаштувати.

Налаштування елемента для зіставлення#

Елемент для зіставлення — це ключова інформація, яку Mergado використовує для однозначної ідентифікації кожної позиції в проєкті.

Що важливо:

• Він має мати унікальне значення для кожного товару.
• Найчастіше використовують елемент з ID товарів або інший однозначний ідентифікатор (URL, EAN,..).
• На кроці з підсумком потрібно перевірити, що елемент для зіставлення вибрано правильно.

Елемент для зіставлення працює як «ідентифікаційний номер» для кожної позиції. Він дає змогу Mergado безпечно відстежувати й обробляти окремі товари незалежно від того, як їх значення змінюються під час роботи.

Скільки елементів зіставляти#

Мінімум – для функціональності#

Для імпорту достатньо зіставити лише обов’язкові елементи (CHANNEL, ITEM і, за потреби, ITEM_ID).

Максимум – для ефективності#

Зіставити більше елементів означає простішу роботу на наступних кроках проєкту.

Переваги детального зіставлення:

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

Приклад наслідків: Якщо не зіставите елемент з назвою товару, вам доведеться пізніше додати його до формату за допомогою правила. Якщо зіставите його вже під час визначення CF, Mergado потім правильно автоматично перенесе його у вихідний фід.

Оновлення структури в разі змін фіду#

Якщо у вхідному фіді з’являться нові елементи, збережений власний формат їх автоматично не перейме. Потрібно:

1. Відкрити відповідний власний формат.
2. Натиснути Update structure from file.
3. Новознайденим елементам призначити спосіб обробки.
4. Зберегти і проєкти з цим власним форматом перегенерувати.

Так ви гарантуєте узгоджену обробку фіду навіть після його змін.

Часті запитання#

Коли потрібно використовувати власний формат на вході?#

Власний формат використаєте тоді, коли Mergado не може розпізнати структуру вхідного фіду і показує інформацію, що формат невідомий. Зазвичай ідеться про фіди постачальників, індивідуальні, застарілі або суттєво змінені фіди. У таких ситуаціях потрібно пояснити Mergado структуру даних, щоб воно змогло їх обробити.

Які типи фідів найчастіше потребують власного формату на вході?#

Найчастіше йдеться про фіди постачальників та індивідуальні фіди, які не мають публічної специфікації або відрізняються від стандартів. Сюди належать також додаткові фіди, наприклад складські, сервісні або фіди, що містять послуги, як-от відгуки чи туристичні пропозиції. Власний формат використовують і для змінених чи застарілих версій загалом відомих форматів.

Як відбувається створення власного формату під час імпорту?#

Створення відбувається на 3-му кроці майстра створення проєкту, де виберете опцію «Define custom format». Потім зіставите обов’язкові елементи CHANNEL та ITEM (для XML-фідів) та інші складники, з якими працюватимете в проєкті. Наприкінці формат збережете.

Що таке елемент для зіставлення і чому він такий важливий?#

Елемент для зіставлення — це дані, які дають змогу Mergado однозначно ідентифікувати кожну позицію. Він має мати унікальне значення для кожного товару – найчастіше це ITEM_ID, URL або EAN. Без правильно налаштованого елемента для зіставлення не можна правильно імпортувати фід ані правильно зіставляти зміни.

Скільки елементів варто зіставити під час визначення власного формату?#

Для базової функціональності достатньо зіставити CHANNEL, ITEM (для XML-фідів) і один унікальний ідентифікатор. Але якщо хочете мінімізувати подальшу роботу, варто зіставити й інші елементи, бо це спростить роботу з правилами і полегшить перетворення на інші вихідні формати. Детальне зіставлення підвищує стабільність і зрозумілість проєкту.

Що станеться, якщо не зіставите деякі важливі елементи?#

Незіставлені елементи в проєкті хоч і з’являться, але Mergado не зможе їх правильно використати, і їх доведеться доповнювати вручну за допомогою правил. Це призводить до більшої трудомісткості й може спричинити помилки під час експорту. Тому точне зіставлення значно полегшить подальшу роботу.

Як діяти, коли у вхідному фіді з’являться нові поля даних?#

Потрібно відкрити визначення власного формату і скористатися опцією «Update structure from file». Mergado завантажить нові елементи, а ви призначите їм спосіб обробки. Потім перегенеруєте проєкт, щоб зміни набули чинності.

Чи можна використати власний формат і тоді, коли Mergado формат розпізнає?#

Так, у деяких випадках може бути вигідно створити власний формат і для розпізнаного фіду, наприклад якщо хочете зберегти початкову структуру або потрібно працювати зі складниками, які стандартний конвертер не бере до уваги. У такому разі просто виберете опцію «Select different format», а потім визначите власний.

Що робити, якщо немає впевненості, що власний формат налаштовано правильно?#

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

6. Використання власного формату на виході#

Власний формат на виході слугує для того, щоб Mergado змогло генерувати товарний фід у такій структурі, яку стандартно не підтримує. Підходить скрізь, де потрібно мати вихідний файл точно відповідно до специфічних вимог платформи, системи або внутрішніх процесів.

Коли використовують вихідний власний формат#

Вихідний власний формат ви використаєте передусім у ситуаціях, коли:

• потрібен фід для платформи, яка не інтегрована в Mergado,
• створюєте підключення до нового каналу електронної комерції,
• працюєте з меншими сервісами порівняння цін або внутрішніми системами з власною структурою даних,
• потрібно досягти конкретної структури кореневих елементів (наприклад, …).

Вихідний власний формат дає змогу визначити вигляд кінцевого фіду так, щоб він точно відповідав потрібному формату.

Що таке зразковий фід і навіщо він потрібен#

Вихідний власний формат створюється на основі зразкового фіду – тобто зразкового файлу XML або CSV, що містить принаймні одну позицію.

Чому зразковий фід важливий#

• Слугує шаблоном, за яким Mergado навчиться, як має виглядати фінальний фід.
• Визначає кореневі елементи, які хочете мати в цільовій структурі.
• Може бути цілком вигаданим – достатньо однієї вигаданої позиції, значення якої неважливі.

Вимоги до зразкового фіду#

• Має бути доступний за URL-адресою.
• Має містити кореневу структуру, яку хочете на виході.
• Може мати мінімальний вміст, наприклад:

<?xml version="1.0" encoding="UTF-8"?> <PRODUCTS> <PRODUCT> <ID>1</ID> </PRODUCT> </PRODUCTS>

Як створити зразковий фід#

Є два способи:

1. Створення файлу вручну#

• підготуєте XML у текстовому редакторі або CSV у табличному редакторі
• збережете його на сервері
• зробите його доступним за URL-адресою

2. За допомогою доповнення Mergado Files#

• активуєте розширення Mergado Files
• створите новий файл
• вставите зразкову позицію, яку отримаєте, наприклад, від сервісів порівняння цін
• збережете його як XML або CSV
• отримаєте URL, яку використаєте під час визначення формату

Mergado Files ідеально підходить, якщо потрібно швидко змінювати або тестувати зразковий фід.

Порядок створення власного формату на виході#

Власний формат для виходу створюється або заздалегідь у розділі Custom Formats у лівому меню на рівні користувача, або безпосередньо під час створення нового проєкту на 4-му кроці майстра.

1. Відкрийте Custom Formats і натисніть New custom format.
2. У поле Source file вставте URL зразкового фіду.
3. Формат назвіть.
4. Зіставте елементи:

• мінімум — налаштування кореневих обгорткових елементів (CHANNEL, ITEM),
• рекомендується зіставити всі елементи, які генеруватимете на виході.

5. Збережіть формат.

Після збереження власний формат стає придатним для повторного використання. У кожному проєкті його можна вибрати як вихідний (і як вхідний) формат.

Як Mergado генерує вихідний фід за власним шаблоном#

Вихідний власний формат визначає фінальну структуру фіду. Під час генерування виходу Mergado:

• використає кореневі елементи точно так, як їх було вказано в зразковому фіді,
• використає визначене зіставлення для перетворення значень з вашого вхідного фіду на кінцевий формат,
• збереже порядок і структуру елементів відповідно до шаблону.

Завдяки цьому можна швидко створити будь-який фід XML або CSV без потреби розробляти нову інтеграцію з боку Mergado.

Ефективність зіставлення#

Хоча для вихідного фіду достатньо зіставити мінімум, вигідніше визначити зіставлення якомога детальніше:

• отримаєте кращий контроль над результатом,
• зменшите потребу в правилах для доповнення значень,
• уможливите простіше повторне використання формату в інших проєктах.

Часті запитання#

Коли має сенс використати власний формат на виході?#

Власний формат на виході використаєте завжди, коли потрібен фід у структурі, яку Mergado стандартно не пропонує. Зазвичай ідеться про підключення до нової платформи, меншого сервісу порівняння цін або внутрішньої системи з власною структурою. Дає змогу точно керувати виглядом вихідного XML або CSV, включно з кореневими елементами.

Що таке зразковий фід (example feed) і для чого він слугує?#

Зразковий фід — це ілюстративний файл XML або CSV, який містить принаймні одну позицію і відповідає цільовій структурі, яку хочете генерувати. За ним Mergado завантажить кореневі елементи, внутрішню структуру і порядок елементів. Слугує шаблоном, за яким потім генерується вихідний фід.

Зразковий фід має бути реальним чи може бути вигаданим?#

Зразковий фід може бути цілком вигаданим – достатньо однієї позиції з мінімумом значень. Важливо, щоб він мав правильну структуру елементів, а не конкретні дані. Значення, як-от ID, назва або ціна, у цьому контексті лише ілюстративні.

Чому зразковий фід має бути доступний за URL-адресою?#

Mergado завантажує структуру безпосередньо з URL, щоб під час аналізу використати її як джерело для визначення формату. Завантажити файл без URL не можна. Якщо не маєте власного хостингу, можете скористатися хмарними сервісами або доповненням Mergado Files.

Як можна створити зразковий фід?#

Або підготуєте XML чи CSV у текстовому/табличному редакторі і збережете його на сервері з публічною URL-адресою, або скористаєтеся розширенням Mergado Files. У Mergado Files створите новий файл, вставите зразкову позицію, збережете його в правильному форматі й отримаєте URL для використання у власному форматі. Другий варіант підходить, якщо потрібно зразковий фід постійно змінювати.

Як відбувається створення власного формату на виході?#

У розділі Custom Formats виберете «New custom format» і як джерельний файл введете URL зразкового фіду. Після аналізу файлу формат назвете і зіставите потрібні елементи, щонайменше CHANNEL та ITEM. Збережений формат потім можна вибрати як вихідний формат у будь-якому проєкті. Або ж можете створити власний формат безпосередньо під час створення нового проєкту на 4-му кроці майстра, натиснувши Define custom format і вставивши URL зразкового фіду. Після збереження власного формату повернетеся назад до майстра, де створений власний формат уже буде вибрано як вихідний формат.

Як Mergado використає власний формат під час генерування вихідного фіду?#

Під час експорту Mergado виходить із шаблону, завантаженого зі зразкового фіду, і зберігає його кореневі елементи та структуру. За допомогою зіставлення перетворює значення з Mergado XML на правильні елементи на виході. Результат — фід у вигляді, який відповідає вашим вимогам, без потреби у власному програмуванні.

Що станеться, якщо у вихідному форматі зіставлю лише мінімум елементів?#

Mergado хоч і створить вихідний фід із правильною структурою, але елементи не будуть заповнені даними. Значення незіставлених елементів доведеться доповнити правилами або іншим налаштуванням у проєкті. Такий підхід робочий, але менш ефективний у разі довготривалого використання.

Чому варто зіставляти якомога більше елементів і на виході?#

Детальне зіставлення дає вам кращий контроль над тим, як дані записуються у вихід, і зменшує кількість правил, які потрібно створювати в проєкті. Водночас спрощує повторне використання того самого формату в інших проєктах. Особливо це вигідно в ситуаціях, коли формат слугує кільком клієнтам або кільком інтернет-магазинам.

Чи можна вихідний власний формат використати і як вхідний?#

Так, щойно формат створено, він доступний у списку форматів для входу й виходу. Це може бути корисно, наприклад, під час перетворень між різними внутрішніми системами або під час перевірки даних.

7. Робота зі складнішими XML-структурами#

Цей розділ описує ситуації, коли фід даних містить складники, розміщені поза звичайною структурою товарів, тобто поза елементом ITEM. У таких фідах власний формат натрапляє на певні обмеження, і потрібно використати альтернативні підходи.

Обмеження власного формату під час імпорту#

Власний формат може працювати лише з елементами, розміщеними всередині вибраного обгорткового елемента позиції (ITEM). Складники, які в ієрархії розташовані над ним або поза ним, Mergado Editor ігнорує.

Інформація між CHANNEL та ITEM#

• Деякі XML-фіди містять додатковий рівень даних між CHANNEL та ITEM (наприклад, категорії, доставка, метадані).
• Ці елементи не є частиною самої позиції, і тому під час імпорту не завантажуються.

Типові приклади проблемних фідів#

• XML-фіди з глобальною інформацією про категорії, збереженою поза товарами.
• Джерела даних, де інформацію про доставку визначено на рівні CHANNEL.
• Комплексні фіди з багатоступеневою структурою між кореневим елементом і окремими позиціями.

Рішення: двопроєктна модель + Blending Bull#

Якщо потрібно зберегти всю структуру XML-фіду, включно зі складниками поза ITEM, можна використати двоетапний підхід:

1. Перший проєкт – містить товари.
2. Другий проєкт – містить додаткову інформацію, яка не є частиною ITEM.
3. Об’єднання – вихідні дані обох проєктів поєднуються за допомогою розширення Blending Bull.

Як працює двопроєктна модель#

Об’єднання за допомогою Blending Bull#

1. Активуйте розширення Blending Bull.
2. У частині Data Sources виберіть виходи обох проєктів.
3. У розділі Files створіть новий вихідний файл, а потім виберіть створені джерела даних із попереднього кроку.
4. За потреби доповніть зміни за допомогою правил.

Чому цей підхід працює#

Кожен проєкт завантажує лише ту частину структури, з якою Mergado вміє працювати. Blending Bull потім дає змогу обидві частини знову поєднати й отримати повний вихід даних.

Редагування кореневих елементів на виході#

Кореневі елементи вихідного фіду в Mergado безпосередньо змінити не можна. Якщо потрібна інша структура обгорткових елементів, є дві альтернативи: зміни через Blending Bull або створення власного шаблону.

Зміни через Blending Bull#

Blending Bull дає змогу працювати з вихідним фідом як із текстовим файлом. Завдяки цьому можна змінювати:

• кореневі елементи,
• заголовок,
• кінцівку,
• назви елементів.

Правила типу «Find and Replace»

За допомогою правил у Blending Bull можна виконати масові зміни назв елементів. Наприклад:

• SHOP → PRODUCTS, SHOPITEM → PRODUCT.

Так можна легко змінити вихідну структуру без втручання в сам проєкт.

Альтернативи Blending Bull (для контролю вихідної структури)#

Існують ще два способи, як вплинути на структуру виходу:

1. Створення шаблону за допомогою власного формату

• Використаєте вигаданий або наявний фід з потрібними кореневими елементами.
• Цей фід використаєте під час створення власного формату для виходу.
• Mergado потім збереже кореневі елементи точно так, як вони були в зразковому фіді (example feed).

2. Запит на додавання нового інтегрованого формату

• Якщо маєте специфікацію цільового формату, можна звернутися до підтримки Mergado.
• Формат може бути додано до офіційно підтримуваних інтеграцій.
• Потім його можна вибрати як звичайний вихідний формат.
• Додавання нового формату, однак, має пройти процес пріоритизації і може тривати довше.

Часті запитання#

Чому Mergado ігнорує деякі елементи у вхідному XML-фіді?#

Власний формат може працювати лише з елементами, розміщеними всередині обгорткового елемента позиції (ITEM). Усе, що поза ним, – наприклад, елементи між CHANNEL та ITEM, – під час імпорту не обробляється. Ця інформація не є частиною даних товарів, і тому редактор її не бачить.

Як зрозуміти, що фід проблемний і потребує спеціального підходу?#

Найпростіше — відкрити вихідний фід і порівняти його з вхідним фідом. Типові приклади — фіди, де категорії, доставка або інші метадані розміщені на рівні CHANNEL або в кількох шарах над ITEM. Якщо після імпорту деякі важливі дані відсутні, це ознака того, що вони розташовані поза структурою, яку Mergado вміє завантажити. У таких ситуаціях потрібно використати альтернативний підхід.

Що таке двопроєктна модель і коли її використовувати?#

Двопроєктну модель використовують, коли потрібно зберегти або обробити частини XML-фіду, які не розташовані під ITEM. Один проєкт завантажує товари, а другий — додаткову інформацію. Потім обидва виходи поєднуються за допомогою розширення Blending Bull.

Як двопроєктна модель працює на практиці?#

У проєкті з товарами зіставляєте CHANNEL та ITEM, що представляє окремі позиції. У проєкті зі специфікаціями залишаєте той самий CHANNEL, але як ITEM вибираєте обгортковий елемент додаткової інформації. Обидва проєкти завантажують той самий вхідний фід, а Blending Bull потім поєднує їх в один вихід.

Чому Blending Bull необхідний для об’єднання складних структур?#

Mergado саме по собі не може скомбінувати дані з двох різних проєктів з різними об’єктами (товарами). Blending Bull створить вихідний файл, до якого можна додати обидва виходи і за потреби ще змінити їх за допомогою правил. Завдяки цьому отримаєте повну структуру даних, яка відповідає початковому фіду.

Для чого слугують правила типу «Find and replace» у Blending Bull? #

За допомогою цих правил можна масово змінювати назви елементів, кореневі теги або частини заголовка й кінцівки. Це рішення для випадків, коли потрібно змінити вихідний фід так, щоб він відповідав специфічному формату. Так можна, наприклад, перейменувати SHOP на PRODUCTS або інші ключові елементи.

Чи можна в Mergado безпосередньо змінити кореневі елементи вихідного фіду?#

Ні, кореневі елементи в стандартному інтерфейсі безпосередньо редагувати не можна. На них можна вплинути або так, що створите власний формат на основі зразкового фіду, або за допомогою змін у Blending Bull. Обидва підходи забезпечать правильний вигляд вихідної структури.

Коли має сенс створити власний шаблон за допомогою вихідного власного формату?#

Якщо маєте чітко задану структуру вихідного XML, наприклад специфікацію партнера або власної системи, вихідний власний формат — найчистіше рішення. Визначивши формат за зразковим фідом, забезпечите, щоб Mergado завжди генерувало дані в потрібному вигляді. Цей підхід найстабільніший для довготривалого використання.

Чи можна попросити про додавання нового офіційного формату в Mergado?#

Так, якщо маєте документацію і чітку специфікацію цільового формату, можете попросити підтримку додати його до офіційних інтеграцій. Цей процес, однак, підлягає пріоритизації і може тривати довше. Якщо результат потрібен швидко, вихідний власний формат або Blending Bull — швидший шлях.

Як зрозуміти, що потрібно використати двопроєктну модель?#

Якщо після імпорту відсутня інформація, розташована поза ITEM, або якщо фід містить кілька рівнів над товарами, двопроєктна модель зазвичай — єдиний спосіб зберегти повну структуру. Так само вона необхідна тоді, коли потрібно поєднати дані товарів із глобальною інформацією, збереженою поза самими позиціями.

8. Пояснення понять#

Mergado XML як універсальна мова#

Mergado XML працює як універсальний проміжний формат, через який Mergado перетворює всі дані товарів. Не потрібно мати для кожного вхідного й вихідного формату окремий конвертер – достатньо однієї спільної структури, у яку дані перекладаються.

Власний формат як словник і граматичні правила#

Власний формат визначає, як окремі елементи вашого фіду «перекласти» в Mergado XML. Це набір правил, який дає змогу Mergado розпізнати структуру майже будь-якого фіду.

Зразковий фід як цільова мова#

Під час створення вихідного формату зразковий фід слугує визначенням того, як має виглядати кінцева структура. Mergado з нього завантажить:

• кореневу структуру,
• назви елементів,
• організацію позицій.

Так отримаєте вихідний фід точно за власною специфікацією.

Приклади перетворень#

• Імпорт (фід постачальника → формат інтернет-магазину)
  • Mergado підготує структуру так, щоб вона була сумісна з форматом інтернет-магазину, включно з цінами, наявністю або параметрами.
• Експорт (внутрішні дані → Heureka, Google, власні платформи)
  • Якщо платформа не пропонує прямого експорту, за допомогою власного формату можна створити вихід, який відповідає потрібній специфікації.