Mira AI -ostoassistentti käyttää tuotefeediäsi suositellakseen tuotteita, vastatakseen hintakysymyksiin ja tarkistaakseen saatavuuden. Tässä oppaassa selitetään feed-muodot, joita Mira AI hyväksyy, tunnisteet, joita se lukee, sekä mistä löydät viralliset vientiohjeet suosituimmille verkkokauppa-alustoille.

Olemme jakaneet oppaan seuraaviin osiin:

Ennen kuin aloitat

Mira AI hyväksyy standardit XML-tuotefeedin – saman muodon, jonka useimmat verkkokauppa-alustat tuottavat Heurékaa, Google Shoppingia, Zboží.cz:ää ja vastaavia markkinapaikkoja varten. Mitä kattavampi feedisi on (hinta, saatavuus, kuvaus, linkki, kategoria), sitä älykkäämpiä Miran suositukset ovat.

Lisätäksesi feedin Smartsuppiin:

Avaa assistentin rakentajassa Tietopankki → XML-tuotefeed ja klikkaa Lisää uusi lähde.
Anna lähteelle nimi.
Liitä tuotefeedisi koko URL-osoite.
Vaiheessa Päivitä -vaiheessa valitse, kuinka usein feed päivitetään.

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.

Huomio: Mira AI lataa tuotekorttien kuvat suoraan XML-feedistäsi. Jos tuotteella ei ole kuvaa feedissä, Mira käyttää varatoimintona Open Graph - tai esittelykuvaa tuotesivultasi – joten niiden pitäminen ajan tasalla kannattaa.

Huomio: Jos palvelimesi rajoittaa saapuvia yhteyksiä (palomuuri, IP-allowlist), varmista, että Smartsuppin feed-hakurobotin IP-osoitteet on sallittu: 94.130.187.58 ja 188.245.65.74. Muuten Mira AI ei pysty lataamaan tuotefeediäsi.

Tuetut feed-muodot

Mira AI tukee kahta standardia tuotefeed-muotoa — Heuréka ja Google Merchant. Molemmat noudattavat yleisiä XML-käytäntöjä:

Tiedostopääte on .xml tai .rss.
Ensimmäisen rivin täytyy alkaa merkkijonolla <?xml ...?> tai <rss ...>.
Yksi ylätason tunniste (parent tag) ympäröi kaikki tuoterivit. Ylätason tunnisteella voi olla mikä tahansa nimi (esim. <SHOP>) — ainoastaan sen olemassaolo on tärkeää.
Jokainen tuote on kääritty omaan item-tunnisteeseensa (katso formaattikohtaiset osiot alempaa).

Minimaalinen, kelvollinen runko näyttää tältä:

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

Tärkeää: Jos pakollinen tunniste puuttuu tuotteesta, koko tuote ohitetaan Miran indeksissä — kävijät eivät näe sitä suosituksissa. Varmista, että jokaisella tuotteella on kaikki vaaditut tunnisteet täytettyinä.

Heuréka-feed-rakenne

Heuréka-muodon kohdalla Mira AI lukee seuraavat tunnisteet. Katso Heurékan virallinen XML-feed-dokumentaatio täydellistä määrittelyä varten.

