Változók a Mergadóban#

1. Mik a változók a Mergadóban?#

A Mergado Editorban a változók az elemek konkrét értékeinek helyettesítői. Olyan „adattárolók", amelyek termékenként más értéket vesznek fel, és amelyeket szabályokban felhasználhatsz.

  • Egy változó minden terméknél más értékkel rendelkezhet.
  • Tipikus példa a PRICE_VAT elem, amelynek értéke termékenként változik.
  • Változót kézzel is létrehozhatsz – például ha egy szövegrészletet kell kiemelned a névből vagy a leírásból.
  • A felhasználói változókon kívül léteznek speciális rendszerváltozók is, mint a @MERGADO_ID.

A Mergado közvetlenül az elemeket használja értékforrásként. A változók kiegészítő eszközök ott, ahol szövegből kell kiemelned egy bizonyos részt, vagy az értékekkel tovább kell dolgoznod.

2. Hogyan működnek a változók?#

A változók szövegkiemelésre és annak további felhasználására szolgálnak, elsősorban szabályokban. Az alapelv egyszerű:

  1. Kiválasztod az elemet, amelyben a kívánt információ található.
  2. Megadsz egy reguláris kifejezést, amely kiemeli a szöveg konkrét részét.
  3. Ez a rész a változó értékeként tárolódik.
  4. A változó aztán a szabályban kerül felhasználásra – a Mergado minden termékhez a helyes értéket illeszti be.
  5. A rendszerváltozóknál (pl. @MERGADO_ID) ugyanez az elv érvényes – a szabályokban százalékjelek közé írva használod: %@MERGADO_ID%.

A változók lehetővé teszik, hogy a feedben nem jól strukturált adatokkal is dolgozz.

3. Miért és mikor használj változókat?#

A változók ott hasznosak, ahol szövegrészletekkel kell dolgoznod, új értékeket kell létrehoznod, vagy hiányzó információkat kell pótolnod.

A. Értékek beállítása szabályokban#

A változókat gyakran használják elemek értékeinek kiegészítésére vagy módosítására. Reguláris kifejezések segítségével kiemelheted a szöveg egy részét és változóként mentheted, amelyet aztán egy másik elembe illeszthetsz be.

B. Adatok összeállítása és módosítása#

A változók lehetővé teszik, hogy több helyről származó értékeket egyetlen eredménnyé kombinálj. Tipikus például a terméknév összeállítása több elem és változó kombinálásával (pl. gyártó, típus, méret).

C. Adatok kiemelése PARAM elemekbe#

Ha a termékek nem tartalmaznak paramétereket a PARAM elemben, de a tulajdonságok a névben vagy a leírásban vannak feltüntetve, reguláris kifejezéssel kinyerheted őket változókba, és aztán standardizált paraméterekként mentheted el. Ez az eljárás univerzális – függetlenül attól, milyen konkrét értékek fordulnak elő a szövegben.

D. A @MERGADO_ID rendszerváltozó használata#

A @MERGADO_ID a termék egyedi belső azonosítója, amelyet a Mergado használ. Különösen hasznos, ha:

  • hiányoznak vagy ismétlődnek az ITEM_ID vagy g:id értékek,
  • egyedi URL-t kell létrehoznod #@MERGADO_ID hozzáadásával,
  • frissíteni kell az árösszehasonlítókon tárolt képeket.

A @MERGADO_ID értékét bármely elembe beírhatod Felülírás típusú szabállyal.

Szekció összefoglaló#

A Mergadóban a változók elemekből származó értékek kiemelésére és további feldolgozására szolgálnak. Kiválasztod az elemet, reguláris kifejezéssel meghatározod a kívánt szövegrészt, és változóként mented el. Ezt aztán felhasználhatod szabályokban, nevek összeállításánál, paraméterek létrehozásánál vagy URL-ek módosításánál. Ott hasznosak, ahol változó vagy strukturálatlan szöveggel kell dolgoznod, és egységes formába kell átalakítanod.

II. Változók típusai a Mergadóban#

1. Felhasználói változók#

A felhasználói változók elemekből kiemelt értékek, amelyek termékenként eltérhetnek. Leggyakrabban akkor hasznosak, ha egy szövegrészletet kell kinyerned a névből vagy a leírásból.

Felhasználói változók létrehozása#

