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

Vodič smo razdelili na naslednje sklope:

Produktni vir ali spletno strganje ne deluje? Odpravljanje težav z viri znanja Mira AI

Preden začnete

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

Za dodajanje produktnega vira v Smartsupp:

V urejevalniku asistenta odprite Znanje → Izdelki in kliknite Dodaj.
Vnesite ime vira.
Prilepite celoten URL vašega produktnega vira.
V koraku Posodobitev izberite, kako pogosto naj se produktni vir osvežuje.

Namig: Glejte Uvod v Mira AI za celotno nastavitev.

Mira AI vaš produktni vir samodejno osvežuje v rednih intervalih — spremembe cen, posodobitve zaloge in novi izdelki se prikažejo v klepetu brez ponovnega nalaganja datoteke.

Opomba: Mira AI nalaga slike izdelkov na karticah neposredno iz vašega XML produktnega vira. Če slika izdelka v viru manjka, Mira uporabi Open Graph ali predstavljeno sliko na strani izdelka — zato priporočamo, da sta tudi ti nastavljeni.

Opomba: Če vaš strežnik omejuje dohodne povezave (firewall, seznam dovoljenih IP-jev), omogočite dostop IP-naslovom za pridobivanje virov Smartsupp: 94.130.187.58 in 188.245.65.74. Sicer 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 osveževati, preverite ta članek za aktualni seznam ali kontaktirajte našo podporo.

Podprti formati produktnih virov

Mira AI podpira dva standardna formata produktnega vira — Heuréka in Google Merchant. Oba sledita običajnim XML standardom:

Končnica datoteke je .xml ali .rss.
Prva vrstica se mora začeti z <?xml ...?> ali <rss ...>.
Nadrejena oznaka obdaja vse izdelke. Nadrejena oznaka ima lahko katerokoli ime (npr. <SHOP>) — pomembna je le njena prisotnost.
Vsak izdelek je ovit v svojo oznako (glejte razdelek o določenih formatih spodaj).

Minimalna veljavna struktura izgleda takole:

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

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

Struktura Heuréka produktnega vira

Za format Heuréka Mira AI bere naslednje oznake. Celotno specifikacijo najdete v uradni dokumentaciji Heuréka XML produktnega vira.

Kategorija	Oznake	Opombe
Ovitek izdelka (obvezno)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Vsak izdelek je ovit v eno od teh oznak.
Opis (obvezno)	`PRODUCTNAME` (ali `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Vsaka oznaka mora vsebovati podatke. Prazne oznake štejejo kot manjkajoče.
Neobvezno	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = na zalogi, 1–7 = dobavljivo v enem tednu, karkoli drugega / manjkajoče = ni na voljo. `PARAM` se lahko ponovi poljubno krat na izdelek.
Slika	`IMGURL`	Slika izdelka prikazana na kartici. Če je ni, Mira uporabi Open Graph ali predstavljeno sliko na strani izdelka.
Prezrto	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI te oznake preskoči — lahko jih pustite v produktnem viru za druga orodja.

Oznaka PARAM nosi dodatne atribute izdelka v obliki para 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. Celotne reference najdete v uradni Google Merchant specifikaciji produktnega vira.

Kategorija	Oznake	Opombe
Ovitek izdelka (obvezno)	`item`, `entry`, `product`	Vsak izdelek je ovit v eno od teh oznak.
Opis (obvezno)	`title`, `description`, `product_type` (ali `google_product_category`), `link`, `price`	Za kategorijo uporabite `product_type` ali `google_product_category` z besedilnim imenom — številčne ID-je kategorij trenutno še ne podpiramo.
Oblika cene	`price`	Dovoljena oblika: `236 CZK` ali `CZK 236`. Sprejemamo decimalna in tisočiska ločila, na primer `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` ali `1 049,00 CHF`. Valuta je 3-črkovna koda (CZK, EUR, GBP…).
Akcijska cena (neobvezno)	`sale_price`, `sale_price_effective_date`	Če je `sale_price` prisotna, v isti valuti in nižja od `price`, Mira v odgovorih, iskanju izdelkov in na karticah prikazuje akcijsko ceno. Z `sale_price_effective_date` se akcijska cena uporabi le v navedenem časovnem obdobju (preverja se ob vprašanju); izven tega ali če ni mogoče prebrati obdobja, Mira uporabi redno ceno. Obstoječi produktni viri prevzamejo akcijsko ceno ob naslednji osvežitvi.
Neobvezno	`availability`	Na zalogi: `in_stock`, `in stock`. Ni na voljo: `out_of_stock`, `out of stock`, `preorder`, `backorder` ali katerakoli druga vrednost / manjkajoče.
Slika	`image_link`	Slika izdelka prikazana na kartici. Če je ni, Mira uporabi Open Graph ali predstavljeno sliko na strani izdelka.
Prezrto	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI te oznake preskoči — lahko jih pustite v produktnem viru za druga orodja.

Mira bere tudi velikosti izdelka iz vašega produktnega vira (oznaka size) in jih lahko omeni pri priporočilih izdelkov. Velikosti bodo prikazane po naslednji osvežitvi 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 produktnega vira po platformi

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

Platforma	Kaj generira	Uradni vodič
Shoptet	Heuréka & Google Shopping XML iz administracije	XML viri • Heuréka XML
Shopsys	Produktni viri prek platforme z dokumentacijo za razvijalce	Produktni viri
Eshop-rychle	Viri za primerjavo cen	Izvoz izdelkov
Upgates	Izvoz podatkov v XML s celotno strukturo izdelka	Izvoz podatkov • Dokumentacija XML
Shoper	Google produktni vir neposredno iz platforme	Google produktni vir
Shopware	Google Shopping — neposreden izvoz ali prek dodatkov	Neposreden izvoz • Dodatki
Shoprenter	Google Shopping & Heuréka produktni viri	Google Shopping • Heuréka
PrestaShop	Google Shopping prek dodatkov	Dodatki
Magento	Google Shopping prek razširitev	Razširitve
WooCommerce	Google produktni vir prek 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 usposabljati Mira AI — prilagodite AI odgovore s prilagojenimi pari vprašanj in odgovorov.
Mira AI - zaloga — omogočite obiskovalcem, da preverijo zalogo izdelka.
Mira AI nakupovalni asistent FAQ — pogosta vprašanja o Mira AI.

💡 Potrebuješ dodatno pomoč? Kontaktirajte našo ekipo za podporo — z veseljem pomagamo!

Sorodni članki

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