Mira AI apsipirkimo asistentas naudoja jūsų produktų srautą, kad rekomenduotų produktus, atsakytų į klausimus apie kainas ir patikrintų prekių likutį. Šiame vadove paaiškinami srautų formatai, kuriuos Mira AI priima, kokias žymas ji skaito ir kur rasti oficialias eksporto instrukcijas populiariausioms e. prekybos platformoms.

Vadovą suskirstėme į šias dalis:

Prieš pradedant

Mira AI priima standartinius XML produktų srautus – tokį patį formatą, kokį dauguma e. prekybos platformų generuoja Heuréka, Google Shopping, Zboží.cz ir panašioms prekyvietėms. Kuo informatyvesnis bus jūsų srautas (kaina, likutis, aprašymas, nuoroda, kategorija), tuo išmanesnės bus Mira rekomendacijos.

Norėdami pridėti srautą Smartsupp sistemoje:

Asistento kūrimo įrankyje atidarykite Knowledge base → XML product feed ir spustelėkite Add new source.
Įveskite šaltinio pavadinimą.
Įklijuokite visą savo produktų srauto URL.
Veiksme Update pasirinkite, kaip dažnai srautas turi atnaujinti duomenis.

Patarimas: Visą konfigūravimo procesą rasite straipsnyje Introduction to Mira AI.

Mira AI automatiškai periodiškai atnaujina jūsų produktų srautą – kainų pakeitimai, likučio atnaujinimai ir nauji produktai pokalbiuose atsiranda be jūsų rankinio failo įkėlimo.

Pastaba: Mira AI įkelia produktų kortelėse rodomus vaizdus tiesiogiai iš jūsų XML srauto. Jei produktui sraute nėra vaizdo, Mira naudoja atsarginį Open Graph arba išskirtinį vaizdą iš jūsų produkto puslapio, todėl verta pasirūpinti ir jais.

Pastaba: Jei jūsų serveris riboja įeinančius prisijungimus (ugniasienė, IP leidžiamų adresų sąrašas), būtinai leiskite prieigą iš Smartsupp srautų gavimo IP adresų: 94.130.187.58 ir 188.245.65.74. Kitu atveju Mira AI negalės atsisiųsti jūsų produktų srauto.

Palaikomi srauto formatai

Mira AI palaiko du standartinius produktų srautų formatus – Heuréka ir Google Merchant. Abu jie naudoja bendras XML konvencijas:

Failo plėtinys turi būti .xml arba .rss.
Pirma eilutė turi prasidėti <?xml ...?> arba <rss ...>.
Vienas tėvinis žymuo apgaubia visus produktų elementus. Tėvinis žymuo gali būti bet kokio pavadinimo (pvz., <SHOP>) – svarbu tik tai, kad jis egzistuotų.
Kiekvienas produktas turi būti apgaubtas atskiru elementu (žymeniu). Konkrečius formatus rasite tolesniuose skyriuose.

Minimalus galiojantis karkasas atrodo taip:

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

Svarbu: Jei trūksta privalomos žymos tam tikram produktui, visas tas produktas yra praleidžiamas kuriant Mira indeksą – lankytojai jo nematys tarp rekomendacijų. Įsitikinkite, kad kiekvienas produktas turi visas privalomas žymas su įrašytais duomenimis.

Heuréka srauto struktūra

Heuréka formatu Mira AI skaito toliau pateiktas žymas. Visą specifikaciją rasite oficialioje Heuréka XML srauto dokumentacijoje.