A felhasználói változókat a Változók oldalon kezeled az Új változó gombbal. A lépések:

  • kiválasztod az elemet, amelyből a változónak származnia kell,
  • megadsz egy reguláris kifejezést, amely meghatározza a kiemelendő szövegrészt,
  • a tesztmezőben ellenőrzöd, hogy a kifejezés helyesen működik-e,
  • elmented a kiemelt szövegrészt a választott változónév alatt.
  • egy reguláris kifejezéssel egyszerre több változót is létrehozhatsz
    • ha a reguláris kifejezésben zárójeleket használsz, minden zárójel önálló csoportként értékelődik ki, és külön változóba menthető
    • például ha egy képi URL-t tartalmazó elemben több URL van vesszővel elválasztva, és mindegyiket külön változóba kell kiemelned

Példa#

Egy Google feedben a termékleírásban a g:description elemben a termék méretei vannak feltüntetve, például „150x50", ahol az első érték a szélességet, a második a hosszúságot jelöli: <g:description>Termékleírás, méretek: 150x50</g:description>

A cél ezeket az értékeket kiemelni és két önálló paraméterbe menteni: Szélesség és Hosszúság.

1. Változók létrehozása#

  1. A Változók oldalon kattints az Új változó gombra.
  2. Az Elem mezőben válaszd ki a g:description elemet.
  3. A Reguláris kifejezés mezőbe írd be a mindkét méretet megragadó kifejezést: (\d+)x(\d+)
  4. A Tesztszöveg mezőben a kiválasztott elem véletlenszerű értéke jelenik meg, így azonnal látod, hogy a kifejezés működik-e. A nyilak ikonjával további mintákat tölthetsz be.
  5. Ha a reguláris kifejezés bármely szövegrészt megragadja, az alábbiakban megjelennek a változónevek mezői. Ha a kifejezésnek több csoportja van, minden csoporthoz külön mező jelenik meg.

A mi esetünkben ezek a mezők jelennek meg:

  • Teljes egyezés: „150x50"
    • Ezt a mezőt figyelmen kívül hagyhatod, vagy pl. meretek néven mentheted, ha az egész karakterláncra szükséged van.
  • 1. csoport: „150"
    • Nevezd el: szelesseg.
  • 2. csoport: „50"
    • Nevezd el: hosszusag.
  1. Kattints a Mentés gombra. Ezzel két új változód lesz: szelesseg és hosszusag.

2. Paraméterek beállítása szabállyal#

  1. A Szabályok oldalon hozz létre új szabályt: Termékparaméterek beállítása.
  2. Az első oszlopban válaszd ki a terméklekérdezést, amelyre a paramétereket be akarod állítani.
  3. Add meg:

Első paraméter:

  • Paraméter neve: Szélesség
  • Paraméter értéke: %szelesseg%

Második paraméter:

  • Paraméter neve: Hosszúság
  • Paraméter értéke: %hosszusag%
  1. A szabályt mentsd el, alkalmazd, majd generáld újra a projektet.

3. Eredmény a kimeneti feedben#

<g:description>Termékleírás, méretek: 150x50</g:description> <g:attribute_detail> <g:attribute_name>Szélesség</g:attribute_name> <g:attribute_value>150</g:attribute_value> </g:attribute_detail> <g:attribute_detail> <g:attribute_name>Hosszúság</g:attribute_name> <g:attribute_value>50</g:attribute_value> </g:attribute_detail>

Elsődleges felhasználás#

A felhasználói változókat elsősorban a következőkre használod:

  • konkrét szövegrész kiemelése hosszabb vagy strukturálatlan tartalmú elemekből,
  • értékek kinyerése, mint méret, szín, térfogat, műszaki paraméterek vagy egyéb terméktulajdonságok,
  • paraméterek kiegészítése vagy létrehozása a PARAM elemben,
  • más elemek kitöltése szabályokkal, például Termékparaméterek beállítása vagy Felülírás.

Ez a megközelítés univerzális – bármilyen szín-, méret- vagy egyéb variációra működik, amelyek a feedben előfordulhatnak.

2. Rendszerváltozók#

A rendszerváltozók a Mergado részét képező speciális változókészletet alkotják. Nem te hozod létre őket kézzel.

Fix készlet#

A Változók oldalon megtalálod a Speciális változók táblázatot, ahol az összes elérhető rendszerváltozó fel van sorolva. Jelenleg egyetlen rendszerváltozó létezik: @MERGADO_ID

