Mira AI -ostoassistentti käyttää tuotefeediasi suositellakseen tuotteita, vastatakseen hintakysymyksiin ja tarkistaakseen saatavuuden. Tässä oppaassa kerrotaan, mitä feedimuotoja Mira AI hyväksyy, mitä tunnisteita se lukee ja mistä löydät viralliset vientiohjeet suosituimmille verkkokauppa-alustoille.

Olemme jakaneet oppaan seuraaviin osioihin:

Feed tai verkkosivujen kaavinta ei toimi? Mira AI:n tietolähteiden vianmääritys

Ennen kuin aloitat

Mira AI hyväksyy vakiomuotoiset XML-tuotefeedin – sama formaatti jonka useimmat verkkokauppa-alustat luovat Heurékaa, Google Shoppingia, Zboží.cz:ää ja vastaavia markkinapaikkoja varten. Mitä laajempi feedisi on (hinta, saatavuus, kuvaus, linkki, kategoria), sitä älykkäämpiä tuotesuosituksia Mira antaa.

Lisää feed Smartsuppiin näin:

Assistentin rakentajassa avaa Tietopankki → Tuotteet ja napsauta Lisää.
Anna lähteelle nimi.
Liitä tuotefeedin täydellinen URL-osoite.
Vaiheessa Päivitä valitse, kuinka usein feed pitäisi päivittää.

Vinkki: Katso Johdanto Mira AI:hin koko käyttöönottoon.

Mira AI päivittää tuotefeedisi automaattisesti säännöllisin väliajoin – hintamuutokset, saatavuuspäivitykset ja uudet tuotteet näkyvät chatissa ilman, että sinun tarvitsee ladata tiedostoa uudelleen.

Huom: Mira AI lataa tuotekortin kuvat suoraan XML-feedistäsi. Jos tuotteella ei ole kuvaa feedissä, Mira käyttää varakuvana Open Graph -kuvaa tai tuotesivun esillä olevaa kuvaa – eli nämäkin kannattaa pitää kunnossa.

Huom: Jos palvelimesi rajoittaa saapuvia yhteyksiä (palomuuri, IP-sallintalista), muista sallia pääsy Smartsuppin feed-hakijan IP-osoitteista: 94.130.187.58 ja 188.245.65.74. Muutoin Mira AI ei pysty lataamaan tuotefeedisi.

Nämä IP-osoitteet voivat ajoittain muuttua. Jos feedisi lakkaa päivittymästä, tarkista tästä artikkelista uusin lista tai ota yhteyttä tukeemme.

Tuetut feedimuodot

Mira AI tukee kahta vakiomuotoista tuotefeedimuotoa – Heuréka ja Google Merchant. Molemmat noudattavat yleisiä XML-käytäntöjä:

Tiedostopääte on .xml tai .rss.
Ensimmäisen rivin on alettava <?xml ...?> tai <rss ...>.
Yksi ylätunniste ympäröi kaikki tuote-alkiot. Ylätunnisteella voi olla mikä tahansa nimi (esim. <SHOP>) – vain olemassaolo merkitsee.
Jokainen tuote on omassa item-tunnisteessaan (katso formaattikohtaiset osiot alta).

Pienin sallittu skeletto näyttää tältä:

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

Tärkeää: Jos vaadittu tunniste puuttuu tuotteelta, koko tuote ohitetaan Miran indeksissä – kävijät eivät näe sitä suosituksissa. Muista täyttää jokaiselle tuotteelle kaikki vaaditut tunnisteet.

Heuréka-feedistruktuuri

Heuréka-muodossa Mira AI lukee seuraavat tunnisteet. Katso virallinen Heuréka XML feed -dokumentaatio koko määritykseen.

