„Mira AI apsipirkimo asistentas“ naudoja jūsų produktų srautą tam, kad rekomenduotų produktus, atsakytų į klausimus apie kainas ir patikrintų prekių likutį. Šioje instrukcijoje paaiškinama, kokius srautų formatus „Mira AI“ priima, kokias žymas ji skaito ir kur rasti oficialias eksportavimo instrukcijas populiariausioms e. prekybos platformoms.

Šią instrukciją suskirstėme į šiuos skyrius:

Srautas ar duomenų rinkimas iš interneto neveikia? „Mira AI“ žinių šaltinių trikčių šalinimas

Prieš pradedant

„Mira AI“ priima standartinius XML produktų srautus — tuo pačiu formatu, kurį generuoja dauguma e. prekybos platformų skirtų Heuréka, Google Shopping, Zboží.cz ir panašioms rinkoms. Kuo pilnesnis bus jūsų srautas (kaina, likutis, aprašymas, nuoroda, kategorija), tuo išmanesnės bus „Mira“ rekomendacijos.

Norėdami pridėti srautą Smartsupp programoje:

Asistento kūrimo priemonėje atverkite Žinių bazė → Produktai ir spustelėkite Pridėti.
Įveskite šaltinio pavadinimą.
Įklijuokite pilną produktų srauto URL.
Žingsnyje Atnaujinti pasirinkite, kaip dažnai srautas turėtų būti atnaujinamas.

Patarimas: Visą sąranką žiūrėkite Įvadas į „Mira AI“.

„Mira AI“ automatiškai reguliariai atnaujina jūsų produktų srautą — kainų pokyčiai, likučio atnaujinimai ir nauji produktai pokalbių lange pasirodo be papildomo failo įkėlimo.

Pastaba: „Mira AI“ atvaizduoja produktų kortelių nuotraukas tiesiai iš jūsų XML srauto. Jei sraute nėra produkto nuotraukos, „Mira“ naudoja Open Graph arba pagrindinį paveikslėlį produkto puslapyje — todėl verta pasirūpinti, kad ir jie būtų nustatyti.

Pastaba: Jei jūsų serveris riboja įeinančias užklausas (ugniasienė, IP leidžiamų sąrašas), įtraukite Smartsupp srauto gavimo IP adresus į leidžiamų sąrašą: 94.130.187.58 ir 188.245.65.74. Priešingu atveju „Mira AI“ negalės atsisiųsti jūsų produktų srauto.

Šie IP adresai retkarčiais gali keistis. Jei staiga srautas nebeatsinaujina, peržiūrėkite šį straipsnį dėl naujausio sąrašo arba susisiekite su mūsų palaikymo komanda.

Palaikomi srauto formatai

„Mira AI“ palaiko du standartinius produktų srauto formatus — Heuréka ir Google Merchant. Abu naudoja standartines XML konvencijas:

Failo plėtinys turi būti .xml arba .rss.
Pirmoji eilutė turi prasidėti <?xml ...?> arba <rss ...>.
Visus produktus apjungia vienas tėvinis žymų blokas. Šio tėvinio žymos pavadinimas gali būti bet koks (pvz., <SHOP>) — svarbu tik, kad egzistuotų.
Kiekvienas produktas įvyniojamas į savo žymą (žiūrėkite formato specifikaciją žemiau).

Minimalus galiojantis karkasas atrodo taip:

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

Svarbu: Jei privalomos žymos trūksta produkte, visas šis produktas bus praleistas „Mira“ indekse — lankytojai jo nematys rekomendacijose. Įsitikinkite, kad kiekvienas produktas turi užpildytas visas privalomas žymas.

Heuréka srauto struktūra

Heuréka formatu „Mira AI“ skaito šias žymas. Pilną specifikaciją rasite oficialioje Heuréka XML srauto dokumentacijoje.

