Preskoči na glavno vsebino

Kako izvoziti katalog izdelkov z različnih e-commerce platform za Mira AI nakupovalni asistent?

Ugotovite, kako izvoziti kataloge izdelkov iz priljubljenih e-commerce platform in jih povezati z Mira AI nakupovalnim asistentom, da omogočite pametna priporočila izdelkov.

Mira AI nakupovalni asistent uporablja vaš katalog izdelkov, da priporoča izdelke, odgovarja na vprašanja o cenah in preverja razpoložljivost. Ta vodnik razlaga formate katalogov izdelkov, ki jih Mira AI sprejema, oznake, ki jih bere, in kje najti uradna navodila za izvoz za najbolj priljubljene e-commerce platforme.

Vodnik smo razdelili na naslednje razdelke:


Preden začnete

Mira AI sprejema standardne XML kataloge izdelkov – enak format, kot ga večina e-commerce platform generira za Heuréka, Google Shopping, Zboží.cz in podobne tržnice. Bolj kot je vaš katalog bogat (cena, razpoložljivost, opis, povezava, kategorija), pametnejša bodo Mirina priporočila.



Če želite katalog dodati v Smartsupp:

  1. V gradniku asistenta odprite Knowledge base → XML Product feed in kliknite Add new source.

  2. Vnesite ime vira.

  3. Prilepite celoten URL vašega kataloga izdelkov.

  4. V koraku Update izberite, kako pogosto naj se katalog osveži.


Namig: Glejte Introduction to Mira AI za celotno nastavitev.


Mira AI samodejno osvežuje vaš katalog izdelkov v rednih intervalih – spremembe cen, posodobitve razpoložljivosti in novi izdelki se prikažejo v klepetu, ne da bi bilo treba datoteke znova naložiti.

Opomba: Mira AI nalaga slike na karticah izdelkov neposredno iz vašega XML kataloga. Če izdelek v katalogu nima slike, Mira uporabi Open Graph ali predstavljeno sliko na strani izdelka – zato se splača poskrbeti tudi za ti dve možnosti.

Opomba: Če vaš strežnik omejuje dohodne povezave (požarni zid, seznam dovoljenih IP naslovov), poskrbite, da omogočite dostop z naslednjih IP naslovov pridobivalnika katalogov Smartsupp: 94.130.187.58 in 188.245.65.74. Sicer Mira AI ne bo mogla prenesti vašega kataloga izdelkov.


Podprti formati kataloga

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

  • Končnica datoteke je .xml ali .rss.

  • Prva vrstica se mora začeti z <?xml ...?> ali <rss ...>.

  • En nadrejeni element (parent tag) zajema vse izdelke. Nadrejeni element je lahko poljubnega imena (npr. <SHOP>) — pomembno je le, da obstaja.

  • Vsak izdelek je zajet v svojem lastnem elementu item (glejte spodaj razdelke, specifične za posamezen format).

Minimalna veljavna osnova izgleda takole:

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

Pomembno: Če obvezni element manjka pri izdelku, je celoten ta izdelek izpuščen iz Mirinega indeksa — obiskovalci ga ne bodo videli v priporočilih. Poskrbite, da ima vsak izdelek izpolnjene vse zahtevane elemente.


Struktura kataloga Heuréka

Za format Heuréka Mira AI bere naslednje oznake. Glejte uradno dokumentacijo XML kataloga Heuréka za celotno specifikacijo.

Kategorija

Oznake

Opombe

Ovojnica elementa (obvezno)

SHOPITEM, PRODUCT, PRODUKT

Vsaka od teh oznak ovije posamezen izdelek.

Opis (obvezno)

PRODUCTNAME (ali PRODUCT), DESCRIPTION, URL, PRICE_VAT, CATEGORYTEXT

Vsaka oznaka mora vsebovati vsebino. Prazne oznake štejejo kot manjkajoče.

Neobvezno

DELIVERY_DATE, PARAM

DELIVERY_DATE: 0 = na zalogi, 1–7 = dobavljivo v enem tednu, vse drugo / manjkajoče = nedobavljivo. PARAM se lahko za vsak izdelek ponovi poljubno velikokrat.

Slika

IMGURL

Slika izdelka, prikazana na kartici. Če manjka, Mira uporabi Open Graph ali predstavljeno sliko na strani izdelka.

Prezrto

DOSTAVA, EAN, ITEM_ID, DDV, ITEMGROUP_ID, ACCESSORY, MANUFACTURER

Mira AI te oznake preskoči — v katalogu jih lahko pustite za druga orodja.

A PARAM Oznaka prenaša dodatni atribut izdelka kot par ime–vrednost:

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


Struktura Google Merchant kataloga

Za format Google Merchant Mira AI bere naslednje oznake. Glejte uradno specifikacijo Google Merchant kataloga za celoten seznam.

Kategorija

Oznake

Opombe

Ovoj izdelka (obvezno)

item, entry, product

Vsak izdelek je ovit v eno od teh oznak.

Opis (obvezno)

Naslov, Opis, product_type (ali google_product_category), Povezava, Cena

Za kategorijo uporabite product_type ali google_product_category z besedilnim imenom — številčni ID-ji kategorij trenutno niso podprti.

Oblika cene

cena

Dovoljena oblika: 236 CZK ali CZK 236. Valuta je 3-mestna koda (CZK, EUR, GBP…).

Neobvezno

availability

Na zalogi: in_stock, na zalogi. Ni na zalogi: out_of_stock, ni na zalogi, preorder, backorder, karkoli drugega / manjkajoče.

Slika

image_link

Slika izdelka, prikazana na kartici. Če manjka, 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 katalogu za druga orodja.

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


Izvoz kataloga po platformi

V spodnji tabeli poiščite svojo e-commerce platformo in sledite uradnemu vodniku za izvoz.

Platforma

Kaj ustvari

Uradni vodnik

Shoptet

Heuréka & Google Shopping XML iz administrativne plošče

Shopsys

Katalogi izdelkov prek platforme z dokumentacijo za razvijalce

Eshop-rychle

Viri za primerjalnike cen

Upgates

Izvoz podatkov XML s celotno strukturo izdelkov

Shoper

Google produktni vir neposredno s platforme

Shopware

Google Shopping – neposredni izvoz ali preko dodatkov

Shoprenter

Google Shopping & Heuréka viri

Prestashop

Google Shopping preko dodatkov

Magento

Google Shopping preko razširitev

WooCommerce

Google produktni vir preko dodatkov


Kaj sledi?

💡 Potrebujete dodatno pomoč? Stopite v stik z našo ekipo za podporo — z veseljem vam bomo pomagali!

Ste s tem dobili odgovor na svoje vprašanje?