Mira AI nakupovalni asistent uporablja vaš produktni vir za priporočanje izdelkov, odgovarjanje na vprašanja o cenah in preverjanje razpoložljivosti. Ta vodič pojasnjuje, katere formate produktnega vira 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 za Mira AI

Preden začnete

Mira AI sprejema standardne XML produktne vire — v istem formatu, kot jih večina e-commerce platform ustvarja 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 produknega vira v Smartsupp:

V orodju za urejanje asistenta odprite Zbirka znanja → Izdelki in kliknite Dodaj.
Vnesite ime vira.
Prilepite celotni URL vašega produktnega vira.
V koraku Posodobitev izberite, kako pogosto naj se vir osveži.

Namig: Za celotno nastavitev glejte Uvod v Mira AI.

Mira AI samodejno osveži vaš produktni vir v rednih intervalih — spremembe cen, posodobitve razpoložljivosti in novi izdelki se prikažejo v klepetu, brez da bi morali znova naložiti datoteko.

Opomba: Mira AI nalaga slike produktnih kartic neposredno iz vašega XML produktnega vira. Če izdelek nima slike v viru, Mira uporabi Open Graph ali izpostavljeno sliko na strani izdelka — zato je vredno poskrbeti tudi za to.

Opomba: Če vaš strežnik omejuje dohodne povezave (firewall, seznam dovoljenih IP), zagotovite dostop iz IP naslovov Smartsupp za prenos produktnega vira: 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 produktnega vira

Mira AI podpira dva standardna formata produktnega vira — Heuréka in Google Merchant. Oba sledita skupnim konvencijam XML:

Končnica datoteke je .xml ali .rss.
Prva vrstica se mora začeti z <?xml ...?> ali <rss ...>.
Vsi izdelki so oviti z eno nadrejeno oznako. Nadrejena oznaka ima lahko katerokoli ime (npr. <SHOP>) — pomemben je le njen obstoj.
Vsak izdelek je ovit v svojo oznako (glejte poglavja za posamezen format spodaj).

Minimalna veljavna osnova izgleda takole:

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

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

Struktura Heuréka produktnega vira

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

Kategorija	Oznake	Opombe
Ovojnica izdelka (obvezno)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Vsak izdelek je ovit v eno izmed teh oznak.
Opis (obvezno)	`PRODUCTNAME` (ali `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Vsaka oznaka mora vsebovati vsebino. Prazen tag šteje kot manjkajoč.
Neobvezno	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = na zalogi, 1–7 = dobava do enega tedna, ostalo / manjkajoče = ni na voljo. `PARAM` se lahko večkrat ponovi pri izdelku.
Slika	`IMGURL`	Slika izdelka, prikazana na kartici. Če manjka, Mira uporabi Open Graph ali izpostavljeno sliko na strani izdelka.
Prezrto	`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. Celotno referenco najdete v uradni specifikaciji Google Merchant produktnega vira.

Kategorija	Oznake	Opombe
Ovojnica 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 — numerične ID kategorij še niso podprte.
Oblika cene	`price`	Dovoljena oblika: `236 CZK` ali `CZK 236`. Dovoljeni so decimalni in tisočinski ločila, na primer `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` ali `1 049,00 CHF`. Valuta mora biti 3-črkovna oznaka (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 navaja akcijsko ceno. Če je podan še `sale_price_effective_date`, akcijska cena velja samo v tem obdobju (preveri se v trenutku vprašanja); izven tega obdobja, ali če območja ni mogoče prebrati, Mira 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`, vse ostalo / manjkajoče.
Slika	`image_link`	Slika izdelka, prikazana na kartici. Če manjka, Mira uporabi Open Graph ali izpostavljeno sliko s strani izdelka.
Prezrto	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI te oznake preskoči — lahko jih pustite v viru za druga orodja.

Mira prav tako bere velikosti izdelkov iz vašega produktnega vira (oznaka size) in jih lahko omeni pri priporočanju izdelkov. Velikosti se prikažejo, ko se produktni vir osveži.

Opomba: Numerični google_product_category ID-ji še niso podprti. Vedno uporabite besedilno različico kategorije — na primer "Apparel & Accessories > Clothing > Shirts & Tops" — ali pa 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 Feedi • Heuréka XML
Shopsys	Produktni viri preko platforme z dokumentacijo za razvijalce	Product Feeds
Eshop-rychle	Viri za primerjalnike cen	Izvoz izdelkov
Upgates	XML izvoz podatkov s celotno strukturo izdelkov	Izvoz podatkov • XML dokumentacija
Shoper	Google produktni vir neposredno iz platforme	Google Feed
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 z usposabljanjem Mira AI — prilagodite AI odgovore s pari vprašanje-odgovor.
Mira AI – zaloga izdelkov — omogočite obiskovalcem preverjanje, ali je izdelek na zalogi.
Mira AI nakupovalni asistent – pogosta vprašanja — pogosta vprašanja o Mira AI.

💡 Potrebujete dodatno pomoč? Obrnite se na našo ekipo za podporo — z veseljem vam pomagamo!

Sorodni članki

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