Partnereknek

Feed URL beállítása

Ez az oldal azt írja le, hogyan tudod a webáruházad termékadatait XML feed formájában eljuttatni a KockaKeresőnek — attól függően, hogy melyik webáruház-motort használod.

UNASShoprenterShoptetEgyéni
⚠️

Fontos: a KockaKereső kizárólag új LEGO® termékeket fogad be. Ha a webáruházad nem csak LEGO® terméket árul, a feedet szűrni kell, hogy csak a LEGO® kategória kerüljön bele — ennek módját platformonként lásd lent.

01 — Minden platformra érvényes

Alapkövetelmények

  • A feednek a webáruház által forgalmazott összes LEGO® készletet tartalmaznia kell — ez az oldalunk lényege, hogy teljes körű árösszehasonlítást tudjunk nyújtani. Egy részleges vagy kihagyásokkal teli feed nem felel meg a célnak.
  • A feed elérési útjának nyilvánosan elérhető, publikus URL-nek kell lennie (bejelentkezés vagy jelszó nélkül elérhető).
  • Formátum: XML, UTF-8 kódolással.
  • A feednek rendszeresen, automatikusan frissülnie kell.
  • Csak LEGO® termékeket tartalmazzon — más kategóriákat ki kell zárni.
  • Csak új állapotú termékeket tartalmazzon — használt/bontott/sérült terméket nem fogadunk el.
  • Az árak bruttó (ÁFÁ-s) árak legyenek, forintban (HUF).
  • Minden termékhez tartozzon egyedi termékkód/cikkszám (ideális esetben a LEGO® szett száma, pl. 42115-1 vagy 42115).

02 — Formátum

Az elvárt XML mezőstruktúra

A KockaKereső feed-feldolgozója az alábbi, #TAG# jelöléssel ellátott mezőneveket ismeri fel — ez a KockaKereső saját XML feed formátuma.

MezőLeírásKötelező?
#CODE#Az áru egyedi kódja / cikkszámaIgen
#MANUFACTURER#Gyártó, márka neve (LEGO®)Igen
#NAME#A termék (illetve változat) neveIgen
#CLEAR_PRODUCT_NAME#A termék "tiszta" megnevezése (márka/extra jelzők nélkül)Ajánlott
#SHORT_DESCRIPTION#A termék rövid leírásaAjánlott
#URL#A termék oldalának URL-je a webáruházbanIgen
#IMG_URL#A termékkép URL-jeIgen
#PRICE_VAT#A termék ára (vagy akciós ár, ha aktív), ÁFÁ-valIgen
#OLD_PRICE_VAT#A termék eredeti (nem akciós) ára, ÁFÁ-valAjánlott (akció esetén)
#AVAILABILITY#Készletinformáció (Pl.: Raktáron, Elérhető, Rendelésre, Nincs készleten, Előrendelhető, stb.)Igen
#PRODUCT_NAME#A termék bővített megnevezéseOpcionális
#ITEM_TYPE#Az áru típusa — csak "új" termékek fogadhatók el, használt terméket nem tartalmazhat a feedAjánlott
#PRODUCT_NUMBER#Termékszám / ISBN (LEGO esetén a szettszám)Ajánlott
#NET_PRICE#A termék nettó áraOpcionális
#DELIVERY_TIME#A termék szállítási idejeOpcionális
#DELIVERY_COST#A termék szállítási költségeOpcionális
#FREEDELIVERY#Ingyenes szállítás jelölése (igen/nem)Opcionális
#CATEGORY#A termék kategóriája (webáruházon belüli útvonala)Ajánlott
#IDENTIFIER#A termék belső azonosítója (pl. EAN vagy adatbázis ID)Opcionális

Példa XML

