Mira AI asistent za kupnju koristi vaš katalog proizvoda za preporučivanje proizvoda, odgovaranje na pitanja o cijenama i provjeru dostupnosti. Ovaj vodič objašnjava koje formate kataloga Mira AI prihvaća, koje oznake čita i gdje pronaći službene upute za izvoz za najpopularnije e-commerce platforme.

Vodič je podijeljen u sljedeće odjeljke:

Katalog ili web scraping ne radi? Rješavanje problema s Mira AI izvorima znanja

Prije početka

Mira AI prihvaća standardne XML kataloge proizvoda — isti format koji većina e-commerce platformi generira za Heuréka, Google Shopping, Zboží.cz i slične marketplaceove. Što je vaš katalog bogatiji (cijena, dostupnost, opis, link, kategorija), preporuke Mire AI bit će pametnije.

Za dodavanje kataloga u Smartsupp:

U graditelju asistenta otvorite Baza znanja → Proizvodi i kliknite Dodati.
Unesite naziv izvora.
Zalijepite puni URL vašeg kataloga proizvoda.
U koraku Ažuriranje odaberite koliko često će se katalog osvježavati.

Savjet: Pogledajte Uvod u Mira AI za cijelo postavljanje.

Mira AI automatski osvježava vaš katalog proizvoda u redovitim intervalima — promjene cijena, ažuriranja dostupnosti i novi proizvodi pojavljuju se u chatu bez potrebe za ponovnim učitavanjem datoteke.

Napomena: Mira AI učitava slike proizvoda izravno iz vašeg XML kataloga. Ako proizvod nema sliku u katalogu, Mira koristi Open Graph ili istaknutu sliku s vaše stranice proizvoda — stoga je korisno održavati i te slike.

Napomena: Ako vaš poslužitelj ograničava dolazne veze (vatrozid, popis dopuštenih IP adresa), svakako omogućite pristup s IP adresa Smartsupp feed-fetchera: 94.130.187.58 i 188.245.65.74. U suprotnom Mira AI neće moći preuzeti vaš katalog proizvoda.

Ove se IP adrese povremeno mogu promijeniti. Ako se vaš katalog iznenada prestane ažurirati, provjerite ovaj članak za trenutni popis ili kontaktirajte našu podršku.

Podržani formati kataloga

Mira AI podržava dva standardna formata kataloga proizvoda — Heuréka i Google Merchant. Oba slijede uobičajene XML konvencije:

Datoteka ima ekstenziju .xml ili .rss.
Prvi redak mora započeti s <?xml ...?> ili <rss ...>.
Jedna nadređena oznaka obuhvaća sve proizvode. Nadređena oznaka može imati bilo koji naziv (npr. <SHOP>) — važna je samo njezina prisutnost.
Svaki proizvod je obuhvaćen vlastitom oznakom (vidi odjeljke specifične za format u nastavku).

Minimalni ispravan primjer izgleda ovako:

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

Važno: Ako obavezna oznaka nedostaje kod nekog proizvoda, cijeli taj proizvod se preskače u indeksu Mire — posjetitelji ga neće vidjeti u preporukama. Pazite da svaki proizvod ima ispunjene sve obavezne oznake.

Struktura Heuréka kataloga

Za Heuréka format, Mira AI čita sljedeće oznake. Pogledajte službenu Heuréka XML dokumentaciju za katalog za potpunu specifikaciju.