Mit jelent és hogyan működik a @MERGADO_ID?#

  • A @MERGADO_ID a termék belső egyedi azonosítója.
  • Egy numerikus érték, amely minden termékhez egyedi.
  • A szabályokban százalékjelek közé írva használod: %@MERGADO_ID%.

A @MERGADO_ID tipikus felhasználása#

  • hiányzó vagy duplikált ITEM_ID vagy g:id értékek helyettesítése,
  • egyedi URL-ek létrehozása #@MERGADO_ID hozzáadásával,
  • képek „frissítése" – az URL módosítása #@MERGADO_ID-val kiváltja az újratöltést az árösszehasonlítókon,
  • bármely elembe beírható Felülírás típusú szabállyal.

3. Elemek használata változókként#

A Mergadóban a szabályokban közvetlenül használhatod az elemek értékeit saját változó létrehozása nélkül. Elég az elem nevét százalékjelek közé írnod, például:

  • %PRODUCTNAME%
  • %MANUFACTURER%
  • %DESCRIPTION%

Így az elem teljes tartalmával dolgozhatsz. Ez a mechanizmus funkcionálisan hasonlít a változóra, de nem kell külön létrehoznod.

Mikor elég az elemet használni?#

Az elem a szabályban elegendő, ha:

  • az elem teljes értékét akarod használni,
  • nem végzel szövegrész-kiemelést,
  • egyértelmű és jól strukturált tartalommal dolgozol.

Mikor hozz létre felhasználói változót?#

