L’assistente agli acquisti Mira AI utilizza il tuo product feed per suggerire prodotti, rispondere a domande su prezzi, disponibilità e molto altro. In questa guida trovi i formati di feed accettati da Mira AI, i tag che vengono letti e dove consultare le istruzioni ufficiali di esportazione per le principali piattaforme e-commerce.

Abbiamo diviso la guida in queste sezioni:

Non funziona il feed o il web scraping? Come risolvere i problemi delle fonti di conoscenza di Mira AI

Prima di iniziare

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

Per aggiungere il feed su Smartsupp:

Nel builder dell’assistente, apri Base di conoscenza → Prodotti e clicca su Aggiungi.
Scegli un nome per la fonte.
Incolla l’URL completo del tuo product feed.
Al passaggio Aggiorna, scegli ogni quanto aggiornare il feed.

Consiglio: Guarda Introduzione a Mira AI per una panoramica completa della configurazione.

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

Nota: Mira AI carica le immagini delle product card direttamente dal tuo product feed XML. Se manca l’immagine, Mira prende quella Open Graph o la principale dalla pagina del prodotto — quindi ti conviene impostarle anche lì.

Nota: Se il tuo server limita l’accesso in ingresso (firewall o whitelist), assicurati di consentire l’accesso dagli indirizzi IP del feed-fetcher Smartsupp: 94.130.187.58 e 188.245.65.74. Altrimenti Mira AI non potrà scaricare il tuo product feed.

Gli IP possono cambiare nel tempo. Se di punto in bianco il feed non si aggiorna più, controlla questo articolo per la lista aggiornata o scrivici pure.

Formati di product feed supportati

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

L’estensione del file è .xml o .rss.
La primissima riga deve cominciare con <?xml ...?> oppure <rss ...>.
Un tag principale racchiude tutti i prodotti. Il nome può essere qualsiasi (es. <SHOP>) — basta che ci sia.
Ogni prodotto è racchiuso nel suo tag (vedi le sezioni dedicate qui sotto).

Uno scheletro minimo valido potrebbe essere così:

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

Importante: Se in un prodotto manca anche solo un tag obbligatorio, quel prodotto viene ignorato da Mira — i visitatori non lo troveranno tra le raccomandazioni. Verifica sempre di compilare tutti i tag obbligatori.

Struttura product feed Heuréka

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

Categoria	Tag	Note
Contenitore prodotto (obbligatorio)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uno di questi tag deve racchiudere ogni prodotto.
Descrittori (obbligatorio)	`PRODUCTNAME` (o `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Tutti questi tag devono contenere un valore: se vuoti vengono considerati mancanti.
Facoltativi	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = disponibile, 1–7 = disponibile entro una settimana, qualsiasi altro valore/mancante = non disponibile. `PARAM` può comparire più volte per prodotto.
Immagine	`IMGURL`	Immagine mostrata sulla product card. Se manca, Mira usa quella Open Graph o la principale presente sulla pagina.
Ignorati	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ignora questi tag — puoi lasciarli per eventuali altri strumenti.

Il tag PARAM aggiunge un attributo prodotto come coppia nome–valore:

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

Struttura product feed Google Merchant

Per Google Merchant, Mira AI legge i seguenti tag. Consulta la specifica ufficiale del product feed Google Merchant per tutti i dettagli.

Categoria	Tag	Note
Contenitore prodotto (obbligatorio)	`item`, `entry`, `product`	Ognuno di questi tag può racchiudere i tuoi prodotti.
Descrittori (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 — i codici numerici delle categorie, per ora, non sono supportati.
Formato prezzo	`price`	Formato accettato: `236 CZK` o `CZK 236`. Si leggono anche i separatori decimali e delle migliaia, tipo `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` o `1 049,00 CHF`. La valuta dev’essere a 3 lettere (CZK, EUR, GBP ecc.).
Prezzo promozionale (opzionale)	`sale_price`, `sale_price_effective_date`	Se `sale_price` esiste, ha la stessa valuta e un importo inferiore rispetto a `price`, Mira userà il prezzo scontato nelle risposte, nelle ricerche prodotto e nelle product card. Se c’è `sale_price_effective_date`, il prezzo promozionale si vede solo in quel periodo (verifica in tempo reale). Fuori da quell’intervallo, o se la data non è recuperabile, Mira mostra il prezzo standard. Se aggiorni i feed, eventuali modifiche ai prezzi compariranno dopo il successivo aggiornamento.
Facoltativi	`availability`	Disponibile: `in_stock`, `in stock`. Non disponibile: `out_of_stock`, `out of stock`, `preorder`, `backorder`, altri valori o se mancante.
Immagine	`image_link`	Immagine visualizzata nella product card. Se manca, Mira considera l’Open Graph o la principale sulla pagina.
Ignorati	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ignora questi tag: puoi lasciarli nel feed per altre integrazioni.

Mira legge anche le taglie dai tuoi feed (tramite il tag size) e può citarle quando consiglia i prodotti. Le taglie saranno visibili dopo l’aggiornamento del feed.

Nota: I codici numerici per google_product_category non sono ancora supportati. Usa sempre la versione in testo della categoria, ad esempio "Abbigliamento e accessori > Abbigliamento > Camicie e top", oppure product_type.

Esporta product feed per piattaforma

Cerca la tua piattaforma e-commerce qui in basso e segui la guida ufficiale per esportare il product feed.

Piattaforma	Cosa esporta	Guida ufficiale
Shoptet	Heuréka & Google Shopping XML dal pannello di amministrazione	Feed XML • Heuréka XML
Shopsys	Product feed via piattaforma con documentazione tecnica	Product feed
Eshop-rychle	Feed per comparatori di prezzi	Esportazione prodotti
Upgates	Export dati XML con tutta la struttura prodotto	Esportazione dati • Doc XML
Shoper	Google product feed direttamente dalla piattaforma	Feed Google
Shopware	Google Shopping — esportazione diretta o tramite componente aggiuntivo	Esportazione diretta • Componente aggiuntivo
Shoprenter	Google Shopping e Heuréka product feed	Google Shopping • Heuréka
PrestaShop	Google Shopping tramite componente aggiuntivo	Componente aggiuntivo
Magento	Google Shopping tramite estensioni	Estensioni
WooCommerce	Google Product Feed tramite componente aggiuntivo	Componente aggiuntivo • Consigliato

E adesso?

Introduzione all’assistente agli acquisti Mira AI — configura Mira AI e aggiungi il product feed come fonte.
Come iniziare a formare Mira AI — personalizza le risposte AI con le domande e risposte che vuoi tu.
Mira AI - disponibilità in magazzino — fai verificare ai visitatori se un prodotto è disponibile.
FAQ sull’assistente agli acquisti Mira AI — domande frequenti su Mira AI.

💡 Serve ancora una mano? Scrivi al nostro team di supporto — siamo qui per te, chiedi pure!

Come esportare i feed di prodotto dalle principali piattaforme e-commerce per l’assistente agli acquisti Mira AI?