<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
  <SHOPITEM>
    <CODE>LEGO42115</CODE>
    <MANUFACTURER>LEGO</MANUFACTURER>
    <NAME>LEGO Technic 42115 Lamborghini Sián FKP 37</NAME>
    <CLEAR_PRODUCT_NAME>Lamborghini Sián FKP 37</CLEAR_PRODUCT_NAME>
    <SHORT_DESCRIPTION>Prémium kategóriás LEGO Technic szett, 3696 elemmel.</SHORT_DESCRIPTION>
    <URL>https://pelda-webshop.hu/termek/lego-technic-42115</URL>
    <IMG_URL>https://pelda-webshop.hu/kepek/42115-1.jpg</IMG_URL>
    <PRICE_VAT>219990</PRICE_VAT>
    <OLD_PRICE_VAT>239990</OLD_PRICE_VAT>
    <AVAILABILITY>Elérhető</AVAILABILITY>
    <PRODUCT_NAME>LEGO Technic 42115 Lamborghini Sián FKP 37 - 3696 db-os építőjáték</PRODUCT_NAME>
    <ITEM_TYPE>új</ITEM_TYPE>
    <PRODUCT_NUMBER>42115-1</PRODUCT_NUMBER>
    <NET_PRICE>173220</NET_PRICE>
    <DELIVERY_TIME>1-3 munkanap</DELIVERY_TIME>
    <DELIVERY_COST>1490</DELIVERY_COST>
    <FREEDELIVERY>nem</FREEDELIVERY>
    <CATEGORY>LEGO / Technic</CATEGORY>
    <IDENTIFIER>5702016914619</IDENTIFIER>
  </SHOPITEM>
  <!-- további SHOPITEM blokkok, termékenként egy -->
</SHOP>

03 — Platform

UNAS

Az UNAS-hoz saját, névre szóló KockaKereső-integráció készült — saját logóval, közvetlenül kikereshető formátumként az UNAS árösszehasonlító export listájából. Nincs szükség egyedi XML sablon összeállítására, az UNAS automatikusan legenerálja a feed URL-t.

  1. 1
    Lépj be az UNAS admin felületére.
  2. 2
    Navigálj ide: Beállítások → Külső kapcsolatok → Árösszehasonlító export, Feed.
  3. 3
    Keresd meg a listában a KockaKereső integrációt (saját logóval jelenik meg), majd kattints a Hozzáadás / Módosítás gombra.
  4. 4
    Az UNAS automatikusan legenerálja a Feed URL mezőt, pl.: https://shop.unas.hu/admin_export.php?shop_id=[boltazonosító]&format=kockakereso.hu.
  5. 5
    Kapcsold be az Engedélyezem kapcsolót, majd kattints a Ment gombra.
  6. 6
    Állítsd be a feed URL-t a KockaKereső Partner Portálodon.

04 — Platform

Shoprenter

A Shoprenternél nincs szükség egyedi feed létrehozására — befogadjuk a webáruházban már meglévő, más integrációkhoz generált XML feedek linkjét is (pl. Árukereső, Google Shopping, ÁrGép, stb.), amennyiben az a teljes LEGO árukészletet tartalmazza.

  1. 1
    Keresd meg a Shoprenter admin felületén egy már beállított, meglévő export (pl. Árukereső, Google Shopping, ÁrGép vagy más hasonló integráció) XML linkjét.
  2. 2
    Ellenőrizd, hogy ez a feed a teljes LEGO kínálatot tartalmazza-e. Ha igen, egyszerűen állítsd be ezt a feed URL-t a KockaKereső Partner Portálodon.
  3. 3
    Ha egyik meglévő export sem tartalmazza a teljes LEGO készletet, bármilyen más, akár még nem konfigurált (be nem kapcsolt) meglévő FEED XML-t is be tudunk fogadni, amennyiben az tartalmazza a fentebb felsorolt kötelező mezőket.
  4. 4
    Ha egyáltalán nincs egyetlen ilyen integrációd sem, vedd fel velünk a kapcsolatot — segítünk egy egyedi export beállításában.

05 — Platform

Shoptet

A Shoptetben egyedi (saját) XML feedet lehet létrehozni, teljesen a KockaKereső igényei szerint konfigurálva.

  1. 1
    Lépj be a Shoptet admin felületére.
  2. 2
    Navigálj ide: Összekapcsolás → XML feedek.
  3. 3
    Kattints a Hozzáad gombra.
  4. 4
    Az Általános információk fülön add meg az alábbiakat:
    Név:KockakeresőFájlnév:kockakereso
    XML fejléc
    <SHOP>
    XML törzs
    <SHOPITEM>
  <PRODUCT>#NAME#</PRODUCT>
  <DESCRIPTION>#SHORT_DESCRIPTION#</DESCRIPTION>
  <URL>#URL#</URL>
  <IMGURL>#IMG_URL#</IMGURL>
  <PRICE>#PRICE#</PRICE>
  <PRICE_VAT>#PRICE_VAT#</PRICE_VAT>
  <VAT>#VAT#</VAT>
  <MANUFACTURER>#MANUFACTURER#</MANUFACTURER>
  <CATEGORYTEXT>#COMPLETE_PATH_PIPE#</CATEGORYTEXT>
  <EAN>#EAN#</EAN>
  <PRODUCTNO>#PART_NUMBER#</PRODUCTNO>
  <DELIVERY_DATE>#AVAILABILITY_DAYS#</DELIVERY_DATE>