Felhasználói változót akkor érdemes létrehozni, ha:

  • csak egy szövegrészletre van szükséged (pl. „XL" egy hosszú névből),
  • olyan leírással dolgozol, amelyben különböző értékek keverednek egyetlen szövegben,
  • nem akarsz tucatnyi lekérdezést vagy szabályt létrehozni minden egyes színhez, mérethez vagy variánshoz,
  • univerzális megoldásra van szükséged, amely akkor is működik, ha új értékek kerülnek a feedbe.

Ilyen esetekben a reguláris kifejezés lehetővé teszi, hogy pontosan azt az információt kiemeld változóba, amelyre szükséged van.

III. Változókkal való munka a Mergadóban#

A. Változók kezelése#

A változókat a Változók oldalon kezeled a Mergado Editor főmenüjében. Ezen az oldalon látod az összes projektváltozót:

  • Felhasználói változók – a te általad létrehozott változók.
  • Speciális változók – rendszerváltozók a Speciális változók táblázatban.
  • Új változók létrehozása – az Új változó gombra kattintva.

A változókat itt szerkesztheted és törölheted is.

B. Felhasználói változók létrehozása – workflow#

Új felhasználói változó létrehozásának lépései:

  1. Kattints az „Új változó" gombra a Változók oldalon.

  2. Válaszd ki a forráselemet, amelyből a változót létre kell hozni.

  3. Add meg a reguláris kifejezést (maszkot), amely meghatározza a kiemelendő szövegrészt.

  4. Teszteld a kifejezést:

    • A Tesztszöveg mezőben a kiválasztott elem véletlenszerű értéke jelenik meg.
    • A tesztszöveget a két nyíl ikonjával frissítheted.
    • Kattints a Kifejezés tesztelése gombra.

  5. Módosítsd és teszteld, amíg meg nem találod a helyes szövegkiválasztást.

    • A reguláris kifejezésekkel való munkához ajánlott a regex101.com külső eszköz is.

  6. Mentsd el a változót – nevezd el a kiemelt szövegrészeket, és erősítsd meg a Változó mentése gombbal.

C. Változók használata szabályokban#

A változókat elsősorban szabályokban használod, ahol értékforrásként szolgálnak más elemekbe való beíráshoz.

Szintaxis#

  • A változót a szabályban %VÁLTOZÓ_NEVE% formátumban írod.
  • Ugyanez a szintaxis érvényes a rendszerváltozóra is: %@MERGADO_ID%.
  • Az elem teljes értékét közvetlenül is használhatod, például:
    • %PRODUCTNAME%, %MANUFACTURER%, %DESCRIPTION%.
    • vagy kettő kombinációjaként: %URL% %@MERGADO_ID%

Tipikus felhasználás#

1. Felülírás szabály Új értékek összeállítására szolgál – például a terméknév összerakása több forrásból: %MANUFACTURER% %PRODUCTNAME% %PARAM_MERET%

2. Termékparaméterek beállítása szabály A PARAM elem kitöltésére szolgál. Ha a paraméter értéke változóban van tárolva, a szabály jobb oldalán kell megadni.

D. Változók használata lekérdezésekben#

A változók közvetlenül nem használhatók a lekérdezések szintaxisában. A lekérdezések azonban gyakran meghatározzák azt a termékcsoportot, amelyre aztán a változóval rendelkező szabály alkalmazódik.

Például:

  • létrehozod a terméklekérdezést, amely egy bizonyos tulajdonságot tartalmazó termékeket választ ki a névben,
  • erre a lekérdezésre alkalmazod a szabályt, amely a reguláris kifejezéssel létrehozott változót használja.

Példa#

Egyes termékek nevében méretek vannak feltüntetve, amelyeket ki kell emelned és új „Méret" paraméterként kell elmentened. Mintatermék neve: „Adidas póló ABC, szín piros, méret XL"

  1. Változó létrehozása - Hozz létre változót a forráselem alapján (pl. g:title). Reguláris kifejezéssel ragadd meg a termék méretét jelölő szövegrészt, tehát például az „XL"-t. A változót mentsd el például termek_meret néven.
  2. Terméklekérdezés létrehozása - Hozd létre a lekérdezést, amely kiválasztja a névben méretet tartalmazó termékeket. Használhatsz pl. ilyen feltételt: g:title CONTAINS "méret" (a termékneveid tényleges szerkezete szerint).
  3. Szabály létrehozása – két lehetséges változat

A változat: Felülírás szabály#

Akkor használd, ha manuálisan akarod összeállítani a paraméter struktúráját elemek segítségével.

  • az Elem mezőbe írd be: g:attribute_detail { g:attribute_name = "Méret" } | g:attribute_value (ha a „Méret" paraméter még nem létezik, a Mergado automatikusan létrehozza)
  • az Új érték mezőbe írd be: %termek_meret%

B változat: Termékparaméterek beállítása szabály#

Akkor használd, ha egyszerűen, űrlapon keresztül akarod létrehozni a paramétert.

  • a Paraméter neve mezőbe írd be: Méret
  • a Paraméter értéke mezőbe írd be: %termek_meret%

E. Változók megjelenítése és exportálása#

Értékek megjelenítése#

  • @MERGADO_ID rendszerváltozó:
    • A @MERGADO_ID értékei a Termékek oldalon jeleníthetők meg.
    • A táblázatos nézetben a Mergado ikonnal hozzáadhatod a @MERGADO_ID oszlopot.
  • Felhasználói változók
    • Értékeik csak azután jeleníthetők meg, miután szabállyal elembe illesztetted őket.
    • Az értékeket a Termékek oldalon vagy az Elemek → Elem értékei → Értékek listázása részben ellenőrizheted.

Exportálás CSV-be#

  • A változók értékeit csak azon elem értékeiként exportálhatod, amelybe szabállyal illesztetted, vagy a @MERGADO_ID esetén:
    • A Termékek oldalon válts táblázatos nézetre, válaszd ki az elemet, és kattints a CSV letöltése gombra.
    • Válaszd a Táblázat oszlopai opciót – így a megjelenített változóértékek is letöltődnek.

IV. Felhasználási esetek és leggyakoribb hibák#

1. Tipikus felhasználási esetek#

a) Termékparaméterek kiegészítése#

A névben vagy leírásban feltüntetett értékeket (pl. méret, szín, térfogat, anyag) reguláris kifejezéssel változóba emelheted ki. Az így kapott értékeket a Termékparaméterek beállítása szabállyal a PARAM elembe írhatod.

b) Új terméknév létrehozása#

Több változóból és elemből állíthatsz össze új tartalmat. Tipikus példa a Felülírás szabályban:

%MANUFACTURER% %PRODUCTNAME% %meret%

c) Kiemelt adatok eltávolítása a névből#

A Keresés és csere szabállyal, reguláris kifejezéssel végezheted el.

d) @MERGADO_ID használata egyedi kulcsként#

Hiányzó vagy duplikált azonosítók helyettesítése, egyedi URL-ek létrehozása, képek újratöltésének kikényszerítése.

2. Leggyakoribb hibák és megoldásaik#

A változó üres értékeket ad vissza#

  • Megoldás: módosítsd a reguláris kifejezést és teszteld több mintán.

