Інтеграція з фідом товарів (XML, Google Merchant)

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

Приклад розмови

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

Важливо: найкращі практики для E-Commerce

Після завершення наведеної нижче інтеграції ознайомтеся з вичерпним посібником з оптимізації вашого чатбота для електронної комерції: Як налаштувати ChatLab для вашого інтернет-магазину

Що надає інтеграція

Пошук товарів за допомогою ШІ - клієнти описують власні потреби своїми словами, а чатбот знаходить відповідні товари у вашому каталозі. Відповідь містить:

• Назву та опис товару
• Ціну (а також акційну ціну, якщо вона є у фіді)
• Зображення товару
• Пряме посилання на сторінку товару у вашому магазині
• Бренд, наявність, GTIN / SKU та інші атрибути з фіду

Категорії - коли фід містить тип товару (наприклад, "Home > Kitchen > Kettles"), чатбот може звузити пошук до певної категорії.

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

Чого інтеграція не надає

Фід - це файл, а не постійне з'єднання з вашим магазином, тому чатбот не може:

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

Картки товарів із дійсним URL товару ведуть на ваш магазин, де клієнт завершує покупку. Для відстеження замовлень оберіть нативну інтеграцію, яка це підтримує. Можливість додавання до кошика також залежить від платформи та налаштувань вітрини; вона доступна не в кожній нативній інтеграції.

Вимоги

• Інтеграція Feed XML, включена до вашого плану
• Доступ до AI Search та ліміт каталогу, призначений чатботу: перевірте доступний обсяг у Shop > Products (Магазин > Товари)
• Відсутність інших підключених інтеграцій магазину до цього самого бота. Ознайомтеся з наслідками, перш ніж відключати наявний магазин.
• Товарний фід у форматі XML Google Merchant (Google Shopping), доступний за публічною адресою https. Підтримуються стиснені фіди (.gz) та фіди, захищені іменем користувача й паролем.

Крок 1: Отримайте товарний фід із вашого магазину

Зверніться до адміністратора вашого магазину, щоб отримати товарний фід XML із полями Google Merchant. Генерація фіду та витрати на можливі розширення залежать від вашої платформи:

• Magento / Adobe Commerce - розширення для фіду Google Shopping (наприклад, з Magento Marketplace) генерує XML за такою адресою, як https://yourstore.com/feeds/google.xml
• IdoSell - відкрийте MARKETING > Produkty i reklamy w Google > Feed produktowy dla Google Shopping do samodzielnego zarządzania reklamami та отримайте URL-адресу фіду. Переконайтеся, що ChatLab може завантажити його, оскільки деякі фіди обмежують доступ лише для призначеного сервісу. Див. посібник IdoSell з Google Shopping та обмеження доступу до фідів.
• OpenCart - якщо ваша версія містить розширення фіду Google Base, увімкніть його у списку розширень фідів і скопіюйте URL-адресу фіду даних; інакше скористайтеся сумісним розширенням для експорту в XML
• BigCommerce - отримайте посилання на завантаження XML із вашого застосунку для експорту фідів. Просте підключення до каналу Google не є посиланням на фід, яке потрібне ChatLab
• Shopware 6 - додайте канал продажу Product comparison, виберіть Google Shopping (XML) як шаблон, налаштуйте експорт і скопіюйте його URL-адресу. Див. посібник з експорту Shopware.
• osCommerce та кастомні сайти - будь-який модуль, який створює фід RSS 2.0 або Atom із товарними атрибутами g:

Кожен проіндексований товар повинен мати унікальний ідентифікатор (за замовчуванням g:id). Назва та посилання на товар настійно рекомендуються: за відсутності назви використовується ідентифікатор, а за відсутності посилання неможливо створити робоче посилання на вітрину. Ціна, зображення, опис, наявність та тип товару значно покращують відповіді.

Крок 2: Підключіть фід у ChatLab

