Változók a Mergadóban#

A változók lehetővé teszik, hogy az elemek értékeinek meghatározott részleteit – például a névből kinyert méretet vagy színt – kiemelj és szabályokban felhasználj. Ez az útmutató ismerteti a felhasználói és rendszerváltozókat, azok létrehozását reguláris kifejezésekkel, és a leggyakoribb felhasználási eseteket.

I. Változók a Mergado Editorban#

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#

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.

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.

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.

Mikor használjak változót és mikor elemet?#

Változót szövegrész-kiemeléshez, elemet teljes értékkel való munkához.

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.

Minden elemhez kell változó?#

Nem. Az elem teljes tartalmához nem kell változó.

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

Mi az a @MERGADO_ID?#

A termék belső egyedi azonosítója, automatikusan elérhető.

Mire való a @MERGADO_ID?#

Hiányzó azonosítók pótlása, egyedi URL-ek, képek újratöltése stb.

Hogyan használjak változót szabályban?#

%VÁLTOZÓ_NEVE% formátumban.

Hogyan illesztem be a @MERGADO_ID-t?#

%@MERGADO_ID% formátumban.

Használhatok változót lekérdezésben?#

Nem. A lekérdezés csak a céltermékcsoport meghatározására szolgál.

Hol kezelem a változókat?#

A Változók oldalon a főmenüben.

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

Igen.

Hogyan tesztelem a reguláris kifejezést?#

A Tesztszöveg mezőben vagy a regex101.com oldalon.

Mit tegyek üres értékeknél?#

Módosítsd a reguláris kifejezést. Írj nekünk a mergado@mergado.hu címre.

Miért nem jelent meg a változó?#

Ellenőrizd a szabályalkalmazást és az elem tartalmát.

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.

Exportálhatom CSV-be?#

Igen, a Táblázat oszlopai opcióval.

Miért ragadott meg túl sok szöveget?#

A kifejezés túl általános. Pontosítsd csoportokkal vagy horgonyokkal.

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.

Hogyan távolítsam el a kiemelt értéket a névből?#

Keresés és csere szabállyal, reguláris kifejezéssel.

Használható URL-ekhez?#

Igen, tipikusan %@MERGADO_ID% hozzáadásával az URL végéhez.

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.

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.

Tartalmazhat egy változó több értéket?#

Nem. Minden termékhez pontosan egy vagy nulla értéket tartalmaz.

Mit tegyek duplikált ITEM_ID esetén?#

Használd a %@MERGADO_ID%-t Felülírás szabállyal.

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

Hasznos volt ez a cikk?
Backward Elemek a Mergadóban Fordított lekérdezések a Mergadóban Forward