XML feedek

Hogyan működik az XML feed és mire szolgál?

Az XML feedek olyan állományok, amelyek részletes információkat tartalmaznak a webáruházában értékesített termékekről (megnevezésüket, árukat, leírásaikat, stb.). Ha regisztrálni kíván az árukereső oldalakon, mint például az Árukereső, a Google Vásárlás és sok más, szüksége lesz ezekre az fájlokra, amelyek az adott szolgáltatás forrásaként funkcionálnak majd.

A Shoptet általános importokat generál a keresőoldalak részére, és nem nyújt technikai támogatást harmadik személyeknek.

Ha valamelyik keresőoldal nem indexeli az oldalát vagy nem párosítja némely termékét, kérdésével forduljon közvetlenül az adott keresőoldal technikai ügyféltámogatásához. A keresőoldalak nagy részének admin felületén található egy hibalista, amelyben feltünteti, miért nem jelenítődnek meg a termékei (lehet, hogy hiányoznak az EAN kódok, hibásan vannak megjelölve a kategóriák, stb.).

Az XML feedek módosításai nem futnak le azonnal. Miután módosította az XML feedeket, eltelhet két óra is, mire a változások átíródnak a keresőoldalakra.

XML feed nyelve és országa

Alapértelmezetten, az Összekapcsolás → XML feedek menüpontban található összes rendszer által generált XML feed mindig elérhető az e-shop alapértelmezett nyelvén és a szállítási ország adataival. Ha e-shopjában több nyelv van aktiválva, vagy több országba történő szállítási lehetőséget kínál különböző pénznemekkel és szállítási módokkal, és ezeket az adatokat szeretné átvinni valamelyik feedbe, rendszerünk ezt lehetővé teszi.

A feed URL-címének más nyelven és egy másik ország adataival való lekéréséhez lépjen az Összekapcsolás → XML feedek menüpontba, kattintson a Szűrés gombra, válassza ki a megfelelő nyelvet és országot, majd kattintson a zöld Szűrés gombra. A feedek URL-címei a kiválasztott nyelv és ország szerint jelennek meg az áttekintő táblázatban.

Példa az XML feedek angol nyelvű szűrésére

Hogyan szerez tudomást az ár- és termék-összehasonlító oldal az üzletemről?

Minden termékkeresőbe külön és manuálisan kell regisztrálni közvetlenül az adott böngésző oldalain. A böngésző által igényelt információk általában a bolttal és az üzemeltetővel kapcsolatos általános adatok, valamint az XML export URL-je, ahonnan le fogja majd tölteni az információkat az áruról.

Milyen XML feedeket kínál fel az admin felület?

Rendszer-értelmezett: maga a rendszer generálja ezeket és semmilyen beavatkozás nem megengedett bennük, az Összekapcsolás → XML feedek menüpontban találhatók. Jelenleg rendszerszintű feedet kínálunk az Árukereső, a Google Vásárlás, a Facebook katalógus, a Glami és az OpenAI ChatGPT Ads szolgáltatása számára.

Felhasználói: ezek tetszés szerint szerkeszthetők. A Hozzáad gombra kattintva hozhat létre új XML állományt. A Beállítás oszlopban található kék nyílra kattintva szerkesztheti a már meglévő feedet. Ezt követően a részletekben lehetővé válik az XML állomány struktúrájának kitöltése, amelynél használhatja a következőkben ismertetett átmásoló jeleket is. A Haladó fülön módosítható a pénznem vagy letiltható az átvitel néhány kategóriánál.

Felhasználói XML feed szerkesztésének részletei

Haladó fül a felhasználói XML feed beállításaiban

Miért jelenik meg a keresőben az ismeretlen elérhetőség?

Hogy a keresőmotor tudja, milyen hosszú a konkrét kézbesítési idő, egyértelműen tudatni kell vele. Minden ön által meghatározott kézbesítési időnél tehát be kell állítani az órában kifjezett alternatívát. Bővebben a kézbesítési idők beállításáról a Elérhetőség súgóban.

Milyen márkákat használhatok az export beállításában?