1. Увійдіть у ChatLab і виберіть свого бота
2. Перейдіть на вкладку Connect (Підключення)
3. Натисніть Connect (Підключити) на картці Feed XML
4. Вставте Feed URL (URL-адреса фіду)
5. Якщо фід вимагає авторизації, увімкніть параметр The feed requires a username and password (Фід вимагає ім'я користувача та пароль) і введіть облікові дані
6. За бажанням вкажіть Product language (Мова товарів - дволітерний код мови, яка використовується у фіді)
7. Натисніть Test feed (Тестувати фід) - ChatLab завантажить початок фіду та покаже його формат, кількість елементів для попереднього перегляду (до 2 000 позицій, не обов'язково загальну кількість у фіді), до п'яти зразків товарів і попередження (якщо відсутні ціни, посилання, зображення чи категорії)
8. Натисніть Connect (Підключити)

Якщо автоматичне індексування каталогу ввімкнено та є необхідний доступ до AI Search і ліміт товарів, процес підключення запустить індексування у фоновому режимі. В іншому разі навчіть каталог вручну. Відстежуйте прогрес і помилки в розділі Shop > Products (Магазин > Товари) або Training > E-commerce catalog (Навчання > Каталог e-commerce); саме по собі успішне підключення ще не означає, що товари вже доступні для пошуку.

Крок 3: Нестандартні фіди (зіставлення полів)

Якщо ваш фід не у форматі Google Merchant, ChatLab все одно може його прочитати:

1. Спочатку запустіть Test feed (Тестувати фід) - назви елементів, знайдені у вашому файлі, з'являться у випадаючих списках зіставлення
2. Відкрийте Field mapping for non-standard feeds (Зіставлення полів для нестандартних фідів)
3. Якщо окремий товар позначається не елементом item або entry, введіть назву в поле Product element (Елемент товару)
4. Виберіть елемент для кожного поля: Product identifier (Ідентифікатор товару - обов'язково), Product name (Назва товару), Description (Опис), Product page URL (URL сторінки товару), Image URL (URL зображення), Price (Ціна), Category path (Шлях категорії) тощо
5. Знову запустіть Test feed (Тестувати фід) і перевірте зразки товарів
6. Натисніть Connect (Підключити)

Поля, залишені зі значенням "Default (Google Merchant)", зберігають стандартні назви, тому фід, який відповідає стандарту, взагалі не потребує налаштування зіставлення.

Крок 4: Розклад оновлення

1. Перейдіть до Training > E-commerce catalog (Навчання > Каталог e-commerce)
2. На картці Feed XML натисніть Retrain (Перенавчити)
3. Кнопка Retrain now! (Перенавчити зараз!) негайно оновлює каталог
4. Щоб оновлювати автоматично, оберіть частоту (щодня, раз на тиждень або раз на місяць), день і час, після чого натисніть Schedule retrain (Запланувати повторне навчання)

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

Крок 5: Налаштування дії ШІ

Якщо автоматичне індексування каталогу ввімкнено та є необхідний доступ, під час підключення активується дія Feed XML - AI product search. В іншому разі ввімкніть її вручну та навчіть каталог. Щоб налаштувати її, перейдіть до Settings > Actions (Налаштування > Дії) та відфільтруйте за платформою Feed XML. Ви можете змінити назву дії, інструкції для ШІ та ввімкнути параметр Include product card (Включати картку товару), щоб чатбот отримував повну картку товару замість короткого опису.

Тестування інтеграції

Відкрийте віджет чатбота та спробуйте:

• "Покажіть мені чайники дешевші за 50 доларів" (тестує пошук із фільтром за ціною)
• "Чи є у вас сині бавовняні футболки?" (тестує відповідність за атрибутами)

У відповідях мають відображатися товари з вашого фіду з посиланнями на ваш магазин.

Поради

• Додайте тип товару у фід (g:product_type) у вигляді повного шляху, наприклад "Clothing > Men > T-Shirts" - це стане категорією, за якою чатбот зможе фільтрувати товари
• Зберігайте описи у фіді повними; чатбот використовує їх для зіставлення із запитаннями клієнтів
• Варіанти одного товару повинні мати однаковий item_group_id - ChatLab об'єднує їхні атрибути кольору, розміру, матеріалу та візерунка в один проіндексований товар. Перший елемент визначає ціну та посилання групи, тому перевіряйте деталі конкретних варіантів у вашому магазині
• Якщо ваш фід має великий розмір, стиснений фід (.gz) завантажуватиметься швидше

Встановлення чатбота на ваш магазин

Щоб додати віджет чату на вітрину магазину:

1. У ChatLab відкрийте вкладку Deploy (Розгортання) для вашого бота
2. Оберіть Widget (Віджет) і скопіюйте фрагмент коду
3. Вставте його в шаблон вашого магазину перед закриваючим тегом </body> або скористайтеся налаштуваннями вашої платформи для "custom HTML" чи "scripts"

Пов'язані статті

• Посібник із налаштування для електронної комерції
• Додавання чатбота на ваш вебсайт