Kategoria	Tunnisteet	Huomautukset
Tuotteen kääre-elementti (pakollinen)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jokainen tuote on jonkin näistä tunnisteista ympäröimä.
Kuvaus (pakollinen)	`PRODUCTNAME` (tai `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Jokaisessa tunnisteessa täytyy olla sisältöä. Tyhjät tunnisteet lasketaan puuttuviksi.
Vapaaehtoinen	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = varastossa, 1–7 = saatavilla viikon sisällä, mikä tahansa muu / puuttuva = ei saatavilla. `PARAM` voi toistua tuotteella rajattomasti monta kertaa.
Kuva	`IMGURL`	Tuotekuva, joka näytetään kortissa. Jos se puuttuu, Mira käyttää varatoimintona Open Graph -kuvaa tai esittelykuvaa tuotesivulla.
Ohitetaan	`TOIMITUS`, `EAN`, `ITEM_ID`, `ALV`, `ITEMGROUP_ID`, `LISÄVARUSTE`, `VALMISTAJA`	Mira AI ohittaa nämä tunnisteet — voit jättää ne feediin muita työkaluja varten.

A PARAM tunniste sisältää ylimääräisen tuoteattribuutin nimi–arvo-parina:

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

Google Merchant -feedin rakenne

Google Merchant -muodossa Mira AI lukee seuraavat tunnisteet. Katso virallinen Google Merchant -feedin määritys täydelliset tiedot.

Kategoria	Tunnisteet	Huomautukset
Tuotteen kääreetunniste (pakollinen)	`item`, `entry`, `product`	Jokainen tuote on jonkin näistä tunnisteista sisällä.
Kuvaus (pakollinen)	`otsikko`, `kuvaus`, `product_type` (tai `google_product_category`), `link`, `hinta`	Luokkaa varten käytä `product_type` tai `google_product_category` kentän kanssa teksti nimi — numeerisia luokkien ID-tunnuksia ei vielä tueta.
Hinnan muoto	`hinta`	Sallittu muoto: `236 CZK` tai `CZK 236`. Valuutta on 3-kirjaiminen koodi (CZK, EUR, GBP…).
Vapaaehtoinen	`availability`	Varastossa: `in_stock`, `varastossa`. Ei saatavilla: `out_of_stock`, `loppu varastosta`, `preorder`, `backorder`, mikä tahansa muu / puuttuva.
Kuva	`image_link`	Tuotekuva, joka näytetään kortissa. Jos se puuttuu, Mira käyttää varakuvana Open Graph -kuvaa tai esittelykuvaa tuotesivulla.
Ohitettu	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ohittaa nämä tunnisteet — voit jättää ne feediin muita työkaluja varten.

Huomio: Numeerinen google_product_category ID:t ovat eivät vielä tuettuja. Käytä aina kategorian tekstiversiota – esimerkiksi "Apparel & Accessories > Clothing > Shirts & Tops" — tai käytä product_type sen sijaan.

Vie feed alustasta

Etsi oma verkkokauppa-alustasi alla olevasta taulukosta ja seuraa virallista vientiohjetta.

Alusta	Mitä se luo	Virallinen ohje
Shoptet	Heuréka & Google Shopping XML -tiedoston ylläpitopaneelista	XML-feedit • Heuréka XML
Shopsys	Tuotefeed alustasta kehittäjädokumentaation avulla	Tuotefeed
Eshop-rychle	Feedit hintavertailupalveluja varten	Tuotteiden vienti
Upgates	XML-tietojen vienti täydellä tuotetietorakenteella	Tietojen vienti • XML-dokumentaatio
Shoper	Google-tuotefeed suoraan alustalta	Google-feed
Shopware	Google Shopping — suora vienti tai lisäosien kautta	Suora vienti • Lisäosat
Shoprenter	Google Shopping & Heuréka -feedit	Google Shopping • Heuréka
Prestashop	Google Shopping lisäosien kautta	Lisäosat
Magento	Google Shopping laajennusten kautta	Laajennukset
WooCommerce	Google-tuotefeed lisäosien kautta	Lisäosat • Suositeltu

Mitä seuraavaksi?

Johdanto Mira AI -ostoassistenttiin — määritä Mira AI ja lisää Tuotefeed tietolähteeksi.
Kuinka aloittaa Mira AI:n kouluttaminen — hienosäädä tekoälyn vastauksia mukautetuilla K&V-pareilla.
Mira AI - varastotilanne — anna kävijöiden tarkistaa, onko tuote varastossa.
Mira AI -ostoassistentti UKK — yleisiä kysymyksiä liittyen Mira AI:hin.

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

Aiheeseen liittyvät artikkelit

Kuinka viedä tuotefeed eri verkkokauppa-alustoilta Mira AI -ostoassistenttia varten?