Правило: Імпорт файлу даних (CSV / XML)#

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

Додаткові функції#

• Elements to import:
  • All – відсутні елементи правило створить самостійно, наявні перезапише.
  • Existing only – відсутні елементи пропускаються (попередня поведінка).
  • Selected – створюються лише ті елементи, які ви позначите; щойно створені впізнаєте за міткою New.
  • Елемент, який не є дійсним для вашого вихідного формату, створюється як прихований, щоб не зламати експорт.
  • У варіанті All одночасно створюється щонайбільше 50 елементів.
  • 💡 Порада: Якщо в правилі раніше був увімкнений варіант Import only selected elements, після цього релізу він автоматично перетвориться на Selected з тими самими елементами. Але список фіксований – новий стовпець, який з’явиться у файлі пізніше, сам не позначиться; або позначте його вручну, або перемкніть правило на All.
• Matching mode:
  • Key matches exactly – значення елемента для зіставлення в джерелі й у Mergado повністю однакові.
    • Значення з імпортованого файлу зчитується лише тоді, коли значення в імпорті дорівнює значенню елемента для зіставлення в проєкті.
    • Зазвичай використовується для зіставлення за унікальним ID товару.
  • Key is contained – значення елемента для зіставлення частково збігаються.
    • Значення з імпортованого файлу зчитується лише тоді, коли значення для зіставлення з імпорту міститься в значенні елемента для зіставлення в проєкті.
    • Зазвичай використовується під час зіставлення за ключовим словом у назві або категоріями товару.
• Підтримувані типи файлів:
  • XML
  • CSV
  • Google Sheets (через публікацію таблиці як CSV за загальнодоступною URL-адресою)
• Спосіб підключення файлу:
  • Завантаження файлу (upload) – одноразовий імпорт.
    • Якщо дані у файлі зміняться, файл потрібно знову завантажити вручну.
  • Введення URL – динамічне підключення.
    • Якщо дані у файлі зміняться, нові значення зчитаються автоматично під час кожної перегенерації проєкту.
• Роздільник полів:
  • Кома, крапка з комою, вертикальна риска – залежно від формату джерельного файлу (типово кома)

Конкретні приклади#

Приклад 1: Імпорт наявності на складі з XML-фіду наявності Heureka#

Цей приклад показує, як за допомогою правила Data File Import (CSV / XML) збагатити стандартний товарний фід інформацією про наявність товарів із зовнішнього XML-фіду (наприклад, Heureka).

1. Підготовка проєкту перед імпортом – перед самим імпортом проєкт потрібно підготувати так, щоб імпорт потім працював.

• Назви елементів, які хочете імпортувати (або назви стовпців у файлі CSV), мають збігатися з назвами елементів у проєкті, у які записуватимете дані.
• Якщо хочете імпортувати елемент, який у проєкті ще не існує, створювати його заздалегідь не потрібно – у налаштуванні Elements to import виберіть All або Selected, і правило створить його самостійно.
  • Створювати вручну через сторінку Elements потрібно лише у варіанті Existing only.
• Елементи, у які імпортуватимете, можуть бути прихованими – їхня видимість на імпорт не впливає.

2. Створення нового правила:

• Відкрийте сторінку Rules.
• Натисніть кнопку New rule.

3. Вибір типу правила:

• У полі Rule type виберіть варіант Data File Import (CSV / XML).

4. Вибір товарів:

• У полі Query або виберіть All products, або створіть власну Product query для конкретних товарів, до яких хочете застосувати правило.

5. Джерело файлу даних:

• За допомогою перемикача (радіокнопки) виберіть, звідки має зчитуватися файл:
  • Enter URL
    • У поле URL address вставте адресу файлу XML або CSV (наприклад, URL фіду наявності з Heureka).
    • Натисніть кнопку Import.
    • Mergado автоматично визначить, чи це CSV, чи XML, і відповідно пристосує інтерфейс правила.
  • Upload file from computer
    • У полі Data file натисніть кнопку Upload file і виберіть файл на комп’ютері (наприклад, фід наявності Heureka).
    • Mergado знову автоматично розпізнає формат і пристосує налаштування.
    • 💡 Порада: Максимальний розмір завантаженого файлу – 25 МБ.