A kifejezés túl sok szöveget ragad meg#

  • Megoldás: pontosítsd a mintát, szűkíts csoportokkal vagy horgonyokkal.

A kiválasztott elem nem tartalmazza a kívánt adatokat#

  • Megoldás: ellenőrizd, melyik elemben található ténylegesen az információ.

A szabály nem jelent meg az adatokban#

  • Megoldás: ellenőrizd a szabályalkalmazást és a kimenetet az Elemek → Elem értékei → Értékek listázása részben.

Duplikált azonosítók#

  • Megoldás: használd a %@MERGADO_ID%-t a célelem felülírásához.

GYIK#

1. Mi az a változó a Mergadóban? Egy elemből kapott tárolt érték, amelyet szabályokban és adatmódosításoknál használhatsz.

2. Mire valók a változók? Értékek kiemelésére, paraméterek kiegészítésére, új értékek létrehozására vagy adatok egységesítésére.

3. Mi a különbség elem és változó között? Az elem az eredeti feedérték. A változó ennek reguláris kifejezéssel kapott része.

4. Mikor használjak változót és mikor elemet? Változót szövegrész-kiemeléshez, elemet teljes értékkel való munkához.

5. Hogyan hozok létre változót? A Változók oldalon az „Új változó" gombbal. Elemet választasz, reguláris kifejezést adsz meg, tesztelsz, elnevezel, mentesz.

6. Minden elemhez kell változó? Nem. Az elem teljes tartalmához nem kell változó.

7. Létrehozhatok egyszerre több változót? Igen. Több csoportot tartalmazó reguláris kifejezésnél mindegyik csoport külön változóba menthető.

8. Mi az a @MERGADO_ID? A termék belső egyedi azonosítója, automatikusan elérhető.

9. Mire való a @MERGADO_ID? Hiányzó azonosítók pótlása, egyedi URL-ek, képek újratöltése stb.

10. Hogyan használjak változót szabályban? %VÁLTOZÓ_NEVE% formátumban.

11. Hogyan illesztem be a @MERGADO_ID-t? %@MERGADO_ID% formátumban.

12. Használhatok változót lekérdezésben? Nem. A lekérdezés csak a céltermékcsoport meghatározására szolgál.

13. Hol kezelem a változókat? A Változók oldalon a főmenüben.

14. Módosítható vagy törölhető később? Igen.

15. Hogyan tesztelem a reguláris kifejezést? A Tesztszöveg mezőben vagy a regex101.com oldalon.

16. Mit tegyek üres értékeknél? Módosítsd a reguláris kifejezést. Írj nekünk a mergado@mergado.hu címre.

17. Miért nem jelent meg a változó? Ellenőrizd a szabályalkalmazást és az elem tartalmát.

18. Hogyan ellenőrzöm a változó értékét? Termékek oldalon táblázatos nézetben, vagy az Elemek → Értékek listázása funkcióval.

19. Exportálhatom CSV-be? Igen, a Táblázat oszlopai opcióval.

20. Miért ragadott meg túl sok szöveget? A kifejezés túl általános. Pontosítsd csoportokkal vagy horgonyokkal.

21. Hogyan juttatom el az értéket a névbe? Felülírás szabállyal, a név és a változó kombinációjaként.

22. Hogyan távolítsam el a kiemelt értéket a névből? Keresés és csere szabállyal, reguláris kifejezéssel.

23. Használható URL-ekhez? Igen, tipikusan %@MERGADO_ID% hozzáadásával az URL végéhez.

24. Mi van, ha nincs PARAM a terméknél? Emeld ki az értéket névből vagy leírásból, és egészítsd ki a Termékparaméterek beállítása szabállyal.

25. Kell minden tulajdonsághoz külön regex? Nem. Jól megtervezett csoportos kifejezés önállóan kiemeli a különböző tulajdonságokat.

26. Tartalmazhat egy változó több értéket? Nem. Minden termékhez pontosan egy vagy nulla értéket tartalmaz.

27. Mit tegyek duplikált ITEM_ID esetén? Használd a %@MERGADO_ID%-t Felülírás szabállyal.

28. Számításigényes a változók használata? Nem, a szabályok alkalmazásakor értékelődnek ki, nincs negatív hatásuk.

Kapcsolódó cikkek

Backward Elemek a Mergadóban Fordított lekérdezések a Mergadóban Forward
🇨🇿 🇬🇧 🇩🇪 🇭🇺