Kategoria	Tunnisteet	Huomioita
Tuote-ympäristö (pakollinen)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jokin näistä tunnisteista ympäröi jokaisen tuotteen.
Kuvaus (pakollinen)	`PRODUCTNAME` (tai `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Jokaisessa tunnisteessa on oltava sisältöä. Tyhjät tunnisteet lasketaan puuttuviksi.
Vapaaehtoinen	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = varastossa, 1–7 = saatavilla viikon sisällä, muu/missing = ei saatavilla. `PARAM` voi toistua useita kertoja per tuote.
Kuva	`IMGURL`	Tuotekuva näkyy kortilla. Jos se puuttuu, Mira käyttää varakuvana Open Graph -kuvaa tai tuotesivun kuvaa.
Ohitetaan	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ohittaa nämä tunnisteet – voit jättää ne feediin muiden työkalujen vuoksi.

PARAM-tunnisteella tuotteen lisäominaisuus tulee nimi–arvoparina:

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

Google Merchant -feedistruktuuri

Google Merchant -muodossa Mira AI lukee seuraavat tunnisteet. Katso virallinen Google Merchant -feedin määritys koko viitteeseen.

Kategoria	Tunnisteet	Huomioita
Tuote-ympäristö (pakollinen)	`item`, `entry`, `product`	Jokin näistä tunnisteista ympäröi jokaisen tuotteen.
Kuvaus (pakollinen)	`title`, `description`, `product_type` (tai `google_product_category`), `link`, `price`	Kategoriaan käytä `product_type` tai `google_product_category` -tunnistetta tekstimuodossa – numeerisia kategoria-ID:itä ei vielä tueta.
Hintaformaatti	`price`	Hyväksytty muoto: `236 CZK` tai `CZK 236`. Myös desimaali- ja tuhaterottimet käyvät, esim. `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` tai `1 049,00 CHF`. Valuutta on 3-kirjaiminen koodi (CZK, EUR, GBP…).
Kampanjahinta (valinnainen)	`sale_price`, `sale_price_effective_date`	Jos `sale_price` on feedissä, sama valuutta ja matalampi kuin `price`, Mira näyttää kampanjahinnan vastauksissa, tuotetuloksissa ja tuotekorteilla. `sale_price_effective_date`:n ansiosta alehinta on voimassa vain määrätyllä aikavälillä (tarkistetaan kysymishetkellä); sen ulkopuolella tai jos aikaväliä ei voi lukea, käytetään normaalia hintaa. Olemassa olevat feedit nappaavat kampanjahinnat seuraavassa päivityksessä.
Vapaaehtoinen	`availability`	Varastossa: `in_stock`, `in stock`. Ei saatavilla: `out_of_stock`, `out of stock`, `preorder`, `backorder`, muu/missing.
Kuva	`image_link`	Tuotekuva näkyy kortilla. Jos se puuttuu, Mira käyttää varakuvana Open Graph -kuvaa tai tuotesivun kuvaa.
Ohitetaan	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ohittaa nämä tunnisteet – voit jättää ne feediin muiden työkalujen vuoksi.

Mira lukee feedistä myös tuotteiden koot (size-tunniste), ja voi mainita ne tuotteita suositellessaan. Koot näkyvät, kun feedi päivittyy.

Huom: Numeerisia google_product_category ID:itä ei vielä tueta. Käytä aina kategorian tekstiversiota – esimerkiksi "Apparel & Accessories > Clothing > Shirts & Tops" – tai käytä product_type-tunnistetta.

Feedin vienti alustan mukaan

Löydä oma verkkokauppa-alustasi alta ja seuraa virallista vientiohjetta.

Alusta	Mitä se tuottaa	Virallinen ohje
Shoptet	Heuréka & Google Shopping XML hallintapaneelista	XML Feed • Heuréka XML
Shopsys	Tuotefeedin vienti alustan kautta kehittäjäohjeilla	Tuotefeed
Eshop-rychle	Feedit vertailupalveluihin	Tuotevienti
Upgates	XML-tiedoston vienti koko tuoterakenteella	Datan vienti • XML-ohje
Shoper	Google-tuotefeed suoraan alustalta	Google Feed
Shopware	Google Shopping – suora vienti tai lisäosilla	Suora vienti • Lisäosat
Shoprenter	Google Shopping- & Heuréka-feed	Google Shopping • Heuréka
PrestaShop	Google Shopping lisäosilla	Lisäosat
Magento	Google Shopping laajennuksilla	Laajennukset
WooCommerce	Google-tuotefeed lisäosilla	Lisäosat • Suositus

Mitä seuraavaksi?

Johdanto Mira AI -ostoassistenttiin — ota Mira AI käyttöön ja lisää tuotefeed lähteeksi.
Miten aloitat Mira AI:n koulutuksen — viimeistele AI-vastauksia mukautetuilla kysymys–vastauspareilla.
Mira AI – varastosaatavuus — anna kävijöiden tarkistaa, onko tuote varastossa.
Mira AI -ostoassistentin UKK — yleiset kysymykset Mira AI:sta.

💡 Tarvitsetko lisää apua? Ota yhteyttä tukitiimiimme — autetaan mielellämme!

Aiheeseen liittyvät artikkelit

Miten viet tuotefeedin eri verkkokauppa-alustoilta Mira AI -ostoassistentille?