Szabály: Adatfájl import (CSV / XML)#

Az Adatfájl import szabállyal külső XML vagy CSV fájlból importálhatsz adatokat a projektedben már meglévő tételekbe. A fájlt közvetlenül feltöltheted, vagy megadhatsz egy URL-t, amelyről az adatok rendszeresen betöltődnek. Így gazdagíthatod a termékadatokat például elérhetőséggel, teljesítménystatisztikákkal, árrésekkel vagy más kiegészítő információkkal.

Extra funkciók#

• Leképezési mód:
  • Kulcs egyezik – a párosító elem értékei a forrásban és a Mergadóban teljesen megegyeznek.
    • Az importált fájlból az érték csak akkor töltődik be, ha az importbeli érték megegyezik a projekt párosító elemének értékével.
    • Tipikusan egyedi termékazonosító szerinti párosításhoz használják.
  • Kulcs tartalmazva van – a párosító elem értékei részlegesen egyeznek.
    • Az importált fájlból az érték csak akkor töltődik be, ha az importból származó párosítási érték megtalálható a projekt párosító elemének értékében.
    • Tipikusan terméknévben lévő kulcsszó vagy kategóriák szerinti párosításhoz használják.
• Támogatott fájltípusok:
  • XML
  • CSV
  • Google Sheets (a Sheet CSV-ként való közzétételén keresztül nyilvános URL-re)
• Fájl csatlakoztatásának módja:
  • Fájl feltöltése (upload) – egyszeri import.
    • Ha a fájlban az adatok megváltoznak, újra kézzel kell feltöltened a fájlt.
  • URL megadása – dinamikus csatlakozás.
    • Ha a fájlban az adatok megváltoznak, az új értékek automatikusan betöltődnek a projekt minden újragenerálásakor.
• Mezőelválasztó:
  • Vessző, pontosvessző, függőleges vonal – a forrásfájl formátuma szerint (vessző az alapértelmezett)

Konkrét példák#

1. példa: Raktárkészlet elérhetőségének importálása Heureka elérhetőségi XML feedből#

Ez a példa bemutatja, hogyan gazdagítsd a standard termékfeedet a termékek elérhetőségére vonatkozó információkkal egy külső XML feedből (pl. Heureka) az Adatfájl import (CSV / XML) szabállyal.

• A projekt előkészítése az import előtt - az importhoz először elő kell készítened a projektet
  • Az importálni kívánt elemek nevei (vagy a CSV fájlban lévő oszlopnevek) meg kell egyezzenek a projekt azon elemeinek nevével, amelyekbe az adatokat írod.
  • Ha olyan elemet szeretnél importálni, amely a projektben még nem létezik, kézzel kell létrehoznod:
    • Nyisd meg az Elemek oldalt.
    • Kattints az Új elem gombra.
    • Add meg az elem nevét és erősítsd meg a létrehozást.
  • Az importcél elemek lehetnek rejtettek – a láthatóságuk nem befolyásolja az importot.
• Új szabály létrehozása:
  • Nyisd meg a Szabályok oldalt.
  • Kattints az Új szabály gombra.
• Szabálytípus kiválasztása:
  • A Szabálytípus mezőben válaszd az Adatfájl import (CSV / XML) opciót.
• Termékek kiválasztása:
  • A Lekérdezés mezőben válaszd az Összes termék opciót, vagy hozz létre saját Terméklekérdezést.
• Adatfájl forrása:
  • A választógombbal válaszd ki, honnan töltődjön be a fájl:
    • URL megadása
      • Az URL cím mezőbe illeszd be az XML vagy CSV fájl címét (pl. a Heureka elérhetőségi feed URL-jét).
      • Kattints az Import gombra.
      • A Mergado automatikusan felismeri, hogy CSV vagy XML fájlról van szó, és ennek megfelelően alakítja a felületet.
    • Fájl feltöltése a számítógépről
      • Az Adatfájl mezőben kattints a Fájl feltöltése gombra és válaszd ki a fájlt a számítógépedről.
      • A Mergado ismét automatikusan felismeri a formátumot.
      • Tipp: A feltöltött fájl maximális mérete 25 MB.
• Tételt határoló elem (csak XML importnál)
  • A Tételt határoló elem mezőben állítsd be az XML fájlban a tételt határoló elemet (tipikusan pl. SHOPITEM vagy ITEM), beleértve a szülő gyökér (ROOT) elemet.
    • A mi esetünkben: item_list | item
• Párosító elem az aktuális projektben
  • Válaszd ki az aktuális Mergado projekt elemét, amely alapján az importált fájl adataival párosítani szeretnéd a termékeket, például termékazonosító: g:id
    • Tipp: Lehetőleg a projekt bemeneti feedjéből válassz párosító elemet – ez gyorsabb feldolgozást eredményez az újragenerálás során.