Kategorija	Žymos	Pastabos
Prekės apgaubimas (privaloma)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Kiekvienas produktas turi būti įvyniotas į vieną iš šių žymų.
Aprašymas (privaloma)	`PRODUCTNAME` (arba `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Kiekvienoje žymoje turi būti turinys. Tuščios žymos laikomos nepridėtomis.
Savanoriškos	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = yra sandėlyje, 1–7 = bus per savaitę, kiti atvejai / nėra = nėra. `PARAM` galima naudoti bet kiek kartų kiekvienam produktui.
Nuotrauka	`IMGURL`	Produkto nuotrauka rodoma kortelėje. Jei trūksta, „Mira“ naudoja Open Graph arba pagrindinį paveikslėlį produkto puslapyje.
Nekreipiama dėmesio	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	„Mira AI“ šių žymų neskaitys — galite palikti jas sraute kitiems įrankiams.

Žyma PARAM gali perduoti papildomą produkto savybę kaip pavadinimo–reikšmės porą:

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

Google Merchant srauto struktūra

Google Merchant formatu „Mira AI“ skaito šias žymas. Pilna informacija yra oficialioje Google Merchant srauto specifikacijoje.

Kategorija	Žymos	Pastabos
Prekės apgaubimas (privaloma)	`item`, `entry`, `product`	Kiekvienas produktas turi būti įvyniotas į vieną 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 tekstiniu pavadinimu — skaitmeniniai kategorijų ID dar nepalaikomi.
Kainos formatas	`price`	Leistinas formatas: `236 CZK` arba `CZK 236`. Priimtini ir skaičių skirtukai (tūkstančių, skilčių, kableliai). Valiuta turi būti 3 raidžių kodas (CZK, EUR, GBP…).
Pardavimo kaina (pasirinktinai)	`sale_price`, `sale_price_effective_date`	Jei yra `sale_price` ir jis mažesnis už `price` ta pačia valiuta, „Mira“ nurodo pardavimo kainą atsakymuose, produktų paieškoje ir produktų kortelėse. Jei yra `sale_price_effective_date`, pardavimo kaina taikoma tik tos datos laikotarpiu (tikrinama klausimo užklausos metu); kitu laiku arba jei laikotarpio nepavyksta nurodyti, taikoma paprasta kaina. Esami srautai akciją aptinka kitame atnaujinime.
Savanoriška	`availability`	Sandėlyje: `in_stock`, `in stock`. Nėra: `out_of_stock`, `out of stock`, `preorder`, `backorder` ar bet kas kitas / tuščia.
Nuotrauka	`image_link`	Produkto nuotrauka rodoma kortelėje. Jei trūksta, „Mira“ naudoja Open Graph arba pagrindinį paveikslėlį produkto puslapyje.
Nekreipiama dėmesio	`id`, `gtin`, `checkout_link_template`, `item_group_id`	„Mira AI“ šių žymų neskaitys — galite palikti jas sraute kitiems įrankiams.

„Mira AI“ taip pat nuskaito produktų dydžius iš srauto (su size žyma) ir, jei reikia, gali juos paminėti rekomenduodama produktus. Dydžiai atsinaujina kartu su srautu.

Pastaba: Skaitmeniniai google_product_category ID dar nepalaikomi. Visada naudokite kategorijos pavadinimą tekstu — pavyzdžiui, „Apparel & Accessories > Clothing > Shirts & Tops“ — arba naudokite product_type.

Eksportuoti srautą pagal platformą

Raskite savo e. prekybos platformą žemiau esančioje lentelėje ir sekite oficialią eksportavimo instrukciją.

Platforma	Ką generuoja	Oficiali instrukcija
Shoptet	Heuréka & Google Shopping XML iš administravimo skydelio	XML srautai • Heuréka XML
Shopsys	Produktų srautai per platformą su kūrėjų dokumentacija	Produktų srautai
Eshop-rychle	Srautai palyginimo portalams	Produktų eksportas
Upgates	XML duomenų eksportas su visa produktų struktūra	Duomenų eksportas • XML dokumentacija
Shoper	Google produktų srautas tiesiai iš platformos	Google srautas
Shopware	Google Shopping — tiesioginis eksportas arba per priedus	Tiesioginis eksportas • Priedai
Shoprenter	Google Shopping & Heuréka srautai	Google Shopping • Heuréka
PrestaShop	Google Shopping per priedus	Priedai
Magento	Google Shopping per plėtinius	Plėtiniai
WooCommerce	Google produktų srautas per priedus	Priedai • Rekomenduojama

Kas toliau?

Įvadas į „Mira AI apsipirkimo asistentą“ — sukonfigūruokite „Mira AI“ ir pridėkite savo produktų srautą kaip šaltinį.
Kaip pradėti „Mira AI“ mokymus — patikslinkite DI atsakymus su pasirinktinais klausimų–atsakymų poromis.
„Mira AI“ - prekių likutis sandėlyje — leiskite lankytojams pasitikrinti, ar prekė yra sandėlyje.
„Mira AI apsipirkimo asistento“ DUK — dažniausiai užduodami klausimai apie „Mira AI“.

💡 Reikia daugiau pagalbos? Susisiekite su mūsų palaikymo komanda — mielai jums padėsime!

Susiję straipsniai

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