Kategorija	Oznake	Napomene
Omot proizvoda (obavezno)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jedna od ovih oznaka obuhvaća svaki proizvod.
Opis (obavezno)	`PRODUCTNAME` (ili `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Sve oznake moraju imati sadržaj. Prazne oznake smatraju se nepostojećima.
Dobrovoljno	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = na zalihi, 1–7 = dostupno unutar tjedan dana, bilo što drugo / nedostaje = nije dostupno. `PARAM` može biti više puta po proizvodu.
Slika	`IMGURL`	Slika proizvoda prikazana na kartici. Ako nedostaje, Mira koristi Open Graph ili istaknutu sliku s proizvoda.
Zanemaruje se	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI preskače ove oznake — možete ih ostaviti u katalogu za druge alate.

Oznaka PARAM sadrži dodatni atribut proizvoda u obliku para naziv–vrijednost:

<PARAM> <PARAM_NAME>Širina</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Struktura Google Merchant kataloga

Za Google Merchant format, Mira AI čita sljedeće oznake. Pogledajte službenu Google Merchant specifikaciju za katalog za potpunu referencu.

Kategorija	Oznake	Napomene
Omot proizvoda (obavezno)	`item`, `entry`, `product`	Jedna od ovih oznaka obuhvaća svaki proizvod.
Opis (obavezno)	`title`, `description`, `product_type` (ili `google_product_category`), `link`, `price`	Za kategoriju koristite `product_type` ili `google_product_category` s tekstualnim nazivom — brojčane ID-ove kategorija još ne podržavamo.
Format cijene	`price`	Dopušteni format: `236 CZK` ili `CZK 236`. Također su prihvaćeni decimalni i tisućiti separator, npr. `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` ili `1 049,00 CHF`. Valuta je 3-slovo oznaka (CZK, EUR, GBP…).
Akcijska cijena (opcionalno)	`sale_price`, `sale_price_effective_date`	Ako je `sale_price` prisutan, u istoj valuti i niži od `price`, Mira navodi akcijsku cijenu u odgovorima, pretragama proizvoda i na karticama proizvoda. S oznakom `sale_price_effective_date` akcijska cijena se upotrebljava samo u tom vremenskom rasponu (provjerava se pri svakom upitu); izvan njega, ili ako raspon nije moguće očitati, Mira koristi redovnu cijenu. Postojeći katalozi preuzimaju akcijske cijene pri svom sljedećem ažuriranju.
Dobrovoljno	`availability`	Na zalihi: `in_stock`, `in stock`. Nedostupno: `out_of_stock`, `out of stock`, `preorder`, `backorder`, bilo što drugo / nedostaje.
Slika	`image_link`	Slika proizvoda prikazana na kartici. Ako nedostaje, Mira koristi Open Graph ili istaknutu sliku s proizvoda.
Zanemaruje se	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI preskače ove oznake — možete ih ostaviti u katalogu za druge alate.

Mira također čita veličine proizvoda iz vašeg kataloga (oznaka size) i može ih spomenuti kod preporuka proizvoda. Veličine će se pojaviti nakon što se katalog osvježi.

Napomena: Numerički google_product_category ID-ovi još nisu podržani. Uvijek koristite tekstualnu verziju kategorije — npr. "Odjeća i dodaci > Odjeća > Majice i topovi" — ili jednostavno upotrijebite product_type.

Izvoz kataloga prema platformi

Pronađite svoju e-commerce platformu u tablici ispod i slijedite službeni vodič za izvoz.

Platforma	Što generira	Službeni vodič
Shoptet	Heuréka & Google Shopping XML iz administratorske ploče	XML katalozi • Heuréka XML
Shopsys	Katalozi proizvoda putem platforme uz dokumentaciju za programere	Katalozi proizvoda
Eshop-rychle	Katalozi za servise za usporedbu proizvoda	Izvoz proizvoda
Upgates	XML izvoz podataka s kompletnom strukturom proizvoda	Izvoz podataka • XML dokumentacija
Shoper	Google katalog proizvoda izravno s platforme	Google katalog
Shopware	Google Shopping — izravni izvoz ili putem dodataka	Izravni izvoz • Dodaci
Shoprenter	Google Shopping & Heuréka katalozi	Google Shopping • Heuréka
PrestaShop	Google Shopping putem dodataka	Dodaci
Magento	Google Shopping putem ekstenzija	Ekstenzije
WooCommerce	Google katalog proizvoda putem dodataka	Dodaci • Preporučeno

Što dalje?

Uvod u Mira AI Shopping Assistant — postavite Mira AI i dodajte katalog proizvoda kao izvor.
Kako započeti trenirati Mira AI — dodatno poboljšajte AI odgovore vlastitim pitanjima i odgovorima.
Mira AI - dostupnost na zalihi — omogućite posjetiteljima provjeru ima li proizvoda na zalihi.
Mira AI Shopping Assistant ČPP — česta pitanja o Mira AI.

💡 Trebate dodatnu pomoć? Kontaktirajte naš tim za podršku — rado ćemo vam pomoći!

Povezani članci

Kako izvesti kataloge proizvoda iz raznih e-commerce platformi za Mira AI Shopping Assistant?