• Párosító elem az importált fájlban
  • Válaszd ki az importált fájlból azt az elemet, amely az aktuális projekt kiválasztott párosító elemének megfelelő értékeket tartalmazza, pl. termékazonosító attribútum a Heureka elérhetőségi feedben: @id
• Párosítás bemeneti értékek alapján
  • A Párosítás bemeneti értékek alapján jelölőnégyzet alapértelmezetten be van kapcsolva.
    • Ha aktív, az adatok a projekt bemeneti feedjéből származó eredeti értékek alapján párosítódnak (a Mergado általi módosítások előtt).
    • Ha kikapcsolod, a párosítás már más szabályok által módosított értékek alapján történik.
    • Figyelem: Ennek kikapcsolása lassíthatja az adatfeldolgozást.
• Haladó beállítások
  • A Haladó beállítások szekcióban állítsd be:
    • Leképezési mód a legördülő listából
      • a mi esetünkben a Kulcs pontosan egyezik módot használjuk
    • Kis- és nagybetűk megkülönböztetése jelölőnégyzettel
      • a mi esetünkben a jelölőnégyzetet kikapcsolva hagyjuk
• Szabály elnevezése
  • Az utolsó lépésben add meg a szabály nevét, például Elérhetőség importálása.

További felhasználás#

• Egyszeri EAN kódok vagy más értékek importálása (például: GPSR adatok vagy hiányzó képek URL-jei)
• Dinamikus értékek csatlakoztatása Google Sheetsből a Mergadóba
  • Teljesítményadatok Google Analyticsből (kattintások, megjelenítések, megrendelések)
  • Termékek szezonalitása
  • Raktárkészletek
• custom_label importálása PPC-hez
• Adatok importálása szegmentáláshoz és custom_label beállításához PPC-hez
• Beszerzési árak és árrések importálása automatikus árazáshoz a Pricing Fox bővítménnyel
• Fordítások importálása (ha más nyelvi feedben vannak a fordítások és be kell juttatnod a Mergadóba)

GYIK#

Mire szolgál az Adatfájl import szabály?#

A szabály külső XML vagy CSV fájlból származó adatok importálására szolgál a Mergado projekt meglévő termékeibe. Így gazdagíthatod a feedet olyan információkkal, amelyeket az eredeti forrás nem tartalmaz – pl. raktárkészlet, árrés, beszerzési ár, teljesítménystatisztikák vagy dinamikus PPC címkék.

Milyen fájlformátumokat támogat a Mergado?#

• XML (pl. Heureka elérhetőségi feed)
• CSV (pl. belső rendszerből vagy ERP-ből származó táblázatos export)
• Google Sheets, ha CSV-ként van közzétéve nyilvános URL-en

A feltöltött fájl maximális mérete 25 MB.

Mi a különbség a fájl feltöltése és az URL megadása között?#

• Fájl feltöltése (upload) – egyszeri import. Ha a fájlban az adatok megváltoznak, újra kézzel kell feltöltened.
• URL cím megadása – dinamikus csatlakozás. A projekt minden újragenerálásakor automatikusan betöltődnek a friss értékek a külső fájlból.
  • Ajánlott rendszeresen frissülő adatforrásokhoz (pl. elérhetőség, árak, teljesítmény).

Mit jelent a “Tételt határoló elem” az XML importnál?#

Ez az elem határozza meg, hogy melyik XML csomópont jelent egyetlen terméket. Pl. a Heureka feedben ez a SHOPITEM, más XML feedekben ITEM vagy PRODUCT lehet. A Mergadóban a gyökérelemmel együtt írd be, pl.: item_list | item.

Hogyan történik a termékpárosítás az importált fájl és a projekt között?#

Párosító elemek segítségével:

• Az aktuális projektben kiválasztod az elemet, amely alapján párosítani kell a termékeket (pl. g:id).
• Az importált fájlban kiválasztod a megfelelő elemet vagy attribútumot (pl. @id).

Ideális, ha ezeknek az elemeknek az értékei egyediek és megegyeznek a projekt és a fájl között.

Mi a különbség a “Kulcs egyezik” és a “Kulcs tartalmazva van” mód között?#

• Kulcs egyezik – a párosító elemek értékeinek teljesen meg kell egyezniük (123 = 123). Pl. termékazonosító szerinti párosításnál használják.
• Kulcs tartalmazva van – a párosítás akkor történik, ha az importból származó párosító elem értéke megtalálható a projekt párosító elemének értékén belül (pl. 123 megtalálható az SKU_12345-ben). Szövegrész (pl. név vagy kategória) szerinti párosításhoz alkalmas.

