L'Assistente agli acquisti Mira AI utilizza il feed dei tuoi prodotti per suggerire prodotti, rispondere a domande sui prezzi e verificare la disponibilità. Questa guida spiega i formati di feed accettati da Mira AI, i tag che legge e dove trovare le istruzioni ufficiali di esportazione per le piattaforme e-commerce più diffuse.

Abbiamo suddiviso la guida nelle seguenti sezioni:

Il feed o il web scraping non funzionano? Risoluzione dei problemi delle fonti di conoscenza di Mira AI

Prima di iniziare

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

Per aggiungere il feed in Smartsupp:

Nel builder dell'assistente, apri Knowledge Base → Products e fai clic su Aggiungere.
Inserisci un nome per la fonte.
Incolla l'URL completo del feed dei tuoi prodotti.
Nel passaggio Aggiornare, scegli con quale frequenza deve essere aggiornato il feed.

Suggerimento: Consulta Introduzione a Mira AI per la configurazione completa.

Mira AI aggiorna automaticamente il feed dei prodotti a intervalli regolari — modifiche di prezzo, aggiornamenti sulla disponibilità e nuovi prodotti vengono mostrati in chat senza che tu debba ricaricare il file.

Nota: Mira AI carica le immagini delle schede prodotto direttamente dal feed XML. Se un prodotto non ha immagine nel feed, Mira utilizza quella Open Graph o l'immagine in evidenza nella pagina del prodotto — quindi è utile impostarle anche lì.

Nota: Se il server limita le connessioni in entrata (firewall, allowlist IP), assicurati di consentire 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 feed dei tuoi prodotti.

Questi indirizzi IP potrebbero occasionalmente cambiare. Se il feed smette improvvisamente di aggiornarsi, controlla questo articolo per l'elenco aggiornato o contatta il nostro supporto.

Formati dei feed supportati

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

L'estensione del file è .xml o .rss.
La primissima riga deve iniziare con <?xml ...?> oppure <rss ...>.
Un tag padre racchiude tutti gli articoli di prodotto. Il tag padre può avere qualsiasi nome (es. <SHOP>) — conta solo che esista.
Ogni prodotto è racchiuso nel proprio tag item (vedi le sezioni specifiche per il formato qui sotto).

Uno scheletro minimo valido è il seguente:

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

Importante: Se manca un tag obbligatorio in un prodotto, tutto quel prodotto viene saltato dall'indice di Mira — i visitatori non lo vedranno tra i suggerimenti. Assicurati che ogni prodotto abbia tutti i tag richiesti compilati.

Struttura del feed Heuréka

Per il formato Heuréka, Mira AI legge i seguenti tag. Vedi la Documentazione ufficiale XML feed di Heuréka per la specifica completa.

Categoria	Tag	Note
Item Wrapper (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 dati. I tag vuoti sono considerati mancanti.
Volontari	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = disponibile, 1–7 = disponibile entro una settimana, altro / mancante = non disponibile. `PARAM` può ripetersi più volte per prodotto.
Immagine	`IMGURL`	Immagine del prodotto mostrata nella scheda. Se manca, Mira utilizza la Open Graph o l'immagine in evidenza nella pagina del prodotto.
Ignorati	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ignora 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>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
Item Wrapper (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 in testo — gli ID numerici della categoria non sono ancora supportati.
Formato prezzo	`price`	Formato consentito: `236 CZK` o `CZK 236`. Sono accettati anche separatori decimali e delle migliaia, esempio `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` o `1 049,00 CHF`. La valuta è un codice di 3 lettere (CZK, EUR, GBP…).
Prezzo in offerta (opzionale)	`sale_price`, `sale_price_effective_date`	Se `sale_price` è presente, nella stessa valuta e inferiore rispetto a `price`, Mira cita il prezzo in offerta nelle risposte, nelle ricerche e nelle schede prodotto. Con `sale_price_effective_date` il prezzo in offerta viene usato solo in quell'intervallo di date (controllato al momento della domanda); al di fuori, o se l'intervallo non è leggibile, Mira utilizza il prezzo regolare. I feed già esistenti rilevano il prezzo in offerta al prossimo aggiornamento.
Volontari	`availability`	Disponibile: `in_stock`, `in stock`. Non disponibile: `out_of_stock`, `out of stock`, `preorder`, `backorder`, altro / mancante.
Immagine	`image_link`	Immagine del prodotto mostrata nella scheda. Se manca, Mira utilizza la Open Graph o l'immagine in evidenza nella pagina del prodotto.
Ignorati	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ignora questi tag — puoi lasciarli nel feed per altri strumenti.

Mira legge anche le taglie dei prodotti dal feed (tag size) e può menzionarle quando consiglia articoli. Le taglie appariranno quando il feed verrà aggiornato.

Nota: Gli ID numerici google_product_category non sono ancora supportati. Usa sempre la versione testuale della categoria — ad esempio "Abbigliamento e accessori > Abbigliamento > Magliette e top" — oppure product_type.

Esporta feed per piattaforma

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

Piattaforma	Cosa genera	Guida ufficiale
Shoptet	Heuréka & Google Shopping XML dal pannello admin	XML Feed • Heuréka XML
Shopsys	Feed dei prodotti tramite piattaforma con documenti sviluppatori	Product Feeds
Eshop-rychle	Feed per motori di comparazione prezzi	Esportazione prodotti
Upgates	Esportazione dati XML con struttura prodotto completa	Esportazione dati • Documenti XML
Shoper	Feed prodotto Google direttamente dalla piattaforma	Google Feed
Shopware	Google Shopping — esportazione diretta o tramite componenti aggiuntivi	Esportazione diretta • Componenti aggiuntivi
Shoprenter	Feed Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping tramite componenti aggiuntivi	Componenti aggiuntivi
Magento	Google Shopping tramite estensioni	Estensioni
WooCommerce	Google Product Feed tramite componenti aggiuntivi	Componenti aggiuntivi • Consigliati

E ora?

Introduzione a Mira AI Shopping Assistant — configura Mira AI e aggiungi il feed prodotto come fonte.
Come iniziare ad addestrare Mira AI — personalizza le risposte AI con coppie di Q&A personalizzate.
Mira AI - disponibilità prodotti — consenti ai visitatori di verificare se un prodotto è disponibile.
FAQ Assistente Mira AI Shopping — domande frequenti su Mira AI.

💡 Serve ancora aiuto? Contatta il nostro team di supporto — siamo felici di aiutarti!

Come esportare i feed dei prodotti da diverse piattaforme e-commerce per MiraAI Shopping Assistant?