Proměnné v Mergadu

Nápověda
1

I. Proměnné v Mergado Editoru

1. Co jsou proměnné v Mergadu

Proměnné v Mergado Editoru představují zastoupení pro konkrétní hodnoty z elementů. Jsou to „držáky“ na data, která se liší produkt od produktu a která chcete dále zpracovávat nebo použít v pravidlech.

  • Proměnná může mít u každého produktu jinou hodnotu.
  • Typickým příkladem je element PRICE_VAT, jehož hodnota se napříč produkty mění.
  • Proměnnou lze vytvořit ručně – například pokud potřebujete vytáhnout část textu z názvu nebo popisu.
  • Kromě uživatelských proměnných existují i speciální systémové proměnné, jako @MERGADO_ID.

Mergado pracuje přímo s elementy jako se zdrojem hodnot. Proměnné jsou doplňkový nástroj tam, kde potřebujete z textu vyjmout jen určitou část nebo s hodnotami dále pracovat.

2. Jak proměnné fungují

Proměnné slouží k extrakci textu a k jeho dalšímu použití, především v pravidlech. Základní princip fungování je jednoduchý:

  1. Uživatel zvolí element, ve kterém je požadovaná informace.
  2. Zadá regulární výraz, který z tohoto elementu vybere konkrétní část textu.
  3. Tato část se uloží jako hodnota proměnné.
  4. Proměnná se následně použije v pravidle – Mergado vloží správnou hodnotu pro každý produkt zvlášť.
  5. U systémových proměnných (např. @MERGADO_ID) platí stejný postup – v pravidlech se používají obalené znaky procent: %@MERGADO_ID%.

Proměnné tak umožňují pracovat i s daty, která nejsou ve feedu dobře strukturovaná.

3. Proč a kdy proměnné používat

Proměnné jsou vhodné všude tam, kde potřebujete pracovat s částí textu, vytvářet nové hodnoty nebo doplňovat chybějící informace.

A. Nastavování hodnot v pravidlech

Proměnné se často používají k doplňování nebo úpravě hodnot v elementech. Pomocí regulárních výrazů můžete z textu vyjmout jen jeho část a uložit ji jako proměnnou, kterou pak vložíte do jiného elementu.

B. Sestavování a modifikace dat

Proměnné umožňují skládat hodnoty z více míst do jednoho výsledku. Typické je například sestavení názvu produktu kombinací více elementů a proměnných (např. výrobce, typ, velikost).

C. Extrakce dat do elementů PARAM

Pokud produkty neobsahují parametry v elementu PARAM, ale vlastnosti jsou uvedené v názvu nebo popisu, lze je pomocí regulárního výrazu vytáhnout do proměnných a následně uložit jako standardizované parametry. Tento postup je univerzální – funguje bez ohledu na to, jaké konkrétní hodnoty se v textu vyskytují.

D. Využití systémové proměnné @MERGADO_ID

@MERGADO_ID je unikátní identifikátor produktu, který Mergado používá pro interní identifikaci. Uživatelé jej mohou využít zejména v situacích, kdy:

  • chybí nebo se opakují hodnoty ITEM_ID nebo g:id,
  • je potřeba vytvořit unikátní URL přidáním #@MERGADO_ID,
  • je nutné obnovit obrázky uložené na zbožových srovnávačích.

Hodnotu @MERGADO_ID lze zapsat do libovolného elementu pomocí pravidla typu Přepsat.

Shrnutí sekce

Proměnné v Mergadu slouží k extrakci a dalšímu zpracování hodnot z elementů. Uživatel zvolí element, definicí regulárního výrazu vybere požadovanou část textu a uloží ji jako proměnnou. Tu pak může využít v pravidlech, při sestavování názvů, při tvorbě parametrů nebo při úpravě URL. Jsou vhodné všude tam, kde je potřeba pracovat s proměnlivým nebo nestrukturovaným textem a převést ho do jednotné podoby.

II. Typy proměnných v Mergadu

1. Uživatelské proměnné

Uživatelské proměnné představují hodnoty extrahované z elementů, které se mohou lišit produkt od produktu. Nejčastěji se používají v situacích, kdy potřebujete získat jen určitou část textu z názvu nebo popisu.

Vytváření uživatelských proměnných