</SHOPITEM>
    XML lábléc
    </SHOP>
  5. 5
    Váltás a Haladó fülre:
    • • Pénznem: HUF
    • • Nyelv: Magyar
    • • A feed aktív: bekapcsolva
    • • Korlátozott kategóriák: itt kell kizárni minden kategóriát a LEGO® kivételével — vagyis minden kategóriát pipálj be, kivéve a „LEGO” kategóriát (a bepipált kategóriák nem kerülnek bele a feedbe, tehát csak a kijelöletlenül hagyott LEGO kategória termékei jelennek meg az exportban).
  6. 6
    Mentés után a rendszer generálja a feed URL-jét (az Összekapcsolás → XML feedek listában látható, pl. https://[boltazonosító].myshoptet.com/kockakereso.xml).
  7. 7
    Állítsd be ezt az URL-t a KockaKereső Partner Portálodon.

06 — Platform

Egyéni / saját fejlesztésű rendszer

Ha a webáruházad saját fejlesztésű rendszer, a 02. pontban leírt mezőstruktúra szerint tudsz nekünk egy saját XML feedet generálni.

  1. 1
    Hozz létre egy publikusan, bejelentkezés nélkül elérhető XML végpontot, amely a webáruházad teljes LEGO készletét tartalmazza.
  2. 2
    A fenti táblázatban szereplő mezőneveket (#CODE#, #NAME#, #PRICE_VAT# stb.) használd — legalább a "Kötelező" jelölésű mezőket töltsd ki minden termékhez.
  3. 3
    Állítsd be, hogy a feed rendszeresen, automatikusan frissüljön.
  4. 4
    Állítsd be a feed URL-jét a KockaKereső Partner Portálodon — mi ellenőrizzük és beillesztjük a rendszerünkbe.

07 — Platform

Más webáruház motor

Ha a webáruházad nem a fenti platformok (UNAS, Shoprenter, Shoptet) valamelyikén fut, és nem is saját fejlesztésű rendszer, kérlek vedd fel velünk a kapcsolatot — együtt megtaláljuk a legjobb megoldást a feed beállítására.

08 — Analitika

Kattintás-követés (UTM paraméterek)

A KockaKereső minden, a webáruházadra mutató kimenő linkre automatikusan ráteszi a saját UTM paramétereit. Ennek köszönhetően a Google Analytics felületeden a KockaKeresőről érkező kattintások külön, termék szerinti bontásban jelennek meg — neked ehhez nincs teendőd, a paraméterek minden linkre automatikusan bekerülnek, akkor is, ha jelenleg nem futtatsz Google Shopping vagy egyéb hirdetést.

utm_sourcekockakereso
utm_mediumcpp
utm_campaigndirect_link
Eredeti terméklink
https://pelda-webshop.hu/termek/lego-technic-42115
A KockaKereső által kiegészített link
https://pelda-webshop.hu/termek/lego-technic-42115?utm_source=kockakereso&utm_medium=cpp&utm_campaign=direct_link

Ha a #URL# mezőben megadott terméklinknek már van saját query stringje (pl. egy partnerprogram vagy egyéb követő paraméter), a rendszerünk ezt figyelembe véve, a meglévő paraméterek megtartásával fűzi hozzá a sajátjait.

Ellenőrzőlista beküldés előtt

  • ✓A feed URL böngészőből, bejelentkezés nélkül elérhető
  • ✓A saját webáruházad által forgalmazott teljes LEGO® készletet tartalmazza, nem csak egy részét
  • ✓Csak LEGO® termékek szerepelnek benne
  • ✓Csak új állapotú termékek szerepelnek benne, használt, bontott, sérült nincs közöttük
  • ✓Minden termékhez van ár, kép, URL és elérhetőség
  • ✓A feed UTF-8 kódolású és valid XML
  • ✓A feed automatikusan frissül (nem egyszeri, statikus fájl)

Kérdésed van, vagy segítségre van szükséged a beállítás során? Írj nekünk a help@kockakereso.hu címre, és partner ügyfélszolgálatunk mielőbb felveszi veled a kapcsolatot.