Mira AI Shopping Assistant utilizza il tuo feed prodotti per consigliare prodotti, rispondere a domande sui prezzi e verificare la disponibilità. Questa guida spiega i formati di feed supportati da Mira AI, i tag che legge e dove trovare le istruzioni di esportazione ufficiali per le piattaforme e-commerce più popolari.

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 marketplace simili. Più ricco è il tuo feed (prezzo, disponibilità, descrizione, link, categoria), più intelligenti saranno le raccomandazioni di Mira.

Per aggiungere il feed in Smartsupp:

Apri la scheda Mira AI Sources e aggiungi una nuova fonte XML Product feed.
Inserisci un nome per la fonte.
Seleziona il formato del feed (Heuréka o Google Merchant).
Incolla l’URL completo del tuo feed prodotti.

Suggerimento: Per la configurazione completa, consulta Introduzione a Mira AI.

Mira AI aggiorna automaticamente il tuo feed prodotti a intervalli regolari — le variazioni di prezzo, gli aggiornamenti di disponibilità e i nuovi prodotti appaiono in chat senza dover ricaricare il file.

Nota: Le immagini delle schede prodotto mostrate nella chat vengono caricate dalla pagina prodotto (tramite parser di link), non dal feed stesso. Assicurati che le tue pagine prodotto abbiano immagini Open Graph o featured appropriate.

Nota: Se il tuo server limita le connessioni in entrata (firewall, whitelist IP), consenti l’accesso dagli indirizzi IP del feed-fetcher di Smartsupp: 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 convenzioni XML comuni:

L'estensione del file è .xml o .rss.
La prima riga deve iniziare con <?xml ...?> o <rss ...>.
Un tag genitore racchiude tutti gli elementi prodotto. Il nome è libero (es. <SHOP>) — conta solo l'esistenza.
Ogni prodotto è incapsulato nel proprio tag item (vedi sezioni specifiche per formato qui sotto).

Uno scheletro minimo valido ha questo aspetto:

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

Importante: Se un tag obbligatorio è mancante, l'intero prodotto viene escluso dall'indice di Mira — i visitatori non lo vedranno nelle raccomandazioni. 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
Wrapper di item (obbligatorio)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uno di questi tag racchiude ogni prodotto.
Descrizione (obbligatorio)	`PRODUCTNAME` (o `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Ogni tag deve contenere un valore. I tag vuoti contano come mancanti.
Opzionale	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = in stock, 1–7 = disponibile entro una settimana, qualsiasi altro / mancante = non disponibile. `PARAM` può essere ripetuto qualsiasi numero di volte per prodotto.
Ignorati	`DELIVERY`, `EAN`, `ITEM_ID`, `IMGURL`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI salta questi tag — puoi lasciarli nel feed per altri strumenti.

Il tag PARAM trasporta un attributo prodotto aggiuntivo come coppia nome-valore:

<PARAM> <PARAM_NAME>Larghezza</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
Wrapper di item (obbligatorio)	`item`, `entry`, `product`	Uno di questi tag racchiude ogni prodotto.
Descrizione (obbligatorio)	`title`, `description`, `product_type` (o `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 prezzo	`price`	Formato consentito: `236 EUR` o `EUR 236`. La valuta è un codice di tre lettere (EUR, CZK, GBP…).
Opzionale	`availability`	In stock: `in_stock`, `in stock`. Non disponibile: `out_of_stock`, `out of stock`, `preorder`, `backorder`, qualsiasi altro / mancante.
Ignorati	`id`, `gtin`, `checkout_link_template`, `image_link`, `item_group_id`	Mira AI salta questi tag — puoi lasciarli nel feed per altri strumenti.

Nota: Gli ID numerici di google_product_category non sono ancora supportati. Usa sempre la versione testuale della categoria — ad esempio "Apparel & Accessories > Clothing > Shirts & Tops" — o usa product_type al suo posto.

Esportare il feed per piattaforma

Trova la tua piattaforma e-commerce nella tabella seguente e segui la guida di esportazione ufficiale.

Piattaforma	Cosa genera	Guida ufficiale
Shoptet	XML Heuréka e Google Shopping dal pannello di amministrazione	Feed XML • Heuréka XML
Shopsys	Feed prodotti tramite la piattaforma con documentazione per sviluppatori	Feed prodotti
Eshop-rychle	Feed per comparatori di prezzo	Esportazione prodotti
Upgates	Esportazione dati XML con struttura prodotto completa	Esportazione dati • Documentazione XML
Shoper	Feed prodotti Google direttamente dalla piattaforma	Feed Google
Shopware	Google Shopping — esportazione diretta o tramite add-on	Esportazione diretta • Add-on
Shoprenter	Feed Google Shopping e Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping tramite add-on	Add-on
Magento	Google Shopping tramite estensioni	Estensioni
WooCommerce	Google Product Feed tramite add-on	Add-on • Consigliato

Cosa segue?

Introduzione al Mira AI Shopping Assistant — configura Mira AI e aggiungi il tuo feed prodotti come fonte.
Come iniziare ad addestrare Mira AI — affina le risposte dell'IA con coppie Q&A personalizzate.
Mira AI - disponibilità in stock — consenti ai visitatori di verificare se un prodotto è in stock.
Mira AI Shopping Assistant FAQ — domande frequenti su Mira AI.

💡 Hai bisogno di ulteriore aiuto? Contatta il nostro team di supporto — saremo felici di aiutarti!

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