Mire szolgál a “Párosítás bemeneti értékek alapján” opció?#

Ez az opció meghatározza, hogy a Mergado a párosítás során:

• a forrásfeed bemeneti értékeit használja (alapértelmezett beállítás), vagy
• a szabályok alkalmazása utáni értékeket (ha az opciót kikapcsolod).

Ajánlott bekapcsolva hagyni – így a párosítás stabilabb és gyorsabb. A kikapcsolás lassíthatja a projekt generálását. Figyelj viszont arra, hogy a kiválasztott párosító elemnek a projektben vannak-e bemeneti értékei. Ha nincsenek, ezt az opciót ki kell kapcsolnod, különben a párosítás nem fog működni.

Mit jelent a “Kis- és nagybetűk megkülönböztetése” opció a haladó beállításokban?#

Ha az opció aktív, a párosítás figyelembe veszi a kis- és nagybetűk közötti különbséget. Pl. ABC nem egyezik Abc-vel. Ha kikapcsolva hagyod (ajánlott), a Mergado figyelmen kívül hagyja a betűméret különbségeit.

Mi történik, ha az importált fájl valamelyik eleme a projektben nem létezik?#

Az import nem fog működni, amíg az adott elemet a projektben kézzel létre nem hozod (azonos névvel). Az Elemek oldalon kattints az Új elem gombra, add meg a nevet (pl. availability) és erősítsd meg. Az elem lehet rejtett is – a láthatóság nem befolyásolja az importot.

Importálhatok egyszerre több értéket (pl. elérhetőség, ár és EAN)?#

Igen. Az Adatfájl import szabály lehetővé teszi több oszlop (CSV) vagy elem (XML) egyidejű importját, ha helyesen vannak leképezve.

Hogyan használhatom az importot Google Sheets adatokhoz?#

1. A Google Sheetsben kattints a Fájl → Megosztás → Közzététel a weben opcióra.
2. Válaszd a CSV formátumot és másold ki a generált URL-t.
3. Ezt az URL-t illeszd be az URL cím mezőbe az Adatfájl import szabályban.
4. Minden újrageneráláskor a Mergado betölti a friss adatokat a Sheetből.

Így csatlakoztathatsz pl. dinamikus címkéket, teljesítményadatokat vagy napi árakat.

Hogyan ellenőrizhetem, hogy az adatok helyesen importálódtak?#

A szabályok mentése és alkalmazása vagy a feed újragenerálása után:

• nyisd meg a Termékek oldalt, keresd meg a konkrét terméket és ellenőrizd, hogy az új adatok megjelentek a megfelelő elemekben,
• vagy használd a Szabályok áthaladása funkciót, amely megmutatja, hogyan párosítódtak és töltődtek be az adatok.

Ha az értékek nem importálódtak, ellenőrizd az elemneveket és a párosítási kulcsokat.

Használható a szabály egyszeri adatimportra is?#

Igen. Egyszeri kiegészítéshez (pl. EAN kódok vagy GPSR adatok) elegendő a fájlt kézzel feltölteni. A szabálynak viszont a projektben kell maradnia, különben a feltöltött adatok ismét törlődnek.

Importálhatók a szabállyal teljesítményadatok Google Analyticsből vagy más eszközökből?#

Igen, ha az adatok CSV (vagy XML) formátumban elérhetők. Alternatív megoldás a Bidding Fox Elements bővítmény, amely ezeket az adatokat automatikusan betölti a Mergadóba. Például importálhatsz kattintásszámokat, megjelenítéseket vagy megrendeléseket termékazonosító alapján. Így gazdagíthatod a feedet teljesítménymutatókkal, amelyeket aztán licitálási stratégiák optimalizálásához használhatsz.

Mit tegyek, ha az import nem sikerül?#

Ellenőrizd:

1. hogy a fájl elérhető (az URL nyilvános, nem igényel bejelentkezést),
2. hogy helyes UTF-8 kódolást használ,
3. hogy az elemek/oszlopok nevei megegyeznek a projekt neveivel,
4. és hogy a párosítás helyesen van beállítva.

Teszteléshez tölts fel egy kisebb elemszámú fájlt és ellenőrizd, hogy helyesen leképeződik.

Használható az import automatikus árazáshoz (pl. árrések, beszerzési árak)?#

Igen. Az importtal a feedbe beillesztheted pl. a beszerzési árakat vagy árréseket, amelyeket aztán a Számítás vagy Szám kerekítése szabályban használhatsz dinamikus árazáshoz. A Pricing Fox bővítménnyel kombinálva akár teljesen automatizálhatod az ármódosítást.