Kód	Leírás
#CODE#	Az áru kódja
#EXTERNAL_ID#	Külső ID. Segít párosítani a változatokat a konkrét termékkel. Használatával mellőzhető az összes többi változat megadása az XML fájlban.
#MANUFACTURER#	Gyártó, márka neve
#NAME#	A termék, illetve a változat neve (abban az esetben, ha az XML állományban ki van töltve a név, csak az XML állományban másolódik át a név).
#CLEAR_PRODUCT_NAME#	A termék megnevezése
#CLEAR_PRODUCT_NAME_VARIANT#	A termék megnevezése, illetve a változatok értéke
#SHORT_DESCRIPTION#	A termék rövid leírása
#SHORT_DESCRIPTION__NO_HTML#	A termék rövid leírása HTML jelek nélkül
#SHORT_DESCRIPTION__NO_SCRIPT#	A termék rövid leírása SCRIPT jel nélkül
#DESCRIPTION#	A termék részletes leírása (haladó felhasználóknak: tartalmaz WYSIWYG szerkesztőn keresztül bevitt html tageket is és CDATA taget, amely meggátolja szintaktikai elemzésüket). Maximális hossz: 32767 karakter.
#URL#	A termék URL címe
#IMG_URL#	Kép URL-je
#IMG_ALT_URL1#	Alternatív képek URL-je (több képnél használható a #IMG_ALT_URL2#, #IMG_ALT_URL3#, stb., számban nincs korlátozás)
#IMG_ORIG_URL#	Az eredeti kép URL-je vízjel nélkül
#PRICE_VAT#	A termék ára (vagy akciós ár, ha aktív) ÁFA-val
PRICE	A termék ára (vagy akciós ár, ha aktív) ÁFA nélkül
#OLD_PRICE_VAT#	A termék standard ára ÁFA-val
#OLD_PRICE#	A termék standard ára ÁFA- nélkül
#VAT#	ÁFA százalékos meghatározása
#CATEGORYTEXT#	Az alapértelmezett termékkategória neve
#AVAILABILITY#	Szállítási határidő
#AVAILABILITY_HOURS#	Szállítási határidő órákban
#AVAILABILITY_DAYS#	Szállítási határidő napokban
#AVAILABILITY_GOOGLE#	Szállítási határidő a Google Vásárlásnál
#COMPLETE_PATH#	A termék elérési útja ("kategória - alkategória - ...")
#COMPLETE_PATH_GT#	A termék elérési útja ("kategória alkategória ...")
#COMPLETE_PATH_SLASH#	A termék elérési útja ("kategória/alkategória/ ...")
#COMPLETE_PATH_PIPE#	A termék elérési útja ("kategória \| alkategória \| ...")
#TOLLFREE#	Vagy 0-ás vagy 1-es értéket mutat attól függően, hogy ez az opció a konkrét termék részletében be van-e jelölve.
#FIRMY_CZ#	Vagy 0-ás vagy 1-es értéket mutat attól függően, hogy ez az opció a konkrét termék részletében be van-e jelölve.
#PRODUCT_NAME#	A termék bővített megnevezése, a termék részletéből íródik át a Haladó mező „név az XML feedben“ kártyáról. Ha a jelet használni szeretné, minden terméknél ki kell tölteni vagy ne hagyja a jelet különállóan, mert akkor a tag üresen marad.
#ITEM_TYPE# #ITEM_TYPE_HEUREKA# #ITEM_TYPE_GOOGLE#	Az áru típusa (új vagy használt), kiválasztható a kereső szerinti optimalizálás
#PRODUCT_NUMBER#	Termék száma / ISBN
#PART_NUMBER#	Part number
#PLU#	Termék PLU
#EAN#	Termék EAN
#TAG_G_IDENTIFIER_EXISTS_FALSE__IF_NO_EAN#	Ha az EAN nincs kitöltve, beíródik a `FALSE`
#PRODUCT_NAME_EXT#	Átmásolja a változat értékét.
#MIN_ORDER_AMOUNT_PRICE_VAT#	Tartalmazza a legkisebb megrendelhető mennyiség PRICE_VAT *-ját, ha a bővítmény aktív és be van állítva a legkisebb megrendelhető mennyiség
#CODE_HEUREKA#	Ha Csehországba értékesít, és átviszi a termék kódját, amely megegyezik azzal, amely a rendszerfüggő feedben a Heureka felé van megadva. Tehát a törtvonal helyébe rövid kötőjel kerül, stb.

Az XML feedekhez való hozzáférés bebiztosítása

Webáruháza XML feedjeinek hozzáférését biztonságossá teheti. Az admin felületen az Összekapcsolás → XML feedek menüpontban válassza ki a Beállítás könyvjelzőt. Két biztonságvédelmi lehetőség áll rendelkezésre:

A globális fehérlistán (whitelist) nem szereplő IP címekről való hozzáférés letiltása (a továbbiakban mint a fehérlista aktiválása).
Biztonsági hash nélküli IP címekről való hozzáférés letiltása.

Az XML feedekhez való hozzáférés védelmének beállításai

Ha olyan feedjeit letöltő szolgáltatást használ, amely nem szerepel a fehérlistán (whitelist), akkor a fehérlista aktiválása esetében ennek a szolgáltatásnak hash paraméter segítségével kell lehetővé tenni a hozzáférést.

Ha aktiválja mindkét lehetőséget, engedélyezve lesz a globális fehérlistán szereplő IP címekről való feed-letöltés, és ezzel egyidejűleg minden olyan IP címről is, amely hasht tartalmazó URL címről közelíti meg a feedeket.

Az admin felületen található fehérlistán gyűjtöttük össze a megbízható szolgáltatástok jegyzékét, de nem garantáljuk, hogy a lista teljes.

Mi van, ha Szlovákiában árulok? Reklámozhatok magyar kereső oldalakon?

Szlovákiai ügyfeleinknek lehetővé tesszük a Srovname.cz, Zboží.cz és a Hledejceny.cz árösszehasonlító oldalakon való regisztrációt. Ezt követően a webáruháznak a következő feltételeknek kell megfelelnie: