Mira AI nakupovalni asistent uporablja vaš produktni vir za priporočanje izdelkov, odgovarjanje na vprašanja glede cen in preverjanje razpoložljivosti. Ta vodič pojasnjuje, katere formate Mira AI sprejema, katere oznake bere in kje najdete uradna navodila za izvoz za najbolj priljubljene e-commerce platforme.

Vodič smo razdelili na naslednje razdelke:

Produktni vir ali spletno strganje ne deluje? Odpravljanje težav s spletnimi viri za Mira AI

Preden začnete

Mira AI sprejema standardne XML produktne vire — isti format, kot ga večina e-commerce platform ustvari za Heuréka, Google Shopping, Zboží.cz in podobne tržnice. Bolj kot je vaš produktni vir bogat (cena, razpoložljivost, opis, povezava, kategorija), pametnejša bodo priporočila Mire.

Za dodajanje produktnega vira v Smartsupp:

V ustvarjalniku asistenta odprite Baza znanja → Izdelki in kliknite Dodaj.
Vnesite ime za vir.
Prilepite celoten URL vašega produktnega vira.
V koraku Posodobi izberite, kako pogosto naj se produktni vir osvežuje.

Nasvet: Glejte Uvod v Mira AI za celotno nastavitev.

Mira AI vaš produktni vir samodejno osvežuje v rednih intervalih — spremembe cen, posodobitve razpoložljivosti in novi izdelki so prikazani v klepetu, brez ponovnega nalaganja datoteke.

Opomba: Mira AI prikazuje slike izdelkov na karticah neposredno iz vašega XML produktnega vira. Če slika manjka, Mira uporabi sliko Open Graph ali izpostavljeno sliko na strani izdelka — zato je priporočljivo, da so tudi te nastavljene.

Opomba: Če vaš strežnik omejuje dohodne povezave (firewall, seznam dovoljenih IP), omogočite dostop z IP naslovov za uvoz produktnih virov Smartsupp: 94.130.187.58 in 188.245.65.74. V nasprotnem primeru Mira AI ne bo mogla prenesti vašega produktnega vira.

Ti IP naslovi se lahko občasno spremenijo. Če se vaš produktni vir nenadoma preneha posodabljati, preverite ta članek za aktualni seznam ali kontaktirajte našo podporo.

Podprti formati produktnih virov

Mira AI podpira dva standardna formata produktnih virov — Heuréka in Google Merchant. Oba sledita običajnim XML konvencijam:

Končnica datoteke je .xml ali .rss.
Prva vrstica se mora pričeti z <?xml ...?> ali <rss ...>.
En nadrejeni element ovije vse izdelke. Nadrejeni element je lahko poljubnega imena (npr. <SHOP>) — pomembna je le njegova prisotnost.
Vsak izdelek je ovit v lastni element (glejte spodnje razdelke po formatih).

Minimalno veljaven primer izgleda tako:

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

POMEMBNO: Če manjka obvezna oznaka pri izdelku, je celoten izdelek izključen iz indeksa Mire — obiskovalci ga ne bodo videli v priporočilih. Poskrbite, da ima vsak izdelek izpolnjene vse zahtevane oznake.

Struktura Heuréka produktnega vira

Za format Heuréka Mira AI bere naslednje oznake. Glejte uradno Heuréka XML dokumentacijo za celotne specifikacije.

