L’assistente agli acquisti Mira AI utilizza il tuo feed prodotti per consigliare articoli, rispondere a domande sui prezzi e controllare la disponibilità. In questa guida trovi i formati di feed supportati da Mira AI, quali tag legge e dove trovare la documentazione ufficiale per esportare il tuo feed dalle piattaforme e-commerce più diffuse.

Abbiamo diviso questa guida in queste sezioni:

Feed o web scraping non funzionano come dovrebbero? Risoluzione dei problemi sulle fonti di conoscenza di Mira AI

Prima di iniziare

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

Per aggiungere il feed su Smartsupp:

Nel builder dell’assistente, vai su Knowledge base → Prodotti e clicca su Aggiungi.
Inserisci un nome per la fonte.
Incolla l’URL completo del tuo feed prodotti.
Nel passaggio Aggiorna, scegli ogni quanto vuoi che il feed venga aggiornato.

Suggerimento: Dai un’occhiata all’Introduzione a Mira AI per scoprire tutte le possibilità di configurazione.

Mira AI aggiorna automaticamente il tuo feed prodotti a intervalli regolari: le modifiche di prezzo, la disponibilità aggiornata e i nuovi prodotti compariranno in chat senza che tu debba caricare nulla a mano.

Nota: Mira AI carica le immagini dei prodotti direttamente dal tuo feed XML. Se un prodotto non ha un’immagine nel feed, Mira utilizza l’Open Graph o l’immagine principale della pagina prodotto: quindi ricorda di inserirla anche lì.

Nota: Se il tuo server limita gli accessi in entrata (firewall, lista IP consentiti), assicurati che gli IP del feed-fetcher di Smartsupp abbiano accesso: 94.130.187.58 e 188.245.65.74. Altrimenti, Mira AI non potrà scaricare il tuo feed prodotti.

Questi indirizzi IP potrebbero cambiare di tanto in tanto. Se il feed smette improvvisamente di aggiornarsi, guarda questo articolo per la lista aggiornata o contatta il nostro supporto.

Formati di feed supportati

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

L’estensione del file è .xml oppure .rss.
La prima riga deve iniziare con <?xml ...?> oppure <rss ...>.
Un tag genitore raccoglie tutti i prodotti. Può avere qualsiasi nome (es. <SHOP>) — l’importante è che ci sia.
Ogni prodotto deve essere racchiuso in un tag suo (vedi sezioni sui formati più sotto).

Ecco un esempio minimo valido:

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

Importante: Se manca anche un solo tag obbligatorio per il prodotto, quel prodotto verrà ignorato da Mira nell’indicizzazione e non sarà visibile nei suggerimenti. Assicurati che ogni prodotto abbia tutti i tag richiesti compilati.

Struttura del feed Heuréka

Per il formato Heuréka, Mira AI legge questi tag. Consulta la documentazione ufficiale XML Heuréka per i dettagli completi.

Categoria	Tag	Note
Contenitore prodotto (obbligatorio)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uno di questi tag avvolge ogni prodotto.
Descrizione (obbligatorio)	`PRODUCTNAME` (o `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Ogni tag deve avere un valore. I tag vuoti sono considerati mancanti.
Facoltativo	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = in stock, 1–7 = disponibile entro una settimana, altri valori o mancante = non disponibile. `PARAM` può essere ripetuto più volte per lo stesso prodotto.
Immagine	`IMGURL`	Immagine del prodotto mostrata sulla scheda. Se manca, Mira usa l’Open Graph o l’immagine della pagina prodotto.
Ignorato	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ignora questi tag: puoi lasciarli per altri strumenti.

Il tag PARAM permette di aggiungere un attributo extra al prodotto in 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 questi tag. Consulta la specifica ufficiale del feed Google Merchant per la guida completa.

Categoria	Tag	Note
Contenitore prodotto (obbligatorio)	`item`, `entry`, `product`	Uno di questi tag avvolge ogni prodotto.
Descrizione (obbligatorio)	`title`, `description`, `product_type` (o `google_product_category`), `link`, `price`	Per la categoria, usa `product_type` o `google_product_category` col nome testuale — gli ID numerici non sono ancora supportati.
Formato prezzo	`price`	Formato accettato: `236 CZK` oppure `CZK 236`. La valuta è sempre con 3 lettere (CZK, EUR, GBP...).
Prezzo scontato (opzionale)	`sale_price`, `sale_price_effective_date`	Se `sale_price` è presente, ha la stessa valuta ed è inferiore a `price`, Mira mostrerà il prezzo scontato nelle risposte, nelle ricerche e sulle card prodotto. Se indichi anche `sale_price_effective_date`, il prezzo promozionale sarà usato solo nel periodo indicato (controllato ogni volta in tempo reale); fuori da quell’intervallo, o se non valido, Mira utilizza il prezzo normale. I feed già caricati recepiscono prezzi scontati al prossimo aggiornamento.
Facoltativo	`availability`	Disponibile: `in_stock`, `in stock`. Non disponibile: `out_of_stock`, `out of stock`, `preorder`, `backorder`, altro o mancante.
Immagine	`image_link`	Immagine del prodotto mostrata sulla scheda. Se manca, Mira usa Open Graph o l’immagine della pagina prodotto.
Ignorato	`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 (tag size) dei prodotti e può inserirle nei suggerimenti: verranno mostrate dopo il prossimo aggiornamento del feed.

Nota: Gli ID numerici di google_product_category non sono ancora supportati. Usa sempre la categoria in testo — ad esempio "Apparel & Accessories > Clothing > Shirts & Tops" — oppure utilizza product_type.

Esporta il feed per piattaforma

Cerca la tua piattaforma e-commerce nella tabella qui sotto e segui la guida ufficiale per l’esportazione del feed.

Piattaforma	Cosa genera	Guida ufficiale
Shoptet	Heuréka & Google Shopping XML dall’amministrazione	Feed XML • Heuréka XML
Shopsys	Feed prodotti dalla piattaforma con documentazione per sviluppatori	Feed prodotti
Eshop-rychle	Feed per motori di confronto prezzi	Esportazione prodotti
Upgates	Esportazione XML con struttura prodotto completa	Esportazione dati • Documenti XML
Shoper	Feed Google prodotti direttamente dalla piattaforma	Google Feed
Shopware	Google Shopping — esportazione diretta o tramite plugin	Esportazione diretta • Plugin
Shoprenter	Feed Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping tramite plugin	Plugin
Magento	Google Shopping tramite estensioni	Estensioni
WooCommerce	Feed Google prodotti tramite plugin	Plugin • Consigliato

E ora?

Introduzione all’assistente agli acquisti Mira AI — configura Mira AI e aggiungi il feed come fonte.
Come iniziare ad addestrare Mira AI — personalizza le risposte di Mira con domande e risposte create da te.
Mira AI - disponibilità prodotti — consenti ai tuoi visitatori di verificare se un prodotto è disponibile in tempo reale.
FAQ assistente agli acquisti Mira AI — tutte le domande frequenti su Mira AI.

💡 Hai bisogno di aiuto? Contatta il nostro team di supporto: siamo qui per darti una mano!

Come esportare feed di prodotti da varie piattaforme e-commerce per l’assistente agli acquisti MiraAI?