Імпорт файлу з товарами
Імпорт файлу використовується для завантаження товарів у проєкт Rozbind для подальшої автоматичної обробки. Під час імпорту відразу задаються стартовий статус товарів, теги, категорія та режими, у яких сервіс має опрацювати завантажені записи.
Підтримуються файли форматів .csv, .xlsx та .xls розміром до 10 МБ. Файл повинен містити рядок заголовків і хоча б один рядок даних. Замість файлу дані можна вставити як CSV-текст безпосередньо у вікні імпорту.
Імпорт виконується у чотири кроки: Джерело → Колонки → Параметри → Підтвердження. Між кроками можна вільно повертатися назад, доки імпорт не запущено.
Крок 1. Джерело
Кнопка “Імпорт” у верхній частині сторінки проєкту відкриває вікно “Імпорт CSV / XLSX”.
Перед завантаженням варто переконатися, що в лівому меню вибрано правильний проєкт: записи створюються саме в тому проєкті, який відкритий у момент імпорту.
Дані додаються одним із двох способів:
Файл — натиснути на область завантаження та вибрати файл на комп'ютері або перетягнути його в цю область;
Текст — вставити вміст CSV у текстове поле.
Якщо у файлі є колонка з назвою prompt, сервіс розпізнає її як назву товару автоматично, і крок із прив'язкою колонок можна пройти без змін.
Крок 2. Колонки
На цьому кроці визначається, які колонки файлу стануть назвою товару, зовнішнім ідентифікатором, категорією та content.
Обов'язкове поле одне — назва товару. Решта полів заповнюються за потреби.
Крок має два режими, які перемикаються посиланням унизу вікна. Спрощений режим підходить для більшості прайсів, розширений — для файлів зі складною структурою.
Унизу обох режимів відображається таблиця попереднього перегляду з колонками product, content, id_external, rozetka_product_id та category. Вона показує, як виглядатимуть записи після імпорту, ще до його запуску.
Спрощений режим
Для кожного поля запису зі списку вибирається відповідна колонка файлу:
Назва товару — основна назва, обов'язкове поле;
Контент — колонка з описом або характеристиками, які передаються моделі як додаткова інформація;
ID external — зовнішній ідентифікатор товару: код постачальника, артикул або внутрішній ID із файлу;
ID категорії — внутрішній код категорії, якщо він є у вихідних даних;
Назва категорії — колонка з назвою категорії, якщо вона вже вказана у файлі постачальника;
Rozetka product ID — ідентифікатор товару, який уже існує в каталозі Rozetka.
Кнопка “Авто-підбір” заповнює всі відповідності самостійно, орієнтуючись на заголовки колонок. Після автоматичного підбору результат варто перевірити в таблиці попереднього перегляду.
Розширений режим
У розширеному режимі поля заповнюються не однією колонкою, а шаблоном із плейсхолдерів. Це потрібно, коли значення складається з кількох колонок або потребує додаткового тексту.
Плейсхолдери. У верхній частині блоку відображається список плейсхолдерів — по одному на кожну колонку файлу. Назви формуються автоматично із заголовків. Плейсхолдер — це змінна, яка під час імпорту замінюється значенням із відповідної колонки поточного рядка. Наприклад, {Артикул} для кожного товару підставить значення з колонки «Артикул».
Шаблон product_name. Визначає назву товару після імпорту. Зазвичай сюди підставляється колонка з основною назвою від постачальника. Якщо назву потрібно зібрати з кількох колонок, у шаблоні вказується кілька плейсхолдерів поспіль — наприклад, {Виробник} {Назва} {Артикул}. У результаті сформується одна назва з об'єднаних значень.
Шаблон id_external. Використовується для зовнішнього ідентифікатора товару: внутрішнього ID постачальника, коду товару або унікального ідентифікатора з файлу. Це дозволяє зберегти зв'язок між записом у Rozbind і рядком у вихідному файлі.
Шаблон category назва. Передає назву категорії, якщо вона вже міститься у файлі постачальника. Якщо категорія визначатиметься автоматично або була вибрана на кроці «Параметри», поле можна залишити порожнім.
Шаблон category ID. Необов'язкове поле. Застосовується лише тоді, коли у вихідних даних уже є внутрішній код категорії.
Шаблон rozetka_product_id. Заповнюється тільки для товарів, які вже існують у каталозі Rozetka та мають свій ID. Для нових товарів поле не використовується.
Шаблон content. Формує додатковий інформаційний блок про товар — саме ці дані модель отримує як допоміжний матеріал під час обробки. Кнопка «Вставити всі в content» одним натисканням додає в шаблон усі колонки файлу. Якщо якась інформація не має практичної цінності для обробки, відповідний блок із шаблону можна видалити — тоді ці дані не потраплять у запис.
Шаблони конвертера зберігаються між імпортами: під час наступного завантаження поля вже будуть заповнені попередніми налаштуваннями. Якщо структура нового файлу відрізняється, шаблони потрібно оновити вручну або скористатися спрощеним режимом.
Крок 3. Параметри
На цьому кроці задається, що станеться з товарами після завантаження.
Стартовий статус
Чорновик. Товари створюються в проєкті, але не потрапляють у чергу обробки. Такий варіант використовується, коли перед запуском потрібно перевірити імпортовані дані, доповнити content, уточнити категорію або налаштувати режими вручну.
Очікує (звичайний запуск). Товари автоматично отримують статус «Очікує» та додаються до черги на обробку відповідно до вибраних режимів. Це стандартний варіант для підготовлених прайсів.
Тег для всіх записів
Поле призначає спільний тег усім товарам поточного імпорту. Тегом може бути назва постачальника, номер партії, дата завантаження або будь-яке інше службове позначення.
Теги суттєво спрощують подальший пошук і фільтрацію: за тегом можна швидко відібрати конкретне завантаження серед тисяч записів проєкту, поставити його в чергу масово або експортувати окремо.
Категорія
Категорія застосовується до всіх записів партії, якщо колонки файлу її не перевизначають. Поле необов'язкове.
Якщо файл містить товари лише однієї категорії, її варто вказати одразу. Це прискорює обробку, зменшує кількість помилок визначення категорії та знижує навантаження на AI-обробку.
Якщо у файлі товари з різних категорій або категорія невідома, поле залишають порожнім і вмикають режим “Пошук категорії”.
Режими обробки
Режими визначають, які саме дії сервіс виконає із завантаженими товарами. Вони поділені на три групи, між якими є залежності.
ПІДГОТОВКА. Виконується першою. Якщо категорії немає, вмикається автоматично.
Пошук категорії — визначає категорію Rozetka за назвою й описом товару. Потрібен, коли категорія ще невідома: без неї підбір характеристик і генерація не мають з чим працювати.
ОСНОВНІ. Дають результат самі по собі, потрібен хоча б один із них.
Підбір характеристик — зіставляє дані товару з довідником характеристик Rozetka та заповнює їх значеннями з довідника. Це основний режим, саме він дає заповнені характеристики;
Генерація SEO-назви для Rozetka — складає назву товару за правилами Rozetka, з урахуванням бренду, типу й ключових характеристик;
Генерація структурованого HTML-опису для Rozetka — складає структурований опис картки на основі характеристик і матеріалу товару;
Ймовірні характеристики (raw params) — витягує з тексту пари «назва — значення» як вони є, без звірки з довідником Rozetka. Корисно, коли характеристики описані словами й потрібно побачити їх списком.
ПІДСИЛЮВАЧІ. Збагачують основний прохід, окремо нічого не дають. Залишаються недоступними, доки не увімкнено хоча б один основний режим.
Пошук інформації про товар в інтернеті — шукає характеристики у відкритих джерелах і додає знайдене до матеріалу товару. Має сенс, коли даних від постачальника бракує;
Розпізнавання зображень товару — аналізує фотографії й дістає з них те, чого немає в тексті: колір, форму, комплектацію. Працює поверх підбору характеристик і потребує зображень у матеріалі товару.
Крок 4. Підтвердження
На останньому кроці показано підсумок імпорту: кількість записів, стартовий статус, вибрана категорія та перелік увімкнених режимів. Нижче — прев'ю перших рядків у тому вигляді, у якому вони потраплять у проєкт.
Поле «Ліміт записів» дозволяє завантажити лише частину рядків файлу; порожнє поле означає всі рядки. Це зручно для пробного імпорту: спочатку завантажити кілька позицій, перевірити результат обробки й лише потім запускати повний файл.
Перед запуском варто ще раз звірити підсумок і прев'ю — після створення записів змінити стартові налаштування партії вже не вийде.
Кнопка «Імпортувати» створює записи в проєкті; у її назві відображається кількість записів, які буде завантажено.
Дані обробляються на стороні браузера й надсилаються на сервер частинами. Якщо завантаження обірветься, кнопку можна натиснути ще раз — імпорт продовжиться з місця збою, без дублювання вже створених записів.
Після імпорту
Створені записи з'являються у списку товарів проєкту. Знайти конкретне завантаження серед інших товарів найпростіше за тегом, який був заданий під час імпорту.
Якщо товари завантажувалися зі статусом «Чорновик», їх потрібно окремо відправити в роботу: вибрати записи чекбоксами й скористатися масовою дією “В чергу” або відкрити картку окремого товару, вибрати режими та натиснути “Запустити”.
Якщо товари завантажувалися зі статусом “Очікує”, обробка почнеться автоматично. Її стан видно в пігулці стану черги у верхній частині сторінки проєкту.
Після завершення обробки результат варто вибірково перевірити на кількох товарах партії — особливо якщо файл завантажувався вперше або зі зміненою структурою.
У відео нижче покроково показано, як імпортувати файл із товарами в Rozbind.