Uživatelské proměnné se spravují na stránce Proměnné pomocí tlačítka Nová proměnná. Postup je následující:

  • vyberete element, ze kterého má proměnná vycházet,
  • zadáte regulární výraz, který určí část textu k zachycení,
  • v testovacím poli ověříte, že výraz funguje správně,
  • uložíte zachycenou část textu pod zvoleným názvem proměnné.
  • pomocí jednoho regulárního výrazu je možné vytvořit více proměnných najednou
    • pokud v regulárním výrazu použijete závorky, každá závorka se pak vyhodnocuje jako samostatná skupina a tu lze uložit do samostatné proměnné
    • typicky např. když v elementu s url obrázku jsou uvedeny více URL oddělené čárkou, a potřebujete každou URL vytáhnout do samostatné proměnné

Příklad

V Google feedu jsou v popisu produktu v elementu g:description uvedené rozměry produktu, například „150x50“, kde první hodnota představuje šířku a druhá délku: <g:description>Popis produktu, rozměry: 150x50</g:description>

Cílem je tyto hodnoty extrahovat a uložit do dvou samostatných parametrů: Šířka a Délka.

1. Vytvoření proměnných

  1. Na stránce Proměnné klikněte na Nová proměnná.
  2. V poli Element vyberte ze seznamu element g:description.
  3. Do pole Regulární výraz zadejte výraz, který zachytí oba rozměry: (\d+)x(\d+)
  4. V poli Testovací text se zobrazí náhodná hodnota ze zvoleného elementu, takže ihned vidíte, zda výraz funguje. Pomocí ikony šipek můžete načíst další ukázky.
  5. Pokud regulární výraz zachytí jakoukoli část textu, objeví se níže sekce s poli pro zadání názvů proměnných. Pokud má výraz více skupin, zobrazí se samostatné pole pro každou z nich.

V našem případě se zobrazí tato pole:

  • Celý match: „150x50“
    • Toto pole můžete ignorovat nebo uložit např. jako proměnnou rozmery, pokud potřebujete celý řetězec.
  • Skupina 1: „150“
    Pojmenujte jako sirka.
  • Skupina 2: „50“
    • Pojmenujte jako delka.
  1. Klikněte na Uložit. Tím získáte dvě nové proměnné: sirka a delka.

2. Nastavení parametrů pomocí pravidla

  1. Na stránce Pravidla vytvořte nové pravidlo typu Nastavit parametry produktů.
  2. V prvním sloupci vyberte výběr produktů, pro které chcete parametry nastavit.
  3. Zadejte:

První parametr:

  • Název parametru: Šířka
  • Hodnota parametru: %sirka%

Druhý parametr:

  • Název parametru: Délka
  • Hodnota parametru: %delka%
  1. Pravidlo uložte, aplikujte a poté projekt přegenerujte.

3. Výsledek ve výstupním feedu

<g:description>Popis produktu, rozměry: 150x50</g:description>
<g:attribute_detail>
<g:attribute_name>Šířka</g:attribute_name>
<g:attribute_value>150</g:attribute_value>
</g:attribute_detail>
<g:attribute_detail>
<g:attribute_name>Délka</g:attribute_name>
<g:attribute_value>50</g:attribute_value>
</g:attribute_detail>

Primární účel

Uživatelské proměnné se používají zejména pro:

  • vytáhnutí konkrétní části textu z elementů s delším nebo nestrukturovaným obsahem,
  • extrakci hodnot, jako je velikost, barva, objem, technické parametry či jiné vlastnosti produktu,
  • doplnění nebo vytvoření parametrů v elementu PARAM,
  • naplnění jiných elementů pomocí pravidel, například Nastavit parametry produktů nebo Přepsat.

Tento přístup je univerzální – funguje pro libovolné barevné varianty, velikosti či jiné hodnoty, které se mohou ve feedu vyskytovat.

2. Systémové proměnné

Systémové proměnné tvoří speciální sadu proměnných, které jsou přímo součástí Mergada. Uživatel je nevytváří ručně.

Fixní sada

Na stránce Proměnné najdete tabulku Speciální proměnné, kde jsou uvedeny všechny dostupné systémové proměnné. Aktuálně existuje jediná systémová proměnná: @MERGADO_ID

