Il Mira AI Shopping Assistant usa il tuo feed prodotti per consigliare prodotti, rispondere alle domande sui prezzi e verificare la disponibilità. Questa guida spiega quali formati di feed accetta Mira AI, quali tag legge e dove trovare le istruzioni di esportazione ufficiali delle piattaforme e-commerce più diffuse.

Abbiamo suddiviso la guida nelle seguenti sezioni:

Prima di iniziare

Mira AI accetta feed prodotti XML standard — lo stesso formato che la maggior parte delle piattaforme e-commerce genera per Heuréka, Google Shopping, Zboží.cz e comparatori simili. Più ricco è il tuo feed (prezzo, disponibilità, descrizione, link, categoria), più intelligenti saranno i consigli di Mira.

Per aggiungere il feed in Smartsupp:

Nel builder dell'assistente apri Knowledge base → XML Product feed e clicca su Add new source.
Inserisci un nome per la fonte.
Incolla l'URL completo del tuo feed prodotti.
Nel passaggio Update, scegli con che frequenza aggiornare il feed.

Suggerimento: La configurazione completa è descritta nell'articolo Introduzione a Mira AI.

Mira AI aggiorna automaticamente il tuo feed prodotti a intervalli regolari — variazioni di prezzo, aggiornamenti di disponibilità e nuovi prodotti compaiono in chat senza che tu debba ricaricare il file.

Nota: Mira AI carica le immagini delle schede prodotto direttamente dal tuo feed XML. Se un prodotto non ha immagine nel feed, Mira ricorre all'immagine Open Graph o in evidenza della pagina prodotto — vale quindi la pena configurare anche quelle.

Nota: Se il tuo server limita le connessioni in entrata (firewall, allowlist IP), consenti l'accesso dagli indirizzi IP con cui Smartsupp scarica i feed: 94.130.187.58 e 188.245.65.74. Altrimenti Mira AI non potrà scaricare il tuo feed prodotti.

Formati di feed supportati

Mira AI supporta due formati standard di feed prodotti — Heuréka e Google Merchant. Entrambi seguono le comuni convenzioni XML:

L'estensione del file è .xml o .rss.
La primissima riga deve iniziare con <?xml ...?> o <rss ...>.
Un tag padre racchiude tutti i prodotti. Può chiamarsi in qualsiasi modo (es. <SHOP>) — conta solo che esista.
Ogni prodotto è racchiuso nel proprio tag (vedi le sezioni specifiche per formato qui sotto).

Uno scheletro minimo valido è questo:

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

Importante: Se a un prodotto manca un tag obbligatorio, l'intero prodotto viene escluso dall'indice di Mira — i visitatori non lo vedranno nei consigli. Assicurati che ogni prodotto abbia tutti i tag obbligatori compilati.

Struttura del feed Heuréka

Per il formato Heuréka, Mira AI legge i seguenti tag. Consulta la documentazione ufficiale del feed XML Heuréka per la specifica completa.

Categoria	Tag	Note
Contenitore del prodotto (obbligatorio)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uno di questi tag racchiude ogni prodotto.
Descrizione (obbligatorio)	`PRODUCTNAME` (or `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Ogni tag deve avere un contenuto. I tag vuoti contano come mancanti.
Facoltativo	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = disponibile, 1–7 = disponibile entro una settimana, qualsiasi altro valore / mancante = non disponibile. `PARAM` può ripetersi un numero qualsiasi di volte per prodotto.
Immagine	`IMGURL`	Immagine del prodotto mostrata sulla scheda. Se manca, Mira ricorre all'immagine Open Graph o in evidenza della pagina prodotto.
Ignorati	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI salta questi tag — puoi lasciarli nel feed per altri strumenti.

Un tag PARAM contiene un attributo aggiuntivo del prodotto come coppia nome-valore:

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

Struttura del feed Google Merchant

Per il formato Google Merchant, Mira AI legge i seguenti tag. Consulta la specifica ufficiale del feed Google Merchant per il riferimento completo.

Categoria	Tag	Note
Contenitore del prodotto (obbligatorio)	`item`, `entry`, `product`	Uno di questi tag racchiude ogni prodotto.
Descrizione (obbligatorio)	`title`, `description`, `product_type` (or `google_product_category`), `link`, `price`	Per la categoria usa `product_type` o `google_product_category` con il nome testuale — gli ID numerici di categoria non sono ancora supportati.
Formato del prezzo	`price`	Formato consentito: `236 CZK` o `CZK 236`. La valuta è un codice di 3 lettere (CZK, EUR, GBP…).
Facoltativo	`availability`	Disponibile: `in_stock`, `in stock`. Non disponibile: `out_of_stock`, `out of stock`, `preorder`, `backorder`, qualsiasi altro valore / mancante.
Immagine	`image_link`	Immagine del prodotto mostrata sulla scheda. Se manca, Mira ricorre all'immagine Open Graph o in evidenza della pagina prodotto.
Ignorati	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI salta questi tag — puoi lasciarli nel feed per altri strumenti.

Nota: Gli ID numerici google_product_category non sono ancora supportati. Usa sempre la versione testuale della categoria — ad esempio «Apparel & Accessories > Clothing > Shirts & Tops» — oppure usa product_type.

Esportare il feed per piattaforma

Trova la tua piattaforma e-commerce nella tabella qui sotto e segui la guida ufficiale all'esportazione.

Piattaforma	Cosa genera	Guida ufficiale
Shoptet	XML Heuréka & Google Shopping dal pannello di amministrazione	XML Feeds • Heuréka XML
Shopsys	Feed prodotti a livello di piattaforma con documentazione per sviluppatori	Product Feeds
Eshop-rychle	Feed per i comparatori di prezzo	Product Export
Upgates	Esportazione dati XML con struttura prodotto completa	Data Export • XML Docs
Shoper	Feed prodotti Google direttamente dalla piattaforma	Google Feed
Shopware	Google Shopping — esportazione diretta o tramite componenti aggiuntivi	Direct Export • Add-ons
Shoprenter	Feed Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping tramite componenti aggiuntivi	Add-ons
Magento	Google Shopping tramite estensioni	Extensions
WooCommerce	Google Product Feed tramite componenti aggiuntivi	Add-ons • Recommended

E adesso?

Introduzione al Mira AI Shopping Assistant — configura Mira AI e aggiungi il tuo feed prodotti come fonte.
Come iniziare ad addestrare Mira AI — perfeziona le risposte dell'AI con le tue coppie domanda-risposta.
Mira AI – disponibilità di magazzino — lascia che i visitatori verifichino se un prodotto è disponibile.
FAQ del Mira AI Shopping Assistant — domande frequenti su Mira AI.

💡 Ti serve altro aiuto? Contatta il nostro team di supporto — saremo felici di aiutarti!

Come esportare i feed dei prodotti da varie piattaforme e-commerce per MiraAI