6. Елемент, що обмежує позицію (лише для імпорту XML):

• У полі Element bounding the item налаштуйте елемент, який у файлі XML обмежує позицію (зазвичай це, наприклад, SHOPITEM або ITEM), разом із вищим кореневим (так званим ROOT) елементом.
  • У нашому випадку використаємо: item_list | item

7. Елемент для зіставлення в поточному проєкті:

• Виберіть елемент із поточного проєкту в Mergado, за яким хочете зіставляти товари з даними з імпортованого файлу, наприклад ID товару: g:id
  • 💡Порада: За можливості вибирайте елемент для зіставлення з вхідного фіду проєкту. Це дасть змогу швидше оцінювати й обробляти правило під час перегенерації проєкту

8. Елемент для зіставлення в імпортованому файлі:

• Виберіть елемент з імпортованого файлу, який містить значення, що відповідають вибраному елементу для зіставлення в поточному проєкті, наприклад атрибут з ID товару у фіді наявності Heureka: @id

9. Зіставляти за вхідними значеннями:

• Прапорець Match by input values типово увімкнений.
  • Якщо він активний, дані зіставляються за початковими значеннями з вхідного фіду проєкту (до будь-якого редагування в Mergado).
  • Якщо його вимкнете, зіставлення відбудеться за значеннями, які вже могли бути змінені іншими правилами.
  • ⚠️ Увага: Вимкнення цього варіанта може сповільнити обробку даних.

10. Розширені налаштування:

• У розділі Advanced settings налаштуйте:
  • Matching mode за допомогою випадного списку
    • у нашому випадку використаємо режим Key matches exactly
  • чи розрізняти великі й малі літери за допомогою прапорця
    • у нашому випадку залишимо прапорець вимкненим

11. Назва правила:

• На останньому кроці введіть назву правила, наприклад Імпорт наявності.

Інші способи використання правила#

• Одноразовий імпорт кодів EAN або інших значень (наприклад: дані GPSR або URL-адреси відсутніх зображень)
• Підключення динамічних значень із Google Sheets до Mergado
  • Дані про ефективність із Google Analytics (кліки, покази, замовлення)
  • Сезонність товарів
  • Складські запаси
• Імпорт custom_label для PPC
• Імпорт даних для сегментації та налаштування custom_label для PPC
• Імпорт закупівельних цін і маржі для автоматичного ціноутворення за допомогою розширення Pricing Fox
• Імпорт перекладів (якщо переклади іншою мовою є в іншому фіді й потрібно перенести їх до Mergado)

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

Для чого слугує правило Data File Import? #

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

Які формати файлів підтримує Mergado?#

• XML (наприклад, фід наявності Heureka)
• CSV (наприклад, табличний експорт із внутрішньої системи або ERP)
• Google Sheets, якщо таблицю опубліковано як CSV за загальнодоступною URL-адресою

💡 Максимальний розмір завантаженого файлу – 25 МБ.

Яка різниця між завантаженням файлу та введенням URL-адреси?#

• Завантаження файлу (upload) – Одноразовий імпорт. Якщо дані у файлі зміняться, файл потрібно знову завантажити вручну.
• Введення URL-адреси – Динамічне підключення. Під час кожної перегенерації проєкту автоматично зчитуються актуальні значення із зовнішнього файлу.
• 💡 Рекомендовано для джерел даних, які регулярно оновлюються (наприклад, наявність, ціни, ефективність).

Що означає «Element bounding the item» під час імпорту XML? #

Цей параметр визначає, який вузол XML становить окремий товар. Наприклад, у фіді Heureka це SHOPITEM, в інших XML-фідах це може бути ITEM або PRODUCT. У Mergado він записується разом із кореневим елементом, наприклад: item_list | item.

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

За допомогою елементів для зіставлення:

• У поточному проєкті виберете елемент, за яким мають зіставлятися товари (наприклад, g:id).
• В імпортованому файлі виберете відповідний елемент або атрибут (наприклад, @id).