Co @MERGADO_ID znamená a jak funguje

  • @MERGADO_ID je interní unikátní ID produktu.
  • Jde o číselnou hodnotu, která je jednoznačná pro každý produkt.
  • V pravidlech se používá obalená znaky procent: %@MERGADO_ID%.

Typické použití @MERGADO_ID

  • jako náhrada za chybějící nebo duplicitní hodnoty v elementech ITEM_ID nebo g:id,
  • pro vytváření unikátních URL přidáním #@MERGADO_ID,
  • pro „obnovení“ obrázků – změna URL obrázků pomocí #@MERGADO_ID vyvolá znovunačtení u zbožových srovnávačů,
  • k zápisu do libovolného elementu pomocí pravidla typu Přepsat.

3. Použití elementů jako proměnných

V Mergadu lze v pravidlech přímo používat hodnoty elementů bez nutnosti vytvářet vlastní proměnnou. Stačí uvést název elementu obalený znaky procent, například:

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

Tímto způsobem lze pracovat s kompletním obsahem elementu. Tento mechanismus funkčně připomíná proměnnou, ale není nutné ji samostatně vytvářet.

Kdy stačí použít element

Element v pravidle postačí, pokud:

  • chcete použít celou hodnotu elementu,
  • neprovádíte extrakci části textu,
  • pracujete s jednoznačným a dobře strukturovaným obsahem.

Kdy vytvořit uživatelskou proměnnou

Uživatelskou proměnnou je vhodné vytvořit tehdy, když:

  • potřebujete získat jen určitou část textu (např. „XL“ z dlouhého názvu),
  • pracujete s popisem, který obsahuje různé hodnoty smíchané v jednom textu,
  • nechcete vytvářet desítky výběrů nebo pravidel pro každou konkrétní barvu, velikost či jinou variantu,
  • potřebujete univerzální řešení, které bude fungovat i při přidání nových hodnot do feedu.

V těchto případech regulární výraz umožní vytvořit proměnnou, která extrahuje přesně tu informaci, kterou potřebujete.

III. Práce s proměnnými v Mergadu

A. Správa proměnných

Proměnné se spravují na stránce Proměnné v hlavním menu Mergado Editoru. Tato stránka slouží jako centrální přehled všech proměnných v projektu:

  • Uživatelské proměnné – proměnné vytvořené uživatelem.
  • Speciální proměnné – systémové proměnné uvedené v tabulce Speciální proměnné.
  • Tvorba nových proměnných – probíhá kliknutím na Nová proměnná.

Správa proměnných zahrnuje i možnost proměnnou upravit nebo odstranit.

B. Tvorba uživatelských proměnných – workflow

Postup vytvoření nové uživatelské proměnné:

  1. Klikněte na tlačítko „Nová proměnná“ na stránce Proměnné.

  2. Vyberte zdrojový element, ze kterého má být proměnná vytvořena.

  3. Zadejte regulární výraz (masku), který určí část textu určenou k extrakci.

  4. Otestujte výraz:

    • V poli Testovací text se zobrazí náhodná hodnota ze zvoleného elementu.
    • Testovací text lze aktualizovat pomocí ikonky dvou šipek.
    • Klikněte na Otestovat výraz.

  5. Upravujte a testujte, dokud není nalezen správný výběr textu.

    • Pro práci s regulárními výrazy lze doporučit i externí nástroj regex101.com.

  6. Uložte proměnnou – zachycené části textu pojmenujte a potvrďte tlačítkem Uložit proměnnou.

Tento postup umožňuje efektivně extrahovat konkrétní informaci z libovolného textu v elementu a následně ji využít v pravidlech.

C. Použití proměnných v pravidlech

Proměnné se používají především v pravidlech, kde slouží jako zdroj hodnot pro zápis do jiných elementů.

Syntaxe

  • Proměnná se v pravidle zapisuje jako %NAZEV_PROMENNE%.
  • Stejná syntaxe platí i pro systémovou proměnnou: %@MERGADO_ID%.
  • Hodnotu celého elementu je možné použít přímo například:
    • %PRODUCTNAME%, %MANUFACTURER%, %DESCRIPTION%.
    • nebo jako kombinace dvou: %URL% %@MERGADO_ID%

Typické použití

