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

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

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

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

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

Чтобы добавить продуктовый фид в 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 AI — посетители не увидят его в рекомендациях. Проверьте, что у каждого товара указаны все обязательные теги.

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

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

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

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

<PARAM> <PARAM_NAME>Ширина</PARAM_NAME> <VAL>100–109 см</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`. Также допускаются десятичные и тысячные разделители, например, `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` или `1 049,00 CHF`. Валюта — 3-х буквенный код (CZK, EUR, GBP…).
Цена со скидкой (необязательно)	`sale_price`, `sale_price_effective_date`	Если задан `sale_price` (в той же валюте и ниже `price`), Mira AI будет использовать скидочную цену в ответах, поиске и карточках товаров. `sale_price_effective_date` указывает, когда скидка действует; за его пределами используется обычная цена. Существующие продуктовые фиды подхватывают скидки при следующем обновлении.
Дополнительно	`availability`	В наличии: `in_stock`, `in stock`. Нет в наличии: `out_of_stock`, `out of stock`, `preorder`, `backorder`, все остальные и неуказанные.
Изображение	`image_link`	Изображение товара на карточке. Если изображение отсутствует, Mira AI использует Open Graph или главное изображение на странице товара.
Игнорируется	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI пропускает эти теги — их можно оставить для других инструментов.

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

Примечание: Числовые ID google_product_category ещё не поддерживаются. Используйте всегда текстовое название категории — например, "Одежда и аксессуары > Одежда > Рубашки и топы", или product_type.

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

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

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

Что дальше?

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

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

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

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