Помощник по покупкам Mira AI использует Ваш фид товаров, чтобы рекомендовать товары, отвечать на вопросы о ценах и проверять наличие. Из этого руководства Вы узнаете, какие форматы фидов принимает Mira AI, какие теги он считывает и где найти официальные инструкции по экспорту для самых популярных платформ электронной коммерции.

Мы разделили руководство на следующие разделы:

Фид или веб-скрейпинг не работает? Устранение неполадок с источниками знаний Mira AI

Перед началом

Mira AI принимает стандартные XML-фиды товаров — в том же формате, который большинство платформ электронной коммерции создаёт для Heuréka, Google Shopping, Zboží.cz и подобных торговых площадок. Чем полнее Ваш фид (цена, наличие, описание, ссылка, категория), тем умнее будут рекомендации Mira.

Чтобы добавить фид в Smartsupp:

В конструкторе помощника откройте База знаний → Товары и нажмите Добавить новый источник.
Введите имя источника.
Вставьте полный URL Вашего фида товаров.
На этапе Обновление выберите, как часто должен обновляться фид.

Совет: См. Введение в Mira AI для получения полных инструкций по настройке.

Mira AI автоматически обновляет Ваш фид товаров через равные промежутки времени — изменения цен, обновлённые сведения о наличии и новые товары появляются в чате без необходимости повторно загружать файл.

Примечание: В течение пробного периода автоматическое обновление фида приостановлено. После перехода на более высокий план выберите интервал обновления фида, чтобы включить автоматическое обновление.

Примечание: Mira AI загружает изображения для карточек товаров непосредственно из Вашего XML-фида. Если у товара нет изображения в фиде, Mira использует изображение Open Graph или основное изображение на странице товара — поэтому стоит настроить и их.

Примечание: Если Ваш сервер ограничивает входящие подключения (межсетевой экран, список разрешённых IP-адресов), обязательно разрешите доступ с IP-адресов службы загрузки фидов Smartsupp: 94.130.187.58 и 188.245.65.74. Иначе Mira AI не сможет загрузить Ваш фид товаров.

Эти IP-адреса могут время от времени меняться. Если Ваш фид внезапно перестал обновляться, проверьте актуальный список в этой статье или обратитесь в нашу службу поддержки.

Поддерживаемые форматы фидов

Mira AI поддерживает два стандартных формата фидов товаров — Heuréka и Google Merchant. Оба соответствуют общим правилам XML:

Расширение файла — .xml или .rss.
Самая первая строка должна начинаться с <?xml ...?> или <rss ...>.
Один родительский тег содержит все элементы товаров. Родительский тег может иметь любое имя (например, <SHOP>) — важно только его наличие.
Каждый товар заключён в собственный тег элемента (см. разделы для конкретных форматов ниже).

Минимальная допустимая структура выглядит так:

<?xml version="1.0" encoding="UTF-8"?> <SHOP> <SHOPITEM> ... </SHOPITEM> <SHOPITEM> ... </SHOPITEM> </SHOP>

Важно: Если у товара отсутствует обязательный тег , этот товар целиком исключается из индекса Mira — посетители не увидят его в рекомендациях. Убедитесь, что у каждого товара заполнены все обязательные теги.

Структура фида Heuréka

Для формата Heuréka Mira AI считывает следующие теги. См. Официальную документацию XML-фида Heuréka для ознакомления с полной спецификацией.

Категория	Теги	Примечания
Тег-обёртка элемента (обязательно)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Каждый товар заключён в один из этих тегов.
Описание (обязательно)	`PRODUCTNAME` (или `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Каждый тег должен содержать данные. Пустые теги считаются отсутствующими.
Необязательные	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = в наличии, 1–7 = доступен в течение недели, любое другое значение / отсутствие = недоступен. `PARAM` может повторяться любое количество раз для одного товара.
Изображение	`IMGURL`	Изображение товара, отображаемое на карточке. Если оно отсутствует, Mira использует изображение Open Graph или основное изображение на странице товара.
Игнорируемые	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI пропускает эти теги — Вы можете оставить их в фиде для других инструментов.

Тег PARAM содержит дополнительный атрибут товара в виде пары имя–значение:

<PARAM> <PARAM_NAME>Width</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Структура фида Google Merchant

Для формата Google Merchant Mira AI считывает следующие теги. См. Официальную спецификацию фида Google Merchant для получения полной справочной информации.

Категория	Теги	Примечания
Тег-обёртка элемента (обязательно)	`item`, `entry`, `product`	Каждый товар заключён в один из этих тегов.
Описание (обязательно)	`title`, `description`, `product_type` (или `google_product_category`), `link`, `price`	Для категории используйте `product_type` или `google_product_category` с текстовым названием — числовые ID категорий пока не поддерживаются.
Формат цены	`price`	Допустимый формат: `236 CZK` или `CZK 236`. Валюта обозначается 3-буквенным кодом (CZK, EUR, GBP…).
Необязательные	`availability`	В наличии: `in_stock`, `in stock`. Недоступен: `out_of_stock`, `out of stock`, `preorder`, `backorder`, любое другое значение / отсутствие.
Изображение	`image_link`	Изображение товара, отображаемое на карточке. Если оно отсутствует, Mira использует изображение Open Graph или основное изображение на странице товара.
Игнорируемые	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI пропускает эти теги — Вы можете оставить их в фиде для других инструментов.

Mira также считывает размеры товаров из Вашего фида (тег size ) и может упоминать их при рекомендации товаров. Размеры появляются после обновления фида.

Примечание: Числовые google_product_category ID пока не поддерживаются. Всегда используйте текстовую версию категории — например "Apparel & Accessories > Clothing > Shirts & Tops" — или используйте product_type вместо неё.

Экспорт фида по платформам

Найдите Вашу платформу электронной коммерции в таблице ниже и следуйте официальному руководству по экспорту.

Платформа	Что создаёт	Официальное руководство
Shoptet	XML для Heuréka & Google Shopping из панели администрирования	XML-фиды • XML для Heuréka
Shopsys	Фиды товаров через платформу с документацией для разработчиков	Фиды товаров
Eshop-rychle	Фиды для сервисов сравнения цен	Экспорт товаров
Upgates	Экспорт данных в XML с полной структурой товаров	Экспорт данных • Документация XML
Shoper	Фид товаров Google непосредственно с платформы	Фид Google
Shopware	Google Shopping — прямой экспорт или через дополнения	Прямой экспорт • Дополнения
Shoprenter	Фиды Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping через дополнения	Дополнения
Magento	Google Shopping через расширения	Расширения
WooCommerce	Google Product Feed через дополнения	Дополнения • Рекомендуемые

Что дальше?

Введение в помощника по покупкам Mira AI — настройте Mira AI и добавьте Ваш фид товаров в качестве источника.
Как начать обучение Mira AI — настройте ответы AI с помощью собственных пар вопросов&ответов.
Mira AI - наличие товаров — дайте посетителям возможность проверить, есть ли товар в наличии.
FAQ о помощнике по покупкам Mira AI — часто задаваемые вопросы о Mira AI.

💡 Нужна дополнительная помощь? Обратитесь в нашу Службу поддержки — будем рады помочь!

Другие статьи по теме

Как экспортировать фиды товаров с различных платформ электронной коммерции для помощника по покупкам MiraAI?