1. Pravidlo Přepsat
Slouží ke skládání nových hodnot – například sestavení názvu produktu z více zdrojů: %MANUFACTURER% %PRODUCTNAME% %PARAM_VELIKOST%

2. Pravidlo Nastavit parametry produktů
Slouží pro naplňování elementu PARAM.
Pokud je hodnota parametru uložena v proměnné, uvede se na pravé straně pravidla.

D. Použití proměnných v dotazech (výběrech)

Proměnné se přímo nepoužívají v syntaxi dotazů. Dotazy však často vymezují skupinu produktů, na které se následně aplikuje pravidlo s proměnnou.

Příklad postupu:

  • vytvoříte výběr produktů, které obsahují určitou vlastnost v názvu,
  • na tento výběr aplikujete pravidlo, které používá proměnnou vytvořenou pomocí regulárního výrazu.

Příklad

V názvech některých produktů jsou uvedené velikosti, které potřebujete extrahovat a uložit jako nový parametr „Velikost“. Ukázkový název produktu: „Adidas tričko ABC, barva červená, velikost XL“

  1. Vytvoření proměnné - Vytvořte proměnnou ze zdrojového elementu (např. g:title). Pomocí regulárního výrazu zachyťte část textu představující velikost produktu, tedy například „XL“. Proměnnou uložte pod názvem, například velikost_produktu.
  2. Vytvoření výběru produktů - Vytvořte výběr produktů, které obsahují velikost v názvu. Můžete použít např. podmínku typu: g:title CONTAINS "velikost" (podle skutečné struktury názvů vašich produktů).
  3. Vytvoření pravidla – dvě možné varianty

Varianta A: Pravidlo Přepsat

Použije se, pokud chcete ručně sestavit strukturu parametru pomocí elementů.

  • do pole Element zadejte:
    g:attribute_detail { g:attribute_name = "Velikost" } | g:attribute_value
    (pokud parametr „Velikost“ ještě neexistuje, Mergado jej automaticky vytvoří)
  • do pole Nová hodnota zadejte:
    %velikost_produktu%

Varianta B: Pravidlo Nastavit parametry produktů

Použije se, pokud chcete parametr vytvořit jednoduše pomocí formuláře.

  • do pole Název parametru zadejte:
    Velikost
  • do pole Hodnota parametru zadejte:
    %velikost_produktu%

Tímto způsobem se extrahovaná velikost uloží jako standardizovaný parametr, který lze dále využívat v exportních formátech nebo pravidlech.

E. Zobrazení a export proměnných

Zobrazení hodnot

  • Systémové proměnné @MERGADO_ID:
    • Hodnoty systémové proměnné @MERGADO_ID je možné zobrazit na stránce Produkty.
    • V tabulkovém výpisu lze pomocí ikonky Mergada přidat sloupec s hodnotami @MERGADO_ID.
  • Uživatelské proměnné
    • Hodnoty uživatelských proměnných lze zobrazit až po vložení proměnné do elementu pomocí pravidla.
    • Hodnoty elementu vytvořené z proměnné zkontrolujeme buď na stránce Produkty, nebo také v části Elementy → Hodnoty elementu → Vypsat hodnoty elementu.

Export do CSV

  • Stejně jako zobrazit, vyexportovat hodnoty proměnných lze pouze jako hodnoty elementu, do kterého jsme proměnnou vložili pravidlem, nebo pokud se jedná o systémovou proměnnou @MERGADO_ID:
    • Na stránce Produkty přepněte na tabulkový výpis, vyberte správný element a klikněte na Stáhnout CSV.
    • Vyberte volbu Sloupce z tabulky – tím se stáhnou i hodnoty proměnných, které byly v tabulce zobrazeny.

IV. Use-cases a nejčastější chyby

1. Typické use-cases

a) Doplnění parametrů produktu

Hodnoty, které jsou uvedené v názvu nebo popisu (např. velikost, barva, objem, materiál), lze pomocí regulárního výrazu extrahovat do uživatelské proměnné. Takto získané hodnoty se následně zapisují do elementu PARAM pravidlem Nastavit parametry produktů.

b) Tvorba nového názvu produktu

Pro úpravu nebo sjednocení názvů lze sestavit nový obsah elementu z více proměnných a elementů.
Typický příklad použití v pravidle Přepsat:

%MANUFACTURER% %PRODUCTNAME% %velikost%