Kategorija	Žymos	Pastabos
Elemento apvalkalas (privaloma)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Kiekvienas produktas turi būti apgaubtas viena iš šių žymų.
Aprašymas (privaloma)	`PRODUCTNAME` (arba `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Kiekvienoje žymoje turi būti turinys. Tuščios žymos laikomos trūkstamomis.
Papildoma (neprivaloma)	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = yra sandėlyje, 1–7 = pristatymas per savaitę, bet kokia kita reikšmė / trūkstama reikšmė = nėra sandėlyje. `PARAM` gali kartotis neribotą skaičių kartų vienam produktui.
Vaizdas	`IMGURL`	Produkto vaizdas, rodomas kortelėje. Jei jo nėra, Mira naudoja atsarginį Open Graph arba išskirtinį vaizdą produkto puslapyje.
Ignoruojama	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI šių žymų nenaudoja – galite jas palikti sraute kitoms priemonėms.

Žyma PARAM aprašo papildomą produkto atributą kaip pavadinimo ir reikšmės porą:

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

Google Merchant srauto struktūra

Google Merchant formatu Mira AI skaito šias žymas. Visą specifikaciją rasite oficialioje Google Merchant srauto specifikacijoje.

Kategorija	Žymos	Pastabos
Elemento apvalkalas (privaloma)	`item`, `entry`, `product`	Kiekvienas produktas turi būti apgaubtas viena iš šių žymų.
Aprašymas (privaloma)	`title`, `description`, `product_type` (arba `google_product_category`), `link`, `price`	Kategorijai naudokite `product_type` arba `google_product_category` su teksto pavadinimu – skaitiniai kategorijų ID kol kas nepalaikomi.
Kainos formatas	`price`	Leidžiamas formatas: `236 CZK` arba `CZK 236`. Valiuta – 3 raidžių kodas (CZK, EUR, GBP ir pan.).
Papildoma (neprivaloma)	`availability`	Yra sandėlyje: `in_stock`, `in stock`. Nėra sandėlyje: `out_of_stock`, `out of stock`, `preorder`, `backorder`, bet kokia kita reikšmė / trūkstama reikšmė.
Vaizdas	`image_link`	Produkto vaizdas, rodomas kortelėje. Jei jo nėra, Mira naudoja atsarginį Open Graph arba išskirtinį vaizdą produkto puslapyje.
Ignoruojama	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI šių žymų nenaudoja – galite jas palikti sraute kitoms priemonėms.

Pastaba: Skaitiniai google_product_category ID dar nepalaikomi. Visada naudokite kategorijos teksto pavadinimą, pavyzdžiui, "Apparel & Accessories > Clothing > Shirts & Tops" – arba vietoj to naudokite product_type.

Srauto eksportas pagal platformą

Žemiau esančioje lentelėje raskite savo e. prekybos platformą ir sekite oficialų eksporto vadovą.

Platforma	Ką ji generuoja	Oficialus vadovas
Shoptet	Heuréka ir Google Shopping XML iš administravimo skydelio	XML Feeds • Heuréka XML
Shopsys	Produktų srautai per platformą su kūrėjų dokumentacija	Product Feeds
Eshop-rychle	Srautai kainų palyginimo sistemoms	Product Export
Upgates	XML duomenų eksportas su pilna produktų struktūra	Data Export • XML Docs
Shoper	Google produktų srautas tiesiogiai iš platformos	Google Feed
Shopware	Google Shopping – tiesioginis eksportas arba per priedus	Direct Export • Add-ons
Shoprenter	Google Shopping ir Heuréka srautai	Google Shopping • Heuréka
PrestaShop	Google Shopping per priedus	Add-ons
Magento	Google Shopping per plėtinius	Extensions
WooCommerce	Google Product Feed per priedus	Add-ons • Recommended

Kas toliau?

Introduction to Mira AI Shopping Assistant – sukonfigūruokite Mira AI ir pridėkite savo produktų srautą kaip šaltinį.
How to start training Mira AI – patikslinkite DI atsakymus naudodami individualias klausimų–atsakymų poras.
Mira AI - stock availability – leiskite lankytojams pasitikrinti, ar produktas yra sandėlyje.
Mira AI Shopping Assistant DUK – dažniausiai užduodami klausimai apie Mira AI.

💡 Reikia daugiau pagalbos? Susisiekite su mūsų klientų aptarnavimo komanda – mielai jums padėsime!

Susiję straipsniai

Kaip eksportuoti produktų srautus iš įvairių e. prekybos platformų Mira AI apsipirkimo asistentui?