Mira AI asistent za kupnju koristi vaš katalog proizvoda za preporučivanje artikala, odgovaranje na upite o cijenama i provjeru dostupnosti. U ovom vodiču saznat ćete koje formate kataloga Mira AI podržava, koje oznake prepoznaje i gdje pronaći službene upute za izvoz s najpopularnijih e-commerce platformi.

Vodič je organiziran prema sljedećim poglavljima:

Imate problem s katalogom ili web scrapingom? Rješavanje poteškoća s izvorima znanja za Mira AI

Prije nego počnete

Mira AI prihvaća standardne XML kataloge proizvoda – isti format koji većina e-commerce platformi koristi za Heuréka, Google Shopping, Zboží.cz i slična tržišta. Što je vaš katalog potpuniji (cijena, dostupnost, opis, poveznica, kategorija), Mira AI može dati relevantnije preporuke.

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 želite da se katalog automatski osvježava.

Savjet: Pogledajte Uvod u Mira AI da biste u potpunosti postavili asistenta.

Mira AI automatski ažurira vaš katalog proizvoda u zadanim vremenskim razmacima – sva ažuriranja cijena, dostupnosti i novi proizvodi prikazuju se u chatu bez potrebe za ponovnim učitavanjem datoteke.

Napomena: Mira AI učitava slike proizvoda na kartici izravno iz vašeg XML kataloga. Ako proizvod nema sliku u katalogu, Mira koristi Open Graph ili istaknutu sliku s same stranice proizvoda – zato ih preporučujemo postaviti i tamo.

Napomena: Ako vaš server ograničava dolazne veze (vatrozid, popis dopuštenih IP adresa), omogućite pristup za IP adrese feed-fetchera Smartsupp-a: 94.130.187.58 i 188.245.65.74. U suprotnom, Mira AI neće moći pristupiti vašem katalogu proizvoda.

Ove se IP adrese povremeno mogu promijeniti. Ako se vaš katalog iznenada prestane ažurirati, provjerite ovaj članak za aktualni popis ili se obratite našoj podršci.

Podržani formati kataloga

Mira AI podržava dva poznata formata kataloga proizvoda – Heuréka i Google Merchant. Oba formata koriste standardne XML konvencije:

Ekstenzija datoteke mora biti .xml ili .rss.
Prvi redak mora započeti s <?xml ...?> ili <rss ...>.
Jedna roditeljska oznaka obuhvaća sve proizvode. Naziv glavne oznake može biti proizvoljan (npr. <SHOP>) – važno je samo da postoji.
Svaki proizvod je unutar svoje oznake (prikazano niže prema formatu).

Minimalni ispravan predložak kataloga izgleda ovako:

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

Važno: Ako proizvodu nedostaje obavezna oznaka, taj će proizvod Mira AI preskočiti – neće biti prikazan u rezultatima i preporukama. Svaki artikl mora imati popunjene sve tražene oznake.

Struktura Heuréka kataloga

Za Heuréka format, Mira AI prepoznaje ove oznake. Pogledajte službenu dokumentaciju za Heuréka XML katalog za detaljne upute.

Kategorija	Oznake	Napomene
Omot za proizvod (obavezno)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Svaki artikl mora biti unutar jedne od navedenih oznaka.
Opis (obavezno)	`PRODUCTNAME` (ili `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Sve oznake moraju imati upisan sadržaj. Prazne oznake smatraju se nedostatnima.
Neobavezno	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = na zalihi, 1–7 = dostupno unutar tjedan dana, ostalo ili prazno = nije dostupno. `PARAM` može biti više puta za jedan proizvod.
Slika	`IMGURL`	Prikazuje se slika proizvoda. Ako nedostaje, Mira koristi Open Graph ili istaknutu sliku s artikla.
Zanemareno	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI preskače te oznake – možete ih ostaviti u katalogu za ostale sustave.

Oznaka PARAM sadrži dodatnu značajku proizvoda kao par oznaka i vrijednost:

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

Struktura Google Merchant kataloga

Za Google Merchant format, Mira AI obrađuje sljedeće oznake. Pogledajte službenu Google Merchant dokumentaciju kataloga za sve pojedinosti.

Kategorija	Oznake	Napomene
Omot za proizvod (obavezno)	`item`, `entry`, `product`	Svaki proizvod mora biti unutar jedne od navedenih oznaka.
Opis (obavezno)	`title`, `description`, `product_type` (ili `google_product_category`), `link`, `price`	Za kategoriju koristite `product_type` ili `google_product_category` s opisnim nazivom – brojčani ID kategorije trenutno nije podržan.
Format cijene	`price`	Dopušteni format: `236 CZK` ili `CZK 236`. Povoljan je troznamenkasti ISO kod valute (npr. CZK, EUR, GBP…)
Akcijska cijena (opcionalno)	`sale_price`, `sale_price_effective_date`	Ako `sale_price` postoji, mora biti niža i u istoj valuti kao `price`. Mira prikazuje akcijsku cijenu i u chatu i na karticama. Sa `sale_price_effective_date` akcijska cijena vrijedi samo u tom razdoblju (gleda se u realnom vremenu); nakon isteka ili ako format nije prepoznat – prikazuje se standardna cijena. Postojeći katalozi ažuriraju se pri idućem osvježavanju.
Neobavezno	`availability`	Na zalihi: `in_stock`, `in stock`. Nema na zalihi: `out_of_stock`, `out of stock`, `preorder`, `backorder`, ili prazno.
Slika	`image_link`	Prikazuje se slika proizvoda. Ako nedostaje, Mira koristi Open Graph ili istaknutu sliku s artikla.
Zanemareno	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI preskače navedene oznake – slobodno ih ostavite za druge alate.

Mira može očitati veličine proizvoda iz kataloga (oznaka size) i prikazivati ih u preporukama, što postaje vidljivo nakon ažuriranja kataloga.

Napomena: Brojčani ID-evi u google_product_category nisu podržani. Obavezno koristite opisni tekst kategorije – primjerice "Odjeća i dodaci > Odjeća > Majice i topovi" – ili upotrijebite product_type.

Izvoz kataloga prema platformama

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

Platforma	Izvoz kataloga	Službeni vodič
Shoptet	Heuréka i Google Shopping XML iz administracije	XML katalozi • Heuréka XML
Shopsys	Katalozi proizvoda dostupni prema developerskoj dokumentaciji	Katalozi proizvoda
Eshop-rychle	Formati kataloga za usporedbe cijena	Izvoz proizvoda
Upgates	XML izvoz s potpunom strukturom proizvoda	Izvoz podataka • XML dokumentacija
Shoper	Google katalog proizvoda izravno iz sustava	Google katalog
Shopware	Google Shopping – izravno ili putem dodataka	Izravan izvoz • Dodaci
Shoprenter	Google Shopping i Heuréka katalog	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 učiniti nakon toga?

Uvod u Mira AI asistenta za kupnju — postavite Mira AI i dodajte svoj katalog proizvoda kao izvor.
Kako započeti s treniranjem Mira AI — poboljšajte AI odgovore vlastitim skupovima pitanja i odgovora.
Mira AI – status zaliha — omogućite posjetiteljima provjeru dostupnosti proizvoda.
Česta pitanja o Mira AI asistentu za kupnju — pronađite odgovore na najčešća pitanja o Mira AI.

💡 Treba li vam dodatna pomoć? Kontaktirajte naš tim za podršku – rado ćemo vam pomoći!

Povezani članci

Kako izvesti katalog proizvoda s različitih e-commerce platformi za Mira AI asistenta za kupnju?