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

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

Прежде чем Вы начнете

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

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

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

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

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

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

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

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

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 считывает следующие теги. См. раздел официальной документации по Heuréka XML фиду для полной спецификации.

Категория	Теги	Примечания
Обёртка элемента (обязательно)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Каждый товар должен быть обёрнут одним из этих тегов.
Описание (обязательно)	`PRODUCTNAME` (или `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Каждый тег должен содержать данные. Пустые теги считаются отсутствующими.
Необязательно	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = в наличии, 1–7 = доступно в течение недели, любое другое значение / отсутствие тега = недоступно. `PARAM` может повторяться любое количество раз для одного товара.
Изображение	`IMGURL`	Изображение товара, отображаемое на карточке. Если оно отсутствует, Mira использует Open Graph или основное изображение на странице товара.
Игнорируется	`ДОСТАВКА`, `EAN`, `ITEM_ID`, `НДС`, `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`, `описание`, `product_type` (или `google_product_category`), `link`, `цена`	Для категории используйте `product_type` или `google_product_category` с текстовым названием — числовые ID категорий пока не поддерживаются.
Формат цены	`цена`	Допустимый формат: `236 CZK` или `CZK 236`. Валюта — это 3-буквенный код (CZK, EUR, GBP…).
Необязательные	`наличие`	В наличии: `in_stock`, `в наличии`. Недоступно: `out_of_stock`, `нет в наличии`, `preorder`, `backorder`, любое другое значение / отсутствие значения.
Изображение	`image_link`	Изображение товара, отображаемое на карточке. Если оно отсутствует, Mira использует Open Graph или основное изображение на странице товара.
Игнорируется	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI пропускает эти теги — Вы можете оставить их в фиде для других инструментов.

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

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

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

Платформа	Что генерирует	Официальная инструкция
Shoptet	Heuréka & Google Shopping XML из админ-панели	XML Feeds • Heuréka XML
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 — точечно настройте ответы ИИ с помощью пользовательских пар Q&A.
Mira AI — наличие товара на складе — позволяет посетителям проверить, есть ли товар в наличии.
FAQ по Mira AI помощнику по покупкам — часто задаваемые вопросы о Mira AI.

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

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

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