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 formate kataloga koje Mira AI prihvaća, oznake koje čita i gdje pronaći službene upute za izvoz s najpopularnijih e-commerce platformi.

Vodič smo podijelili na sljedeće odjeljke:

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

Prije nego što počnete

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čna tržišta. Što je vaš katalog bogatiji (cijena, dostupnost, opis, poveznica, kategorija), to će preporuke koje daje Mira biti pametnije.

Za dodavanje kataloga u aplikaciji Smartsupp:

U alatu za izradu asistenta otvorite Baza znanja → Proizvodi i kliknite Dodati novi izvor.
Unesite naziv izvora.
Zalijepite puni URL svojeg kataloga proizvoda.
U koraku Ažuriranje odaberite koliko se često katalog treba osvježavati.

Savjet: Pogledajte Uvod u Mira AI za cjelovite upute za 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: Tijekom probnog razdoblja automatsko ažuriranje kataloga je pauzirano. Nakon nadogradnje odaberite interval ažuriranja kataloga kako biste ga uključili.

Napomena: Mira AI učitava slike na karticama proizvoda izravno iz vašeg XML kataloga. Ako proizvod nema sliku u katalogu, Mira koristi Open Graph sliku ili istaknutu sliku na stranici proizvoda — stoga je korisno i njih postaviti.

Napomena: Ako vaš poslužitelj ograničava dolazne veze (vatrozid, popis dopuštenih IP adresa), obavezno omogućite pristup s IP adresa Smartsuppova sustava za dohvaćanje kataloga: 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 trenutačni popis u ovom članku ili se obratite našoj podršci.

Podržani formati kataloga

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

Nastavak datoteke je .xml ili .rss.
Prvi redak mora započeti s <?xml ...?> ili <rss ...>.
Jedna nadređena oznaka obuhvaća sve stavke proizvoda. Nadređena oznaka može imati bilo koji naziv (npr. <SHOP>) — važno je samo da postoji.
Svaki je proizvod obuhvaćen vlastitom oznakom stavke (pogledajte odjeljke za pojedine formate u nastavku).

Minimalna valjana struktura izgleda ovako:

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

Važno: Ako nedostaje obavezna oznaka za proizvod, taj se proizvod u cijelosti izostavlja iz Mirina indeksa — posjetitelji ga neće vidjeti u preporukama. Provjerite jesu li za svaki proizvod ispunjene sve obavezne oznake.

Struktura kataloga Heuréka

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

Kategorija	Oznake	Napomene
Omotna oznaka stavke (obavezno)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jedna od ovih oznaka obuhvaća svaki proizvod.
Opis (obavezno)	`PRODUCTNAME` (ili `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Svaka oznaka mora biti popunjena. Prazne oznake smatraju se nedostajućima.
Neobavezno	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = na zalihi, 1–7 = dostupno unutar tjedan dana, sve ostalo / nedostaje = nedostupno. `PARAM` može se ponavljati neograničen broj puta po proizvodu.
Slika	`IMGURL`	Slika proizvoda prikazana na kartici. Ako nedostaje, Mira koristi Open Graph sliku ili istaknutu sliku na stranici proizvoda.
Zanemareno	`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 kao par naziv–vrijednost:

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

Struktura kataloga Google Merchant

Za format Google Merchant Mira AI čita sljedeće oznake. Pogledajte Službenu specifikaciju kataloga Google Merchant za potpuni pregled.

Kategorija	Oznake	Napomene
Omotna oznaka stavke (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čani ID-ovi kategorija još nisu podržani.
Format cijene	`price`	Dopušteni format: `236 CZK` ili `CZK 236`. Valuta je kod od 3 slova (CZK, EUR, GBP…).
Neobavezno	`availability`	Na zalihi: `in_stock`, `in stock`. Nedostupno: `out_of_stock`, `out of stock`, `preorder`, `backorder`, sve ostalo / nedostaje.
Slika	`image_link`	Slika proizvoda prikazana na kartici. Ako nedostaje, Mira koristi Open Graph sliku ili istaknutu sliku na stranici proizvoda.
Zanemareno	`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 pri preporučivanju proizvoda. Veličine se pojavljuju nakon osvježavanja kataloga.

Napomena: Brojčani google_product_category ID-ovi još nisu podržani. Uvijek koristite tekstualnu verziju kategorije — na primjer "Apparel & Accessories > Clothing > Shirts & Tops" — ili koristite product_type kao zamjenu.

Izvoz kataloga prema platformi

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

Platforma	Što generira	Službeni vodič
Shoptet	XML katalozi za Heuréka & Google Shopping iz administratorske ploče	XML katalozi • Heuréka XML
Shopsys	Katalozi proizvoda putem platforme s dokumentacijom za programere	Katalozi proizvoda
Eshop-rychle	Katalozi za servise za usporedbu cijena	Izvoz proizvoda
Upgates	Izvoz XML podataka s potpunom strukturom proizvoda	Izvoz podataka • XML dokumentacija
Shoper	Google katalog proizvoda izravno s platforme	Google katalog
Shopware	Google Shopping — izravan izvoz ili putem dodataka	Izravan izvoz • Dodaci
Shoprenter	Katalozi za Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping putem dodataka	Dodaci
Magento	Google Shopping putem proširenja	Proširenja
WooCommerce	Google Product Feed putem dodataka	Dodaci • Preporučeno

Što dalje?

Uvod u Mira AI asistenta za kupnju — postavite Mira AI i dodajte svoj katalog proizvoda kao izvor.
Kako započeti obuku Mira AI — precizno prilagodite AI odgovore pomoću prilagođenih parova pitanja&odgovora.
Mira AI - dostupnost na zalihi — omogućite posjetiteljima da provjere je li proizvod na zalihi.
Često postavljana pitanja o Mira AI asistentu za kupnju — uobičajena pitanja o Mira AI.

💡 Trebate dodatnu pomoć? Obratite se našem Timu za podršku — rado ćemo vam pomoći!

Povezani članci

Kako izvesti kataloge proizvoda s različitih e-commerce platformi za MiraAI asistenta za kupnju?