💡 Ідеально, коли значення цих елементів унікальні й однакові в проєкті та у файлі.

Яка різниця між режимом «Key matches exactly» і «Key is contained»? #

• Key matches exactly – значення елементів для зіставлення мають бути абсолютно однаковими (123 = 123). Використовується, наприклад, під час зіставлення за ID товарів.
• Key is contained – зіставлення відбувається, якщо значення в елементі для зіставлення з імпорту міститься всередині значення елемента для зіставлення в проєкті (наприклад, 123 міститься в SKU_12345). Підходить для зіставлення за частиною тексту (наприклад, назви або категорії).

Для чого слугує варіант «Match by input values»? #

Цей варіант визначає, чи Mergado під час зіставлення використовуватиме:

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

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

Що означає варіант «Case sensitive» у розширених налаштуваннях? #

Якщо варіант активний, зіставлення враховує різницю між малими й великими літерами.
Наприклад, ABC ≠ Abc.
Якщо залишите його вимкненим (рекомендовано), Mergado ігнорує різницю в регістрі літер.

Що станеться, якщо якогось елемента з імпортованого файлу в проєкті немає?#

Залежить від налаштування Elements to import:

• All – елемент створюється автоматично (і як прихований, якщо він не є дійсним для вашого вихідного формату).
• Selected – створюються лише ті елементи, які ви позначите; щойно створені впізнаєте за міткою New.
• Existing only – елемент пропускається; якщо хочете його імпортувати, потрібно створити його на сторінці Elements вручну (кнопкою New element).

💡 Одночасно можна автоматично створити щонайбільше 50 елементів.

Чи можу я імпортувати кілька значень одночасно (наприклад, наявність, ціну та EAN)?#

Так. Правило Data File Import дає змогу імпортувати кілька стовпців (CSV) або елементів (XML) одночасно, якщо їх правильно зіставлено.

Як використати імпорт для даних із Google Sheets?#

1. У Google Sheets натисніть File → Share → Publish to the web.
2. Виберіть формат CSV і скопіюйте згенеровану URL-адресу.
3. Вставте цю URL-адресу в поле URL address у правилі Data File Import.
4. Під час кожної перегенерації Mergado зчитає актуальні дані з таблиці.

💡 Так можна підключити, наприклад, динамічні мітки, дані про ефективність або щоденні ціни.

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

Після збереження й застосування правил або після перегенерації фіду можна:

• відкрити сторінку Products, знайти конкретний товар і перевірити, що нові дані з’явилися у відповідних елементах,
• або скористатися функцією Rule walkthrough, яка покаже, як дані було зіставлено й зчитано.

💡 Якщо значення не імпортувалися, перевірте назви елементів і ключі для зіставлення.

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

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

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

Так, якщо дані доступні у форматі CSV (або XML). Альтернативне рішення – використати розширення Bidding Fox Elements, яке зчитує ці дані до Mergado автоматично. Наприклад, можна імпортувати кількість кліків, показів або замовлень за ID товару. Так ви збагатите фід метриками ефективності, які потім можна використати для оптимізації стратегій ставок.

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

Перевірте:

1. чи файл доступний (URL загальнодоступна, не вимагає входу),
2. що він має правильне кодування UTF-8,
3. що назви елементів/стовпців відповідають назвам у проєкті,
4. і що зіставлення налаштовано правильно.

💡 Для тестування можна завантажити файл із меншою кількістю позицій і перевірити, чи він правильно зіставляється.

Чи можна використати імпорт і для автоматичного ціноутворення (наприклад, маржа, закупівельні ціни)?#

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

Що станеться з правилами, у яких раніше був увімкнений варіант «Import only selected elements»? #

Після цього релізу такі правила автоматично перетворяться на варіант Selected з тими самими елементами, які досі імпортувалися. Але список фіксований — новий стовпець, який з’явиться в джерельному файлі пізніше, сам не позначиться. Якщо хочете його імпортувати, позначте його вручну або перемкніть правило на варіант All.