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.

Források

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#

1. 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.

2. 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.

3. 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).

4. 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.

5. 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.

6. 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.

7. 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.

8. 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.

9. 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.

10. 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.

11. Hogyan használhatom az importot Google Sheets adatokhoz?

A Google Sheetsben kattints a Fájl → Megosztás → Közzététel a weben opcióra.
Válaszd a CSV formátumot és másold ki a generált URL-t.
Ezt az URL-t illeszd be az URL cím mezőbe az Adatfájl import szabályban.
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.

12. 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.

13. 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.

14. 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.

15. Mit tegyek, ha az import nem sikerül? Ellenőrizd:

hogy a fájl elérhető (az URL nyilvános, nem igényel bejelentkezést),
hogy helyes UTF-8 kódolást használ,
hogy az elemek/oszlopok nevei megegyeznek a projekt neveivel,
é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.

16. 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.

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

GYIK#

Kapcsolódó cikkek