kde MANUFACTURER a PRODUCTNAME jsou standardní elementy, a velikost je uživatelská proměnná. Výsledkem je strukturovaný a konzistentní název produktu.

c) Odstranění extrahovaných dat z názvu

Pokud byly parametry vytažené z názvu a přesunuty do PARAM, může být potřeba odstranit je z původního názvu produktu. Provádí se to pravidlem Najít a nahradit za využití regulárního výrazu.

Tento postup je běžný například u formátů, které vyžadují čistý název bez velikostí či barev.

d) Použití @MERGADO_ID jako unikátního klíče

@MERGADO_ID se používá zejména při:

  • náhradě chybějících nebo duplicitních identifikátorů (ITEM_ID, g:id),
  • vytváření unikátních URL (např. přidáním #@MERGADO_ID na konec adresy),
  • vynucení znovunačtení obrázků na srovnávačích.

Tato systémová proměnná se zapisuje do elementů pomocí pravidla Přepsat.

2. Nejčastější chyby a jejich řešení

Proměnná vrací prázdné hodnoty

  • Regulární výraz neodpovídá skutečnému textu.
  • Řešení: upravit výraz a otestovat jej na více případech v Mergadu nebo v nástroji regex101.com.

Výraz zachytí příliš mnoho textu

  • Regulární výraz je příliš obecný.
  • Řešení: zpřesnit pattern, případně použít kotvy, skupiny nebo omezení rozsahu.

Zvolený element neobsahuje požadovaná data

  • Proměnná je vytvořená nad nesprávným elementem.
  • Řešení: ověřit, ve kterém elementu se informace skutečně nachází, a proměnnou podle toho upravit.

Pravidlo se neprojevilo v datech

  • Pravidlo nemuselo být aplikováno nebo bylo použito na jiný výběr.
  • Řešení: zkontrolovat aplikaci pravidel a ověřit výstup v části
    Elementy → Hodnoty elementu → Vypsat hodnoty elementu.

Duplicitní identifikátory

  • Některé služby vyžadují unikátní identifikátor.
  • Řešení: použít %@MERGADO_ID% a přepsat nebo doplnit jím cílový element, který duplicitu obsahuje.

FAQ

1. Co je v Mergadu proměnná?
Proměnná je uložená hodnota získaná z elementu, kterou můžete použít v pravidlech a dalších úpravách dat.

2. K čemu proměnné slouží?
Slouží k extrakci hodnot z elementů, k doplnění parametrů, tvorbě nových hodnot nebo standardizaci dat.

3. Jaký je rozdíl mezi elementem a proměnnou?
Element je původní hodnota z feedu. Proměnná je část této hodnoty získaná regulárním výrazem.

4. Kdy mám použít proměnnou a kdy stačí použít element?
Proměnnou použijte, pokud potřebujete vytáhnout a použít část textu. Element použijte, pokud chcete pracovat s jeho celou hodnotou.

5. Jak se proměnná vytváří?
Proměnná se vytváří na stránce Proměnné pomocí tlačítka „Nová proměnná“. Vyberete element, který obsahuje potřebná data, a zadáte regulární výraz, kterým zacílíte na část textu k extrakci. Výraz následně otestujete na ukázkové hodnotě a případně upravíte, dokud neodpovídá požadovanému výsledku. Nakonec zachycenou hodnotu pojmenujete a uložíte jako proměnnou.

6. Musím vytvořit proměnnou pro každý element, se kterým chci pracovat?
Ne. Pokud potřebujete použít celý obsah elementu, nemusíte vytvářet proměnnou.

7. Můžu vytvořit více proměnných najednou?
Ano. Pokud regulární výraz obsahuje více skupin (závorek), každou lze uložit jako samostatnou proměnnou pomocí jednoho formuláře.

8. Co je systémová proměnná @MERGADO_ID?
Je to interní unikátní identifikátor produktu, který je dostupný automaticky.

9. K čemu slouží @MERGADO_ID?
K doplnění chybějících nebo duplicitních identifikátorů, k vytváření unikátních URL, a k vynucení znovunačtení obrázků v cílovém systému atd.

10. Jak použít proměnnou v pravidle?
Vložíte ji ve tvaru %NAZEV_PROMENNE%.

11. Jak vložit @MERGADO_ID do pravidla?
Píšete jej ve tvaru %@MERGADO_ID%.

12. Můžu použít proměnnou v dotazu (výběru)?
Ne, syntaxe proměnných se v dotazech nepoužívá. Dotaz slouží jen k vymezení produktů, na které pravidlo s proměnnou dopadne.

13. Kde proměnné spravuji?
Na stránce Proměnné v hlavním menu projektu.

14. Lze proměnnou později upravit nebo smazat?
Ano, v přehledu proměnných můžete provádět úpravy i odstranění.

15. Jak zjistím, že můj regulární výraz funguje?
Použijte Testovací text v dialogu pro tvorbu proměnné nebo otestujte výraz na regex101.com.

16. Co mám udělat, když proměnná vrací prázdné hodnoty?
Upravit regulární výraz tak, aby odpovídal struktuře textu v elementu. Můžete se také obrátit na naši technickou podporu.

17. Proč se mi proměnná nepropsala do výsledku?
Zkontrolujte, zda bylo pravidlo aplikováno a zda proměnná odpovídá obsahu elementu.

18. Jak zkontroluji hodnotu proměnné v produktu?
Nejjednodušší způsob je zobrazit si produkt v tabulkovém výpisu na stránce Produkty a přidat sloupec s příslušným elementem nebo s @MERGADO_ID. Hodnoty elementu vytvořené z proměnné budou ale vidět až po vytvoření a aplikování pravidla. Můžete také využít výpis hodnot v sekci Elementy → Hodnoty elementu → Vypsat hodnoty elementu. Tento nástroj ukáže přesný obsah elementu tak, jak se propsal po aplikaci pravidel. Díky tomu snadno ověříte, zda proměnná funguje podle očekávání.

19. Můžu exportovat hodnoty proměnných do CSV?
Ano, stačí použít volbu Sloupce z tabulky při exportu CSV.

20. Proč regulární výraz zachytil příliš mnoho textu?
Výraz je příliš obecný. Omezte jej přesnějšími skupinami nebo kotvami.

21. Jak extrahované hodnoty dostanu do názvu produktu?
Vytvořte proměnnou, pak ji vložte do pravidla Přepsat jako kombinaci názvu a proměnné.

22. Jak odstranit extrahovanou hodnotu z názvu?
Použijte pravidlo Najít a nahradit s vhodným regulárním výrazem.

23. Lze proměnnou použít pro práci s URL?
Ano, proměnné můžete používat také pro úpravu URL adres. Typickým příkladem je přidání hodnoty %@MERGADO_ID% na konec URL, čímž vytvoříte unikátní adresu (například pro variantní produkty nebo obrázky). Tento postup se využívá i v situaci, kdy je potřeba vynutit znovunačtení obrázků na zbožových srovnávačích. V pravidlech se URL sestavuje stejnou syntaxí jako jiné textové hodnoty.

24. Co když produkt nemá parametr v elementu PARAM?
Extrahujte hodnotu z názvu nebo popisu pomocí proměnné a doplňte ji pravidlem Nastavit parametry produktů.

25. Je nutné mít pro každou vlastnost samostatný regulární výraz?
Ne. Dobře navržený výraz obsahující skupiny extrahuje různé vlastnosti samostatně (např. všechny velikosti nebo barvy).

26. Může proměnná obsahovat více hodnot?
Ne. Proměnná je množina hodnot, která obsahuje pro každý produkt vždy právě jednu nebo žádnou hodnotu.

27. Co dělat, když mám duplicitní hodnoty v ITEM_ID?
Pokud ve feedu chybí unikátní identifikátor, můžete jej nahradit systémovou proměnnou @MERGADO_ID. Pomocí pravidla typu Přepsat nastavíte %@MERGADO_ID% do elementu ITEM_ID nebo g:id, čímž zajistíte, že každý produkt získá jedinečnou hodnotu. Tento postup je spolehlivý a doporučený pro projekty, kde se identifikátory opakují jsou nekonzistentní nebo obsahuji nepovolenou hodnotu. Změny se projeví po aplikaci pravidel a následné aktualizaci výstupního feedu.

28. Je použití proměnných výpočetně náročné?
Ne, proměnné se vyhodnocují při aplikaci pravidel a nemají negativní vliv na běžné fungování projektu.