Kategorija	Oznake	Opombe
Ovijalec izdelka (obvezno)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Vsak izdelek ovije ena od teh oznak.
Opis (obvezno)	`PRODUCTNAME` (ali `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Vsaka oznaka mora vsebovati vsebino. Prazne oznake veljajo za manjkajoče.
Neobvezno	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = na zalogi, 1–7 = dobavljivo v enem tednu, drugo / manjka = ni na voljo. `PARAM` je lahko v viru večkrat za vsak izdelek.
Slika	`IMGURL`	Slika izdelka, prikazana na kartici. Če manjka, Mira uporabi Open Graph ali izpostavljeno sliko na strani izdelka.
Sprezrto	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI te oznake preskoči — lahko jih pustite v viru za druga orodja.

Oznaka PARAM vsebuje dodatni atribut izdelka kot par ime–vrednost:

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

Struktura Google Merchant produktnega vira

Za format Google Merchant Mira AI bere naslednje oznake. Celoten referenčni seznam najdete v uradni Google Merchant dokumentaciji.

Kategorija	Oznake	Opombe
Ovijalec izdelka (obvezno)	`item`, `entry`, `product`	Vsak izdelek ovije ena od teh oznak.
Opis (obvezno)	`title`, `description`, `product_type` (ali `google_product_category`), `link`, `price`	Za kategorijo uporabite `product_type` ali `google_product_category` s tekstovnim imenom — številčne ID-je kategorij trenutno še ne podpiramo.
Format cene	`price`	Dovoljen format: `236 CZK` ali `CZK 236`. Valuta je 3-črkovna oznaka (CZK, EUR, GBP…).
Akcijska cena (neobvezno)	`sale_price`, `sale_price_effective_date`	Če je `sale_price` na voljo, v isti valuti in nižja od `price`, Mira pri odgovorih, iskanju in na karticah navaja akcijsko ceno. Če je podan `sale_price_effective_date`, velja akcijska cena le v tem obdobju (preveri se ob vprašanju); izven tega ali če obdobja ni mogoče prebrati, uporabi običajno ceno. Obstoječi produktni viri prevzamejo akcijske cene ob naslednji posodobitvi.
Neobvezno	`availability`	Na zalogi: `in_stock`, `in stock`. Ni na voljo: `out_of_stock`, `out of stock`, `preorder`, `backorder`, drugo / manjka.
Slika	`image_link`	Slika izdelka, prikazana na kartici. Če manjka, Mira uporabi Open Graph ali izpostavljeno sliko na strani izdelka.
Sprezrto	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI te oznake preskoči — lahko jih pustite v viru za druga orodja.

Mira bere tudi velikosti izdelkov iz vašega produktnega vira (oznaka size) in jih lahko omeni ob priporočanju izdelkov. Velikosti so prikazane ob naslednji osvežitvi produktnega vira.

Opomba: Številčni google_product_category ID-ji še niso podprti. Vedno uporabite besedilno različico kategorije — na primer "Apparel & Accessories > Clothing > Shirts & Tops" — ali uporabite product_type.

Izvoz produktnih virov po platformah

Poiščite svojo e-commerce platformo v spodnji tabeli in sledite uradnemu vodiču za izvoz.

Platforma	Kaj generira	Uradni vodič
Shoptet	Heuréka in Google Shopping XML iz nadzorne plošče	XML produktni viri • Heuréka XML
Shopsys	Produktne vire s platforme in razvijalsko dokumentacijo	Produktni viri
Eshop-rychle	Vire za primerjalnike izdelkov	Izvoz izdelkov
Upgates	Izvoz XML podatkov s celotno strukturo izdelkov	Izvoz podatkov • Dokumentacija XML
Shoper	Google produktni vir neposredno iz platforme	Google produktni vir
Shopware	Google Shopping — neposreden izvoz ali preko dodatkov	Neposreden izvoz • Dodatki
Shoprenter	Google Shopping in Heuréka produktni viri	Google Shopping • Heuréka
PrestaShop	Google Shopping preko dodatkov	Dodatki
Magento	Google Shopping preko vtičnikov	Vtičniki
WooCommerce	Google produktni vir preko dodatkov	Dodatki • Priporočeno

Kaj sledi?

Uvod v Mira AI nakupovalni asistent — nastavite Mira AI in dodajte svoj produktni vir kot vir.
Kako začeti z usposabljanjem Mira AI — prilagodite AI odgovore z lastnimi pari vprašanj in odgovorov.
Mira AI - zaloga izdelkov — omogočite obiskovalcem preverjanje zaloge izdelkov.
Pogosta vprašanja o Mira AI nakupovalnem asistentu — pogosta vprašanja o Mira AI.

💡 Potrebuje še pomoč? Pišite naši ekipi za podporo — z veseljem vam bomo pomagali!

Sorodni članki

Kako izvoziti produktni vir iz različnih e-commerce platform za Mira AI nakupovalni asistent?