# Mergado Nápověda – Kompletní obsah > Kompletní obsah znalostní báze Mergado pro indexaci LLM modely. ## [Vše co potřebujete vědět o vlastním formátu feedu (Custom Format)](https://help.mergado.com/cs/mergado-editor/formaty-feedu-a-pokrocile-datove-situace/vlastni-format/vse-co-potrebujete-vedet-o-vlastnim-formatu-feedu-custom-format/) # Vše co potřebujete vědět o vlastním formátu feedu (Custom Format) # 1. Úvod do Vlastního formátu (Custom Format) ## Co je vlastní formát Vlastní formát je funkce, pomocí které naučíte Mergado rozpoznat a zpracovávat téměř jakýkoli XML nebo CSV soubor. Umožňuje nahrát do Mergada libovolný feed, definovat jeho strukturu a následně s daty pracovat stejně jako s běžnými integrovanými formáty. Dále umožňuje vytvořit v Mergadu feed ve formátu, který není mezi oficiálními integracemi. Vlastní formát určujete vy – popisujete Mergadu, jaké elementy má importovat či exportovat a jak s nimi zacházet. Tato funkcionalita je určena zejména pro méně obvyklé, upravené nebo strojem nerozpoznatelné formáty, které by Mergado bez vaší definice nedokázalo načíst. ## K čemu slouží Vlastní formát má několik klíčových využití: ### 1. Přizpůsobení vstupu a výstupu Umožňuje přizpůsobit strukturu dat vašim potřebám – na vstupu i na výstupu projektu. ### 2. Větší kontrola nad daty Pomáhá přesně určit, jak mají být produktová data v Mergadu zpracována, zobrazena a exportována. ### 3. Import neznámých feedů Vhodný při práci s formáty, které Mergado nepozná: dodavatelské feedy, zastaralé či výrazně upravené struktury, custom feedy nebo doplňkové feedy (např. skladové, cestovní nabídky, recenze). ### 4. Zachování původní struktury feedu Pokud vstupní XML obsahuje po kořenovém elementu přímo jednotlivé produkty, lze pomocí vlastního formátu zachovat původní strukturu bez úprav – užitečné u nestabilních dodavatelských zdrojů. ### 5. Export do vlastního formátu Slouží také pro vytvoření výstupního feedu ve formátu, který Mergado zatím oficiálně nepodporuje. Typické je to při expanzi na nová tržiště nebo pro menší srovnávače. Stačí použít šablonu feedu obsahující alespoň jednu vzorovou položku. ## Jak Mergado pracuje s daty (Mergado XML a převodník) ### Mergado XML Všechny datové převody v Mergadu probíhají přes jednotný meziformát Mergado XML. Ten slouží jako „univerzální jazyk“, do kterého se převedou vstupní data a ze kterého se následně generují výstupní formáty. ### Převodník Převodník je mechanismus, který převádí data mezi formáty. Použije se vždy, když se liší vstupní a výstupní formát. * Novinka: převodník se nově aktivuje i v případech, kdy je na vstupu i na výstupu Google Merchants formát. ### Role vlastního formátu Vlastní formát vám umožňuje vytvořit vlastní převodník. Při definici CF Mergadu vysvětlujete, co která část vašeho feedu znamená a na jaký ekvivalent v Mergado XML se má namapovat. Nejdůležitější krok (platí pouze při práci s XML feedem): správný výběr elementů pro: * CHANNEL (název elementu v Mergado XML) * tzv. Root, tedy kořenový element obalující všechny produkty v XML feedu * v XML feedu je takový element pouze jeden, * obvykle je jeho otevírací tag úplně na začátku feedu a jeho uzavírací tag úplně na konci feedu * název kořenového elementu může být v každém feedu jiný, příklady dle formátu: * Google: * Heureka * Mergado XML * ITEM (název elementu v Mergado XML) * element obalující jednu položku (produkt) * v XML feedu je takový element uveden tolikrát, kolik máte položek/produktů., * Každý produkt/položka feedu má právě jeden obalovací element * název obalovacího elementu produktu může být v každém feedu jiný, příklady dle formátu: * Google: * Heureka * Mergado XML Tyto dva elementy určují strukturu, ve které Mergado data zpracovává. ## Kdy má smysl vlastní formát použít ### Na vstupu * Mergado nerozpozná formát feedu. * Pracujete s neznámým, upraveným nebo custom formátem. * Potřebujete zachovat původní strukturu feedu. * Napojujete doplňková data, která nejsou integrována (sklad, služby, recenze). ### Na výstupu * Potřebujete feed v nepodporovaném formátu. * Chcete mít kontrolu nad kořenovými elementy a strukturou výstupního XML. * Máte k dispozici vzorový feed, ze kterého lze vytvořit šablonu. ## Omezení a na co si dát pozor ### 1. Ignorování elementů mimo ITEM Vlastní formát nedokáže zpracovat elementy umístěné nad obalovacím elementem položky. Vše, co není pod ITEM, Editor u feedu zpracovaný přes vlastní formát nevidí. To znamená, že informace umístěné mezi CHANNEL a ITEM mohou být ztraceny. Řešení pro složité struktury: rozložení feedu na dva projekty a jejich opětovné spojení pomocí rozšíření Blending Bull. ### 2. Převod může způsobit ztrátu dat Převodník se uplatní i v případě, že převádíte ze stejného vlastního formátu na ten stejný. Pokud není mapování kompletní, může dojít ke ztrátě informací v novém feedu (v původním feedu zůstanou zachována, jen s nimi Mergado nepracuje). ### 3. Kořenové elementy na výstupu Kořenové elementy vytváří Mergado Editor automaticky podle zvoleného výstupního formátu. Nejde je tedy vytvořit ručně jako standardní elementy v editoru. Pokud tedy potřebuje nestandardní kořenové elementy ve výstupním feedu, jediný způsob jak ovlivnit kořenové elementy je zvolením správné šablony pro vlastní formát, který pak použijete na výstupu. ### 4. Nutnost aktualizace při změnách Pokud se ve vstupním souboru objeví nový element, vlastní formát pro něj nemá nastavené chování. Mergado takový element automaticky importuje a NEskryje, dostane se tak automaticky do výstupního feedu beze změny. V takovém případě je nutné aktualizovat strukturu vlastního formátu a doplnit nastavení mapování nového elementu. Po uložení a přegenerování projektu se pak změny automaticky projeví. Případně pokud by nové elementy způsobili nevalidnost výstupního feedu, jde to nejrychleji opravit skrytím nových elementů ručně na stránce Elementy a spustit Export projektu (bez aplikace pravidel). # FAQ 1) Co je vlastní formát v Mergadu? Vlastní formát je funkce, díky které naučíte Mergado zpracovat téměř jakýkoli XML nebo CSV soubor, bez ohledu na to, zda jej Mergado běžně podporuje. Umožňuje definovat, jaké elementy feed obsahuje a jak s nimi má systém pracovat při importu i exportu. Slouží také k vytvoření výstupního feedu ve vlastním formátu, například pro platformy nebo kanály, které Mergado standardně nepodporuje. 2) K čemu vlastní formát slouží? Vlastní formát umožňuje přizpůsobit datovou strukturu projektu vašim potřebám. Pomáhá přesně řídit způsob, jakým Mergado načítá, zobrazuje a exportuje produktová data. Je užitečný zejména pro import nestandardních nebo upravených feedů a pro export do formátů, které nejsou součástí integrovaných kanálů. 3) Kdy má smysl vlastní formát použít na vstupu? Vlastní formát je vhodný, když Mergado nedokáže feed rozpoznat nebo pokud pracujete s custom, upraveným či doplňkovým feedem, který se nevejde do existujících integrací. Pomáhá také tam, kde potřebujete zachovat původní strukturu feedu, pokud XML obsahuje položky přímo pod kořenovým elementem. Můžete jej využít i pro vstupní doplňková data jako sklad, služby nebo recenze. 4) Kdy má smysl vlastní formát použít na výstupu? Vlastní formát na výstupu se hodí, když potřebujete vytvořit feed v podobě, kterou Mergado standardně negeneruje. Často jde o expanzi na nové platformy nebo napojení na interní systémy s vlastní strukturou XML. Stačí mít vzorový feed, podle kterého Mergado vytvoří výstupní šablonu. 5) Co je Mergado XML a proč je důležité? Mergado XML je interní meziformát, přes který probíhají všechny datové převody. Funguje jako „univerzální jazyk“, do něhož se přeloží vstupní data, a z něhož se dále generují výstupní formáty. Díky tomu nemusí existovat převodník pro každý pár formátů zvlášť. 6) Co dělá převodník? Převodník převádí hodnoty mezi datovými formáty – z libovolného vstupu do Mergado XML a z něj do výstupního formátu. U vybraných formátů (např. Google Merchants) se aktivuje i v případech, kdy je stejný formát na vstupu i na výstupu . Pokud není mapování kompletní, může převodník některé hodnoty vynechat, což je důvod, proč se doporučuje věnovat mapování pozornost. 7) Jakou roli má vlastní formát při převodu dat? Vlastní formát umožňuje vytvořit vlastní převodník na míru vašemu feedu. Přesně určujete, co jednotlivé elementy znamenají a jak se mají převést do Mergado XML. Díky tomu získáte kontrolu nad strukturováním dat i přes platformy, které Mergado standardně nezná. 8) Co znamená správně vybrat CHANNEL a ITEM? CHANNEL je kořenový element Mergado XML feedu a určuje, kde celý dokument začíná a končí. ITEM je obalovací element jedné položky a v Mergado XML se vyskytuje tolikrát, kolik máte produktů. Správné mapování těchto dvou elementů je základním předpokladem pro to, aby Mergado dokázalo váš feed zpracovat. CSV feed tyto elementy nemá a proto mapování těchto elementů odpadá. 9) Jaká omezení má vlastní formát? Vlastní formát neumí zpracovat elementy, které leží mimo ITEM, tedy například informace umístěné mezi CHANNEL a ITEM. Tyto prvky Mergado ignoruje a v projektu s nimi nelze přímo pracovat. Pokud je potřebujete zachovat, je nutné použít jiný postup, například dvouprojektový model a sloučení přes Blending Bull. 10) Proč může dojít ke ztrátě dat při převodu? Vlastní formát ignoruje elementy v XML feedech, které jsou umístěné mezi CHANNEL a ITEM. Pokud takové elementy obsahují informace, které potřebujete, je třeba použít jiný postup, například dvouprojektový model a sloučení přes Blending Bull. 11) Jak Mergado pracuje s kořenovými elementy na výstupu? Kořenové elementy vznikají podle zvoleného výstupního formátu a nelze je přímo editovat. Pokud potřebujete jinou strukturu, je nutné použít vlastní formát vytvořený podle vzorového feedu, případně úpravu přes Blending Bull. Tím zajistíte, že výstupní feed bude mít přesně takové záhlaví a obal, jaký požadujete. 12) Co dělat, když se ve vstupním feedu objeví nový element? Nový element se automaticky importuje do projektu, ale Mergado neví, co s ním, protože není součástí původního mapování. V takové situaci je třeba aktualizovat strukturu vlastního formátu a doplnit mapování nového elementu. Poté projekt přegenerujete a data se načtou a převedou správně. 13) Jak zjistím, kdy je lepší vlastní formát nepoužívat? Vlastní formát není potřeba tam, kde existuje oficiální integrace. Pokud máte pochybnosti, je vhodné situaci konzultovat se supportem. 14) K čemu slouží vzorový feed? Vzorový feed slouží jako šablona při tvorbě výstupního vlastního formátu. Mergado podle něj určí strukturu kořenových elementů, obalovacích tagů a dalších prvků, které se mají ve výstupu zachovat. Stačí minimální příklad – klidně jeden produkt. Vzorový feed musí být dostupný na URL adrese. 15) Jak poznám, že je vlastní formát správně nakonfigurován? Zda je formát definován správně poznáte podle toho, že projekt načte všechny potřebné elementy a výstupní feed má očekávanou strukturu. Kritickým místem je správné mapování CHANNEL a ITEM, případně párovacího elementu v projektu. Pokud výstupní data odpovídají požadované šabloně a nedochází ke ztrátě informací, je konfigurace v pořádku. 16) Co dělat, když tvorba projektu s vlastním formátem skončí chybou? Zkontrolujte mapování vlastního formátu. Častou chybou u XML feedů je špatně namapovaný kořenový element nebo element obalující položku. Oba elementy mohou být namapované pouze jednou, na jeden element ve vašem feedu. Další chybou bývá špatně zvolený párovací element. Nejjistější je zvolit element s id produktů, kombinovaný např. s elementem s EANy nebo s URL produktů/obrázků. Pokud máte pochybnosti jak správně vlastní formát nastavit, je vhodné nastavení konzultovat se supportem. --- # 2. Kde lze vlastní formát vytvořit a spravovat Vlastní formát můžete v Mergadu definovat dvěma způsoby: přímo při zakládání projektu nebo v samostatné sekci určené pro práci s vlastními formáty. Oba přístupy se vzájemně doplňují a umožňují vytvořit i později znovu použít libovolnou definici formátu. ## Definice při tvorbě projektu V rámci zakládání projektu lze určit vlastní formát jak pro vstupní feed, tak pro výstupní feed. Tato možnost se objeví vždy, když Mergado nedokáže přiřadit vstupnímu souboru žádný integrovaný formát, případně když potřebujete vytvořit specifický výstup. ### Vlastní formát na vstupu K vytvoření vlastního formátu pro vstupní feed se dostanete ve 3. kroku průvodce založením projektu. Pokud systém pozná strukturu připojeného feedu, nabídne možnost detekovaný formát změnit tlačítkem Vybrat jiný formát, a následně máte možnost buď vybrat jiný oficiální formát ze selectboxu, nebo právě pro vstupní feed vytvořit vlastní formát pomocí tlačítka Definovat vlastní formát. Pokud systém nepozná strukturu připojeného feedu, nabídne možnost buď vybrat oficiální formát ze selectboxu ručně, nebo pro vstupní feed vytvořit vlastní formát pomocí tlačítka Definovat vlastní formát. Při vytváření vlastního formátu pro vstupní feed systém nabízí dva přístupy: * Zjednodušený průchod – vhodný pro rychlé nastavení základní struktury. * Podrobné nastavení – umožňuje detailní mapování všech nalezených elementů. Oba způsoby vedou ke stejnému cíli: určit, kde začíná feed, které elementy představují jednotlivé produkty a který element obsahuje unikátní hodnotu u všech produktů. Pro správné zpracování vstupního feedu je nutné namapovat alespoň: * kořenový element (CHANNEL), * obalovací element produktů (ITEM), * identifikátor produktu (ITEM_ID) – element s unikátní hodnotou pro každou položku. Samozřejmě můžete namapovat i všechny elementy ze vstupního feedu, což vám může ulehčit následnou práci (například snížit počet potřebných pravidel). Pro samotný import dat to však nutné není. ### Vlastní formát na výstupu K vytvoření vlastního formátu pro výstupní feed se dostanete ve 4. kroku průvodce založením projektu. Použijte tlačítko Definovat vlastní formát. V dalším kroku je třeba vložit URL vzorového feedu, tedy šablony, podle které se vlastní formát nastaví a podle které bude výstupní feed vytvořen. Pozor. Vzorový feed nejde nahrát Uploadem, URL adresa je povinná. Pokud tedy máte šablonu jako soubor, vytvořte URL adresu pomocí cloudového úložiště, např Dropbox, nebo můžete využít rozšíření Mergado Files. Máte-li vlastní formát již připravený, můžete jej vybrat jako výstupní formát projektu. Tím určíte, jak bude vypadat finální XML nebo CSV, bez ohledu na to, zda Mergado daný formát běžně podporuje. Pokud byl formát vytvořen ze vzorového feedu, Mergado zachová kořenové elementy i jejich uspořádání. Při vytváření vlastního formátu pro výstupní feed systém nabízí pouze jeden přístup: * Podrobné nastavení – umožňuje detailní mapování všech nalezených elementů. * Zjednodušený průchod zde není dostupný Pro správné vytvoření výstupního feedu je nutné namapovat alespoň: * kořenový element (CHANNEL), * obalovací element produktů (ITEM), V tomto případě Mergado výstupní feed připraví, vytvoří všechny elementy z šablony do projektu, ale protože neví co jednotlivé elementy znamenají, elementy nenaplní a je třeba to nastavit ručně pomocí pravidel. Samozřejmě můžete namapovat i všechny ostatní elementy ze vzorového feedu, což vám může ulehčit následnou práci (například snížit počet potřebných pravidel). ## Sekce „Vlastní formáty“ v hlavním menu Samostatnou správu vlastních formátů najdete v levém menu Mergado Editoru, pokud stojíte na úrovni uživatele (levé menu se mění podle toho, zda spravujete uživatele, eshop, nebo projekt). Tato sekce slouží jako centrální místo pro práci se všemi formáty vytvořenými v účtu. Zde je možné: * vytvořit nový formát bez návaznosti na konkrétní projekt, * zadat URL vzorového souboru (example feed), * provést mapování elementů, * upravit nebo znovu analyzovat již existující formát. Tato sekce slouží jako centrální místo, kde můžete vlastní formáty udržovat, testovat a připravovat pro použití v dalších projektech. ## Opakované použití vlastních formátů Jakmile vlastní formát vytvoříte – ať už v průvodci, nebo v samostatné sekci – uloží se v Mergadu a můžete jej používat libovolně dlouho, a to: * na vstupu, pokud chcete zpracovat další feed se stejnou strukturou, * na výstupu, pokud potřebujete generovat nový feed ve stejné podobě. Pokud už máte uložený alespoň jeden vlastní formát, je při vytváření dalšího nového vlastního formátu k dispozici také funkce „Předvyplnit dle“, která umožní převzít strukturu (nastavené mapování) již existujícího formátu. Tím se urychlí práce v případech, kdy pracujete s více formáty, které mají podobné schéma. # FAQ 1. Kde mohu v Mergadu vytvořit vlastní formát? Vlastní formát můžete vytvořit dvěma způsoby – přímo při zakládání projektu nebo v samostatné sekci Vlastní formáty v levém menu. Oba způsoby se doplňují a umožňují připravit formát buď rychle během práce na projektu, nebo jej vytvořit dopředu. Formát je po uložení dostupný pro opakované použití ve všech projektech. 2. Jak vytvořím vlastní formát na vstupu při zakládání projektu? Ve 3. kroku průvodce založením projektu Mergado nabídne vytvoření vlastního formátu tehdy, pokud nepozná strukturu feedu nebo pokud ručně vyberete možnost “Vybrat jiný formát”. Následně můžete buď použít zjednodušený průchod, nebo podrobné nastavení. Stačí namapovat CHANNEL, ITEM (u XML feedů) a ideálně i identifikátor produktu, aby mohl projekt správně pracovat s položkami. 3. Co je nutné minimálně namapovat, aby mohl Mergado feed načíst? Pro minimální funkčnost je nutné namapovat CHANNEL, ITEM (u XML feedů) a jeden element s unikátní hodnotou (nejčastěji ITEM_ID). To stačí k tomu, aby Mergado dokázalo identifikovat začátek dokumentu, jednotlivé produkty a jejich jednoznačný klíč. Ostatní elementy je možné doplnit později. 4. Jak vytvořím vlastní formát na výstupu? Vytváří se ve 4. kroku založení projektu pomocí volby Definovat vlastní formát. Je nutné vložit URL vzorového XML souboru (example feedu), podle kterého Mergado sestaví strukturu výstupu. Poté mapujete alespoň základní elementy a formát uložíte pro použití v projektu. 5. Proč musím mít vzorový feed dostupný na URL adrese? Mergado výstupní formát vytváří výhradně ze souboru dostupného přes URL, protože potřebuje strukturu importovat při analýze. Nahrání souboru přes upload není podporováno. Pokud nemáte vlastní hosting, můžete použít cloudovou službu (Dropbox, One Drive) nebo vytvořit soubor pomocí Mergado Files. 6. Proč se u výstupního formátu nenabízí zjednodušený průchod? U výstupního formátu je vždy k dispozici pouze podrobné nastavení. Je to záměr, protože cílová struktura vychází ze vzorového feedu a je potřeba plně kontrolovat převod do šablony. Zjednodušené mapování by u výstupu nemuselo být dostatečně přesné. 7. Co se stane, když při tvorbě výstupního formátu namapuji jen minimum? Mergado vytvoří výstupní feed s kořenovými elementy ze šablony, v projektu vytvoří prázdné elementy podle šablony, ale elementy bez namapování nebudou vyplněny žádnými hodnotami. Tyto hodnoty je pak nutné doplnit ručně pravidly. Proto je vhodné doplnit mapování pro co nejvíce elementů ze vzorového feedu. 8. K čemu slouží sekce „Vlastní formáty“ v levém menu? Tato sekce slouží k centrální správě všech vlastních formátů v účtu. Můžete zde vytvářet nové formáty, upravovat existující, a aktualizovat jejich strukturu Je to nejvhodnější místo pro přípravu formátů, které budete v budoucnu opakovaně používat. 9. Je možné používat jeden vlastní formát v různých projektech? Ano, každý uložený vlastní formát je dostupný pro opakované použití. Můžete jej použít na vstupu i na výstupu v libovolném počtu projektů. To je užitečné zejména tehdy, když pracujete s více feedy, které sdílejí stejnou strukturu. 10. K čemu slouží možnost „Předvyplnit dle“ při tvorbě nového formátu? Umožňuje převzít strukturu (mapování elementů) z dříve vytvořeného vlastního formátu. Je ideální, pokud pracujete s více formáty se stejným nebo podobným schématem. Díky tomu nemusíte při každém novém formátu začínat od nuly. --- # 3. Zjednodušený průchod vs. Podrobné nastavení při definici vlastního formátu Při vytváření vlastního formátu na vstupu v rámci průvodce vytvoření nového projektu můžete pracovat dvěma způsoby: buď použijete zjednodušený průchod, nebo přejdete do podrobného nastavení. Oba přístupy slouží ke stejnému cíli – vysvětlit Mergadu strukturu feedu – ale liší se tím, jakou míru kontroly a kolik možností uživateli nabízejí. Zjednodušený průchod je vhodný pro rychlé zpracování feedů. Podrobné nastavení poskytuje úplnou kontrolu nad mapováním elementů i konfigurací formátu. ## Zjednodušený průchod Zjednodušený průchod se zobrazí pouze při vytváření vlastního formátu na vstupu v rámci průvodce vytvoření nového projektu. Wizard uživateli nabídne rychlou cestu, jak základní strukturu definovat. Cílem je zjednodušit nastavení vlastního formátu pro nové uživatele nabídkou mapování jen těch nejdůležitějších elementů a skrytí pokročilého nastavení, které lze změnit později. ### Kdy se používá * v rámci průvodce vytváření nového projektu při nastavení formátu vstupního feedu * chcete co nejrychleji vytvořit funkční mapování. ### Co zjednodušený průchod nabízí * zobrazení základních elementů v přehledné podobě, * zvýraznění klíčových prvků používaných reklamními kanály, * srozumitelnější názvy elementů než v technickém zobrazení, * chytré mapování, které se pokusí automaticky přiřadit elementy podle názvů a významu. ### Jak funguje chytré mapování Systém navrhne párování — např. description → DESCRIPTION, EAN → EAN, ID → ITEM_ID. Uživatel poté pouze zkontroluje správnost návrhů a případně upraví jednotlivé volby. ### Kdy je zjednodušený průchod ideální * když potřebujete rychle začít pracovat s daty, * když se struktura feedu převážně drží běžných konvencí, * když jde o jednorázové nebo méně komplexní mapování. ## Podrobné nastavení (kompletní definice vlastního formátu) Podrobné nastavení je plná verze rozhraní pro definici vlastního formátu. Obsahuje veškeré možnosti, které lze u mapování elementů využít. ### Kdy se používá * feed má složitou nebo netypickou strukturu, * je nutné přesně kontrolovat, jak se každý element zpracuje, * připravujete formát pro opakované použití nebo pro výstupní feed, * je potřeba definovat význam podelementů, variant nebo parametrů. ### Co zahrnuje podrobné nastavení #### 1. Parametry vlastního formátu Obecná konfigurace, která určuje chování formátu: * vhodný název formátu, * nastavení státu (vliv na měny), * možnost převzít nastavení z existujícího formátu, * volba pro rozdělení variant na samostatné produkty, * definice vlastního stromu kategorií. #### 2. Nastavení zpracování dat (mapování elementů) Klíčová část, která určuje, jak Mergado interpretuje jednotlivé části feedu. Zásadní elementy: * kořenový element (např. CHANNEL), * obalovací element produktů (např. ITEM), * identifikátor produktu (např. ITEM_ID) – element s unikátní hodnotou pro každou položku. Další možnosti: * přímé mapování na Mergado XML, * operace pro elementy bez podelementů (Propsat jak je, Skrýt, Význam elementu), * speciální operace pro obalovací elementy (např. DELIVERY, PARAM, VARIANT), * možnost namapovat libovolné množství elementů pro snadnější následnou práci v projektu. ## Porovnání zobrazení: Zjednodušený průchod vs. Podrobné nastavení |Kritérium|Zjednodušený průchod|Podrobné nastavení| | --- | --- | --- | |Rychlost práce|Rychlé základní nastavení|Delší, ale přesnější| |Úroveň kontroly|Omezená, vhodná pro jednoduché struktury|Úplná kontrola nad každým elementem| |Vhodné pro|Neznámé feedy se standardní logikou|Složité, upravené nebo hierarchické feedy| |Chytré mapování|Ano – automatické návrhy|Ano – automatické návrhy| |Možnost nastavení parametrů formátu|Omezená|Plná (název, stát, varianty, vlastní kategorie)| |Manipulace s podelementy|Základní|Detailní, včetně speciálních operací| |Přesnost výsledku|Dostatečná pro většinu běžných feedů|Nejvyšší možná přesnost převodu| ## Jaký postup zvolit * Použijte zjednodušený průchod, pokud potřebujete rychle založit projekt a feed má relativně přehlednou strukturu. * Zvolte podrobné nastavení, pokud pracujete s komplexním feedem, připravujete šablonu pro výstup nebo potřebujete přesně definovat význam jednotlivých elementů. # FAQ 1. Co je zjednodušený průchod při vytváření vlastního formátu? Zjednodušený průchod je variantou rozhraní ve 3. kroku průvodce, která nabízí pouze nejdůležitější elementy a rychlejší cestu k vytvoření funkčního mapování. Je navržen tak, aby uživatele nezahltil pokročilým nastavením a umožnil rychlý start i u neznámých feedů. Nabízí chytré mapování, které automaticky doporučí přiřazení elementů podle názvů a významu. 2. Kdy se zjednodušený průchod zobrazí? Zobrazí se výhradně při vytváření vlastního formátu na vstupu a jen tehdy, pokud Mergado nerozpozná strukturu feedu nebo uživatel zvolí definici vlastního formátu ručně. V těchto situacích je cílem urychlit základní nastavení tak, aby byl projekt co nejdříve připraven k práci. Podrobné nastavení lze vyvolat kdykoli. 3. Jak funguje chytré mapování v rámci zjednodušeného průchodu? Chytré mapování se pokusí automaticky přiřadit elementy podle jejich názvu a typického významu. Uživatel pouze zkontroluje navržené hodnoty a případně ručně upraví, jaký element má být spojen s ekvivalentem v Mergado XML. Tento krok výrazně urychluje práci zejména u běžných nebo jednodušších struktur feedů. 4. Kdy je vhodné použít zjednodušený průchod? Zjednodušený průchod je ideální, pokud potřebujete rychle začít pracovat s daty a feed má poměrně standardní strukturu. Vhodný je také tehdy, když jde o jednorázové zpracování nebo když nechcete hned na začátku řešit detailní nastavení. Pokud feed neobsahuje složitou hierarchii, často postačí právě tato varianta. 5. Co je podrobné nastavení vlastního formátu? Podrobné nastavení je plná varianta tvorby vlastního formátu, která umožňuje mapovat jednotlivé elementy i jejich podelementy s maximální přesností. Obsahuje také všechny parametry formátu, jako je stát, název nebo rozdělování variant, a umožňuje definovat chování složitějších struktur. Tento přístup je určen pro feedy s více úrovněmi nebo připravované výstupní formáty. 6. Kdy je vhodné použít podrobné nastavení? Podrobné nastavení je nejlepší volba tehdy, když feed obsahuje složitou, nestandardní nebo víceúrovňovou strukturu. Stejně tak je vhodné, pokud potřebujete úplně přesně kontrolovat, jak se budou data v projektu zpracovávat a exportovat. Je nezbytné také při přípravě formátu, který se bude používat opakovaně nebo na výstupu. 7. Jaké elementy je nutné namapovat v obou případech? Ať už použijete zjednodušený průchod, nebo podrobné nastavení, musíte vždy určit kořenový element (CHANNEL) (platí pro XML feedy), obalovací element produktu (ITEM) (platí pro XML feedy), a alespoň jeden identifikátor produktu (nejčastěji ITEM_ID). Tyto elementy jsou klíčem k tomu, aby Mergado dokázalo datový feed správně načíst a identifikovat jednotlivé položky. Mapa ostatních elementů závisí na tom, co budete v projektu potřebovat. 8. Co nabízí podrobné nastavení navíc oproti zjednodušenému? Podrobné nastavení umožňuje definovat význam každého elementu a nastavovat speciální operace u elementů s podelementy, například u parametrů, dopravy nebo variant. Navíc obsahuje všechny parametry formátu a nabízí možnost převzít strukturu z existujícího CF. Poskytuje tedy nejvyšší možnou přesnost převodu dat. 9. Jaký postup zvolit – zjednodušený nebo podrobný? Zjednodušený průchod zvolte tehdy, když jde o rychlé vytvoření projektu a feed má jednoduchou a čitelnou strukturu. Podrobné nastavení použijte v případě, že plánujete s daty pracovat dlouhodobě, nebo pokud je feed složitý a vyžaduje přesné mapování. Volba postupu závisí především na složitosti dat a na tom, zda je pro vás důležitější rychlost, nebo přesnost. 10. Může zjednodušený průchod nahradit podrobné nastavení? Ano, v mnoha jednodušších případech postačí. Pokud ale feed obsahuje varianty, parametry, vícestupňovou strukturu nebo plánujete další exporty, bude podrobné nastavení ve výsledku přesnější a stabilnější. Doporučuje se tedy začít zjednodušeným přístupem a přejít na detailní režim, pokud zjistíte, že je potřeba více kontroly. --- # 4. Tvorba vlastního formátu – Detailní nastavení Detailní nastavení vlastního formátu je krok, ve kterém Mergadu přesně určíte, jak má interpretovat strukturu vašeho feedu. Na základě těchto informací vzniká převodník mezi vaším datovým formátem a Mergado XML. Tato fáze následuje po analýze struktury zdrojového souboru. ## Analýza struktury feedu Při vytváření vlastního formátu Mergado nejprve načte a analyzuje připojený soubor. Z jeho struktury určí, které elementy je možné mapovat, a vytvoří jejich přehled. ### Co analýza dělá * načte strukturu XML nebo CSV ze zadané URL, * identifikuje dostupné elementy i jejich strukturu, * připraví seznam elementů, které lze namapovat na Mergado XML. ### Aktualizace struktury Pokud se později ve vstupním souboru objeví nový element, je nutné jej do nastavení vlastního formátu doplnit. Slouží k tomu volba „Aktualizovat strukturu ze souboru“, která načte nové prvky a umožní u nich určit, jak se mají do Mergada propsat. ## Nastavení základních parametrů vlastního formátu V této části určíte obecné parametry formátu. Tyto volby se netýkají jednotlivých elementů, ale chování formátu jako celku. ### Dostupné parametry |Parametr|Popis| | --- | --- | |Název formátu|Umožňuje pojmenovat formát tak, aby byl snadno dohledatelný. Doporučujeme dobře identifikovatelný název.| |Stát|Ovlivňuje měnovou konfiguraci.| |Předvyplnit dle|Načtení nastavení z již existujícího vlastního formátu. Tato možnost se zobrazuje pouze v případech, kdy už máte vytvořený vlastní formát. Při první nastavení je skrytá.| |Rozdělovat varianty|Každá varianta (např. barva, velikost) se v Mergadu zpracuje jako samostatný produkt.| |Vlastní strom kategorií|Aktivuje možnost pracovat s vlastním stromem kategorií a našeptáváním kategorií (při použití formátu na výstupu).| ## Mapování elementů (Nastavení zpracování dat) Tato část určuje, jak bude Mergado interpretovat elementy vašeho feedu. Mapování definuje vztah mezi konkrétním elementem a jeho ekvivalentem v Mergado XML. ### Povinné elementy (platí pouze pro XML) Pro funkční zpracování feedu je nutné namapovat alespoň tyto dva prvky: * CHANNEL – kořenový obal celého feedu, * ITEM – obalovací element jedné položky. Bez těchto dvou elementů nelze XML feed importovat. ### Doporučené elementy Mergado umožňuje mapovat libovolné množství dalších elementů. Čím více prvků namapujete, tím méně práce budete mít později s pravidly a tím lépe lze feed převádět na jiné výstupní formáty. ### Operace pro jednoduché elementy U elementů, které nemají podelementy, lze použít tři typy operací: |Operace|Význam| | --- | --- | |Propsat jak je|Element se importuje a exportuje tak jak je, pokud ho pravidlo Převodník nebo uživatel nenastaví jako skrytý.| |Skrýt|Element se importuje a nastaví se jako skrytý, lze s ním pracovat v rámci pravidel, nebo ho případně ručně odkrýt.| |Význam elementu|Přiřazení elementu k ekvivalentu Mergado XML. Element se importuje, nastaví se jako skrytý a pravidlo Převodník jeho hodnoty převede do ekvivalentního elementu na výstupu.| ### Operace pro obalovací elementy U elementů, které mají v sobě další strukturu, lze zvolit speciální operace, které zpřístupní nastavení pro jejich podelementy. Příklady: * DELIVERY – nastavíte cenu dopravy, název či kód dopravce, * PARAM – definice parametrů produktu, * VARIANT – práce s jednotlivými variantami položky. ### Dopady mapování * Rozsáhlejší mapování usnadní následný export do jiných formátů. * Minimální mapování vyžaduje více práce v pravidlech (kopírování a doplňování hodnot). * Elementy umístěné mimo ITEM nelze zpracovat – Mergado je ignoruje. # FAQ 1. Co znamená analýza struktury feedu při tvorbě vlastního formátu? Analýza je první krok, ve kterém Mergado načte soubor z URL a identifikuje všechny dostupné elementy. Z jejich hierarchie sestaví strukturu, kterou následně nabídne k mapování. Tento proces určuje, s čím lze ve vlastním formátu pracovat. 2. Co mám dělat, když se ve vstupním feedu objeví nový element? Je potřeba otevřít definici uloženého vlastního formátu a použít volbu „Aktualizovat strukturu ze souboru“. Tím se načte nový element do seznamu a vy můžete určit, jak se má v Mergadu zpracovat. Po uložení a přegenerování dat je nový element součástí projektu. 3. K čemu slouží základní nastavení vlastního formátu? Tyto parametry určují chování formátu jako celku a neřeší jednotlivé elementy. Patří sem název formátu, nastavení státu, volba pro práci s variantami nebo aktivace vlastního stromu kategorií. Správné nastavení parametrů zjednoduší jeho budoucí použití v dalších projektech. 4. Proč je důležité správně pojmenovat vlastní formát? Název formátu se zobrazuje v seznamu formátů a usnadňuje orientaci zejména v případě, že jich máte více. Dobře zvolený název umožní rychle identifikovat, pro jaký typ feedu byl formát vytvořen. Předejdete tím chybám při opakovaném použití. 5. Jak funguje volba „Předvyplnit dle“? Tato možnost zpřístupní existující vlastní formáty a umožní převzít jejich strukturu. Hodí se, pokud potřebujete vytvořit podobný formát nebo pracujete s feedy se stejným schématem. Díky tomu nemusíte vše mapovat od začátku. 6. Co znamenají operace „Propsat jak je“, „Skrýt“ a „Význam elementu“? * „Propsat jak je“ - Element se importuje a exportuje beze změn, pokud ho pravidlo Převodník nebo uživatel nenastaví jako skrytý. * „Skrýt“ zajistí, že se Element importuje a nastaví se jako skrytý. Lze s ním pracovat v rámci pravidel, vytváření výběrů, nebo ho případně ručně odkrýt. * „Význam elementu“ slouží k mapování elementu na ekvivalent v Mergado XML 7. Kdy se vyplatí mapovat i další elementy mimo povinných? Pokud plánujete export do jiných formátů nebo budete pracovat s daty v pravidlech, je detailní mapování výrazně přínosné. Méně namapovaných elementů znamená více práce při doplňování hodnot v projektu. Čím přesnější mapování, tím jednodušší další zpracování. 8. Jak fungují speciální operace pro obalovací elementy? Používají se tehdy, když má element vlastní vnořenou strukturu, například parametry, dopravu nebo varianty. Výběrem speciální operace zpřístupníte nastavení pro jejich podelementy. To umožňuje detailně definovat, jak mají být hodnoty těchto struktur zpracovány. 9. Proč Mergado ignoruje elementy mimo ITEM? Vlastní formát umí pracovat jen s částí XML, kterou tvoří jednotlivé položky produktu. Elementy nad ITEM, například informace mezi CHANNEL a ITEM, nejsou součástí modelu produktových dat. Proto se při importu ignorují a projekt nad nimi nemá kontrolu. 10. Jak poznám, že je mapování dostatečné? Pokud dokážete načíst feed, pracovat s daty bez nutnosti rozsáhlých pravidel a export je bez ztrát informací, je mapování nastaveno správně. Kritickým bodem je zachycení všech elementů, které budete později upravovat nebo exportovat. Pokud musíte často doplňovat hodnoty pravidly, mapování je pravděpodobně příliš stručné. 11. Jaký je vztah mezi mapováním a převodníkem? Mapování určujete vy a právě podle něj převodník převádí data do Mergado XML. Pokud nějaký element nenamapujete, převodník o něm „neví“ a nepracuje s ním. Dobré mapování tedy určuje kvalitu celého převedeného feedu. --- # 5. Vlastní formát na vstupu Vlastní formát na vstupu slouží k načtení datových feedů, které Mergado nerozpozná, a k jejich převodu do interní struktury Mergado XML. Díky tomu lze v Mergadu zpracovat téměř libovolný XML nebo CSV soubor. ## Kdy se používá vlastní formát na vstupu Potřeba definovat vlastní formát vzniká tehdy, když systém nedokáže určit strukturu vstupního feedu a zobrazí informaci, že formát není známý. V takové situaci nabídne vytvoření vlastního formátu. ### Typické scénáře * Dodavatelské feedy nebo jinak strukturované XML/CSV, * Custom feedy vytvořené na míru. Typicky u větších e-shopů. * Zastaralé nebo výrazně upravené varianty známých formátů, * Doplňkové feedy, například skladové nebo servisní, * Feedy poskytující jiné typy služeb (recenze, cestovní nabídky). * atd. ## Postup vytvoření vlastního formátu při importu feedu Definice vlastního formátu probíhá ve 3. kroku průvodce zakládáním projektu. ### Postup 1. Vytvořte nový projekt a vložte URL vstupního feedu. 2. Pokud Mergado strukturu nerozpozná, zvolte Definovat vlastní formát. 3. Namapujte povinné elementy: * CHANNEL, * ITEM. 4. Namapujte další elementy, se kterými budete v projektu pracovat (URL, NAME, ITEM_ID, …). 5. Formát pojmenujte a uložte. 6. Ve 4. kroku můžete * ponechat stejný vlastní formát i na výstup, struktura feedu se tak nebude měnit * vybrat pomocí selectboxu jiný oficiální formát, např. Google, Meta aj. * nebo vytvořit nový vlastní formát pro výstup 7. V posledním kroku zkontrolujte, zda jsou vybrané párovací elementy. Pokud ne, je nutné je nastavit. ## Nastavení párovacího elementu Párovací element je klíčovým údajem, který Mergado používá pro jednoznačnou identifikaci každé položky v projektu. ### Co je důležité * musí mít unikátní hodnotu pro každý produkt, * nejčastěji se používá element s ID produktů nebo jiný jednoznačný identifikátor (URL, EAN,..), * v rekapitulaci kroků je nutné zkontrolovat, že je párovací element správně vybraný. Metafora: Párovací element funguje jako rodné číslo pro každou položku. Umožňuje Mergadu bezpečně sledovat a zpracovávat jednotlivé produkty bez ohledu na to, jak se jejich hodnoty v průběhu práce mění. ## Kolik elementů mapovat ### Minimum – pro funkcionalitu Pro import postačí namapovat pouze povinné elementy (CHANNEL, ITEM a případně ITEM_ID). ### Maximum – pro efektivitu Namapovat více elementů znamená jednodušší práci v dalších krocích projektu. Výhody detailního mapování: * méně potřebných pravidel pro kopírování hodnot, * rychlejší převod do jiných výstupních formátů, * lepší čitelnost a stabilita projektu. Příklad dopadu: Pokud nenamapujete element s názvem produktu, musíte ho později do formátu doplnit pravidlem. Pokud jej namapujete už při definici CF, Mergado ho pak správně automaticky převede do výstupního feedu. Aktualizace struktury při změnách feedu Pokud se u vstupního feedu objeví nové elementy, uložený vlastní formát je automaticky nepřevezme. Je potřeba: 1. otevřít daný vlastní formát, 2. kliknout na Aktualizovat strukturu ze souboru, 3. nově nalezeným elementům přiřadit způsob zpracování, 4. uložit a projekty s tímto vlastním formátem přegenerovat. Tím zaručíte konzistentní zpracování feedu i po jeho změnách. # FAQ 1. Kdy je potřeba použít vlastní formát na vstupu? Vlastní formát použijete tehdy, když Mergado nedokáže rozpoznat strukturu vstupního feedu a zobrazí informaci, že formát není známý. Typicky jde o dodavatelské, custom, zastaralé nebo výrazně upravené feedy. V těchto situacích je nutné Mergadu vysvětlit strukturu dat, aby je dokázal zpracovat. 2. Jaké typy feedů nejčastěji vyžadují vlastní formát na vstupu? Nejčastěji jde o dodavatelské a custom feedy, které nemají veřejnou specifikaci nebo se liší od standardů. Patří sem také doplňkové feedy, například skladové, servisní nebo feedy obsahující služby jako recenze či cestovní nabídky. Vlastní formát se používá i u upravených či zastaralých verzí jinak známých formátů. 3. Jak probíhá vytvoření vlastního formátu při importu? Vytvoření probíhá ve 3. kroku průvodce založením projektu, kde zvolíte možnost „Definovat vlastní formát“. Následně namapujete povinné elementy CHANNEL a ITEM (u XML feedů) a další položky, se kterými budete v projektu pracovat. Na závěr formát uložíte. 4. Co je párovací element a proč je tak důležitý? Párovací element je údaj, který umožňuje Mergadu jednoznačně identifikovat každou položku. Musí mít unikátní hodnotu pro každý produkt – nejčastěji jde o ITEM_ID, URL nebo EAN. Bez správně nastaveného párovacího elementu nelze feed importovat správně ani správně párovat změny. 5. Kolik elementů je vhodné při definici vlastního formátu namapovat? Pro základní funkčnost stačí namapovat CHANNEL, ITEM (u XML feedů) a jeden unikátní identifikátor. Pokud ale chcete minimalizovat pozdější práci, je vhodné namapovat i další elementy, protože to zjednoduší práci s pravidly a usnadní převod na jiné výstupní formáty. Detailní mapování zvyšuje stabilitu a přehlednost projektu. 6. Co se stane, když nenamapujete některé důležité elementy? Nenamapované elementy se v projektu sice objeví, ale Mergado je nebude umět správně využít a bude je potřeba doplňovat ručně pomocí pravidel. To vede k vyšší pracnosti a může způsobit chyby při exportu. Přesné mapování proto výrazně usnadní pozdější práci. 7. Jak postupovat, když se ve vstupním feedu objeví nová datová pole? Je nutné otevřít definici vlastního formátu a použít volbu „Aktualizovat strukturu ze souboru“. Mergado načte nové elementy a vy jim přiřadíte způsob zpracování. Poté projekt přegenerujete, aby se změny projevily. 8. Může se vlastní formát použít i tehdy, když Mergado formát pozná? Ano, v některých případech může být výhodné vytvořit vlastní formát i u rozpoznaného feedu, například pokud chcete zachovat původní strukturu nebo potřebujete pracovat s prvky, které standardní převodník nebere v úvahu. V takovém případě jednoduše zvolíte možnost „Vybrat jiný formát“ a následně definujete vlastní. 9. Co dělat, pokud si nejsem jistý, zda je vlastní formát nastaven správně? Doporučuje se zkontrolovat načtené elementy, párovací element a strukturu výstupního feedu projektu. Pokud vidíte všechny hodnoty, se kterými potřebujete pracovat, a data se správně párují, je formát v pořádku. Pokud narazíte na potíže, je lepší se vrátit do mapování nebo kontaktovat podporu. --- # 6. Použití vlastního formátu na výstupu Vlastní formát na výstupu slouží k tomu, aby Mergado dokázalo generovat produktový feed v takové struktuře, kterou standardně nepodporuje. Vhodný je všude tam, kde potřebujete mít výstupní soubor přesně podle specifických požadavků platformy, systému nebo interních procesů. ## Kdy se výstupní vlastní formát používá Výstupní vlastní formát využijete především v situacích, kdy: * potřebujete feed pro platformu, která není v Mergadu integrována, * vytváříte napojení na nový e-commerce kanál, * pracujete s menšími srovnávači nebo interními systémy s vlastní strukturou dat, * je nutné docílit konkrétní struktury kořenových elementů (např. …). Výstupní vlastní formát umožňuje definovat podobu výsledného feedu tak, aby přesně odpovídala požadovanému formátu. ## Co je vzorový feed a proč je potřebný Výstupní vlastní formát se vytváří na základě vzorového feedu – což je vzorový XML nebo CSV soubor obsahující alespoň jednu položku. ### Proč je vzorový feed důležitý * Slouží jako šablona, podle které se Mergado naučí, jak má finální feed vypadat. * Definuje kořenové elementy, které chcete mít v cílové struktuře. * Může být zcela fiktivní – postačí jediná fiktivní položka, na jejichž hodnotách nezáleží. ### Požadavky na vzorový feed * musí být dostupný pod URL adresou, * musí obsahovat kořenovou strukturu, kterou chcete na výstupu, * může mít minimální obsah, například: `` `` `` `1` `` `` ## Jak vytvořit vzorový feed Existují dva způsoby: ### 1. Ruční vytvoření souboru * připravíte XML v textovém editoru, nebo CSV v tabulkovém editoru * uložíte jej na server, * zpřístupníte pod URL adresou. ### 2. Pomocí doplňku Mergado Files * aktivujete rozšíření Mergado Files, * vytvoříte nový soubor, * vložíte ukázkovou položku, kterou získáte například od srovnávačů * uložíte jej jako XML nebo CSV, * získáte URL, kterou použijete při definici formátu. Mergado Files je ideální, pokud potřebujete vzorový feed rychle upravovat nebo testovat. ## Postup vytvoření vlastního formátu na výstupu Vlastní formát na výstup se vytváří buď dopředu v sekci Vlastní formáty v levém menu na úrovni uživatele, nebo přímo během vytváření nového projektu ve 4. kroku wizardu. ### Postup 1. Otevřete Vlastní formáty a klikněte na Nový vlastní formát. 2. Do pole „Zdrojový soubor“ vložte URL vzorového feedu. 3. Formát pojmenujte. 4. Namapujte elementy: * minimem je nastavení kořenových obalovacích elementů (CHANNEL, ITEM), * doporučuje se namapovat všechny elementy, které budete generovat ve výstupu. 5. Uložte formát. Po uložení se vlastní formát stává opakovaně použitelným. V každém projektu jej lze vybrat jako výstupní (i jako vstupní) formát. ## Jak Mergado generuje výstupní feed podle vlastní šablony Výstupní vlastní formát určuje finální strukturu feedu. Mergado při generování výstupu: * použije kořenové elementy přesně tak, jak byly uvedeny ve vzorovém feedu, * využije definované mapování pro převod hodnot z vašeho vstupního feedu do výsledného formátu, * zachová pořadí a strukturu elementů podle šablony. Díky tomu lze rychle vytvořit libovolný XML nebo CSV feed bez nutnosti vývoje nové integrace ze strany Mergada. ## Efektivita mapování Ačkoliv pro výstupní feed stačí namapovat minimum, výhodnější je definovat mapování co nejpodrobněji: * získáte lepší kontrolu nad výsledkem, * snížíte potřebu pravidel pro doplňování hodnot, * umožníte snazší opakované použití formátu v dalších projektech. # FAQ 1. Kdy má smysl použít vlastní formát na výstupu? Vlastní formát na výstupu použijete vždy, když potřebujete feed ve struktuře, kterou Mergado standardně nenabízí. Typicky jde o napojení na novou platformu, menší srovnávač nebo interní systém s vlastní strukturou. Umožňuje vám přesně řídit podobu výstupního XML nebo CSV, včetně kořenových elementů. 2. Co je vzorový (example) feed a k čemu slouží? Vzorový feed je ukázkový XML nebo CSV soubor, který obsahuje alespoň jednu položku a odpovídá cílové struktuře, kterou chcete generovat. Mergado podle něj načte kořenové elementy, vnitřní strukturu a pořadí elementů. Slouží jako šablona, podle které se výstupní feed následně generuje. 3. Musí být vzorový feed reálný, nebo může být fiktivní? Vzorový feed může být zcela fiktivní – stačí jedna položka s minimem hodnot. Důležité je, aby měl správnou strukturu elementů, ne konkrétní data. Hodnoty jako ID, název nebo cena jsou v tomto kontextu pouze ukázkové. 4. Proč musí být vzorový feed dostupný na URL adrese? Mergado načítá strukturu přímo z URL, aby ji mohlo při analýze použít jako zdroj pro definici formátu. Nahrání souboru bez URL není možné. Pokud nemáte vlastní hosting, můžete použít cloudové služby nebo doplněk Mergado Files. 5. Jakým způsobem mohu vzorový feed vytvořit? Buď si připravíte XML nebo CSV v textovém/tabulkovém editoru a uložíte jej na server s veřejnou URL, nebo použijete rozšíření Mergado Files. V Mergado Files vytvoříte nový soubor, vložíte ukázkovou položku, uložíte jej ve správném formátu a získáte URL pro použití ve vlastním formátu. Druhá možnost je vhodná, pokud potřebujete vzorový feed průběžně upravovat. 6. Jak probíhá vytvoření vlastního formátu na výstupu? V sekci Vlastní formáty zvolíte „Nový vlastní formát“ a jako zdrojový soubor zadáte URL vzorového feedu. Po analýze souboru formát pojmenujete a namapujete potřebné elementy, minimálně CHANNEL a ITEM. Uložený formát pak můžete vybrat jako výstupní formát v libovolném projektu. Alternativně můžete vlastní formát vytvořit přímo během vytváření nového projektu ve 4. kroku wizardu kliknutím na Definovat vlastní formát a vložem URL vzorového feedu. Po uložení vlastního formátu se vrátíte zpět do wizardu kde bude vytvořený vlastní formát vyplněn jako výstupní formát. 7. Jak Mergado použije vlastní formát při generování výstupního feedu? Při exportu Mergado vychází ze šablony načtené ze vzorového feedu, zachová jeho kořenové elementy i strukturu. Pomocí mapování převede hodnoty z Mergado XML do správných elementů ve výstupu. Výsledkem je feed v podobě, která odpovídá vašim požadavkům bez nutnosti vlastního programování. 8. Co se stane, pokud ve výstupním formátu namapuji jen minimum elementů? Mergado sice vytvoří výstupní feed se správnou strukturou, ale elementy nebudou naplněny daty. Hodnoty nenamapovaných elementů bude nutné doplnit pravidly nebo dalším nastavením v projektu. Takový postup je funkční, ale méně efektivní při dlouhodobém používání. 9. Proč je vhodné mapovat co nejvíce elementů i na výstupu? Detailní mapování vám dává lepší kontrolu nad tím, jak se data do výstupu zapisují, a snižuje množství pravidel, která musíte v projektu vytvářet. Zároveň zjednodušuje opakované použití stejného formátu v dalších projektech. Vyplatí se zejména v situacích, kdy formát slouží více klientům nebo více e-shopům. 10. Lze výstupní vlastní formát použít i jako vstupní? Ano, jakmile je formát jednou vytvořen, je k dispozici v seznamu formátů pro vstup i výstup. To může být užitečné například při transformacích mezi různými interními systémy nebo při kontrole dat. --- # 7. Práce se složitějšími XML strukturami Tato sekce popisuje situace, kdy datový feed obsahuje prvky umístěné mimo obvyklou strukturu produktů, tedy mimo element ITEM. U těchto feedů naráží vlastní formát na určitá omezení a je nutné použít alternativní postupy. ## Omezení vlastního formátu při importu Vlastní formát dokáže pracovat pouze s elementy umístěnými uvnitř zvoleného obalovacího elementu položky (ITEM). Prvky, které se v hierarchii nacházejí nad ním nebo mimo něj, Mergado Editor ignoruje. ### Informace mezi CHANNEL a ITEM * Některé XML feedy obsahují další úroveň dat mezi CHANNEL a ITEM (např. kategorie, doprava, metadata). * Tyto elementy nejsou součástí samotné položky, a proto nejsou při importu načteny. ### Typické příklady problémových feedů * XML feedy s globálními informacemi o kategoriích uloženými mimo produkty, * datové zdroje, kde jsou informace o dopravě definovány na úrovni CHANNEL, * komplexní feedy s vícestupňovou strukturou mezi kořenovým elementem a jednotlivými položkami. ## Řešení: dvouprojektový model + Blending Bull Pokud je potřeba zachovat celou strukturu XML feedu, včetně prvků mimo ITEM, lze použít dvoustupňový postup: 1. První projekt – obsahuje produkty. 2. Druhý projekt – obsahuje doplňkové informace, které nejsou součástí ITEM. 3. Sloučení – výstupní data obou projektů se spojí pomocí rozšíření Blending Bull. ### Jak dvouprojektový model funguje |Krok|Projekt s produkty|Projekt se specifikacemi| | --- | --- | --- | |Definice CF|Namapujte CHANNEL a obalovací element produktů (ITEM).|CHANNEL ponechte stejný. U ITEM zvolte obal, který obsahuje doplňkové informace.| |Párovací element|Zvolte element s unikátní hodnotou pro každý produkt.|Zvolte identifikátor, který je u položek unikátní.| |Vstup|Použije se původní feed.|Použije se stejný vstupní feed.| ### Sloučení pomocí Blending Bull 1. Aktivujte rozšíření Blending Bull. 2. V části Datové zdroje vyberte výstupy obou projektů. 3. V sekci Soubory vytvořte nový výstupní soubor a následně vyberte vytvořené datové zdroje z předchozího kroku. 4. Dle potřeby doplňte úpravy pomocí pravidel. ### Proč tento postup funguje Každý projekt načte pouze tu část struktury, se kterou Mergado umí pracovat. Blending Bull následně umožní obě části znovu spojit a získat kompletní datový výstup. ## Editace kořenových elementů na výstupu Kořenové elementy výstupního feedu nelze v Mergadu přímo upravit. Pokud potřebujete jinou strukturu obalových elementů, existují dvě alternativy: úprava přes Blending Bull, nebo vytvoření vlastní šablony. ### Úpravy přes Blending Bull Blending Bull umožňuje pracovat s výstupním feedem jako s textovým souborem. Díky tomu lze upravovat: * kořenové elementy, * záhlaví, * patičku, * názvy elementů. ### Pravidla typu „Najít a nahradit“ Pomocí pravidel v Blending Bullu lze provést hromadné změny názvů elementů. Například: * SHOP → PRODUCTS, SHOPITEM → PRODUCT. Tím lze snadno upravit výstupní strukturu bez nutnosti zásahu do projektu samotného. ## Alternativy k Blending Bullu (pro kontrolu výstupní struktury) Existují dva další způsoby, jak ovlivnit strukturu výstupu: ### 1. Vytvoření šablony pomocí vlastního formátu * Použijete fiktivní nebo existující feed s požadovanými kořenovými elementy. * Tento feed použijete při tvorbě vlastního formátu na výstup. * Mergado poté zachová kořenové elementy přesně tak, jak byly v example feedu. ### 2. Požádání o přidání nového integrovaného formátu * Pokud máte specifikaci cílového formátu, lze kontaktovat podporu Mergada. * Formát může být přidán mezi oficiálně podporované integrace. * Následně jej lze vybrat jako běžný výstupní formát. * Přidání nového formátu ale musí projít prioritizačním procesem a může trvat déle. # FAQ 1. Proč Mergado ignoruje některé elementy ve vstupním XML feedu? Vlastní formát dokáže pracovat pouze s elementy, které jsou umístěny uvnitř obalovacího elementu položky (ITEM). Vše, co je mimo něj – například elementy mezi CHANNEL a ITEM – se při importu nezpracuje. Tyto informace nejsou součástí produktových dat, a proto je Editor nevidí. 2. Jak poznám, že je feed problémový a vyžaduje speciální postup? Nejjednodušší postup je otevřit si výstupní feed a provnat to se vstupním feedem. Typické příklady jsou feedy, kde jsou kategorie, doprava nebo další metadata umístěny na úrovni CHANNEL nebo v několika vrstvách nad ITEM. Pokud po importu některé důležité údaje chybí, je to známka toho, že se nacházejí mimo strukturu, kterou Mergado umí načíst. V takových situacích je nutné použít alternativní postup. 3. Co je dvouprojektový model a kdy ho použít? Dvouprojektový model se používá, když potřebujete zachovat nebo zpracovat části XML feedu, které nepatří pod ITEM. Jeden projekt načte produkty a druhý načte doplňkové informace. Následně se oba výstupy spojí pomocí rozšíření Blending Bull. 4. Jak dvouprojektový model prakticky funguje? V projektu s produkty namapujete CHANNEL a ITEM představující jednotlivé položky. V projektu se specifikacemi ponecháte stejný CHANNEL, ale jako ITEM zvolíte obalový element doplňkových informací. Oba projekty načítají stejný vstupní feed a Blending Bull je následně spojí do jednoho výstupu. 5. Proč je Blending Bull nezbytný pro sloučení složitých struktur? Mergado samo o sobě nedokáže zkombinovat data ze dvou různých projektů s různými objekty (produkty). Blending Bull vytvoří výstupní soubor, do kterého můžete přidat oba výstupy a případně je ještě upravit pomocí pravidel. Díky tomu získáte kompletní datovou strukturu, která odpovídá původnímu feedu. 6. K čemu slouží pravidla typu „Najít a nahradit“ v Blending Bullu? Pomocí těchto pravidel lze hromadně měnit názvy elementů, kořenové tagy nebo části záhlaví a patičky. Je to řešení pro případy, kdy potřebujete upravit výstupní feed tak, aby odpovídal specifickému formátu. I tímto způsobem můžete například přejmenovat SHOP na PRODUCTS nebo jiné klíčové elementy. 7. Lze v Mergadu přímo upravit kořenové elementy výstupního feedu? Ne, kořenové elementy nelze ve standardním rozhraní přímo editovat. Lze je ovlivnit buď tak, že vytvoříte vlastní formát na základě vzorového feedu, nebo pomocí úprav v Blending Bullu. Oba postupy zajistí správnou podobu výstupní struktury. 8. Kdy má smysl vytvořit vlastní šablonu pomocí výstupního vlastního formátu? Pokud máte jasně danou strukturu výstupního XML, například specifikaci partnera nebo vlastního systému, je výstupní vlastní formát nejčistším řešením. Definicí formátu podle vzorového feedu zajistíte, že Mergado vždy vygeneruje data v požadovaném tvaru. Tento postup je nejstabilnější pro dlouhodobé použití. 9. Je možné požádat o přidání nového oficiálního formátu do Mergada? Ano, pokud máte dokumentaci a jasnou specifikaci cílového formátu, můžete požádat podporu o přidání mezi oficiální integrace. Tento proces ale podléhá prioritizaci a může trvat déle. Pokud potřebujete výsledek rychle, výstupní vlastní formát nebo Blending Bull je rychlejší cesta. 10. Jak poznám, že je nutné použít dvouprojektový model? Pokud po importu chybí informace, které se nacházejí mimo ITEM, nebo pokud feed obsahuje více úrovní nad produkty, je dvouprojektový model obvykle jediným způsobem, jak zachovat kompletní strukturu. Stejně tak je nutný tehdy, pokud potřebujete kombinovat produktová data s globálními informacemi uloženými mimo samotné položky. --- # 8. Vysvětlení pojmů ### Mergado XML jako univerzální jazyk * Mergado XML funguje jako univerzální meziformát, přes který Mergado převádí všechna produktová data. Není nutné mít pro každý vstupní a výstupní formát samostatný převodník – stačí jedna společná struktura, do které se data přeloží. ### Vlastní formát jako slovník a gramatická pravidla * Vlastní formát určuje, jak jednotlivé elementy vašeho feedu „přeložit“ do Mergado XML. Jedná se o sadu pravidel, která umožní Mergadu rozpoznat strukturu téměř jakéhokoli feedu. ### Vzorový feed jako cílový jazyk * Při tvorbě výstupního formátu slouží vzorový feed jako definice toho, jak má výsledná struktura vypadat. Mergado z něj načte: * kořenovou strukturu, * názvy elementů, * organizaci položek. Tím získáte výstupní feed přesně podle vlastní specifikace. ### Příklady převodů * Import (dodavatelský feed → formát e-shopu) * Mergado připraví strukturu tak, aby byla kompatibilní s formátem e-shopu, včetně cen, dostupností nebo parametrů. * Export (interní data → Heureka, Google, vlastní platformy) * Pokud platforma nenabízí přímý export, lze pomocí vlastního formátu vytvořit výstup, který splní požadovanou specifikaci. --- ## [Produkty a produktové výběry](https://help.mergado.com/cs/mergado-editor/prace-s-daty/zakladni-prvky/produkty-a-produktove-vybery/) # Produkty a produktové výběry # 🧭 Produkty a produktové výběry v Mergadu # **1\. Produkty v Mergadu** ## **Co je produkt v Mergadu** Produkt v Mergadu je **základní datová jednotka**, která představuje položku zboží z e-shopu. Každý produkt obsahuje různé **elementy**, jež popisují jeho vlastnosti – například název, cenu nebo EAN. Mergado s těmito produkty pracuje, upravuje je a optimalizuje před exportem do inzertních kanálů. * Produkty jsou tvořeny **elementy**, které definují jejich vlastnosti (např. `PRODUCTNAME`, `PRICE`, `EAN`). * **Feed** je soubor, který obsahuje všechny produkty a jejich elementy. ## **Vstupní a výstupní data** Celý proces práce s produkty v Mergadu je založen na transformaci mezi dvěma základními datovými sadami – **vstupním** a **výstupním feedem**. * **Vstupní feed (vstupní data)** – obsahuje původní data, která Mergado stahuje z e-shopu a dále zpracovává. Při vyhledávání produktů se doporučuje hledat právě na vstupu, protože hodnoty vstupního feedu se nemění aplikováním pravidel (pokud tak neupraví poskytovatel feedu). * **Výstupní feed (upravená data)** – obsahuje data po provedených úpravách v Mergado Editoru. Tato data se exportují do cílových marketingových kanálů (např. Heureka, Google Ads). Mergado umožňuje při kontrole dat zobrazit hodnoty pouze ze **vstupního feedu**, pouze z **výstupního feedu**, nebo **ze vstupu i výstupu současně**. ## **Načítání a zpracování produktových dat** Mergado funguje na principu **cyklického zpracování dat**, které probíhá ve čtyřech krocích: 1. **Import dat** – do Mergada se stáhnou data ze vstupního feedu. 2. **Aplikování pravidel** – většina změn a úprav se provádí hromadně prostřednictvím pravidel. 3. **Export** – po zpracování dat se vytvoří aktuální výstupní feed. 4. **Přístup k výstupnímu feedu** – Mergado zaznamenává, kdy si inzertní kanál (např. Heureka) upravený feed stáhl. Pokud se u konkrétního produktu objeví chyba (např. element obsahuje jinou než očekávanou hodnotu), lze použít funkci **„Sledování produktu při průchodu pravidly“**. Tato funkce zobrazí, které pravidlo produkt ovlivnilo a jaké změny se u něj provedly. ## **Rozdíl mezi produktem v e-shopu a v Mergadu** E-shop spravuje **primární produktová data**, zatímco Mergado je nástroj pro jejich **úpravu a optimalizaci** pro marketingové kanály. Původní data z e-shopu zůstávají beze změny – Mergado vytváří **upravenou verzi**, která odpovídá požadavkům jednotlivých platforem. * **E-shop** – spravuje zdrojová data používaná v rámci svého systému. * **Mergado** – upravuje a optimalizuje data pro inzerci na srovnávačích a marketplaces. ## **Praktické funkce pro práci s produkty** Na stránce *Produkty* nabízí Mergado několik způsobů, jak s daty pracovat – od **manuálních úprav** po **hromadné zpracování** pomocí pravidel. ### **Jednorázové úpravy** **Manuální úpravy** * Umožňují upravit hodnoty jednotlivých elementů přímo v rozhraní Mergada. Jsou vhodné zejména pro **drobné nebo jednorázové změny**. **WYSIWYG editor** * Pro textové elementy (např. `DESCRIPTION`) lze použít editor typu **„What You See Is What You Get“**, který umožňuje formátování popisků pomocí **HTML prvků**. Tímto způsobem lze přehledně upravit popisy produktů bez nutnosti psát HTML ručně. **Manuální skrývání produktů** * Užitečné při práci s menším počtem položek, které **nejsou vhodné pro inzerci** (např. produkty bez EANu nebo s dlouhou dobou dodání). ### **Hromadné úpravy** * Pro rozsáhlejší změny (úpravy hodnot, přepisování dat nebo skrývání většího množství produktů) slouží **pravidla**, která se aplikují na vybrané skupiny produktů. * Používání hromadných úprav pomocí pravidel je mnohem efektivnější než ruční úpravy jednotlivých produktů, a proto se ve většině případů **doporučuje tento způsob práce s daty**. ## **FAQ** **1\. Co je produkt v Mergadu?** Produkt v Mergadu je základní datová jednotka, která představuje položku zboží z e-shopu. Každý produkt je tvořen elementy (např. `PRODUCTNAME`, `PRICE`, `EAN`), které popisují jeho vlastnosti. Mergado s těmito produkty pracuje, upravuje je a připravuje pro export do inzertních kanálů. **2\. Co je to feed?** Feed je soubor, který obsahuje všechny produkty a jejich elementy. V Mergadu se rozlišuje vstupní feed (data z e-shopu) a výstupní feed (upravená data připravená pro export). **3\. Jaký je rozdíl mezi vstupním a výstupním feedem?** Vstupní feed obsahuje původní data stažená z e-shopu. Výstupní feed obsahuje data po provedených úpravách v Mergadu. Výstupní feed je exportován do marketingových kanálů, jako jsou Heureka nebo Google Ads. **4\. Můžu zobrazit současně hodnoty ze vstupního i výstupního feedu?** Ano. Mergado umožňuje zobrazit pouze vstupní hodnoty, pouze výstupní hodnoty, nebo obojí současně. Tato možnost pomáhá snadno porovnat, jaká data se v průběhu zpracování změnila. **5\. Jak Mergado zpracovává produktová data?** Mergado pracuje cyklicky ve třech krocích: 1. Importuje data ze vstupního feedu. 2. Aplikuje pravidla a úpravy. 3. Vygeneruje výstupní feed. Dále zaznamená, kdy si inzertní kanál (např. Heureka) upravený feed stáhl. **6\. Co dělat, když se produkt chová jinak, než očekávám?** Pokud má produkt nečekanou hodnotu elementu nebo se například zobrazuje ve výstupu, i když měl být skryt, použijte funkci **„Sledování produktu při průchodu pravidly“**. Ta zobrazí, která pravidla produkt ovlivnila a jaké změny u něj provedla. **7\. Jaký je rozdíl mezi produktem v e-shopu a v Mergadu?** E-shop spravuje původní produktová data, zatímco Mergado tato data upravuje a optimalizuje pro marketingové kanály. Původní data zůstávají beze změny, Mergado pouze vytváří jejich upravenou verzi. **8\. Jaké jsou možnosti úprav produktových dat?** Mergado nabízí dva základní způsoby: * **Manuální úpravy** – přímá editace hodnot u jednotlivých produktů (vhodné pro drobné změny). * **Hromadné úpravy** – pomocí pravidel aplikovaných na celé výběry produktů (doporučený způsob). **9\. Kdy je vhodné použít ruční úpravu a kdy pravidla?** Ruční úpravy se hodí pro menší počet produktů nebo jednorázové změny. Pravidla jsou efektivnější při práci s většími objemy dat nebo opakovanými úpravami, protože umožňují automatizaci. **10\. K čemu slouží WYSIWYG editor?** WYSIWYG editor (What You See Is What You Get) slouží k úpravě textových elementů, jako jsou popisky produktů. Umožňuje přehledně formátovat text (např. tučnost, kurzíva) pomocí HTML značek bez nutnosti psát kód ručně. **11\. Jak mohu skrýt produkt z výstupního feedu?** Pro menší počet produktů můžete využít **manuální skrývání** přímo na stránce *Produkty*. Pro větší množství produktů použijte pravidlo **„Skrýt produkt“**, které se aplikuje na uložený výběr (např. produkty bez EANu, s nízkou marží apod.). **12\. Je možné zjistit, kdy si kanál (např. Heureka) stáhl výstupní feed?** Ano. Mergado zaznamenává, kdy došlo ke stažení výstupního feedu, což pomáhá sledovat aktualizaci dat u jednotlivých inzertních kanálů. Informaci o **posledním stažení** najdete na stránce **Přehled**. Podrobnější historii stahování najdete na stránce **Historie** po zvolení typu události **Stahování**. --- # **2\. Stránka Produkty** Stránka **Produkty** je centrální místo, kde můžete **kontrolovat, zobrazovat a upravovat produktová data**. Najdete zde všechny položky ze svého feedu, můžete s nimi pracovat jednotlivě nebo po skupinách a ověřovat, jak fungují pravidla. Zjednodušeně řečeno – zde máte plnou kontrolu nad tím, co se s produkty v Mergadu děje. ## **Účel a funkce stránky** Hlavním účelem stránky *Produkty* je **kontrola dat a změn**, které se v projektu provádějí. Najdete zde nejdůležitější informace o položkách ve feedu, můžete přímo upravovat jejich hodnoty nebo vytvářet výběry pro další práci. **Hlavní funkce stránky:** * **Zobrazení dat** – vizuální kontrola produktů a jejich hodnot. * **Editace** – možnost upravit konkrétní element ručně. * **Tvorba výběrů** – vytváření skupin produktů, se kterými následně pracují pravidla. * **Debugování** – ověřování, proč se produkt chová jinak, než očekáváte (např. se zobrazí ve výstupu, i když měl být skryt). ## **Přehled rozhraní a dostupné pohledy** Stránka *Produkty* nabízí několik různých pohledů, které pomáhají s orientací v datech a umožňují rychlou kontrolu konkrétních informací. ### **Typy pohledů** | Pohled | Popis | | ----- | ----- | | **Náhledy** | Zobrazí produkty podobně jako na inzertních kanálech (např. Heureka, Zboží.cz). Zobrazí pouze klíčová data, vhodné pro rychlý přehled o katalogu. | | **Elementy** | Zobrazí produkt rozložený po jednotlivých elementech a jejich hodnotách. Umožňuje snadno porovnat původní a upravené hodnoty. Nejpodrobnější zobrazení – ideální pro práci s daty. | | **Obrázky** | Zobrazuje hlavní i doplňkové obrázky produktů. Umožňuje porovnání obrázků ze vstupního i výstupního feedu. | | **Tabulka** | Výkonný nástroj pro práci s daty v přehledné tabulce, podobně jako v Excelu nebo Google Sheets. Umožňuje nastavit zobrazené sloupce, jejich pořadí a filtrovat produkty podle potřeb. | ### **Funkce tabulkového zobrazení** * **Lišta nástrojů** obsahuje ikony pro speciální sloupce (např. obrázek, ID, název produktu, ukotvení). * K dispozici jsou **záložky s presety** (např. párování, bidding) i záložka pro vlastní seznam zobrazených elementů. * V hlavičce každého sloupce lze použít **křížek pro dočasné skrytí** nebo **řazení hodnot** (neplatí pro speciální sloupce). * Pořadí sloupců můžete **měnit metodou drag & drop**. * Tabulku lze **rozšířit na celou obrazovku**, což usnadňuje práci s větším množstvím dat. * Zobrazená data **respektují aktuálně nastavený filtr produktů** – lze tak srovnávat konkrétní elementy a produkty. * Vytvořenou tabulku je možné **exportovat do CSV**, přesně v podobě, v jaké ji vidíte. Tento soubor lze dále analyzovat v tabulkovém editoru nebo použít pro zpětný import do jiného projektu pomocí pravidla *Import datového souboru*. 💡 **Tip:** Způsob zobrazení můžete měnit jak pro všechny produkty, tak i pro konkrétní produkt. ## **Kontrola dat a porovnání vstupu a výstupu** Na stránce *Produkty* vidíte nejen aktuální data, ale také rozdíly mezi tím, co Mergado načetlo (**vstupní feed**), a tím, co odesílá dál (**výstupní feed**). To umožňuje snadno ověřit, zda se úpravy pravidly aplikovaly správně. ### **Nastavení zobrazení hodnot** Pomocí ikon můžete přepínat, které hodnoty se mají zobrazovat: * pouze **vstupní hodnoty** (`->]`), * pouze **výstupní hodnoty** (`[->`), * nebo **vstup i výstup současně** (`->][->`). Pokud zvolíte zobrazení obou hodnot současně, Mergado zvýrazní rozdíly: * 🟥 **červeně** – odstraněné hodnoty, * 🟩 **zeleně** – nově přidané hodnoty. ### **Skryté elementy** Stránka zobrazuje i **skryté elementy**, které nejsou součástí výstupního feedu, ale existují ve vstupních datech. V rozhraní se zobrazují **šedou barvou**. Pokud je nechcete vidět, můžete vypnout volbu *„Zobrazit skryté“*. Tuto možnost se doporučuje zapnout zejména tehdy, pokud se **vstupní a výstupní formát liší** a potřebujete zkontrolovat původní vstupní data. ### **Hledání produktů – vstup vs. výstup** Při filtrování produktů a vytváření výběrů si můžete zvolit, zda se má hledat podle hodnot ze **vstupního** nebo **výstupního** feedu. * Obecně se doporučuje hledat **na vstupu**, protože tyto hodnoty se pravidly nemění. * Pokud ale pracujete s elementem, který vzniká až po úpravě (např. `g:id`), je nutné přepnout hledání na **výstup**. ## **Ruční a hromadná editace** Většina změn v Mergadu se provádí hromadně pomocí pravidel, ale v některých případech je vhodné upravit jen několik produktů ručně. Na stránce *Produkty* lze provádět **rychlé manuální změny** u jednotlivých produktů a jejich elementů. ### **Manuální editace** * Hodnoty elementů lze měnit přímo v rozhraní stránky *Produkty*. * Mergado vždy zobrazuje **původní** i **novou hodnotu**, což usnadňuje kontrolu provedených změn. * Funkce je ideální pro drobné opravy nebo testování pravidel. ### **Úprava popisků (WYSIWYG editor)** Pro textové elementy, jako `DESCRIPTION` nebo `SHORT_DESCRIPTION`, je k dispozici **WYSIWYG editor** (*What You See Is What You Get*). Můžete psát buď v prostém textu, nebo v režimu s formátováním (tučnost, kurzíva apod.). Po uložení se text převede do HTML, které podporují reklamní systémy. ## **Propojení se stránkami *Pravidla* a *Elementy*** Stránka *Produkty* úzce spolupracuje s ostatními částmi Mergada – především se stránkami **Pravidla** a **Elementy**. ### **Napojení na Pravidla** * Z výběrů vytvořených na stránce *Produkty* můžete snadno vytvářet pravidla, která na ně působí. * Pro kontrolu, jak jednotlivá pravidla produkty ovlivňují, lze využít zobrazení *Elementy* nebo funkci **„Sledování produktu při průchodu pravidly“**. Tato funkce zobrazí přehled všech změn, které u produktu provedla jednotlivá pravidla. * Je ideální při **debugování**, pokud se produkt nechová podle očekávání (např. výsledná hodnota elementu je jiná, než jste předpokládali). ### **Napojení na Elementy** * Na stránce *Elementy* můžete **přidávat, skrývat nebo upravovat** (ručně vytvořené) elementy, které se následně zobrazí i na stránce *Produkty*. * **Skryté elementy** se v rozhraní *Produkty* zobrazují šedě, aby bylo jasné, že nejsou exportovány. * Pomocí stránky *Elementy* lze také **vyhledávat duplicity** – vyberete element (např. `PRODUCTNAME`), zobrazíte jeho hodnoty a přejdete na stránku *Produkty* s automaticky vytvořeným výběrem duplicit. ## **FAQ** 1. **Co je stránka Produkty a k čemu slouží?** Stránka Produkty je centrální místo pro kontrolu, zobrazení a úpravu produktových dat v Mergadu. Umožňuje pracovat s jednotlivými produkty nebo skupinami produktů, sledovat, jak se na nich projevují pravidla, a ověřovat správnost dat ve feedu.V horní části se nachází také **vyhledávací pole**, které slouží k **vytváření produktových výběrů**. 2. **Jaké jsou hlavní funkce stránky Produkty?** Stránka umožňuje zobrazovat data, provádět ruční úpravy elementů, vytvářet produktové výběry a kontrolovat, jak se mění hodnoty po aplikování pravidel. Slouží také k ladění problémů s produkty (debugování). 3. **Jaké typy zobrazení stránka nabízí?** K dispozici jsou čtyři základní pohledy: * Náhledy – rychlý přehled o produktech podobný inzertním kanálům. * Elementy – detailní zobrazení produktů po jednotlivých elementech. * Obrázky – zobrazení hlavních i doplňkových obrázků. * Tabulka – přehledné zobrazení dat s možností filtrování, řazení a exportu. 4. **Jak mohu upravit, které sloupce jsou v tabulkovém zobrazení viditelné?** Sloupce lze přidávat nebo skrývat pomocí záložek a lišty nástrojů. Pořadí lze měnit metodou „drag & drop“. Dočasné skrytí sloupce se provádí ikonou křížku v hlavičce. 5. **Lze tabulku exportovat mimo Mergado?** Ano. Tabulku je možné exportovat jako CSV soubor přesně v podobě, v jaké ji vidíte. Tento soubor lze použít například v Excelu, Google Sheets nebo pro import do jiného projektu pomocí pravidla Import datového souboru. 6. **Jak zjistím rozdíly mezi vstupním a výstupním feedem?** Na stránce lze přepínat, zda chcete zobrazit hodnoty ze vstupního feedu, výstupního feedu, nebo obojí současně. Rozdíly jsou zvýrazněny barvami – červeně odstraněné hodnoty, zeleně nově přidané. 7. **Co znamenají skryté elementy a jak je zobrazit?** Skryté elementy jsou data, která nejsou exportována do výstupního feedu, ale existují ve vstupních datech. V rozhraní se zobrazují šedou barvou. Pokud je chcete vidět, aktivujte volbu „Zobrazit skryté“. 8. **Kdy mám hledat produkty na vstupu a kdy na výstupu?** Obvykle je vhodné hledat produkty na vstupu, protože tato data se pravidly nemění. Pokud ale hledáte elementy, které vznikají až po úpravě, přepněte hledání na výstupní feed. 9. **Můžu upravovat data přímo na stránce Produkty?** Ano. Hodnoty elementů lze ručně měnit přímo v rozhraní. Mergado vždy zobrazuje původní i novou hodnotu, takže můžete snadno kontrolovat změny. 10. **K čemu slouží WYSIWYG editor?** Editor umožňuje přehledně upravovat textové elementy, jako jsou popisky produktů (`DESCRIPTION`, `SHORT_DESCRIPTION`). Podporuje formátování textu (tučnost, kurzíva apod.) a ukládá výsledný text jako HTML, které rozpoznávají reklamní systémy. 11. **Jak stránka Produkty souvisí se stránkou Pravidla?** Z výběrů vytvořených na stránce Produkty lze vytvářet pravidla, která na tyto produkty působí. Pro kontrolu jejich efektu lze využít funkci „Sledování produktu při průchodu pravidly“, která ukáže, jaké změny pravidla provedla. 12. **Jak stránka Produkty souvisí se stránkou Elementy?** Na stránce Elementy můžete přidávat, skrývat nebo upravovat elementy, se kterými pak následně můžete pracovat v Pravidlech. 13. **Co dělat, když se produkt ve výstupu zobrazuje jinak, než očekávám?** Použijte funkci „Sledování produktu při průchodu pravidly“. Ta zobrazí přehled všech pravidel, která produkt ovlivnila, a pomůže odhalit, které pravidlo způsobilo nežádoucí změnu. --- # **3\. Vyhledávání a výběry produktů** Vyhledávání a vytváření výběrů patří mezi nejdůležitější funkce stránky Produkty. Umožňují snadno filtrovat, seskupovat a spravovat produkty podle přesně definovaných podmínek. Výběry následně slouží jako základ pro aplikaci pravidel, skrývání produktů nebo cílení kampaní v inzertních kanálech. ## **Výběry produktů** Každý vytvořený filtr můžete uložit jako výběr produktů. Výběry slouží k aplikaci pravidel, analýze dat i k automatizacím. **Typy výběrů:** * **Dočasné výběry** – použijí se pouze v aktuálním kontextu, např. pro rychlou kontrolu. * **Uložené výběry** – zůstávají dostupné pro opakované použití a zobrazují se v sekci Uložené výběry. U každého vidíte počet produktů i počet pravidel, která s výběrem pracují. ## **Jak funguje vyhledávání** Na stránce *Produkty* můžete vyhledávat produkty podle hodnot v jednotlivých elementech (např. `PRICE, PRODUCTNAME, EAN`). K dispozici jsou dva způsoby: * **Jednoduché rozhraní** – klikací způsob vhodný pro běžnou práci. * **Vlastní MQL dotaz** – textové vyhledávání s pokročilou syntaxí a možností kombinovat více podmínek. Vyhledávání je přehledné i při práci se stovkami nebo tisíci produktů. Každý vytvořený filtr můžete uložit jako **výběr produktů** a dále s ním pracovat v pravidlech. ## **Hledání ve vstupních a výstupních datech** Při filtrování je klíčové, zda hledáte produkty ve **vstupním** nebo **výstupním** feedu. Správná volba zdroje dat ovlivňuje výsledky vyhledávání i další práci s výběry. * **Hledání na vstupu** – výchozí režim; vyhledává podle původních dat z e-shopu, která se pravidly nemění. * **Hledání na výstupu** – používá se, když potřebujete filtrovat podle elementů vytvořených až během úprav v Mergadu. **Přeškrtnuté kolečko 🚫** označuje elementy, které ve vstupních datech neexistují. Tyto elementy Mergado vytváří převodníkem, a proto v nich nelze hledat při zobrazení vstupních dat. **Příklad:** Na vstupu máte Heureka feed a vytváříte feed pro Google. Pokud hledáte podle ITEM\_ID, zůstaňte u hledání na vstupu. Pokud pracujete s g:id, přepněte na výstup. ## **Práce s podmínkami (operátory)** Každý filtr nebo výběr je kombinací podmínek ve tvaru: ` ` ### **Podporované operátory** * `CONTAINS` – obsahuje text * `NOT CONTAINS` – neobsahuje text * `=` – je rovno * `!=` – není rovno * `~` – obsahuje regulární výraz * `!~` – neobsahuje regulární výraz * `, =` – porovnání čísel * `IN` – je obsažen ve výčtu * `NOT IN` – není obsažen ve výčtu * `IS EMPTY` – je prázdný * `IS NOT EMPTY` – není prázdný * `AND, OR` – logické spojení podmínek Pokud název elementu obsahuje nealfanumerické znaky, zapište jej do hranatých závorek: `[Název elementu] = "modrá"` ### **Popis a příklady operátorů** #### Operátor: Obsahuje / Neobsahuje text **Popis**: * Hledá v řetězci uvedenou hodnotu. Hodnota není case sensitive. **Příklady:** * Hledáte repasované produkty ve feedu. * Podmínka: `NAME_EXACT CONTAINS "repasovan"` * Slovy: název produktu obsahuje hodnotu “repasovan” * stačí napsat i část slova, bez koncovky –á, –é, –ý, tím pokryjete celé spektrum: repasovaný, repasované, repasovaná * Hledáte kategorie, které neobsahují hodnotu vánoce nebo vánoční * Podmínka: `CATEGORY NOT CONTAINS "vánoční" OR CATEGORY NOT CONTAINS "vánoce"` * Slovy: element kategorie neobsahuje hodnotu vánoční nebo vánoce **Na co si dát pozor:** Vyhledávat celou hodnotu místo klíčového výrazu; např. “Repasované notebooky” nezachytí ostatní repasované produkty. #### Operátor Je / Není rovno **Popis** * Hledá v elementu přesnou shodu. Hodnota není case sensitive. **Příklady**: * Hledáte všechny produkty, které jsou od výrobce AB Porzellan. * Podmínka: `PRODUCER = "AB Porzellan"` * Slovy: element PRODUCER se rovná hodnotě „AB Porzellan“. * Hledáte produkty, které nejsou z porcelánu. * Podmínka: `PARAM { NAME = "Materiál" } | VALUE != "Porcelán"` * Slovy: parametr s názvem „Materiál“ má hodnotu, která se nerovná „Porcelán“. **Na co si dát pozor:** * Hledané výrazy jako „červená“ mohou mít ve feedu více koncovek (červený, červené). * Pokud uvedete jen část řetězce, může se výsledek lišit od očekávání – je potřeba vědomě pracovat s tím, zda chcete přesnou shodu, nebo pouze část textu. #### Operátory pro porovnání číselných hodnot (\, \=) **Popis** * Porovnávají číselné hodnoty elementů mezi sebou (větší, menší, větší nebo rovno, menší nebo rovno). Fungují pouze pro elementy s číselnou hodnotou. **Příklady**: * Segmentujete produkty do různých cenových hladin. * Podmínka: `PRICE_VAT > 200 AND PRICE_VAT 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport"` ## **Základní vyhledávání** V jednoduchém rozhraní stačí vybrat element, nastavit podmínku a zadat hodnotu. Další řádky můžete přidávat kliknutím na ikonu „+“. Můžete také zvolit, zda další řádek bude na stejné úrovni, nebo jako zanořená podmínka. **Příklady**: * `PRICE > 1000` → zobrazí produkty dražší než 1000 Kč. * `PRODUCTNAME CONTAINS "tričko"` → najde všechny produkty s tímto výrazem v názvu. * `[CATEGORYTEXT] CONTAINS "Elektro"` → vyhledá produkty z dané kategorie. * `(PRICE > 100 AND BRAND = "Bose") OR CATEGORYTEXT CONTAINS "Reprodukt "` → příklad podmínky se zanořenou podmínkou. ### **Jaké hodnoty lze zadat do pole „Hodnota“** * textovou nebo číselnou hodnotu – např. `Auto`, `1000`, * regulární výraz – např. `^\d{8}$` pro EAN o délce 8 číslic, * jiný element – pokud chcete porovnat hodnoty mezi dvěma elementy (např. `PRODUCTNAME` neobsahuje `BRAND`). ## **Pokročilé vyhledávání pomocí MQL** Pro složitější výběry slouží MQL (Mergado Query Language) – textové rozhraní, které nabízí plnou kontrolu nad podmínkami. MQL aktivujete přepnutím z jednoduchého vyhledávání volbou „Vlastní MQL dotaz“. Příklad MQL dotazu: * `PRICE > 1000 AND BRAND = "Nike"` → Produkty se značkou Nike, které jsou dražší než 1000\. * `(PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport"`→ Produkty se značkou Nike, které jsou dražší než 500, nebo produkty z kategorií, jejichž název obsahuje výraz „Sport“. * `PRICE_VAT > "500" AND CATEGORYTEXT ~ "mikina" AND MANUFACTURER = "Adidas"`→ Zboží, které je dražší než 500 Kč, je v kategorii, která obsahuje slovo „mikina“, a má značku Adidas. * `NAME_EXACT CONTAINS "detská hojdačka" AND PARAM { NAME = "Tvar" } | VALUE = "okrůhly" AND PARAM { NAME = "Materiál" } | VALUE = "masiv"`→ Název obsahuje text „detská hojdačka“ a zároveň parametr Tvar se rovná „okrůhly“ a parametr Materiál se rovná „masiv“. Pro ověření, zda konkrétní produkt spadá do výběru, přidejte podmínku: `AND ITEM_ID = "123"` Příklad: `((PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport") AND ITEM_ID = "123"` * Místo hodnoty 123 zadejte ID produktu. Pokud se produkt zobrazí, výběr ho zahrnuje. ## **Použití regulárních výrazů (RegEx)** Regulární výrazy můžete využít pro přesné filtrování textů, např. podle vzoru v názvu nebo podle délky EAN kódů. Příklady: * Produkty, jejichž název obsahuje varianty slova „modrý“: `PRODUCTNAME ~ "modr."` * Kontrola délky EANu: * přesně 8 číslic → `^\d{8}$` * 8 nebo 12–14 číslic → `^(\d{8}|\d{12,14})$` Díky značkám `^` (začátek) a `$` (konec) se kontroluje přesná délka textu, nikoliv jen jeho část. ## **Ověření a použití výběrů** Po vytvoření výběru jej můžete: * **okamžitě použít** v pravidlech (např. Skrýt produkt), * **uložit pro pozdější použití,** * nebo **znovu načíst** a upravit jeho podmínky. **Chcete-li ověřit, že produkt do výběru skutečně spadá:** 1. Na stránce *Produkty* načtěte výběr. 2. Přepněte do MQL rozhraní a přidejte podmínku `AND ITEM_ID = "123"`. → Pokud se produkt zobrazí, výběr ho obsahuje. **Chcete-li jednoduše a rychle zjistit, do kterých výběrů produkt spadá a případně které skrývací pravidlo ho skrývá:** 1. Na stránce *Produkty* najděte daný produkt. 2. U produktu přejděte na záložku Výběry (z dostupných záložek Náhled, Elementy, Obrázky, Výběry a Sledování produktu). 3. Zobrazí se tabulka s existujícími výběry, do kterých produkt aktuálně spadá. 4. U každého výběru je na pravé straně buď: 1. informace, že daný výběr není zahrnut v žádném skrývacím pravidle, nebo 2. název a odkaz na skrývací pravidlo, které daný výběr obsahuje. ## **Vytvoření a editace výběru z formuláře pravidla** Mergado umožňuje vytvořit nebo upravit výběr přímo z formuláře nového pravidla, nebo při editaci existujícího pravidla. To se hodí v situaci, kdy nastavujete pravidlo a zjistíte, že ještě nemáte vhodný výběr produktů, nebo potřebujete existující výběr upravit. **Postup vytvoření nového výběru z formuláře pravidla:** 1. Na stránce Pravidla vytvořte nové pravidlo nebo editujte existující pravidlo. 2. Ve formuláři pravidla v poli Výběr vyberte v selectboxu poslední možnost „Vytvořit nový výběr“. 3. Zprava vyjede sidepanel zjednodušené stránky Produkty, kde můžete zadat podmínku a název výběru. 4. Po uložení výběru se sidepanel skryje a nový výběr se automaticky vybere v poli Výběr formuláře pravidla. **Postup editace výběru z formuláře pravidla:** 1. Na stránce Pravidla vytvořte nové pravidlo nebo editujte existující pravidlo. 2. Ve formuláři pravidla v poli Výběr najděte v selectboxu existující výběr, který potřebujete upravit, a klikněte na ikonu tužky. 3. Zprava vyjede sidepanel zjednodušené stránky Produkty s vybraným výběrem. 4. Upravte podmínku výběru dle potřeby. 5. Po uložení změn ve výběru se sidepanel skryje a v poli Výběr zůstane vybraný upravený výběr. ## **Shrnutí** Operátory a podmínky vám umožňují velmi přesně cílit na konkrétní skupiny produktů. Správnou kombinací podmínek, regulárních výrazů a výčtů dokážete vytvořit výběry, na které lze bezpečně a efektivně aplikovat pravidla i automatizace. ## **FAQ** **1\. Jaký je rozdíl mezi vyhledáváním a výběrem produktů?** Vyhledávání umožňuje filtrovat produkty podle zadaných podmínek. Výběr je uložený filtr, který můžete znovu použít nebo na něj aplikovat pravidla. Výběry jsou trvalé a přehledně dostupné v sekci Uložené výběry, zatímco vyhledávání slouží jako dočasná práce s daty. **2\. Kdy mám hledat ve vstupních a kdy ve výstupních datech?** Většinu času se doporučuje hledat ve vstupních datech, protože ty nejsou ovlivněny pravidly. Výstupní data použijte tehdy, když pracujete s hodnotami, které Mergado vytvoří až při transformaci pro výstupní feed. **3\. Co znamená červené označení přeškrtnutého kolečka u elementu?** Tento symbol označuje elementy, které ve vstupních datech neexistují a byly vytvořeny převodníkem nebo uživatelem pro výstupní element. V takových elementech nelze hledat, pokud máte zapnuté vyhledávání ve vstupním feedu. Při přepnutí na vyhledávání na výstupu toto označení zmizí. **4\. Jaké operátory mohu používat při vytváření výběrů?** K dispozici jsou operátory pro práci s textem, čísly, regulárními výrazy, výčtem hodnot i prázdnými hodnotami. Patří mezi ně například CONTAINS, \=, \!=, \, \~, IN, IS EMPTY nebo jejich negace. Operátory lze kombinovat pomocí AND, OR a závorek. **5\. K čemu slouží hranaté závorky u názvů elementů?** Hranaté závorky je nutné použít tehdy, pokud název elementu obsahuje mezeru nebo jiné nealfanumerické znaky. Používat je můžete i u elementů bez speciálních znaků – usnadní to našeptávání názvů a sníží riziko chybných dotazů. **6\. Jak zjistím, zda je hodnota elementu prázdná nebo vyplněná?** Pro kontrolu prázdných nebo nevyplněných hodnot slouží podmínky IS EMPTY a IS NOT EMPTY. Jsou vhodné například při vyhledávání produktů s chybějícím výrobcem, kategorií nebo jiným důležitým údajem. **7\. Jak mohu vyhledávat podle více hodnot najednou?** Použijte operátory IN nebo NOT IN. Hodnoty vložte do pole výčtu, každou na samostatný řádek. Tento způsob je vhodný pro výběry, které nevyužívají žádný společný prvek (např. výběr top produktů nebo ručně vybraných kategorií). **8\. Jak fungují regulární výrazy při vyhledávání?** Regulární výrazy umožňují pokročilé filtrování, například podle vzoru textu nebo podle délky řetězce. Pro přesnou shodu je potřeba používat značky začátku a konce řetězce (^ a $). To zajistí, že se vrátí pouze hodnoty, které odpovídají přesnému tvaru. **9\. Kdy mám použít jednoduché vyhledávání a kdy MQL?** Jednoduché vyhledávání je ideální pro běžnou práci a základní filtrování. MQL se hodí pro složitější dotazy, kombinaci více podmínek, porovnávání elementů nebo detailní použití regulárních výrazů. **10\. Jak zjistím, zda produkt do výběru skutečně spadá?** Na stránce Produkty načtěte výběr, přepněte do MQL režimu a přidejte podmínku `AND ITEM_ID = "ID produktu"`. Pokud se produkt zobrazí, do výběru patří. Pokud ne, podmínky výběru mu neodpovídají. Alternativně můžete produkt vyhledat a na jeho kartě otevřít záložku Výběry, kde uvidíte všechny výběry, do kterých aktuálně spadá. **11\. Jak zjistím, do kterých výběrů produkt spadá?** Na stránce Produkty otevřete kartu Výběry u daného produktu. Zobrazí se seznam všech výběrů, do kterých produkt aktuálně patří, včetně informace, zda je některý z těchto výběrů použit ve skrývacím pravidle. To pomůže hlavně v situaci, kdy máte v projektu víc skrývacích pravidel nebo ve skrývacím pravidle skrýváte více výběrů produktů, a nevíte, který výběr a skrývací pravidlo skrývá nějaký konkrétní produkt. **12\. Je možné vytvořit výběr přímo při zakládání pravidla?** Ano. Ve formuláři pravidla můžete zvolit možnost vytvořit nový výběr. Otevře se postranní panel, kde zadáte podmínky a název výběru. Po uložení se výběr automaticky vloží do formuláře pravidla. **13\. Lze upravit existující výběr přímo z pravidla?** Ano. Kliknutím na ikonu tužky vedle názvu výběru ve formuláři pravidla otevřete postranní panel s podmínkami daného výběru. Upravte jej a po uložení se změny okamžitě promítnou i v pravidle. **14\. Jaké chyby při práci s výběry jsou nejčastější?** Mezi časté chyby patří hledání ve špatném zdroji dat (vstup vs. výstup), nepoužití hranatých závorek u elementů s mezerami, chybné použití regulárních výrazů bez ^ a $, nebo překryv více podmínek, který vede k neočekávaným výsledkům. **15\. K čemu se výběry nejčastěji používají?** Výběry tvoří základ pro filtrování, skrývání produktů, úpravu cen, doplňování informací, kontrolu kvality dat i cílení kampaní v jednotlivých inzertních kanálech. Jsou jedním z nejdůležitějších nástrojů v Mergadu. --- # **4\. Úpravy produktových dat** V Mergadu můžete měnit produktová data buď **ručně**, nebo **hromadně prostřednictvím pravidel**. Manuální úpravy se hodí pro jednotlivé produkty nebo menší skupiny položek, zatímco pravidla jsou určena pro rozsáhlé a opakované změny v celém feedu. ## **Manuální editace** Manuální změny jsou ideální pro **menší počet produktů**, u kterých by nebylo efektivní vytvářet samostatné pravidlo. Hodnoty lze upravovat přímo na stránce *Produkty* v zobrazení **Elementy.** ### **Rychlá úprava hodnot** * Upravte hodnotu elementu kliknutím na **ikonu tužky**. Upravte hodnotu, následně kliněte na **Uložit.** * Mergado vždy zobrazí **původní** i **novou hodnotu**, takže snadno zkontrolujete, co se změnilo. * Pokud takto upravené hodnoty chcete propsat do výstupního feedu, je potřeba feed přegenerovat. Aplikování pravidel v tomto případě ale není nutné. * Po editaci dat se zobrazí speciální pravidlo i v seznamu pravidel na stránce *Pravidla.* Pravidlo nelze editovat, pouze vypnout. * Lze ale vyfiltrovat na stránce Produkty všechny manuálně upravené produkty. Pod vyhledávacím polem kliněte na *Zobrazit \-\> S manuálními změnami* Tento způsob úprav je vhodný například při testování nebo opravách menších datových chyb. ## **Úprava popisků pomocí WYSIWYG editoru** Pro textové elementy, jako jsou popisky produktů (`DESCRIPTION`, `SHORT_DESCRIPTION`), Mergado nabízí editor typu **WYSIWYG** (*What You See Is What You Get*). Umožňuje pracovat s textem pohodlně a přehledně, bez nutnosti znát HTML kód. Úpravy lze ale provést pouze u konkrétních produktů, nelze upravit hromadně. ### **Jak editor funguje** * Editor otevřete kliknutím na **ikonu tužky** u konkrétního elementu. * Hodnotu můžete upravovat ve dvou režimech: 1. **Prosté zobrazení** – zobrazuje syrový text s HTML značkami (např. `Novinka`). 2. **Formátované zobrazení** – zobrazuje výsledný formátovaný text (např. **Novinka**). * Po uložení se vám zobrazí původní i nová verze. Nová verze se zobrazí HTML značkami. Pro export změn do výstupného feedu je nutné přegeneorvat feed. Po uložení se text ukládá s příslušnými HTML značkami, které **podporuje většina reklamních systémů**. To umožňuje například zvýraznit klíčová slova nebo strukturovat delší popisky. ## **Hromadné úpravy pomocí pravidel** Většina změn v Mergadu se provádí **hromadně přes pravidla**. Pravidla umožňují automatizovat úpravy napříč stovkami či tisíci produktů a jsou základním nástrojem pro optimalizaci feedu. ### **Jak pravidla fungují** * Pravidla se aplikují buď na všechny produkty, nebo na konkrétní výběry produktů vytvořené na stránce Produkty. * Po uložení výběru přejdete na stránku Pravidla, kde zvolíte typ pravidla (např. přepsání hodnoty, výpočet, skrytí produktu, atd.). ### **Typické příklady pravidel** #### **1\. Skrytí produktu** Pravidlo **„Skrýt produkt“** zcela odstraní zboží z výstupního feedu (ale v Mergadu produkty v katalogu zůstanou s označením skryté a lze je kdykoli znovu odkrýt a exportovat). Využívá se například pro produkty: * s **dlouhou dobou dodání** (např. `DELIVERY_DATE > 10`), * s **nízkou marží**, * nebo které **nejsou vhodné pro inzerci** (např. zbraně v Google Ads). Lze ho použít i pro **časové skrývání** – například sezónní produkty. #### **2\. Výpočet nových hodnot** Pravidlo typu **„Výpočet“** se používá k vytváření nebo přepočítávání hodnot, například pro výpočet marže. **Příklad:** Vzorec pro výpočet marže: ((%Prodejní\_cena% \- %Nákupní\_cena%) / %Prodejní\_cena%) \* 100 Výsledek se uloží do nového elementu (např. `MARGIN`), který můžete dál využívat v pravidlech nebo výběrech. #### **3\. Import datového souboru** Pokud ve vstupním feedu chybí důležité informace (např. marže, skladovost, parametry), lze je doplnit pomocí pravidla **„Import datového souboru“**. Tímto způsobem můžete k produktům připojit data z externího zdroje – typicky ve formátu CSV nebo XML. ## **Sledování produktu při průchodu pravidly** Pokud se produkt chová jinak, než očekáváte (např. se zobrazuje ve výstupním feedu, i když měl být skryt), použijte funkci **„Sledování produktu při průchodu pravidly“**. * Funkci aplikujete na konkrétní produkt (lze vybrat i více produktů najednou). * Po provedení aplikace pravidel se zobrazí odkaz na stránka s přehledem všech pravidel, která produkt ovlivnila, včetně popisu změn. * Díky tomu snadno zjistíte, které pravidlo způsobilo nečekanou změnu. * Odkaz na tuto stránku najdete i zpětně v historii událostí – v levém menu projektu zvolte Historie a vyhledejte konkrétní aplikaci pravidel. Před použitím této funkce doporučujeme ověřit, zda produkt skutečně spadá do výběru, na který se pravidlo aplikuje. ## **Shrnutí** Úpravy produktových dat v Mergadu jsou flexibilní – lze je provádět ručně nebo hromadně. Manuální editace je vhodná pro menší zásahy, opravné úpravy a testování. Pravidla naopak zajišťují konzistentní a rozsáhlé úpravy napříč celým feedem. Funkce jako WYSIWYG editor nebo sledování průchodu pravidly umožňují efektivní kontrolu a správu dat. ## **FAQ** **1\. Kdy mám použít manuální úpravy místo pravidel?** Manuální úpravy jsou vhodné pro menší počet produktů nebo jednorázové změny, kdy by vytváření samostatného pravidla nedávalo smysl. Hodí se také pro rychlé testování. **2\. Propsání manuálně upravených hodnot vyžaduje aplikaci pravidel?** Ano. I manuální úprava hodnoty jednoho elementu jednoho produktu vytvoří automatické pravidlo typu Manuální změny s názvem Přímá editace elementů produktů, které se musí aplikovat, aby se změny dostaly do výstupní feedu. **3\. Kde najdu informace o tom, že a které produkty mají manuální změny?** Manuálně upravené produkty lze zobrazit na stránce Produkty volbou Zobrazit → S manuálními změnami. V seznamu pravidel se zároveň objeví systémové pravidlo typu Manuální změny, které záznam o úpravě reprezentuje. **4\. Co dělat, pokud se manuální úpravy nepropisují do exportu?** Zkontrolujte, zda byl přegenerován výstupní feed. Pokud feed nebyl po úpravě znovu vygenerován, změny se v exportu neprojeví. **5\. Lze pomocí WYSIWYG editoru upravit texty hromadně?** Ne. WYSIWYG editor slouží pouze pro úpravy jednotlivých produktů. Hromadné změny textů je nutné provádět pomocí pravidel. Pokud potřebujete upravovat popisky ve větším množství, lze využít rozšíření Mergado Sources, kde pomocí ChatGPT získáte strukturované a optimalizované texty. **6\. Jaké HTML prvky WYSIWYG podporuje?** Podporuje základní HTML značky, které akceptují reklamní systémy (např. tučné písmo, kurzívu, odstavce). **7\. Co znamená, že se po manuální úpravě vytvoří systémové pravidlo?** Jedná se o interní záznam, který zaznamenává provedené manuální úpravy. Nelze jej editovat ani měnit jeho chování, lze jej jen dočasně nebo trvale vypnout. **8\. Lze zjistit, jaké pravidlo ovlivnilo konkrétní produkt a případně jak ho ovlivnilo?** Ano. Slouží k tomu funkce Sledování produktu při průchodu pravidly. Zobrazí přehled všech pravidel, která produkt upravila, a přesný popis provedených změn. **9\. Kde najdu historii průchodu pravidly, pokud si ji chci zobrazit zpětně?** V levém menu otevřete stránku Historie a vyhledejte konkrétní aplikaci pravidel podle data a času. Odtud se můžete prokliknout na detail zpracování. **10\. Jak poznám, že pravidlo nepůsobí správně?** Pokud výsledné hodnoty ve výstupním feedu neodpovídají očekávání, nejprve ověřte, zda produkt skutečně spadá do výběru používaného pravidlem. Pokud ano, využijte sledování průchodu pravidly k identifikaci pravidla, které změnu provedlo. **11\. Mohou pravidla ovlivňovat i hodnoty, které jsem upravil ručně?** Ano. Pokud pravidlo cílí na stejný element, může manuálně upravenou hodnotu přepsat. V takovém případě doporučujeme hodnotu ošetřit správnou strukturou pravidel, případně upravit výběry, aby přepis nenastal. --- # **5\. Autorizace produktů** Autorizace produktů je funkce, která zpřesňuje kontrolu nad tím, které produkty se exportují do výstupního feedu. Funguje jako alternativa ke skrývacím pravidlům. Pokud je autorizace zapnutá, nově importované produkty se sice načtou do projektu, ale **nebudou exportovány**, dokud je uživatel ručně neschválí. Funkce se vztahuje vždy ke konkrétnímu projektu. ## **Zapnutí funkce Autorizace produktů** **Autorizaci produktů lze zapnout dvěma způsoby:** * při vytváření nového projektu: * V posledním kroku průvodce, v sekci Shrnutí, najdete volbu *Zapnout autorizaci produktů*. Stačí zaškrtnout checkbox. * v existujícím projektu: * Přejděte do levého menu *Nastavení → Obecná nastavení projektu*. * V sekci Základní informace najdete checkbox *Zapnout autorizaci produktů*. * Funkci lze stejným způsobem také vypnout. Po vypnutí je nutné projekt přegenerovat. ## **Chování projektu se zapnutou autorizací** **Nově vytvořený projekt** * Po zapnutí funkce u nového projektu získají všechny produkty stav **Čeká na schválení**. * Výstupní feed bude do té doby prázdný, dokud některé produkty neschválíte. **Existující projekt** Pokud autorizaci zapnete dodatečně: * všechny stávající produkty dostanou stav **Schváleno**, * všechny nově importované produkty budou ve stavu **Čeká na schválení** a nebudou se exportovat, dokud je uživatel ručně neschválí. ## Práce s autorizací produktů Po aktivaci funkce se v projektu na stránce Produkty objeví nová sekce **Autorizace produktů**. Najdete zde tabulkové zobrazení všech produktů a rychlé filtrování podle stavu schválení. **Tabulka obsahuje například:** * datum prvního importu produktu, * název, ID, cenu, kategorii, * aktuální stav autorizace. **Každý produkt může mít jeden ze tří stavů:** * Schváleno * Zamítnuto * Čeká na schválení **Filtrování umožňuje zobrazit:** * všechny produkty, * pouze schválené, * pouze zamítnuté, * nebo pouze produkty čekající na schválení. Pomocí tlačítka *Filtr* můžete otevřít klasický formulář s MQL podmínkami a kombinovat filtr podle stavu autorizace s filtrováním podle názvu, ceny, kategorie, značky a dalších produktových informací. ## Schvalování nebo zamítání produktů Produkty můžete schválit nebo zamítnout ručně: 1. vyberte produkty pomocí checkboxů (jeden nebo více), 2. aktivují se tlačítka *Schválit* a *Zamítnout*, 3. klikněte na požadovanou akci, 4. změny se projeví po přegenerování projektu. Zamítnuté produkty se na stránce Produkty zobrazí jako „Zamítnutý produkt“. Jejich hodnoty se zobrazují šedě a u produktu je dostupné tlačítko *Schválit* pro rychlé povolení exportu. ### Autorizace produktů vs. Skrývací pravidla Autorizace produktů a skrývací pravidla řeší podobný problém – rozhodují o tom, co se exportuje do výstupního feedu. Fungují však zásadně odlišně: **Autorizace produktů** * blokuje pouze **nově importované produkty,** * schválení nebo zamítnutí provád**í vždy uživatel ručně,** * nezávisí na elementech produktu ani na jeho hodnotách. **Skrývací pravidlo** * skrývá produkty **na základě podmínek** (např. cena, marže, dostupnost), * výběr se vyhodnocuje při každém přegenerování, * produkty se mohou automaticky odkrýt, pokud přestanou splňovat podmínku. Zjednodušeně tedy: * autorizace skryje **všechny nové produkty**, * skrývací pravidlo skryje **produkty splňující podmínku**. ### **Exportní chování ve vztahu k autorizaci a pravidlům** Produkt **nebude exportován**, pokud: * je ve stavu *Čeká na schválení* nebo *Zamítnuto*, a není skrytý pravidlem, * je ve stavu *Schválený*, ale je skrytý pravidlem, * je ve stavu *Čeká na schválení* nebo *Zamítnuto* a zároveň je skrytý pravidlem. Produkt **bude exportován**, pokud: * je ve stavu *Schválený* a **není** skrytý žádným pravidlem. ## **Shrnutí** Autorizace produktů zajišťuje, že nové produkty se do výstupního feedu dostanou až po ručním schválení. Uživatel tak má plnou kontrolu nad tím, které položky se mohou začít inzerovat. Funkci lze zapnout v novém i existujícím projektu a snadno kombinovat se skrývacími pravidly. Autorizace je ideální pro případy, kdy potřebujete zabránit automatickému publikování nového sortimentu. ## **FAQ** 1\. **Co je účelem autorizace produktů?** Autorizace slouží k ručnímu řízení toho, které produkty se exportují do výstupního feedu. Nové produkty se exportují až po schválení uživatelem. **2\. Kde mohu autorizaci produktů zapnout?** Buď při vytváření nového projektu v kroku Rekapitulace, nebo v existujícím projektu v sekci Nastavení → Obecná nastavení projektu. **3\. Co se stane s produkty, pokud funkci zapnu u již existujícího projektu?** Všechny stávající produkty se nastaví jako schválené. Nově importované produkty budou ve stavu Čeká na schválení. **4\. Jak poznám stav autorizace u jednotlivých produktů?** Ve speciální sekci Autorizace produktů najdete přehled se stavem Schváleno, Zamítnuto nebo Čeká na schválení. **5\. Jak schválím nebo zamítnu více produktů najednou?** Produkty označíte pomocí checkboxů a poté kliknete na tlačítko Schválit nebo Zamítnout. Změny se projeví po přegenerování projektu. **6\. Co se stane s produktem, který je zamítnutý?** Produkt nebude exportován a v seznamu produktů se zobrazí jako zamítnutý. Lze jej kdykoli ručně schválit. **7\. Lze kombinovat autorizaci produktů a skrývací pravidla?** Ano. Autorizace řeší pouze stav schválení produktu, zatímco skrývací pravidla pracují s hodnotami v produktových elementech. Obě funkce mohou fungovat současně. **8\. Jaký je hlavní rozdíl mezi autorizací a pravidlem Skrýt produkt?** Autorizace skrývá všechny nové produkty bez ohledu na jejich vlastnosti. Skrývací pravidlo skrývá produkty na základě podmínek a může je automaticky odkrývat. **9\. Může být produkt schválený a přesto se neexportuje?** Ano. Pokud je schválený, ale zároveň spadá do skrývacího pravidla, do výstupního feedu se nedostane. **10\. Jak zjistím, proč se produkt neexportuje?** Zkontrolujte jeho stav autorizace a zároveň ověřte, zda není skrytý skrývacím pravidlem. Obě podmínky mohou export blokovat. **11\. Je nutné po schválení produktů vždy přegenerovat projekt?** Ano. Schválení nebo zamítnutí se projeví až po přegenerování výstupního feedu. **12\. Mohu autorizaci produktů později vypnout?** Ano. Lze ji vypnout v nastavení projektu. Po vypnutí je potřeba projekt přegenerovat, aby se změna projevila. --- # **6\. Export a práce s daty mimo Mergado** Tato sekce popisuje způsoby, jak **exportovat produktová data** z Mergada do externích souborů. Export můžete použít buď **jednorázově** pro rychlou kontrolu dat, nebo si vytvořit **nový trvalý výstupní feed** dostupný přes URL adresu. ## **Export do CSV (jednorázový soubor)** Pokud potřebujete zkontrolovat data mimo Mergado nebo vytvořit jednoduchý report, můžete si produkty stáhnout jako **CSV soubor** přímo ze stránky *Produkty*. Tento export je vhodný pro ruční kontrolu, analýzy či import do jiných nástrojů (např. Excel, Google Sheets) a můžete si plně přizpůsobit co do CSV chcete exportovat. ### **Jak exportovat data z tabulky** Jednorázový export se provádí ze zobrazení **Tabulka**. 1. Na stránce Produkty pomocí filtru nastavte, které produkty chcete exportovat (např. všechny nebo jen uložený výběr). 2. V zobrazení Tabulka vyberte, které sloupce (elementy) chcete zahrnout. 3. Klikněte na *Stáhnout CSV* a vyberte typ exportu: 1. Vstupní elementy 2. Výstupní elementy 3. Výstupní elementy včetně skrytých 4. **Sloupce z tabulky (doporučeno – exportuje přesně to, co vidíte)** 4. CSV soubor se stáhne do počítače a můžete jej otevřít v tabulkovém editoru. ⚠️ **Upozornění:** Pokud váš projekt, resp. tabulka obsahuje **velké množství produktů**, může se export z tabulky nedokončit. V takovém případě doporučujeme vytvořit export jako **nový projekt** (viz níže). ### **Volba sloupců a pořadí** Před exportem si můžete přizpůsobit, které **elementy (sloupce)** budou v CSV obsažené: * Můžete si vybrat z už existujících nastavení, např.: *Párování, Bidding*, kde jsou předchystané elementy. * Pokud vám předchystané nevyhovují, zvolte možnost *Vlastní,* kde máte možnost zvolit libovolné sloupce. * Pomocí **funkce „drag & drop“** můžete měnit jejich pořadí. * Klikněte na možnost “**Stáhnout CSV”** a následně vyberte z možností **“Vybrané sloupce”** * Do CSV se exportují právě ty sloupce, které jsou v aktuálním zobrazení viditelné. ### **Export jen části produktů** Pokud nepotřebujete exportovat celý feed, můžete zvolit, že se do CSV stáhnou pouze **produkty z konkrétního uloženého výběru**. Tím získáte přehled jen nad částí sortimentu, která vás zajímá (např. *produkty bez EANu*, *produkty v akci* apod.). ## **Export do nového projektu (CSV na URL)** Pokud chcete, aby bylo CSV dostupné **trvale přes URL adresu**, můžete vytvořit **nový projekt**, který bude generovat výstupní feed ve formátu CSV. ### **Jak vytvořit výstupní projekt** 1. Vytvořte **nový projekt** v Mergadu. 2. Jako zdroj dat vložte váš produktový feed a vyberte správný vstupní formát. 3. Jako výstupní formát nastavte **Plain CSV**. Tímto způsobem se vytvoří projekt, který pravidelně generuje aktuální CSV feed dostupný přes URL – ideální například pro automatické zpracování dat nebo sdílení s partnery. ### **Nastavení formátu a oddělovače** Při tvorbě CSV projektu můžete určit, **jaký oddělovač** se použije (např. čárka nebo středník ). Do nového CSV se načtou **všechny elementy** z původního feedu, které pak můžete upravit a přizpůsobit podle potřeby. ### **Výběr a skrytí elementů** Aby byl váš CSV výstup přehledný, můžete zvolit, **které elementy (sloupce)** se mají ve výsledném feedu zobrazovat. Postup: 1. Na stránce **Elementy** vyberte jeden či více elementů, které V CSV nechcete. 2. Zaškrtněte volbu **„Skrýt“**. 3. Po přegenerování feedu se vybrané elementy v CSV **neobjeví**. 4. Pomocí funkce **Seřadit** můžete přizpůsobit i **pořadí sloupců** a udržet export přehledný. Takto vytvořený CSV feed obsahuje pouze relevantní data a může sloužit jako vstupní zdroj pro další systémy (např. reporting, skladové systémy, BI nástroje apod.). ## **Shrnutí** Mergado nabízí dva hlavní způsoby exportu dat: * **Jednorázový export do CSV** – ideální pro rychlou kontrolu dat, práci v Excelu nebo příležitostnou analýzu. * **Export do nového projektu (CSV na URL)** – vhodný pro trvalé a automatizované zpracování dat mimo Mergado. Pomocí přizpůsobení sloupců, skrývání elementů a nastavení formátu můžete snadno získat přesně takový CSV výstup, jaký potřebujete. ## **FAQ** **1\. Jaký je rozdíl mezi jednorázovým exportem a exportem přes nový projekt?** Jednorázový export stáhne CSV přímo z tabulky a slouží pro rychlou kontrolu nebo analýzu dat. Export přes nový projekt vytváří trvalý CSV feed dostupný na URL, vhodný pro automatizace a pravidelnou aktualizaci dat. **2\. Co mám dělat, když se jednorázový export nedokončí?** Pravděpodobně pracujete s velkým množstvím produktů. V takovém případě doporučujeme vytvořit nový výstupní projekt s formátem CSV, který export zvládne i u velmi rozsáhlých feedů. **3\. Jak ovlivním, které sloupce se v CSV objeví?** V zobrazení Tabulka si vyberte zobrazené sloupce a nastavte jejich pořadí. Pokud použijete export typu „Sloupce z tabulky“, CSV bude obsahovat přesně to, co vidíte a co jste nastavili. **4\. Lze exportovat jen určitou skupinu produktů?** Ano. Stačí v horním filtru načíst uložený výběr nebo vytvořit nový a poté CSV stáhnout. Exportovaný soubor bude obsahovat pouze produkty z daného výběru. **5\. Jak skryji z CSV sloupce, které nechci exportovat?** Na stránce Elementy zaškrtněte u elementu volbu „Skrýt“. Po přegenerování projektu se tyto elementy ve výstupním CSV feedu neobjeví. **6\. Kde nastavím oddělovač pro CSV výstup?** Oddělovač se nastavuje při vytváření nového projektu, pokud jako výstupní formát zvolíte Plain CSV. Můžete si vybrat například čárku nebo středník. **7\. Aktualizuje se CSV feed automaticky?** Ano. CSV výstup vzniklý prostřednictvím nového projektu se aktualizuje při každém přegenerování dat, stejně jako jakýkoli jiný výstupní feed v Mergadu. **8\. Obsahuje výstupní CSV všechny elementy z feedu?** Ano, výstupní CSV obsahuje všechny elementy vstupního feedu, pokud si je sami neskryjete na stránce Elementy. **9\. Mohu CSV výstup použít jako vstup pro jiný Mergado projekt?** Ano. CSV feed dostupný na URL lze použít jako vstupní datový zdroj pro další projekty nebo automatizace. **10\. Zůstávají produkty v exportu vždy ve stejném pořadí?** Pořadí sloupců si určujete pomocí nastavení pořadí elementů. Pořadí řádků odpovídá pořadí produktů generovaných ve feedu – Mergado jej negarantuje jako stabilní, pokud se mění samotný vstupní feed a uživatel ho nemůže změnit. --- ## [Jak funguje Mergado a kdo jej nastavuje?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/co-je-mergado-a-jak-funguje/jak-funguje-mergado-a-kdo-jej-nastavuje/) # Jak funguje Mergado a kdo jej nastavuje? ### Co je Mergado a jak mi pomůže Mergado je webová aplikace pro správu a úpravu produktových dat určená zejména pro e-shopy a digitální agentury. Můžete si jej představit třeba jako chytrého pomocníka mezi vaším e-shopem a reklamními platformami (např. Heurekou, Zboží.cz, Googlem nebo Facebookem). Když posíláte data o produktech ze svého e-shopu (např. ze Shoptetu, Shopify nebo WooCommerce), Mergado vám umožní tato data hromadně upravit, doplnit nebo přizpůsobit přesně tak, jak to jednotlivé reklamní kanály vyžadují. Můžete například: * segmentovat produkty, * hromadně přidat do názvů produktů značku, * doplnit chybějící parametry, * párovat kategorie, * skrýt vybrané produkty, * hromadně upravit produktové obrázky podle požadavků jednotlivých reklamních platforem, * vytvořit několik různých verzí produktového feedu pro různé inzertní kanály. Možnosti úprav jsou téměř nekonečné a je jen na vás, jak si svá data vylepšíte. Díky tomu se vaše produkty zobrazí správně, s kompletními informacemi a často i lépe zacíleně – což se v praxi projeví vyšším výkonem kampaní a menším počtem chyb v inzerci. Navíc vám ušetří obrovské množství času. Představte si, kolik času byste strávili třeba ručním přeceňováním produktů, pokud máte ve svém e-shopu tisíce položek. A jak dlouho by vám trvalo upravit stovky produktových obrázků přesně na požadované rozměry Googlu, když na e-shop přidáváte nové zboží. ### Kdo nastavuje Mergado Mergado vám práci s vašimi produktovými daty obrovsky ulehčí, ale je důležité vědět, že to není kouzelný nástroj, který všechno udělá a zařídí sám. Každý e-shopař má své vlastní strategie a chce dosáhnout odlišných cílů a to za vás Mergado nevymyslí. Pořád potřebuje svého dirigenta. Je tedy nutné, abyste v Mergadu sami prostřednictvím tzv. pravidel nastavili, co se má s vašimi daty dít a je také potřeba data v čase dále ladit a upravovat. Výhodou však je, že stačí pravidla jednou nastavit a dokud je nezměníte nebo nezrušíte, Mergado je bude automaticky a hromadně aplikovat na stovky nebo tisíce vašich produktů. ### Jaké znalosti je potřeba mít pro práci s Mergadem Mergado je takzvaný no-code nástroj, tedy nástroj, který vám umožní upravovat své produktové feedy i bez znalosti kódování. Práce v Mergadu je přehledná, nemusíte umět programovat a všechno jednoduše nastavíte klikáním – přes pravidla, filtry a jednoduché formuláře. Většinu pravidel zvládnete nastavit podle našich návodů nebo s pomocí naší podpory. ### Kdo s Mergadem nejčastěji pracuje V praxi obvykle s Mergadem pracují zaměstnanci marketingových oddělení e-shopů. Pokud e-shop spolupracuje s externí marketingovou agenturou (nebo freelancerem), často právě agentura přebírá zodpovědnost za nastavení feedů přes Mergado. Mergado také s některými agenturami a freelancery spolupracuje a po absolvování potřebných kurzů, školení a praxe se z nich stávají tzv. certifikovaní partneři – specialisté, kteří vám odborně pomůžou v případě, že chcete správu svých produktových feedů přenechat externí agentuře. Seznam našich certifikovaných partnerů najdete [tady](https://www.mergado.cz/certifikovani-partneri). ### Jak probíhá napojení a nastavení Mergada #### 1. Napojení zdroje produktových dat a volba výstupního formátu V Mergadu si vytvoříte uživatelský účet a připojíte váš existující produktový feed nebo využijete napojení skrze integraci. Rovnou si také zvolíte, na jakou platformu mají být vaše data, která upravíte v Mergadu, odesílána (např. Heureka, Kaufland Marketplaces, ChatGPT, Facebook). Návod, jak vytvořit svůj první projekt a napojit zdroj svých produktových dat, najdete [tady](https://forum.mergado.cz/t/jak-v-mergadu-vytvorit-novy-projekt/jak-v-mergadu-vytvorit-novy-projekt). #### 2. Audit / kontrola kvality dat Pokud při napojování zdroje dat zvolíte tuto možnost, Mergado zdarma provede kontrolu (audit) vašich dat. [Mergado Audit](https://audit.mergado.com/) upozorní na technické chyby nebo nedostatky a rovnu vám doporučí, jak je vyřešit. #### 3. Definice pravidel, filtrů a úprav Nastavíte si, jaké změny se mají provádět – např. změna názvů, doplnění chybějících elementů, přepočty cen, filtrování produktů, mapování kategorií apod. Toto je klíčový krok, který Mergado neudělá samo. Nastavení pravidel a cenových nebo jiných strategií musí být navrženo a potvrzeno člověkem. #### 4. Automatizace / plánování aktualizací Mergado vám umožní nastavit si pravidelné přepočty, automatické spouštění úprav a odesílání dat do cílových platforem, načasování procesů apod. Samotný režim a frekvenci těchto procesů opět nastavuje uživatel. #### 5. Monitoring, ladění a údržba Po spuštění je potřeba průběžně sledovat, zda inzerce na cílové platformě odpovídá očekávání a cílům, které jste si nastavili, zda nedochází k chybám nebo nežádoucím filtracím, a na základě dat ladit stávající pravidla nebo přidávat nová. ### Jaké výhody a usnadnění mi Mergado přinese I když se může zdát, že data, která proudí přímo z vaší e-shopové platformy do inzertních kanálů, šlapou tak, jak mají, Mergado vám umožní jít ještě o několik kroků dál: * lépe přizpůsobíte data požadavkům jednotlivých inzertních kanálů, * získáte kontrolu nad tím, co přesně se do inzerce posílá, * snadno si vytvoříte různé produktové feedy pro různé trhy, * budete mít přehled o případných chybách a získáte doporučení na úpravy, * inzerci budete moct řídit z jednoho místa, * pomocí hromadných úprav a aplikací pravidel na stovky/tisíce produktů výrazně zredukujete ruční práci, * nemusíte kvůli běžným změnám zapojovat programátora, * s Mergadem zvládne pracovat v podstatě kdokoliv, ne jen vývojáři, * Mergado podporuje napojení na více než 650 formátů a kanálů, takže expanze či změna platformy je výrazně snazší, * k dispozici je vám [bezplatný support](https://www.mergado.cz/kontakt) a mnoho [školení](https://www.mergado.cz/skoleni) zdarma, kde si můžete doplnit znalosti, * v [Mergado Fóru](https://forum.mergado.cz/) najdete informace, návody, nápovědy, můžete se na cokoliv ptát a vyměňovat si zkušenosti s jinými uživateli. Mergado vám zkrátka pomůže dostat z vašich dat maximum. ### Mýty vs. realita při práci s Mergadem |Mýtus|Skutečnost| | --- | --- | |„Stačí pouze napojit produktový feed a Mergado se postará o zbytek.“|Napojení zdrojových dat je jen vstupní krok. Proces úprav a nastavování pravidel musí být definován uživatelem. Strategii a cíle je potřeba stanovit si sám.| |„Jakmile je jednou nastaveno, už nemusím nic řešit.“|Situace na trzích se mění, váš sortiment se obměňuje, inzertní kanály mají nová pravidla. To vše si vyžaduje pravidelnou údržbu a úpravu pravidel.| |„Support Mergada pro mě inzerci nastaví.“|Support je odborná pomoc a rádi s vámi cokoliv zkonzultují a poradí vám s postupem. Nastavit pravidla inzerce a dále je spravovat už však musíte vy, podle svých vlastních strategií a cílů. Nicméně Mergado vám procesy výrazně usnadní a ušetří vám spoustu času.| ### Kde najdu pomoc, když si s něčím nevím rady #### 1. Technický support Pokud si nevíte rady s nastavením Mergada, napište nám na mergado@mergado.cz nebo zavolejte na +420 530 513 050. Naše [technická podpora](https://www.mergado.cz/kontakt) je vám zdarma k dispozici v pracovní dny od 9:00 do 16:00. Pomůžeme vám pochopit, jak Mergado nastavit, vysvětlíme funkce a navedeme vás správným směrem. #### 2. Onboarding zdarma Jste v Mergadu noví? Domluvte si s námi jednorázovou bezplatnou hodinovou schůzku, během které vám ukážeme, jak Mergado funguje, a společně projdeme základní nastavení. Pokud už základy ovládáte podle našich návodů, můžete onboarding využít i jinak, například k doladění konkrétního problému nebo konzultaci vašeho nastavení. #### 3. Bezplatné webináře Chcete se v Mergadu zlepšit? Přihlaste se na naše webináře zdarma. Ukážeme vám praktické postupy, které zvládnete sami, a získáte jistotu při práci s Mergadem. Aktuální termíny a školení najdete [tady](https://www.mergado.cz/skoleni). #### 4. Mergado Fórum Máte konkrétní otázku nebo se chcete poradit s ostatními uživateli? Navštivte[ Mergado Fórum](https://forum.mergado.cz/), kde najdete praktické návody, tipy i diskuze s komunitou zkušených marketérů. Doporučujeme začít v sekci[ Nápověda](https://forum.mergado.cz/c/napoveda/88), kde najdete přehledné články a postupy krok za krokem. #### 5. Certifikovaní partneři Pokud nechcete nastavovat Mergado sami nebo potřebujete odbornou správu svých produktových dat, navažte spolupráci s našimi certifikovanými partnery. Jsou to specialisté, kteří prošli školením, mají ověřenou praxi a pomohou vám s nastavením, optimalizací i správou inzerce. Seznam certifikovaných partnerů najdete [tady](https://www.mergado.cz/certifikovani-partneri). #### 6. Další zdroje Mergado má dlouhou historii a velkou komunitu, takže většinu otázek už někdo řešil před vámi. Kromě fóra a nápovědy doporučujeme navštívit také[ blog Mergada](https://www.mergado.cz/blog), kde najdete desítky článků, návodů a případových studií z praxe – od základů práce v Mergadu až po pokročilé tipy pro zlepšení inzerce. Nápovědu najdete také přímo v Mergado Editoru v sekci [Průvodce Mergado Editorem](https://app.mergado.com/guide) nebo [Video nápověda](https://app.mergado.com/guide/video). #### 7. AI pomocníci Pokud potřebujete rychlou radu, můžete využít také AI nástroje, které Mergado dobře znají a často dokáží poradit, jak postupovat krok za krokem. ### Odpovědnost za používání Mergada Používání nástroje Mergado je na vlastní odpovědnost uživatele. Rádi vám poskytneme všeobecné návody, podporu a konzultace, avšak neneseme odpovědnost za případné škody či ztráty, které mohou vzniknout v důsledku nevhodného nastavení feedu, nesprávného použití pravidel nebo chybného exportu. Doporučujeme provádět změny opatrně, testovat výstupy a v případné nejistoty konzultovat s naší podporu nebo externím specialistou. Kompletní Podmínky užívání Mergada si můžete přečíst [tady](https://www.mergado.cz/podminky-uzivani). ## FAQ: Jak funguje Mergado a kdo jej nastavuje? ### Co je Mergado a jak mi pomůže? Mergado je online nástroj, který vám pomůže upravovat a spravovat produktová data z vašeho e-shopu tak, aby perfektně fungovala v reklamních kanálech, například na Heurece, Zboží.cz, Googlu, Facebooku nebo v ChatGPT Shoppingu. Pomocí Mergada můžete třeba hromadně upravovat názvy, popisy nebo ceny produktů, doplňovat chybějící parametry, filtrovat nebo rozdělovat produkty do různých kampaní, vytvářet více verzí feedu pro různé inzertní platformy a mnoho dalšího. Díky tomu budou vaše produkty zobrazovány správně a vaše inzerce bude efektivně zacílená, což zlepší její výkon a ušetříte si spoustu ruční práce. Navíc vše zvládnete bez nutnosti programování, vše nastavíte jednoduše klikáním v přehledném rozhraní. ### K čemu mi bude Mergado, když už posílám feedy do Heureky nebo Zboží.cz přímo z e-shopu? Mergado vám umožní data lépe a snadněji přizpůsobit, rozšířit a spravovat. Díky Mergadu můžete například hromadně upravovat různé parametry nebo produktové obrázky, automaticky biddovat či přeceňovat produkty, filtrovat sortiment nebo vytvářet různé verze feedů pro různé inzertní kanály. To vše uděláte hromadně a bez zásahu do e-shopu. ### Kdo nastavuje Mergado? Vy sami. Mergado je nástroj, který vám dává plnou kontrolu nad tím, co se s vašimi daty děje. Je potřeba si nastavit tzv. pravidla a definovat, jak se mají data upravovat. Mergado poté vše spouští automaticky a hromadně. Pokud nechcete nastavení a správu provádět sami, doporučujeme využít spolupráce s našimi [certifikovanými partnery](https://www.mergado.cz/certifikovani-partneri), kteří vám s inzercí a Mergadem odborně pomůžou. ### Zvládnu pracovat s Mergadem, i když neumím programovat? Ano. Mergado je tzv. no-code nástroj, takže nevyžaduje žádné znalosti kódování a programování. Pravidla a úpravy dat nastavujete klikáním v přehledném rozhraní pomocí jednoduchých formulářů. Navíc máte k dispozici videonávody, fórum s nápovědami i podporu zdarma. Stačí mít jasný cíl a strategii a s Mergadem to zvládnete. ### Můžu používat Mergado, když mi inzerci spravuje agentura? Ano, správu vašeho feedu v Mergadu může zajišťovat i externí agentura nebo specialista, který se stará o vaši inzerci. Stačí jim udělit přístup do vašeho projektu a mohou s daty pracovat stejně, jako byste to dělali vy. Pokud se teprve rozhodujete, komu správu svěřit, doporučujeme vybrat si z našich [certifikovaných partnerů](https://www.mergado.cz/certifikovani-partneri). Jsou to ověření odborníci, kteří prošli školením, mají praktické zkušenosti a s Mergadem pracují denně. ### Co všechno potřebuji, abych mohl/a začít pracovat s Mergadem? Stačí mít produktový feed z vašeho e-shopu a vytvořit si účet v Mergadu. Podrobný návod, jak vytvořit první projekt, najdete [tady](https://forum.mergado.cz/t/jak-v-mergadu-vytvorit-novy-projekt/jak-v-mergadu-vytvorit-novy-projekt). Případně si můžete s naší podporou domluvit úvodní schůzku, kde vás provedeme základy práce s Mergadem. ### Co je Mergado Audit a proč ho použít? [Mergado Audit](https://audit.mergado.com/) je bezplatná kontrola vašeho produktového feedu. Odhalí chyby a nedostatky ve vašich datech a rovnou doporučí, jak je v Mergadu opravit. Audit lze spustit rovnou při tvorbě nového projektu v Mergadu, ale i kdykoliv jindy. ### Musím v Mergadu něco pravidelně dělat? Ano, Mergado potřebuje vaši pravidelnou péči, aby vaše inzerce zůstala aktuální a výkonná. Trhy, sortiment i podmínky inzertních kanálů se mění a drobná údržba vám pomůže udržet výkonnou inzerci, která vám přinese vyšší prodeje. Nemusíte ale trávit hodiny úpravami, většinu věcí zvládnete během několika minut, například jednou týdně nebo při větších změnách v e-shopu. ### Kde najdu návody a pomoc, když si s něčím nevím rady? Máte hned několik možností: * Technický support zdarma – napište na mergado@mergado.cz nebo volejte +420 530 513 050 (Po–Pá, 9:00–16:00). * Onboarding zdarma – hodinová schůzka pro nové uživatele Mergada, kde vám ukážeme základy nebo pomůžeme s konkrétním problémem. * Webináře zdarma – [praktická školení](https://www.mergado.cz/skoleni), díky kterým se naučíte nejen, jak efektivně pracovat s Mergadem, ale také jak lépe porozumět inzerci na různých reklamních platformách. * Mergado Fórum – na [našem fóru](https://forum.mergado.cz/) najdete praktické návody, novinky i zkušenosti ostatních uživatelů. * Blog Mergada – na [blogu](https://www.mergado.cz/blog) najdete stovky článků a případových studií z praxe. * Certifikovaní partneři – pokud chcete správu inzerce a svých produktových dat přenechat externí agentuře, doporučujeme vybrat si z našich [certifikovaných partnerů](https://www.mergado.cz/certifikovani-partneri), kteří mají s Mergadem bohaté zkušenosti. ### Kdo nese odpovědnost za chyby v nastavení? Rádi vám poskytneme podrobné návody, konzultace a podporu, ale do vaší inzerce nezasahujeme. Za správnost a výsledky vašeho nastavení jste odpovědní vy jako uživatel. Doporučujeme proto po úpravách zkontrolovat výstupy (případně změny předem nanečisto testovat) a v případě nejistoty se poradit s naší technickou podporou nebo s agenturou, která vám inzerci pomáhá spravovat. --- ## [Integrace Mergada a Heureky: Jak vám Mergado pomůže s inzercí na Heurece?](https://help.mergado.com/cs/mergado-editor/reklamni-kanaly-a-inzerce/heureka/integrace-mergada-a-heureky-jak-vam-mergado-pomuze-s-inzerci-na-heurece/) # Integrace Mergada a Heureky: Jak vám Mergado pomůže s inzercí na Heurece? Provozujete e-shop a chcete oslovit miliony nakupujících? Pak je pro vás Heureka jedním z klíčových inzertních kanálů. Je totiž nejpoužívanějším vyhledávačem zboží v České republice a na Slovensku. Funguje jako největší cenový srovnávač u nás a také jako marketplace, kde mohou zákazníci nakupovat přímo. Aby se vaše produkty na Heurece zobrazovaly tak, jak mají, je potřeba dodat produktová data ve [správném formátu XML](https://sluzby.heureka.cz/napoveda/xml-feed/#utm_source=chatgpt.com). A právě Mergado vám umožní připravit je pro Heureku přesně podle jejich požadavků a bez nutnosti pokročilého programování. V tomto článku se podíváme na to, jak vám Mergado pomůže s inzercí na Heurece, jaké formáty Mergado podporuje, a jak celý proces integrace Heureky a Mergada provést krok za krokem. ### S čím mi Mergado pomůže Mergado je nástroj, který vám umožní: * jednoduše převést váš feed do formátu Heureky (Heureka.cz i Heureka.sk), ať už jde o převod feedu přímo z vaší e-shopové platformy (např. Shoptet, WooCommerce, Upgates atd.) nebo z jiného formátu feedu (např. Google Nákupy) i bez vývojáře, * zdarma kdykoliv spustit [Audit feedu](https://audit.mergado.com/), který odhalí chyby a rovnou doporučí jejich řešení, * automaticky spárovat vaše zboží se správnými kategoriemi na Heurece, * upravovat feed podle vlastních potřeb, abyste vždy inzerovali jen to, co vám přináší zisk (např. skrýt vyprodané produkty nebo sezónní zboží) * opravovat chyby ve feedu, * automaticky spravovat bidding (ceny za proklik), cenotvorbu nebo produktové obrázky, * analyzovat a neustále vylepšovat svou inzerci. ### Jaké Heureka formáty Mergado podporuje Mergado podporuje kompletní sadu formátů specifikovaných pro Heureku, které jsou klíčové pro správné fungování vaší inzerce: * Heureka – produktový * Heureka – dostupnostní * Heureka – konverzní * Heureka – recenze obchodu * Heureka – recenze produktů #### Heureka produktový XML feed Nejzásadnějším formátem pro vás je Heureka.cz - produktový [CZ], případně Heureka.sk - produktový [SK]. V tomto formátu je nutné Heurece posílat vaše produktová data, žádný jiný formát Heureka nepřijme. Pro převod vašeho formátu feedu do Heureka formátu, stačí při zakládání projektu zvolit odpovídající vstupní (váš formát feedu, Mergado jej v naprosté většině případů samo rozpozná) a jako výstupní formát zvolit Heureka.cz - produktový [CZ], případně Heureka.sk - produktový [SK]. Mergado se automaticky (díky funkci „Převodník“) postará o správnou výstupní strukturu dat, kterou požaduje Heureka. Přečtěte si článek, jak krok za krokem vytvořit [nový projekt](https://forum.mergado.cz/t/jak-v-mergadu-vytvorit-novy-projekt/jak-v-mergadu-vytvorit-novy-projekt). #### Heureka dostupnostní XML feed [Dostupností feed](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed) obsahuje aktuální informace o skladových zásobách a dostupnosti vašich produktů. Povinně jej Heurece zasílat nemusíte, nicméně jeho poskytnutím zaručíte, že Heureka bude vždy správně zobrazovat dostupnost vašeho zboží. Dostupností feed by měla vygenerovat vaše e-shopová platforma, může se ale samozřejmě stát, že jej budete chtít před odesláním do Heureky nějak upravit (například pokud váš dostupnostní feed přesně neodpovídá [požadavkům Heureky](https://sluzby.heureka.cz/napoveda/dostupnostni-feed/)). Pokud váš e-shopový systém tento feed negeneruje, můžete si jej v Mergadu vytvořit. V těchto případech si při tvorbě projektu jako výstupní formát nastavíte Heureka.cz – dostupností [CZ], případně Heureka.sk - dostupnostný [SK]. #### Heureka konverzní / recenze obchodu / recenze produktů XML feed Tyto tři typy formátů feedu naopak generuje z vašich dat sama Heureka. Využijete je především v případě, že budete chtít vaše recenze z Heureky převést do Google Merchant Centra, aby se mohly zobrazovat přímo v inzerci na Googlu. ### Jak napojit výstupní feed z Mergada do Heureky Máte vytvořený projekt, data z vašeho e-shopu proudí do Mergada, zde jste si je upravili podle svých potřeb a Mergado vytvořilo výstupní feed ve formátu pro Heureku. Aby data proudila do Heureky, je potřeba URL výstupního feedu vložit do administrace vašeho Heureka účtu. 1. Ve vybraném projektu v Mergadu přejděte na stránku Přehled a zkopírujte URL výstupního feedu (URL výstupního feedu se nachází v kolonce vpravo nahoře na stránce). 2. Přihlašte se do svého Heureka.cz nebo Heureka.sk účtu a klikněte na Administrace e-shopu. 3. Přejděte na stránku Přehled a klikněte na Upravit obchod. 4. V části Informace o eshopu vložte do kolonky URL XML importu zkopírovanou adresu výstupního feedu z Mergada a změny uložte. ### Proč a jak propojit Heureku a Mergado Keychain Aby vaše inzerce na Heurece byla úspěšná, je potřeba průběžně analyzovat její výkon a na základě vyhodnocení ji upravovat a vylepšovat. Díky stránce Analytika u každého projektu v Mergadu získáte možnost jednoduše sledovat výkon své inzerce skrze přehledné grafy a tabulky. Pro zobrazení analýz je nutné zajistit, aby potřebná data, která nejsou v produktovém feedu (například informace o objednávkách), proudili z vašeho Heureka účtu do Mergada. To zajistíte tak, že propojíte Heureku s Mergadem skrze rozšíření Mergado Keychain. Keychain slouží jako bezpečné úložiště, kde vložíte své přihlašovací údaje do Heureky a Mergado si díky tomu bude automaticky stahovat potřebná data k analýzám. Údaje tak nebudete muset do Mergada vkládat pokaždé, když budete chtít nahlédnout do analytiky. (Přečtěte si více o rozšíření [Mergado Keychain](https://forum.mergado.cz/t/co-je-rozsireni-keychain-a-jak-ho-nastavit/co-je-rozsireni-keychain-a-jak-ho-nastavit).) Data z Heureky se do Analytiky načítají se zpožděním, vždy ráno za předchozí den, a Mergado pracuje s časovým oknem 70 dní. To znamená, že Analytika v Mergadu uchovává a zobrazuje data za posledních 70 dní s tím, že každý den přibudou nová data za předchozí den. Propojení Mergada s vaším Heureka účtem skrze Keychain budete potřebovat také ve chvíli, kdy se rozhodnete používat některá z Mergado [rozšíření](https://store.mergado.com/), která pracují s daty z Heureky (např. [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about), [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about)). #### Jak napojit Heureku přes Mergado Keychain Mergado Keychain je pro uživatele Mergado Editoru zdarma a aktivuje se automaticky při vytváření projektu. Stačí tedy pouze vytvořit spojení s Heurekou. 1. Na [hlavní straně](https://app.mergado.com/) Mergado Editoru klikněte na vybraný e-shop, pro který chcete v Keychainu nastavit propojení s Heurekou. 2. V levé liště uvidíte seznam svých spuštěných rozšíření. Klikněte na Mergado Keychain. 3. V části Spojení vyberte Heureka a klikněte na Vytvořit. 4. Vyplňte přihlašovací údaje a zvolte, zda chce vytvořit spojení pro Heureka.cz nebo Heureka.sk. 5. Potvrďte kliknutím na Přihlásit. *Tip! Pokud si ve svém Heureka účtu změníte přihlašovací údaje (např. heslo), nezapomeňte aktualizovat údaje také v Mergado Keychain, jinak vám bude Keychain hlásit chybu spojení. Jednoduše spojení zrušte a znovu jej vytvořte s novými přihlašovacími údaji.* Stejným způsobem můžete v Mergado Keychain vytvořit spojení se svým účtem v Google Analytics a Mergado Analytika bude pracovat také s těmito daty. Postupujte stejně jako u Heureky, ale pro vytvoření spojení zvolte Google Analytics 4, přihlašte se pomocí Google účtu a odsouhlaste přístup Mergadu k vašim datům. V případě napojení Google Analytics je potřeba počítat s tím, že v Analytice se budou vyskytovat odchylky v číslech způsobené právě kombinací různých zdrojů. Pro ještě podrobnější analytiku můžete přes Mergado Keychain vložit také Mergado Analytické XML, což vám umožní snadno a přehledně sledovat náklady na pořízení zboží nebo vypočítat zisk. Návod, jak si vytvořit XML soubor pro analýzu najdete [tady](https://www.mergado.cz/sites/default/files/users/documents/shopsystems/mergado-xml-analytic-1-1.pdf). Následně stačí v Mergado Keychain vložit v sekci Zdroje URL vytvořeného souboru a kliknout na Uložit. *Tip! Pokud si chcete být jistí, že se nikdo nedostane k tak citlivým údajům, jako jsou vaše náklady na pořízení zboží, povolte přístup k souboru pouze aplikaci Mergado. To bude přistupovat k Mergado Analytickému XML z této IP adresy: 81.31.39.112* *Podívejte se, jaké další [IP adresy Mergado](https://forum.mergado.cz/t/jake-ip-adresy-pouziva-mergado-a-jeho-rozsireni/jake-ip-adresy-pouziva-mergado-a-jeho-rozsireni) používá.* # FAQ: Integrace Mergada a Heureky: Jak vám Mergado pomůže s inzercí na Heurece? ### Co je Heureka a proč na ní inzerovat? Heureka je nejpoužívanější inzertní platforma v Česku a na Slovensku, funguje jako cenový srovnávač i marketplace. Přináší vysoký dosah a je ideální pro e-shopy, které chtějí oslovit miliony nakupujících. ### Jak mi s inzercí na Heurece pomů že Mergado? Mergado vám umožní jednoduše připravit produktová data přesně podle požadavků Heureky bez nutnosti programování. Pomůže s jejich úpravami, párováním kategorií a produktů, biddingem i analýzou výkonu. ### Jaké hlavní výhody získám používáním Mergada? * Převod dat do Heureka formátu (pro českou i slovenskou Heureku) – Mergado převede vaše produktové feedy z různých zdrojů (Shoptet, WooCommerce, Upgates, Google Nákupy aj.) do formátu, který přesně odpovídá požadavkům Heureky. * Audit feedu zdarma – kdykoliv můžete spusti audit vašeho produktového feedu, který odhalí chyby a rovnou navrhne, jak je opravit. * Párování produktů – díky Mergadu snadno upravíte data tak, aby se vaše produkty mohli spárovat s odpovídajícími produktovými kartami na Heurece a byly tak viditelné pro zákazníky. * Hromadné a automatické úpravy feedu – pomocí snadno nastavitelných pravidel můžete automaticky a hromadně upravovat data u tisíců produktů. Např. segmentovat produkty, skrýt vyprodané nebo sezónní zboží, nastavit CPC, přejmenovat kategorie podle stromu kategorií Heureky apod.). * Opravy chyb ve feedu – jednoduše opravíte chyby, které brání inzerci nebo snižují její výkonnost, a to i bez znalosti programování. * Automatická správa biddingu (CPC), cenotvorby a obrázků. * Analytika výkonu a průběžné vylepšování inzerce. ### Jaké Heureka formáty Mergado podporuje? Mergado podporuje kompletní sadu formátů specifických pro Heureku, které jsou klíčové pro správné fungování vaší inzerce. Jedná se například o produktový formát feedu (zásadní pro zobrazení vašich produktů na Heurece), dostupnostní (který Heurece poskytuje data o dostupnosti a skladovosti vašeho zboží) a také formáty feedu, které generuje sama Heureka a využijete je například při převodu recenzí z Heureky do Google Merchant Centra (konverzní, recenze obchodu a recenze produktů). ### Co je Heureka produktový feed a jak ho vytvořím v Mergadu? Je to formát, který přesně odpovídá specifikaci Heureky a zajistí funkčnost inzerce. V Mergadu si vytvoříte projekt, kde jako vstupní feed vložíte URL svého produktového feedu. Jako výstupní feed zvolíte formát Heureka.cz - produktový [CZ], případně Heureka.sk - produktový [SK]. Mergado se postará o to, aby byla vaše data ve výstupní feedu strukturována přesně tak, jak to požaduje Heureka. Zároveň vám Mergado umožní svá data jednoduše, automaticky a hromadně upravovat i bez znalosti programování. ### K čemu slouží Heureka dostupnostní feed? Dostupnostní feed obsahuje data o aktuální skladovosti a dostupnosti vašich produktů. Jedná se o doplňkový feed k vašemu produktovému feedu. Není povinný, ale zajistí správné zobrazení dostupnosti na Heurece. Heureka si jej stahuje každých 10 minut, čímž je zajištěna častá aktualizace dostupnosti a tím se minimalizují prokliky na produkty, které se na Heurece zobrazují jako dostupné, avšak na e-shopu už mohou být vyprodané. Obvykle je možné jej vygenerovat ve vaší e-shopové platformě. Pokud ne, můžete si ho vytvořit nebo upravit v Mergadu, kdy jako výstupní formát feedu zvolíte Heureka.cz - dostupnostní [CZ], případně Heureka.sk - dostupnostný [SK]. ### K čemu slouží Heureka konverzní / recenze obchodu / recenze produktů formáty feedu? Tyto formáty feedu generuje Heureka z vašich dat. Využijete je např. pro přenos recenzí z Heureky do Google Merchant Centra, aby se tyto recenze zobrazovaly přímo v inzerci na Googlu. ### Jak dostanu data z Mergada do Heureky? 1. V projektu v Mergadu přejděte na stránku Přehled a zkopírujte URL výstupního feedu (vpravo nahoře). 2. Přihlaste se do vašeho Heureka účtu a přejděte do Administrace e-shopu. 3. Na stránce Přehled klikněte na Upravit obchod. 4. V sekci Informace o e-shopu vložte do pole URL XML importu adresu výstupního feedu z Mergada a uložte. ### Proč propojovat Heureku s Mergadem přes Keychain? Pokud chcete v Mergadu využívat stránku Analytika a sledovat tak výkonnost vaší inzerce, je potřeba Mergadu umožnit přístup k datům z vašeho Heureka účtu. Jedná se o data, která nejsou obsažena ve vašem produktovém feedu, tedy např. informace o objednávkách. Přístup Mergadu umožníte skrze rozšíření Mergado Keychain, které je pro uživatele Mergado Editoru zdarma a aktivuje se automaticky při vytváření projektu. Stačí do něj uložit vaše přihlašovací údaje do Heureka účtu a Mergado si bude data pro analýzy automaticky stahovat. Přístupové údaje jsou v Keychainu v bezpečí, nedostanou se k nim ani pracovníci technické podpory Mergada. ### Jak můžu analyzovat inzerci na Heurece? V každém projektu v Mergadu na stránce Analytika najdete přehledné grafy a tabulky o výkonu vaší inzerce na Heurece. Aby Mergado mohlo provádět analýzy, je nutné vytvořit spojení s vaším Heureka účtem skrze rozšíření Mergado Keychain. Data z Heureky se načítají se zpožděním, a to následující den ráno za předchozí den. Analytika pracuje s časovým oknem 70 dní. ### Jak propojit Heureku přes Mergado Keychain? Rozšíření Mergado Keychain je pro uživatele Mergado Editoru zdarma a aktivuje se automaticky při založení projektu. 1. Na [hlavní straně](https://app.mergado.com/) Mergado Editoru klikněte na vybraný e-shop, pro který chcete v Keychainu nastavit propojení s Heurekou. 2. Na levé liště uvidíte seznam svých spuštěných rozšíření. Klikněte na Mergado Keychain. 3. V části Spojení vyberte Heureka a klikněte na Vytvořit. 4. Vyplňte přihlašovací údaje a zvolte, zda chce vytvořit spojení pro Heureka.cz nebo Heureka.sk. 5. Potvrďte kliknutím na Přihlásit. ### Co když Keychain hlásí chybu spojení? Nejčastějším důvodem, proč Keychain hlásí chybu spojení, je, že nemá aktuální přihlašovací údaje. Pokud jste si ve svém Heureka účtu změnili heslo nebo přihlašovací e-mail, je nutné aktualizovat údaje i v Keychainu. V Keychainu zrušte stávající spojení a vytvořte nové s aktuálními údaji. ### Proč na stránce Analytika nevidím žádná data z Heureky? Aby mohlo Mergado analyzovat vaše data z Heureky a připravovat přehledné grafy a tabulky, potřebuje mít k těmto datům přístup. Přístup Mergadu umožníte vytvořením spojení v rozšíření Mergado Keychain. Do Keychainu uložíte přihlašovací údaje do vašeho Heureka účtu a Mergado si tak bude moct automaticky stahovat potřebná data pro analytiku. ### Můžu do Analytiky v Mergadu posílat i data z Google Analytics? Ano. Aby však vaše data z Google Analytics proudila do Mergada, je potřeba vytvořit spojení skrze rozšíření Mergado Keychain. Toto rozšíření je pro uživatele Mergado Editoru zdarma a automaticky se aktivuje při vytvoření projektu. 1. Na [hlavní straně](https://app.mergado.com/) Mergado Editoru klikněte na vybraný e-shop, pro který chcete v Keychainu nastavit propojení s Google Analytics. 2. Na levé liště uvidíte seznam svých spuštěných rozšíření. Klikněte na Mergado Keychain. 3. V části Spojení vyberte Google Analytics 4 a klikněte na Vytvořit. 4. Přihlašte se pomocí vašeho Google účtu a odsouhlaste přístup Mergadu k vašim datům. ### Mohu v Analytice sledovat náklady a zisk? Ano, přes rozšíření Mergado Keychain můžete do Mergada vložit Mergado Analytické XML a v Analytice tak sledovat náklady na pořízení zboží nebo zisk. V Keychainu v sekci Zdroje vložte URL Mergado Analytické XML souboru a klikněte na Uložit. ### Můžu Mergado Analytické XML nějak zabezpečit? Dostane se k němu pak Mergado? Ano. Pokud své nákladové XML zabezpečíte tzv. whitelistem IP adres, tedy že k souboru budou mít přístup pouze povolené IP adresy, přidejte na whitelist také Mergado. Mergado bude k souboru přistupovat z IP adresy 81.31.39.112. ### Můžu ve výstupním feedu skrýt vyprodané nebo sezónní produkty? Ano. Pomocí pravidla Skrytí produktu si můžete v Mergadu nastavit, že vybrané produkty budou ve výstupní feedu skryté a na Heurece se nebudou zobrazovat. Díky tomu ušetříte na nákladech za inzerci, protože nebudete inzerovat produkty, které zákazník nemůže nakoupit. ### Pomůže Mergado s párováním do kategorií a produktových karet Heureky? Ano. Mergado Audit vám pomůže odhalit chyby a problémy, které způsobují, že Heureka nedokáže zařadit vaše produkty do odpovídajících produktových kategorií a nezvládne spárovat zboží do správných produktových karet a tudíž vaše produkty zamítá a nezobrazuje je. V Mergado Editoru pak tyto chyby snadno a automatizovaně opravíte. --- ## [Pravidla](https://help.mergado.com/cs/mergado-editor/pravidla/co-jsou-pravidla-v-mergado/pravidla/) # Pravidla # Pravidla V tomto příspěvku se dozvíme: * [Co jsou to pravidla?](https://forum.mergado.cz/t/pravidla/pravidla/4#co-jsou-to-pravidla-2) * [Co vidím na stránce Pravidla?](https://forum.mergado.cz/t/pravidla/pravidla/4#co-vidm-na-strnce-pravidla-3) * [Jak vytvořit nové pravidlo](https://forum.mergado.cz/t/pravidla/pravidla/4#jak-vytvoit-nov-pravidlo-4) * [Seznam pravidel a jejich nejčastější použití](https://forum.mergado.cz/t/pravidla/pravidla/4#seznam-pravidel-5) * [Co je dobré vědět](https://forum.mergado.cz/t/pravidla/pravidla/4#co-je-dobr-vdt-6) * [Shrnutí](https://forum.mergado.cz/t/pravidla/pravidla/4#shrnut-13) # Co jsou to pravidla? Naše chytrá pravidla jsou **jeden z nejdůležitějších [nástrojů](https://forum.mergado.cz/t/co-je-mergado-editor/2486) MERGADO Editoru**. Pomocí konkrétních pravidel, výběrů a elementů upravíte data podle vašich potřeb nebo potřeb zbožových srovnávačů, marketplaces, webů, dodavatelských aplikací nebo dalších platforem. Pravidla dělíme do čtyř skupin: * Pravidla vytvořená Editorem (např. Převod MERGADO XML [CZ] -> Heureka.cz –⁠ produktový [CZ]) * Pravidla aplikací (např. Bidding Fox - INPUT) * Uživatelská pravidla (např. Změna parametru barva) * Pravidlo manuálních změn *Příklady jsou z obrázku níže.* Různé typy pravidel je pak možné měnit. Například pravidla vytvořená MERGADEM nelze kopírovat, můžete je pouze smazat. Naopak uživatelská pravidla můžete vypnout, duplikovat nebo smazat. # Co vidím na stránce Pravidla? **** Stránku *Pravidla* můžeme rozdělit do několika sekcí: 1. **Vyhledávání** Zde můžete vyhledat pravidla dle názvu, konkrétního typu nebo elementu, se kterým pracují. Případně vyhledat pouze aktivní pravidla. 2. **Seznam pravidel** Zde vidíte pravidla, která se neustále aplikují ve vašem projektu. Některá pravidla jsou vytvořena z naší strany nebo ze strany aplikací. 3. **Aplikovat pravidla** Tlačítko které vám umožní změnit data pouze v Editoru. Nepřegeneruje data do výstupního feedu. 4. **Nové pravidlo** Přes toto tlačítko můžete vytvořit nové pravidlo. Pokud už máte pravidlo vytvořené v jiném projektu, můžete jej importovat pomocí možnosti - importovat pravidlo. 5. **Možnosti úprav pravidel** Seřadit –⁠ Umožní seřadit pravidla. Pozor, na pořadí záleží. Viz níže. Vypnout –⁠ Vypne konkrétní pravidlo Upravit –⁠ Dostanete se do editace pravidla Duplikovat –⁠ Zkopíruje pravidlo. Duplikát je pod originálem. Smazat –⁠ Smaže pravidlo Plán –⁠ Naplánuje pravidlo na konkrétní čas # Jak vytvořit nové pravidlo? **** 1. Zadej název 2. Vyber typ pravidla 3. Zvol výběr(y) 4. Vyber element, který se má upravit 5. Zadej nový obsah Pozn. Formulář pravidel se mění podle typu pravidla. Např pravidlo přepsat vypadá jinak než pravidlo datového importu nebo nastavení ceny dopravy. **** # Seznam pravidel **MERGADO nabízí velkou řadu typů pravidel**. Názvy poukazují na to, co vlastně potřebujete s daným elementem či výběrem udělat. Např. Potřebujete skrýt produkt, protože jej dodavatel už nedodává - použiji pravidlo *Skrytí produktu*. Potřebuji nastavit dopravu –⁠ použiji pravidlo *Nastavení ceny dopravy*. TIP: Nové typy pravidel budeme postupně přidávat. Seznam pravidel: * [Přepsat](https://forum.mergado.cz/t/prepsat-prepisovaci-pravidlo/1992) * [Najít a nahradit](https://forum.mergado.cz/t/najit-a-nahradit/1991) * [Skrytí produktu](https://forum.mergado.cz/t/skryti-produktu/1987/2) * [Hromadné přepisování dle výběrů](https://forum.mergado.cz/t/hromadne-prepisovani-dle-vyberu/1988) * [Hromadné přepisování dle hodnot](https://forum.mergado.cz/t/hromadne-prepisovani-dle-hodnot/1989) * [Hromadné zkopírování hodnot](https://forum.mergado.cz/t/hromadne-zkopirovani-hodnot/1982) * [Hromadné přejmenování kategorií](https://forum.mergado.cz/t/hromadne-prejmenovani-kategorii/1990) * [Nastavit parametry produktů](https://forum.mergado.cz/t/prace-s-parametry-v-mergadu-2/2249) * [Nastavení ceny dopravy](https://forum.mergado.cz/t/prace-s-dopravou-v-mergadu-2/2264) * [Zkrácení hodnoty](https://forum.mergado.cz/t/zkraceni-hodnoty/1984) * [Změna velikosti písmen](https://forum.mergado.cz/t/zmena-velikosti-pismen/1983) * [Zaokrouhlit číslo](https://forum.mergado.cz/t/zaokrouhlit-cislo/1985) * [Odstranit diakritiku](https://forum.mergado.cz/t/odstranit-diakritiku/1975) * [Nastavení cen za proklik](https://forum.mergado.cz/t/nastaveni-cen-za-prokliky/1986) * [Nastavit UTM parametry](https://forum.mergado.cz/t/nastavit-utm-parametry/1981) * [Odstranit HTML značky](https://forum.mergado.cz/t/odstranit-html-znacky/1980) * [Výpočet](https://forum.mergado.cz/t/vypocet-vypoctove-pravidlo/1978) * [Import datového souboru](https://forum.mergado.cz/t/import-datoveho-souboru/1974) * [Přidat hodnotu vícenásobného parametru](https://forum.mergado.cz/t/pravidlo-pridat-hodnotu-vicenasobneho-elementu/2155) TIP: Jak jednotlivá pravidla použít naleznete ve vlastních článcích. # Co je dobré vědět? ## [Pořadí](https://forum.mergado.cz/t/poradi-pravidel/1994) **Na pořadí pravidel záleží**. Pravidla se aplikují odshora dolů. U pravidla naleznete číslo, které ukazuje kolikáté je v pořadí aplikace pravidel. Můžete tedy pracovat už i s upravenými daty. ## Aplikace **Aplikace z MERGADO Store vytváří pravidla**. Tato pravidla nemůžete vypnout, editovat ani duplikovat. Můžete je pouze smazat. Pro případ, kdy potřebujete prvně zpracovat data v aplikaci a pak s nimi pracovat až v Editoru, můžete změnit pořadí pravidla dané aplikace. ## Nové pravidlo lze importovat Pravidlo lze i importovat z jiného projektu. Přes tlačítko –⁠ *Importovat pravidlo* v jednoduchém formuláři zvolíte z jakého e-shopu a projektu chcete import provést. Hodí se v případě, že už máte v jiném e-shopu vytvořené sofistikované pravidlo a nechce se vám vytvářet od začátku. **** ## [Aplikace pravidel](https://forum.mergado.cz/t/aplikace-pravidel/1993) **Aplikace pravidel představuje pouze část celého přegenerování dat**. Aplikace změní pouze data v MERGADU. Do výstupního feedu se tato data dostanou až po kompletním přegenerování. Aplikování pravidel je vhodné například pro případy, kdy si potřebujete zkontrolovat nebo otestovat vaše úpravy před samotným vygenerováním do výstupního feedu. ## Aplikování pravidel jen na sledované produkty MERGADO umožňuje také pravidla aplikovat pouze na sledované produkty. Sledování produktu nastavíte v detailu produktu v záložce *Průchod pravidly*. Pokud tak učiníte, můžete přes možnost *Aplikovat pravidla* –⁠ *Aplikovat jen na sledované*, aplikovat pravidla pouze na sledované produkty. **Urychlíte tím proces kontroly či testování** na konkrétním produktu v případě, že váš feed obsahuje velké množství produktů. **** ## [Plánovat pravidlo](https://forum.mergado.cz/t/nova-funkce-planovac-pravidel/1346) Pravidlo můžete také naplánovat. Plánovač pravidel naleznete v sekci Plán u každého pravidla pak máte možnost plánovat pravidla. **Plánovač pravidel umožňuje nastavit časy, kdy se má dané pravidlo aplikovat anebo kdy se má přeskočit.** Můžete tak například nastavit, že pravidlo, které se vztahuje k nějaké časově omezené slevové akci, se bude aplikovat jen v konkrétním rozmezí datumů (např. Black Friday, nebo před Vánocemi), nebo třeba prostě jen přes víkend. **** # Shrnutí * **Co jsou to pravidla?** Pravidlo je nástroj pro úpravu dat. * **Kolik Editor nabízí pravidel?** Mnoho. Každé ke svému konkrétnímu účelu. Stačí se řídit jednoduchou poučkou. Chci něco přepsat –⁠ použiji pravidlo Přepsat, potřebuji upravit údaje ve větším množství nebo pro více hodnot –⁠ zvolím hromadné pravidlo. * **Co dělá aplikace pravidel?** Aplikování pravidel pouze mění data v Editoru. Pro vyexportování dat je potřeba plné přegenerování. * **V jakém pořadí se aplikují pravidla?** Odshora dolů. Pravidla v Mergadu představují způsob, jak na produkty aplikovat **hromadné úpravy**. Jednotlivá pravidla se dají aplikovat na všechny produkty ve vašem feedu, nicméně mnohem častěji jsou pravidla využívána v kombinaci s [výběry](/c/napoveda/produkty-a-vybery-produktu), díky nimž můžete specifikovat, na jaké produkty se má aplikovat které pravidlo. Tip: Pravidlo můžete vytvořit na stránce ***Pravidla*** stisknutím tlačítka **VYTVOŘIT PRAVIDLO** . Tip 2: Podívejte se na **videonápovědu** k práci s pravidly: https://youtu.be/CQ6y5v7UdE8 --- ## [Elementy v Mergadu](https://help.mergado.com/cs/mergado-editor/prace-s-daty/zakladni-prvky/elementy-v-mergadu/) # Elementy v Mergadu # **1\. Co jsou elementy** ## **Definice** **Element** je základní stavební prvek feedu, který nese data. Každý element představuje konkrétní informaci – například název produktu, cenu, kód nebo obrázek. V jazyce XML i CSV funguje element jako **označení místa, kde se daná hodnota nachází**. Zjednodušeně řečeno: * element \= „název informace“, * hodnota \= „obsah této informace“. **Příklad:** \Bid long and prosper – hrnek\ \364.21 CZK\ \47\ V tomto příkladu je: * `` element, * „Bid long and prosper – hrnek“ jeho hodnota. ## **Elementy v různých formátech** ### **Element v XML feedu** V XML souborech je element vše, co se nachází **mezi počátečním a ukončovacím tagem**. Element může obsahovat text, atributy nebo další elementy (tzv. zanoření). XML je hierarchický formát – díky tomu umí popsat i složitější vztahy mezi daty. **Příklad:** \1499\ Element `PRICE_VAT` obsahuje jednu hodnotu – cenu s DPH. ### **Element v CSV feedu** V CSV souborech element odpovídá **jednomu sloupci** v tabulce. Název sloupce představuje element, buňky ve sloupci pak jeho hodnoty. **Příklad:** | PRODUCTNAME | PRICE\_VAT | EAN | | :---- | :---- | :---- | | Hrnek Mergado | 1499 | 8592384021932 | CSV neumí pracovat se zanořením (rodič–potomek), a proto Mergado tuto strukturu **simuluje zápisem typu `rodič | potomek`**. ### **Element v Mergado Editoru** V Mergado Editoru odpovídá každý element **jednomu řádku na stránce *Elementy***. Editor zobrazuje strukturu feedu jako strom – tedy v hierarchii, kde jsou zanořené elementy zobrazeny odsazením. Každý element v Mergadu může být: * **jednoduchý**, pokud má pouze jednu hodnotu, * **vícenásobný**, pokud se opakuje vícekrát (např. více obrázků, více parametrů), * **zanořený**, pokud je součástí jiného elementu, * nebo **atributový**, pokud doplňuje hlavní hodnotu o další informaci (např. `@id` nebo `@description`). ## **K čemu elementy slouží** Elementy jsou základem pro **přenos, zpracování a úpravu dat** v Mergadu. Pomáhají organizovat data tak, aby bylo možné je: * číst, měnit a exportovat, * převádět mezi formáty (např. Heureka → Google Merchant), * třídit, filtrovat a vyhodnocovat. V praxi s nimi pracujete při: * tvorbě **výběrů produktů**, * nastavování **pravidel**, * práci s **proměnnými a automatizací**, * **řazení** a kontrole dat na stránkách *Produkty* a *Elementy*. ## **Shrnutí** Element je základní jednotka dat ve feedu. Mergado s ním zachází jednotně bez ohledu na formát – ať už pochází z XML, CSV nebo z jiného zdroje. Porozumění tomu, jak elementy fungují a jak spolu souvisejí, je klíčové pro efektivní práci s pravidly, výběry i exporty. ## **FAQ – Co jsou elementy** **1\. Co je to element** Element je základní stavební prvek feedu, který nese konkrétní informaci – například název, cenu nebo kód produktu. V XML i CSV formátu představuje označení místa, kde se daná hodnota nachází. **2\. Jaký je rozdíl mezi elementem a hodnotou** Element je název informace (např. `PRICE_VAT`), zatímco hodnota je její obsah (např. `1499`). Společně tvoří pár – název a jeho datový obsah. **3\. Jak element vypadá v XML feedu** V XML je element definován počátečním a ukončovacím tagem. Příklad: * `1499` Zde je `PRICE_VAT` element a `1499` jeho hodnota. **4\. Jak element funguje v CSV feedu** V CSV souboru element odpovídá názvu sloupce. Každá buňka v tomto sloupci představuje hodnotu elementu. Příklad: * `PRICE_VAT` → sloupec s hodnotami 1499, 1599, 1799 atd. **5\. Jak se zanoření zapisuje v CSV, když CSV neumí hierarchii** Mergado zanoření v CSV simuluje pomocí zápisu `rodič | potomek`. Například cesta `PARAM | VAL` představuje hodnotu elementu `VAL` zanořeného pod elementem `PARAM`. **6\. Jak elementy zobrazuje Mergado Editor** V Mergado Editoru je každý element zobrazen jako samostatný řádek na stránce Elementy. Zanořené elementy jsou vizuálně odsazené a tvoří stromovou strukturu, která odpovídá struktuře XML feedu. To platí i pro stránku Produkty v zobrazení typu Elementy. **7\. Jaké druhy elementů Mergado rozlišuje** Mergado pracuje se čtyřmi základními typy: * Jednoduché elementy – mají jednu hodnotu. * Vícenásobné elementy – mohou mít více hodnot. * Zanořené elementy – jsou součástí jiného elementu. * Atributové elementy – doplňují element o další informace (např. `@id`). **8\. K čemu elementy slouží v Mergadu** Elementy jsou základem práce s daty – používají se pro čtení, úpravu, filtrování, export i převody dat. Jsou klíčové při práci s pravidly, výběry, proměnnými a automatizací. **9\. Jsou elementy stejné ve všech formátech** Ano. Mergado s nimi zachází jednotně – bez ohledu na to, zda pocházejí z XML, CSV nebo jiného formátu. **10\. Proč je důležité porozumět elementům** Protože téměř veškerá práce v Mergadu (výběry, pravidla, výpočty, exporty) se na elementech zakládá. Porozumění elementům znamená schopnost přesně řídit úpravy a zpracování dat. --- # **2\. Základy elementů** ## **Typy elementů** Mergado rozlišuje čtyři základní typy elementů. Každý z nich má specifické chování a možnosti použití. ### **1️⃣ Jednoduché elementy** * Mají **jednu hodnotu**. * Jejich pozice (`@@POSITION`) je vždy **rovna 1**. * Při práci s nimi není nutné pozici uvádět. **Příklad:** \47\ Cesta `ITEM_ID` cílí na stejnou hodnotu jako `ITEM_ID { @@POSITION = 1 }`. ### **2️⃣ Vícenásobné elementy** * Obsahují **více hodnot** stejného typu. * Každá hodnota má vlastní **pozici** (1, 2, 3 ...). * Pro cílení na konkrétní hodnotu se používají **podmínky** nebo atributy `@@POSITION` a `@@VALUE`. **Příklad:** \url1.jpg\ \url2.jpg\ Element `IMAGE` má dvě hodnoty – na pozici 1 a 2\. Vícenásobnost se objevuje často například u obrázků, doprav, parametrů nebo kategorií. ### **3️⃣ Zanořené elementy** * Jsou **uvnitř jiného elementu** (tzv. rodiče). * Vytvářejí hierarchickou strukturu dat. * V Mergadu se zanoření zobrazuje odsazením, v cestě k elementu pak pomocí svislé čáry `|`. **Příklad:** \ \Barva\ \Černá\ \ Cesta k hodnotě zní: * PARAM | VAL Tento zápis určuje, že hodnota `VAL` se nachází uvnitř elementu `PARAM`. ### **4️⃣ Atributové elementy** * Atribut je doplňující informace, která rozšiřuje význam elementu. * V XML je uveden v otevíracím tagu a označuje se symbolem `@`. * V Mergadu se atributy používají běžně a zapisují se pomocí cesty s `@`. **Příklad:** \obrazek.jpg\ Cesta k atributu: * IMAGE | @description ## **Jak elementy zobrazit v Mergado Editoru** ### **Stránka *Elementy*** Na stránce *Elementy* najdete kompletní přehled všech elementů v projektu. Zde můžete elementy: * zobrazovat a skrývat (pro výstupní feed), * přidávat, mazat nebo přejmenovávat (u uživatelských elementů), * třídit podle názvu nebo podle struktury, * prohlížet jejich **vstupní a výstupní hodnoty**. Kliknutím na název elementu otevřete detailní přehled všech jeho hodnot. ### **Stránka *Produkty*** Na stránce *Produkty* lze elementy zobrazit dvěma způsoby: * **Zobrazení „Elementy“** – zobrazuje všechny elementy a jejich hodnoty u konkrétního produktu. * **Zobrazení „Tabulka“** – umožňuje vybrat konkrétní elementy a zobrazit je v přehledné tabulce. ### **Nástroj *Cesta k elementu* (Element-Path)** Na stránce *Elementy* i v pravidlech můžete využít nástroj **Cesta k elementu**, který pomáhá s tvorbou správné cesty a kontrolou její validity. Zobrazí vám, kam přesně cesta vede, a usnadní práci s pravidly nebo výběry. ## **Shrnutí** Elementy jsou základní jednotkou, se kterou Mergado pracuje.Rozlišují se podle své funkce (jednoduché, vícenásobné, zanořené, atributové) a jejich pochopení je klíčem k efektivní práci s pravidly, výběry i strukturou feedu. ## **FAQ** **1\. Jaké typy elementů v Mergadu existují** Existují čtyři základní typy: * Jednoduché – mají jednu hodnotu. * Vícenásobné – obsahují více hodnot. * Zanořené – nacházejí se uvnitř jiného elementu. * Atributové – doplňují hodnotu o další informaci. **2\. Co znamená pozice elementu** Každá hodnota elementu má svou pozici (např. první, druhá, třetí hodnota). U jednoduchých elementů je pozice vždy 1, u vícenásobných elementů může být vyšší. **3\. Jak se pracuje s vícenásobnými elementy** Vícenásobné elementy (např. IMAGE) mohou mít více hodnot. Pro práci s nimi se používají podmínky nebo speciální atributy @@POSITION (cílení podle pořadí) a @@VALUE (cílení podle obsahu). **4\. Jak poznám zanořený element** Zanořený element se nachází uvnitř jiného elementu (tzv. rodiče). V cestě k elementu se označuje pomocí svislítka |, například PARAM | VAL. **5\. Jak se zapisují atributy elementů** Atributy se zapisují pomocí zavináče @. Příklad: * \obrazek.jpg\ V Mergadu je cesta k tomuto atributu IMAGE | @description. U některým formátů feedu (např. ceneo) jsou atributy uvedeny i u obalovacího elementu. * \ \Název produktu\ … \ V tomto případě je v Mergadu cesta k tomuto atributu @id, @price, @avail. A pokud chceme v Mergadu vytvořit nový atribut do obalovacího elementu, přidáme ho na stránce Elementy na nový řádek, tedy ne pomocí znaku plus u existujícího elementu. **6\. Kde v Mergadu elementy najdu** Na stránce Elementy v levém menu projektu. Zde můžete elementy zobrazovat, skrývat, přidávat nebo třídit podle struktury. **7\. Jak si zobrazím hodnoty konkrétního elementu** Kliknutím na jeho název na stránce Elementy otevřete přehled všech jeho hodnot – vstupních i výstupních. **8\. Jak se elementy zobrazují na stránce Produkty** Na stránce Produkty můžete zvolit: * zobrazení Elementy – všechny elementy a jejich hodnoty u konkrétního produktu, * zobrazení Tabulka – přehledný výpis vybraných elementů v tabulce. **9\. Co je nástroj Cesta k elementu (Element-Path)** **Element-Path**, neboli Cesta k elementu je jazyk vyvinutý společností Mergado, který slouží k **zapisování cest k elementům a jejich hodnotám**. Pomocí Element-Path určujete, **na které hodnoty ve feedu chcete cílit** – zda je budete číst, nebo do nich zapisovat. Mergado Editor pracuje s elementy stejně jako XML feed – ve stromové struktuře. Aby bylo možné v této struktuře přesně určit, s kterými daty chcete pracovat, je potřeba znát jejich **cestu**. Právě to umožňuje jazyk Element-Path. **10\. Jaký je rozdíl mezi jednoduchým a vícenásobným elementem** Jednoduchý element má jednu hodnotu u všech produktů (např. ITEM\_ID). Vícenásobný element má více hodnot (např. více IMAGE tagů) u jednoho produktu – a s těmito hodnotami je možné pracovat individuálně díky Element-path. # **3\. Zanořenost elementů** ## **Co je zanořenost** **Zanořenost (nebo také vnořenost)** je vlastnost elementu, která určuje jeho umístění v hierarchii XML feedu. Element je považován za zanořený, pokud se v XML nachází **mezi počátečním a ukončovacím tagem jiného elementu**. Zanořenost vytváří strukturu, která pomáhá udržet přehlednost a logické vazby mezi daty. Tento princip má praktický význam – elementy, které jsou do sebe zanořené, spolu obvykle **souvisí a tvoří jeden celek**. S takovou strukturou se setkáte například u parametrů produktů, kategorií nebo dopravců. **Příklad:** \ \Barva\ \Černá\ \ V tomto případě: * `PARAM_NAME` je název parametru, * `VAL` je jeho hodnota, * `PARAM` je nadřazený element, který oba spojuje. Díky této struktuře Mergado rozpozná, že hodnota „Černá“ patří právě k parametru „Barva“. ## **Rodiče, potomci a sourozenci** Zanořené elementy tvoří mezi sebou vztahy, které odpovídají stromové struktuře XML: | Typ vztahu | Popis | | ----- | ----- | | **Rodič (Parent)** | Element, do kterého se jiný element zanořuje. | | **Potomek (Child)** | Element, který je uvnitř jiného elementu. | | **Sourozenci (Siblings)** | Elementy, které mají stejného rodiče. | **Příklad vztahů:** PARAM | PARAM\_NAME PARAM | VAL * `PARAM` je rodič. * `PARAM_NAME` a `VAL` jsou jeho potomci. * `PARAM_NAME` a `VAL` jsou mezi sebou sourozenci. V Mergado Editoru se tento vztah vizuálně projevuje odsazením – potomci jsou na stránkách *Elementy* a *Produkty* vždy posunuti doprava oproti rodiči. ## **Jak Mergado pracuje se zanořenou strukturou** Mergado Editor pracuje s elementy tak, že **přebírá a zobrazuje strukturu XML feedu v její přirozené stromové podobě**. Každý element si zachovává informaci o svém rodiči a potomcích, což umožňuje: * přesně rozlišovat, které hodnoty k sobě patří, * správně zacílit na konkrétní hodnotu (např. `PARAM | VAL`), * vytvářet a spravovat nové zanořené elementy přímo v rozhraní Editoru. Na stránce **Elementy** můžete nové zanořené elementy přidat kliknutím na ikonu „+“ u rodičovského elementu. Takto vytvořený element je prázdný a naplní se až pomocí pravidla (např. *Přepsat*). Pro lepší orientaci si můžete strukturu představit jako složky a soubory: * **rodičovský element** je složka, * **potomek** je soubor nebo podsložka uvnitř ní. Například cesta `PARAM | VAL` znamená, že hodnota `VAL` se nachází uvnitř elementu `PARAM`. ## **CSV a zanořenost** Zanořenost je přirozenou vlastností formátů jako **XML** nebo **JSON**, ale formát **CSV** ji neumí nativně vyjádřit. Proto Mergado zanoření v CSV **simuluje pomocí zápisu `rodič | potomek`**, aby bylo možné s daty pracovat stejným způsobem jako v XML. V praxi to znamená, že v CSV souboru každý sloupec představuje cestu k elementu. Například: PARAM | PARAM\_NAME PARAM | VAL Tento zápis vyjadřuje, že element `VAL` je zanořený pod elementem `PARAM`. Tímto způsobem Mergado dokáže zachovat logické vztahy mezi daty i u formátů, které zanořenost samy o sobě nepodporují. ## **Prakticky: práce se zanořeností v Mergado Editoru** ### **1\. Zápis cesty k zanořenému elementu** Když chcete v pravidle nebo výběru pracovat se zanořeným elementem, zapíšete jeho cestu pomocí svislé čáry `|`. **Příklad:** * PARAM | VAL Tento zápis znamená: „Najděte element `PARAM` a v něm potomka `VAL`.“ Je nutné dodržet mezery před a za svislítkem. * Správně: `PARAM | VAL` * Chybně: `PARAM|VAL` ### **2\. Přesné cílení pomocí podmínky** Pokud má element `PARAM` více hodnot (např. více parametrů), je vhodné doplnit **podmínku** pro přesnější cílení. Podmínky se zapisují do složených závorek `{ }` a filtrují hodnoty podle zadaného kritéria. **Příklad:** * PARAM { PARAM\_NAME \= "Typ displeje" } | VAL Tento zápis říká: „Najděte element `PARAM`, který má potomka `PARAM_NAME` s hodnotou *Typ displeje*, a upravte jeho hodnotu `VAL`.“ Takto cílíte přesně na požadovaný parametr bez ohledu na jeho pozici ve feedu. ## **Rozdíl mezi XML a CSV při zpracování zanořenosti** | Vlastnost | XML feed | CSV feed | Zobrazení v Mergadu | | ----- | ----- | ----- | ----- | | **Zpracování zanořenosti** | Ano, nativně. | Ne, Mergado ji simuluje. | Ano, prostřednictvím stromové struktury. | | **Zobrazení vztahů** | Pomocí tagů a odsazení. | Pomocí názvů sloupců. | Pomocí odsazení na stránkách *Elementy* a *Produkty*. | | **Zápis cesty** | Pomocí tagů. | \`Rodič | Potomek\`. | Zatímco XML vyjadřuje zanoření pomocí značek a vnořených tagů, CSV používá zápis cesty s oddělovačem `|`.Mergado obě struktury sjednocuje a umožňuje s nimi pracovat stejným způsobem. ## **Shrnutí** Zanořenost je základní princip práce s daty v Mergado Editoru. Umožňuje rozpoznat, jak spolu hodnoty jednotlivých elementů souvisí, a díky tomu přesně cílit pravidla i výběry. Správné pochopení zanořenosti je klíčem k efektivní práci s parametry, dopravci, variantami a dalšími vícenásobnými strukturami.Ať už pracujete s XML nebo CSV feedem, Mergado dokáže zanoření zobrazit, zachovat a využít při všech typech úprav. ## **FAQ** **1\. Co je zanořenost elementu** Zanořenost je vlastnost elementu, která určuje, že se **nachází uvnitř jiného elementu**. Tento vztah vytváří hierarchii dat – například element `PARAM` (rodič) může obsahovat názvy a hodnoty parametrů (`PARAM_NAME` a `VAL`), které jsou jeho potomky. Pojmy *zanořený* a *vnořený* znamenají totéž. **2\. K čemu zanořenost slouží** Zanořenost pomáhá udržet **logickou a srozumitelnou strukturu dat**. Díky ní lze jednoznačně přiřadit hodnoty k jejich kontextu – například že parametr „Barva“ má hodnotu „Černá“. Umožňuje tak sjednotit související informace do jedné struktury. **3\. Jaké vztahy se v zanořené struktuře používají** Zanořené elementy mezi sebou tvoří tři typy vztahů: * **Rodič (Parent)** – element, který obsahuje jiné elementy. * **Potomek (Child)** – element, který je uvnitř jiného elementu. * **Sourozenci (Siblings)** – elementy, které mají stejného rodiče. Příklad: v cestě `PARAM | VAL` je `PARAM` rodič a `VAL` jeho potomek. **4\. Jak vypadá zanořený element v XML** V XML se zanoření vyjadřuje vnořenými tagy. Příklad: \ \Barva\ \Černá\ \ Element `PARAM` je rodičovský, `PARAM_NAME` a `VAL` jsou jeho potomci. **5\. Jak Mergado zobrazuje zanořené elementy** Mergado Editor zobrazuje elementy **ve stromové hierarchii**, která odpovídá struktuře XML feedu. Zanořené elementy jsou odsazené zleva vůči svému rodiči. Zanoření můžete vidět například na stránkách *Produkty* a *Elementy*. Nový zanořený element lze vytvořit kliknutím na ikonu „+“ u rodičovského elementu. **6\. Jak se zanoření zapisuje v Element-Path** Zanoření se zapisuje pomocí **svislé čáry `|`** mezi názvy elementů. Příklad: PARAM | VAL Tento zápis znamená, že `VAL` je potomek elementu `PARAM`. Je nutné zachovat mezery před a za svislítkem. * Správně: `PARAM | VAL` * Chybně: `PARAM|VAL`. **7\. Jak se zanoření vyjadřuje v CSV formátu** Formát CSV neumí hierarchii vyjádřit nativně, proto Mergado zanoření **simuluje** pomocí zápisu `rodič | potomek`. Například `PARAM | PARAM_NAME` a `PARAM | VAL` vyjadřují stejný vztah jako ve struktuře XML. **8\. Které typy souborů umí pracovat se zanořeností** Se zanořeností pracují přirozeně formáty **XML** a **JSON**. CSV formát zanoření nativně neumí, ale Mergado Editor mu v tom pomáhá právě pomocí zápisu `rodič | potomek`. **9\. Jaký je maximální počet úrovní zanoření** Na hloubku zanoření neexistuje teoretické omezení. V praxi se Mergado setkalo s až devíti úrovněmi zanoření, například u feedů ve formátu Upgates. **10\. Jak přesně cílit na hodnotu zanořeného elementu** Pro přesné cílení se používá **podmínka v cestě**. Příklad: `PARAM { PARAM_NAME = "Typ displeje" } | VAL` Tento zápis říká: „Najděte element `PARAM`, který má potomka `PARAM_NAME` s hodnotou *Typ displeje*, a pracujte s jeho elementem `VAL`.“ Tento způsob je nejspolehlivější, protože funguje bez ohledu na pořadí elementů ve feedu. **11\. Jak se cílit, když je element vícenásobný i zanořený** Pokud je element vícenásobný (např. `PARAM` se opakuje vícekrát), je nutné použít podmínku. Cesta `PARAM | VAL` bez podmínky cílí na všechny hodnoty, ale přesné cílení zajistí zápis: `PARAM { PARAM_NAME = "Barva" } | VAL` **12\. Proč je cílení přes potomka jistější než pomocí @@POSITION** Cílení přes potomka (např. `PARAM_NAME = "Barva"`) je jistější, protože vybere správnou hodnotu bez ohledu na její pozici v seznamu. Atribut `@@POSITION` se odkazuje pouze na pořadí, takže pokud se pořadí parametrů liší mezi produkty, může vést k chybnému výsledku. **13\. Proč je práce se zanořeností důležitá** Většina komplexních dat, jako jsou parametry, doprava nebo varianty, je zanořená. Správné pochopení zanořenosti umožňuje pracovat s daty přesně, vytvářet spolehlivá pravidla a udržovat feed logicky strukturovaný a přehledný. # **4\. Vícenásobnost elementů** ## **Co znamená vícenásobný element** Vícenásobný element je takový element, u kterého existuje **více hodnot se stejným názvem**. Z pohledu struktury feedu to znamená, že v rámci jednoho produktu se daný element vyskytuje opakovaně – například u obrázků, parametrů nebo variant. Vícenásobnost umožňuje **sjednotit více příbuzných hodnot pod jeden název elementu**, a není tedy nutné vytvářet nové elementy pro každou hodnotu zvlášť. S vícenásobnými elementy se setkáte nejčastěji u: * URL adres obrázků (např. `IMGURL_ALTERNATIVE`), * parametrů produktů (`PARAM`), * dopravy (`DELIVERY`), * kategorií, * variant produktů. **Příklad v XML struktuře:** \url1.jpg\ \url2.jpg\ V tomto případě je element `IMGURL_ALTERNATIVE` vícenásobný, protože má více hodnot. ## **Rozdíl mezi jednoduchým a vícenásobným elementem** | Vlastnost | Jednoduchý element | Vícenásobný element | | ----- | ----- | ----- | | **Počet hodnot** | Pouze jedna hodnota. | Více hodnot se stejným názvem. | | **Pozice hodnoty** | Vždy rovna 1\. | Každá hodnota má vlastní pozici (2, 3 …). | | **Zápis cesty** | Není nutné uvádět pozici. | Pro cílení na konkrétní hodnotu je nutné použít podmínku nebo atribut `@@POSITION`. | | **Příklady** | `ITEM_ID`, `DESCRIPTION`, `PRICE_VAT` | `IMAGE`, `PARAM`, `DELIVERY`, `IMGURL_ALTERNATIVE` | U zanořených struktur (např. `PARAM`) se vícenásobnost vztahuje k rodičovskému elementu. Potomci (typicky `PARAM_NAME` a `VAL`) zůstávají jednoduché, protože v rámci jednoho rodiče mají vždy jen jednu hodnotu. ## **Jak Mergado pracuje s pozicemi** Každá hodnota elementu má své pořadové číslo neboli **pozici** (1, 2, 3 …). Pozici lze využít pro přesné zacílení konkrétní hodnoty v rámci elementu. Pro práci s pozicemi se v Mergadu používá speciální atribut `@@POSITION`. Ten je součástí jazyka **Element-Path** a umožňuje určit, na kterou pozici chcete v elementu mířit. **Příklad:** \url1.jpg\ @@POSITION \= 1 \url2.jpg\ @@POSITION \= 2 \url3.jpg\ @@POSITION \= 3 Pokud chcete pracovat s třetím obrázkem, použijete cestu: * IMAGES | IMAGE { @@POSITION \= 3 } Tento zápis říká: „Pracuji s elementem `IMAGE` na třetí pozici.“ ### **Omezení atributu `@@POSITION`** Atribut `@@POSITION` se odkazuje pouze na pořadí, nikoli na obsah. Pokud se pořadí hodnot liší napříč produkty, stejné pozice nemusí odpovídat stejným informacím. Příklad: * První produkt má parametry 1\. Materiál, 2\. Objem. * Druhý produkt má 1\. Materiál, 2\. Dekor. Cesta `PARAM { @@POSITION = 2 } | VAL` pak u druhého produktu odkáže na *Dekor*, nikoli *Objem*. Bezpečnější je proto cílit podle názvu: * PARAM { PARAM\_NAME \= "Objem" } | VAL ## **Jak pracovat s vícenásobností v Mergado Editoru** ### **Zjištění a použití pozice** 1. Na stránce **Elementy** otevřete daný element a uvidíte všechny jeho hodnoty s jejich pozicemi. 2. V pravidlech nebo výběrech můžete cílit: * podle pozice, např. `IMGURL_ALTERNATIVE { @@POSITION > 1 }`, * nebo podle rozsahu pozic, např. `IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION url1.jpg` `url2.jpg` Element `IMAGE` je vícenásobný, protože se vyskytuje vícekrát a obsahuje více hodnot. **3\. K čemu vícenásobnost slouží** Vícenásobnost umožňuje sjednotit více příbuzných hodnot pod jeden název elementu. Není tedy nutné vytvářet nové elementy pro každou hodnotu zvlášť. Například všechny alternativní obrázky produktu lze zapsat jako opakující se elementy `IMGURL_ALTERNATIVE`. **4\. Které elementy jsou typicky vícenásobné** Vícenásobnost se nejčastěji vyskytuje u elementů, které popisují opakující se vlastnosti produktů, například: * URL adresy obrázků (`IMGURL_ALTERNATIVE`), * parametry produktů (`PARAM`), * dopravu (`DELIVERY`), * kategorie, * varianty produktů. **5\. Jak Mergado pracuje s pozicemi hodnot** Každá hodnota elementu má svou **pozici**, tedy pořadové číslo (1, 2, 3 …). Pozici lze využít pro přesné cílení na konkrétní hodnotu v rámci elementu. K tomu slouží speciální atribut `@@POSITION`. Příklad: `IMAGES | IMAGE { @@POSITION = 3 }` Tento zápis znamená: „Pracuji s elementem `IMAGE` na třetí pozici.“ **6\. Co znamená atribut @@POSITION a jak se používá** `@@POSITION` určuje pořadí hodnoty uvnitř vícenásobného elementu. Používá se v podmínkách pro cílení na konkrétní pozici nebo rozsah pozic. Příklad: `IMGURL_ALTERNATIVE { @@POSITION > 1 }` Tento zápis cílí na všechny alternativní obrázky kromě prvního. Je však třeba mít na paměti, že `@@POSITION` pracuje pouze s pořadím, nikoli s obsahem. Pokud se pořadí liší mezi produkty, může cílit na nesprávnou hodnotu. **7\. Co je atribut @@VALUE a kdy ho použít** `@@VALUE` představuje **obsah hodnoty elementu** a umožňuje cílit podle hodnoty namísto pozice. Používá se zejména u elementů bez potomků, například `CATEGORY` nebo `IMGURL_ALTERNATIVE`. Příklad: `CATEGORY { @@VALUE != "Hračky" }` Tento zápis vybere všechny kategorie kromě „Hračky“. **8\. Jak se cílit na hodnoty vícenásobných elementů v Element-Path** Cílení se provádí pomocí podmínek ve složených závorkách `{ }`. V nich lze používat atributy `@@POSITION`, `@@VALUE` nebo výrazy z jazyka MQL. **Cílení na všechny hodnoty:** `IMAGES | IMAGE` * Zpracuje všechny hodnoty (`url1`, `url2`, `url3` …). **Cílení na konkrétní hodnoty nebo rozsah pozic:** `IMAGES | IMAGE { @@POSITION IN (3;4) }` * Cílí na třetí a čtvrtý obrázek. **9\. Jak zjistit pozice hodnot v Mergado Editoru** Na stránce **Elementy** lze u každého elementu zobrazit všechny jeho hodnoty včetně jejich pozic. Tento přehled pomáhá lépe porozumět struktuře vícenásobných dat a usnadňuje cílení v pravidlech. **10\. Kdy není nutné pozici v cestě uvádět** Pozici není nutné uvádět v těchto případech: * **Jednoduché elementy** – mají vždy jednu hodnotu (pozice \= 1). `ITEM_ID` je ekvivalentní `ITEM_ID { @@POSITION = 1 }`. * **Čtení z vícenásobného elementu bez podmínky** – Mergado automaticky použije první hodnotu. Např. `%PARAM | VAL%` vezme první hodnotu. * **Cílení na všechny hodnoty** – stačí uvést název elementu bez podmínky, např. `IMAGES | IMAGE`. **11\. Jaký je rozdíl mezi cílením podle pozice a podle hodnoty** * `@@POSITION` pracuje s pořadím hodnoty. * `@@VALUE` pracuje s obsahem hodnoty. Pokud se pořadí hodnot v rámci produktů liší, je bezpečnější použít `@@VALUE`, protože cílí přímo na obsah. **12\. Jaký je problém cílení pomocí @@POSITION** `@@POSITION` se odkazuje pouze na pořadí. Pokud mají produkty parametry v jiném pořadí, může cesta zacílit na nesprávnou hodnotu. Bezpečnější je použít cílení podle názvu potomka, například: `PARAM { PARAM_NAME = "Objem" } | VAL` **13\. Jak pracovat s vícenásobnými elementy v pravidlech a výběrech** Práce s vícenásobnými elementy závisí na tom, zda pravidlo z elementu **čte**, nebo do něj **zapisuje**. **Čtení:** * Pokud cesta vede k více hodnotám, Mergado použije první z nich. * Chcete-li číst jinou hodnotu, je nutné cestu upřesnit podmínkou. **Zápis:** * Pokud pravidlo zapisuje do vícenásobného elementu, změna se provede ve všech hodnotách, které odpovídají zadané cestě. * Chcete-li zapisovat pouze do konkrétní hodnoty, je nutné cestu omezit pomocí podmínky. * Pokud podmínka obsahuje operátor `=` nebo spojku `AND`, Mergado vytvoří chybějící strukturu automaticky. **14\. Proč je důležité rozlišovat vícenásobnost** Vícenásobnost určuje, že element může obsahovat více hodnot stejného typu. Porozumění tomuto principu je zásadní pro správné nastavení pravidel, výběrů i přesné cílení na konkrétní data v rámci feedu. --- # **5\. Práce s vícenásobnými elementy v Mergado pravidlech** Vícenásobné elementy se v Mergado Editoru chovají odlišně než elementy jednoduché. Každý produkt může obsahovat více hodnot stejného elementu, a proto je potřeba vědět, jak s nimi pracují pravidla – jak hodnoty čtou, zapisují a jak je správně cílit. ## **Jak pravidla čtou a zapisují vícenásobné hodnoty** Vícenásobný element je takový, který má **více než jednu hodnotu** u jednoho produktu. Pravidla v Mergadu (například *Přepsat*, *Hromadné zkopírování hodnot*, *Výpočet*) mají v takovém případě definované určité výchozí chování. ### **Čtení z elementů a proměnných** Pokud pravidlo čte hodnotu z vícenásobného elementu, jehož cesta vede k více hodnotám, **Mergado automaticky použije pouze první hodnotu**. Toto chování platí, pokud se čte pomocí zápisu se znakem procenta `%` (například `%PARAM | VAL%`). Příklad: \Černá\ \XL\ Pokud pravidlo čte z cesty `PARAM | VAL`, Mergado vezme pouze první hodnotu „Černá“. U jednoduchých elementů (např. `ITEM_ID`) se tato logika nijak neprojevuje, protože existuje vždy jen jedna hodnota. ### **Zapisování do elementů** Pokud pravidlo zapisuje do vícenásobného elementu bez dalšího upřesnění, **Mergado zapíše hodnotu do všech výskytů** daného elementu. Příklad: * Použijete-li v pravidle *Přepsat* cestu `IMGURL_ALTERNATIVE` a zadáte novou hodnotu `novy_obrazek.jpg`, Mergado přepíše všechny existující hodnoty tohoto elementu. Chcete-li zapisovat pouze do konkrétní hodnoty, je nutné cestu **upřesnit pomocí podmínek**. Například cesta * PARAM { PARAM\_NAME \= "Barva" } | VAL zapíše hodnotu pouze do parametrů „Barva“. Pokud se v jednom produktu parametr „Barva“ vyskytuje vícekrát, změna se provede u všech těchto výskytů. ## **Kdy použít podmínku a kdy speciální atribut** Pro přesné cílení na konkrétní hodnotu vícenásobného elementu je potřeba doplnit **podmínku**. Podmínky fungují jako filtr – určují, na které hodnoty nebo pozice se pravidlo aplikuje. Zapisují se do složených závorek `{ }` a mohou obsahovat buď **zanořený element**, nebo **speciální atribut**. ### **1\. Použití zanořeného elementu v podmínce** Tento způsob je **nejspolehlivější**, protože cílí na hodnotu podle jejího obsahu, nikoli podle pořadí. Příklad: Chceme přepsat hodnotu elementu `VAL`, která patří k parametru „Barva“: * PARAM { PARAM\_NAME \= "Barva" } | VAL Tento zápis říká:„Najděte všechny elementy `PARAM`, které mají potomka `PARAM_NAME` s hodnotou *Barva*, a u nich upravte hodnotu elementu `VAL`.“ Tento způsob funguje bez ohledu na pořadí elementů ve feedu a je proto doporučován ve většině případů. ### **2\. Použití speciálního atributu @@POSITION** Atribut `@@POSITION` slouží k cílení na hodnotu podle jejího pořadí. Každá hodnota elementu má svou pozici – první \= 1, druhá \= 2 atd. Příklad: IMGURL\_ALTERNATIVE { @@POSITION \> 1 } Tento zápis cílí na všechny obrázky kromě prvního. **Vhodné použití:** U elementů, kde pořadí hodnot odpovídá významu (např. alternativní obrázky). **Slabina:** Cílení pomocí `@@POSITION` se odkazuje pouze na pozici, nikoli na obsah. Pokud se pořadí hodnot mění napříč produkty, nemusí být výsledek konzistentní. ### **3\. Použití speciálního atributu @@VALUE** Atribut `@@VALUE` odkazuje na skutečnou **hodnotu elementu**, nikoli na jeho pořadí. Je vhodný tam, kde se pořadí mění nebo není podstatné. Příklad: * CATEGORY { @@VALUE \!= "Hračky" } Tento zápis cílí na všechny hodnoty elementu `CATEGORY` kromě „Hračky“. `@@VALUE` se používá především u elementů, které nemají potomky (např. `CATEGORY`, `IMGURL_ALTERNATIVE`). U rodičovských elementů, které samy o sobě nenesou hodnotu (např. `PARAM`), nedává jeho použití smysl. ## **Praktické ukázky cest** Pravidla v Mergadu při práci s elementy (čtení/zápis) používají jazyk **Element-Path**, který umožňuje přesně zacílit na hodnoty, ze kterých chcete číst, nebo do kterých chcete zapisovat. ### **Cílení na hodnotu konkrétního parametru** * PARAM { PARAM\_NAME \= "Barva" } | VAL Tento zápis čte nebo zapisuje hodnotu `VAL` u parametru, jehož název je *Barva*. Mergado to interpretuje následovně: „Najděte element `PARAM`, který má potomka `PARAM_NAME` s hodnotou *Barva*, a upravte hodnotu jeho potomka `VAL`.“ ### **Cílení na hodnotu ve variantách** Cesta může kombinovat více úrovní zanoření a vícenásobnosti. Příklad pro práci s druhou variantou, která obsahuje parametr „Velikost“: * VARIANTS | VARIANT { @@POSITION \= 2 } | PARAMETERS | PARAMETER { NAME \= "Velikost" } | VALUE Tento zápis říká: „Najděte druhou variantu produktu, v níž parametr *Velikost* nese určitou hodnotu, a s touto hodnotou pracujte.“ ## **Přidávání nových hodnot pomocí pravidel** Při zápisu do vícenásobných nebo zanořených elementů platí jedno důležité pravidlo: **Pokud element, na který cílíte, ještě neexistuje, Mergado jej vytvoří.** To znamená, že vše, co je uvedeno v podmínce (např. `PARAM_NAME = "Barva"`) a v cestě s operátorem `=`, se vytvoří automaticky. Příklad přidání nové strukturované hodnoty – tzv. „flagu“: Element: FLAGS | FLAG { CODE \= "action" } | ACTIVE Nová hodnota: 0 Pokud flag s kódem `action` neexistuje, Mergado vytvoří nový `FLAG` (novou pozici) s elementem `CODE = "action"` a přidá k němu element `ACTIVE` s hodnotou 0\. Tento mechanismus se používá při přidávání nových variant, dopravců, parametrů či dalších strukturovaných dat. --- ## **5.5 Přehled pravidel, kterých se vícenásobnost týká** Popisované chování čtení a zápisu vícenásobných hodnot se týká těchto pravidel: | Pravidlo | Umí číst | Zapisuje | | :---- | :---- | :---- | | [Přepsat](https://forum.mergado.cz/t/prepsat-prepisovaci-pravidlo/) | ![:white\_check\_mark:][image1] | ![:white\_check\_mark:][image2] | | [Najít a nahradit](https://forum.mergado.cz/t/najit-a-nahradit/) | ![:white\_check\_mark:][image3] | ![:white\_check\_mark:][image4] | | [Hromadné přepisování dle výběrů](https://forum.mergado.cz/t/hromadne-prepisovani-dle-vyberu/) | ![:white\_check\_mark:][image5] | ![:white\_check\_mark:][image6] | | [Hromadné přepisování dle hodnot](https://forum.mergado.cz/t/hromadne-prepisovani-dle-hodnot/) | ![:white\_check\_mark:][image7] | ![:white\_check\_mark:][image8] | | [Hromadné zkopírování hodnot](https://forum.mergado.cz/t/hromadne-zkopirovani-hodnot/) | ![:white\_check\_mark:][image9] (Zdrojový element) | ![:white\_check\_mark:][image10] | | [Nastavit parametry produktů](https://forum.mergado.cz/t/nastavit-parametry-produktu/) | ![:white\_check\_mark:][image11] | ![:x:][image12] | | [Nastavení ceny dopravy](https://forum.mergado.cz/t/nastaveni-ceny-dopravy/) | ![:white\_check\_mark:][image13] | ![:x:][image14] | | [Nastavit UTM parametry](https://forum.mergado.cz/t/nastavit-utm-parametry/) | ![:white\_check\_mark:][image15] | ![:x:][image16] | | [Výpočet](https://forum.mergado.cz/t/vypocet-vypoctove-pravidlo/) | ![:white\_check\_mark:][image17] | ![:white\_check\_mark:][image18] | | [Import datového souboru](https://forum.mergado.cz/t/import-datoveho-souboru/) | ![:x:][image19] | ![:white\_check\_mark:][image20] | ### **Shrnutí** Při práci s vícenásobnými elementy v pravidlech Mergado Editoru je nejdůležitější **vědět, s jakou hodnotou pracujete**. Bez upřesnění pravidlo vždy čte první hodnotu a zapisuje do všech odpovídajících hodnot. Pomocí podmínek, speciálních atributů `@@POSITION` a `@@VALUE` nebo kombinace více zanořených úrovní můžete přesně určit, co pravidlo upravuje. Správně napsaná cesta k elementu vám zajistí, že se úpravy provedou přesně tam, kde mají – a zůstanou bezpečné i v případě, že se struktura feedu v čase mění. ## **FAQ** **1\. Jaký je základní princip práce pravidel s vícenásobnými elementy** Pravidla v Mergado Editoru pracují s vícenásobnými elementy podle dvou principů – **čtení hodnot** a **zapisování hodnot**. Jednoduché elementy mají vždy jen jednu hodnotu, takže pravidlo s nimi pracuje přímo. Vícenásobné elementy však mohou mít u jednoho produktu více hodnot, a proto je nutné určit, se kterou z nich má pravidlo pracovat. Bez upřesnění pravidla **čtou první hodnotu** a **zapisují do všech hodnot**. **2\. Jak Mergado čte hodnoty z vícenásobných elementů** Pokud cesta vede k více hodnotám, Mergado automaticky použije **pouze první hodnotu**. Toto chování platí u všech pravidel, která čtou hodnotu elementu pomocí zápisu se znakem `%` – například `%PARAM | VAL%`. Příklad: `Černá` `XL` Cesta `PARAM | VAL` vrátí hodnotu „Černá“, protože jde o první výskyt. **3\. Jak Mergado zapisuje do vícenásobných elementů** Pokud pravidlo zapisuje do vícenásobného elementu bez dalšího upřesnění, Mergado zapíše novou hodnotu **do všech jeho výskytů (pozic)**. Chcete-li cílit pouze na konkrétní hodnotu, je nutné cestu upřesnit pomocí podmínky. Příklad: `PARAM { PARAM_NAME = "Barva" } | VAL` Tento zápis upraví hodnotu elementu `VAL` pouze u parametrů „Barva“. Pokud má produkt více parametrů „Barva“, změna se provede u všech těchto výskytů. **4\. Proč je potřeba používat podmínky u vícenásobných elementů** Podmínky fungují jako **filtr**, který určuje, na které hodnoty se pravidlo vztahuje. Bez podmínky by pravidlo zasáhlo všechny hodnoty elementu. Podmínky se zapisují do složených závorek `{ }` a mohou obsahovat buď zanořený element, nebo speciální atribut. **5\. Jak používat zanořený element v podmínce** Cílení pomocí zanořeného elementu je nejspolehlivější, protože se opírá o obsah, nikoliv o pořadí. Příklad: `PARAM { PARAM_NAME = "Barva" } | VAL` Tento zápis znamená: „Najděte element `PARAM`, který má potomka `PARAM_NAME` s hodnotou Barva, a upravte hodnotu jeho potomka `VAL`.“ Tento způsob funguje bez ohledu na pořadí elementů a je doporučovaný v praxi. **6\. Kdy použít atribut @@POSITION** Atribut `@@POSITION` slouží k cílení podle **pořadí hodnoty** v rámci elementu. Každá hodnota má svou pozici – první \= 1, druhá \= 2 atd. Příklad: `IMGURL_ALTERNATIVE { @@POSITION > 1 }` Cílí na všechny obrázky kromě prvního. Používejte jej tam, kde pořadí hodnot odpovídá významu (např. alternativní obrázky). Slabina: `@@POSITION` se odkazuje pouze na pořadí, nikoliv na obsah. Pokud se pořadí hodnot liší mezi produkty, výsledky nemusí být konzistentní. **7\. Kdy použít atribut @@VALUE** Atribut `@@VALUE` odkazuje na **skutečnou hodnotu elementu** a umožňuje cílit podle obsahu místo pořadí. Používá se hlavně u elementů, které nemají potomky (např. `CATEGORY`, `IMGURL_ALTERNATIVE`). Příklad: `CATEGORY { @@VALUE != "Hračky" }` Tento zápis vybere všechny hodnoty elementu `CATEGORY` kromě „Hračky“. `@@VALUE` je vhodný tam, kde se pořadí hodnot může měnit nebo není podstatné. **8\. Jak kombinovat podmínky a speciální atributy** V jedné cestě lze kombinovat více podmínek a atributů. Podmínky mohou obsahovat logické operátory (`AND`, `OR`) nebo dotazy v jazyce MQL. Příklad: `VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = "Velikost" } | VALUE` Znamená: „Najděte druhou variantu produktu, která obsahuje parametr Velikost, a pracujte s jeho hodnotou VALUE.“ **9\. Jak Mergado vytváří nové hodnoty při zápisu** Pokud element, na který cílíte, neexistuje, Mergado jej při zápisu **automaticky vytvoří**. To platí pro všechny podmínky obsahující operátor `=` nebo spojku `AND`. Příklad: `FLAGS | FLAG { CODE = "action" } | ACTIVE` Pokud flag „action“ neexistuje, Mergado vytvoří nový element `FLAG` s potomkem `CODE = "action"` a přidá k němu `ACTIVE` s hodnotou 0\. Tento mechanismus umožňuje automaticky přidávat nové parametry, varianty nebo strukturovaná data. **10\. Jak předejít chybám při práci s vícenásobnými hodnotami** * Ověřte, zda element, s nímž pracujete, skutečně obsahuje více hodnot. * Používejte podmínky `{ }` k přesnému cílení. * Vyhněte se spoléhání na `@@POSITION`, pokud se pořadí hodnot liší mezi produkty. * Před zápisem zkontrolujte, zda cesta neovlivní více hodnot, než je žádoucí. * Využívejte nástroj **Cesta k elementu** pro ověření, kam pravidlo cílí. # **6\. Atributy v elementech** ## **Co jsou atributy** Atribut je **součást elementu**, která **upřesňuje jeho význam nebo vlastnost**. Zatímco element nese samotná data, atribut poskytuje doplňující informaci o těchto datech. Atributy tak fungují jako *rozšíření hodnot* elementu a často pomáhají popsat podrobnosti, které by se jinak do struktury nevešly. ### **Jak se atributy zapisují v XML** V XML je atribut vždy uveden **v otevíracím tagu elementu** a má svůj název a hodnotu. Hodnota atributu musí být **uzavřena v uvozovkách nebo apostrofech**. **Příklad XML zápisu:** \ \Pavlína\ \Nováková\ \ V tomto příkladu je * `person` element, * `gender` je atribut * `female` hodnota atributu. Atribut `gender` tedy upřesňuje informaci o osobě – že jde o ženu. Stejnou informaci je teoreticky možné vyjádřit i jinak, pomocí samostatného zanořeného elementu: \ \female\ \Pavlína\ \Nováková\ \ Oba zápisy jsou správné – liší se pouze strukturou dat. Použití atributů se obvykle volí tam, kde doplňují nebo upřesňují význam hlavního elementu. ## **K čemu atributy slouží** V produktových feedech mají atributy praktický význam – umožňují **přesněji popsat produkt nebo jeho vlastnosti**. Některé reklamní portály nebo e-shopové platformy přímo vyžadují, aby určitá data byla uvedena formou atributů. ### **Příklady využití atributů v různých systémech** * **Ceneo** * Používá atributy pro popis výrobce nebo jiných vlastností, například: * \ \Nike\ \ * **Heureka (Dostupnostní feed)** * Vyžaduje atributy pro doplnění časových údajů: * \2023-04-26 12:00\ * **Shoptet** * Používá atributy například u obrázků: * \https://cdn.myshoptet.com/obrazek.jpg\ * **Google Nákupy** * Nepoužívá rozlišení mezi elementy a atributy, ale všechny označuje jako *atributy* v rámci svého systému. Správné použití atributů v Mergadu vám umožní **splnit požadavky těchto portálů** a zajistit, že váš feed bude přijat bez chyb. ## **Jak s atributy pracovat v Mergado Editoru** Mergado Editor je navržen tak, aby uměl s atributy plnohodnotně pracovat. Atributy jsou jedním ze základních typů elementů a je s nimi možné pracovat v celém prostředí Editoru – v pravidlech, výběrech, proměnných i MQL dotazech. ### **Identifikace atributů** Atributy v Mergadu **poznáte podle zavináče `@` na začátku názvu**. * `@id` – atribut identifikátoru produktu, * `@description` – atribut popisující obrázek, * `@availability` – atribut popisující stav nebo dostupnost. Kromě běžných atributů existují i **speciální atributy**, které začínají dvěma zavináči `@@`. Ty se používají v jazyce *Element-Path* a slouží k přesnému cílení – typicky `@@POSITION` (pozice hodnoty) a `@@VALUE` (hodnota elementu). Tip: Speciální atributy slouží pouze k cílení na hodnoty elementů a běžných atributů v rámci element-path a nikdy se neexportují do samotného feedu, na rozdíl od běžných atributů, které ve feedu najdete. ### **Cílení na atributy pomocí Element-Path** K práci s atributy se používá jazyk **Element-Path**. Cesta k atributu se zapisuje pomocí zavináče `@` před názvem atributu. **Příklad cílení podle atributu:** 1\. V pravidle cílíme na element CODE jedné konkrétní varianty, která v atributu id elementu VARIANT obsahuje hodnotu idvariant3: \ \ \EEQ21\ \unit\ \1\ \1\ \ \ \EEQ22\ \unit2\ \0\ \0\ \ \ Cesta k danému elementu CODE bude vypadat následovně: VARIANTS | VARIANT { @id \~ "idvariant3" } | CODE. 2\. Na stránce Produkty hledáme produkt s výchozí kategorii s atributem @id \= 123: \ \Spotrebice\ \Elektronika\ \ Podmínka pro výběr bude vypadat následovně: CATEGORIES | DEFAULT\_CATEGORY | @id \= "123". ## **Prakticky: vytvoření, přepsání a odstranění atributu** ### **Vytvoření atributu** Atribut lze vytvořit přímo na stránce **Elementy**. 1. Otevřete stránku *Elementy* a zvolte možnost **Nový element**. 2. Zadejte název a zvolte typ **atribut**. 3. Pokud do názvu přidáte zavináč `@`, Editor automaticky rozpozná, že chcete vytvořit atribut. 4. Chcete-li vytvořit zanořený atribut, použijte ikonu „+“ u rodičovského elementu a zvolte typ *atribut*. Po vytvoření je atribut prázdný (nemá hodnoty). Naplníte ho například pomocí pravidla *Přepsat*. ### **Přepsání hodnoty atributu** Atributy lze upravovat stejně jako běžné elementy – například pravidlem *Přepsat*. **Cílení:** V poli *Element* uveďte cestu k atributu, např.: IMAGE | @description SHOPITEM | @id PARAM { @@VALUE \= "Barva" } | @lang **Postup:** Na stránce *Pravidla* vytvořte nové pravidlo typu *Přepsat*, vyberte výběr produktů, zadejte cestu k atributu a do pole *Nový obsah* uveďte novou hodnotu. ### **Odstranění atributu** Atributy lze odstranit dvěma způsoby: 1. **Manuálně** – na stránce *Elementy* lze ručně vytvořené atributy smazat pomocí ikony koše. Smažou se tak hodnoty i samotný atribut 2. **Pomocí pravidel** – u atributů, které pocházejí ze vstupního nebo výstupního formátu, je možné odstranit pouze hodnoty, a to pravidlem (např. *Přepsat* s prázdnou hodnotou). Atributy definované cílovým formátem (tzv. systémové) nelze přejmenovat ani odstranit, protože jsou součástí specifikace výstupního feedu. ## **Shrnutí** Atributy doplňují význam elementů a umožňují detailněji popsat data ve feedu. V Mergado Editoru s nimi můžete pracovat stejně jako s běžnými elementy – vytvářet je, měnit jejich hodnoty i cílit na ně v pravidlech. Správná práce s atributy je důležitá zejména pro feedy, které směřují na portály vyžadující přesně definovanou strukturu, jako jsou Google, Heureka, Ceneo nebo Shoptet. ## **FAQ** **1\. Co je atribut v kontextu XML a produktových feedů** Atribut je součást elementu, která **upřesňuje jeho význam nebo vlastnost**. Zatímco element nese samotná data, atribut poskytuje doplňující informaci o těchto datech – například jednotku, stav nebo typ hodnoty. V XML je atribut vždy uveden v **otevíracím tagu** elementu a má svůj název i hodnotu, která musí být uzavřena v uvozovkách nebo apostrofech. Příklad: `` `Pavlína` `Nováková` `` Zde je `person` element, `gender` je atribut a jeho hodnota je `"female"`. **2\. K čemu atributy slouží v produktových feedech** Atributy mají praktický význam – umožňují přesněji popsat produkt nebo jeho vlastnosti. Některé reklamní portály a e-shopové platformy **vyžadují**, aby určité údaje byly uvedeny právě formou atributů. Příklady využití: * **Ceneo:** používá atributy k určení výrobce (`Nike`). * **Heureka (Dostupnostní feed):** atributy doplňují časové údaje (`…`). * **Shoptet:** atribut `description` popisuje obrázky (`…`). Používání atributů v Mergadu zajistí, že feed splní požadavky cílového systému a bude přijat bez chyb. **3\. Jak se atributy zapisují v XML** Atribut je součástí otevírací značky elementu: `obsah elementu` Hodnota atributu musí být uzavřena v **uvozovkách** nebo **apostrofech**. `Příklad: Zimní bunda` Zde atribut `available` doplňuje informaci o dostupnosti produktu. **4\. Jak Mergado Editor identifikuje atributy** Atributy v Mergado Editoru poznáte podle **zavináče `@`** na začátku názvu. * `@id` – identifikátor hodnoty elementu, * `@description` – popis hodnoty elementu, * `@lang` – jazyk hodnoty elementu. Kromě těchto běžných atributů existují také **speciální atributy**, které začínají dvěma zavináči `@@` (např. `@@POSITION`, `@@VALUE`). Tyto se používají výhradně **v jazyce Element-Path** a nikdy se neexportují do výstupního feedu. **5\. Jak se cílit na atributy pomocí jazyka Element-Path** Pro práci s atributy (čtení, úpravu, filtrování) se používá jazyk **Element-Path**. Cesta k atributu se zapisuje pomocí zavináče `@` před jeho názvem. Příklady cílení: Při filtrování produktů: Najděte produkty, jejichž `id` hlavní kategorie se rovná 123: * `CATEGORIES | DEFAULT_CATEGORY | @id = "123"` V pravidle při cílení na konkrétní element: Najděte CODE varianty, jejíž atribut `@id` obsahuje text `idvariant3`: * `VARIANTS | VARIANT { @id ~ "idvariant3" } | CODE` Atributy lze používat i v podmínkách (v závorkách `{ }`), kde filtrují konkrétní hodnoty. **6\. Jaký je rozdíl mezi běžnými a speciálními atributy** V Mergadu rozlišujeme dva typy atributů: | Typ atributu | Zápis | Použití | | ----- | ----- | ----- | | Standardní atributy (XML) | `@id`, `@description`, `@availability` | Jsou součástí XML struktury a určují význam elementu. | | Speciální atributy (Element-Path) | `@@POSITION`, `@@VALUE` | Slouží pro cílení v podmínkách při práci s vícenásobnými elementy. Nejsou součástí výstupního feedu. | **7\. K čemu slouží speciální atributy @@POSITION a @@VALUE** **`@@POSITION`** – odpovídá **pořadí hodnoty** elementu, na který se váže. Používá se hlavně u vícenásobných elementů (např. obrázky, varianty). *Příklad:* `IMGURL_ALTERNATIVE { @@POSITION > 1 }` * Tento zápis cílí na všechny alternativní obrázky kromě prvního. **`@@VALUE`** – představuje **obsah hodnoty** elementu. Používá se u elementů, kde se pořadí hodnot mění nebo není důležité. *Příklad:* `CATEGORY { @@VALUE != "Hračky" }` * Tento zápis vybere všechny kategorie kromě „Hračky“. **8\. Jak vytvořit nový atribut v Mergadu** Nový atribut lze vytvořit na stránce **Elementy**. 1. Klikněte na **Nový element**. 2. Zadejte název atributu začínající znakem `@`. 3. Mergado automaticky rozpozná, že vytváříte atribut. 4. Chcete-li vytvořit zanořený atribut, použijte ikonu „+“ u rodičovského elementu. Nově vytvořený atribut je prázdný a lze jej naplnit pomocí pravidla **Přepsat**. **9\. Jak upravit nebo přepsat hodnotu atributu** Atributy lze přepisovat stejně jako běžné elementy. V pravidle **Přepsat** stačí v poli *Element* uvést cestu k atributu. Příklady: * IMAGE | @description * SHOPITEM | @id * PARAM { @@VALUE \= "Barva" } | @value Do pole *Nová hodnota* pak zadejte požadovanou novou hodnotu. **10\. Jak odstranit atribut** Atributy lze odstranit dvěma způsoby: * **Manuálně:** u ručně vytvořených atributů na stránce *Elementy* kliknutím na ikonu koše u atributu. * **Pomocí pravidla:** např. pravidlem *Přepsat* s prázdnou hodnotou. Atributy, které jsou součástí zdrojového nebo cílového formátu, nelze odstranit, pouze smazat jejich hodnoty. **11\. Jaký je vztah mezi atributy a elementy v Mergadu** V Mergadu jsou atributy považovány za speciální typ elementů. Lze je používat v pravidlech, výběrech, proměnných i automatizacích stejně jako běžné elementy. Rozdíl spočívá pouze ve způsobu zápisu (se znakem `@`) a v jejich umístění v rámci struktury feedu. **12\. Proč je důležité pracovat s atributy správně** Správná práce s atributy je klíčová pro feedy směřující na portály, které vyžadují přesnou datovou strukturu – jako Google, Heureka, Ceneo nebo Shoptet. Chybně uvedené nebo chybějící atributy mohou způsobit zamítnutí feedu nebo neúplné zobrazení produktů. Díky nástrojům Mergado Editoru lze atributy přidávat, měnit i kontrolovat s vysokou přesností. # **7\. Jazyk Element-Path** ## **Co je Element-Path** **Element-Path** je jazyk vyvinutý společností Mergado, který slouží k **zapisování cest k elementům a jejich hodnotám**. Pomocí Element-Path určujete, **na které hodnoty ve feedu chcete cílit** – zda je budete číst, nebo do nich zapisovat. Mergado Editor pracuje s elementy stejně jako XML feed – ve stromové struktuře. Aby bylo možné v této struktuře přesně určit, s kterými daty chcete pracovat, je potřeba znát jejich **cestu**. Právě to umožňuje jazyk Element-Path. ## **Co znamená „cesta k elementu“** *Cesta k elementu* je zápis, který vyjadřuje, **kde se v datové struktuře nachází hodnota (hodnoty)**, se kterou chcete pracovat. Pomocí této cesty Mergadu sdělujete, že chcete buď: 1. **hodnotu přečíst** – tedy použít ji jako vstup (např. v pravidle nebo výběru), nebo 2. **hodnotu změnit** – tedy do ní zapsat nová data. Příklad: * Chcete-li cílit na hodnotu elementu `NAME`, cesta bude jednoduše: NAME Mergado Editor si tuto cestu přečte a použije hodnotu uvedenou v elementu `NAME`. Poznámka: V praxi se běžně používá pojem „cesta k elementu“, i když přesněji řečeno se vždy jedná o „cestu k hodnotě elementu“. U jednoduchých elementů se však oba pojmy významově shodují. ## **Zanořené cesty** Zanořenost (vnořenost) se v jazyce Element-Path zapisuje pomocí **svislé čáry `|`**, která vyjadřuje vztah rodiče a potomka. * **Syntaxe:** Chcete-li cílit na zanořený element, přidáte před jeho název rodiče a oddělíte je svislítkem. * **Čtení:** Svislítko čteme jako „a pod ním zanořený“ nebo „a jeho potomek“. **Příklad:** Cesta PARAM | VAL * znamená: „Najděte element `PARAM` a pod ním zanořený element `VAL`.“ * **Důležité pravidlo:** Mezera před a za svislítkem **musí být zachována** – zápis `PARAM | VAL` je správně, `PARAM|VAL` nikoli. ## **Slovní zásoba a syntaxe Element-Path** Element-Path má svou vlastní „slovní zásobu“ a pravidla syntaxe. Základními prvky jazyka jsou: 1. **Názvy elementů** – všechny názvy, které se v projektu vyskytují. 2. **Svislítko (`|`)** – označuje zanoření (rodič → potomek). 3. **Podmínky (`{ }`)** – filtrují hodnoty podle zadaných kritérií. 4. **Speciální atributy (`@@…`)** – umožňují cílit např. podle pozice (`@@POSITION`), hodnoty (`@@VALUE`), nebo na poslední hodnotu (`@@MAX_POSITION`). 5. **MQL (Mergado Query Language)** – můžete jej používat v podmínkách pro pokročilé filtrování (např. s operátory `AND`, `OR` apod.). ### **Nápověda při psaní cest** V Mergado Editoru je práce s Element-Path usnadněna několika funkcemi: * **Našeptávání:** Editor nabízí dostupné elementy, operátory i hodnoty. * **Validace:** Pokud se napsaný element v projektu nenachází, zvýrazní se červeně; validní cesta je zvýrazněná zeleně. * **Našeptávání dopravců a parametrů:** U některých typů feedů Editor nabízí konkrétní názvy (např. dopravce, parametry) a automaticky doplní celou cestu. ## **Kde se Element-Path používá** Cesty k elementům se používají téměř ve všech částech Mergado Editoru – všude tam, kde je potřeba určit, s jakými daty pracovat. * **V pravidlech** – např. *Přepsat*, *Najít a nahradit*, *Hromadné zkopírování hodnot*, *Výpočet*. Cesta k elementu určuje, s jakými hodnotami má pravidlo pracovat. * **Ve výběrech** – při vytváření výběrů na stránce Produkty nebo při psaní vlastního MQL dotazu. * **V proměnných** – pro čtení hodnot z konkrétních elementů a zápisu hodnot do elementů. * **V importech** – v elementech importních souborů, které se zpracovávají přes pravidlo *Import datového souboru*. * **Na stránce Produkty** – pro řazení, filtrování a přehled hodnot elementů. * **V automatizaci** – při nastavování pravidel a podmínek pro automatické akce. ## **Prakticky: práce se zápisem a podmínkami** Element-Path je klíčový zejména u zanořených a vícenásobných elementů. Správné zapsání cesty rozhoduje o tom, které hodnoty Mergado čte nebo upravuje. ### **1\. Základní cesta bez podmínky** Pokud použijete zanořenou cestu bez podmínky, Mergado zacílí na **všechny hodnoty** v dané struktuře. **Příklad:** * PARAM | VAL Tato cesta označuje všechny hodnoty `VAL` všechny výskyty elementu `PARAM`. Pokud má produkt parametry Barva, Velikost a Materiál, cesta `PARAM | PARAM_NAME` vede ke třem hodnotám. Při čtení Mergado použije první z nich; při zápisu se změna projeví u všech odpovídajících hodnot. **2\. Přesné cílení pomocí podmínek** Podmínky se zapisují do složených závorek `{ }` a vždy se vážou k elementu, který stojí nalevo. Slouží k omezení cílení na konkrétní hodnoty. #### **Cílení na konkrétní hodnotu zanořeného elementu** Chcete-li pracovat pouze s parametrem „Barva“, použijte podmínku, která filtruje přes zanořený element `PARAM_NAME`: PARAM { PARAM\_NAME \= "Barva" } | VAL Tento zápis znamená: „Najděte element `PARAM`, který má potomka `PARAM_NAME` s hodnotou *Barva*, a v něm upravte hodnotu elementu `VAL`.“ Tento způsob je nejbezpečnější, protože funguje bez ohledu na pořadí parametrů ve feedu. #### **Cílení na pozici vícenásobného elementu** Pomocí speciálního atributu `@@POSITION` můžete cílit na hodnotu podle její pozice. Každá hodnota má vlastní pořadové číslo (1, 2, 3 …). **Příklad:** * IMAGES | IMAGE { @@POSITION \= 3 } Tato cesta cílí na třetí obrázek. Je vhodná tam, kde má pořadí hodnot pevný význam. Je však třeba pamatovat, že `@@POSITION` neřeší obsah – pokud se pořadí liší napříč produkty, může dojít k nechtěnému výběru jiné hodnoty. #### **Cílení na hodnotu vícenásobného elementu** Atribut `@@VALUE` odkazuje na hodnotu elementu. Používá se u elementů, které nemají potomky, a umožňuje cílit podle konkrétní hodnoty bez ohledu na její pozici. **Příklad:** CATEGORIES | CATEGORY { @@VALUE \!= "Hračky" } Tento zápis vybere všechny `CATEGORY`, jejichž hodnota se nerovná „Hračky“. Podmínky lze kombinovat i s MQL operátory (AND, OR, NOT apod.), což umožňuje velmi přesné filtrování. --- ## **Shrnutí** Element-Path je základní jazyk pro práci s daty v Mergado Editoru. Díky němu lze přesně určit, odkud hodnoty pocházejí, kam se mají zapisovat a v jakém kontextu se nacházejí. Správné pochopení struktury a syntaxí Element-Path vám umožní tvořit bezpečná pravidla, efektivní výběry a automatizace, které spolehlivě pracují i s komplexními XML a CSV feedy. ## **FAQ** **1\. Co je jazyk Element-Path a k čemu slouží** **Element-Path** je jazyk vyvinutý společností **Mergado**. Slouží k zapisování **cest k elementům** a jejich hodnotám – tedy k určení, s jakými daty ve feedu chcete pracovat. Pomocí Element-Path můžete: * **číst hodnoty** z feedu (např. pro výběry, výpočty nebo podmínky), * **zapisovat nové hodnoty** (např. pomocí pravidel jako *Přepsat* nebo *Najít a nahradit*).. **2\. Co znamená „cesta k elementu“** *Cesta k elementu* určuje, **kde se nachází konkrétní hodnota v datové struktuře feedu**. Pomocí cesty sdělujete Mergadu, na jaký prvek má pravidlo nebo výběr cílit. Příklad: `NAME` * Tento zápis říká, že chceme pracovat s hodnotou elementu `NAME`. Poznámka: Technicky vzato jde o „cestu k hodnotě elementu“, protože cílem je vždy konkrétní hodnota, nikoli samotný tag elementu. **3\. Jak se zapisuje zanoření v Element-Path** Zanoření vyjadřuje vztah **rodiče a potomka** a zapisuje se pomocí svislé čáry `|`. Syntaxe: `RODIČ | POTOMEK` * Čtení: „Najděte element `RODIC` a pod ním zanořený element `POTOMEK`.“ * Důležité: **Mezera před a po svislítku je povinná.** * Správně: `PARAM | VAL` * Chybně: `PARAM|VAL` Příklad: `` `Barva` `Černá` `` Cesta k hodnotě `VAL` je `PARAM | VAL`. **4\. Jaká je slovní zásoba a syntaxe Element-Path** Element-Path má svou vlastní „gramatiku“. Zahrnuje tyto základní prvky: | Prvek | Popis | Příklad | | ----- | ----- | ----- | | **Název elementu** | Označuje konkrétní prvek ve feedu. | `ITEM_ID` | | **Svislítko ( | )** | Vyjadřuje zanoření (rodič → potomek). | `PARAM | VAL` | | **Podmínky ( { } )** | Slouží jako filtr pro přesné cílení. | `PARAM { PARAM_NAME = "Barva" } | VAL` | | **Speciální atributy ( @@ )** | Cílí podle pozice (`@@POSITION`) nebo hodnoty (`@@VALUE`). | `IMGURL_ALTERNATIVE { @@POSITION = 2 }` | | **MQL syntaxe** | Umožňuje logické operace (AND, OR, NOT…) v rámci podmínek. | `PARAM { PARAM_NAME = "Barva" AND VAL = "Černá" }` | **5\. Jaké nástroje pomáhají při psaní cest v Mergadu** Mergado Editor nabízí pokročilé funkce pro práci s Element-Path: * **Našeptávání:** Editor nabízí dostupné elementy, atributy i operátory. * **Validace:** Pokud element neexistuje, zvýrazní se červeně; validní cesty se zvýrazní zeleně. * **Našeptávání parametrů a dopravců:** Editor automaticky doplňuje konkrétní názvy a vytváří kompletní cesty. **6\. Kde všude se Element-Path používá** Cesty k elementům se používají **napříč celým Mergado Editorem** – všude tam, kde je potřeba přesně určit, s jakými daty pracujete. * **V pravidlech:** např. *Přepsat*, *Najít a nahradit*, *Výpočet*, *Hromadné zkopírování hodnot*. * **Ve výběrech:** v Onelineru i v MQL dotazech. * **V proměnných:** při čtení nebo zápisu hodnot. * **V importech:** v hlavičkách importních souborů. * **Na stránce Produkty:** pro zobrazení, řazení a filtrování hodnot. * **V automatizaci:** při nastavování pravidel a podmínek automatických akcí. **7\. Co jsou podmínky a jak fungují** Podmínky slouží jako **filtr**, který omezuje, na které hodnoty má cesta mířit. Zapisují se do složených závorek `{ }` a vážou se vždy k elementu nalevo od nich. Příklad: `PARAM { PARAM_NAME = "Barva" } | VAL` Tento zápis vybere pouze hodnoty `VAL` u parametrů, kde je `PARAM_NAME` rovno „Barva“. Podmínky jsou nezbytné u vícenásobných elementů, kde se stejné názvy mohou opakovat (např. různé parametry u jednoho produktu). **8\. Jak se dají v podmínkách používat logické operátory MQL** Element-Path podporuje celou slovní zásobu jazyka **MQL (Mergado Query Language)**. V podmínkách lze používat logické operátory jako `AND`, `OR`, `NOT`, `IN`, `CONTAINS` apod. Příklad složité podmínky: `VARIANTS | VARIANT { PARAMETERS | PARAMETER { NAME = "Velikost" } | VALUE = "M" AND PARAMETERS | PARAMETER { NAME = "Materiál" } | VALUE = "Bavlna" } | STOCK | WAREHOUSES | WAREHOUSE | NAME` Tento zápis vybere název skladu (`NAME`) u variant, které mají **velikost „M“** a **materiál „Bavlna“**. **9\. Jaké speciální atributy Element-Path používá** Speciální atributy začínají vždy dvěma zavináči `@@` a používají se **v podmínkách**. Slouží ke snadnějšímu cílení u vícenásobných elementů. | Atribut | Popis | Příklad použití | | ----- | ----- | ----- | | **`@@POSITION`** | Cílí podle pořadí hodnoty (1, 2, 3…). | `VARIANTS | VARIANT { @@POSITION = 2 }` | | **`@@VALUE`** | Cílí podle obsahu hodnoty. | `CATEGORY { @@VALUE != "Hračky" }` | `@@POSITION` se používá tam, kde pořadí hodnot odpovídá významu (např. obrázky). `@@VALUE` je jistější tam, kde se pořadí může měnit. **10\. Jak se používají podmínky s více úrovněmi zanoření** Podmínky lze kombinovat i mezi různými úrovněmi elementů. Příklad víceúrovňového zanoření: `VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = "Velikost" } | VALUE` Tento zápis cílí na hodnotu parametru „Velikost“ u **druhé varianty produktu**. **11\. Jaké jsou nejčastější chyby při psaní cest** * Vynechané mezery kolem svislítka (`|`). * Nesprávné umístění složených závorek `{ }`. * Chybné názvy elementů (neexistující v projektu). * Použití `@@POSITION` u elementů, kde se pořadí liší mezi produkty. * Cesta končící rodičem místo potomkem (např. `PARAM` místo `PARAM | VAL`). Mergado Editor chyby automaticky detekuje v poli pro zadání cesty – nevalidní cesta se zobrazí červeně. **12\. Jak Element-Path pomáhá s přesností a bezpečností pravidel** Správné používání Element-Path zajišťuje, že pravidla, výběry i automatizace pracují **pouze s relevantními daty**. Díky přesně definované cestě lze: * bezpečně číst a upravovat hodnoty, * cílit jen na vybrané podmínky, * předejít chybám způsobeným změnou struktury feedu. --- # **8\. Podmínky v cestě k elementu** ## **Co jsou podmínky** Podmínky v cestě k elementu fungují jako **filtr**, který umožňuje **cílit pouze na vybrané hodnoty** a tím zpřesnit práci s daty. Jsou nedílnou součástí jazyka **Element-Path** a používají se zejména při práci s vícenásobnými a zanořenými elementy. Podmínky se **vždy vážou k elementu, který stojí nalevo od nich**, a mohou filtrovat pouze hodnoty jeho **zanořených potomků**. ## **Jak se podmínky zapisují** Podmínky se zapisují do **složených závorek `{ }`**, které se vážou k příslušnému elementu. **Základní šablona zápisu:** Element { Potomek Operátor Hodnota } | Další\_potomek **Příklad:** * PARAM { PARAM\_NAME \= "Barva" } | VAL Tato cesta říká: „Najděte element `PARAM`, který má potomka `PARAM_NAME` s hodnotou *Barva*, a v něm zacilte na zanořený element `VAL`.“ ### **Pravidla zápisu** * **Mezery jsou důležité** – nelze je vynechat. Platí to jak uvnitř podmínky, tak před a po ní (např. `PARAM { PARAM_NAME = "Barva" } | VAL` je správně, `PARAM{PARAM_NAME="Barva"}|VAL` je chybně). * **Závorky `{ }`** se na české klávesnici píší pomocí klávesové zkratky `Alt + B (option + 9)` (levá) a `Alt + N (option + 0)` (pravá). * Podmínky mohou obsahovat **libovolně složité výrazy**, včetně operátorů `AND`, `OR`, `NOT`, nebo i více úrovní zanoření. ## **Použití MQL v podmínkách** Podmínky v Element-Path podporují **plnou syntaxi Mergado Query Language (MQL)**. To znamená, že do nich můžete psát stejné výrazy jako do formuláře pro vlastní dotazy. Například: * PARAM { PARAM\_NAME \= "Velikost" AND VAL \= "M" } nebo složitější variantu s více úrovněmi: * VARIANT { PARAMETERS | PARAM { PARAM\_NAME \= "Materiál" AND VAL \= "Bavlna" } } Tento přístup umožňuje kombinovat podmínky a cílit na velmi přesně definované skupiny hodnot. ## **K čemu podmínky slouží** Podmínky zpřesňují cestu k elementu a umožňují cílit na **konkrétní podskupiny hodnot**. Používají se především pro: 1. **Cílení na konkrétní hodnoty vícenásobných elementů.** 1. Například při práci s parametry, dopravci nebo obrázky, kde by cesta bez podmínky vedla k více hodnotám. Podmínka zajistí, že se pravidlo použije pouze na tu správnou. 2. **Strukturové přidávání hodnot** 1. Při zápisu do feedu platí, že vše, co je uvedeno v podmínce s operátorem `=` nebo `AND`, **Mergado vytvoří, pokud to ještě neexistuje**. 2. Díky tomu lze podmínkami vytvářet i nové zanořené struktury (např. nový parametr nebo flag). 3. **Použití speciálních atributů** 1. Podmínky slouží také k práci se **speciálními atributy** jako `@@POSITION` (pořadí hodnoty) a `@@VALUE` (hodnota elementu). ## **Kdy mají a nemají smysl** ### **Kdy mají smysl** Podmínky mají smysl u **vícenásobných elementů**, kde se jeden typ informace může opakovat vícekrát. Nejčastěji se používají při práci s: * parametry (`PARAM`), * dopravou (`DELIVERY`), * variantami (`VARIANT`), * obrázky (`IMAGE`), * kategoriemi (`CATEGORY`). Příklad: * PARAM { PARAM\_NAME \= "Barva" } | VAL Tento zápis zajistí, že se změna provede pouze u parametru „Barva“, bez ohledu na jeho pozici ve feedu. V tomto případě je to bezpečnější než použití atributu `@@POSITION`, který se může lišit napříč produkty. **Kdy nemají smysl** 1. **Jednoduché elementy** 1. U jednoduchých elementů (např. `ITEM_ID`, `PRICE_VAT`) má element vždy jedinou hodnotu, takže podmínka je zbytečná. 2. **Cílení na všechny hodnoty** 1. Pokud chcete pracovat se všemi hodnotami elementu, podmínku nepoužívejte. Například: IMAGES | IMAGE 2. Tato cesta cílí na všechny obrázky daného produktu. ## **Prakticky: filtrování hodnot pomocí podmínky** ### **Příklad cesty** * PARAM { PARAM\_NAME \= "Barva" } | VAL ### **Jak Mergado tuto cestu vyhodnocuje** 1. **`PARAM`** – označuje rodičovský, vícenásobný element. 2. **`{ PARAM_NAME = "Barva" }`** – je podmínka, která říká: „Zajímají nás pouze ty elementy `PARAM`, jejichž potomek `PARAM_NAME` má hodnotu *Barva*.“ 3. **`| VAL`** – určuje, že pracujeme s potomkem `VAL`, tedy s konkrétní hodnotou parametru. Výsledkem je, že Mergado vybere pouze ty hodnoty `VAL`, které patří k parametru s názvem „Barva“. ### **Porovnání s cílením podle pozice** Podmínka * PARAM { PARAM\_NAME \= "Barva" } | VAL je spolehlivější než zápis * PARAM { @@POSITION \= 2 } | VAL Protože cílení podle názvu parametru funguje bez ohledu na jeho pořadí v rámci produktu. U parametrů s různým pořadím se tak předejde nesprávnému přiřazení hodnot. ## **Shrnutí** Podmínky v jazyce Element-Path jsou klíčovým nástrojem pro přesné a bezpečné cílení na konkrétní hodnoty. Umožňují filtrovat data, vytvářet nové struktury a pracovat s vícenásobnými i zanořenými elementy bez rizika chybného přepisu. Správné používání podmínek vám pomůže předejít chybám, udržet pořádek v pravidlech a zajistit, že Mergado upraví vždy jen ta data, která skutečně chcete měnit. ## **FAQ** **1\. Co jsou podmínky v jazyce Element-Path a proč se používají** Podmínky jsou **filtr**, který zpřesňuje cestu k elementu. Pomocí nich určujete, **na které konkrétní hodnoty má Mergado cílit** – tedy které číst, upravit nebo vytvořit. Používají se hlavně u **vícenásobných a zanořených elementů**, kde se hodnoty opakují nebo sdílejí stejný název. Podmínky pomáhají: * přesně cílit na vybranou hodnotu (např. konkrétní parametr), * zabránit chybám při přepisu nesouvisejících dat, * vytvářet nové struktury přímo v pravidlech. **2\. Jak se podmínky zapisují (syntaxe)** Podmínky se zapisují do **složených závorek `{ }`**, které se vážou k elementu stojícímu **nalevo** od nich. Základní tvar zápisu: * `ELEMENT { POTOMEK = "Hodnota" } | DALŠÍ_POTOMEK` Příklad: * `PARAM { PARAM_NAME = "Barva" } | VAL` Tento zápis říká: „Najděte element `PARAM`, jehož zanořený element `PARAM_NAME` má hodnotu `Barva`, a v něm zacilte na `VAL`.“ **Důležité zásady zápisu:** * Mezery jsou povinné – nelze je vynechat ani uvnitř podmínky, ani před a po ní. * Závorky `{ }` se na české klávesnici píší kombinací **Alt \+ B** (levá) a **Alt \+ N** (pravá). * Podmínky mohou obsahovat více kritérií propojených logickými operátory `AND`, `OR`, `NOT`. **3\. Jak funguje vazba podmínek v cestě** Podmínka se **vztahuje vždy k elementu nalevo od ní**. Filtrovat lze pouze přes **potomky (zanořené elementy)** tohoto elementu. Příklad: `VARIANT { PARAMETERS | PARAMETER { NAME = "Velikost" } | VALUE = "M" } | STOCK` Tento zápis znamená: „Najděte variantu, která má parametr s názvem *Velikost* a hodnotou *M*, a v ní pracujte s elementem `STOCK`.“ **4\. Jak se podmínky využívají při práci s vícenásobnými elementy** Podmínky jsou klíčové při práci s elementy, které se v rámci jednoho produktu opakují (např. `PARAM`, `DELIVERY`, `CATEGORY`, `IMAGE`, `VARIANT`). **Bez podmínky:** * `PARAM | VAL` \- cílí na všechny hodnoty `VAL` v rámci všech parametrů. Při čtení Mergado použije první hodnotu, při zápisu změní všechny. **S podmínkou:** * `PARAM { PARAM_NAME = "Barva" } | VAL` \- cílí pouze na hodnotu `VAL`, která patří k parametru „Barva“. Tento zápis je **bezpečný a jednoznačný** – nezáleží na pořadí elementů. **5\. Jaké operátory lze v podmínkách použít** Podmínky podporují všechny běžné operátory z jazyka **MQL (Mergado Query Language)**. Díky tomu lze vytvářet i velmi přesné a komplexní filtry. | Typ operátoru | Příklad | Význam | | ----- | ----- | ----- | | **\=** | `PARAM_NAME = "Barva"` | Rovnost hodnoty | | **\!=** | `@@VALUE != "Hračky"` | Nerovnost | | **\> / \ 1` | Porovnání číselných hodnot | | **\~** | `@id ~ "variant"` | Obsahuje | | **AND** | `PARAM_NAME = "Barva" AND VAL = "Černá"` | A zároveň | | **OR** | `@@VALUE = "XL" OR @@VALUE = "L"` | Nebo | | **NOT** | `NOT (VAL = "M")` | Negace | **6\. Jak se v podmínkách používá MQL syntaxe** Do podmínek lze psát **celé MQL dotazy** – jazyk Mergado Query Language je plně integrovaný do Element-Path. Tím je možné kombinovat vícenásobné filtry, různé úrovně zanoření i složitou logiku. Příklad komplexní podmínky: `VARIANTS | VARIANT { PARAMETERS | PARAMETER { NAME = "Materiál" AND VAL = "Bavlna" } AND PARAMETERS | PARAMETER { NAME = "Velikost" AND VAL = "M" } } | PRICE` Tento zápis vybere cenu (`PRICE`) u varianty, která má parametry *Materiál \= Bavlna* a *Velikost \= M*. **7\. Co když element nemá zanořené potomky** U elementů, které **nemají žádné zanořené elementy**, se v podmínkách používají **speciální atributy**: * `@@POSITION` – cílí podle pořadí hodnoty, * `@@VALUE` – cílí podle obsahu hodnoty. Příklady: * `IMAGES | IMAGE { @@POSITION = 3 }` – třetí obrázek, * `CATEGORY { @@VALUE != "Hračky" }` – všechny kategorie kromě „Hračky“. **8\. Jaký je rozdíl mezi podmínkou a cílením podle pozice** Cílení podle **pozice** (`@@POSITION`) odkazuje pouze na pořadí hodnoty. Cílení pomocí **podmínky** naopak zohledňuje obsah. Porovnání: * `PARAM { @@POSITION = 2 } | VAL` – cílí na druhý parametr v pořadí. * `PARAM { PARAM_NAME = "Barva" } | VAL` – cílí na parametr s názvem „Barva“, bez ohledu na jeho pozici. Cílení podle obsahu je spolehlivější, protože funguje i tehdy, když se pořadí hodnot liší mezi produkty. **9\. Jak podmínky pomáhají při zápisu nových dat** Při **zápisu** dat do feedu platí pravidlo: **Pokud podmínka u elementu obsahuje pouze operátory** `=` **a** `AND` **s pod-elementy jejichž hodnoty neexistují, tak Mergado tyto hodnoty automaticky vytvoří.** Tento princip umožňuje tzv. **strukturové přidávání hodnot** – například přidání nového parametru, varianty nebo flagu. Příklad: `FLAGS | FLAG { CODE = "action" } | ACTIVE` Pokud flag s kódem `action` neexistuje, Mergado jej automaticky vytvoří a nastaví `ACTIVE` na 0\. **10\. Kdy má smysl podmínky používat** Podmínky mají smysl zejména u vícenásobných nebo zanořených elementů, jako jsou: * `PARAM` nebo `g:attribute_detail` (parametry produktu), * `DELIVERY` (doprava), * `VARIANT` (varianty), * `IMAGE` (obrázky), * `CATEGORY` (kategorie). Například cesta: `PARAM { PARAM_NAME = "Barva" } | VAL` Zajistí, že se úprava týká pouze hodnoty parametru „Barva“, nikoli jiných parametrů. **11\. Kdy podmínky nemají smysl** Podmínky nemají smysl v těchto případech: * **Jednoduché elementy** – mají pouze jednu hodnotu (`ITEM_ID`, `PRICE_VAT`). * **Cílení na všechny hodnoty** – pokud chcete pracovat se všemi výskyty elementu (např. `IMAGES | IMAGE`), není třeba podmínku přidávat. **12\. Jak ověřit správnost cesty s podmínkou** V Mergado Editoru je k dispozici nástroj **Cesta k elementu**, který umožňuje: * otestovat zápis cesty (včetně podmínek), * zobrazit, kam cesta skutečně vede, * validovat, zda elementy v cestě existují. Kromě toho pole pro zápis cesty nabízí: * našeptávání (elementů, atributů, operátorů, hodnot), * barevné zvýraznění syntaxe, * varování při neplatné nebo neúplné cestě. **13\. Jaké jsou nejčastější chyby při psaní podmínek** * Chybějící mezery kolem složených závorek `{ }`. * Použití podmínky u elementu, který žádné potomky nemá. * Zaměnění názvu elementu (např. `PARAM_NAME` vs. `NAME`). * Vynechané složené závorky nebo špatné umístění podmínky v cestě. * Použití `@@POSITION` místo názvu elementu tam, kde se pořadí liší. Mergado na tyto chyby automaticky upozorňuje zvýrazněním chybného zápisu. --- # **9\. Speciální atributy v Element-Path** ## **Co jsou speciální atributy** Speciální atributy představují **pokročilý nástroj** v Mergado Editoru a jazyce Element-Path. Slouží k **přesnému cílení** u vícenásobných elementů a umožňují rozlišovat mezi jednotlivými hodnotami daného elementu. Každý speciální atribut: * **začíná dvěma zavináči (`@@`)**, * **váže se na konkrétní element**, * používá se **uvnitř podmínek v cestách k elementům** (v složených závorkách `{ }`), * rozšiřuje možnosti cílení a filtrování v Element-Path. V Mergadu jsou v současnosti k dispozici tyto speciální atributy: 1. `@@POSITION` – pozice hodnoty, 2. `@@VALUE` – obsah hodnoty. 3. `@@MAX_POSITION` – číslo určující nejvyšší pozici hodnot daného elementu u konkrétního produktu. ## **@@POSITION – cílení podle pozice** Atribut `@@POSITION` odpovídá **pořadí hodnoty elementu**, na který se váže. Umožňuje cílit na konkrétní pozici nebo rozsah pozic uvnitř vícenásobného elementu. * Každá hodnota má svou **pozici**, vyjádřenou přirozeným číslem (1, 2, 3 …). * U jednoduchých elementů má vždy hodnota pozici 1\. * Pouze u vícenásobných elementů (`IMAGE`, `PARAM`, `DELIVERY` apod.) může být pozice vyšší než 1\. **Příklad:** * IMAGES | IMAGE { @@POSITION \= 3 } Čteme jako: „Najděte element `IMAGES` a zacilte na jeho potomka `IMAGE` s hodnotou na třetí pozici.“ **Slabina:** `@@POSITION` pracuje pouze s pořadím a nezohledňuje obsah hodnoty. Pokud se pořadí hodnot liší napříč produkty, může cílení dopadnout na jinou hodnotu, než očekáváte. ## **@@VALUE – cílení podle obsahu hodnoty** Atribut `@@VALUE` reprezentuje **hodnotu elementu**, na který se váže, a umožňuje cílit podle jejího obsahu. Používá se v podmínkách u elementů, které nemají potomky (nebo tam, kde nepotřebujeme cílit na zanořenou strukturu). ### **Kdy `@@VALUE` použít** 1. **U elementů bez potomků** – například `IMGURL_ALTERNATIVE`, `CATEGORY`. 2. **U vícenásobných elementů** – umožňuje cílit na hodnotu bez ohledu na její pozici. 3. **Při měnícím se pořadí hodnot** – nahrazuje méně spolehlivé cílení pomocí `@@POSITION`. **Příklad:** * CATEGORIES | CATEGORY { @@VALUE \!= "Hračky" } Tento zápis vybere všechny kategorie kromě „Hračky“. Cílení pomocí `@@VALUE` je vhodné tam, kde se pořadí hodnot může lišit mezi produkty. ## **@@MAX\_POSITION – pomocný speciální atribut** Pomocný speciální atribut `@@MAX_POSITION` představuje **pozici hodnoty s nejvyšším pořadím** daného elementu u konkrétního produktu. Jinými slovy – označuje **poslední pozici**, na které se daný element v rámci produktu nachází. Příklad: \www.image1.jpg\ …@@POSITION \= 1 \www.image2.jpg\ …@@POSITION \= 2 \www.image3.jpg\ …@@POSITION \= 3 V tomto případě je `@@MAX_POSITION = 3`, protože nejvyšší existující pozice elementu `IMAGE` je právě 3\. U různých produktů může mít stejný element rozdílnou hodnotu `@@MAX_POSITION`, protože počet hodnot se může lišit. ### **Kdy `@@MAX_POSITION` použít** #### **1️⃣ Přidávání nových vícenásobných hodnot** Chcete-li **přidat novou hodnotu** na konec existujících hodnot, aby se žádná nepřepsala, použijte konstrukci: `ELEMENT {@@POSITION = @@MAX_POSITION + 1}` Příklad: Chcete zapsat novou URL obrázku `www.image4.jpg` do elementu `IMAGE` na další volnou pozici. * Použijte pravidlo **Přepsat** * Do pole **Element** vložte: `IMAGE {@@POSITION = @@MAX_POSITION + 1}` * Do pole Nová hodnota zapíšeme novou url: www.image4.jpg Výsledek: \www.image1.jpg\ \www.image2.jpg\ \www.image3.jpg\ \www.image4.jpg\ #### **2️⃣ Kopírování hodnot na konec existujícího seznamu** Při **kopírování hodnot mezi vícenásobnými elementy** můžete `@@MAX_POSITION` využít pro kopírování „až na konec“ bez přepsání původních hodnot. Příklad: Ve feedu máme tyto dva vícenásobné elementy: \www.image1.jpg\ …@@POSITION \= 1 \www.image2.jpg\ …@@POSITION \= 2 \www.image3.jpg\ …@@POSITION \= 3 \www.context\_image1.jpg\ …@@POSITION \= 1 \www.context\_image2.jpg\ …@@POSITION \= 2 Chcete zkopírovat všechny `CONTEXT_IMAGE` do `IMAGE`, aniž by se původní obrázky přepsaly. * Použijte pravidlo **Hromadné zkopírování hodnot** * Do pole **Zdrojový element** zadejte: `CONTEXT_IMAGE` * Do pole **Cílový element** zadejte: `IMAGE {@@POSITION = @@MAX_POSITION + 1}` Výsledek: \www.image1.jpg\ \www.image2.jpg\ \www.image3.jpg\ \www.context\_image1.jpg\ \www.context\_image2.jpg\ ## **Kdy který atribut použít** | Cíl cílení | @@POSITION (podle pozice) | @@VALUE (podle hodnoty) | Doporučený přístup | | ----- | ----- | ----- | ----- | | Obrázky nebo kategorie (bez potomků) | Vhodné, pokud je pořadí pevné (např. 2\. obrázek). | Vhodné, pokud se pořadí mění. | Libovolné dle situace | | Parametry (se zanořením) | Méně bezpečné – cílení na pořadí. | Nevhodné, protože rodič `PARAM` nemá hodnotu. | Nejbezpečnější je cílit přes potomka (`PARAM_NAME = "Barva"`) | **Pravidla pro volbu:** 1. U jednoduchých elementů pozici uvádět nemusíte – je vždy rovna 1\. 2. U vícenásobných elementů bez potomků můžete použít `@@POSITION` nebo `@@VALUE`. 3. U zanořených struktur (např. parametry) je nejbezpečnější použít podmínku s názvem zanořeného elementu, např. `PARAM_NAME = "Barva"`. ## **Indexace (`#`)** Kromě speciálních atributů umožňuje Element-Path také **indexaci**, která se zapisuje pomocí znaku `#`. Indexace = výskyt elementu. Zatímco @@POSITION pracuje s pořadím hodnot uvnitř vícenásobného elementu (např. 3. obrázek v IMAGE), indexace pomocí `#` umožní vybrat *konkrétní opakovaný výskyt stejného elementu* (např. druhý parametr „Barva“), i když se jeho pořadí napříč produkty liší. Indexace rozšiřuje možnosti cílení tam, kde `@@POSITION` nestačí. Indexaci je nutné použít pouze v případech, kdy cesta k elementu vrací více než jednu hodnotu a speciální atribut `@@POSITION` nelze využít, protože hodnoty se u jednotlivých produktů nacházejí na odlišných pozicích. Použití indexace jako náhrady za `@@POSITION` v situacích, kdy to není nezbytné, je nevhodné a může vést k degradaci výkonu. ### Jak indexaci použít krok za krokem 1. **Ujasněte si, který výskyt chcete cílit** (1., 2., 3., …) a podle čeho ho poznáte (např. parametr s názvem „Barva“). 2. **Otevřete místo, kde s daty pracujete** – indexaci lze použít ve *výběrech i pravidlech*, v polích pro *Element-Path* a také v *MQL (Mergado Query Language)*. 3. **Doplňte indexaci do cesty** pomocí `#` ve tvaru: ` #{ pořadí }` 4. **Uložte a aplikujte** pravidlo nebo výběr. Mergado pak bude pracovat pouze s určeným výskytem. * **Syntaxe:** `PARAM { NAME = "Barva" } #{ 2 } | VALUE` * **Význam:** Cílí na druhý výskyt elementu `PARAM | VALUE` s názvem parametru „Barva“. * **Použití:** Indexace je vhodná zejména u podmíněných elementů, u kterých nelze použít `@@POSITION`. * **Doporučení:** Pokud funguje běžné cílení podle pozice, je `@@POSITION` rychlejší a přehlednější. Příklad: Ve feedu máme 2 produkty s parametrem Barva. Oba produkty mají parametr Barva 2x s různými hodnotami, na různých pozicích. Produkt A Barva Bílá Barva Černá Materiál Keramika Produkt B Barva Zelená Materiál Keramika Barva Červená V případě, že chceme zacílit právě na druhou hodnotu parametru Barva u každého produktu, nemůžeme použít speciální atribut @@POSITION, protože hodnoty jsou na různých pozicích. Pomůže nám právě Indexace. Správný zápis cesty s použitím indexace: * `g:product_detail { g:attribute_name = "Barva" } #{ 2 } | g:attribute_value` ## **Tipy pro indexaci** * **Kde ji použít:** ve výběrech i pravidlech (Element-Path, případně i MQL). * **Kdy po ní sáhnout:** když potřebujete cílit na konkrétní výskyt stejného elementu (např. „druhá barva“) a @@POSITION nestačí. * **Při slučování:** indexace vám dá kontrolu nad tím, ze kterého výskytu skládáte výslednou hodnotu. * **Když to není nutné:** pokud vám stačí pevné pořadí hodnot, je jednodušší a rychlejší použít @@POSITION. ## **Praktické příklady použití speciálních atributů** ### **1\. Cílení na rozsah pozic pomocí `@@POSITION`** Cesta pro alternativní obrázky od pozice 3 do 8: * IMGURL\_ALTERNATIVE { @@POSITION \>= 3 AND @@POSITION \= 3 AND @@POSITION [image2]: [image3]: [image4]: [image5]: [image6]: [image7]: [image8]: [image9]: [image10]: [image11]: [image12]: [image13]: [image14]: [image15]: [image16]: [image17]: [image18]: [image19]: [image20]: --- ## [Vyplatí se mi používání Mergada?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/co-je-mergado-a-jak-funguje/vyplati-se-mi-pouzivani-mergada/) # Vyplatí se mi používání Mergada? Stručná odpověď zní – ano. Pokud si aplikaci [vhodně nastavíte](https://forum.mergado.cz/t/jak-funguje-mergado-a-kdo-jej-nastavuje/jak-funguje-mergado-a-kdo-jej-nastavuje), dokážete s její pomocí navýšit své tržby o desítky procent a snadno tak převýšíte měsíční náklady za Mergado, které se obvykle pohybují v řádu několika stovek korun. A k tomu ušetříte i hromadu času, který je, jak všichni víme, k nezaplacení. Pojďme si ale všechny výhody trochu rozebrat. ### Hlavní výhody používání Mergada #### 1. Okamžité úpravy bez programátorů Mergado funguje jako „překladač“ mezi vaším e-shopem a inzertními kanály. Vložíte do něj svůj produktový feed a pomocí přehledného rozhraní provedete všechny potřebné úpravy i nastavení pravidel sami, bez nutnosti zásahu vývojářů. Úpravy, které by jinak musel řešit programátor, zvládnete během pár minut klikáním. Rychle, přehledně a bez čekání. Nemusíte ručně upravovat stovky nebo tisíce produktů pokaždé, když se něco změní. Nastavíte pravidlo a Mergado hromadně upraví data u všech položek, kterých se to týká. Díky tomu nejen výrazně zrychlíte práci, ale zároveň ušetříte nemalé náklady, které byste jinak platili za úpravy od programátorů. ##### Příklad: Máte 1000 produktů, u kterých potřebujete upravit název podle požadavků Heureky. Místo toho, abyste po jednom upravovali názvy produktů na vašem e-shopu nebo čekali na programátora, až upraví XML feed pro Heureku, otevřete Mergado, nastavíte pravidlo a Mergado názvy upraví pro všechny produkty. Úpravu provedete okamžitě, bez programátora a bez zasahování do vašeho e-shopu. #### 2. Zvýšení výkonu inzerce a tržeb Kvalita dat posílaných do inzertních systémů má přímý vliv na to, jak dobře se vaše produkty zobrazí a zda je vůbec reklamní platforma schválí. S Mergadem snadno odhalíte a opravíte chyby, které brání inzerci nebo snižují její výkon. S kvalitnějšími daty se budete zobrazovat na vyšších příčkách vyhledávání, což je velká výhoda v době, kdy jsou prokliky stále dražší. Při správném nastavení dokážete s Mergadem zvýšit míru prokliku (CTR) a navýšit své tržby až o desítky procent. ##### Příklad: Pokud některému produktu chybí EAN nebo je přiřazen do špatné kategorie, na reklamní platformě nebude při vyhledávání vidět nebo bude chybně zařazený. Mergado vám umožní tyto chyby rychle a na pár kliknutí opravit, čímž zvýšíte pravděpodobnost, že váš produkt osloví správného zákazníka. #### 3. Přehled a pořádek v datech Mergado nabízí nástroj [Mergado Audit](https://audit.mergado.com/), který zdarma zkontroluje kvalitu vašeho produktového feedu. Odhalí chyby, jako jsou například chybějící nebo špatné elementy, nepovolené hodnoty nebo duplicitní položky, a doporučí, co a jak opravit. Díky tomu budete mít jistotu, že vaše produktová data jsou kompletní, správná a vždy připravená k odeslání do inzertních kanálů. ##### Příklad: Mergado Audit odhalí, že názvy kategorií neodpovídají kategoriím cílové reklamní platformy. Díky našeptávači snadno nastavíte vhodné kategorie a zajistíte si tak správné párování produktů do produktových karet reklamní platformy, díky čemuž se vaše produkty budou správně zobrazovat. #### 4. Ušetření nákladů na inzerci Mergado vám umožní vytvořit si výběry produktů podle různých kritérií, například podle dostupnosti, marže, sezóny nebo marketingové kampaně. Můžete tak vždy propagovat jen zboží, jehož inzerce má v daném okamžiku smysl, a pracovat tak s reklamním rozpočtem smysluplně a efektivně. ##### Příklad: Ve svém produktovém katalogu máte letní kolekci i zimní zboží. V létě pochopitelně nechcete inzerovat boby nebo zimní bundy. V Mergadu nastavíte pravidlo, které vyloučí zimní produkty z letních kampaní. Budete tak propagovat pouze relevantní zboží, snížíte zbytečné náklady a zlepšíte efektivitu svých kampaní. #### 5. Snadná a rychlá expanze Mergado podporuje stovky inzertních platforem, srovnávačů, marketplaců i analytických systémů. Umožní vám snadno, rychle a bez složitých technických komplikací oslovit nové zákazníky nejen doma, ale i v zahraničí. ##### Příklad: Inzerujete na Kauflandu a rozhodli jste se, že chcete expandovat také na italský nebo francouzský trh? V Mergadu je to otázka několika kliknutí, kdy využijete připravenou integraci. Zvládnete to sami a bez složitých příprav. #### 6. Funkce, které šetří čas a posunou váš byznys před konkurenci Mergado není jen o základních úpravách feedu. Jeho funkce a [rozšíření](https://store.mergado.com/) vám poskytnou automatické překlady pro expanzi na zahraniční trhy, umožní automatické bidování nebo cenotvorbu, usnadní správu dodavatelských feedů, umožní hromadné úpravy obrázků, analýzy, synchronizaci dat z více zdrojů a poskytnou desítky dalších možností, jak vylepšit vaše podnikání, testovat nové trhy a rychle reagovat na změny. ##### Příklad: Dostáváte feed od dodavatele, který má jiný formát než potřebuje váš e-shop? S Mergadem snadno převedete dodavatelský feed do takové struktury, kterou vaše e-shopová platforma dokáže zpracovat. #### 7. Nízké náklady, vyzkoušení zdarma a podpora vždy k dispozici Mergado je navrženo tak, aby bylo cenově dostupné i pro menší e-shopy. [Cena](https://www.mergado.cz/cenik) se odvíjí podle počtu inzerovaných produktů. Navíc můžete využít 30denní zkušební verzi zdarma a otestovat si všechny funkce. A když narazíte na problém nebo nevíte, jak něco nastavit, Mergado nabízí [podporu](https://www.mergado.cz/kontakt), [návody](https://forum.mergado.cz/c/napoveda/88) i [školení](https://www.mergado.cz/skoleni) zdarma, které vám pomohou rychle nastartovat efektivní feed management. ## FAQ: Vyplatí se mi používání Mergada? ### Co je Mergado a k čemu ho můžu použít? Mergado je nástroj pro úpravu, správu a optimalizaci produktových feedů. Pomáhá vylepšit kvalitu dat, šetřit náklady na inzerci, efektivně expandovat na zahraniční trhy a automatizovat řadu marketingových a technických procesů. S Mergadem se dají veškeré úpravy zvládnou i bez hlubokých technických znalostí a bez programátora. ### Jak mi pomůže Mergado Audit? [Mergado Audit](https://audit.mergado.com/) je zdarma dostupný nástroj, který zkontroluje kvalitu vašeho produktového feedu. Odhalí chyby (např. chybějící elementy, nepovolené hodnoty, duplikáty, špatné kategorie) a doporučí, jak je opravit. Získáte tak jistotu, že jsou vaše data kompletní a připravená k odeslání do inzertních kanálů. ### Ušetřím díky Mergadu peníze na inzerci? Jak? Při správném nastavení ano. V Mergadu můžete vytvářet výběry produktů podle kritérií jako marže, dostupnost, sezónnost nebo typ kampaně. Díky tomu propagujete jen to, co se vyplatí, čímž eliminujete zbytečné náklady a posílíte výkon kampaní. ### Pomůže mi Mergado expandovat do zahraničí? Ano. Mergado podporuje stovky kanálů, srovnávačů a marketplaců po celém světě. Pomocí připravených integrací jednoduše napojíte svůj produktový feed a začnete inzerovat v zahraničí. Rychle a bez složitých technických komplikací. ### Pomůže mi Mergado i s dodavatelskými feedy? Ano, například pokud je dodavatelský feed ve formátu, který váš e-shop není schopen zpracovat, v Mergadu jej můžete převést do formátu, který vaše e-shopová platforma zvládne. Není potřeba programování, vše nastavíte klikáním pomocí pravidel. ### Jaké další funkce Mergado nabízí? Mergado jde daleko za běžné úpravy feedu. Mezi nejčastěji používané funkce patří: * automatické překlady pro expanzi do zahraničí, * automatické bidování a cenotvorba, * správa dodavatelských feedů, * hromadné úpravy obrázků, * synchronizace dat z více zdrojů, * analýzy, * a mnoho dalších funkcí, které umožní [Mergado rozšíření](https://store.mergado.com/). ### Je Mergado vhodné i pro malé e-shopy? Ano. Cena se odvíjí od počtu produktů, takže je dostupné i pro malé podniky s menšími katalogy. ### Můžu si Mergado vyzkoušet zdarma? Ano, Mergado nabízí 30denní zkušební verzi zdarma, kdy můžete naplno otestovat všechny funkce. ### Můžu se obrátit na podporu, když si s něčím nebudu vědět rady? Ano. K dispozici je bezplatná [technická podpora](https://www.mergado.cz/kontakt), [detailní návody](https://forum.mergado.cz/c/napoveda/88), [fórum](https://forum.mergado.cz/) i pravidelná [školení](https://www.mergado.cz/skoleni) zdarma. Pokud si nebudete jistí nastavením, tým Mergada vás provede celým procesem. ### Jak rychle mohu začít Mergado používat? Okamžitě. Stačí importovat produktový feed, pustit Audit a začít tvořit pravidla. Úpravy zvládnete i sami bez vývojáře. --- ## [Optimalizace dat pro Heureku: Jak opravit chyby v produktovém feedu a zajistit, že Heureka nebude zamítat produkty?](https://help.mergado.com/cs/mergado-editor/reklamni-kanaly-a-inzerce/heureka/optimalizace-dat-pro-heureku-jak-opravit-chyby-v-produktovem-feedu-a-zajistit-ze-heureka-nebude-zamitat-produkty/) # Optimalizace dat pro Heureku: Jak opravit chyby v produktovém feedu a zajistit, že Heureka nebude zamítat produkty? Pro úspěšnou inzerci na Heurece je nezbytné, aby produktový XML feed splňoval [veškeré požadavky Heureky](https://sluzby.heureka.cz/napoveda/xml-feed/#utm_source=chatgpt.com). To znamená, že musí obsahovat specifické elementy, které jsou základními stavební kameny datového souboru (XML feedu). O to, aby se struktura elementů z vašeho vstupního feedu „proměnila“ na strukturu, kterou požaduje Heureka, se postará Mergado. Vy jste však ti, kteří musí Mergadu říct, jakými informacemi má jednotlivé elementy plnit a především mu tyto informace musíte poskytnout ve svém vstupním feedu. V tomto článku si postupně ukážeme, k čemu jednotlivé elementy slouží, které z nich jsou nezbytné pro to, aby se následně vaše produkty na Heurece zobrazovaly, jak musí informace v nich obsažené vypadat a jak v Mergadu zařídit to, že elementy se budou automaticky plnit správnými informacemi bez toho, abyste to museli u každého produktu dělat ručně. ### Proč je potřeba znát Heureka elementy a pracovat s nimi? Možná už máte vlastní zkušenost s tím, že Heureka vám některé vaše produkty opakovaně zamítá a odmítá je zobrazovat. Můžou za to nesprávně vyplněné elementy, kvůli čemuž Heureka nedokáže vaše produkty spárovat s produktovými kartami a tudíž je nezobrazuje. Ale nebojte, nebudete muset u tisíců svých produktů ručně přepisovat všechny nesprávně vyplněné elementy podle požadavků Heureky. Od toho je tady Mergado. Kompletní seznam elementů, se kterými Heureka pracuje, najdete na [jejich webu](https://sluzby.heureka.cz/napoveda/xml-feed/#utm_source=chatgpt.com). Některé jsou povinné a mají přesně danou strukturu, některé povinné nejsou. Platí však, že čím kvalitněji a kompletněji budete mít vyplněný feed, tím lépe bude Heureka vaše produkty zobrazovat. ### Povinné elementy a elementy nezbytné pro správné párování Nejzásadnější pro zobrazení a správné párování vašich produktů do produktových karet Heureky jsou následující elementy: * PRODUCTNAME – povinný, obsahuje přesný název produktu * CATEGORYTEXT – obsahuje cestu do správné produktové kategorie podle katalogu Heureky * ITEM_ID – povinný, obsahuje unikátní a trvalé označení produktu v rámci e-shopu * PRICE_VAT – povinný, obsahuje cenu produktu * URL – povinný, obsahuje unikátní adresu, která odkazuje na stránku produktu na vašem e-shopu * DELIVERY – zahrnuje další elementy, které obsahují typ nabízené dopravy k jednotlivým produktům a cenu za dopravu * DELIVERY_DATE – obsahuje počet dnů do odeslání produktu * IMGURL – obsahuje odkaz na hlavní obrázek produktu * ITEMGROUP_ID – element, kterým se označuje (sdružuje) skupina produktů, jež tvoří varianty jednoho produktu * HEUREKA_CPC – obsahuje maximální cenu za proklik (tj. maximální CPC) * EAN – obsahuje ean, tzn. čárový kód produktu Dalšími elementy Heureka feedu jsou SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, MANUFACTURER_POSTAL_ADDRESS, MANUFACTURER_ELECTRONIC_ADDRESS, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE a SALES_VOUCHER. ### PRODUCTNAME PRODUCTNAME obsahuje přesný název produktu, je povinným elementem Heureka feedu a je potřebný pro správné zobrazení produktů. Tento element je klíčový pro párování produktů, tzn. pro zařazení vašich produktů do odpovídajících produktových karet na Heurece. Aby došlo ke správnému spárování, musí tedy element PRODUCTNAME obsahovat všechny povinné informace podle vybrané kategorie (např. u sortimentu oblečení musí být přímo v názvu uvedena velikost). Povinné údaje pro jednotlivé kategorie a příklady správných názvů najdete na [webu Heureky](https://sluzby.heureka.cz/napoveda/povinne-nazvy/). Např. pro kategorii Pánské ponožky jsou povinnými údaji Značka | Řada | Barva | Velikost. Správně vyplněný PRODUCTNAME tedy bude vypadat například takto: VoXX ponožky Setra tmavě šedé 35-38 Zároveň by tento element neměl obsahovat nadbytečné informace jako třeba dárek k produktu, informace o záruce a podobně. Maximální délka textu je omezena na 200 znaků, což si můžete automaticky pojistit nastavením pravidla [Zkrácení hodnoty](https://forum.mergado.cz/t/pravidlo-zkraceni-hodnoty/pravidlo-zkraceni-hodnoty). #### Jak do elementu PRODUCTNAME doplnit název výrobce? Nejjednodušší cestou, jak doplnit do elementu PRODUCTNAME název výrobce, je využít automatizaci, kterou Mergado nabízí. 1. U vybraného projektu klikněte na záložku Automatizace. 2. Klikněte na automatizaci z názvem Doplnění výrobce do názvu. 3. Vyplňte Název elementu s výrobcem, tzn. vyplňte element ze vstupního feedu, který obsahuje informaci o názvu výrobce (např. MANUFACTURER). 4. Vyplňte Název elementu se jménem produktu, tzn. vyplňte element ze vstupního feedu, který obsahuje informaci o názvu produktu (např. PRODUCTNAME). 5. Jako Výstupní název elementu se jménem produktu vyplňte PRODUCTNAME. 6. Klikněte na Spustit automatizaci. #### Jak do elementu PRODUCTNAME doplnit velikost nebo jiný parametr? Pokud chcete do elementu PRODUCTNAME doplnit další povinný parametr pro danou kategorii (např. velikost, materiál nebo zda je jedná o dámské/pánské/dětské zboží), je potřeba pro to v Mergadu vytvořit pravidlo. 1. U vybraného projektu si nejprve na stránce Produkty vytvořte výběr produktů, u kterých chcete do elementu PRODUCTNAME vložit vybraný parament (např. u kategorie Oblečení chcete do elementu PRODUCTNAME vložit parametr Velikost, vytvoříte tedy výběr produktů, který bude obsahovat všechny produkty z kategorie Oblečení). Podívejte se na náš návod, jak pracovat s [výběry produktů](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=5). 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Přepsat. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat. 5. Do kolonky Element vyplňte PRODUCTNAME (tedy element, který se bude na základě pravidla upravovat). 6. Do kolonky Nová hodnota vyplňte všechny elementy, které mají být v elementu PRODUCTNAME obsaženy. Protože pro každý produkt bude hodnota elementu jiná (každý produkt má jiný název/velikost/barvu), je potřeba tyto elementy označit jako tzv. proměnné. To uděláte tak, že element na začátku a na konci ohraničíte znakem „%“. Příklad: V tuto chvíli element PRODUCTNAME pro vybraný produkt obsahuje informaci „Nike tričko zelené“. Vy ale chcete, aby PRODUCTNAME nesl informaci „Nike tričko zelené XL“. Informace o velikosti je obsažena v elementu PARAM, který dále obsahuje PARAM_NAME (název parametru, např. velikost) a VAL (hodnota parametru, např. XL). Do kolonky Nová hodnota v nově vytvářeném pravidle proto vyplníte: %PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL% Mergado tak bude vědět, že nová hodnota elementu PRODUCTNAME má obsahovat původní hodnotu (%PRODUCTNAME%, např. Nike tričko zelené) a k tomu informaci, kterou najde v elementu PARAM → PARAM_NAME="VELIKOST" → VAL (např. XL). 7. Vyplňte název pravidla a klikněte na Vytvořit. Podobně můžete do elementu PRODUCTNAME doplnit i další parametry, např. materiál. V tom případě byste ještě za velikost doplnili %PARAM {PARAM_NAME="MATERIÁL"} | VAL% a Mergado by za „Nike tričko zelené XL“ doplnilo např. bavlna. Důležité je myslet na to, zda váš feed u vybraných parametrů skutečně obsahuje příslušné hodnoty, jinak Mergado pochopitelně nebude mít odkud brát informace a do PRODUCTNAME nedoplní nic. Dále je potřeba dávat pozor na to, abyste vždy „cestu“ k hodnotě parametru vyplnili správně a Mergado tak vědělo, jak se k ní dostat. Další informace a návody vztahující se k elementu [PRODUCTNAME](https://forum.mergado.cz/t/element-productname/2757). ### CATEGORYTEXT CATEGORYTEXT je element, který obsahuje celou cestu do správné produktové kategorie podle katalogu Heureky. Je to další důležitý element, který hraje roli při správném párování produktů. Pokud Heureka nezvládne kvůli nesprávně vyplněnému CATEGORYTEXT spárovat kategorie, nepostoupí dále k párování produktů do produktových karet a váš produkt tedy nebude na Heurece zobrazen. Je potřeba uvést kompletně celou cestu, ideálně podle [stromu kategorií Heureky](https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml?_gl=1*dqcpbm*_gcl_aw*R0NMLjE3NjAwNzczMjguQ2p3S0NBand1cDNIQmhBQUVpd0E3ZXVadXE5eUx5VkVNbEdxRkg2NXktTGpKa2FSNXNDdi1TWjFnN0F1cWVYbTNmV3dIc1ZoS3d3b0V4b0NvaXdRQXZEX0J3RQ..*_gcl_au*MTQ3NTUyMjc3OC4xNzU2NzE1MzkzLjg3MDExNjE5LjE3NjE3Mjc2MzEuMTc2MTcyNzY0Mw..). V takovém případě Heureka kategorie automaticky spáruje a postoupí k párování produktů do produktových karet. Použít můžete i vlastní názvy kategorií, proces párování se tím ale prodlouží a hrozí riziko, že kategorie a tedy i produkty nebudou spárovány a vaše zboží nebude na Heurece zobrazeno. Příklad správně vyplněného elementu CATEGORYTEXT (např. pro pračku): Heureka.cz | Velké spotřebiče | Pračky a sušičky | Pračky Příklad špatně vyplněného elementu CATEGORYTEXT (např. pro pračku): Heureka.cz | Velké spotřebiče | Pračky a sušičky #### Jak nastavit správné kategorie podle stromu kategorií Heureky? Mergado data o stromu kategorií Heureky denně načítá a aktualizuje a přiřazování správných kategorií vám obrovsky usnadní. Správné kategorie jednoduše nastavíte s pomocí pravidla Hromadné přejmenování kategorií. 1. U vybraného projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidla zvolte Hromadné přejmenování kategorií. 3. Pokud chcete pojmenovat kategorie podle stromu Heureky u všech produktů, zvolte ve výběrech možnost Všechny produkty. Případně vyberte nebo vytvořte nový výběr produktů, u kterých chcete přejmenovat kategorie. 4. Pokud si chcete usnadnit práci, klikněte na tlačítko Navrhnout kategorie. Mergado tak samo vyplní na levé straně kategorie, které se vyskytují ve vašem vstupním feedu, a na pravé straně k nim přiřadí odpovídající kategorie podle stromu kategorií Heureky. Tento návrh Mergada následně zkontrolujte a v případě potřeby upravte. * Další možností je kliknout na šipku u tlačítka Navrhnout kategorie a kliknout na Předvyplnit levou stranu, kdy vám Mergado samo doplní pouze kategorie vyskytující se ve vašem vstupním feedu a vy si k nim sami přiřadíte odpovídající kategorie podle stromu Heureky. * Případně nemusíte zvolit ani jednu z předchozích možností a kategorie si na obou stranách vyplníte sami. Toto je ideální volba, pokud chcete například přejmenovat jen některé kategorie. * Ať už si zvolíte jakoukoliv možnost přiřazování, na levé i na pravé straně vám Mergado bude kategorie našeptávat, takže je nemusíte nikde složitě dohledávat. 5. Pokud nechcete procházet a kontrolovat všechny kategorie, můžete si díky kolonce Zobrazit pouze vyfiltrovat jen chybné řádky (Konfliktní řádky, Neplatné kategorie na výstupu nebo Hodnoty chybějící na vstupu). 6. Vyplňte název pravidla a klikněte na Vytvořit. Více podrobností o pravidle [Hromadné přejmenování kategorií](https://www.youtube.com/watch?v=Bdm0gnnzz4s). Další informace a návody vztahující se k elementu [CATEGORYTEXT](https://forum.mergado.cz/t/element-categorytext/2770). ### ITEM_ID ITEM_ID obsahuje unikátní identifikátor produktu a je povinným elementem Heureka feedu. Bez jeho vyplnění nedojde k zobrazení vašeho zboží na Heurece. Díky němu je Heureka schopná identifikovat jednotlivé produkty pro službu Ověřeno zákazníky nebo v případě, že napojujete také dostupnostní feed. Pokud tento kód změníte, dojde k odpárování produktů a začne nový proces zařazování produktů do produktových karet. Může obsahovat maximálně 36 znaků a lze použít malá a velká písmena bez diakritiky, čísla, pomlčky a podtržítka. Každý produkt musí mít svůj vlastní unikátní ITEM_ID. Tento element se nepoužívá pro párování produktů. #### Jak doplnit ITEM_ID pokud ho ve svém feedu nemám? Pokud ve svém feedu element ITEM_ID vůbec nemáte, případně máte, ale neobsahuje žádné unikátní identifikátory, lze si je snadno vytvořit a naplnit v Mergadu. Nejjednodušší možností, jak vytvořit a doplnit chybějící ITEM_ID je využití automatizace ITEM_ID z MERGADO_ID. Tato automatizace vytvoří element ITEM_ID a následně jej naplní unikátními číselnými kódy. Automatizaci lze použít i v případě, že element ITEM_ID ve feedu máte, ale potřebujete jej naplnit vhodnými hodnotami. 1. U vybraného projektu přejděte na stránku Automatizace. 2. Klikněte na automatizaci ITEM_ID z MERGADO_ID. 3. Není potřeba nic vyplňovat, Mergado samo rozpozná, zda je potřeba vytvořit element, nebo již existuje a pouze jej naplní hodnotami. Stačí tedy pouze kliknout na Spustit automatizaci. Další možností, jak vyplnit element ITEM_ID, je nastavení pravidla Přepsat, kdy využijete proměnnou @MERGADO_ID. Tuto proměnnou automaticky vytváří Mergado při tvorbě projektu a pro každý produkt obsahuje unikátní číslo. 1. U vybraného projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidl zvolte Přepsat. 3. Jako výběr zvolte Všechny produkty. 4. Na levé straně vyplňte element, který chcete naplnit, v tomto případě tedy ITEM_ID. 5. Na pravé straně vyplňte proměnnou, jejíž hodnotou chcete naplnit element ITEM_ID. V tomto případě tedy doplňte %@MERGADO_ID%. Nezapomeňte, že se jedná o proměnnou (pro každý produkt obsahuje jinou hodnotu) a je tedy nutné ji ohraničit znakem %. 6. Vyplňte název pravidla a klikněte na Vytvořit. Myslete však na to, že pokud pro naplnění elementu ITEM_ID použijete proměnnou @MERGADO_ID, ID produktů v Heureka feedu nebude shodné s ID produktů posílaných do Heureky v kódu pro měření konverzí. Nebudou se tak správně párovat statistiky z měření konverzí. Další informace a návody vztahující se k elementu [ITEM_ID](https://forum.mergado.cz/t/element-item-id/2743). ### PRICE_VAT PRICE_VAT obsahuje konečnou cenu produktu včetně DPH (a případných autorských nebo recyklačních poplatků) a je povinným elementem Heureka feedu. Bez jeho vyplnění nedojde k zobrazení vašeho zboží na Heurece. Ceny musí být uvedeny v Kč (případně v € u slovenské Heureky), oddělovačem pro desetinná místa může být čárka (,) nebo tečka (.) a tisíce mohou nebo nemusí být odděleny mezerou (může být 25000 i 25 000). Je možné uvádět maximálně dvě desetinná místa. Do elementu uvádějte pouze číselnou hodnotu, bez symbolu měny Kč nebo €. #### Jak automaticky měnit cenu podle konkurence? Pro automatické nastavování cen na vašem e-shopu a Heurece je ideální rozšíření [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about). Pricing Fox sleduje konkurenci a zajistí, aby ceny vašich produktů byly atraktivní pro zákazníky a zároveň výdělečné. Neustále vyhodnocuje trh a podle vašich pravidel pravidelně přeceňuje zboží tak, aby chránil marži a posílil vaše prodeje. Navíc získáte dokonalý přehled o tom, kdo jsou vaši konkurenti, jak se vyvíjí jejich ceny a skladová dostupnost v čase, jakou mají pozici v biddingu, jaké dávají dárky k nákupu, kdo jsou jejich výrobci nebo v jakých kategoriích prodávají. Další informace a návody vztahující se k elementu [PRICE_VAT](https://forum.mergado.cz/t/element-price-vat/2765). ### URL URL obsahuje odkaz na produkt ve vašem e-shopu, kde jej může zákazník vložit do košíku a následně zakoupit. Tento element je povinný a bez jeho vyplnění nedojde k zobrazení vašeho zboží na Heurece. Každý produkt musí mít unikátní URL a maximální délka adresy může být 300 znaků (což si můžete automaticky pojistit nastavením pravidla [Zkrácení hodnot](https://forum.mergado.cz/t/pravidlo-zkraceni-hodnoty/pravidlo-zkraceni-hodnoty)). Při změně URL dojde k odpárování produktu a novému procesu zařazování do správné produktové kategorie. #### Jak odlišit URL variant, které mám v e-shopu na jedné adrese? Pokud má některý produkt více variant, je nutné, aby každá varianta měla svou vlastní URL. Pokud tedy máte varianty produktů ve svém e-shopu na jedné stránce, je potřeba pro každou variantu vytvořit unikátní URL. V Mergadu se to dá vyřešit tak, že na konec URL přidáte znak # a za něj pro každou variantu unikátní číselný kód ze systémové proměnné @MERGADO_ID. Tuto proměnnou nemusíte vytvářet, Mergado ji automaticky vytvoří při tvorbě projektu, kdy každému produktu přidělí unikátní číselný kód. Takto vytvoříte pro každou variantu unikátní odkaz, aniž by byl ovlivněn odkaz na produktovou stránku na vašem e-shopu. Pro vytvoření pravidla: 1. Nejprve si na stránce Produkty vytvořte výběr produktů, u kterých chcete upravit URL. V tomto případě tedy výběr produktů, které mají varianty. Podívejte se na návod, jak pracovat s [výběry produktů](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=5). 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Přepsat. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat. 5. Do kolonky Element vyplňte URL (tedy element, který se bude na základě pravidla upravovat). 6. Do kolonky Nová hodnota vyplňte čím má být původní URL nahrazeno. V tomto případě tedy: %URL%#%@MERGADO_ID% 7. Vyplňte název pravidla a klikněte na Vytvořit. Tímto pravidlem zajistíte, že každá varianta bude mít za znakem # odlišný číselný kód a URL tedy nebude stejná. Funkčnost původního URL by neměla být ovlivněna (je však dobré si to ověřit) a pro Heureku bude splněna podmínka unikátnosti adres pro každý produkt. #### Jak doplnit UTM parametry do URL jednotlivých produktů? Pokud chcete mít přehled o tom, kolik zákazníků k vám přichází proklikem z Heureky, pak budete pravděpodobně chtít do URL jednotlivých produktů doplnit tzv. UTM parametry. V Mergadu to jednoduše vyřešíte pravidlem [Nastavit UTM parametry](https://forum.mergado.cz/t/pravidlo-nastavit-utm-parametry/pravidlo-nastavit-utm-parametry). 1. U vybraného projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidla vyberte Nastavit UTM parametry. 3. Ve výběru produktů zvolte Všechny produkty (nebo si vytvořte výběr konkrétních produktů, u kterých chcete nastavit UTM parametry). 4. Jako Element zvolte URL. 5. Vyplňte požadované parametry. 6. Vyplňte název pravidla a klikněte na Vytvořit. Další informace a návody vztahující se k elementu [URL](https://forum.mergado.cz/t/element-url/2760). ### DELIVERY DELIVERY je „obálkou“, která v sobě nese elementy: * DELIVERY_ID (identifikátor dopravce) * DELIVERY_PRICE (cena dopravy pro daného dopravce včetně DPH při platbě předem) * DELIVERY_PRICE_COD (cena dopravy pro daného dopravce včetně DPH při platbě na dobírku) Ve feedu se bude element DELIVERY opakovat tolikrát, kolik způsobů dopravy lze pro váš produkt využít. Pokud tedy nabízíte tři způsoby dopravy (např. PPL, Zásilkovna, Balíkovna), ve vašem feedu bude DELIVERY třikrát. Jednou bude vyplněn informacemi pro PPL, podruhé informace pro Zásilkovnu a potřetí pro Balíkovnu. Elementy DELIVERY_ID a DELIVERY_PRICE jsou povinné, DELIVERY_PRICE_COD ve svém feedu nemusíte mít, pokud zboží u vybraného dopravce není možné doručit na dobírku. Heureka dovoluje ve feedu uvádět pouze vybrané dopravce, které najdete ve specifikaci na jejich [webu](https://sluzby.heureka.cz/napoveda/xml-feed/?_gl=1*ov176c*_gcl_aw*R0NMLjE3NjAwNzczMjguQ2p3S0NBand1cDNIQmhBQUVpd0E3ZXVadXE5eUx5VkVNbEdxRkg2NXktTGpKa2FSNXNDdi1TWjFnN0F1cWVYbTNmV3dIc1ZoS3d3b0V4b0NvaXdRQXZEX0J3RQ..*_gcl_au*MTQ3NTUyMjc3OC4xNzU2NzE1MzkzLjg3MDExNjE5LjE3NjE3Mjc2MzEuMTc2MTcyNzY0Mw..#DELIVERY). #### Jak přidat dopravce a nastavit cenu dopravy? Pro přidání dopravce a nastavení ceny za dopravu použijte pravidlo Nastavení ceny dopravy. 1. U vybraného projektu si nejdříve na stránce Produkty vytvořte [výběry produktů](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=6), u kterých budete chtít nastavit dopravce a ceny za dopravu. Můžete například chtít odlišit cenu dopravy podle ceny zboží nebo podle hmotnosti. * Vytvořit výběry zboží na základě cenových hladin můžete jednoduše s pomocí automatizace [Segmentace do 5. cenových hladin](https://forum.mergado.cz/t/jak-a-proc-v-mergadu-nastavit-cenove-hladiny/jak-a-proc-v-mergadu-nastavit-cenove-hladiny). Obdobně s pomocí automatizace Segmentace dle hmotnosti zboží vytvoříte výběry produktů na základě jejich hmotnosti. * V případě, že chcete u všech produktů nastavit stejnou cenu za dopravu, není potřeba tyto výběry vytvářet. 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Nastavení ceny dopravy. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat (např. vyberte určitou cenovou hladinu nebo zvolte Všechny produkty). 5. Na levé straně vyplňte vybrané dopravce. Mergado vám bude našeptávat dopravce, které Heureka povoluje. Případně můžete kliknout na Předvyplnit levou stranu a Mergado vyplní všechny doprace povolené Heurekou. 6. Na pravé straně vyplňte cenu pro vybraného dopravce při platbě předem (případně také při platbě na dobírku, pokud to dopravce umožňuje). 7. Vyplňte název pravidla a klikněte na Vytvořit. Pokud nastavujete odlišnou cenu pro jednotlivé cenové hladiny nebo skupiny produktů podle hmotnosti, opakujte tento postup a pro každý výběr nastavte samostatné pravidlo. #### Jak u některých produktů nastavit dopravu zdarma? 1. U vybraného projektu si nejdříve na stránce Produkty vytvořte výběr produktů, pro které chcete nastavit dopravu zdarma (např. výběr produktů pro zboží s cenou nad 2000 Kč). 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Nastavení ceny dopravy. 4. Zvolte výběr produktů, u kterých chcete nastavit dopravu zdarma. 5. Na levé straně vyplňte vybrané dopravce. Mergado vám bude našeptávat dopravce, které Heureka povoluje. Případně můžete kliknout na Předvyplnit levou stranu a Mergado vyplní všechny dopravce povolené Heurekou. 8. Na pravé straně do kolonek pro cenu vyplňte nulu: „0“. 9. Vyplňte název pravidla a klikněte na Vytvořit. #### Jak z feedu smazat některé dopravce? Pokud se rozhodnete smazat některého dopravce, použijte pravidlo Nastavení ceny dopravy. 1. U vybraného projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidla vyberte Nastavení ceny dopravy. 3. Zvolte výběr produktů, u kterých chcete smazat určitého dopravce. 4. Na levé straně vyplňte dopravce, kterého chcete odstranit. 5. Na pravé straně nechce kolonky nevyplněné. (Nevyplňujte nulu, pomlčku, x ani jiné znaky. Nechte pole prázdné.) 6. Vyplňte název pravidla a klikněte na Vytvořit. Tím se vybraný dopravce odstraní z feedu, protože Mergado do výstupního feedu nepropisuje elementy, které nemají vyplněnou hodnotu. Další informace a návody vztahující se k elementu [DELIVERY](https://forum.mergado.cz/t/element-delivery/2775). ### DELIVERY_DATE DELIVERY_DATE obsahuje informaci o dodací době produktu, tzn. o době od přijetí platby (nebo objednávky v případě dobírky) do odeslání zboží. Do elementu je potřeba vyplnit číselnou hodnotu v podobě pouze jednoho čísla, nikoliv rozmezí. Např. pokud bude zboží odesláno za čtyři dny (případně do čtyř dní), do elementu doplňte číslici 4. Heureka pak tyto číselné hodnoty zobrazí jako textový popis: |DELIVERY_DATE|Text na Heurece| | --- | --- | |0|skladem| |1 až 3|do 3 dnů| |4 až 7|do týdne| |8 až 14|do 2 týdnů| |15 až 30|do měsíce| |31 a více|více než měsíc| |bez vyplněné hodnoty|info v obchodu| V případě, že bude zboží skladem od určitého data a je možné na něj dělat předobjednávky, vyplňte do DELIVERY_DATE datum, od kdy bude zboží skladem, ve formátu rrrr-mm-dd (např. 2025-03-25). Nejsnadněji element DELIVERY_DATE vyplníte s pomocí pravidla Přepsat. Pro zboží, které máte skladem, vyplňte do elementu hodnotu nula: 0. Takovéto zboží jednoduše skryjete pomocí pravidla Skrytí produktu. Stejně můžete skrýt také produkty, které mají dlouhou dobu dodání a zákazníci je tedy pochopitelně pravděpodobně nakoupí tam, kde je skladem. Inzerování takového zboží by tedy pro vás bylo zbytečným plýtváním nákladů. #### Jak skrýt produkty, které mají dlouhou dobu dodání nebo nevím, kdy budou opět dostupné? 1. U vybraného projektu si nejdříve na stránce Produkty vytvořte výběr produktů, pro které chcete vytvořit skrývací pravidlo. (Např. výběr produktů, které mají hodnotu DELIVERY_DATE větší než 10, nebo výběr produktů, které nemají v DELIVERY_DATE žádnou hodnotu, protože nevíte, kdy bude zboží dostupné). 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Skrytí produktu. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat. 5. Vyplňte název pravidla a klikněte na Vytvořit. Hodnota DELIVERY_DATE však v produktovém feedu nemusí být vždy aktuální. Je proto možné do Heureky posílat další XML feed, tzv. dostupnostní feed (váš shopsystém by jej měl generovat sám). Tento feed si Heureka načítá každých deset minut a informace z něj mají přednost před informacemi z hlavního produktového feedu (tedy před informace obsaženými v DELIVERY_DATE). Díky tomu má vždy aktuální informace o dostupnosti zboží a o tom, kolik kusů daného zboží vám ještě zbývá skladem. Jak má Heureka dostupností feed vypadat, najdete na [jejich webu](https://sluzby.heureka.cz/napoveda/dostupnostni-feed). Přečtěte si více informací o [dostupnostním feedu](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed). Další informace a návody vztahující se k elementu [DELIVERY_DATE](https://forum.mergado.cz/t/element-delivery-date/2773). ### IMGURL IMGURL obsahuje adresu odkazu na hlavní obrázek produktu. V adrese nesmí být mezery a diakritika a adresa může být stejná pro více produktů. Základní požadavky na produktový obrázek jsou: * Minimální velikost obrázku je 20 × 50 pixelů (nebo 50 × 20) a 30 kB. Avšak Heurekou doporučená velikost je alespoň 175 × 175 pixelů, tedy přibližně 30 000 pixelů. * Maximální velikost je 4096 × 4096 pixelů a 2000 kB. * URL obrázku může mít maximálně 255 znaků. * Podporované formáty jsou webp, jpeg, png, bmp. * Obrázek nesmí obsahovat vodoznaky, zobrazení slevy nebo bonusu ani upozornění na ocenění nebo přednost produktu. Zda vaše produktové obrázky splňují požadavky Heureky, snadno zjistíte spuštěním [Auditu obrázků](https://audit-obrazku.cz/), který je zdarma. #### Jak u obrázků hromadně upravit rozměry podle požadavků Heureky? Upravení velikosti, odstranění vodoznaků i vylepšení kvality rychle, jednoduše a hromadně vyřešíte pomocí rozšíření [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about). Více informací i konkrétní návody najdete na [webu tohoto rozšíření](https://www.feed-image-editor.cz/). Další informace a návody vztahující se k elementu [IMGURL](https://forum.mergado.cz/t/element-imgurl/2762). ### ITEMGROUP_ID ITEMGROUP_ID je element, s jehož pomocí označíte skupinu produktů, které jsou variantami jednoho produktu. Pro označení skupiny můžete využít kód dlouhý maximálně 36 znaků a může jít o kombinaci podtržítka, pomlčky, čísel 0 až 9 a malých a velkých písmen bez diakritiky. Toto označení variant je nezbytné z toho důvodu, že Heureka požaduje, aby byla každá varianta produktu ve feedu zobrazena jako samostatný produkt. Všechny varianty jednoho produktu označíte jedním společných kódem vloženým do elementu ITEMGROUP_ID. O varianty jde v případě, že se jedná o různé velikosti, barvy, vzory nebo druhy jednoho produktu. Příklad: Ve svém feedu máte tenisky Adidas Superstar ve velikostech 36, 37 a 38. Všechny tři varianty tohoto produktu v Heureka feedu označíte jedním společných kódem (např. ZD563) obsaženým v elementu ITEMGROUP_ID. #### Jak doplnit do feedu hodnoty ITEMGROUP_ID, když chybí? V tomto případě se dá postupovat různými způsoby v závislosti na typu vašeho feedu. Jednou z možností je například využití pravidla [Import datového souboru](https://forum.mergado.cz/t/pravidlo-import-datoveho-souboru-csv-xml/pravidlo-import-datoveho-souboru-csv-xml), kdy si hodnoty pro tento element do Mergada importujete zvlášť v samostatném souboru. Pokud si však nebudete vědět rady, kontaktujte naši [technickou podporu](https://www.mergado.cz/kontakt) na e-mailu mergado@mergado.cz a společně se pokusíme najít řešení přesně pro váš feed. Další informace a návody vztahující se k elementu [ITEMGROUP_ID](https://forum.mergado.cz/t/element-itemgroup-id/2776). ### HEUREKA_CPC HEUREKA_CPC obsahuje maximální cenu, kterou jste ochotni zaplatit za proklik, tedy přivedení zákazníka z Heureky do vašeho e-shopu. Desetinná místa se v tomto elementu oddělují desetinnou čárkou. Maximální možná cena za proklik je 1000 Kč. Pokud si nepřejete [biddovat](https://www.bidding-fox.cz/jak-funguje-bidding), tedy nastavovat cenu za proklik, element nechte nevyplněný (nedoplňujte nulu ani žádný jiný znak). Vhodnou cenu za proklik můžete nastavovat například na základě [cenových hladin](https://forum.mergado.cz/t/jak-a-proc-v-mergadu-nastavit-cenove-hladiny/jak-a-proc-v-mergadu-nastavit-cenove-hladiny), kdy si sortiment rozdělíte do výběrů podle ceny. Následně například skupině produktů s nízkými cenami a malou marží nastavíte nižší CPC (cost per click / cena za proklik), abyste na nich neprodělávali. A naopak skupině dražších produktů s vyšší marží nastavíte vyšší CPC. #### Jak nastavit bidding pro Heureku na základě cenových hladin? Jednou z možností, jak v Mergadu nastavit bidding (a tedy vyplnit element HEUREKA_CPC), je využití pravidla Nastavení cen za prokliky. 1. Nejdříve si vytvořte vhodné výběry produktů dle [cenových hladin](https://forum.mergado.cz/t/jak-a-proc-v-mergadu-nastavit-cenove-hladiny/jak-a-proc-v-mergadu-nastavit-cenove-hladiny). 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Nastavení cen za prokliky. 4. V kolonce Výběry zvolte cenovou hladinu, pro kterou chcete nastavit cenu za proklik. 5. Zvolte, zda chcete cenu za proklik vypočítávat podle: 1. Minimální ceny prokliku – Pravidlo zohlední minimální ceny za proklik pro zboží v jednotlivých kategoriích (minimální ceny udává Heureka) a vy můžete navýšit tuto cenu o libovolnou částku, kterou vyplníte do kolonky Přičíst k minimálnímu CPC (Kč). 2. Procenta z ceny zboží – Zde si v kolonce Procento z ceny produktu určíte procentuální hodnotu z ceny zboží, kterou chcete nabídnout za proklik. Např. Pokud nastavíte 1 % z ceny, u produktu za 500 Kč bude pravidlo nabízet cenu za proklik 5 Kč. 6. Vyplňte Název pravidla. 7. Klikněte na Vytvořit. 8. Stejně postupujte i u ostatních cenových hladin a nezapomeňte následně vytvořená pravidla aplikovat. Nastavit CPC pro Heureku lze také s pomocí pravidla Hromadné přepisování dle výběrů, kdy CPC pro jednotlivé cenové hladiny nastavíte hromadně jedním pravidlem. 1. Nejdříve si vytvořte vhodné výběry produktů dle [cenových hladin](https://forum.mergado.cz/t/jak-a-proc-v-mergadu-nastavit-cenove-hladiny/jak-a-proc-v-mergadu-nastavit-cenove-hladiny). 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Hromadné přepisování dle výběrů. 4. Jako element, který bude pravidle přepisován, vyplňte HEUREKA_CPC. 5. Na levé straně vyplňte výběry, tedy jednotlivé cenové hladiny, které jste si vytvořili. 6. Na pravé straně vyplňte k jednotlivým cenovým hladinám zvolenou cenu za proklik. * Toto pravidlo nevypočítává CPC pomocí nějakého vzorce, jako tomu je u pravidla Nastavení cen za prokliky. Zde je potřeba vyplnit finální hodnotu CPC, kterou jste ochotni zaplatit. 7. Vyplňte Název pravidla. 8. Klikněte na Vytvořit. 9. Nezapomeňte následně pravidlo aplikovat. #### Jak nastavit bidding pro Heureku na základě marže, kategorie, výrobce nebo různých parametrů? ##### Podle marže Cenu za proklik pochopitelně nemusíte nastavovat pouze na základě cenových hladin. CPC můžete nastavit třeba podle marže, kdy si podobně jako u cenových hladin rozdělíte sortiment do několika výběrů, avšak na základě výše marže. V tomto případě je však nutné mít ve svém feedu element, který bude naplněn informací o marži. Poté opět využijete pravidlo Nastavení cen za prokliky nebo Hromadné přepisování dle výběrů. ##### Podle kategorií, výrobce nebo různých parametrů Další možností je nastavení CPC například podle kategorií, výrobce nebo parametrů jako třeba materiál. V takových případech je nejjednodušší využít pravidlo Hromadné přepisování dle hodnot. 1. Na stránce Pravidla klikněte na Nové pravidlo. 2. Jako Typ pravidla vyberte Hromadné přepisování dle hodnot. 3. Zvolte výběr produktů, na který chcete pravidlo aplikovat, nebo zvolte Všechny produkty. 4. Na levé straně do kolonky Element, ve kterém hledáte vyplňte element, na základě kterého chcete nastavovat CPC. * Pro nastavení podle kategorií zvolte element CATEGORYTEXT. * Pro nastavení podle výrobce zvolte MANUFACTURER. 5. Na pravé straně do kolonky Element, do kterého zapisujete vyplňte HEUREKA_CPC. 6. Následně do kolonek vlevo vyplňte hodnoty zvoleného elementu a vpravo příslušnou hodnotu CPC. * Pro nastavení podle kategorií vyplňte jednotlivé kategorie (např. trička, košile, kalhoty apod.) a k nim zvolenou cenu za proklik. * Pro nastavení podle výrobce vyplňte jednotlivé výrobce (např. Adidas, Nike, Reebok apod.) a k nim zvolenou cenu za proklik. 7. Vyplňte Název pravidla. 8. Klikněte na Vytvořit. 9. Nezapomeňte následně pravidlo aplikovat. #### Jak nastavit automatický bidding, aby se HEUREKA_CPC vhodně upravovalo samo? Pro nastavení automatického biddingu je ideální rozšíření [Bidding Fox](https://store.mergado.com/detail/biddingfox). Analyzuje prodejní potenciál produktů a dynamicky řídí jejich inzerci, aby byly maximálně viditelné. Naopak u položek s nízkým potenciálem inzerci utlumí, a šetří tak váš kredit. Biddování upravuje několikrát denně podle nejaktuálnějších dat, které ověřuje přímo na Heurece. Navíc vám umožní sledovat CPC vašich konkurentů a upravovat inzerci i na základě těchto informací. Další informace a návody vztahující se k elementu [HEUREKA_CPC](https://forum.mergado.cz/t/element-heureka-cpc/2772). najdete [tady](https://forum.mergado.cz/t/element-heureka-cpc/2772). ### EAN EAN obsahuje kód, který označuje jednotlivé druhy zboží. Jeho uvádění je povinné pro kategorie Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy. Pro ostatní kategorie není povinný, ale je doporučeno jej uvádět u všech produktů. Narozdíl od elementu ITEM_ID nejde o libovolné kódy, kterými můžete označit své zboží. Jde o oficiální, tzv. čárové kódy. Heureka podporuje formát EAN-13. Heureka sice nepáruje zboží do produktových karet na základě EAN kódů, avšak v [Reportu nespárovaných produktů](https://sluzby.heureka.cz/napoveda/co-je-report-nesparovanych-produktu/), který Heureka generuje a ve kterém najdete informace o nespárovaných produktech, pracuje právě s EAN kódy. Pokud tedy Heurece budete posílat EANy, nespárované produkty dohledá na základě EANů a v reportu vám doporučí správný název a kategorii pro spárování. [Report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/) nespárovaných produktů najdete na Heurece v administraci vašeho obchodu pod záložkou Spárovanost produktů. Je dostupný pouze pro e-shopy v PPC režimu a Heureka jej generuje jednou denně. Pokud máte ve feedu správně vyplněné EAN kódy a nechcete ztrácet čas manuálním párováním produktů a procházením [Report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/)u nespárovaných produktů, využijte rozšíření [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about). Rozšíření automaticky na základě EANů spáruje vaše zboží s produktovými kartami na Heurece a u položek, které nelze spárovat, nabídne inteligentní doporučení, například úpravu názvu nebo kategorie. #### Jak ve feedu vyhledat produkty s chybným EAN? Produkty s chybným EAN snadno vyhledáte s pomocí automatizace Vyhledat produkty s nevalidním EAN. 1. U vybraného projektu klikněte na záložku Automatizace. 2. Klikněte na automatizaci z názvem Vyhledat produkty s nevalidním EAN. 3. Automatizace má jako element s ean kódy přednastaven EAN. Ponechte to takto. 4. Klikněte na Spustit automatizaci. Automatizace vám produkty s chybným EAN uloží do výběru s názvem „Produkty s nevalidním EAN“. Následně můžete kódy opravit, případně toto zboží dočasně skrýt (pravidlo Skrytí produktu), než EANy opravíte. #### Jak ve feedu vyhledat produkty s chybějícím EAN? Produkty s chybějícím EAN můžete vyhledat tak, že si pro ně vytvoříte výběr. 1. Na stránce Produkty si v tabulce zvolte možnost Jednoduché rozhraní. 2. U možnosti Hledat produkty zvolte na vstupu. 3. Do kolonky pro vyhledávání napište EAN a následně zvolte možnost je prázdný. 4. Klikněte na Hledat. 5. Vyhledají se vám všechny produkty, které mají chybějící EAN. 6. Vyplňte název výběru (např. Produkty s chybějícím EAN). 7. Klikněte na Uložit. Na stejné stránce klikněte na záložku Uložené výběry, kde tento výběr najdete. Ideálně se snažte u těchto produktů EAN co nejdříve doplnit. Další informace a návody vztahující se k elementu [EAN](https://forum.mergado.cz/t/element-ean/2761). ### DALŠÍ HEUREKA ELEMENTY Informace o ostatních elementech Heureka feedu najdete na [našem fóru](https://forum.mergado.cz/c/napoveda/heureka-a-mergado/118): [SHOP](https://forum.mergado.cz/t/element-shop/2741), [SHOPITEM](https://forum.mergado.cz/t/element-shopitem/2742), [PRODUCT](https://forum.mergado.cz/t/element-product/2758), [DESCRIPTION](https://forum.mergado.cz/t/element-description/2759), [IMGURL_ALTERNATIVE](https://forum.mergado.cz/t/element-imgurl-alternative/2763), [VAT](https://forum.mergado.cz/t/element-vat/2766), [ITEM_TYPE](https://forum.mergado.cz/t/element-item-type/2767), [PARAM](https://forum.mergado.cz/t/element-param/2768), [MANUFACTURER](https://forum.mergado.cz/t/element-manufacturer/2769), [ISBN](https://forum.mergado.cz/t/element-isbn/2771), [ACCESSORY](https://forum.mergado.cz/t/element-accessory/2777), [GIFT](https://forum.mergado.cz/t/element-gift/2778), [EXTENDED_WARRANTY](https://forum.mergado.cz/t/element-extended-warranty/2779), [SPECIAL_SERVICE](https://forum.mergado.cz/t/element-special-service/2780) a [SALES_VOUCHER](https://forum.mergado.cz/t/element-sales-voucher/2781). # FAQ: Optimalizace dat pro Heureku: Jak opravit chyby v produktovém feedu a zajistit, že Heureka nebude zamítat produkty? ### Proč Heureka některé produkty nezobrazuje nebo zamítá? Nejčastěji je to kvůli chybějícím nebo špatně vyplněným elementům ve vašem produktovém XML feedu. Heureka má specifické požadavky pro to, jak by měl produktový feed vypadat a nesprávně vyplněné elementy brání spárování do produktových karet. Mergado zdarma nabízí [Audit feedu](https://audit.mergado.com/), který si můžete kdykoliv spustit a který odhalí chyby a rovnou doporučí jejich řešení. ### Jak mi Mergado pomůže s párováním produktů na Heurece? Mergado převede strukturu vašeho vstupního feedu do formátu Heureky a umožní vám s pomocí pravidel a automatizací hromadně doplnit nebo opravit hodnoty elementů, aby odpovídaly požadavkům Heureky. Opravy Mergado provede hromadně a automatizovaně, takže nebudete muset chyby u každého produktu opravovat ručně. ### Které elementy jsou zásadní pro správné párování a zobrazování produktů na Heurece? Nejzásadnějšími elementy pro správné párování produktů jsou PRODUCTNAME (povinný element obsahující přesný název produktu) a CATEGORYTEXT (obsahuje celou cestu do správné produktové kategorie podle stromu Heureky). Povinnými elementy, bez kterých váš produkt nebude zobrazen, jsou dále ITEM_ID (unikátní a trvalý identifikátor produktu), PRICE_VAT (koncová cena produktu s DPH) a URL (unikátní URL produktu na vašem e-shopu). Dále jsou důležité elementy DELIVERY (dopravci a ceny za dopravu), DELIVERY_DATE (počet dnů do odeslání produktu), IMGURL (URL hlavního produktového obrázku), ITEMGROUP_ID (identifikátor variant), HEUREKA_CPC (maximální CPC, pokud biddujete) a EAN (obsahuje čárový kód produktů, povinný pro vybrané kategorie). ### Co musí obsahovat element PRODUCTNAME? PRODUCTNAME je povinným elementem Heureka feedu. Je zásadní pro správné párování produktů do produktových karet Heureky a musí obsahovat přesný název daného zboží. Každá kategorie produktů má určenou přesnou specifikaci toho, jak by měl element vypadat. Např. pro kategorii Pánské ponožky jsou povinnými údaji Značka | Řada | Barva | Velikost. Správně vyplněný PRODUCTNAME tedy bude vypadat například takto: VoXX ponožky Setra tmavě šedé 35-38. Povinné údaje pro jednotlivé kategorie a příklady správných názvů najdete na [webu Heureky](https://sluzby.heureka.cz/napoveda/povinne-nazvy/). ### Jak hromadně doplnit výrobce do názvu produktů? Nejjednodušší cestou je využití automatizace Doplnění výrobce do názvu. 1. U vybraného projektu klikněte na záložku Automatizace. 2. Klikněte na automatizaci z názvem Doplnění výrobce do názvu. 3. Vyplňte Název elementu s výrobcem, tzn. vyplňte element ze vstupního feedu, který obsahuje informaci o názvu výrobce (např. MANUFACTURER). 4. Vyplňte Název elementu se jménem produktu, tzn. vyplňte element ze vstupního feedu, který obsahuje informaci o názvu produktu (např. PRODUCTNAME). 5. Jako Výstupní název elementu se jménem produktu vyplňte PRODUCTNAME. 6. Klikněte na Spustit automatizaci. ### Jak hromadně doplnit velikost, materiál nebo jinou informaci do názvu produktů? Nejsnadnější cestou, jak do názvu produktů doplnit informace o velikosti, materiálu nebo jiných parametrech, je využití pravidla Přepsat. 1. U vybraného projektu si nejprve na stránce Produkty vytvořte výběr produktů, u kterých chcete do elementu PRODUCTNAME vložit vybraný parament. 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Přepsat. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat. 5. Do kolonky Element vyplňte PRODUCTNAME (tedy element, který se bude na základě pravidla upravovat). 6. Do kolonky Nová hodnota vyplňte všechny elementy, které mají být v elementu PRODUCTNAME obsaženy. Protože pro každý produkt bude hodnota elementu jiná (každý produkt má jiný název/velikost/barvu), je potřeba tyto elementy označit jako tzv. proměnné. To uděláte tak, že element na začátku a na konci ohraničíte znakem „%“. Jednotlivé proměnné oddělte mezerou. *Příklad: V tuto chvíli element PRODUCTNAME pro vybraný produkt obsahuje informaci „Nike tričko zelené“. Vy ale chcete, aby PRODUCTNAME nesl informaci „Nike tričko zelené XL“. Informace o velikosti je obsažena v elementu PARAM, který dále obsahuje PARAM_NAME (název parametru, např. velikost) a VAL (hodnota parametru, např. XL).* *Do kolonky Nová hodnota v nově vytvářeném pravidle proto vyplníte:* *%PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL%* *Mergado tak bude vědět, že nová hodnota elementu PRODUCTNAME má obsahovat původní hodnotu (%PRODUCTNAME%, např. Nike tričko zelené) a k tomu informaci, kterou najde v elementu PARAM → PARAM_NAME="VELIKOST" → VAL (např. XL).* 7. Vyplňte název pravidla a klikněte na Vytvořit. ### Jak správně vyplnit element CATEGORYTEXT? Do elementu CATEGORYTEXT je nutné vyplnit celou cestu do správné produktové kategorie podle stromu kategorií Heureky. Pokud bude element vyplněn nesprávně, Heureka kategorie nespáruje a tudíž ani nepostoupí k párování produktů do produktových karet a vaše zboží nebude na Heurece zobrazeno. Správná cesta bude například vypadat takto: Heureka.cz | Velké spotřebiče | Pračky a sušičky | Pračky. ### Jak hromadně nastavit správné kategorie podle stromu kategorií Heureky? Pro správné nastavení kategorií je ideální pravidlo Hromadné přejmenování kategorií. 1. U vybraného projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidla zvolte Hromadné přejmenování kategorií. 3. Pokud chcete pojmenovat kategorie podle stromu Heureky u všech produktů, zvolte ve výběrech možnost Všechny produkty. Případně vyberte nebo vytvořte nový výběr produktů, u kterých chcete přejmenovat kategorie. 4. Klikněte na tlačítko Navrhnout kategorie. Mergado tak samo vyplní na levé straně kategorie, které se vyskytují ve vašem vstupním feedu, a na pravé straně k nim přiřadí odpovídající kategorie podle stromu kategorií Heureky. Tento návrh Mergada následně zkontrolujte a v případě potřeby upravte. 5. Vyplňte název pravidla a klikněte na Vytvořit. ### Jak doplnit element ITEM_ID pokud ho ve svém feedu nemám? ITEM_ID obsahuje unikátní identifikátor produktu a je povinným elementem Heureka feedu. Pokud tento element ve feedu nemáte využijte automatizaci ITEM_ID z MERGADO_ID. Tato automatizace vytvoří element ITEM_ID a následně jej naplní unikátními číselnými kódy. Automatizaci lze použít i v případě, že element ITEM_ID ve feedu máte, ale potřebujete jej naplnit vhodnými hodnotami. 1. U vybraného projektu přejděte na stránku Automatizace. 2. Klikněte na automatizaci ITEM_ID z MERGADO_ID. 3. Není potřeba nic vyplňovat, Mergado samo rozpozná, zda je potřeba vytvořit element, nebo již existuje a pouze jej naplní hodnotami. Stačí tedy pouze kliknout na Spustit automatizaci. ### Jak automaticky měnit cenu na Heurece podle konkurence? Pro automatickou cenotvorbu je ideální rozšíření [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about), které bude element PRICE_VAT plnit na základě vašich pravidel a aktuálních dat o konkurenci. Zajistí, aby ceny vašich produktů byly atraktivní pro zákazníky a zároveň výdělečné pro vás. ### Musí mít každý produkt v Heureka feedu unikátní URL? Ano. Každý produkt musí mít v Heureka feedu element URL vyplněn odlišnou adresou, která vede na stránku produktu ve vašem e-shopu. Unikátní URL musí mít také každá varianta jednoho produktu. Jak nastavit odlišné URL pro každou variantu najdete níže. ### Jak pro Heureka feed odlišit URL variant, které mám na svém e-shopu na jedné adrese? Pokud máte varianty produktů ve svém e-shopu na jedné adrese, je potřeba pro každou variantu vytvořit unikátní URL. To v Mergadu jednoduše zařídíte tak, že na konec URL přidáte znak # a za něj pro každou variantu unikátní číselný kód ze systémové proměnné @MERGADO_ID. Takto vytvoříte pro každou variantu unikátní odkaz, aniž by byl ovlivněn odkaz na produktovou stránku na vašem e-shopu. Proměnnou @MERGADO_ID nemusíte vytvářet, Mergado ji automaticky vytvoří při tvorbě projektu, kdy každému produktu (včetně variant) přidělí unikátní číselný kód. 1. Nejprve si na stránce Produkty vytvořte výběr produktů, u kterých chcete upravit URL. V tomto případě tedy výběr produktů, které mají varianty. 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Přepsat. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat. 5. Do kolonky Element vyplňte URL. 6. Do kolonky Nová hodnota vyplňte: %URL%#%@MERGADO_ID% 7. Vyplňte název pravidla a klikněte na Vytvořit. ### Jak zjistím, kolik zákazníků do mého e-shopu přichází z Heureky? Informaci o tom, kolik zákazníků k vám přichází z Heureky, najdete například v Google Analytics. Pokud však chcete získat speciální nebo podrobnější informace, můžete do URL jednotlivých produktů doplnit tzv. UTM parametry. V Mergadu to jednoduše vyřešíte pravidlem [Nastavit UTM parametry](https://forum.mergado.cz/t/pravidlo-nastavit-utm-parametry/pravidlo-nastavit-utm-parametry). 1. U vybraného projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidla vyberte Nastavit UTM parametry. 3. Ve výběru produktů zvolte Všechny produkty (nebo si vytvořte výběr konkrétních produktů, u kterých chcete nastavit UTM parametry). 4. Jako Element zvolte URL. 5. Vyplňte požadované parametry. 6. Vyplňte název pravidla a klikněte na Vytvořit. ### Jak do Heureka feedu přidat dopravce a nastavit cenu dopravy? Pro přidání dopravce a nastavení ceny za dopravu použijte pravidlo Nastavení ceny dopravy. 1. U vybraného projektu si nejdříve na stránce Produkty vytvořte výběry produktů, u kterých budete chtít nastavit dopravce a ceny za dopravu. Můžete například chtít odlišit cenu dopravy podle ceny zboží nebo podle hmotnosti. 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Nastavení ceny dopravy. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat (např. vyberte určitou cenovou hladinu) nebo zvolte Všechny produkty, pokud chcete pro všechny produkty nastavit stejné dopravce a cenu za dopravu. 5. Na levé straně vyplňte vybrané dopravce. Mergado vám bude našeptávat dopravce, které Heureka povoluje. Případně můžete kliknout na Předvyplnit levou stranu a Mergado vyplní všechny doprace povolené Heurekou. 6. Na pravé straně vyplňte cenu pro vybraného dopravce při platbě předem (případně také při platbě na dobírku, pokud to dopravce umožňuje). 7. Vyplňte název pravidla a klikněte na Vytvořit. Pokud nastavujete odlišnou cenu pro jednotlivé cenové hladiny nebo skupiny produktů podle hmotnosti, opakujte tento postup a pro každý výběr nastavte samostatné pravidlo. ### Jak nastavit dopravu zdarma pro některé produkty? Nejdříve si vytvořte výběr produktů, u kterých chcete nastavit dopravu zdarma (např. produkty s cenou nad 2000 Kč). Následně pro tento výběr nastavte pravidlo Nastavení ceny dopravy a u vybraných dopravců vyplňte jako cenu dopravy nulu. ### Jak z Heureka feedu odstraním některé dopravce? Využijte pravidlo Nastavení ceny dopravy, kde vlevo vyplníte dopravce, které chcete smazat, a vpravo necháte příslušné kolonky nevyplněné (nedoplňujte nulu ani žádné jiné znaky). Mergado do výstupního feedu nepropisuje elementy, které jsou prázdné, a tito dopravci tak zůstanou v Heureka feedu skrytí. ### Jak v Heureka feedu označím zboží, které je skladem? U zboží, které máte skladem, vyplňte do elementu DELIVERY_DATE nulu. ### Jak z inzerce na Heurece skrýt produkty, které mají dlouhou dodací dobu? Nejdříve si vytvořte výběr produktů, které mají dlouhou dodací dobu (např. DELIVERY_DATE > 10). Poté pro tento výběr nastavte pravidlo Skrytí produktů. ### Jak zajistit, aby měla Heureka vždy aktuální informace o dostupnosti a skladovosti mého zboží? Nejspolehlivějším zdrojem informací o dostupnosti a skladovosti vašeho zboží je tzv. dostupností feed, který poskytnete Heurece. Váš e-shopový systém by měl dostupností feed automaticky generovat. Pokud tomu tak není, je možné si jej vytvořit v Mergadu. Heureka stahuje informace z dostupnostního feedu každých deset minut a informace z něj mají přednost před informacemi z hlavního produktového feedu. Pro identifikace produktů je nutné zajistit, aby hodnoty ITEM_ID v produktovém i dostupnostním feedu byly u jednotlivých produktů shodné. Podrobné informace o tom, jak má Heureka dostupností feed vypadat, najdete na [jejich webu](https://sluzby.heureka.cz/napoveda/dostupnostni-feed). ### Jaké rozměry by měly mít produktové obrázky na Heurece? Nejmenší doporučená velikost je alespoň 175 × 175 pixelů, tedy přibližně 30 000 pixelů. Maximální velikost je 4096 × 4096 pixelů a 2000 kB. Zda vaše obrázky odpovídají požadavkům Heureky si můžete zdarma zkontrolovat díky [Auditu obrázků](https://audit-obrazku.cz/). Rozměry i kvalitu pak snadno a hromadně upravíte s pomocí rozšíření [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about). ### Můžou produktové obrázky na Heurece obsahovat vodoznaky? Ne. Obrázky nesmí obsahovat vodoznaky, zobrazení slevy nebo bonusu ani upozornění na ocenění nebo přednost produktu. Zda vaše obrázky odpovídají požadavkům Heureky si můžete zdarma zkontrolovat díky [Auditu obrázků](https://audit-obrazku.cz/). Vodoznaky i jiné prvky snadno hromadně odstraníte s pomocí rozšíření [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about). ### Jak v Heureka feedu označím všechny varianty produktu? Heureka vyžaduje, aby byla každá varianta produktu ve feedu zobrazena jako samostatný produkt a zároveň aby všechny varianty jednoho produktu byly označeny společným identifikátorem. K tomu slouží element ITEMGROUP_ID, kdy všechny varianty jednoho produktu označíte jedním společných kódem vloženým do elementu ITEMGROUP_ID. ### Jak do Heureka feedu doplním hodnoty ITEMGROUP_ID, když je ve vstupním feedu nemám? Pro doplnění hodnoty ITEMGROUP_ID se dá postupovat různými způsoby v závislosti na typu vašeho feedu. Jednou z možností je například využití pravidla [Import datového souboru](https://forum.mergado.cz/t/pravidlo-import-datoveho-souboru-csv-xml/pravidlo-import-datoveho-souboru-csv-xml), kdy si hodnoty pro tento element do Mergada importujete zvlášť v samostatném souboru. Pokud si nevíte rady, kontaktujte naši technickou podporu na e-mailu mergado@mergado.cz a společně se pokusíme najít řešení přesně pro váš feed. ### Jak nastavit CPC (cenu za proklik) pro Heureku? Maximální cenu za proklik v Mergadu snadno nastavíte pomocí pravidla Nastavení cen za prokliky. 1. Nejdříve si vytvořte vhodné výběry produktů, pro které chcete nastavit CPC (např. výběry dle cenových hladin, kategorií, parametrů atd.). 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Nastavení cen za prokliky. 4. V kolonce Výběry zvolte výběr, pro který chcete nastavit cenu za proklik. 5. Zvolte, zda chcete cenu za proklik vypočítávat podle: * Minimální ceny prokliku – Pravidlo zohlední minimální ceny za proklik pro zboží v jednotlivých kategoriích (minimální ceny udává Heureka) a vy můžete navýšit tuto cenu o libovolnou částku, kterou vyplníte do kolonky Přičíst k minimálnímu CPC (Kč). * Procenta z ceny zboží – Zde si v kolonce Procento z ceny produktu určíte procentuální hodnotu z ceny zboží, kterou chcete nabídnout za proklik. Např. Pokud nastavíte 1 % z ceny, u produktu za 500 Kč bude pravidlo nabízet cenu za proklik 5 Kč. (Myslete však na to, že při tomto způsobu nastavení se může cena za proklik u dražších produktů vyšplhat na poměrně vysoké částky. Následně si to však můžete upravit nastavením pravidla, kdy určíte, že nad určitou hodnotu CPC má být cena za proklik přepsána např. na 50 Kč. Využijete k tomu pravidlo [Přepsat](https://forum.mergado.cz/t/pravidlo-prepsat/pravidlo-prepsat).) 6. Vyplňte Název pravidla. 7. Klikněte na Vytvořit. Díky tomuto pravidlu se bude automaticky plnit element HEUREKA_CPC. Maximální CPC lze nastavit také s pomocí pravidla Hromadné přepisování dle výběrů, případně Hromadné přepisování dle hodnot. ### Jak na Heurece nastavit automatický bidding? Pro nastavení automatického biddingu je ideální rozšíření [Bidding Fox](https://store.mergado.com/detail/biddingfox). Analyzuje prodejní potenciál produktů a dynamicky řídí jejich inzerci, aby byly maximálně viditelné. Naopak u položek s nízkým potenciálem inzerci utlumí, a šetří tak váš kredit. Biddování upravuje několikrát denně podle nejaktuálnějších dat, které ověřuje přímo na Heurece. Navíc vám umožní sledovat CPC vašich konkurentů a upravovat inzerci i na základě těchto informací. Pro jeho používání je nutné v rozšíření Mergado Keychain nastavit propojení s Heurekou. ### Je uvádění EANu (čárového kódu) u produktů inzerovaných na Heurece povinné? Jeho uvádění je povinné pro produkty v kategoriích Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy. Pro ostatní kategorie není povinný, ale je doporučeno jej uvádět u všech produktů. ### Jak ve feedu najít produkty s chybnými nebo chybějícími EANy? Produkty s chybnými EANy v Mergadu snadno najdete s pomocí automatizace Vyhledat produkty s nevalidním EAN. Produkty s chybějícími EANy vyhledáte tak, že si vytvoříte výběr produktů, kde pro element EAN nastavíte podmínku „je prázdný“. ### Jak si v Mergadu usnadnit párování produktů pro Heureku? Využijte rozšíření [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about). Automaticky podle EANů spáruje vaše zboží s vhodnými produktovými kartami na Heurece a u nespárovatelných položek navrhne vhodné úpravy, např. názvu produktu (element PRODUCTNAME) nebo kategorie (element CATEGORYTEXT). --- ## [Proměnné v Mergadu](https://help.mergado.com/cs/mergado-editor/prace-s-daty/zakladni-prvky/promenne-v-mergadu/) # Proměnné v Mergadu # **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: ``Popis produktu, rozměry: 150x50`` 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`. 6. 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%` 4. Pravidlo uložte, aplikujte a poté projekt přegenerujte. ### **3\. Výsledek ve výstupním feedu** ``Popis produktu, rozměry: 150x50`` `` ``Šířka`` ``150`` `` `` ``Délka`` ``50`` `` ### **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. --- ## [Komplexní průvodce párováním produktů na Heurece s pomocí Mergada](https://help.mergado.com/cs/mergado-editor/reklamni-kanaly-a-inzerce/heureka/komplexni-pruvodce-parovanim-produktu-na-heurece-s-pomoci-mergada/) # Komplexní průvodce párováním produktů na Heurece s pomocí Mergada Párování produktů je jedním z nejdůležitějších úkonů pro úspěšnou inzerci na srovnávači Heureka. Tento proces propojuje nabídku vašeho e-shopu s konkrétní produktovou kartou v katalogu Heureky. Pokud vaše produkty nejsou spárované, zobrazují se pouze ve fulltextovém vyhledávání, což výrazně snižuje jejich viditelnost a šanci na objednávku. ## Proč je správné párování pro e-shopy zásadní? * Společné zobrazení s konkurencí – Spárované produkty se zobrazují přímo u „hlavní“ produktové karty spolu s nabídkami dalších e-shopů, takže zákazník vidí vaše zboží na jednom místě v porovnání s ostatními. Ne jako samostatnou, izolovanou nabídku. * Vyšší pozice ve vyhledávání: Produktové karty jsou ve výsledcích hledání řazeny výše než samostatné nespárované nabídky. * Možnost biddingu: Pouze spárované produkty lze plnohodnotně biddovat (nastavovat cenu za proklik) a ucházet se o horní příčky mezi prodejci. * Důvěryhodnost a recenze: Spárované produkty umožňují zákazníkům využívat recenze, hodnocení a porovnávání s jinými produkty. * Heureka Marketplace: Správné párování je jednou z podmínek pro aktivaci oranžového tlačítka „Koupit přes Heureku“. ## Jaké jsou klíčové elementy pro úspěšné spárování? Aby Heureka dokázala váš produkt správně identifikovat a zařadit, je potřeba zaměřit se na tyto tři elementy: * CATEGORYTEXT * PRODUCTNAME * EAN ## CATEGORYTEXT CATEGORYTEXT je element, který musí obsahovat celou cestu do správné produktové kategorie podle katalogu Heureky (např. Heureka.cz | Elektronika | Mobily). Je důležitý pro zařazení produktů z feedu do správných kategorií v katalogu Heureky. Jako oddělovač úrovní jednotlivých kategorií a podkategorií se používá svislítko „|“. Jedná o zásadní element pro správné párování produktů. Pokud Heureka nezvládne kvůli nesprávně vyplněnému CATEGORYTEXT spárovat kategorie, nepostoupí dále k párování produktů do produktových karet a produkt tedy nebude na Heurece zobrazen. V elementu je potřeba uvést kompletně celou cestu, ideálně podle [stromu kategorií Heureky](https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml). V takovém případě Heureka kategorie automaticky spáruje a postoupí k párování produktů do produktových karet. Použít můžete i vlastní názvy kategorií, proces párování se tím ale prodlouží a hrozí riziko, že kategorie a tedy i produkty nebudou spárovány a vaše zboží nebude na Heurece zobrazeno. * Příklad správně vyplněného elementu CATEGORYTEXT (např. pro pračku): Heureka.cz | Velké spotřebiče | Pračky a sušičky | Pračky * Příklad špatně vyplněného elementu CATEGORYTEXT (např. pro pračku): Heureka.cz | Velké spotřebiče | Pračky a sušičky ### Jak v Mergadu správně vyplnit element CATEGORYTEXT Mergado denně načítá a aktualizuje data o stromu kategorií Heureky a přiřazování správných kategorií vám obrovsky usnadní. Správné kategorie jednoduše a hromadně nastavíte s pomocí pravidla [Hromadné přejmenování kategorií](https://forum.mergado.cz/t/pravidlo-hromadne-prejmenovani-kategorii/pravidlo-hromadne-prejmenovani-kategorii). Toto pravidlo funguje spolehlivě ve chvíli, kdy máte kategorie na vstupu vyplněné ve správném elementu, se kterým Mergado v daném formátu počítá. Proto si před nastavováním kategorií vždy zkontrolujte, kde a v jaké podobě kategorie ve vstupním feedu skutečně máte (u vlastního formátu například to, že jsou elementy správně namapované). Ve většině případů je možné použít Hromadné přejmenování kategorií, které pracuje s existujícími vstupními kategoriemi a přiřazuje je ke stromu Heureky. Může ale nastat situace, kdy kategorie na vstupu chybí nebo jsou v jiném elementu, než Mergado pro daný formát očekává. Například u Google feedu se Mergado při práci s kategoriemi standardně dívá do elementu `g:google_product_category`. Stává se však, že někteří e-shopaři mají kategorii vyplněnou pouze v elementu `g:product_type` a `g:google_product_category` je prázdný. V takovém případě je potřeba zvolit jiný postup. Například použít pravidlo [Hromadné přepisování dle hodnot](https://forum.mergado.cz/t/pravidlo-hromadne-prepisovani-dle-hodnot/pravidlo-hromadne-prepisovani-dle-hodnot), které umožní zapisovat kategorie uvedené v nesprávném vstupním elementu přímo do elementu CATEGORYTEXT (Mergado přitom našeptává možné kategorie ze stromu Heureky). Jak použít pravidlo *Hromadné přejmenování kategorií* pro vyplnění CATEGORYTEXT: 1. U vybraného Heureka projektu přejděte na stránku Pravidla a klikněte na Nové pravidlo. 2. Jako typ pravidla zvolte Hromadné přejmenování kategorií. 3. Pokud chcete přiřadit kategorie podle stromu Heureky u všech produktů, zvolte ve výběrech možnost Všechny produkty. Případně vyberte nebo vytvořte nový výběr produktů, u kterých chcete přiřadit kategorie. 4. Přiřaďte ke kategoriím z vašeho e-shopu odpovídající kategorie podle stromu Heureky. 1. Nejjednodušším způsobem je využití funkce Navrhnout kategorie. Mergado tak samo vyplní na levé straně kategorie z vašeho e-shopu a na pravé straně k nim přiřadí odpovídající kategorie podle stromu kategorií Heureky. Tento návrh Mergada následně zkontrolujte a v případě potřeby upravte. 2. Další možností je využití funkce Předvyplnit levou stranu. Mergado na levé straně samo doplní kategorie z vašeho e-shopu. Vy k nim následně na pravé straně sami přiřadíte odpovídající kategorie podle stromu Heureky. Mergado vám bude na základě vámi vepsaného klíčového slova našeptávat vhodné kategorie ze stromu Heureky. 3. Další možností je, že si kategorie vyplníte a přiřadíte sami. I v tomto případě vám bude Mergado kategorie (vaše i ze stromu Heureky) našeptávat, takže je nemusíte nikde složitě dohledávat. Tip: Pořadí, v jakém jsou kategorie v tomto pravidle řazeny, je důležité. Pravidlo řádky aplikuje postupně od shora dolů. Je proto vhodné řadit obecnější kategorie nahoru a konkrétní kategorie dolů. V rámci tvorby pravidla je možné toto pořadí upravit. 5. Pokud nechcete procházet a kontrolovat všechny kategorie, můžete si díky kolonce Zobrazit pouze vyfiltrovat jen chybné řádky (Konfliktní řádky, Neplatné kategorie na výstupu nebo Hodnoty chybějící na vstupu). 6. Vyplňte název pravidla a klikněte na Vytvořit. ## PRODUCTNAME PRODUCTNAME je element, který musí obsahovat přesný název produktu a pro správné spárování musí být hodnota v něm obsažená totožná s názvem produktové karty na Heurece. Je povinným elementem Heureka feedu a je potřebný pro správné zobrazení produktů. Tento element je klíčový pro párování produktů, tzn. pro zařazení vašich produktů do odpovídajících produktových karet na Heurece. Aby došlo ke správnému spárování, musí element PRODUCTNAME obsahovat všechny povinné informace podle vybrané kategorie (např. u sortimentu oblečení musí být přímo v názvu uvedena velikost). [Povinné údaje pro jednotlivé kategorie a příklady správných názvů najdete na webu Heureky.](https://sluzby.heureka.cz/napoveda/povinne-nazvy/?_gl=1*1ib8mc7*_gcl_aw*R0NMLjE3NzIwMTM4MTIuQ2p3S0NBaUEyUHJNQmhBNEVpd0F3cEh5QzJFNnYwZG5iU3d2enFPTzBFLW9KRjdwaF9fbURfNmE4MnZwOVJGejZUMnZrbGhOcWU2SEdSb0M4djhRQXZEX0J3RQ..*_gcl_au*MTgwMjg4NzY0NS4xNzcwMTA3MTgwLjUxMDQ0NTcwNy4xNzcxOTQzMTU1LjE3NzE5NDMxNjE.) Např. pro kategorii Pánské ponožky jsou povinnými údaji Značka | Řada | Barva | Velikost. Správně vyplněný PRODUCTNAME tedy bude vypadat například takto: VoXX ponožky Setra tmavě šedé 35-38 Zároveň tento element nesmí obsahovat nadbytečné informace nesouvisející s názvem produktu, jako třeba dárek k produktu, informace o záruce, dopravě zdarma a podobně. Maximální délka textu je omezena na 200 znaků, což si můžete automaticky pojistit nastavením pravidla [Zkrácení hodnoty](https://forum.mergado.cz/t/pravidlo-zkraceni-hodnoty/pravidlo-zkraceni-hodnoty). Úpravy elementu PRODUCTNAME můžete v Mergadu provádět různými typy pravidel, například: [Přepsat](https://forum.mergado.cz/t/pravidlo-prepsat/pravidlo-prepsat), [Hromadné přepisování dle hodnot](https://forum.mergado.cz/t/pravidlo-hromadne-prepisovani-dle-hodnot/pravidlo-hromadne-prepisovani-dle-hodnot), [Import datového souboru](https://forum.mergado.cz/t/pravidlo-import-datoveho-souboru-csv-xml/pravidlo-import-datoveho-souboru-csv-xml) nebo manuálními změnami. Pokud již máte produkty na Heurece spárovány a následně provedete změny v elementu PRODUCTNAME, produkty se odpárují a musí znovu projít procesem párování. Délka tohoto procesu závisí na možnostech Heureky. ### Jak v Mergadu správně vyplnit element PRODUCTNAME Jedním z nejčastějších problémů u elementu PRODUCTNAME je chybějící název výrobce (značky) nebo chybějící parametr (např. velikost.) #### Jak do elementu PRODUCTNAME doplnit název výrobce? Nejjednodušší cestou, jak doplnit do elementu PRODUCTNAME název výrobce, je využít automatizaci, kterou Mergado nabízí. 1. U vybraného projektu klikněte na záložku Automatizace. 2. Klikněte na automatizaci z názvem Doplnění výrobce do názvu. 3. Vyplňte Název elementu s výrobcem, tzn. vyplňte element ze vstupního feedu, který obsahuje informaci o názvu výrobce (např. MANUFACTURER). 4. Vyplňte Název elementu se jménem produktu, tzn. vyplňte element ze vstupního feedu, který obsahuje informaci o názvu produktu (např. PRODUCTNAME). 5. Jako Výstupní název elementu se jménem produktu vyplňte PRODUCTNAME. 6. Klikněte na Spustit automatizaci. Takto se vytvoří pravidlo s názvem „Doplnění výrobce do názvu“. Díky tomuto pravidlu bude u všech produktů ve feedu, kterým chybí v názvu výrobce, do elementu PRODUCTNAME doplněn název výrobce. Pravidlo uvidíte v seznamu na stránce Pravidla, kde jej také můžete upravit. #### Jak do elementu PRODUCTNAME doplnit velikost nebo jiný parametr? Pokud chcete do elementu PRODUCTNAME doplnit další povinný parametr pro danou kategorii (např. velikost, materiál nebo zda je jedná o dámské/pánské/dětské zboží), je potřeba pro to v Mergadu vytvořit pravidlo. 1. U vybraného projektu si nejprve na stránce Produkty vytvořte výběr produktů, u kterých chcete do elementu PRODUCTNAME vložit vybraný parament (např. u kategorie Oblečení chcete do elementu PRODUCTNAME vložit parametr Velikost, vytvoříte tedy výběr produktů, který bude obsahovat všechny produkty z kategorie Oblečení). [Jak pracovat s výběry produktů najdete v tomto návodu.](https://youtu.be/pDjUNyKac88?si=RPYlX8yRtydfrT6f) 2. Přejděte na stránku Pravidla a klikněte na Nové pravidlo. 3. Jako typ pravidla vyberte Přepsat. 4. Zvolte výběr produktů, na který chcete toto pravidlo aplikovat. 5. Do kolonky Element vyplňte PRODUCTNAME (tedy element, který se bude na základě pravidla upravovat). 6. Do kolonky Nová hodnota vyplňte všechny elementy, které mají být v elementu PRODUCTNAME obsaženy (včetně původního PRODUCTNAME, pokud jej chcete zachovat). → Protože pro každý produkt bude hodnota elementu jiná (každý produkt má jiný název/velikost/barvu), je potřeba tyto elementy označit jako tzv. proměnné. To uděláte tak, že element na začátku a na konci ohraničíte znakem „%“. 7. Vyplňte název pravidla a klikněte na Vytvořit. Příklad: V tuto chvíli element PRODUCTNAME pro vybraný produkt obsahuje informaci „Nike tričko zelené“. Vy ale chcete, aby PRODUCTNAME nesl informaci „Nike tričko zelené XL“. Informace o velikosti je obsažena v elementu PARAM, který dále obsahuje zanořené elementy PARAM_NAME (název parametru, např. velikost) a VAL (hodnota parametru, např. XL). Do kolonky Nová hodnota v nově vytvářeném pravidle proto vyplníte: `%PRODUCTNAME% %PARAM{PARAM_NAME=“VELIKOST”} | VAL%` Mergado tak bude vědět, že nová hodnota elementu PRODUCTNAME má obsahovat původní hodnotu (%PRODUCTNAME%, např. Nike tričko zelené) a k tomu informaci, kterou najde v elementu PARAM → PARAM_NAME=“VELIKOST” → VAL (např. XL). Podobně můžete do elementu PRODUCTNAME doplnit i další parametry, např. materiál. V tom případě byste ještě za velikost doplnili %PARAM {PARAM_NAME=“MATERIÁL”} | VAL% a Mergado by za „Nike tričko zelené XL“ doplnilo např. bavlna. Důležité je myslet na to, zda váš feed u vybraných parametrů skutečně obsahuje příslušné hodnoty, jinak Mergado pochopitelně nebude mít odkud brát informace a do PRODUCTNAME nedoplní nic. Dále je potřeba dávat pozor na to, abyste vždy [„cestu“ k hodnotě parametru](https://forum.mergado.cz/t/element-path/2493) (tzv. Element-Path) vyplnili správně a Mergado tak vědělo, jak se k ní dostat. Zápis cesty k hodnotě elementu se samozřejmě může lišit od uvedeného příkladu, pokud se elementy s parametrem ve vašem feedu jmenují jinak. Ale jakmile napíšete počáteční značku proměnné %, spustí se našeptávání proměnných a vy tak můžete pouze vybrat ze seznamu návrhů. ## EAN EAN obsahuje číselný kód, který označuje jednotlivé produkty. Jde o oficiální, tzv. čárové, kódy a Heureka podporuje formát EAN-13, který se skládá z třinácti číslic. Jeho uvádění je povinné pro kategorie Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy. Pro ostatní kategorie není povinný, ale je doporučeno jej uvádět u všech produktů, protože může párování výrazně urychlit, pomáhá automatickým procesům a je nezbytný pro generování Reportu nespárovaných produktů. Heureka sice nepáruje zboží do produktových karet na základě EAN kódů, avšak v [Reportu nespárovaných produktů](https://heureka.group/cz-cs/datove-sluzby/report-nesparovanych-produktu/), který Heureka generuje a ve kterém najdete informace o nespárovaných produktech, pracuje právě s EAN kódy. Pokud tedy Heurece budete posílat EANy, nespárované produkty dohledá na základě EANů a v reportu vám doporučí správný název a kategorii pro spárování. [Report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/) nespárovaných produktů najdete na Heurece v administraci vašeho obchodu. Je dostupný pouze pro e-shopy v PPC režimu a Heureka jej generuje jednou denně. ### Jak v Mergadu zkontrolovat správnost elementu EAN #### Jak ve feedu vyhledat produkty s chybným EAN? Produkty s chybným EAN snadno vyhledáte s pomocí automatizace Vyhledat produkty s nevalidním EAN. 1. U vybraného projektu klikněte na záložku Automatizace. 2. Klikněte na automatizaci z názvem Vyhledat produkty s nevalidním EAN. 3. Automatizace má jako element s EAN kódy přednastaven EAN. Ponechte to takto. 4. Klikněte na Spustit automatizaci. Automatizace vám produkty s chybným EAN uloží do výběru s názvem „Produkty s nevalidním EAN“. Následně můžete kódy opravit, případně toto zboží dočasně skrýt (pravidlo [Skrytí produktu](https://forum.mergado.cz/t/pravidlo-skryti-produktu/pravidlo-skryti-produktu)), než EANy opravíte. #### Jak ve feedu vyhledat produkty s chybějícím EAN? Produkty s chybějícím EAN můžete vyhledat tak, že si pro ně vytvoříte výběr. 1. Na stránce Produkty si v tabulce zvolte možnost Jednoduché rozhraní. 2. U možnosti Hledat produkty zvolte na vstupu. 3. Do kolonky pro vyhledávání napište EAN a následně zvolte možnost je prázdný. 4. Klikněte na Hledat. 5. Vyhledají se vám všechny produkty, které mají chybějící EAN. 6. Vyplňte název výběru (např. Produkty s chybějícím EAN). 7. Klikněte na Uložit. Na stejné stránce klikněte na záložku Uložené výběry, kde tento výběr najdete. Ideálně se snažte u těchto produktů EAN co nejdříve doplnit, například pomocí pravidla [Import datového souboru](https://forum.mergado.cz/t/pravidlo-import-datoveho-souboru-csv-xml/pravidlo-import-datoveho-souboru-csv-xml). ## Pokročilá automatizace s rozšířením Pairing Bear Pokud máte ve feedu správně vyplněné EAN kódy a nechcete ztrácet čas manuálním párováním produktů a procházením [Report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/)u nespárovaných produktů, můžete využít rozšíření [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about). Rozšíření automaticky na základě EANů spáruje vaše zboží s produktovými kartami na Heurece a u položek, které nelze spárovat, nabídne inteligentní doporučení, například úpravu názvu nebo kategorie. ## Pravidelná kontrola s pomocí Mergado Auditu Pravidelná kontrola feedu pomocí [Mergado Auditu](https://audit.mergado.com/) pomáhá odhalit chyby, které mají přímý dopad na párování produktů do produktových karet na Heurece. Audit umožňuje tyto nedostatky průběžně kontrolovat, včas zachytit změny ve feedu a systematicky tak zvyšovat podíl spárovaných produktů i jejich výkon. Více informací o Mergado Auditu najdete v článku [Mergado Audit: Průvodce technickou kontrolou produktových feedů](https://forum.mergado.cz/t/mergado-audit-pruvodce-technickou-kontrolou-produktovych-feedu/mergado-audit-pruvodce-technickou-kontrolou-produktovych-feedu). ### Co Mergado Audit kontroluje u elementů souvisejících s párováním produktů? #### CATEGORYTEXT * Zda element CATEGORYTEXT u produktů nechybí nebo není prázdný. * Zda se u produktů nenachází vícero elementů CATEGORYTEXT → Heureka zpracovává pouze první výskyt CATEGORYTEXT u každé položky. * Upozorní, když CATEGORYTEXT obsahuje neplatný oddělovač úrovní kategorií nebo přebytečné oddělovače navíc. * Zda element CATEGORYTEXT neobsahuje pouze jednu hodnotu (jednu úroveň) kategorie, případně zda v tomto elementu není neplatná hodnota. * Odhalí, když CATEGORYTEXT obsahuje odkazy (URL adresy), což do tohoto elementu nepatří. #### PRODUCTNAME * Zda element PRODUCTNAME u produktů nechybí nebo není prázdný. * Zda PRODUCTNAME není duplicitní, tj. zda je unikátní pro každý produkt ve feedu. * Zda má element PRODUCTNAME správnou délku (nejvýše 200 znaků) * Odhalí, když PRODUCTNAME obsahuje nepovolená slova, odkazy nebo znaky. Například informace o dárku nebo dopravě do tohoto elementu nepatří, stejně tak znaky pro copyright [image] , trademark [image] , apod. #### EAN * Zda EAN u produktů nechybí nebo není prázdný. * Zda jsou EAN kódy unikátní a nenachází se ve feedu duplicitní hodnoty (tj. stejné EANy u více produktů). * Zda element EAN neobsahuje nepovolenou hodnotu, kdy jsou místo číselného kódu v hodnotách EANů například písmena, mezery, pomlčky, apod. * Zda má element EAN správnou délku. ## Shrnutí Správně vyplněné elementy CATEGORYTEXT, PRODUCTNAME a EAN tvoří základ úspěšného párování produktů do produktových karet na Heurece. Pokud jsou tyto údaje přesné, úplné a odpovídají požadavkům Heureky, výrazně to zvyšuje šanci na správné spárování, lepší viditelnost i možnost efektivního biddingu. Je však potřeba mít na paměti, že samotné párování je jen jednou částí úspěšné inzerce. Heureka má i další požadavky na strukturu a kvalitu feedu a jejich splnění je klíčové pro to, aby produkty nebyly zamítány a kampaně běžely bez omezení. Více se tomuto tématu věnujeme v článku [Optimalizace dat pro Heureku: Jak opravit chyby v produktovém feedu a zajistit, že Heureka nebude zamítat produkty?](https://forum.mergado.cz/t/optimalizace-dat-pro-heureku-jak-opravit-chyby-v-produktovem-feedu-a-zajistit-ze-heureka-nebude-zamitat-produkty/optimalizace-dat-pro-heureku-jak-opravit-chyby-v-produktovem-feedu-a-zajistit-ze-heureka-nebude-zamitat-produkty). ## FAQ - Co je párování produktů na Heurece a proč je tak důležité? Párování produktů je proces, při kterém se nabídka vašeho e-shopu propojí s konkrétní produktovou kartou v katalogu Heureky. Spárované produkty se zobrazují výše ve vyhledávání, mohou využívat recenze a porovnání cen a umožňují plnohodnotný bidding. Bez párování se zboží zobrazuje pouze ve fulltextové vyhledávání, což výrazně snižuje jeho viditelnost i prodejní potenciál. - Jaké výhody přináší správné spárování produktů e-shopu? Správně spárované produkty mají lepší pozice ve výsledcích vyhledávání a lze na ně nastavovat cenu za proklik. Zákazníci zároveň vidí recenze, hodnocení a porovnání s konkurencí, což zvyšuje důvěryhodnost nabídky. Párování je také jednou z podmínek pro aktivaci Heureka Marketplace a tlačítka „Koupit přes Heureku“. - Jaké elementy jsou klíčové pro úspěšné párování produktů? Zásadní roli hrají tři elementy feedu: CATEGORYTEXT, PRODUCTNAME a EAN. Každý z nich plní jinou funkci – CATEGORYTEXT určuje kategorii, PRODUCTNAME identifikuje konkrétní produkt. Důležitým, avšak nikoliv povinným pro všechny kategorie, je element EAN, který pomáhá s dohledáváním a kontrolou nespárovaných položek. Pokud některý z těchto elementů chybí nebo je vyplněn chybně, párování může selhat. - Jak má být správně vyplněný element CATEGORYTEXT? CATEGORYTEXT musí obsahovat kompletní cestu do kategorie podle stromu kategorií Heureky. Jednotlivé kategorie a podkategorie musí být odděleny svislítkem „|“. Je důležité uvést všechny úrovně kategorie, jinak Heureka nemusí produkt správně zařadit. Nesprávně vyplněný nebo neúplný CATEGORYTEXT může zastavit celý proces párování. - Jak lze v Mergadu nastavit správné kategorie pro Heureku? V Mergadu lze využít pravidlo Hromadné přejmenování kategorií, které umožňuje přiřadit e-shopové kategorie ke kategoriím podle stromu Heureky. Pomoci mohou funkce jako „Navrhnout kategorie“ nebo „Předvyplnit levou stranu“, které proces výrazně urychlí. Důležité je také správně seřadit pravidla od obecných kategorií ke konkrétním. - Co musí obsahovat element PRODUCTNAME, aby došlo ke správnému spárování? PRODUCTNAME musí odpovídat názvu produktové karty na Heurece a obsahovat všechny povinné údaje dle konkrétní kategorie, například značku, barvu či velikost. Nesmí zahrnovat marketingové informace jako dárek zdarma nebo dopravu zdarma. Maximální délka názvu je 200 znaků. - Jak doplnit chybějící značku do PRODUCTNAME v Mergadu? V Mergadu lze využít automatizaci „Doplnění výrobce do názvu“, která přidá název výrobce z příslušného elementu (např. MANUFACTURER) do PRODUCTNAME. Automatizace vytvoří pravidlo, které zajistí úpravu u všech relevantních produktů. Tím se zvýší šance na správné spárování. - Jak přidat velikost nebo jiný parametr do názvu produktu? Je potřeba vytvořit pravidlo typu Přepsat a použít proměnné označené znakem %. Do nové hodnoty PRODUCTNAME se vloží původní název a doplní se cesta k požadovanému parametru (např. velikost z elementu PARAM). Klíčové je ověřit, že feed skutečně obsahuje potřebné hodnoty. - Kdy je element EAN povinný a jaký má význam? EAN je povinný u kategorií Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy, ale doporučujeme mít jej vyplněný i u ostatních kategorií. I když Heureka nepáruje přímo podle EAN, využívá jej v Reportu nespárovaných produktů. Díky EANu může Heureka doporučit správný název nebo kategorii pro spárování. - Jak v Mergadu odhalit chybné nebo chybějící EAN kódy? Pro nevalidní EAN lze využít automatizaci „Vyhledat produkty s nevalidním EAN“, která vytvoří výběr problematických položek. Produkty s chybějícím EAN lze najít pomocí jednoduchého vyhledávání a uloženého výběru. Následně je vhodné EAN doplnit nebo produkty dočasně skrýt. - Co je Pairing Bear a jak pomáhá s párováním? Pairing Bear je rozšíření, které automaticky páruje produkty podle EAN kódů. U nespárovaných položek nabízí inteligentní doporučení na úpravu názvu nebo kategorie. Šetří tak čas a minimalizuje potřebu manuální kontroly Reportu nespárovaných produktů z Heureky. - Jak pomáhá Mergado Audit s kontrolou párování produktů? Mergado Audit zkontroluje správnost elementů CATEGORYTEXT, PRODUCTNAME a EAN a odhalí chyby, duplicity nebo neplatné hodnoty. Upozorní například na prázdné názvy, neplatné oddělovače kategorií nebo špatnou délku textu. - Proč nestačí řešit pouze párování a je nutné řešit i další požadavky feedu? Párování je jen jednou částí úspěšné inzerce na Heurece. Feed musí splňovat i další technické a obsahové požadavky, jinak může docházet k zamítání produktů nebo omezení kampaní. Proto je důležité věnovat pozornost celkové optimalizaci dat a pravidelné kontrole kvality feedu. --- ## [Opačné výběry v Mergadu](https://help.mergado.com/cs/mergado-editor/prace-s-daty/zakladni-prvky/opacne-vybery-v-mergadu/) # Opačné výběry v Mergadu # Jak na opačné výběry Tento článek vysvětluje, co jsou opačné výběry a jak s nimi v Mergadu efektivně pracovat. Ukážeme si rozdíl mezi jednoduchým opačným výběrem (kde stačí změnit operátor, např. z „=“ na „!=“) a složitějším výběrem s využitím MQL a operátoru `NOT`. Na konci článku budete umět: * rozpoznat situaci, kdy je vhodné použít opačný výběr, * vytvořit jednoduchý opačný výběr bez znalosti MQL, * přepsat složitý výběr do MQL a použít negaci `NOT(...)` pro dosažení opačného výsledku. ## Kontext Běžně při práci s výběry určujete produkty, které chcete zasáhnout—např. zvýšit cenu, upravit název nebo je skrýt. Někdy je ale jednodušší vytvořit výběr opačný—tedy takový, který vybere vše ostatní mimo určitou skupinu. Jinými slovy: místo „co chci upravit“ definujete „co nechci upravit“. Tento přístup šetří čas hlavně v situacích, kdy: * přesně víte, které produkty mají zůstat beze změny, nebo * máte malou skupinu produktů, která má být na výstupu zachována, a všechny ostatní mají být skryté. ## Příklady z praxe **Typický příklad** Spravujete feed s 65 000 produkty. Chcete ve výstupu ponechat jen 5 000 konkrétních produktů a všechny ostatní skrýt. Můžete na to jít dvěma způsoby: * vytvořit výběr na všech 60 000 produktů, které nechcete (velmi nepraktické), nebo * vytvořit opačný výběr: „Cokoliv kromě těchto produktů.“ Právě k tomu slouží opačné výběry. **Kdy se opačný výběr hodí** * nechcete zasáhnout určitou skupinu produktů pravidlem (např. nechcete jim měnit název nebo cenu), * chcete skrýt všechno kromě určité skupiny produktů, * chcete přehledně spravovat výjimky místo dlouhých seznamů podmínek. ## Jednoduché opačné výběry (bez MQL) Pokud potřebujete vytvořit jednoduchý opačný výběr, nemusíte hned používat MQL. Stačí pracovat s opačnými operátory přímo v základním rozhraní výběrů. Princip je jednoduchý: místo podmínky typu „obsahuje / je ve výčtu / =“ použijete její negaci. | Běžný operátor | Opačný operátor | Co dělá | | -------------- | ----------------- | ------------------------------------------------ | | `=` (rovná se) | `!=` (nerovná se) | Vybere produkty s jinou hodnotou | | obsahuje | neobsahuje | Vybere produkty, které text neobsahují | | je ve výčtu | není ve výčtu | Vybere produkty, které nejsou v uvedeném seznamu | **Příklad 1 – obrácení „obsahuje“** Původní výběr: ``` CATEGORY ~OBSAHUJE "Zahrada" ``` Najde všechny produkty, které mají v elementu `` hodnotu „Zahrada“. Opačný výběr (ponechá jen produkty, které tuto hodnotu **ne**obsahují): ``` CATEGORY !~ NEOBSAHUJE "Zahrada" ``` **Příklad 2 – „je ve výčtu“ vs. „není ve výčtu“** Původní výběr (produkty, které chcete ponechat na výstupu): ``` ITEM_ID Je ve výčtu (101, 102, 103) ``` Opačný výběr (produkty, které chcete skrýt – tedy vše kromě uvedených): ``` ITEM_ID Není ve výčtu (101, 102, 103) ``` Tento výběr vybere všechny produkty kromě těchto tří. ## Pokročilé opačné výběry pomocí MQL (NOT) Pokud je výběr složitější (více podmínek, logika `AND/OR`), doporučujeme použít MQL a operátor `NOT`. Tento přístup dává plnou kontrolu nad tím, jak se výběr otočí. ### Jak funguje operátor NOT V MQL můžete `NOT` použít ke „znegujování“ podmínky nebo celého dotazu. Příklady ekvivalence: ``` ITEM_ID != 43 ``` je totéž jako ``` NOT(ITEM_ID = 43) ``` * `ITEM_ID = 43` → vybere produkt s ID 43 * `NOT(ITEM_ID = 43)` → vybere všechny **kromě** produktu s ID 43 **Grafické znázornění negace (slovně):** `NOT` obrací množinu – vybere vše, co **neodpovídá** původnímu výběru. ## Kroky k řešení ### 1) Přihlášení do Mergada a přechod na správu výběrů * Přihlaste se do svého Mergado účtu. * Přejděte na sekci **Produkty** v hlavním menu. ### 2) Vytvoření dotazu * Operátor `NOT` se vždy přidává v sekci **Vlastní MQL dotaz**. * Můžete si nejdříve výběr sestavit v jednoduchém rozhraní a poté se přepnout do MQL sekce, nebo rovnou napsat dotaz v MQL. * Vytvořte výběr produktů, které chcete **ponechat**. * Celý vytvořený dotaz uzavřete do kulatých závorek `()` a před něj přidejte negaci `NOT`. ### 3) Pojmenování a uložení * Výběr si vhodně pojmenujte a uložte. * Následně s ním můžete pracovat v rámci pravidel (např. použít ve skrývacím pravidle). ## Praktický příklad Chcete ponechat na výstupu pouze produkty, které: * mají v názvu „kalhoty“, * mají parametr **barva = fialová**, * a stojí více než **1100 Kč s DPH**. Všechno ostatní chcete skrýt. Celkový počet produktů je cca 65 000, tento výběr najde pouze 2. Postup: * V rozhraní výběru přepněte do **Vlastní MQL dotaz**. * Původní výběr (ten, který definuje *co ponechat*) zabalte do `()` a předřaďte `NOT`. Tím vytvoříte opačný výběr: vybere všechny produkty **kromě** těch, které splňují původní podmínky. Můžete ho použít ve skrývacím pravidle—ve výstupním feedu tak zůstanou jen produkty, které odpovídají původnímu výběru. ## Tipy a časté chyby * **Nezapomínejte na závorky.** Pokud kombinujete více podmínek, vždy celý původní výběr uzavřete do závorek: ``` NOT(PRODUCTNAME CONTAINS "boty" OR CATEGORY = "Doplňky") ``` * **Pamatujte, že `NOT` obrací celou logiku, ne jen jednotlivé části.** Pokud kombinujete více výrazů s `AND` a `OR`, může být výsledek jiný, než čekáte. Výběr proto otestujte. ### Rychlá rekapitulace (přehled) | Typ výběru | Jak vytvořit | Příklad | | ------------------------------- | ----------------------- | ---------------------------------------------------------- | | Jednoduchý opačný výběr | Použít opačný operátor | `CATEGORY != "Zahrada"` | | Opačný výběr se seznamem hodnot | Použít „není ve výčtu“ | `ITEM_ID NOT IN (101,102,103)` | | Složitý opačný výběr | Použít MQL a `NOT(...)` | `NOT(PRODUCTNAME CONTAINS "kalhoty" AND PRICE_VAT > 1100)` | --- ## FAQ **Kdy má smysl použít opačný výběr?** Když nechcete zasáhnout určitou skupinu produktů pravidlem, chcete skrýt všechno kromě určité skupiny, nebo potřebujete přehledně spravovat výjimky bez dlouhých seznamů podmínek. **Jak vytvořím jednoduchý opačný výběr bez MQL?** V základním rozhraní výběrů použijete opačný operátor (např. `!=` místo `=`; „neobsahuje“ místo „obsahuje“; „není ve výčtu“ místo „je ve výčtu“). **Jak vypadá příklad pro „obsahuje“ vs. „neobsahuje“?** Původní: `CATEGORY ~OBSAHUJE "Zahrada"` Opačný: `CATEGORY !~ NEOBSAHUJE "Zahrada"` **Jak vytvořím opačný výběr k seznamu ID?** Původní: `ITEM_ID Je ve výčtu (101, 102, 103)` Opačný: `ITEM_ID Není ve výčtu (101, 102, 103)` – vybere vše kromě těchto tří. **Kdy sáhnout po MQL a `NOT`?** Když je výběr složitější (více podmínek, kombinace `AND/OR`) a potřebujete přesně řídit negaci celého dotazu. **Jak funguje `NOT` v MQL na jednoduchém příkladu?** `ITEM_ID != 43` je totéž co `NOT(ITEM_ID = 43)`. `NOT` vybere všechny položky, které **ne**splňují podmínku. **Kam `NOT` zapisovat?** Do sekce **Vlastní MQL dotaz**. Původní výběr dejte do závorek `()` a před něj napište `NOT`. **Proč jsou závorky důležité?** Zajistí, že `NOT` neguje přesně tu část, kterou chcete. U kombinací `AND/OR` bez závorek hrozí jiný výsledek, než očekáváte. **Mohu opačný výběr použít ke skrytí všeho mimo výjimky?** Ano. Opačný výběr můžete použít ve skrývacím pravidle, takže ve výstupním feedu zůstanou jen položky splňující původní (ne-negovaný) výběr. **Zvládnu to bez znalosti MQL?** Ano—u jednoduchých případů stačí v rozhraní výběrů použít opačné operátory. MQL s `NOT` využijete, když potřebujete negovat složitější kombinace podmínek. --- ## [Sortiment report v Mergadu](https://help.mergado.com/cs/mergado-editor/reklamni-kanaly-a-inzerce/heureka/sortiment-report-v-mergadu/) # Sortiment report v Mergadu # Sortiment report z Heureky Některá rozšíření Mergada (např. Pairing Bear, Bidding Fox, Pricing Fox) pracují s reporty z Heureky – nejčastěji se **sortiment reportem**. Tyto reporty Heureka generuje, **Mergado Keychain** je stahuje a jednotlivá rozšíření z nich čerpají data k analýze. V této nápovědě zjistíte, **jak proces funguje, jak často se reporty generují a stahují** a **jak postupovat**, když se v Keychainu objeví hláška „**Problémy se spojením**“ nebo když se data v rozšířeních projeví se zpožděním. --- ## Jak to funguje v Mergadu (kdy se reporty tvoří a stahují) * **Mezi 1:00–4:00 ráno** Mergado na Heurece klikne na **„Generovat sortiment report“**. * **Zhruba do dvou hodin** od kliknutí se Mergado pokusí report **stáhnout a zpracovat**. * Když stažení selže, Mergado **zkouší opakovaně** v pravidelných intervalech. * Pokud se opakovaně nedaří, v Keychainu u napojení uvidíte **oranžové hlášení „Problémy se spojením“** (u Sortiment reportu může být uvedena **nespecifikovaná chyba**). * V praxi se může stát, že **napojení na Heureku je v pořádku**, ale **Heureka negeneruje report** – pak není co stahovat. * Změny v některých rozšířeních (např. nastavená kampaň nebo pravidlo) se můžou **projevit až následující den**. --- ## Postup: jak ověřit a vyřešit problém se stahováním sortiment reportu ### 1) Zkontrolujte stav napojení v Keychainu 1. V Keychainu u napojení na Heureku zkontrolujte, zda se nezobrazuje oranžové hlášení **„Problémy se spojením“**. 2. Klikněte na **Upravit**. 3. Ověřte, že je **připojení na Heureku v pořádku**. * Pokud ano a přesto vidíte hlášku, pokračujte bodem 2 – je možné, že **Heureka report negeneruje**. ### 2) Ověřte generování reportu v administraci Heureky 1. V administraci Heureky vlevo otevřete **Statistiky a reporty**. 2. Zkontrolujte, zda je dostupná záložka **„Sortiment report“** (v místě, kde bývá červené zvýraznění na screenu). * **Měli byste vidět odpovídající obrazovku** se sortiment reportem. 3. **Záložku nevidíte?** Ověřte, zda splňujete podmínky pro generování: * máte hodnocení **„Ověřeno zákazníky“** **nebo** * **máte kredit**. Podrobnosti najdete v nápovědě Heureky: [https://sluzby.heureka.cz/napoveda/sortiment-report/](https://sluzby.heureka.cz/napoveda/sortiment-report/) ### 3) Zkontrolujte kredit * I když máte **Ověřeno zákazníky**, pokud je **kredit v mínusu**, **sortiment report se nemusí generovat**. ### 4) Vyhodnoťte stav a dejte reportu čas * Pokud je napojení v Keychainu **v pořádku** a Heureka **report generuje**, ale v Keychainu se ukazuje, že **data z reportu jsou zastaralá**, vyčkejte **cca 1 den** – Heureka mohla **ještě nevygenerovat nové reporty**, takže Mergado zatím **nemá co stáhnout**. ### 5) Kdy kontaktovat podporu * Pokud hláška **„Problémy se spojením“** **nezmizí ani po jednom dni**, kontaktujte **technickou podporu Mergada**. Problém se spojením prověříme. --- ## Tipy a doporučení * Při hlášce **„Problémy se spojením“** **nejdřív** ověřte v administraci Heureky, **zda se sortiment report skutečně generuje**. * **Zkontrolujte kredit** – **negativní zůstatek** může **blokovat generování** i při **Ověřeno zákazníky**. * Pokud Keychain hlásí problém, ale po kliknutí na **Upravit** je napojení **OK**, dejte reportu **cca den** – nové reporty ještě nemusely být od Heureky k dispozici. * Změny v rozšířeních (kampaně, pravidla) se mohou **projevit až následující den**. --- ## FAQ **Proč vidím v Keychainu „Problémy se spojením“ u Sortiment reportu?** Mergado opakovaně zkoušelo stáhnout report a nedařilo se. Důvodem může být i to, že **Heureka report aktuálně negeneruje** – pak **není co stáhnout**. **Napojení na Heureku je po kliknutí na „Upravit“ v pořádku. Je to v pohodě?** Ano, napojení může být OK, ale **report od Heureky ještě nemusí existovat**. V takovém případě vyčkejte **cca 1 den** na nové vygenerování. **Jak často Mergado spouští a stahuje sortiment report?** **Mezi 1:00–4:00** Mergado klikne na **„Generovat sortiment report“**, do **zhruba 2 hodiny** se jej pokusí **stáhnout a zpracovat**. Při chybě to **zkouší opakovaně**. **Kde v Heurece najdu sortiment report?** V administraci Heureky v sekci **Statistiky a reporty** na záložce **„Sortiment report“**. **Záložku „Sortiment report“ nevidím. Co teď?** Ověřte, zda splňujete podmínky Heureky: **„Ověřeno zákazníky“** **nebo** **kladný kredit**. Podrobnosti: [https://sluzby.heureka.cz/napoveda/sortiment-report/](https://sluzby.heureka.cz/napoveda/sortiment-report/) **Mám „Ověřeno zákazníky“, ale report se negeneruje. Proč?** Zkontrolujte **kredit**. Pokud je **v mínusu**, **report se generovat nemusí**. **Nastavil/a jsem kampaň nebo pravidlo v rozšíření, ale změny nevidím hned. Je to normální?** Ano, **změny se mohou projevit až další den**. **Kdy mám psát podpoře?** Pokud po **1 dni** od ověření napojení a podmínek Heureky **hláška nezmizí**, napište na **technickou podporu Mergada** – prověříme spojení. --- ## [Operátory pro Mergado Query Language](https://help.mergado.com/cs/mergado-editor/prace-s-daty/zakladni-prvky/operatory-pro-mergado-query-language/) # Operátory pro Mergado Query Language # Seznam operátorů v MQL Tento přehled vysvětluje všechny operátory, které můžete použít v **Mergado Query Language (MQL)** – jazyku pro vytváření podmínek ve výběrech produktů. Pomůže vám lépe porozumět, jak MQL funguje a jak přesně formulovat pravidla pro výběr dat. Díky správnému použití operátorů budete umět tvořit přesné, efektivní a přehledné dotazy. --- ## Přehled operátorů | **Operátor** | **Význam** | | -------------- | -------------------------- | | `CONTAINS` | obsahuje text | | `NOT CONTAINS` | neobsahuje text | | `=` | rovná se | | `!=` | nerovná se | | `~` | obsahuje regulární výraz | | `!~` | neobsahuje regulární výraz | | `=` | je větší nebo rovno* | | `` | je větší než* | | `IN` | je obsažen v seznamu | | `NOT IN` | není obsažen v seznamu | | `OR` | logický výraz „nebo“ | | `AND` | logický výraz „a“ | | `SORT BY` | řadí podle názvu elementu | *Používá se pouze u číselných hodnot. --- ## Modifikátory pro `SORT BY` | **Modifikátor** | **Význam** | | --------------- | ----------------------------- | | `DESC` | řadí sestupně | | `ASC` | řadí vzestupně | | `AS NATURAL` | řadí podle přirozeného pořadí | > Tyto modifikátory se používají společně s operátorem `SORT BY` a určují, jakým způsobem se výsledky seřadí. --- ## Jak správně psát podmínky Podmínky v MQL mají vždy tvar: ``` [] ``` **Příklad:** ``` [PRICE] >= 100 ``` ### Pravidla pro zápis: * **Hodnota** nemusí být v uvozovkách, pokud obsahuje jen jedno alfanumerické slovo nebo číslo. Např. `[CATEGORY] = Electronics` * **Název elementu** uzavřete do hranatých závorek, pokud obsahuje jiné než alfanumerické znaky: `[PARAM | color] = "blue"` * **Textové hodnoty a regulární výrazy** pište v rovných uvozovkách `" "`, ne v typografických „ “. * **Doporučení:** vždy používejte hranaté závorky. Díky nim vám Mergado nabídne seznam dostupných elementů při psaní dotazu. --- ## Tipy pro efektivní práci * Kombinujte operátory `AND` a `OR` pro tvorbu komplexních výběrů. * Používejte `SORT BY` k přehlednému řazení výsledků – například podle ceny nebo názvu. * Pokud si nejste jistí, jaký operátor použít, začněte s `CONTAINS` – snadno ověří, zda element obsahuje požadovaný text. * Pro přesné vyhledávání vzorů využijte regulární výrazy (`~` a `!~`). --- ## FAQ **Jaký je základní formát podmínky v MQL?** Podmínka má tvar `[] `. **Kdy potřebuji uvozovky kolem hodnoty?** Používejte je, pokud hodnota obsahuje mezery nebo speciální znaky. Jednoslovné alfanumerické hodnoty a čísla je nepotřebují. **Jaký je rozdíl mezi `CONTAINS` a `~`?** `CONTAINS` hledá přesný text, zatímco `~` umožňuje hledat pomocí regulárního výrazu (vzorů). **Lze kombinovat více podmínek?** Ano, pomocí `AND` a `OR` můžete spojovat více výrazů do jednoho výběru. **K čemu slouží `SORT BY` a jeho modifikátory?** `SORT BY` určuje, podle kterého elementu se mají výsledky seřadit. Modifikátory `ASC`, `DESC` a `AS NATURAL` určují pořadí řazení. --- Tento přehled vám pomůže psát MQL dotazy přehledně, správně a efektivně – a využít tak plný potenciál výběrů v Mergadu. --- ## [Jak funguje přegenerování a aktualizace dat v Mergadu?](https://help.mergado.com/cs/mergado-editor/prace-s-daty/zakladni-prvky/jak-funguje-pregenerovani-a-aktualizace-dat-v-mergadu/) # Jak funguje přegenerování a aktualizace dat v Mergadu? ## Proč je důležité přegenerovávat data Když v Mergadu upravíte pravidla, filtry či výběry, nebo když se změní vstupní data z vašeho e-shopu, je důležité, aby tyto změny opravdu pronikly až do výstupního feedu, který odesíláte na inzertní kanály. Přegenerování dat je mechanizmus, který zajistí, že změny, které proběhly ve zdroji dat, se dostanou do Mergado Editoru a úpravy v editoru se projeví ve výstupních datech, které proudí do cílových platforem. Díky tomuto mechanismu získáte kontrolu nad tím, co se ve vaší inzerci skutečně objeví. V tomto článku si ukážeme, jaké typy aktualizace a přegenerování dat Mergado nabízí, kdy a jak je používat, a ukážeme si také, jak spustit ruční přegenerování, případně pozastavit automatické přegenerování nebo si ho naplánovat na konkrétní časy. ## Jaké typy aktualizace dat probíhají v Mergadu ### 1. Aplikování pravidel Poté, co v projektu provedete úpravy (manuální změny u vybraných produktů, vytvoření nových pravidel, úprava stávajících pravidel), je potřeba tyto změny potvrdit kliknutí na tlačítko Aplikovat pravidla. V tu chvíli se změny na základě vašich úprav provedou pouze v rámci Mergada a vy si je můžete zkontrolovat na stránce Produkty. Při aplikování pravidel se nenačítají nová data ze vstupního feedu, ani se změny pravidel neprojeví ve výstupním feedu. K propsání změn do výstupní feedu (a tedy jejich odeslání do cílových inzertních platforem) dojde až při přegenerování dat (ať už jde o automatické nebo manuální přegenerování). * Kdy použít: Pokud si chcete ověřit vliv pravidla na produkty a zkontrolovat, zda je pravidlo nastaveno správně, a to bez toho, aby se změnila výstupní data a změny se projevily v cílové platformě (např. na Heurece nebo Googlu). * Jak spustit: V rámci konkrétního projektu na stránce Pravidla klikněte na tlačítko Spustit procesy ručně a následně vyberte Aplikovat pravidla. ### 2. Aplikování pravidel jen na sledované produkty O něco rychlejší a specifičtější možností, jak si ověřit změny, které nové nebo upravené pravidlo provádí, je aplikování pravidel jen na sledované produkty. Mergado v tomto režimu opět aplikuje pravidla pouze v rámci Mergada (bez načítání nových vstupních dat a bez exportu dat do výstupního feedu), ale tentokrát pouze na vybrané produkty, u kterých chcete sledovat změny. * Kdy použít: Pokud řešíte konkrétní změnu (např. jen u určité kategorie) a chcete vidět efekt rychle, bez čekání na celý feed. Je to ideální diagnostický nástroj pro zjišťování toho, jak konkrétně mění jednotlivá pravidla hodnoty elementů u jednotlivých produktů. Stejně tak je tato možnost ideální v případě, že máte ve svém feedu tisíce produktů, pravidla se však týkají jen některých z nich a hromadné aplikování na všechny položky ve feedu by trvalo zbytečně dlouho. S aplikováním pravidel na sledované produkty si ušetříte spoustu času. * Jak spustit: V rámci konkrétního projektu si nejprve vyberte produkty, které chcete sledovat. Na stránce Produkty u vybraného produktu klikněte na záložku Průchod pravidly. Zde zaklikněte políčko Sledovat produkt při průchodu pravidly. Toto zopakujte u všech produktů, které chcete sledovat. Na záložce Průchod pravidly můžete také rovnou spustit aplikování pravidel na sledované produkty kliknutím na Spustit aplikování pravidel. Na stránce Průchod pravidly následně také uvidíte seznam všech pravidel, která mění data u daného produktu, včetně původního a výsledného stavu. Zakliknutím políčka Zvýraznit rozdíly se vám barevně zvýrazní konkrétní změny. Spustit aplikování pravidel na sledované produkty můžete také na stránce Pravidla. Tady klikněte na tlačítko Spustit procesy ručně a následně vyberte Aplikovat jen na sledované. Stejně tak proces spustíte i na stránce Nastavení, v záložce Přegenerování, kde v části Aplikovat pravidla jen na sledované položky klikněte na tlačítko Aplikovat jen na sledované. Po dokončení aplikace pravidel na sledované produkty se na konci stránky zobrazí seznam všech sledovaných produktů. Jednotlivé položky si můžete rozkliknout, což vás odkáže na stránku Sledované produkty, kde si můžete rovnou zkontrolovat proběhlé změny. ### 3. Přegenerování změněného Ve chvíli, kdy se rozhodnete provedené změny vypustit do inzertní platformy, je potřeba synchronizovat data. To znamená, že Mergado načte nová data ze vstupního feedu, poté aplikuje pravidla pouze na produkty změněné od posledního přegenerování, a pošle tato změněná data do výstupního feedu (a tedy do cílové platformy). * Kdy použít: Pokud chcete, aby se provedené změny „naostro“ a co nejrychleji propsali do výstupního feedu. Zároveň ale například nechcete kvůli několika menším změnám přegenerovávat kompletně celý feed. Oceníte to především, pokud máte ve feedu tisíce produktů, jejichž kompletní přegenerování by mohlo zabrat delší dobu. Tento způsob přegenerování je nejrychlejší a nejefektivnější. * Jak spustit: V rámci konkrétního projektu na stránce Pravidla klikněte na Spustit procesy ručně a následně vyberte Přegenerovat změněné. Tento proces můžete spustit také na stránce Nastavení. Zde klikněte na záložku Přegenerování a v části Přegenerovat projekt klikněte na tlačítko Přegenerovat změněné. ### 4. Přegenerování všeho Jedná se o stejný proces jako v předchozím bodě, avšak v tomto případě se synchronizace provádí na všech datech. Mergado opět načte nová data ze vstupního feedu, poté aplikuje pravidla, a pošle tato změněná data do výstupního feedu. Mergado při tomto procesu zpracuje a aktualizuje kompletně všechny položky, tedy i ty, u kterých se po dokončení zpracování výstupní hodnoty nijak nezmění. Tento způsob přegenerování pochopitelně trvá výrazně déle, zejména pokud máte rozsáhlý feed. * Kdy použít: Pokud chcete aktualizovat také produkty, které nebyly od minulého přegenerování změněné. To můžete požadovat například ve chvíli, kdy u posledního přegenerování došlo k chybám, některá data nebyla aktualizována nebo došlo k jiným nestandardním stavům. Kompletní přegenerování feedu může pomoci s odstraněním těchto problémů. * Jak spustit: V rámci konkrétního projektu přejděte na stránku Nastavení. Zde klikněte na záložku Přegenerování a v části Přegenerovat projekt klikněte na tlačítko Přegenerovat vše. ### 5. Import vstupních dat Mergado stáhne nejnovější zdrojová data ze vstupního feedu a aktualizuje interní data v Mergadu. Při tomto procesu neprobíhá aplikování pravidel a výstupní feed není nijak ovlivněn. * Kdy použít: Pokud došlo ve vašich vstupních datech ke změnám (např. doplnili jste nové produkty, změnili se ceny) a vy chcete na těchto nových datech provádět v Mergadu úpravy. Zároveň ale nechcete, aby se nová data ze vstupního feedu rovnou propsala i do výstupního. * Jak spustit: V rámci vybraného projektu přejděte na stránku Nastavení. Přejděte na záložku Přegenerování a v části Přegenerovat projekt klikněte na tlačítko Import vstupních dat. ### 6. Export výstupních dat Mergado vyexportuje aktuální data do výstupního feedu. Při tomto procesu se nestáhnou aktuální data ze vstupního feedu, ani se neaplikují pravidla. Pokud tedy chcete, aby se do exportu propsala pravidla a úpravy, které jsme předtím provedli, je potřeba nejdříve změny potvrdit kliknutím na Aplikovat pravidla. * Kdy použít: Pokud chcete, aby se na inzertní platformě okamžitě projevily úpravy, které jste udělali v Mergadu (např. před spuštěním kampaně), zároveň ale nechcete znovu načítat vstupní feed (např. kvůli omezenému počtu stažení na straně e-shopové platformy). * Jak spustit: V rámci vybraného projektu přejděte na stránku Nastavení. Přejděte na záložku Přegenerování a v části Přegenerovat projekt klikněte na tlačítko Spustit export. ### 7. Automatické přegenerování Mergadem Mergado několikrát denně automaticky provádí přegenerování, aby vaše data ve výstupních feedech byla vždy aktuální. Tato automatická synchronizace svým průběhem odpovídá procesu přegenerování změněného. Automaticky se tedy vždy přegeneruje pouze to, co se změnilo od posledního přegenerování (nikoliv kompletně celý feed). #### Kdy probíhá automatické přegenerování Po vytvoření projektu se spustí funkce automatického přegenerovávání dat a není potřeba tuto funkci zapínat ručně. Přegenerování probíhá několikrát denně a je závislé především na změnách ve vstupním feedu, tzn. čím častěji se mění data ve vstupním feedu, tím častěji Mergado přegenerovává, aby výstupní feed udrželo co nejaktuálnější. #### Jak vypnout nebo znovu spustit automatické přegenerování Pokud zrovna provádíte rozsáhlejší změny ve feedu a nechcete riskovat, že se v průběhu práce automaticky spustí přegenerování a do výstupního feedu se tak dostanou i změny, které nejsou kompletní, nebo je nemáte vyzkoušené „nanečisto“, můžete toto automatické přegenerování jednoduše pozastavit a ve vhodnou chvíli opět spustit. V rámci projektu, ve kterém provádíte změny, přejděte do sekce Nastavení. Zde klikněte na záložku Přegenerování a v části Nastavená přegenerování kliknutím na tlačítko Pozastavit přegenerování dočasně zastavíte automatickou synchronizaci dat. Až budete mít potřebné úpravy feedu dokončeny, automatické přegenerování jednoduše na stejném místě spustíte kliknutím na tlačítko Povolit přegenerování. #### Jak naplánovat automatické přegenerování dat Pokud nechcete, aby Mergado samo plánovalo přegenerování a chcete mít tento proces pod kontrolou, můžete si přegenerování jednoduše sami nastavit na vybrané časy. 1. V rámci vybraného projektu přejděte na stránku Nastavení. Zde klikněte na záložku Přegenerování a přejděte do části Nastavení přegenerování. 2. Klikněte na tlačítko Upravit. Zde si v sekci Manuální můžete nastavit až 6 časových slotů, kdy se bude projekt přegenerovávat. Odstup mezi jednotlivými sloty musí být minimálně 2 hodiny. 3. Následně vyberte časové pásmo a klikněte na Uložit. V případě, že budete chtít manuálně nastavené přegenerování přepnout zpět na automatické, přejděte opět do části Nastavení přegenerování, klikněte na Upravit, dále na Automatický a potvrďte kliknutím na Uložit. #### Jak zjistit, kdy byl projekt přegenerován Jak často je konkrétní projekt přegenerováván snadno zjistíte v záložce Historie. Zde můžete sledovat jednotlivé procesy a v kolonce Typ událostí je možné si vybrat a vyfiltrovat konkrétní typ přegenerování, který chcete sledovat, např. Import produktů, Aplikování pravidel nebo Export produktů. Historie také rozlišuje mezi plánovaným přegenerováním (v rámci manuálního nebo automatického nastavení), např. Plánovaný import produktů, a přegenerováním spuštěným jednorázově a ručně, např. Import produktů. ## FAQ: Jak funguje přegenerování a aktualizace dat v Mergadu? ### Co znamená „přegenerování“ v Mergadu? Přegenerování je proces, při kterém Mergado načte aktuální data ze vstupního feedu, aplikuje na ně vaše pravidla a úpravy, které jste provedli, a takto aktualizovaná data pošle do výstupního feedu. Zajišťuje tak, že se ve vašich inzertních kanálech (např. Heurece, Googlu nebo Facebooku) zobrazují správně upravené a aktuální informace. ### Jaký je rozdíl mezi „aplikováním pravidel“ a „přegenerováním“? * Aplikování pravidel probíhá pouze v rámci Mergada. Mergado upraví data podle vašich pravidel, ale změny se nepropíší do výstupního feedu. * Přegenerování už tyto úpravy přenese „naostro“ do výstupního feedu, který si stahují inzertní platformy. Jinými slovy: „Aplikovat pravidla“ je v podstatě testovací krok, „Přegenerovat“ znamená publikovat změny do výstupního feedu. ### Kdy použít „Aplikovat pravidla“? Pokud si chcete ověřit, jak pravidla ovlivňují produkty, aniž byste tyto změny ihned zveřejnili ve výstupním feedu. Například když testujete nové podmínky nebo kontrolujete, zda pravidlo funguje správně. ### Kdy použít „Aplikovat pravidla jen na sledované produkty“? Tuto funkci použijte, když potřebujete otestovat dopad pravidel pouze na konkrétní produkty nebo kategorie, aniž byste zpracovávali celý feed. Je to ideální způsob, jak rychle zjistit, jestli pravidla fungují podle očekávání. ### Co znamená „Přegenerovat změněné“? Při tomto procesu Mergado: 1. Načte aktuální vstupní data. 2. Aplikuje pravidla. 3. Aktualizuje pouze produkty, které se od posledního přegenerování změnily, a pošle takto aktualizovaná data do výstupního feedu. Je to nejrychlejší a nejčastější způsob aktualizace dat, vhodný např. pro denní synchronizaci dat. ### Co znamená „Přegenerovat vše“? Při tomto procesu Mergado: 1. Načte aktuální vstupní data. 2. Aplikuje pravidla. 3. Aktualizuje všechny produkty ve feedu, nejen ty, kterých se týkají změny. Tento způsob přegenerování trvá déle, ale je vhodný například po rozsáhlých změnách pravidel, při podezření, že v minulém přegenerování došlo k chybám, nebo když potřebujete mít jistotu, že všechna data jsou znovu zpracovaná od začátku. ### K čemu je „Import vstupních dat“? Při tomto procesu se stáhne aktuální verze vašeho vstupního feedu do Mergada, ale nejsou aplikována pravidla a data nejsou exportována do výstupního feedu. Tento krok použijte, když chcete nejdříve pracovat s novými daty v editoru (např. otestovat pravidla), ale zatím nechcete, aby se změny propsaly do inzerce. ### K čemu je „Export výstupních dat“? Při tomto procesu se exportují aktuální data z Mergada do výstupního feedu, který si následně stahují inzertní systémy. Při samostatném exportu se už neprovádí import nových vstupních dat ani nové aplikování pravidel. Zpracují se data tak, jak aktuálně v Mergadu jsou. Tento krok použijte, například když chcete ručně spustit aktualizaci výstupního feedu před spuštěním kampaně, ale nechcete znovu načítat celý vstupní feed. ### Jak často probíhá automatické přegenerování? Automatické přegenerování probíhá několikrát denně, a to podle aktivity ve vašem vstupním feedu. Pokud se data ve feedu mění často, Mergado je přegenerovává častěji. Pokud chcete mít časy plně pod kontrolou, můžete si je nastavit ručně a zvolit si až 6 časových slotů denně. ### Mohu naplánovat přegenerování na konkrétní čas? Ano. U vybraného projektu v části Nastavení → Přegenerování → Nastavení přegenerování klikněte na tlačítko Upravit. Zvolte možnost Manuální a zde si můžete zvolit až 6 časových slotů denně (s minimálním rozestupem 2 hodiny). Potvrďte kliknutím na Uložit. Tím určíte, kdy bude váš projekt automaticky přegenerováván. ### Jak pozastavit a znovu spustit automatické přegenerování? Na stránce Nastavení přejděte na Přegenerování. Zde v části Nastavení přegenerování klikněte na tlačítko Pozastavit přegenerování, čímž se automatická aktualizace dat dočasně vypne.Až budete chtít proces obnovit, stačí na stejném místě kliknout na Povolit přegenerování. Tuto funkci využijete například při větších úpravách dat, kdy nechcete, aby se rozpracované změny propsaly do výstupních dat. ### Jak zjistím, kdy naposledy proběhlo přegenerování? U vybraného projektu přejděte na stránku Přehled. Zde uvidíte, kdy proběhl poslední import, aplikování pravidel, export i přístup k výstupnímu feedu. Pokud chcete zjistit, kdy tyto procesy proběhly i hlouběji v minulosti, přejděte u vybraného projektu na stránku Historie. Zde najdete všechny události projektu včetně typu procesů, datumu i času jejich spuštění. ### Mohu během přegenerování pracovat na jiných projektech? Ano. Přegenerování běží na pozadí na serveru Mergada, takže můžete přepínat mezi projekty, záložkami nebo i zavřít prohlížeč. Proces se tím nepřeruší a jeho stav můžete později ověřit na stránce Historie. ### Lze přegenerování nějak urychlit? Částečně ano. Přegenerování bude rychlejší například pokud zvolíte možnost Přegenerování změněného, kdy se zpracují pouze produkty, u nichž došlo ke změnám, místo Přegenerovat vše, kdy se zpracovává kompletně celý feed. Urychlení dosáhnete také tím, když budete efektivně nastavovat pravidla, to znamená, že pokud je to možné, použijete pro požadovanou úpravu jedno pravidlo namísto dvou nebo více. Nejvíce však celkovou délku přegenerování ovlivňuje velikost feedu. ### Lze přegenerovat jen část produktů nebo konkrétní produkt? Teoreticky ano, ale při procesu je nutné dávat si pozor. Pokud si některé produkty označíte jako sledované, následně nastavíte pravidlo, aplikujete jej pouze na tyto sledované produkty a poté využijete možnost Přegenerovat změněné, pak se změny projeví opravdu pouze na sledovaných produktech. V průběhu procesu však nesmíte provést žádné další změny na jiných produktech, protože ve chvíli, kdy byste spustili možnost Přegenerovat změněné, tak by se do výstupního feedu propsali i tyto další změny. ### Mohu průběh přegenerování nějak zrušit či zastavit? Ano. Pokud jste spustili přegenerování, ale chcete jej v průběhu zrušit, jednoduše klikněte na tlačítko Zrušit. Proces se ihned ukončí a pokud přegenerování neproběhlo celé, nedojde k aktualizaci výstupního feedu. ### Za jak dlouho po přegenerování se změny projeví ve výstupním feedu? Změny se ve výstupním feedu projeví okamžitě po dokončení přegenerování. Platformy jako Heureka nebo Google Merchant Center si pak data z tohoto feedu načítají podle svého vlastního harmonogramu. ### Jak poznám, že se přegenerování dokončilo? Na stránce Historie u projektu vidíte seznam všech proběhlých procesů, včetně data, času, typu a výsledku. Zde si tedy můžete ověřit, že přegenerování skutečně proběhlo. --- ## [CDATA v Mergadu](https://help.mergado.com/cs/mergado-editor/formaty-feedu-a-pokrocile-datove-situace/technicke-detaily-formatu/cdata-v-mergadu/) # CDATA v Mergadu # CDATA v Mergadu ## K čemu CDATA slouží a proč je důležitá CDATA (z anglického *Character Data*) je způsob, jak v XML ochránit část textu před vyhodnocením jako kód. V e-commerce feedech se hodí hlavně tam, kde elementy obsahují HTML nebo speciální znaky — typicky u `` či ``. Bez CDATA by se HTML tagy (např. ``, ``) mohly číst jako XML elementy, což vede k nevalidnímu feedu nebo ztrátě obsahu. V této nápovědě si ukážeme, co CDATA je a jak element v Mergadu jednoduše obalit do CDATA — buď jedním kliknutím v kartě **Elementy**, nebo ručně pomocí pravidla **Přepsat**. --- ## Co je CDATA (stručně) CDATA označuje úsek textu, který se **neparsuje jako XML** a zůstane přesně tak, jak je zapsán. **Příklad:** ```xml Stylová košile z bavlny]]> ``` Bez CDATA by se HTML značky `` a `` mohly interpretovat jako XML elementy a způsobit chybu ve feedu. --- ## Jak přidat CDATA v Mergadu (step-by-step) ### A) Nejjednodušší způsob (doporučeno): přes kartu Elementy 1. Přejděte do karty **Elementy**. 2. U požadovaného elementu (např. `DESCRIPTION`) klikněte na ikonu **CDATA**. 3. **Přegenerujte výstupní feed**: **Nastavení → Přegenerování**, aby se změna projevila. 4. Potřebujete CDATA zrušit? U stejného elementu obalení **opět vypněte**. ### B) Manuální způsob: pravidlem Přepsat 1. Vytvořte pravidlo **Přepsat** pro daný element. 2. Do pole **Nová hodnota** zadejte CDATA obal, např.: ``` ``` 3. Po přegenerování uvidíte ve výstupním feedu např.: ```xml ``` --- ## Tipy z praxe * **Používejte CDATA** u elementů s HTML formátováním (např. `DESCRIPTION`) nebo se speciálními znaky. * Po každé úpravě **nezapomeňte přegenerovat** feed (**Nastavení → Přegenerování**). * Když CDATA chybí, některé HTML značky mohou **zhavarovat validaci** nebo se **nezobrazí** správně. --- ## FAQ **Co přesně je CDATA?** Je to úsek v XML, jehož obsah se **nevyhodnocuje jako kód**, ale bere se doslova jako text. **Kdy mám CDATA použít?** Když element obsahuje **HTML** nebo speciální znaky — nejčastěji u `DESCRIPTION` nebo `LONGDESC`. **Jak nejrychleji obalím element do CDATA v Mergadu?** V kartě **Elementy** klikněte u daného elementu na **ikonu CDATA** a poté **přegenerujte** feed. **Jak CDATA přidám ručně?** Vytvořte pravidlo **Přepsat** a do nové hodnoty vložte CDATA, např. ``. **Musím po změně něco dělat, aby se projevila?** Ano, je potřeba **přegenerovat výstupní feed**: **Nastavení → Přegenerování**. **Co když CDATA nepoužiji?** HTML značky se mohou brát jako XML tagy, což vede k **chybě validace** nebo ke **ztrátě/zkomolení obsahu**. **Lze obalení CDATA zase vypnout?** Ano, v kartě **Elementy** u daného elementu **zrušíte obalení** stejnou ikonou. --- ## [Jak v Mergadu zefektivnit správu produktových dat pomocí Master Feedu?](https://help.mergado.com/cs/mergado-editor/prace-s-daty/pokrocile-workflow-a-sprava-feedu/jak-v-mergadu-zefektivnit-spravu-produktovych-dat-pomoci-master-feedu/) # Jak v Mergadu zefektivnit správu produktových dat pomocí Master Feedu? Inzerujete stejné produkty na více reklamních platformách a řešíte, jak se vyhnout tomu, abyste museli u každého projektu pořád dokola provádět stejné úpravy a nastavovat totožná pravidla? Vytvořte si jeden Master Feed, který následně využijete jako zdroj dat pro jednotlivé projekty. Umožní vám provést úpravy společné pro všechny projekty hromadně a jen jednou. Ušetříte tak spoustu času i energie a následně už jen doladíte jednotlivé projekty podle specifik daných reklamních platforem. Master Feed slouží jako váš centrální zdroj produktových dat. Místo, kde je vyčistíte, sjednotíte a připravíte tak, aby byly ideálním podkladem pro všechny reklamní platformy, na kterých inzerujete. ### Proč a kdy využít Master Feed Master Feed vám usnadní práci ve chvíli, kdy chcete jeden produktový feed posílat na vícero inzertních platforem. V Mergadu to znamená, že máte pod jedním e-shopem vytvořeno několik projektů pro jednotlivé inzertní platformy (např. pro Google, Facebook, Heureku, Zboží, Glami a další) a pro všechny používáte stejný zdroj dat. Tímto společným zdrojem dat může být právě master feed, ve kterém vždy pouze jednou provedete úpravy a nastavíte pravidla, která se týkají všech inzertních platforem, a nemusíte opakovaně dělat stejné úkony u každého projektu zvlášť. Stačí si pod stejným e-shopem vytvořit nový projekt, který bude master feedem. Na vstupu vložíte svá produktová data (např. produktový feed generovaný vaším e-shopem) a výstupní feed pak použijete jako vstupní feed pro všechny ostatní projekty vytvořené pro jednotlivé inzertní platformy. ### Příklady využití Master Feedu #### 1. Nekonzistentní nebo neúplná data v produktovém feedu Mnoho inzertních platforem má podobné nebo stejné požadavky pro to, jaké informace mají obsahovat jednotlivé elementy. Například Heureka, Zboží.cz i Glami vyžadují, aby názvy produktů obsahovaly také název výrobce. Pokud tedy ve vašem produktovém feedu v názvu produktu tato informace chybí, stačí v Master Feedu jednou nastavit pravidlo, kterým tento problém vyřešíte, a nemusíte pravidlo nastavovat zvlášť v jednotlivých projektech pro Heureku, Zboží a Glami. Podobně například téměř všechny inzertní platformy vyžadují nebo doporučují mít správně vyplněny EAN kódy. EANy tedy doplníte nebo opravíte pouze jednou v Master Feedu a kódy se automaticky propíší do všech projektů pro jednotlivé platformy. Hromadně můžete v Master Feedu doplnit také například chybějící parametry produktů (velikosti, barvy apod.), které jsou často vyžadovány pro určitý sortiment. Typicky tomu tak je například u Heureky, Zboží, GLAMI, FAVI, Biana nebo Google Nákupů. #### 2. Produktový feed obsahuje produkty, které nechcete inzerovat Obsahuje váš produktový feed zboží, které na reklamních platformách nechcete inzerovat (např. velmi levné produkty, zboží s nízkou marží, vyprodané produkty, příslušenství apod.)? Skryjte je jednou a hromadně v Master Feedu a produkty se skryjí také ve všech souvisejících projektech. #### 3. Nastavení ceny dopravy pro všechny reklamní platformy najednou Nastavte si dopravce a ceny za dopravu pouze jednou v Master Feedu a nastavení se projeví ve všech souvisejících projektech. Také v budoucnu, pokud budete chtít například některé dopravce přidat nebo odebrat nebo změnit jejich cenu, stačí úpravu provést pouze v Master Feedu. ### Jak vytvořit Master Feed 1. Master Feed si v Mergadu vytvoříte stejným způsobem jako jakýkoliv jiný projekt. Postupovat můžete podle [tohoto návodu](https://forum.mergado.cz/t/jak-v-mergadu-vytvorit-novy-projekt/jak-v-mergadu-vytvorit-novy-projekt). 2. Jako vstupní feed použijte takový produktový feed, který obsahuje co nejvíce informací o vašich produktech (název, cenu, obrázek, důležité parametry). Může jít například o produktový feed generovaný vaším e-shopem. 3. Jako výstupní formát zvolte stejný formát, jako máte na vstupu. (Například pokud jste jako vstupní feed zvolili produktový feed, který váš e-shop generuje pro Heureku, zvolte jako výstupní formát také Heureka formát.) 4. Projekt si vhodně pojmenujte, abyste ihned poznali, že se jedná o Master Feed (např. *název-eshopu.cz – Master Feed*). 5. V Master Feedu nastavte pravidla a proveďte obecné a základní úpravy produktových dat, které se mají týkat všech reklamních systémů, na kterých chcete inzerovat (např. doplnění výrobců do názvů produktů nebo nastavení dopravy). 6. Následně (pod stejným e-shopem) vytvořte jednotlivé projekty pro vybrané reklamní platformy, kde u všech jako vstupní feed vložíte výstupní feed z vytvořeného Master Feedu. Na výstupu zvolíte formát na základě inzertní platformy, pro kterou projekt vytváříte. Pak už stačí pouze v každém projektu dle potřeby provést specifické úpravy podle požadavků konkrétní reklamní platformy. ### Jak ihned dostat změny provedené v Master Feedu do souvisejících projektů Mergado samo vyhodnocuje, jak často je potřeba data aktualizovat, a automaticky je [přegenerovává](https://forum.mergado.cz/t/jak-funguje-pregenerovani-a-aktualizace-dat-v-mergadu/jak-funguje-pregenerovani-a-aktualizace-dat-v-mergadu) (tzn. aktualizuje) několikrát denně (obvykle za jednu až tři hodiny). Tímto procesem se tedy nemusíte zabývat. Pokud však z nějakého důvodu chcete provedené změny ihned vidět ve feedu, můžete data přegenerovat ručně. Po provedení úprav v Master Feedu přejděte na stránku *Pravidla*, klikněte na *Spustit procesy ručně* a následně vyberte *Přegenerovat změněné*. Stejný postup zopakujte i u souvisejících projektů. ### Jak zjistit, u kterých projektů využívám Master Feed V Mergadu si můžete snadno zkontrolovat, u kterých projektů jako vstupní feed používáte data z Master Feedu. 1. V projektu, který je Master Feedem, přejděte na stránku *Nastavení*. 2. Zde v sekci *Obecná nastavení projektu – Základní informace* klikněte u kolonky *Výstupní feed* na šipku směřující dolů. 3. Zobrazí se vám seznam projektů, u kterých je jako vstupní feed použit Master Feed. Do vybraných projektů se můžete z tohoto místa rovnou prokliknout. Podobně si můžete u vybraného projektu ověřit, zda je jako vstupní feed použit Master Feed. 1. U vybraného projektu, u kterého chcete zkontrolovat, jaký feed je na vstupu, přejděte na stránku *Nastavení*. 2. Zde v sekci *Obecná nastavení projektu – Základní informace* klikněte u kolonky *Vstupní feed* na šipku směřující dolů. 3. Zobrazí se vám projekt, jehož výstupní feed jste zde použili na vstupu. Do tohoto projektu (Master Feedu) se můžete z tohoto místa rovnou prokliknout. ### Jak Master Feedu ovlivní cenu za používání Mergada Master Feed je dalším projektem, to znamená že navýší celkový počet produktů na výstupu u daného e-shopu. Může se tedy stát, že ovlivní cenu za používání Mergada. Pokud máte například ve svém produktovém feedu přes 3 000 položek a inzerujete na třech různých reklamních platformách (máte tedy vytvořeny tři různé projekty), máte celkem na výstupu okolo 9 000 položek. Spadáte tak do tarifu Basic. S vytvořením Master Feedu se počet položek na výstupu navýší na 12 000 položek, což znamená přesun do vyššího cenového tarifu Standard. Před implementací Master Feedu tedy myslete na to, že může ovlivnit cenu za používání Mergada. Přestože se náklady na Mergado tímto mohou mírně navýšit, investice se vám vrátí v podobě obrovské úspory času a efektivnější správy produktového feedu. Více informací o [cenách](https://www.mergado.cz/cenik) za používání Mergada najdete v článku [Změna tarifu pro e-shop](https://forum.mergado.cz/t/zmena-tarifu-pro-e-shop/zmena-tarifu-pro-e-shop). ### Závěr Master Feed funguje jako „centrální základna“ pro úpravu vašich produktových dat. Místo abyste dělali stejné úpravy pro každý reklamní kanál zvlášť, provedete je pouze jednou v Master Feedu, odkud se automaticky distribuují do všech souvisejících projektů. To vám umožní soustředit se na finální dolaďování jednotlivých reklamních platforem, aniž byste museli ztrácet čas s duplicitní prací. Výsledkem je úspora času, čistší data, méně chyb, rychlejší práce a hlavně větší prostor pro strategii místo rutiny. *Tip: Implementaci Master Feedu doporučujeme provést hned na začátku práce se správou vašich produktových dat, ideálně předtím, než začnete tvořit jednotlivé související projekty. Zajistíte si tak hladkých přechod dat a minimalizujete pravděpodobnost vzniku chyb a zmatku mezi projekty.* ## FAQ: Jak v Mergadu zefektivnit správu produktových dat pomocí Master Feedu ### Co je Master Feed a k čemu slouží? Master Feed je centrální zdroj dat, který použijete jako základ pro projekty, kde chcete využít stejná produktová data. Umožňuje vám upravit společná data jen jednou a následně využít upravený výstup jako vstup pro projekty určené pro jednotlivé reklamní platformy (např. Heureka, Zboží.cz, GLAMI, Facebook). Díky tomu se vyhnete opakování stejných úprav v každém projektu zvlášť. ### Kdy má smysl Master Feed použít? Master Feed se hodí vždy, když posíláte stejná produktová data na více inzertních platforem. Typicky v situaci, kdy máte pod jedním e-shopem založeno několik projektů (např. Heureka, Zboží.cz, GLAMI, FAVI, Google Nákupy) a všechny používají stejný vstupní feed. Master Feed je vhodné použít jako jeden sdílený základ, ve kterém provedete společné úpravy jen jednou. ### Jak mi Master Feed ušetří čas a práci? Všechny všeobecné a základní úpravy provedete pouze v jednom projektu – v Master Feedu. Nemusíte tak jednotlivě upravovat názvy, parametry, EAN kódy nebo nastavení dopravy v samostatných projektech pro každou platformu. Změny se z Master Feedu automaticky propisují do všech souvisejících projektů, u kterých jako vstupní feed použijete výstupní feed z Master Feedu. ### Jaké typy úprav je vhodné dělat v Master Feedu? V Master Feedu nastavujete pravidla a provádíte úpravy, které mají být společné pro všechny inzertní platformy. Patří sem například: * doplnění výrobců do názvů produktů, * oprava či doplnění EAN kódů,.0 * doplnění chybějících parametrů (velikosti, barvy apod.), * skrytí produktů, které nechcete inzerovat, * nastavení dopravců a cen dopravy. ### Proč je výhodné dělat některé úpravy v Master Feedu? Protože mnoho inzertních platforem má podobné nebo stejné požadavky pro produktové feedy. Například Heureka, Zboží.cz a GLAMI vyžadují výrobce v názvu produktu a většina platforem doporučuje nebo vyžaduje správně vyplněné EAN kódy. Díky Master Feedu tyto informace doplníte nebo opravíte jen jednou a změny se automaticky dostanou do všech souvisejících projektů. ### Mohu v Master Feedu skrýt produkty, které nechci inzerovat? Ano. Pokud váš produktový feed obsahuje položky, které nechcete inzerovat (např. příliš levné produkty, příslušenství, zboží s velmi nízkou marží nebo vyprodané produkty), můžete je v Master Feedu skrýt hromadně. Skrytí se následně projeví ve všech navázaných projektech. ### Mohu v Master Feedu nastavit ceny dopravy pro všechny platformy najednou? Ano. Dopravce a ceny dopravy nastavíte v Master Feedu pouze jednou. Nastavení se projeví ve všech propojených projektech. Pokud se ceny dopravy v budoucnu mění, stačí úpravu udělat pouze v Master Feedu. ### Jak vytvořím Master Feed v Mergadu? Master Feed vytvoříte stejně jako kterýkoliv jiný projekt: 1. Založíte v Mergadu [nový projekt](https://forum.mergado.cz/t/jak-v-mergadu-vytvorit-novy-projekt/jak-v-mergadu-vytvorit-novy-projekt). 2. Jako vstupní feed použijete produktový feed, který obsahuje co nejvíce informací o vašich produktech (např. produktový feed generovaný přímo vaším e-shopem). 3. Jako výstupní formát zvolíte stejný formát, jaký máte na vstupu. 4. Projekt vhodně pojmenujete, abyste jej snadno rozeznali od ostatních projektů určených pro jednotlivé inzertní platformy (např. „název-eshopu.cz – Master Feed“). 5. Nastavíte pravidla a provedete obecné úpravy, které jsou společné pro všechny platformy, na kterých chcete inzerovat. 6. Poté vytvoříte jednotlivé projekty pro konkrétní inzertní platformy a jako vstupní feed u nich použijete výstupní feed z Master Feedu. ### Musím v projektech pro jednotlivé platformy ještě něco nastavovat? Ano. V těchto projektech provádíte jen úpravy specifické pro danou platformu, například mapování kategorií nebo úpravu elementů podle požadavků konkrétního systému. Obecné úpravy už máte hotové v Master Feedu. ### Jak rychle se změny z Master Feedu projeví v ostatních projektech? Mergado přegenerovává (aktualizuje) data automaticky několikrát denně. Pokud ale chcete, aby se změny projevily okamžitě po tom, co v Master Feedu něco upravíte, můžete data přegenerovat ručně: 1. V Master Feedu přejděte na stránku *Pravidla*. 2. Klikněte na *Spustit procesy ručně*. 3. Vyberte *Přegenerovat změněné*. 4. Stejný postup zopakujte v navázaných projektech. ### Jak zjistím, které projekty používají Master Feed jako vstupní feed? V projektu, který je Master Feedem: 1. Přejděte na stránku *Nastavení*. 2. V sekci *Obecná nastavení projektu – Základní informace* klikněte u kolonky *Výstupní feed* na šipku dolů. 3. Zobrazí se seznam všech projektů, u kterých jste jako vstupní feed nastavili Master Feed. Z tohoto seznamu se můžete přímo prokliknout do jednotlivých projektů. ### Jak ověřím, že konkrétní projekt používá jako vstup data z Master Feedu? V konkrétním projektu: 1. Přejděte na stránku *Nastavení*. 2. V sekci *Obecná nastavení projektu – Základní informace* klikněte u kolonky *Vstupní feed* na šipku dolů. 3. Zobrazí se projekt, jehož výstupní feed je zde použit jako vstupní feed. ### Ovlivní Master Feed cenu za používání Mergada? Ano, může ovlivnit výslednou cenu. Master Feed totiž představuje další projekt, který navyšuje celkový počet položek na výstupu jednoho e-shopu. Právě výsledný počet položek na výstupu ovlivňuje [cenu za používání Mergada](https://forum.mergado.cz/t/zmena-tarifu-pro-e-shop/zmena-tarifu-pro-e-shop). Příklad: * Pokud máte v produktovém feedu přibližně 3 000 položek a v Mergadu vytvořeny tři projekty (pro tři různé reklamní platformy), máte celkem okolo 9 000 položek na výstupu (tarif Basic). * Přidáním Master Feedu se počet zvýší o dalších 3 000 položek, celkem tedy bude na výstupu přibližně 12 000 položek, což znamená přesun do vyššího tarifu Standard. Před zavedením Master Feedu si proto zkontrolujte celkový počet položek na výstupu. ### Kdy je nejlepší Master Feed vytvořit? Ideálně hned na začátku práce se správou produktových dat. Tedy ještě před tím, než začnete zakládat jednotlivé projekty pro reklamní platformy. Zajistíte tím hladký tok dat a minimalizujete riziko chyb. ### Jaký je hlavní přínos Master Feedu? Master Feed vám umožní provádět rutinní úpravy dat pouze jednou, centrálně a efektivně. To vám ušetří obrovské množství času, který byste jinak trávili opakováním stejných operací napříč jednotlivými projekty. Zároveň tím výrazně snižujete riziko chyb, které často vznikají právě při manuální a duplicitní práci. Méně chyb pak ve výsledku znamená i úsporu nákladů na inzerci, protože zamezíte nedostatkům, které mohou negativně ovlivnit výkon kampaní. Díky Master Feedu se tak můžete soustředit na strategii a doladění detailů místo technické rutiny. --- ## [Jak v Mergadu vytvořit nový projekt?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/sprava-projektu-v-mergadu/jak-v-mergadu-vytvorit-novy-projekt/) # Jak v Mergadu vytvořit nový projekt? Rozhodli jste se se svým e-shopem vstoupit na novou reklamní platformu (např. Heureka, Sklik, Google, Kaufland nebo ChatGPT) a jako pomocníka jste si vybrali Mergado? Ukážeme vám, že vytvořit nový projekt zvládnete snadno a rychle i sami. ## Jaký je rozdíl mezi e-shopem a projektem E-shop v rámci Mergada sdružuje jednotlivé projekty. Pod jedním e-shopem můžete mít tolik projektů, kolik potřebujete. Představte si například e-shop v Mergadu jako váš vlastní e-shop (příklad: Můj-eshop.cz) a projekty jako jednotlivé platformy, na kterých produkty z tohoto e-shopu chcete inzerovat (např. Heureka, Allegro, ChatGPT, Facebook atd.) Pokud máte vícero online obchodů, založte v Mergadu pro každý samostatný e-shop a pod ním opět vytvořte jednotlivé projekty, které jsou s ním spojené. Každý e-shop bude následně fakturován zvlášť. ℹ️ *Dle [Podmínek užívání](https://www.mergado.cz/podminky-uzivani) Mergada není možné mít v rámci jednoho e-shopu více různých internetových obchodů. Pokud tedy máte dva internetové obchody a každý je na vlastní doméně, je potřeba v rámci Mergada vytvořit také dva e-shopy, pod kterými si vytvoříte příslušné projekty pro jednotlivé reklamní platformy.* ## Co je produktový feed Produktový (neboli datový) feed je strukturovaný datový soubor, který obsahuje tzv. elementy. Tyto elementy jsou nositeli informací o vámi prodávaném zboží. Obsahují například název produktů, jejich popis, cenu, dostupnost, kategorii a mnoho dalšího. Pro vytvoření projektu je potřeba, abyste Mergadu tyto strukturované informace o vašich produktech poskytli. Feed, který do Mergada vložíte, označujeme jako vstupní feed. V Mergadu pracujeme také s označením výstupní feed. Jedná se o feed obsahující všechna vaše data a také úpravy, které jste provedli v Mergado Editoru, a je tedy připraven na míru pro reklamní platformu, kvůli které vytváříte projekt. vstupní feed → Mergado → výstupní feed ## Co je formát produktového feedu Podobně jako si můžete třeba svoje poznámky uložit do wordového dokumentu (docx) nebo do excelové tabulky (xlsx), tak stejně tak produktový feed může být uložen v různých formátech. Nejčastěji je to XML, CSV, JSON nebo Google Sheet. Mergado všechny tyto formáty podporuje a záleží na vás, v jakém z nich svůj vstupní feed do Mergada vložíte. V průběhu vytváření projektu si také zvolíte, v jakém formátu má být výstupní feed. To zvolíte na základě toho, pro jakou platformu jsou vaše data v konkrétním projektu určena (např. Heureka, Google, Zboží.cz, Kaufland Marketplaces). V případě, že chcete projekt využít pouze pro úpravu stávajících dat (např. v rámci vlastního e-shopu), zvolíte na vstupu a výstupu stejný formát. ## Jak získat URL vstupního feedu Pro nahrání vstupního feedu musíte do Mergada vložit jeho URL (jinými slovy odkaz na místo, kde je tento feed uložen). Nejedná se o adresu vašeho e-shopu, ale přímo adresu, kde jsou uložena data o jednotlivých položkách ve vašem e-shopu. URL feedu nejčastěji získáte v administraci své e-shopové platformy nebo u správce vašeho e-shopu. Může vypadat třeba nějak takto: *https://eshop.cz/feed.xml* Pokud máte e-shop na platformách jako Prestashop, Woocommerce nebo Opencard můžete využít náš bezplatný doplněk [Mergado Pack](https://pack.mergado.cz/), který vám pomůže vytvořit XML soubor s daty pro nahrání do Mergada. V případě, že nemáte k dispozici URL vašeho feedu, protože je uložen na FTP serveru, pomůže vám naše rozšíření [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about), které nedostupná data z FTP převede na veřejnou URL. ℹ️ *Mergado si váš vstupní feed bude stahovat z IP adresy 81.31.39.112. Pokud pro zabezpečení svých feedů používáte whitelist IP adres, je nutné si do něj IP adresu Mergada přidat.* ## Jak vytvořit nový projekt 1. Po přihlášení do vašeho Mergado účtu klikněte na tlačítko *Nový projekt*, čímž budete odkázání na stránku, kde si jej v několika krocích vytvoříte. → Pokud jste v Mergadu úplně poprvé, doporučujeme nejdříve si projít [Průvodce Mergado Editorem](https://app.mergado.com/guide), odkud se následně také dostanete k vytvoření projektu kliknutím na tlačítko *Vytvořit projekt*. 2. V prvním kroku klikněte na kolonku *E-shop*, kde vyberete e-shop, pod kterým chcete nový projekt vytvořit. a. Pokud jste v Mergadu poprvé (žádný e-shop ještě nemáte) nebo si přejete projekt vytvořit pod zcela novým e-shopem, klikněte na *Vytvořit e-shop*. Do kolonky napište název vašeho nového e-shopu a klikněte na *Potvrdit*. b. Pokud už v Mergadu máte e-shopy a projekt chcete vytvořit pod některým z nich, vyberte z nabídky požadovaný e-shop. 3. Klikněte na *Pokračovat*. 4. V dalším kroku vyberte *zdroj svého vstupního feedu* (místo, kde jsou uložena vaše produktová data). Můžete si vybrat z následujících možností napojení zdrojových dat. a. Produktový feed (URL) – pokud máte svůj produktový feed uložen na URL adrese, klikněte na *Použít URL feedu* b. Shopify – pokud provozujete svůj e-shop na platformě Shopify, klikněte na *Připojit přes Shopify* c. Dodavatelský feed Malfini – pokud chcete do svého projektu napojit Malfini dodavatelský feed, klikněte na *Napojit Malfini* d. UNAS – pokud provozujete svůj e-shop na platformě UNAS, klikněte na *Připojit přes UNAS* 5. Jak přesně napojit váš vstupní feed jednotlivými způsoby si ukážeme v následující části tohoto článku. Poté, co zvoleným způsobem napojíte data, klikněte na *Pokračovat*. 6. V dalším kroku vyberte *formát vašeho výstupního feedu* (neboli cílového příjemce vašich dat). Zjednodušeně řečeno, vyberte platformu, na které chcete začít inzerovat nebo pro kterou jsou vaše data určena (např. Heureka, Google, Facebook, dodavatelská aplikace, web, marketplace a jiné) a klikněte na tlačítko *Pokračovat*. → Mergado předvybere výstupní formát podle analýzy vašeho vstupního feedu (vybere nejpodobnější formát tomu vstupnímu). Vy si ale samozřejmě můžete zvolit takový formát, jaký chcete. → Pokud ani jeden z nabízených výstupních formátů neodpovídá formátu, který chcete mít na výstupu, klikněte na *Definovat vlastní formát* a nastavte si požadovaný výstupní formát. 7. V posledním kroku zkontrolujte (a případně kliknutím na ikonku tužky změňte), zda jsou veškerá nastavení zvolená tak, jak si přejete. → Jako název projektu bude automaticky doplněno to, co jste zvolili jako výstupní formát. Název můžete také změnit kliknutím na ikonku tužky. → Uvidíte také možnost změny *Párovacích elementů*. Tyto elementy obsahují unikátní informace a pomáhají rozlišit jednotlivé produkty ze vstupního feedu. Mergado vždy samo navrhne nejvhodnější elementy a jejich změna je pokročilou funkcí, kterou ve svém prvním projektu pravděpodobně nebudete potřebovat upravovat. 8. Klikněte na *Dokončit*. Mergado začne stahovat a importovat data. Rychlost importu závisí na velikosti feedu (u malého feedu je to rychlé, u feedu s desítkami tisíc produktů to může trvat několik minut). Po dokončení projektu bude *vytvořena URL výstupního feedu*. Tuto URL následně *vložíte do platformy, pro kterou jste tento projekt vytvořili*. K veškerým informacím o vytvořeném projektu se kdykoliv dostane přes stránku *[Detaily uživatele](https://app.mergado.com/user/details/)* ve vašem Mergado účtu. Zde najdete seznam všech svých e-shopů. Po kliknutí na vybraný e-shop se vám zobrazí seznam všech projektů v tomto e-shopu. Kliknutím na vybraný projekt se zobrazí veškeré informace o něm, včetně URL výstupního feedu. ℹ️ *Pokud už s Mergadem nějaký čas pracujete a nový projekt vytváříte pod již existujícím e-shopem, ve kterém máte aktivní projekt/y, může se stát, že s novým aktivním projektem přesáhnete limit svého aktuálně předplaceného tarifu. V případě, že současný tarif skutečně přesáhnete a přejdete na vyšší tarif, přijde vám do e-mailu upozornění. Pokud nový projekt zakládáte v rámci nově založeného e-shopu, přibude vám ve fakturaci nová položka s příslušným tarifem. Více informací o změnách tarifu najdete v [tomto článku](https://forum.mergado.cz/t/zmena-tarifu-pro-e-shop/zmena-tarifu-pro-e-shop).* ## Jak napojit různé zdroje produktových dat ### Produktový feed (URL) Tuto možnost vyberte v případě, že máte k dispozici URL svého produktového feedu, kterou jste získali z *administrace své e-shopové platformy nebo u správce vašeho e-shopu*. Případně pokud už Mergado využíváte a chcete jako vstupní feed použít například některý z výstupních feedů vašich jiných projektů. 1. Poté, co vyberete/vytvoříte e-shop, pod kterým bude projekt zařazen, klikněte na *Použít URL feedu*. 2. Zde vložíte URL vstupního feedu. a. Do kolonky *Zadejte URL adresu vstupního feedu* vložte URL vašeho produktového feedu. b. Pokud již Mergado používáte a chcete jako vstupní feed pro tento projekt využít již existující feed z některého vašeho jiného projektu, vyberte v kolonce *Existující URL* požadovaný feed. 3. Klikněte na *Pokračovat*. 4. V tomto kroku Mergado automaticky rozpozná formát vašeho vstupního feedu. Stačí tedy kliknout na tlačítko *Pokračovat*. a. V případě, že Mergado nerozpoznalo formát správně, klikněte na *Vybrat jiný formát*. Zde v kolonce *Vstupní formát* vyberte správný formát vašeho vstupního feedu a klikněte na *Pokračovat*. b. V případě, že formát vašeho vstupního feedu neodpovídá žádnému z nabízených formátů (máte například velmi specifický dodavatelský feed), klikněte na *Definovat vlastní formát*, kde si sami nastavíte formát vašeho zdroje. Po nastavení klikněte na *Uložit a pokračovat*. 5. Dále dokončíte vytváření projektu podle návodu v části *Jak vytvořit nový projekt* tohoto článku. ### Shopify Tento způsob napojení doporučujeme všem, kteří *svůj internetový obchod provozují na e-shopové platformě Shopify*. Možná už jste zjistili, že tato platforma neumožňuje export produktového feedu. Respektive umožňuje, ale museli byste pro vygenerování produktového feedu využít placenou aplikaci ze Shopify Store. Přímá integrace mezi Shopify a Mergadem vám tedy zjednoduší napojení vašeho e-shopu do Mergada. Propojení probíhá přes API, Mergado tedy nepotřebuje feed a informace o vašich produktech si vezme přímo z vašeho e-shopu. 1. Poté, co vyberete/vytvoříte e-shop, pod kterým bude projekt zařazen, klikněte na *Připojit přes Shopify*. 2. Vyplňte *Shopify Store URL pro Admin API* ve tvaru *nazev.myshopify.com*. Najdete ho v administraci vašeho e-shopu v sekci *Nastavení* pod názvem vašeho e-shopu (např. muj-eshop.myshopify.com). 3. Vyplňte *Client ID* a *Client Secret*. → [Jak získat Shopify API Credentials (Client ID a Client Secret), najdete v tomto návodu.](https://forum.mergado.cz/t/novy-projekt-vygenerovani-shopify-api-credentials/jak-zajistit-napojeni-e-shopove-platformy-shopify-na-mergado-editor) 4. Klikněte na *Pokračovat*. 5. Dále dokončíte vytváření projektu podle návodu v části *Jak vytvořit nový projekt* tohoto článku. ### Dodavatelský feed Malfini Toto napojení doporučujeme *e-shopařům, jejichž dodavatelem je Malfini*, a chtějí jejich produkty do svého e-shopu dostat jednoduše a na pár kliknutí. Jejich produkty si naimportujete ve zvoleném jazyce, upravíte názvy, ceny nebo cokoliv, co potřebujete, a data ve vašem e-shopu budou vždy aktuální. Další výhodou je, že pokud svůj e-shop provozujete na platformě jako Shoptet, Shopify nebo WooCommerce, *Mergado vám předpřipraví některá pravidla* – například pro výpočet prodejní ceny, skrytí vybraných kategorií nebo úpravu názvů produktů. 1. Poté, co vyberete/vytvoříte e-shop, pod kterým bude projekt zařazen, klikněte na *Napojit Malfini*. 2. Zvolte *zdrojový Malfini soubor*, tedy jazykovou verzi dat, které chcete importovat. 3. Klikněte na *Pokračovat*. 4. Zvolte výstupní formát dat (vaši e-shopovou platformu, případně jiný formát) a klikněte na *Pokračovat*. 5. Dále dokončíte vytváření projektu podle návodu v části *Jak vytvořit nový projekt* tohoto článku. ## FAQ: Jak v Mergadu vytvořit nový projekt? ### Co je „projekt“ v Mergadu? Projekt v Mergadu představuje konkrétní nastavení dat, které posíláte na určitou platformu. Například když chcete data ze svého e-shopu posílat na inzertní platformu (Heureka, Google, Facebook, Kaufland atd.) a mezi tím je v Mergadu upravit speciálně pro potřeby dané platformy. Projekt vytváříte i v případě, že data nechcete posílat na jinou platformu, ale chcete je v Mergadu upravovat. Například necháte posílat data ze svého e-shopu do Mergada, zde je upravíte podle svých potřeb a upravená data poputují zpátky do vašeho e-shopu. ### Co je „e-shop“ v Mergadu? E-shop v Mergadu zastřešuje jednotlivé projekty, které souvisí s jedním vaším internetovým obchodem. Představte si například e-shop v Mergadu jako váš vlastní e-shop (příklad: Můj-eshop.cz) a projekty pod ním jako jednotlivé platformy, na kterých produkty z tohoto e-shopu chcete inzerovat (např. Heureka, Allegro, ChatGPT, Facebook atd.) Pokud máte více e-shopů, vytvořte pro každý vlastní e-shop i v Mergadu. ### Můžu mít pod jedním e-shopem víc projektů? Ano, pod jedním e-shopem můžete mít tolik projektů, kolik potřebujete. Každý projekt je určen pro jinou platformu, například jeden pro Heureku, druhý pro Google Ads a třetí pro Facebook. Podle [Podmínek užívání](https://www.mergado.cz/podminky-uzivani) Mergada však není možné mít v rámci jednoho e-shopu více různých internetových obchodů. Pokud tedy máte dva internetové obchody a každý je na vlastní doméně, je potřeba v rámci Mergada vytvořit také dva e-shopy, pod kterými si vytvoříte příslušné projekty pro jednotlivé reklamní platformy. ### Kdy mám založit nový e-shop a kdy jen nový projekt? Nový e-shop zakládejte, pokud jde o zcela jiný internetový obchod (s jinou doménou). Nový projekt zakládejte tehdy, když chcete inzerovat produkty ze stejného internetového obchodu, pro který už máte v Mergadu založený e-shop, na další platformě. ### Co je to produktový feed? Produktový feed je strukturovaný datový soubor, který obsahuje všechny informace o vašich produktech, např. názvy, ceny, popisy, dostupnost a další údaje. ### Jaký je rozdíl mezi vstupním a výstupním feedem? Vstupní feed je ten, který do Mergada posíláte (zdrojová data z vašeho e-shopu). Výstupní feed je ten, který vytvoří Mergado. Obsahuje vaše zdrojová data a veškeré úpravy, které jsme v Mergadu provedli. ### V jakém formátu může být feed? Nejčastější formáty jsou XML, CSV, JSON nebo Google Sheet. Mergado všechny tyto formáty podporuje a v případě potřeby si také můžete v Mergadu definovat vlastní formát. ### Musí být vstupní a výstupní formát feedu stejný? Nemusí. Záleží, na jakou platformu feed posíláte. Pokud ale projekt využíváte jen pro interní úpravy (například v rámci vašeho e-shopu), můžete zvolit stejný formát na vstupu i výstupu. ### Co je URL feedu? Je to odkaz na místo, kde je uložen soubor s daty o vašich produktech (tzn. místo, kde je uložen váš produktový feed). URL feedu může vypadat například takto: https://muj-eshop.cz/feed.xml. Není to adresa vašeho e-shopu, ale konkrétní odkaz na soubor s produktovými daty. ### Kde získám URL svého feedu? Nejčastěji ji najdete v administraci své e-shopové platformy nebo vám ji poskytne správce e-shopu. V případě potřeby (např. pokud máte e-shop na platformách Prestashop, Woocommerce nebo Opencard) můžete využít náš bezplatný doplněk [Mergado Pack](https://pack.mergado.cz/), který vám pomůže vytvořit XML soubor s daty pro nahrání do Mergada. Pokud nemáte k dispozici URL vašeho feedu, protože je uložen na FTP serveru, pomůže vám naše rozšíření [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about). ### Co když mám feed uložený na FTP serveru a nemám tedy k dispozici jeho URL? Použijte rozšíření [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about), které nedostupná data z FTP převede na veřejnou URL, aby s nimi Mergado mohlo pracovat. ### Co je Mergado Pack? Je to bezplatný doplněk pro platformy jako Prestashop, WooCommerce nebo Opencart, který vám pomůže snadno vytvořit feed ve správném formátu pro Mergado. ### Co když mám svůj feed zabezpečený? Dostane se k němu Mergado? Pokud pro zabezpečení svého feedu používáte whitelist IP adres, přidejte do něj adresu Mergada (81.31.39.112), aby systém mohl váš feed stahovat. ### Jak v Mergadu vytvořím nový projekt? 1. Po přihlášení do vašeho Mergado účtu klikněte na tlačítko Nový projekt, čímž budete odkázání na stránku, kde si jej v několika krocích vytvoříte. → Pokud jste v Mergadu úplně poprvé, doporučujeme nejdříve si projít [Průvodce Mergado Editorem](https://app.mergado.com/guide), odkud se následně také dostanete k vytvoření projektu kliknutím na tlačítko Vytvořit projekt. 2. V prvním kroku klikněte na kolonku E-shop, kde vyberete e-shop, pod kterým chcete nový projekt vytvořit. a. Pokud jste v Mergadu poprvé (žádný e-shop ještě nemáte) nebo si přejete projekt vytvořit pod zcela novým e-shopem, klikněte na Vytvořit e-shop. Do kolonky napište název vašeho nového e-shopu a klikněte na Potvrdit. b. Pokud už v Mergadu máte e-shopy a projekt chcete vytvořit pod některým z nich, vyberte z nabídky požadovaný e-shop. 3. Klikněte na Pokračovat. 4. V dalším kroku vyberte zdroj svého vstupního feedu (místo, kde jsou uložena vaše produktová data). Můžete si vybrat ze tří možností napojení zdrojových dat. a. Produktový feed (URL) – pokud máte svůj produktový feed uložen na URL adrese, klikněte na *Použít URL feedu* b. Shopify – pokud provozujete svůj e-shop na platformě Shopify, klikněte na *Připojit přes Shopify* c. Dodavatelský feed Malfini – pokud chcete do svého projektu napojit Malfini dodavatelský feed, klikněte na *Napojit Malfini* d. UNAS – pokud provozujete svůj e-shop na platformě UNAS, klikněte na *Připojit přes UNAS* 5. Poté, co zvoleným způsobem napojíte data, klikněte na Pokračovat. 6. V dalším kroku vyberte formát vašeho výstupního feedu (neboli cílového příjemce vašich dat). Zjednodušeně řečeno, vyberte platformu, na které chcete začít inzerovat nebo pro kterou jsou vaše data určena (např. Heureka, Google, Facebook, dodavatelská aplikace, web, marketplace a jiné) a klikněte na tlačítko Pokračovat. → Mergado předvybere výstupní formát podle analýzy vašeho vstupního feedu (vybere nejpodobnější formát tomu vstupnímu). Vy si ale samozřejmě můžete zvolit takový formát, jaký chcete. → Pokud ani jeden z nabízených výstupních formátů neodpovídá formátu, který chcete mít na výstupu, klikněte na Definovat vlastní formát a nastavte si požadovaný výstupní formát. 7. V posledním kroku zkontrolujte (a případně kliknutím na ikonku tužky změňte), zda jsou veškerá nastavení zvolená tak, jak si přejete. → Jako název projektu bude automaticky doplněno to, co jste zvolili jako výstupní formát. Název můžete také změnit kliknutím na ikonku tužky. → Uvidíte také možnost změny Párovacích elementů. Tyto elementy obsahují unikátní informace a pomáhají rozlišit jednotlivé produkty ze vstupního feedu. Mergado vždy samo navrhne nejvhodnější elementy a jejich změna je pokročilou funkcí, kterou ve svém prvním projektu pravděpodobně nebudete potřebovat upravovat. 8. Klikněte na Dokončit. ### Jaký zdroj vstupních dat si mám vybrat? Můžete zvolit jednu z následujících možností: * Produktový feed (URL) – pokud máte k dispozici URL svého feedu. * Shopify – pokud svůj e-shop provozujete na platformě Shopify. * Dodavatelský feed Malfini – pokud je vaším dodavatelem Malfini a chcete jejich data importovat do svého e-shopu nebo využívané inzertní platformy. * UNAS – pokud svůj e-shop provozujete na platformě UNAS. ### Jak vyberu formát vstupního feedu? Mergado automaticky rozpozná formát vašeho vstupního feedu. V případě, že jej rozpozná špatně, můžete jej při tvorbě projektu ručně změnit kliknutím na Vybrat jiný formát (formát vyberete na základě toho, z jaké platformy vstupní feed pochází). Pokud váš formát není v nabídce, klikněte na Definovat vlastní formát a nastavte ho podle sebe. ### Jak vyberu formát výstupního feedu? Formát výstupního feedu zvolíte na základě cílového příjemce vašich dat, tedy pro jakou platformu jsou vaše data v konkrétním projektu určena (např. Heureka, Google, Zboží.cz, Kaufland Marketplaces). V případě, že chcete projekt využít pro interní úpravu dat (např. v rámci vlastního e-shopu), zvolíte na výstupu stejný formát, jako jste zadali na vstupu. ### Co jsou párovací elementy? Párovací elementy jsou obsaženy ve vašem feedu a nesou unikátní údaje, podle kterých Mergado rozpozná jednotlivé produkty (např. ID produktu). Obvykle je není potřeba měnit, Mergado je vybere automaticky. ### Jak poznám, že se projekt vytvořil správně? Po dokončení importu vstupního feedu uvidíte URL výstupního feedu. Tuto adresu vložíte do platformy, pro kterou jste projekt vytvářeli. ### Jak napojím feed pomocí URL? Ve druhém kroku tvorby projektu klikněte na Použít URL feedu, jednoduše zadejte adresu feedu do Mergada a pokračujte do posledního kroku tvorby projektu. Pokud již Mergado používáte a chcete jako vstupní feed pro projekt využít již existující feed z některého vašeho jiného projektu, vyberte v kolonce Existující URL požadovaný feed a pokračujte do posledního kroku tvorby projektu. ### Jak napojím svůj Shopify e-shop do Mergada? Ve druhém kroku tvorby projektu klikněte na Připojit přes Shopify a zadejte Shopify Store URL pro Admin API, Client ID a Client Secret a pokračujte do posledního kroku tvorby projektu. [Jak získat potřebné Shopify API Credentials (Client ID a Client Secret), najdete v tomto návodu.](https://forum.mergado.cz/t/novy-projekt-vygenerovani-shopify-api-credentials/jak-zajistit-napojeni-e-shopove-platformy-shopify-na-mergado-editor) ### Kde najdu Shopify Store URL pro napojení Shopify do Mergada? Najdete ho v Shopify v administraci vašeho e-shopu v sekci Nastavení pod názvem vašeho e-shopu. Bude ve tvaru *nazev.myshopify.com* (např. muj-eshop.myshopify.com). ### K čemu slouží napojení Malfini? Toto napojení je ideální pro e-shopaře, jejichž dodavatelem je Malfini, a chtějí jejich produkty do svého e-shopu dostat jednoduše a na pár kliknutí. Malfini produkty si můžete do Mergada importovat ve zvoleném jazyce, snadno upravit názvy, ceny nebo cokoliv, co potřebujete, a data, která budou z Malfini přes Mergado proudit do vašeho e-shopu budou vždy aktuální. Další výhodou je, že pokud svůj e-shop provozujete na platformě jako Shoptet, Shopify nebo WooCommerce, Mergado vám předpřipraví některá pravidla – například pro výpočet prodejní ceny, skrytí vybraných kategorií nebo úpravu názvů produktů. ### Jak nastavím napojení na Malfini? Ve druhém kroku tvorby projektu klikněte na Napojit Malfini, zvolte jazykovou verzi feedu, klikněte na Pokračovat, vyberte výstupní formát (např. vaši e-shopovou platformu) a pokračujte do posledního kroku tvorby projektu. ### Co když po vytvoření nového projektu překročím svůj stávající předplacený tarif? Pokud máte v rámci e-shopu více aktivních projektů a s nově vytvořeným projektem překročíte limit aktuálně předplaceného tarifu, Mergado vás na zvýšení tarifu upozorní e-mailem. ### Co dělat, když mi Mergado hlásí chybu při importu feedu? Zkontrolujte, zda je URL vašeho feedu veřejně přístupná. Pokud máte například svůj feed chráněný tzv. whitelistem IP adres, je potřeba do něj přidat IP adresu Mergada (81.31.39.112). Pokud problém přetrvává, kontaktujte naši technickou podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). ### Co dělat, když jsem si při tvorbě projektu neuložil/a URL výstupního feedu? Nemusíte se bát, URL výstupního feedu se nikam neztratí. Najdete ji přímo ve svém Mergado účtu: 1. Přihlaste se do Mergada a přejděte na stránku *[Detaily uživatele](https://app.mergado.com/user/details/)*. 2. V seznamu svých e-shopů vyberte ten, pod kterým jste projekt vytvořili. 3. Zobrazí se seznam všech projektů vytvořených pod vybraným e-shopem. Klikněte na projekt, který vás zajímá. 4. V detailu projektu uvidíte URL výstupního feedu, kterou můžete kdykoliv zkopírovat a vložit do cílové platformy. --- ## [Pravidlo: Přepsat](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-prepsat/) # Pravidlo: Přepsat ## **Pravidlo: Přepsat** Pravidlo se používá k úpravě hodnot jakéhokoliv elementu, například: názvů produktů, kategorií, popisků a mnohých dalších. Pomocí pravidla Přepsat se dají hodnoty úplně přepsat, obohacovat nebo redukovat o části. **Zdroje** * [Přepisovací pravidlo na Mergado Fórum](https://forum.mergado.cz/t/prepsat-prepisovaci-pravidlo/1992) * [Video návod na YouTube](https://www.youtube.com/watch?v=KHKrclAdcDI&_gl=1*1hh772a*_gcl_au*MTc1NTc2NjU5My4xNzQ4NDE5MTYwLjExODA1ODM5NzQuMTc1MjEzMjc2MC4xNzUyMTMyNzYw) **Extra funkce** * Režim chytrého vkládání \- hromadné kopírování a vložení hodnot například: z Google Sheets * Do pole *Nová hodnota* lze zadat: * text * proměnnou, například: `%g:brand%` * kombinace text \+ proměnná, například: `%g:price%` CZK * prázdnou hodnotu * Možnost přidat více řádků * Na pořadí řádků záleží \- aplikuje se shora dolu **Jak využít** Příklad 1: Rozšíření produktových názvů o další informace (značka, parametry) * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Přepsat**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu. * **Zadejte novou hodnotu:** * Do pole “Nová hodnota” zadejte kombinaci proměnných oddělené mezerou. Například `%brand% %title% %size% %material% %color%` * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například: “*Rozšíření produktových názvů”.* Příklad 2: Naplnění prázdného povinného elementu hodnotou: **A:** vložit text (například: konkrétního výrobce), **B:** vložit proměnnou (například: výrobce), **C:** kombinace textu a proměnné (prodejní cenu s měnou) * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Přepsat**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu. * **Zadejte novou hodnotu:** * Do pole “Nová hodnota” zadejte * textovou hodnotu, například: konkrétního výrobce (Nike) * proměnnou, například: `%manufacturer%` * kombinaci proměnné a textu, například: `%g:price%` CZK * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například: “*Naplnění prázdných elementů”.* Příklad 3: Odstranění hodnoty z elementu (smazání hodnoty elementu) * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Přepsat**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu. * **Zadejte novou hodnotu:** * Pole “Nová hodnota” nechte prázdné. Tím se jakékoli hodnoty zvoleného elementu smažou. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Smazat element*”. **FAQ:** **1\. K čemu přesně slouží pravidlo Přepsat?** Pravidlo slouží k **úplné úpravě obsahu libovolného elementu** ve feedu. Umožňuje hodnotu buď **zcela přepsat**, nebo ji **obohatit o nové informace** (např. přidat značku, parametry, text), případně **vymazat**. **2\. Mohu s pravidlem Přepsat doplnit informace do názvu produktu, například značku a barvu?** Ano. Do pole **„Nová hodnota“** zadejte kombinaci proměnných, např.: `%brand% %title% %color%`. Mergado automaticky vloží odpovídající hodnoty z elementů každého produktu. **3\. Co se stane, pokud některá z použitých proměnných nemá vyplněnou hodnotu?** Pokud je element prázdný, Mergado ho při přepisu **přeskočí**. **Poznámka**: Pokud se prázdná proměnná nachází uprostřed řetězce, mohou mezi sousedními proměnnými zůstat dvě mezery. Tento problém lze snadno opravit pomocí pravidla Najít a nahradit – do pole „Najít“ zadejte dvě mezery ( \_ \_ ) a v poli „Nahradit“ ponechte jednu mezeru ( \_ ). **4\. Jaký je rozdíl mezi textem a proměnnou v poli „Nová hodnota“?** * **Text** je pevně daný obsah, který se zapíše přesně tak, jak ho napíšete (např. „Nike“ nebo „Akční nabídka“). * **Proměnná** je odkaz na hodnotu jiného elementu, např. `%manufacturer%` nebo `%g:price%`. **5\. Jak nastavím pravidlo, pokud chci hodnotu elementu úplně smazat?** Vytvořte nové pravidlo typu **Přepsat**, vyberte příslušný element a **ponechte pole „Nová hodnota“ prázdné**. Tím se hodnota z tohoto elementu odstraní ze všech produktů, na které se pravidlo vztahuje. **6\. Mohu přepsat hodnotu pouze u vybraných produktů?** Ano. V poli **„Výběr“** zvolte, zda se pravidlo použije pro **všechny produkty**, nebo jen pro **vybraný Produktový výběr**. Výběr může být například podle značky, kategorie nebo ceny. **7\. Co znamená režim chytrého vkládání?** Režim **chytrého vkládání** umožňuje **hromadně zkopírovat a vložit** více hodnot (např. sloupce z Google Sheets nebo z Excelu) přímo do tabulky pravidla. Mergado automaticky správně rozdělí vložené hodnoty podle řádků a sloupců. **8\. Jak funguje pořadí řádků v pravidle Přepsat?** Pořadí je důležité – Mergado zpracovává řádky **shora dolů**. Pokud dva řádky mění stejný element, použije se **výsledek z posledního (nejnižšího) řádku**. **9\. Jak zkontroluji, jestli se pravidlo aplikovalo správně?** Po uložení a aplikování pravidel nebo přegenerování feedu otevřete náhled produktů a zkontrolujte, zda se hodnoty změnily podle očekávání. Pro detailní kontrolu konkrétního produktu můžete aktivovat funkci „Průchod pravidly“, která zobrazí, jak jednotlivá pravidla postupně mění data daného produktu. **10\. Lze kombinovat pravidlo Přepsat s jinými pravidly, jako například Najít a nahradit?** Ano. Je potřeba ale počítat s tím, že pravidla se aplikují shora dolů a na jejich pořadí záleží. Mějte na paměti, že pravidlo Přepsat může hodnotu elementu zcela nebo částečně přepsat, proto je důležité promyslet jeho umístění mezi ostatními pravidly. **11\. Je možné použít stejné pravidlo i pro kategorie nebo popisky produktů?** Ano. Pravidlo **Přepsat** lze použít pro **jakýkoliv element** – např. `g:description`, `g:product_type`, `g:brand` apod. Princip zůstává stejný: vyberete element, zadáte novou hodnotu a Mergado ji zapíše. **12\. Můžu pravidlem Přepsat doplnit chybějící výrobce (manufacturer)?** Ano. Do pole **„Nová hodnota“** napište buď pevný text (např. „Nike“), nebo proměnnou `%manufacturer%`, pokud už máte tuto informaci v jiném elementu. Pravidlo pak doplní hodnotu všem produktům bez vyplněného výrobce. **13\. Co když chci přepsat hodnoty jen v prázdných elementech, ale nechci změnit ty, které už obsahují data?** V tom případě vytvořte výběr produktů, kde je daný element prázdný, a aplikujte na něj pravidlo **Přepsat**. **14\. Jak se chová pravidlo Přepsat, pokud vkládám text s diakritikou nebo speciálními znaky?** Mergado diakritiku i speciální znaky zachovává, není nutné ji odstraňovat. Pokud by systém hlásil problém s formátem, lze použít pravidlo **Odstranit diakritiku** před samotným přepisem. **15\. Je možné v rámci jednoho pravidla přepisovat více elementů současně?** Ano. Každý element uveďte na **samostatném řádku** pravidla. Například: první řádek pro `g:title`, druhý pro `g:description`, třetí pro `g:brand`. **16\. Mohu tímto pravidlem nastavit hodnotu z jiného projektu nebo feedu?** Ne přímo. Pravidlo Přepsat pracuje pouze s daty **v rámci jednoho projektu**. Pro import hodnot z externího zdroje použijte pravidlo **Import datového souboru (CSV / XML)**. **17\. Mohu pravidlo Přepsat naplánovat, aby se spouštělo jen v určitých dnech nebo časech?** Ano. V nastavení pravidla použijte funkci **„Časovač“**. Můžete zvolit **konkrétní dny v týdnu**, **časové sloty** (např. 08:00–12:00), nebo nastavit **jednorázovou platnost od–do**. 💡 **Příklad:** Pravidlo Přepsat můžete aktivovat jen během víkendové kampaně – např. od pátku 18:00 do neděle 23:59. **18\. Mohu k pravidlu Přepsat přidat vlastní poznámku?** Ano. Do pole **„Poznámka“** můžete doplnit libovolný text až do délky 2000 znaků. Doporučuje se použít pro **interní komentáře** – např. proč bylo pravidlo vytvořeno nebo co přesně upravuje. Poznámka se nezobrazuje ve feedu, slouží jen pro přehlednost v projektu. --- ## [JSON v Mergadu](https://help.mergado.com/cs/mergado-editor/formaty-feedu-a-pokrocile-datove-situace/technicke-detaily-formatu/json-v-mergadu/) # JSON v Mergadu # Soubor JSON - jak má takový formát vypadat? Vysvětlit, zda a jak lze v Mergado Editoru použít feed ve formátu JSON, jak má vypadat jeho základní struktura a na co si dát pozor při nahrávání. ## Kontext V Mergadu se nejčastěji pracuje se soubory **XML** a **CSV**. Editor ale přijímá také **JSON**, **TSV** a **TXT**. Může se stát, že dodavatel poskytne právě JSON feed a vy jej potřebujete nahrát do Mergada. Pokud se při zakládání projektu JSON nenačte nebo vrátí chybovou hlášku, bývá častou příčinou **nesprávný formát či obsah** feedu. > Co je JSON? > Lehký textový formát pro výměnu dat. Je srozumitelný pro člověka a zároveň snadno zpracovatelný programy – „univerzální jazyk pro předávání strukturovaných dat“ mezi systémy. ## Jak má JSON feed vypadat Aby bylo možné **nahrát URL feedu ve formátu JSON** do Mergada, je potřeba, aby šlo **o list (pole) objektů**, např.: Jasně — tady je hezky zarovnané (a validní) JSON pole se dvěma položkami, připravené k vložení do Markdownu: ```json [ { "ITEM_ID": "342", "AVAILABILITY": "preorder", "URL": "https://wp533.mergadoshop.com/produkt/woocommerce-simple-product-test/", "NAME_EXACT": "WooCommerce Simple product TEST", "CURRENCY": "EUR", "VAT": "21", "PRICE": "0.068302", "PRICE_VAT": "0.08", "IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2020/06/tricko-nastvany-bily-tygr-white-edition.jpg", "PARAM": [ { "NAME": "Size", "VALUE": "SM | S | M | L" }, { "NAME": "EAN", "VALUE": "ean222" }, { "NAME": "Příušniče", "VALUE": "Druhá vlastnost, žeřemě" } ], "STOCK_QUANTITY": "0", "DESCRIPTION_SHORT": "[WCMC]", "CATEGORY": "Polštáře", "CATEGORY_ALTERNATIVE": [ "Nezařazené", "Čaje, káva" ], "PRODUCTNO": "SKU01-6", "VISIBILITY": "public", "CATALOG_VISIBILITY": "visible" }, { "ITEM_ID": "11089", "AVAILABILITY": "in stock", "URL": "https://wp533.mergadoshop.com/produkt/voyage-451-mikina-damska/?attribute_pa_barva=cerna&attribute_pa_varianta=xs", "NAME_EXACT": "Voyage 451 Mikina dámská - černá, XS", "CURRENCY": "EUR", "VAT": "21", "PRICE": "650", "PRICE_VAT": "786.5", "IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg", "PARAM": [ { "NAME": "Barva", "VALUE": "černá" }, { "NAME": "Varianta", "VALUE": "XS" } ], "STOCK_QUANTITY": "156", "DESCRIPTION": "lehce vypasovaný střih s bočními švy\ncelopropínací kovový zip\ntáhlo zipu s gravírovaným logem\nkapuce s podšívkou, na stažení šňůrkou\nvnitřní průkrčník začištěn páskou\nraglánové rukávy s ozdobným prošitím\nnakládané kapsy ve stylu klokanky\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\nkontrastní prvky\nvnitřní strana nepočesaná lehce vypasovaný střih s bočními švy\\ncelopropínací kovový zip\\ntáhlo zipu s gravírovaným logem\\nkapuce s podšívkou, na stažení šňůrkou\\nvnitřní průkrčník začištěn páskou\\nraglánové rukávy s ozdobným prošitím\\nnakládané kapsy ve stylu klokanky\\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\\nkontrastní prvky\\nvnitřní strana nepočesaná", "DESCRIPTION_SHORT": "Výplňková pletenina, vnitřní strana nepočesaná\n100 % bavlna (barva 12 - složení se může lišit - 85 % bavlna, 15 % viskóza)", "CATEGORY": "Nezařazené", "VISIBILITY": "public", "CATALOG_VISIBILITY": "visible", "IMAGE_ALTERNATIVE": [ "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_bw600.jpg" ], "SHIPPING_WEIGHT": "500 g", "ITEMGROUP_ID": "11088", "VARIANT_DESCRIPTION": "lehce vypasovaný střih s bočními švy\\ncelopropínací kovový zip\\ntáhlo zipu s gravírovaným logem\\nkapuce s podšívkou, na stažení šňůrkou\\nvnitřní průkrčník začištěn páskou\\nraglánové rukávy s ozdobným prošitím\\nnakládané kapsy ve stylu klokanky\\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\\nkontrastní prvky\\nvnitřní strana nepočesaná" } ] ``` ## Příklady z praxe * Máte JSON od dodavatele a Mergado jej při vytváření projektu nenačte → zkontrolujte, zda jde o **list objektů** ve tvaru výše. * Na výstupu z projektu potřebujete **XML**, ale váš JSON obsahuje názvy elementů, které nejsou validní pro XML (např. začínají číslem nebo obsahují mezery) → tyto elementy je potřeba v projektu **skrýt**, pokud je cílem výstup do XML. ## Tipy * **Nativní JSON formáty**, které Mergado umí (aktuálně **jen Shopify**), **nemusí** výše uvedený formát splňovat. * Potřebujete dostat jiný JSON (nebo obecně soubor) do požadované podoby listu objektů? Často to jde přes rozšíření **Blending Bull**. * **JSON může stejně jako CSV obsahovat nevalidní XML elementy** – pokud míříte na XML výstup, **skryjte je** v projektu. --- ## FAQ **Lze v Mergadu použít JSON feed?** Ano. Kromě XML a CSV podporuje Editor také JSON, TSV a TXT. **Co je nejčastější příčinou, když se JSON feed nenačte?** Neodpovídající formát nebo obsah feedu. **Jak musí být JSON strukturovaný, aby šel nahrát?** Jako **list (pole) objektů**: `[ { …produkt_1… }, { …produkt_2… } ]`. **Platí uvedený formát i pro všechny „nativní“ JSONy?** Ne. **Nativní JSON formáty** v Mergadu (aktuálně **jen Shopify**) ho **nemusí** splňovat. **Mám jiný JSON – jak jej převedu do požadované podoby?** Často to lze pomocí rozšíření **Blending Bull**. **Co když JSON obsahuje názvy nevhodné pro XML?** Pokud máte na výstupu **XML**, **skryjte** v projektu elementy, které jsou pro XML nevalidní (např. začínají číslem nebo obsahují mezery). --- ## [Jak v Mergadu duplikovat projekt?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/sprava-projektu-v-mergadu/jak-v-mergadu-duplikovat-projekt/) # Jak v Mergadu duplikovat projekt? Potřebujete vytvořit nový projekt, který bude v podstatě stejný jako projekt, který už máte, a nechce se vám znovu vytvářet všechna pravidla? Zakládáte v Mergadu nový e-shop, který je jazykovou mutací jiného vašeho e-shopu na odlišné doméně, a chcete v něm vytvořit projekty, které budou téměř identické, jako ty v už vytvořeném e-shopu? Potřebujete si v projektu vyzkoušet pár nových pravidel a úprav, ale nechcete riskovat, že si rozhodíte projekt, který jede naostro? Nebo si chcete nějaký projekt jen pro jistou zálohovat? Všechny tyto situace jednoduše vyřešíte s pomocí funkce *Duplikace projektu*, díky které jedním kliknutím vytvoříte kopii vybraného projektu. Navíc si při duplikaci můžete zvolit, zda chcete kopii vytvořit pod stejným e-shopem nebo jiným e-shopem, jehož jste Vlastníkem nebo k němu máte oprávnění Zápis. Při duplikaci se zkopírují také všechna pravidla, takže ušetříte spoustu času, který byste strávili nad jejich vytvářením. V novém projektu pak stačí třeba jenom vyměnit vstupní feed, udělat pár úprav a máte hotovo. ## Jaké informace se přenesou do duplikovaného projektu Při duplikování se vytvoří nový samostatný projekt se zvoleným názvem a vytvoří se pod vybraným e-shopem. Z původního projektu se přenesou téměř všechny informace: * URL i formát vstupního feedu * formát výstupního feedu * veškeré vytvořené výběry produktů * veškerá vytvořená pravidla (a také některá pravidla vytvořená rozšířeními, která byla na původním projektu spuštěná) * veškeré vytvořené elementy a proměnné (elementy vytvořené rozšířeními se ale naplní hodnotami až ve chvíli, kdy i na novém projektu spustíte příslušné rozšíření) Co se do duplikovaného projektu nepřenese: * automaticky se nespustí rozšíření, která byla na původním projektu zapnutá (a nepřenesou se také některá pravidla vytvořená rozšířeními) * manuální změny u produktů * historie úprav a změn z původního projektu * bude vytvořena nová výstupní URL ℹ️ *Pokud potřebujete u duplikovaného projektu změnit formát vstupního nebo výstupní feedu, kontaktujte naši technickou podporu na e-mailové adrese [mergado@mergado.cz](mailto:mergado@mergado.cz).* ## Jak duplikovat projekt 1. Na stránce *Detaily uživatele* ve svém účtu klikněte na e-shop, kde se nachází projekt, který chcete duplikovat. 2. U projektu, který chcete duplikovat, klikněte na ikonku ozubeného kolečka, čímž přejdete na stránku *Obecná nastavení projektu*. 3. V části *Duplikovat* vyplňte název nového projektu a cílový e-shop, pod kterým se má nový projekt vytvořit. 4. Klikněte na *Duplikovat*. 5. Jakmile se projekt zduplikuje, přijde vám upozornění do e-mailu. ## FAQ: Jak v Mergadu duplikovat projekt? ### K čemu slouží funkce Duplikace projektu? Duplikace projektu umožňuje rychle vytvořit kopii existujícího projektu v rámci stejného nebo jiného e-shopu (ke kterému máte oprávnění Vlastník nebo Zápis). Hodí se například pro testování nových pravidel, zálohování nebo opakované použití stávajících nastavení bez nutnosti vše znovu vytvářet. ### Jaké informace se přenesou do duplikovaného projektu? Při duplikaci se zkopírují téměř všechny informace: URL a formát vstupního feedu, formát výstupního feedu, výběry produktů, všechna pravidla (včetně některých vytvořených rozšířeními) a všechny elementy a proměnné. ### Je něco, co se do duplikovaného projektu nepřenese? Neaktivují se rozšíření, která byla na původním projektu zapnutá. Nepřenesou se některá pravidla vytvořená rozšířeními, manuální změny u produktů ani historie úprav a změn původního projektu. Také bude vytvořena nová URL výstupního feedu. ### Jak vytvořím kopii projektu? Na stránce *Detaily uživatele* klikněte na e-shop, kde se projekt nachází, a u vybraného projektu klikněte na ikonku ozubeného kolečka. To vás odkáže na stránku *Obecná nastavení projektu*, kde v části *Duplikovat* vyplňte název nového projektu a vyberte cílový e-shop, po kterým se má nový projekt vytvořit. Poté klikněte na *Duplikovat*. Po dokončení duplikace vám přijde potvrzení do e-mailu. ### Co dělat, pokud potřebuji změnit formát vstupního nebo výstupního feedu u duplikovaného projektu? Pokud chcete upravit vstupní nebo výstupní formát, kontaktujte naši technickou podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz), která vám s tím pomůže. ### Můžu pomocí duplikace vytvořit projekt i pod e-shopem, jehož nejsem Vlastníkem? Ano, pokud máte k cílovému e-shopu oprávnění Zápis. Pokud k němu máte oprávnění Čtení nebo žádné oprávnění, projekt pod daný e-shop duplikovat nemůžete. ### Jak vytvořím nový projekt, který bude téměř stejný jako můj jiný projekt, bez nutnosti znovu vytvářet všechna pravidla? Pomocí funkce Duplikace projektu můžete rychle vytvořit kopii existujícího projektu, včetně všech pravidel a nastavení. Stačí vybrat původní projekt, zvolit cílový e-shop a kliknout na Duplikovat. Následně můžete například vyměnit vstupní feed nebo provést jiné úpravy. Pokud budete chtít u duplikovaného projektu změnit formát vstupního nebo výstupního feedu, je potřeba kontaktovat naši podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). ### Jak si můžu vyzkoušet nová pravidla nebo úpravy bez rizika ovlivnění stávajícího projektu? Nejjednodušší cestou je vytvoření kopie stávajícího projektu pomocí duplikace. Na vytvořené kopii si můžete testovat nová pravidla a úpravy. Původní projekt zůstane nedotčený a funkční. ### Jak si mohu aktuální projekt zálohovat? Pomocí duplikace můžete vytvořit záložní kopii projektu, která bude obsahovat všechna pravidla a nastavení. V případě potřeby můžete novou kopii kdykoliv použít nebo upravit. --- ## [Pravidlo: Najít a nahradit](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-najit-a-nahradit/) # Pravidlo: Najít a nahradit ## **Pravidlo: Najít a nahradit** Toto pravidlo vyhledá text v obsahu elementu a nahradí ho jiným. **Zdroje** * [Najít a nahradit na Mergado Fórum](https://forum.mergado.cz/t/najit-a-nahradit/1991) **Extra funkce** * Rozlišování velkých a malých písmen * Podpora regulárních výrazů * V polích lze využít text, proměnné i prázdnou hodnotu * Možnost přidat více řádků * Na pořadí řádků záleží \- aplikuje se shora dolu **Konkrétní příklady** Příklad 1: **Odstranit informace z elementu** promo texty nebo rozměry z názvů produktů, odkazy z popisu produktů, nežádoucí texty nebo HTML znaky z popisu * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Najít a nahradit**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, u kterého chcete provést změnu. * V tomto případě můžeme zvolit element: `popis produktu` nebo `název produktu` * **Nastavení dalších možností** * Pokud potřebujete rozlišovat velká a malá písmena, **zaškrtněte možnost** „Rozlišovat velikost písmen“. * Pokud chcete pro hledání použít **regulární výrazy**, **zaškrtněte možnost** „Regulární výrazy“. * **Zadejte vyhledávaný text** * Do pole **„Najít“** zadejte hledaný text, regulární výraz nebo použijte hodnotu jiného elementu pomocí proměnné (např. `%size%`). * V našem příkladu to mohou být například: * `akce` * `XXL` * `www.muj_eshop.cz/doplnky` * `` * 💡 **Tip:** Pravidlo umožňuje, přidat víc řádků (a tím pádem více podmínek najít a nahradit). Na pořadí řádků záleží, protože Mergado při aplikování vyhodnocuje řádky od vrchu dolu postupně. * **Zadejte text, kterým se nahradí** * Pole **„Nahradit“** ponechte prázdné. * 👉 Tím Mergado odstraní všechny nalezené výskyty textu — nahradí je prázdnou hodnotou. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například *„Odstranit promo texty z názvů“* nebo *„Vyčištění popisu produktů“*. Příklad 2: **Úprava textů v elementech – nahrazení, doplnění nebo změna formátu** * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Najít a nahradit**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * 💡 **Tip:** Toto pravidlo je specifický v tom, že i při použití výběru Všechny produkty nehází chybu v případě že v konkrétním produktu nenašel hledaný výraz * **Volba elementu pro změnu**: * V poli **Element** vyberte element, u kterého chcete provést změnu. * **Nastavení dalších možností** * Pokud potřebujete rozlišovat velká a malá písmena, zaškrtněte možnost „Rozlišovat velikost písmen“. * Pokud chceš použít regulární výrazy pro hledání nebo nahrazování, zaškrtněte možnost „Regulární výrazy“. * **Zadejte vyhledávaný text** * Do pole „Najít“ zadejte text, který chceš nahradit, regulární výraz, nebo použij hodnotu jiného elementu pomocí proměnné (např. %size%). * V našem příkladu Můžete použít například: * `gauč` * `CZK` * `Letní kampaň` * `/` * **Zadejte text, kterým se nahradí** * Do pole **„Nahradit“** zadejte nový text, regulární výraz, nebo použij hodnotu jiného elementu pomocí proměnné (např. `%size%`). * V našem příkladu to může být například: * `pohovka` * `EUR` * `Back to school` * `>` 💡 **Tip:** Můžete kombinovat více pravidel „Najít a nahradit“ pro různé účely — např. jedno pro měnu, druhé pro názvy kampaní. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla** dle svého výběru, například *„Úprava názvů produktů“* nebo *„Změna formátu měny“*. **Příklad 3:** Prohodit informace v rámci jednoho elementu přehodit první odstavec za druhý v popisu produktu * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Najít a nahradit**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, u kterého chcete provést změnu. * **Nastavení dalších možností** * Pokud potřebujete rozlišovat velká a malá písmena, zaškrtněte možnost „Rozlišovat velikost písmen“. * Zaškrtněte možnost „Regulární výrazy“, abys to ve vyhledávání mohl použít. * **Zadejte vyhledávaný text** * Do pole “**Najít”** zadejte následující regulární výraz: `^(.*?)\n\n(.*)$` * Tento regulární výraz rozdělí text na první a druhý odstavec, mezi kterýma je jeden prázdný řádek `(\n\n)` * **Zadejte text, kterým se nahradí** * Do pole **„Nahradit“** zadejte následující hodnotu: * `\2` `\1` * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla** dle svého výběru, například *„Prohození informací v rámci jednoho elementu“*. **FAQ**: **1\. K čemu slouží pravidlo Najít a nahradit?** Toto pravidlo umožňuje **vyhledat konkrétní text v obsahu elementu a nahradit ho jiným textem**, proměnnou nebo prázdnou hodnotou. Můžete ho použít pro **úpravy, doplnění nebo odstranění textu** v názvech, popiscích, kategoriích i jiných elementech. **2\. Můžu tímto pravidlem odstranit text, odkazy nebo HTML značky z popisu produktu?** Ano. Do pole **„Najít“** vložte text nebo HTML prvek, který chcete odstranit (např. `` nebo `www.muj_eshop.cz`). Pole **„Nahradit“** nechte prázdné. Mergado pak všechny nalezené výskyty těchto textů **odstraní** z elementu. **3\. Co znamená „Rozlišovat velikost písmen“?** Pokud zaškrtnete tuto možnost, Mergado rozlišuje mezi malými a velkými písmeny. Například hledání výrazu `AKCE` nenajde `akce`. Pokud není zaškrtnuto, hledání probíhá bez ohledu na velikost písmen. **4\. K čemu slouží možnost „Regulární výrazy“?** Po zapnutí této volby můžete použít **regulární výrazy (regex)** – tedy vzory pro pokročilé hledání a úpravy textu. Například pro přehazování odstavců, nahrazení čísel, odstranění více mezer, nebo úpravu formátu dat. 💡 **Příklad:** výraz `^(.*?)\n\n(.*)$` rozdělí text na první a druhý odstavec. **5\. Co když chci nahradit více různých textů najednou?** V pravidle můžete přidat **více řádků** – každý s jinou kombinací „Najít“ a „Nahradit“. Mergado je zpracovává **shora dolů**, takže pokud se některé výrazy překrývají, rozhoduje jejich pořadí. 💡 **Tip:** První řádky volte pro jednodušší výrazy, složitější (např. regulární) až nakonec. **6\. Jak mohu nahradit určité slovo jiným?** Do pole **„Najít“** napište původní text (např. `gauč`) a do pole **„Nahradit“** nový text (např. `pohovka`). Pravidlo pak nahradí všechna nalezená slova ve vybraném elementu. **7\. Mohu použít proměnnou i v pravidle Najít a nahradit?** Ano. Do polí **„Najít“** nebo **„Nahradit“** lze vložit **proměnné** – například `%size%` nebo `%brand%`. Mergado pak dosadí hodnotu odpovídajícího elementu u každého produktu. **8\. Co se stane, když výraz, který hledám, v některých produktech neexistuje?** Nic se nestane – pravidlo se bez chyby přeskočí. Produkt zůstane beze změny. To je užitečné např. tehdy, když používáte pravidlo s výběrem **„Všechny produkty“**, ale hledaný výraz se vyskytuje jen u části z nich. **9\. Jak mohu odstranit vícenásobné mezery, které vznikly po úpravě textu?** Použijte pravidlo **Najít a nahradit** s regulárním výrazem: * **Najít:** `\s{2,}` (dvě nebo více mezer) * **Nahradit:** (jedna mezera) Tím sjednotíte nadbytečné mezery po odstranění textů nebo prázdných proměnných. **10\. Mohu tímto pravidlem přehodit pořadí odstavců v textu?** Ano. Použijte regulární výraz: * **Najít:** `^(.*?)\n\n(.*)$` * **Nahradit:** `\2` `\1` Tím dojde k prohození prvního a druhého odstavce. 💡 **Tip:** Pravidlo funguje nejlépe, pokud mezi odstavci je prázdný řádek (dvojité `\n\n`). **11\. Jaký je rozdíl mezi použitím textu a regulárního výrazu?** Textové hledání pracuje s přesnými shodami (např. hledá přesné slovo nebo frázi). Regulární výrazy umožňují **hledat vzory** – např. všechna čísla, e-mailové adresy, tagy nebo cokoliv mezi dvěma znaky. Pro složitější úpravy je regex vhodnější. **12\. Co znamená, že se pravidlo aplikuje shora dolů?** Mergado zpracovává všechny řádky pravidla v pořadí, v jakém jsou uvedeny – **odshora dolů**. Pokud první řádek upraví text, druhý řádek už pracuje s upravenou verzí. To umožňuje řetězit více úprav, ale vyžaduje pečlivé plánování pořadí. **13\. Jak mohu nahradit například měnu „CZK“ za „Kč“ nebo odstranit lomítka ze stringu?** Do pole **„Najít“** napište `CZK` (nebo `/`) a do pole **„Nahradit“** napište `Kč` (nebo ponechte prázdné, pokud chcete znak odstranit). 💡 Můžete také vytvořit více řádků – jeden pro měnu, druhý pro jiné úpravy (např. kampaně nebo formát textu). **14\. Lze kombinovat pravidlo Najít a nahradit s jinými pravidly, jako Přepsat nebo Odstranit diakritiku?** Ano. Je potřeba ale počítat s tím, že pravidla se aplikují shora dolů a na jejich pořadí záleží. Mějte na paměti, že pravidlo Najít a nahradit může hodnotu elementu zcela nebo částečně přepsat, proto je důležité promyslet jeho umístění mezi ostatními pravidly. **15\. Jak zkontroluji, jestli se úpravy aplikovaly správně?** Po uložení a aplikování pravidel, nebo **přegenerování feedu** zkontrolujte výsledek přímo ve výstupním feedu nebo v **náhledu produktů** na stránce Produkty. Pro detailní kontrolu konkrétního produktu můžete využít funkci **„Průchod pravidly“**, která ukáže, jak se hodnoty mění po aplikaci jednotlivých pravidel. **16\. Mohu odstranit pouze část textu v rámci jednoho elementu?** Ano. Do pole **„Najít“** vložte konkrétní slovo nebo frázi, kterou chcete odstranit, a pole **„Nahradit“** ponechte prázdné. Mergado odstraní pouze tento text a ostatní část elementu zůstane beze změny. **17\. Co dělat, pokud potřebuji v popiscích odstranit HTML tagy (např. ``, ``, ``) ve větším množství?** Použijte regulární výraz, který zachytí všechny HTML tagy: * **Najít:** `]*>` *(příklad regexu, v individuálních případech může být potřeba regex upravit)* * **Nahradit:** *(ponechte prázdné)* Tím se odstraní všechny HTML značky a zůstane jen čistý text. **18\. Lze použít pravidlo i na čísla, ceny nebo parametry?** Ano. Pravidlo lze použít na libovolný element, který obsahuje text – včetně **číselných hodnot**, **cen**, nebo **PARAM | PARAM\_VALUE**. Například můžete změnit oddělovač desetinných míst, odstranit jednotky nebo přidat doplňující text. **19\. Co dělat, pokud se regulární výraz chová jinak, než očekávám?** Zkontrolujte, zda máte zapnutou volbu **„Regulární výrazy“**. Pokud ano, ověřte si správnost syntaxe – například pomocí online nástroje jako [regex101.com](https://regex101.com). 💡 **Tip:** U složitějších výrazů testujte nejprve na menším vzorku produktů, než pravidlo aplikujete plošně. Můžete se také obrátit na náš support. **20\. Dá se pravidlo použít i pro nahrazení víceřádkového textu?** Ano. Regulární výrazy dokážou pracovat i s odstavci nebo přechody řádků (`\n`, `\r\n`). --- ## [Jak v Mergadu přesunout projekt pod jiný e-shop?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/sprava-projektu-v-mergadu/jak-v-mergadu-presunout-projekt-pod-jiny-e-shop/) # Jak v Mergadu přesunout projekt pod jiný e-shop? Spravujete v Mergadu vícero e-shopů a omylem jste vytvořili projekt pod jiným e-shopem, než do kterého spadá? Žádný problém! Pokud máte k původnímu i cílovému e-shopu oprávnění Vlastník nebo Zápis, projekt si zvládnete jednoduše sami přesunout pod správný e-shop. ℹ️ *Při přesouvání projektů nezapomeňte, že dle [Podmínek užívání](https://www.mergado.cz/podminky-uzivani) není možné mít v rámci jednoho e-shopu více různých internetových obchodů. Pokud tedy máte dva internetové obchody a každý je na vlastní doméně, je potřeba v rámci Mergada vytvořit také dva e-shopy, pod kterými si vytvoříte příslušné projekty pro jednotlivé reklamní platformy.* ## Jak přesunout projekt pod jiný e-shop 1. Na stránce *[Detaily uživatele](https://app.mergado.com/user/details/)* ve svém uživatelském účtu klikněte na e-shop, ve kterém se nachází projekt, který si přejete přesunout. 2. U projektu, který chcete přesunout, klikněte vpravo na ikonku ozubeného kolečka, což vás odkáže na stránku *Obecná nastavení projektu*. 3. Na stránce se přesuňte do části Přesunout projekt do jiného e-shopu a klikněte na *Přesunout projekt*. 4. V kolonce *Cílový e-shop* vyberte e-shop, do kterého si přejete projekt přesunout. 5. Klikněte na *Přesunout*. 6. Projekt se pod nový e-shop přesune včetně celé jeho historie změn a nastavení. ## Jak přesunout projekt pod e-shop, který nespravuju Potřebujete projekt přesunout pod e-shop, ke kterému máte oprávnění Čtení nebo k němu v rámci Mergada nemáte žádnou vazbu? V takovém případě kontaktujte naši technickou podporu na e-mailové adrese [mergado@mergado.cz](mailto:mergado@mergado.cz) a my pro vás projekty přesuneme. Budeme však potřebovat e-mailové potvrzení od Vlastníka cílového e-shopu, kde nám potvrdí, že vámi vytvořený projekt můžeme skutečně přesunout pod jeho e-shop. ## FAQ: Jak v Mergadu přesunout projekt pod jiný e-shop? #### Jak přesunu projekt pod jiný e-shop? 1. Na stránce *Detaily uživatele* ve svém účtu klikněte na e-shop, kde se projekt nachází. 2. U projektu, který chcete přesunout, klikněte na ikonku ozubeného kolečka, čímž budete odkázáni na stránku *Obecná nastavení projektu*. 3. V části *Přesunout projekt do jiného e-shopu* klikněte na *Přesunout projekt*. 4. V kolonce vyberte cílový e-shop a klikněte na *Přesunout*. #### Můžu projekt přesunout pod e-shop, který nespravuju? Pokud potřebujete přesunout projekt pod e-shop, ke kterému máte oprávnění Čtení nebo k němu v rámci Mergada nemáte žádnou vazbu, kontaktujte naši technickou podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). Budeme potřebovat e-mailové potvrzení od Vlastníka cílového e-shopu, že souhlasí s přesunem projektu pod jeho e-shop. #### Co dělat, pokud mám více e-shopů a omylem jsem vytvořil projekt pod nesprávným e-shopem? Pokud jste projekt vytvořili pod nesprávným e-shopem, jednoduše ho můžete přesunout: 1. Na stránce *Detaily uživatele* ve svém účtu klikněte na e-shop, kde se projekt nachází. 2. U projektu, který chcete přesunout, klikněte na ikonku ozubeného kolečka, čímž přejdete na stránku *Obecná nastavení projektu*. 3. V části *Přesunout projekt do jiného e-shopu* klikněte na *Přesunout projekt*. 4. Vyberte cílový e-shop, do kterého chcete projekt přesunout. 5. Klikněte na *Přesunout*. Tento postup vám umožní jednoduše přemístit projekt pod správný e-shop, aniž byste museli projekt mazat nebo vytvářet nový. #### Můžu mít v rámci jednoho e-shopu v Mergadu více různých internetových obchodů? Ne, dle [Podmínek užívání](https://www.mergado.cz/podminky-uzivani) není možné mít v rámci jednoho e-shopu více různých internetových obchodů. Pokud máte více e-shopů, každý musí mít svůj vlastní e-shop také v Mergadu. Pod jednotlivými e-shopy pak vytvoříte příslušné projekty, které se k danému e-shopu vztahují. --- ## [Pravidlo: Hromadné zkopírování hodnot](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-hromadne-zkopirovani-hodnot/) # Pravidlo: Hromadné zkopírování hodnot ## **Pravidlo: Hromadné zkopírování hodnot** Toto pravidlo umožňuje **zkopírování hodnot** z jednoho elementu do jiného v rámci Mergado Editoru. Hodnoty se přenesou ze **zdrojového elementu** do **cílového elementu**. Pravidlo jde použít hromadně pro kopírování více elementů pomocí jednoho pravidla. **Zdroje** * [Hromadné zkopírování hodnot na Mergado Fórum (téma)](https://forum.mergado.cz/t/hromadne-zkopirovani-hodnot/1982) * [Příklad využití na Mergado Fórum](https://forum.mergado.cz/t/hromadne-zkopirovani-hodnot/1982/4) * [Video návod na YouTube](https://www.youtube.com/watch?v=HqR831a1qas&_gl=1*kmk6yj*_gcl_au*MTc1NTc2NjU5My4xNzQ4NDE5MTYwLjExODA1ODM5NzQuMTc1MjEzMjc2MC4xNzUyMTMyNzYw) **Extra funkce** * Hromadné kopírování hodnot například: z Google Sheets * Hromadné zkopírování struktury * Předvyplnění levé strany * Možnost přidat více řádků * Na pořadí řádků záleží – aplikují se shora dolů **Konkrétní příklady** **Příklad 1:** Prohození hodnot dvou elementů mezi sebou Tento příklad ukazuje, jak pomocí hromadného zkopírování hodnot prohodit hodnoty mezi dvěma elementy (např. mezi image a image\_alternative). * **Vytvoření pomocného elementu**: * Na stránce **„Elementy“** v pravém horním rohu klikněte na tlačítko **„Nový element“**. * Vytvořte pomocný element, například *„pomocny\_element“*. * **Skryjte tento element** pomocí přepínače na konci řádku. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné zkopírování hodnot**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba zdrojového elementu:** * V levém sloupci **„Zdrojový element“** vyberte element, **ze kterého chcete kopírovat** hodnoty. * Element můžete vyhledat zadáním části názvu elementu do pole **„Zdrojový element“**. Například: `image` nebo `image_alternative`. * **Volba cílového elementu** * V pravém sloupci **„Cílový element“** vyberte element, **do kterého chcete hodnoty vložit**. * **Přidání dalšího řádku** * Pokud potřebujete kopírovat více elementů najednou, můžete přidat další řádky. * **Pořadí řádků záleží** – pravidlo se aplikuje **shora dolů**. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Prohození hodnot dvou elementů”. **Příklad 2:** Kopírovat více elementů do různých cílových elementů Tento příklad ukazuje, jak použít hromadné zkopírování hodnot pro kopírování více elementů (např. title, description, price) do různých cílových elementů (např. g:title, g:description, g:price). * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné zkopírování hodnot**. * **Výběr produktů:** * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba zdrojového elementu:** * V poli **„Zdrojový element“** vyberte element, **ze kterého chcete kopírovat hodnoty**. * Například: `title`, `description`, `price`. * **Volba cílového elementu:** * V poli **„Cílový element“** vyberte element, **do kterého chcete kopírovat hodnoty**. * Například: `g:title`, `g:description`, `g:price`. * **Přidání dalšího řádku** * Pokud potřebujete kopírovat více elementů najednou, **přidejte další řádky** pro každý pár zdrojového a cílového elementu. * **Pořadí řádků záleží**, protože se aplikují **shora dolů**. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Kopírování elementů*”. **Příklad 3:** Zkopírovat **vybrané parametry** do jiných elementů Tento příklad ukazuje, jak pomocí **hromadného zkopírování hodnot** přenést **parametry** z jednoho elementu do jiného * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné zkopírování hodnot**. * **Výběr produktů:** * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba zdrojového elementu:** * V poli Zdrojový element vyberte parametr, jehož hodnoty chcete kopírovat * **Volba cílového elementu:** * V poli Cílový element vyberte element (nebo zadejte cestu k elementu), do kterého chcete kopírovat hodnoty parametru. * **Přidání dalšího řádku** * Pokud potřebujete kopírovat více parametrů najednou, můžete přidat další řádky a nastavit tak hromadné kopírování více parametrů pomocí jednoho pravidla. * Na pořadí řádků záleží \- aplikují se shora dolů. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Kopírování parametrů*”. **Příklad 4:** Zkopírovat všechny parametry do jiných elementů se zachováním struktury název-hodnota parametru Tento příklad ukazuje, jak kopírovat všechny parametry do cílových elementů se zachováním struktury, tedy název-hodnota parametru. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné zkopírování hodnot**. * **Výběr produktů:** * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Využití speciálního chování pravidla pro kopírování struktury** * Pro zkopírování všech parametrů do různých elementů využijeme speciální chování pravidla, které nazýváme „hromadné kopírování struktury“. Nemusíme jmenovitě vypisovat všechny názvy parametrů, stačí na 3 řádky pravidla zadat následující: * 1\. řádek: Název obalovacího (rodičovského) elementu parametrů. * 2\. řádek: Název elementu s názvy parametrů * 3\. řádek: Název elementu s hodnotami parametrů * **Volba zdrojového elementu na prvním řádku:** * V poli Zdrojový element vyberte obalovací (rodičovský) element parametrů, které chcete kopírovat, např. `PARAM` * **Volba cílového elementu na prvním řádku:** * V poli Cílový element vyberte obalovací (rodičovský) element parametrů, do kterých chcete parametry kopírovat, např. `g:attribute_detail` * **Volba zdrojového elementu na druhém řádku:** * V poli Zdrojový element vyberte element s názvy parametrů, které chcete kopírovat, např. `PARAM | PARAM_NAME` * **Volba cílového elementu na druhém řádku:** * V poli Cílový element vyberte element, do kterých chcete názvy parametrů kopírovat, např. `g:attribute_detail | g:attribute_name` * **Volba zdrojového elementu na druhém řádku:** * V poli Zdrojový element vyberte element s hodnotami parametrů, které chcete kopírovat, např. `PARAM | PARAM_VALUE` * **Volba cílového elementu na druhém řádku:** * V poli Cílový element vyberte element, do kterých chcete hodnoty parametrů kopírovat, např. `g:attribute_detail | g:attribute_value` * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Kopírování všech parametrů*”. **Další využití pravidla** * Domapování elementů, které nevzládl Převodník **FAQ:** **1\. K čemu slouží pravidlo „Hromadné zkopírování hodnot“?** Toto pravidlo umožňuje **zkopírovat hodnoty z jednoho elementu do jiného**. Navíc v rámci jednoho pravidla nastavíte hned několik kopírování najednou. Můžete ho využít například pro: * přenos hodnot mezi elementy (např. `title` → `g:title`), * duplikaci obsahu více elementů, * kopírování parametrů do struktury vyžadované konkrétním srovnávačem, * nebo hromadné přenesení dat mezi feedy. **2\. Můžu kopírovat více elementů najednou?** Ano. Do jednoho pravidla můžete přidat více řádků, kdy každý řádek představuje **pár zdrojový → cílový element**. 💡 Pořadí řádků je důležité — Mergado je **aplikuje shora dolů**. **3\. Co znamená „zdrojový“ a „cílový“ element?** * **Zdrojový element** – z něj se hodnota kopíruje (např. `title`) * **Cílový element** – do něj se hodnota vloží (např. `g:title`) Pokud cílový element ještě neexistuje, je potřeba ho **vytvořit na stránce Elementy** pomocí tlačítka **„Nový element“**. **4\. Dá se tímto pravidlem hodnoty i prohodit?** Ano. Pro tzv. **prohození hodnot dvou elementů** (např. `image` ↔ `image_alternative`) postupujte takto: 1. Na stránce **Elementy** vytvořte pomocný element (např. `pomocny_element`) a následně ho skryjte. 2. zkopírujte `image` → `pomocny_element`, 3. `image_alternative` → `image`, 4. a nakonec `pomocny_element` → `image_alternative`. 💡 Po přegenerování feedu si tak hodnoty „vymění“ místo. **5\. Zvládne toto pravidlo i hromadné kopírování struktury?** Pravidlo umožňuje kopírovat **celé sady elementů se zachováním jejich hierarchie** (např. parametry názvů a hodnot). Stačí zadat tři řádky pravidla: 1. obalovací element (`PARAM` → `g:product_detail`), 2. element s názvy (`PARAM | PARAM_NAME` → `g:product_detail | g:attribute_name`), 3. element s hodnotami (`PARAM | PARAM_VALUE` → `g:product_detail | g:attribute_value`). Mergado automaticky vytvoří odpovídající strukturu cílového formátu. **6\. Kdy se vyplatí využít kopírování struktury?** Například při exportu feedu do platformy, která používá odlišný formát elementů (např. Google vs. Heureka) a pokud to Mergado nevytvoří automaticky. Díky kopírování struktury nemusíte ručně mapovat desítky parametrů — systém to provede automaticky. **7\. Dá se tímto pravidlem kopírovat i parametry produktů?** Ano. Pravidlo zvládne přenášet hodnoty i mezi parametry, například: `PARAM | PARAM_NAME` → `g:product_detail | g:attribute_name`. To se hodí při převodu feedu na jiný formát nebo doplňování parametrů chybějících v cílovém XML. **8\. Co se stane, pokud cílový element už obsahuje hodnotu?** Výchozí chování je, že **stávající hodnota se přepíše** hodnotou ze zdrojového elementu. Pokud potřebujete hodnoty zachovat a pouze doplnit, je vhodnější použít jiné pravidlo, např. **Přidat hodnotu vícenásobného elementu**. **9\. Můžu použít proměnné nebo textové úpravy při kopírování?** Ne přímo v tomto pravidle. Pravidlo kopíruje hodnoty **beze změny**. Pokud potřebujete hodnoty upravit (např. přidat text, odstranit znaky), použijte kombinaci s pravidlem **Přepsat** nebo **Najít a nahradit**. **10\. Dá se pravidlo aplikovat jen na určité produkty?** Ano. V poli **„Výběr“** můžete použít uložené výběry nebo vytvořit nové, např. jen pro určité značky, cenové hladiny nebo kategorie. Díky tomu můžete kopírovat hodnoty selektivně jen pro část feedu. **11\. Co když chci kopírovat jen určité řádky elementu (např. konkrétní parametr)?** V takovém případě lze použít **cestu k elementu** včetně podmínky, např.: `PARAM {PARAM_NAME="Barva"} | VAL` Tím Mergado zkopíruje jen hodnoty, které odpovídají parametru „Barva“. **12\. Jak zjistím, jestli kopírování proběhlo správně?** Po **uložení a aplikování pravidel** * přejděte na stránku **Produkty** a zkontrolujte produkt, který je součástí výběru z kopírovacího pravidla * nebo spusťte **„Průchod pravidly“** u konkrétního produktu – uvidíte, jak byla hodnota zkopírována. nebo po **přegenerování feedu**: * otevřete výstupní feed a zkontrolujte cílový element, **13\. Můžu tímto pravidlem opravit neúplně namapované elementy po Převodníku?** Ano, to je jedno z častých využití. Pokud Převodník nevytvořil všechny elementy podle očekávání, můžete pomocí tohoto pravidla **doplnit chybějící nebo přemapovat** ty, které se nepřevedly správně. **14\. Dá se pravidlo naplánovat v čase (časovač)?** Ano, můžete aktivovat **časovač** a nechat pravidlo spouštět jen v určitých dnech nebo hodinách. **15\. Jaké jsou nejčastější chyby při práci s tímto pravidlem?** * Záměna směru kopírování (zdroj ↔ cílový element). * Použití neexistujícího elementu. * Neprovedené přegenerování feedu po aplikaci pravidel \- změny zatím nejsou vidět v samotném feedu * Pořadí řádků – kopírování se vyhodnocuje **shora dolů**. 💡 Doporučení: otestujte pravidlo nejprve na malém vzorku produktů pomocí **Průchodu pravidly**. **16\. Co když potřebuji přenést i strukturu atributů nebo názvů parametrů?** Využijte **kopírování celé struktury** (viz Příklad 4). Mergado umožňuje přenést i zanořené elementy s jejich názvy a hodnotami, takže zachová původní vztah `název – hodnota`. --- ## [Jak vypnout a zapnout projekt v Mergadu?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/sprava-projektu-v-mergadu/jak-vypnout-a-zapnout-projekt-v-mergadu/) # Jak vypnout a zapnout projekt v Mergadu? Vytvořili jste si ve svém e-shopu projekt pro specializovanou reklamní platformu (jako Favi nebo Biano), ale zrovna *teď nemáte čas se mu stoprocentně věnovat*? Projekt byt tak pro vás teď byl spíše prodělečný, ale zároveň víte, že *v budoucnu to chcete zase rozjet*? Prodáváte *sezónní zboží* (jako lyže nebo vánoční stromky), které má *smysl inzerovat jen v sezóně* a mimo ni chcete projekty s tímto zbožím nechat neaktivní? Chcete *optimalizovat svůj rozpočet* a rozhodli jste na nějaký čas pozastavit některý projekt a snížit tak náklady na inzerci? A nebo jste prostě jenom *zapomněli zaplatit včas fakturu za Mergado* a chcete projekty, které byly v důsledku toho vypnuty, *opět aktivovat*? Nic z toho rozhodně nemusíte řešit mazáním nebo vytvářením zcela nových projektů. Pokud máte k e-shopu, pod který daný projekt spadá, oprávnění Vlastník nebo Zápis, stačí vybraný projekt vypnout nebo zapnout. Pokaždé, když budete chtít určitý projekt dočasně vypnout nebo znovu zapnout, *kontaktujte naši podporu* na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). Pokud je váš požadavek pro vypnutí nebo zapnutí projektu spojen s fakturací (třeba právě s platbou provedenou až po splatnosti faktury) *kontaktujte naši fakturační podporu* na e-mailu [billing@mergado.cz](mailto:billing@mergado.cz). ℹ️ *Pokud máte pro dané projekty, které si přejete dočasně vypnout, zapnutá i některá placená rozšíření Mergada, tato rozšíření se s vypnutím projektu automaticky také vypnou. Pokud však máte zapnutá placená rozšíření na úrovni e-shopu nebo uživatele, doporučujeme je po dobu vypnutí projektu také vypnout. Některá rozšíření totiž dokáží pracovat i s neaktivním exportem a mohla by vám tak být fakturována.* ## FAQ: Jak vypnout a zapnout projekt v Mergadu? ### Jak vypnu projekt v Mergadu bez toho, abych ho smazal/a? Pokud chcete dočasně vypnout nebo opět zapnout projekt, stačí se obrátit na naši podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). Vybraný projekt pro vás vypneme nebo zapneme, kdykoliv to budete potřebovat. ### Jak zapnu dočasně deaktivovaný projekt v Mergadu? Pro zapnutí dočasně vypnutého projektu kontaktujte naši podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). Pokud je váš projekt dočasně vypnutý z důvodu pozdě zaplacené faktury, kontaktujte nás na e-mailu [billing@mergado.cz](mailto:billing@mergado.cz). ### Můžu pozastavit projekt bez jeho smazání? Ano, projekty lze jednoduše vypnout nebo zapnout, aniž by bylo nutné je smazat a znovu vytvářet. Kontaktujte nás na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz) a my se o to postaráme. ### Co mám dělat, pokud byl můj projekt vypnut kvůli nezaplacené faktuře? Pokud byl projekt vypnut kvůli nezaplacené faktuře, kontaktujte prosím naši fakturační podporu na e-mailu [billing@mergado.cz](mailto:billing@mergado.cz). ### Jak postupovat, když mám projekt se sezónním zbožím, které nyní nechci inzerovat, ale projekt chci ponechat pro budoucí sezónu? Pokud si chcete projekt ponechat, ale momentálně nechcete inzerovat sezónní zboží, projekt je možné vypnout, aniž byste jej museli smazat. Jakmile bude zboží opět připraveno k inzerci v příští sezóně, projekt můžete znovu aktivovat. Pro vypnutí i zapnutí projektu se obraťte na naši podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz). --- ## [Pravidlo: Přidat hodnotu vícenásobného elementu](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-pridat-hodnotu-vicenasobneho-elementu/) # Pravidlo: Přidat hodnotu vícenásobného elementu ## **Pravidlo: Přidat hodnotu vícenásobného elementu** Základním principem pravidla je, že námi vybranému existujícímu elementu přidá další hodnotu. **Zdroje** * [Vícenásobné elementy v pravidlech – Mergado Fórum](https://forum.mergado.cz/t/vicenasobne-elementy-v-pravidlech/2485) * [Pravidlo Přidat hodnotu vícenásobného elementu – Mergado Fórum](https://forum.mergado.cz/t/pravidlo-pridat-hodnotu-vicenasobneho-elementu/2155) **Extra funkce** Jak se pravidlo chová v různých situacích? Pokud: * element zatím žádnou hodnotu nemá \- přidá novou hodnotu na první pozici, nevznikne tak vícenásobný element: * `` `->` `nová hodnota` * element má zatím jednu hodnotu \- přidá novou hodnotu na další, tedy druhou pozici, vznikne tak vícenásobný element: * `původní hodnotaA` `->` `původní hodnotaA` `nová hodnota` * element má už více hodnot (už je vícenásobný) \- přidá novou hodnotu na další, tedy první volnou pozici: * `původní hodnotaA` `původní hodnotaB` `->` `původní hodnotaA` `původní hodnotaB` `nová hodnota` **Konkrétní příklady** Příklad 1: Přidání další URL alternativního obrázku * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Přidat hodnotu vícenásobného elementu**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu. * v našem případě to bude `g:additional_image_link` * **Zadejte novou hodnotu:** * Do pole “Nová hodnota” zadejte * textovou hodnotu, například: konkrétní url (https://www…) * proměnnou, ve které je hodnota uložená, například: `%url%` * kombinaci proměnné a textu, například: `https://www.my-shop.com/%image_handle%` * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například: “Přidání alternativních obrázků” **Další využití pravidla** * Přidat další alternativní kategorie FAQ: **1\. K čemu pravidlo „Přidat hodnotu vícenásobného elementu“ slouží?** Toto pravidlo umožňuje **přidat novou hodnotu** do existujícího elementu, který podporuje vícenásobné hodnoty (např. obrázky, kategorie nebo parametry). Používá se typicky pro doplnění dalších URL obrázků (`g:additional_image_link`) nebo alternativních kategorií. **2\. Jak se pravidlo chová, když element zatím nemá žádnou hodnotu?** Pokud element nemá žádnou hodnotu, Mergado **vytvoří první hodnotu** a element se zatím **nepovažuje za vícenásobný**. `` `→` `nová hodnota` **3\. Co se stane, pokud má element jednu nebo více hodnot?** * Pokud má **jednu hodnotu**, nová hodnota se přidá na **další pozici** a element se stane vícenásobným. * Pokud má **více hodnot**, nová hodnota se přidá na **první volné místo** (tj. jako další položka v pořadí). 💡 **Příklad:** `původníA` `→` `původníA` `nová_hodnota` **4\. Dá se tímto pravidlem přidat více hodnot najednou?** Ne přímo. Každé pravidlo přidá **jednu hodnotu na jeden řádek**. Pokud chcete přidat více hodnot (např. více URL obrázků), použijte více pravidel tohoto typu. **5\. Jaké typy hodnot lze do elementu přidat?** Do pole **„Nová hodnota“** můžete zadat: * **textovou hodnotu**, např. `https://www.mujshop.cz/img123.jpg`, * **proměnnou**, např. `%url%`, * **kombinaci textu a proměnné**, např. `https://cdn.mujshop.cz/%image_name%`. **6\. Dá se tímto pravidlem přidat i dynamická hodnota z jiného elementu?** Ano. Pokud chcete přidat hodnotu z jiného elementu, použijte jeho **proměnnou** (např. `%g:image_link%`). Mergado při přegenerování automaticky doplní hodnotu každého produktu podle této proměnné. **7\. Jak poznám, že můj element je vícenásobný?** Na stránce Elementy v projektu se u vícenásobných elementů (např. `g:additional_image_link`) zobrazuje maximální počet hodnot v závorce, např. `(6×)`. Takové elementy se mohou u jednoho produktu vyskytovat vícekrát. Přehled najdete v dokumentaci: [Vícenásobné elementy v Mergadu](https://forum.mergado.cz/t/vicenasobnost/2154). **8\. Dá se pravidlo použít i pro jiné účely než obrázky?** Ano. Pravidlo lze využít např. pro: * přidání **dalších kategorií**, * doplnění **alternativních URL**, * rozšíření **seznamu parametrů** (např. přidat nový parametr u produktů s určitým výběrem). **9\. Dá se přidávaná hodnota omezit jen na určité produkty?** Ano. V poli **„Výběr“** můžete zvolit buď **Všechny produkty**, nebo **vytvořit vlastní výběr**, například jen pro produkty určité značky, kategorie nebo s chybějícím obrázkem. **10\. Co se stane, pokud element, do kterého chci přidávat, ve feedu chybí?** Pravidlo ho **nevytvoří automaticky** – musíte ho nejprve přidat ručně: 1. Otevřete stránku **Elementy**, 2. klikněte na **„Nový element“**, 3. zadejte název elementu (např. `g:additional_image_link`), 4. a potvrďte vytvoření. **11\. Dá se přidání hodnoty naplánovat v čase?** Ano. Pokud chcete například přidávat odkazy jen v určitém období (např. sezónní obrázky), můžete aktivovat **časovač pravidla** a nastavit konkrétní dny či hodiny, kdy se má pravidlo spouštět. **12\. Jak ověřím, že přidání hodnoty proběhlo správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu**: * otevřete stránku *Elementy* nebo stránku *Produkty*, * zkontrolujte, že nový řádek hodnoty přibyl, * případně spusťte **Průchod pravidly** u konkrétního produktu – zobrazí vám výsledek pravidla v reálném čase. **13\. Dá se tímto pravidlem nahradit existující hodnota?** Ne. Pravidlo pouze **přidává nové hodnoty**, existující hodnoty nemění ani nemaže. Pokud potřebujete hodnoty přepsat, použijte pravidlo **Přepsat** nebo **Hromadné přepisování dle výběru**. **14\. Na co si dát pozor při použití pravidla?** * Po přidání pravidla vždy proveďte **přegenerování feedu**. * Pokud se hodnoty neprojevují, zkontrolujte výběr produktů a zda element skutečně existuje. FAQ: **1\. K čemu slouží pravidlo Přidat hodnotu vícenásobného elementu?** Toto pravidlo umožňuje **přidat další hodnotu** k již existujícímu elementu, aniž by se původní obsah přepsal. Využívá se například při doplňování **dalších URL obrázků**, **alternativních kategorií** nebo jiných vícenásobných údajů. **2\. Jak poznám, že element je vícenásobný?** Element je vícenásobný, pokud se ve feedu může vyskytovat **vícekrát se stejným názvem**. Například: `url1.jpg` `url2.jpg` V takovém případě je možné přidávat další hodnoty, aniž by se staré přepsaly. **3\. Co se stane, když přidávám hodnotu do elementu, který zatím žádnou hodnotu nemá?** Pokud element zatím neexistuje nebo je prázdný, Mergado **vytvoří nový element** s první hodnotou. Nevznikne vícenásobný element, ale pouze jeden záznam, např.: `nová hodnota` **4\. Co když element už obsahuje jednu hodnotu?** V takovém případě Mergado **přidá novou hodnotu na další (druhou) pozici**, např.: `původní` `nová hodnota` **5\. A co když element už obsahuje více hodnot?** Pravidlo přidá novou hodnotu **na další volnou pozici**. Původní hodnoty zůstanou zachovány, např.: `hodnotaA` `hodnotaB` `nová hodnota` **6\. Jaký typ hodnot mohu přidávat?** Do pole **„Nová hodnota“** můžete vložit: * **text** (např. `https://.../image.jpg`), * **proměnnou** (např. `%image_url%`), * nebo **kombinaci textu a proměnné** (např. `https://shop.cz/%image_handle%`). **8\. Dá se pravidlo využít i pro jiné účely než obrázky?** Ano. Pravidlo lze použít pro jakýkoliv vícenásobný element – například pro **alternativní kategorie**, **další odkazy**, **více parametrů**, nebo **variantní informace**. **9\. Co když přidám stejnou hodnotu, která už v elementu existuje?** Mergado v tuto chvíli **duplikaci neodstraňuje automaticky**. Pokud přidáte hodnotu, která už v elementu existuje, bude ve výstupu uvedena dvakrát. **10\. Jak zkontroluji, zda se hodnota skutečně přidala?** Po **uložení a aplikování pravidel nebo po přegenerování feedu** otevřete **náhled produktů** nebo použijte **Průchod pravidly**. Uvidíte, že se do vícenásobného elementu přidala nová hodnota, aniž by se ty původní změnily. **11\. Mohu pomocí pravidla přidat hodnotu jen vybraným produktům?** Ano. V poli **„Výběr“** zvolte buď **„Všechny produkty“**, nebo vyberte **konkrétní produktový výběr**, kterému chcete novou hodnotu přidat. Můžete tak např. doplnit alternativní obrázky jen u produktů v určité kategorii. **12\. Jak se chová pravidlo, pokud přidávám proměnnou, která je prázdná?** Pokud je proměnná prázdná, Mergado **nevytvoří nový záznam**. Tím se zamezí vzniku prázdných elementů bez hodnoty. **13\. Mohu přidávání hodnot naplánovat (např. jen pro určité období)?** Ano. Pomocí **Časovače** můžete určit konkrétní dny, hodiny nebo datumové rozmezí, kdy má být pravidlo aktivní. To je vhodné např. pro **sezónní doplnění kategorií** nebo **dočasné přidání promo obsahu**. **14\. Lze tímto pravidlem nahrazovat existující hodnoty?** Ne. Pravidlo pouze **přidává nové hodnoty**, nikdy nepřepisuje existující. Pokud potřebujete hodnoty změnit nebo nahradit, použijte pravidlo **Přepsat** nebo **Najít a nahradit**. **15\. Dá se přidat hodnota do elementu, který není ve výstupním formátu povolený?** Pokud cílový element není ve formátu podporovaný, Mergado ho do výstupu **nevloží**. V takovém případě je potřeba nejprve upravit **výstupní formát projektu**, nebo element vytvořit ručně ve **stránce Elementy**. **16\. Mohu tímto pravidlem doplňovat obrázky z externí tabulky (např. z Google Sheets)?** Ano. Pokud máte tabulku s odkazy na obrázky, můžete je importovat do Mergada pomocí **Import datového souboru (CSV / XML)** a následně doplnit pomocí tohoto pravidla. Tím lze kombinovat **externí data** s **vícenásobnými elementy** ve feedu. ## --- ## [Jak v Mergadu smazat projekt?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/sprava-projektu-v-mergadu/jak-v-mergadu-smazat-projekt/) # Jak v Mergadu smazat projekt? Pokud jste se rozhodli některý ze svých projektů definitivně odstranit (např. už nechcete inzerovat na některé reklamní platformě, případně chcete snížit náklady na inzerci) a jste si jistí, že už se k němu nikdy nebudete chtít vrátit, můžete jej jednoduše smazat. *TIP! Pokud projekt dočasně nechcete používat (např. prodáváte sezónní zboží, které na vybrané reklamní platformě nemá smysl mimo sezónu inzerovat), ale zároveň víte, že jej po čase budete chtít opět aktivovat, doporučujeme projekt pouze vypnout a v pravou chvíli opět zapnout. Více o vypnutí a zapnutí projektu se dozvíte v [tomto článku](https://forum.mergado.cz/t/jak-vypnout-a-zapnout-projekt-v-mergadu/jak-vypnout-a-zapnout-projekt-v-mergadu).* ## Jak smazat projekt 1. Na stránce *Detaily uživatele* ve svém účtu klikněte na e-shop, kde se nachází projekt, který chcete smazat. 2. U projektu, který chcete smazat, klikněte na ikonku ozubeného kolečka, čímž přejdete na stránku *Obecná nastavení projektu*. 3. V části *Smazat projekt* potvrďte zaškrtnutím políčka, že chcete vybraný projekt opravdu smazat. 4. Klikněte na *Smazat projekt*. 5. Jakmile se projekt smaže, přijde vám upozornění do e-mailu. ## Jak obnovit omylem smazaný projekt V případě, že některý projekt smažete omylem a potřebovali byste jej obnovit, kontaktujte neprodleně po smazání naši technickou podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz) nebo na telefonním čísle +420 530 513 050. *TIP! Obnovení je možné jen krátce po smazání a my vám můžeme pomoci v rámci naší pracovní doby. Pokud tedy plánujete mazat projekty a „dělat pořádek“ ve svých e-shopech, doporučujeme si tuto činnost naplánovat na pracovní dny ideálně během dopoledne, abychom případně měli čas na vaši zprávu reagovat a pomoct vám.* ## FAQ: Jak v Mergadu smazat projekt? ### Jak smažu projekt v Mergadu? Na stránce *Detaily uživatele* ve svém Mergado účtu klikněte na e-shop, kde se projekt nachází. U projektu, který chcete smazat, klikněte na ikonku ozubeného kolečka, čímž přejdete na stránku *Obecná nastavení projektu*. V části *Smazat projekt* zaškrtněte políčko pro potvrzení smazání a klikněte na *Smazat projekt*. Po úspěšném smazání obdržíte e-mailové upozornění. ### Můžu obnovit omylem smazaný projekt? Pokud jste projekt smazali omylem, kontaktujte neprodleně naši technickou podporu na e-mailu [mergado@mergado.cz](mailto:mergado@mergado.cz) nebo telefonu +420 530 513 050. Obnovení je možné jen krátce po smazání. ### Co dělat, když nechci, aby byl projekt aktivní, ale vím, že jej v budoucnu budu opět potřebovat? V případě, že nechcete, aby byl projekt aktivní, ale zároveň víte, že jej po čase budete chtít opět používat, není potřeba jej mazat a pak znovu vytvářet. Doporučujeme projekt vypnout a následně opět zapnout. Více o vypnutí a zapnutí projektu se dozvíte v [tomto článku](https://forum.mergado.cz/t/jak-vypnout-a-zapnout-projekt-v-mergadu/jak-vypnout-a-zapnout-projekt-v-mergadu). --- ## [Pravidlo: Import datového souboru (CSV / XML)](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-import-datoveho-souboru-csv-xml/) # Pravidlo: Import datového souboru (CSV / XML) ## **Pravidlo: Import datového souboru (CSV / XML)** Pomocí pravidla **Import datového souboru** můžete **importovat data z externího XML nebo CSV souboru** do již existujících položek ve vašem projektu. Soubor lze do pravidla nahrát **přímo jako upload**, nebo zadat **URL adresu**, ze které se data pravidelně načítají. Tímto způsobem můžete obohatit produktová data například o **dostupnost**, **výkonnostní statistiky**, **marže** nebo jiné doplňující informace. **Zdroje** * [CSV import v Mergadu | Mergado Blog](https://www.mergado.cz/blog/csv-import-mergado-release) * [Import datového souboru | Mergado Fórum](https://forum.mergado.cz/t/import-datoveho-souboru/1974) * [Import a export dat Google Sheets | Mergado Blog](https://www.mergado.cz/blog/import-a-export-dat-google-sheets) **Extra funkce** * **Režim mapování:** * **Klíč se shoduje** – hodnoty párovacího elementu jsou ve zdroji i v Mergadu **zcela stejné**. * Hodnota z importovaného souboru se načte pouze tehdy, pokud se hodnota v importu **rovná** hodnotě párovacího elementu v projektu. * Typicky se používá pro párování podle **unikátního ID produktu**. * **Klíč je obsažen** – hodnoty párovacího elementu se **částečně shodují**. * Hodnota z importovaného souboru se načte pouze tehdy, pokud je párovací hodnota z importu **obsažena** v hodnotě párovacího elementu v projektu. * Typicky se používá při párování podle **klíčového slova v názvu** nebo **kategoriích** produktu. * **Podporované typy souboru:** * XML * CSV * Google Sheets (přes zveřejnění Sheetu jako CSV na veřejné URL adrese) * **Způsob napojení souboru:** * **Nahrání souboru (upload)** – jednorázový import. * Pokud se data v souboru změní, je nutné soubor **znovu ručně nahrát**. * **Zadání URL** – dynamické napojení. * Pokud se data v souboru změní, **nové hodnoty se načtou automaticky** při každém přegenerování projektu. * **Oddělovač polí:** * Čárka, středník, svislítko – dle formátu ve zdrojovém souboru (čárka je výchozí) **Konkrétní příklady** **Příklad 1**: Import skladové dostupnosti z Heureka dostupnostního XML feedu Tento příklad ukazuje, jak pomocí pravidla **Import datového souboru (CSV / XML)** obohatit standardní produktový feed o informace o **dostupnosti produktů** z externího XML feedu (např. Heureka). * **Příprava projektu před importem \-** před samotným importem je třeba připravit projekt tak, aby pak import fungoval * **Názvy elementů**, které chcete importovat (nebo názvy sloupců v CSV souboru), musí být **shodné** s názvy elementů v projektu, do kterých budete data zapisovat. * Pokud chcete importovat element, který v projektu **zatím neexistuje**, je potřeba ho **vytvořit ručně**: * Otevřete stránku **„Elementy“**. * Klikněte na tlačítko **„Nový element“**. * Zadejte název elementu a potvrďte vytvoření. * Elementy, do kterých budete importovat, mohou být **skryté** – jejich viditelnost nemá vliv na import. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Import datového souboru (CSV / XML)**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Zdroj datového souboru:** * Pomocí přepínače (Radio button) vyberte, odkud se má soubor načíst: * **Zadat URL** * V poli **URL adresa** vložte adresu k XML nebo CSV souboru (např. URL dostupnostního feedu z Heureky). * Klikněte na tlačítko **„Import“**. * Mergado automaticky detekuje, zda jde o **CSV** nebo **XML** a podle toho přizpůsobí rozhraní pravidla. * **Nahrát soubor z počítače** * V poli **Datový soubor** klikněte na tlačítko **„Nahrát soubor“** a vyberte soubor z počítače (např. Heureka dostupnostní feed). * Mergado opět automaticky rozpozná formát a přizpůsobí nastavení. * 💡 **Tip:** Maximální velikost nahraného souboru je **25 MB**. * **Element ohraničující položku** (pouze pro XML import) * V poli **Element ohraničující položku** nastavte element, který v XML souboru ohraničuje položku (typicky je to například SHOPITEM nebo ITEM), včetně nadřazeného kořenového (tzv. ROOT) elementu. * V našem případě použijeme: `item_list | item` * **Párovací element v aktuálním projektu** * Vyberte element z aktuálního projektu v Mergadu, podle kterého chcete párovat produkty s daty z importovaného souboru, například id produktu: `g:id` * **💡Tip**: Pokud možno, vybírejte párovací element ze vstupního feedu projektu. Umožní to rychlejší vyhodnocování a zpracování pravidla při přegenerování projektu * **Párovací element v importovaném souboru** * Vyberte element z importovaného souboru, který obsahuje hodnoty odpovídající vybranému párovacímu elementu v aktuálním projektu, např atribut s id produktu v Heureka dostupnostním feedu: `@id` * **Párovat podle vstupních hodnot** * **Checkbox „Párovat podle vstupních hodnot”** je **defaultně zapnutý**. * Pokud je aktivní, data se párují podle **původních hodnot ze vstupního feedu** projektu (před jakoukoliv úpravou Mergadem). * Pokud ho vypnete, párování proběhne podle **hodnot, které už mohly být upraveny jinými pravidly**. * ⚠️ **Upozornění:** Vypnutí této volby může **zpomalit zpracování dat**. * **Pokročilá nastavení** * V sekci **Pokročilá nastavení** nastavte: * **Režim mapování** pomocí Selectboxu * v našem případě použijeme režim **Klíč se přesně shoduje** * zda **Rozlišovat velikost písmen** pomocí Checkboxu * v našem případě necháme checkbox vypnutý * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například Import dustopnosti. **Další využití pravidla** * Jednorázový import EAN kódů nebo jiných hodnot (například: GPSR údaje nebo URL adresy chybějících obrázků) * Napojit dynamické hodnoty z Google Sheets do Mergada * Výkonnostní data z Google Analytics (kliky, zobrazení, objednávky) * Sezónnost produktů * Skladové zásoby * Import custom\_label pro PPC * Import dat pro segmentaci a nastavení custom\_label pro PPC * Import nákupních cen a marží pro automatický pricing pomocí rozšíření Pricing Fox * Import překladů (pokud mám překlady v jiném jazyce v jiném feedu a potřebuji je dostat do Mergada) \- souvisí s KB \- jak přeložit kategorie? FAQ: **1\. K čemu slouží pravidlo Import datového souboru?** Pravidlo slouží k **importu externích dat z XML nebo CSV souboru** do již existujících produktů v projektu Mergado. Můžete tak obohatit feed o informace, které původní zdroj neobsahuje – např. **skladovou dostupnost, marži, nákupní cenu, výkonnostní statistiky nebo dynamické štítky pro PPC kampaně**. **2\. Jaké formáty souborů Mergado podporuje?** * **XML** (např. Heureka dostupnostní feed) * **CSV** (např. tabulkový export z interního systému nebo ERP) * **Google Sheets**, pokud je publikovaný jako CSV na veřejné URL adrese 💡 Maximální velikost nahraného souboru je 25 MB. **3\. Jaký je rozdíl mezi nahráním souboru a zadáním URL adresy?** * **Nahrání souboru (upload)** – jednorázový import. Pokud se data v souboru změní, je potřeba soubor ručně nahrát znovu. * **Zadání URL adresy** – dynamické napojení. Při každém **přegenerování projektu** se automaticky načtou aktuální hodnoty z externího souboru. * 💡 Doporučeno pro datové zdroje, které se pravidelně aktualizují (např. dostupnost, ceny, výkonnost). --- **4\. Co znamená „Element ohraničující položku“ u XML importu?** Tento prvek určuje, **který XML uzel představuje jednotlivý produkt**. Např. v Heureka feedu je to `SHOPITEM`, v jiných XML feedech to může být `ITEM` nebo `PRODUCT`. V Mergadu se zapisuje i s kořenovým elementem, např.: `item_list | item`. **5\. Jak probíhá párování produktů mezi importovaným souborem a projektem?** Pomocí **párovacích elementů**: * V aktuálním projektu vyberete element, podle kterého se mají produkty párovat (např. `g:id`). * V importovaném souboru vyberete odpovídající element nebo atribut (např. `@id`). 💡 Ideální je, když hodnoty těchto elementů **jsou jedinečné a shodné** mezi projektem a souborem. **6\. Jaký je rozdíl mezi režimem „Klíč se shoduje“ a „Klíč je obsažen“?** * **Klíč se shoduje** – hodnoty párovacích elementů musí být naprosto stejné (`123 = 123`). Používá se např. při párování podle ID produktů. * **Klíč je obsažen** – párování probíhá, pokud se hodnota v párovacím elementu z importu nachází **uvnitř hodnoty v párovacím elementu v projektu** (např. `123` je obsažen v `SKU_12345`). Vhodné pro párování podle části textu (např. názvu nebo kategorie). **7\. K čemu slouží volba „Párovat podle vstupních hodnot“?** Tato volba určuje, zda Mergado bude při párování používat: * **vstupní hodnoty** ze zdrojového feedu (výchozí nastavení), nebo * **hodnoty po aplikaci pravidel** (pokud volbu vypnete). 💡 Doporučuje se ponechat zapnuté – párování je pak stabilnější a rychlejší. Vypnutí může zpomalit generování projektu. Pozor ale na to, zda **zvolený párovací element z projektu má vstupní hodnoty**. Pokud nemá, je třeba tuto volbu vypnout, jinak párování nebude fungovat **8\. Co znamená možnost „Rozlišovat velikost písmen“ v pokročilém nastavení?** Pokud je volba aktivní, párování bere ohled na rozdíl mezi malými a velkými písmeny. Např. `ABC` ≠ `Abc`. Pokud ji necháte vypnutou (doporučeno), Mergado ignoruje rozdíl mezi velikostí písmen. **9\. Co se stane, pokud některý element z importovaného souboru v projektu neexistuje?** Import nebude fungovat, dokud si daný element v projektu **nevytvoříte ručně** (se stejným názvem). Na stránce **„Elementy“** klikněte na **„Nový element“**, zadejte název (např. `availability`) a potvrďte. Element může být i **skrytý** – viditelnost neovlivňuje import. **10\. Mohu importovat více hodnot najednou (např. dostupnost, cenu a EAN)?** Ano. Pravidlo „Import datového souboru“ umožňuje import více sloupců (CSV) nebo elementů (XML) současně, pokud jsou správně mapovány. **11\. Jak mohu import využít pro data z Google Sheets?** 1. V Google Sheets klikněte na **Soubor → Sdílet → Publikovat na webu**. 2. Vyberte formát **CSV** a zkopírujte vygenerovanou URL. 3. Tuto URL vložte do pole **„URL adresa“** v pravidle Import datového souboru. 4. Při každém přegenerování Mergado načte aktuální data ze Sheetu. 💡 Tímto způsobem lze napojit např. dynamické štítky, výkonnostní data nebo denní ceny. **12\. Jak zkontroluji, že se data správně importovala?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** můžete: * otevřít stránku **Produkty**, najít konkrétní produkt a ověřit, že se nová data objevila v příslušných elementech, * nebo použít funkci **Průchod pravidly**, která zobrazí, jak byla data napárována a načtena. 💡 Pokud se hodnoty neimportovaly, zkontrolujte názvy elementů a párovací klíče. **13\. Dá se pravidlo použít i pro jednorázový import dat?** Ano. Pro jednorázové doplnění (např. EAN kódů nebo GPSR údajů) stačí soubor nahrát ručně. Pravidlo ale v projektu musí zůstat, jinak se nahraná data opět smažou. **14\. Lze pomocí pravidla importovat i výkonnostní data z Google Analytics nebo jiných nástrojů?** Ano, pokud máte data dostupná v CSV (nebo XML) formátu. Alternativním řešením je využít rozšíření Bidding Fox Elements, které tato data do Mergada načítá automaticky. Například můžete importovat počty kliků, zobrazení nebo objednávek podle produktového ID. Tímto způsobem obohatíte feed o výkonnostní metriky, které lze následně využít pro optimalizaci biddingových strategií. **15\. Co dělat, když import neproběhne správně?** Zkontrolujte: 1. zda je **soubor přístupný** (URL je veřejná, nevyžaduje přihlášení), 2. že má **správné kódování UTF-8**, 3. že **názvy elementů/sloupců** odpovídají názvům v projektu, 4. a že je **párování** správně nastaveno. 💡 Pro testování můžete nahrát soubor s menším počtem položek a ověřit, zda se správně mapuje. **16\. Dá se import využít i pro automatické cenotvorby (např. marže, nákupní ceny)?** Ano. Pomocí importu lze do feedu přidat např. **nákupní ceny** nebo **marže**, které následně využijete v **pravidlech Výpočet nebo Zaokrouhlení ceny** pro dynamický pricing. V kombinaci s rozšířením **Pricing Fox** lze dokonce plně automatizovat úpravu cen. --- ## [Jak v Mergadu získat informace o historii projektu?](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/sprava-projektu-v-mergadu/jak-v-mergadu-ziskat-informace-o-historii-projektu/) # Jak v Mergadu získat informace o historii projektu? Ve vašem projektu něco nefunguje tak, jak by mělo a vy nevíte, kde se stala chyba? Děláte si analýzu vaší inzerce a chcete vědět, proč došlo k některým výkyvům? Váš e-shop spravuje více uživatelů a potřebuje zjistit, kdo a kdy nastavil některá pravidla? Chcete si nastavit přegenerování feedu podle toho, kdy je projekt stahován reklamní platformou, aby vaše data byla vždy co nejaktuálnější? Všechny důležité informace o událostech a změnách ve feedu v konkrétním projektu najdete na stránce *Historie*. Snadno tak například odhalíte, kde se stala nějaká chyba nebo můžete informace využít k analýze a další práci na projektu. Hledané informace si můžete filtrovat na základě typu události (např. import produktů, aplikování pravidel, stahování, zapnutí rozšíření, výběry a další), datumu nebo uživatele, který změnu provedl. Každou událost je možné kliknutím na šipku vpravo rozkliknout a získat další detaily. Celou *Historii* projektu jde stáhnout do CSV souboru, který můžete použít například pro analýzu mimo Mergado. ## Jaké informace najdu v Historii projektu Zjistíte, kdy byl projekt založený, kdy byl vypnutý nebo znovu zapnutý, kdy se aplikovala pravidla, kdo je vytvořil, kdy byl přegenerován nebo kdy byly importovány či exportovány produkty. Uvidíte, kdy si vaše data stáhl jiný člověk nebo reklamní platforma, a najdete tam také IP adresu stahujícího nebo tzv. UserAgenta a mnoho dalších informací. ## Jaké informace v Historii projektu nejsou V Historii projektu se neuchovávají informace o importovaných hodnotách. Nezjistíte tam tedy, kdy a jaké hodnoty se importovaly do konkrétních elementů. ## Jak zobrazit historii produktu 1. Na stránce *Detaily uživatele* ve svém účtu klikněte na e-shop, kde se nachází projekt, jehož historii si chcete prohlédnout. 2. Klikněte na vybraný projekt. 3. Na levém panelu stránky klikněte na záložku *Historie*. 4. Zde si můžete prohlédnout kompletní historii událostí a změn v projektu. 5. Podle potřeby můžete historii filtrovat na základě typu události, datumu nebo uživatele, který změny provedl. ## FAQ: Jak v Mergadu získat informace o historii projektu? ### Kde najdu podrobnosti o změnách a událostech v projektu? Informace o provedených změnách a událostech v projektu najdete na stránce *Historie*. Ve vašem účtu přejděte na stránku *Detaily uživatele*, klikněte na e-shop, ve kterém se vybraný projekt nachází, a následně na samotný projekt, jehož historii si chcete prohlédnout. Na levém panelu stránky projektu klikněte na záložku *Historie* a zobrazí se vám kompletní seznam událostí a změn. ### Co najdu v Historii projektu? *Historie* projektu zobrazuje všechny důležité události a změny, jako je založení projektu, vypnutí/zapnutí, aplikace pravidel, import/export produktů, stahování dat a mnoho dalších informací. Můžete zjistit, kdo a kdy provedl konkrétní změny a získat další podrobnosti, například o IP adrese stahujícího nebo o tzv. UserAgentovi. ### Je možné informace v Historii projektu filtrovat? Ano, v *Historii* projektu si můžete filtrovat informace podle typu události (např. import produktů, aplikování pravidel nebo stahování), datumu nebo uživatele, který změny provedl. To vám pomůže snadno najít požadované informace. ### Je možné informace o změnách v projektu stáhnout do jednoho souboru? Ano, celou historii projektu lze stáhnout do CSV souboru, který můžete využít například pro analýzu mimo Mergado. ### Jak zjistím, kdy byl projekt přegenerován nebo kdy byly importovány/exportovány produkty? Tyto a mnoho dalších informací získáte na stránce *Historie*. Najdete tam konkrétní datum a čas, kdy byly provedeny importy nebo exporty produktů, kdy došlo k přegenerování projektu nebo třeba kdy byla aplikována pravidla a kdo je vytvořil. ### Můžu zjistit, kdy a jaké hodnoty byly importovány do konkrétních elementů? Ne, tyto informace bohužel v *Historii* projektu nezískáte. --- ## [Pravidlo: Nastavit UTM parametry](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-nastavit-utm-parametry/) # Pravidlo: Nastavit UTM parametry ## **Pravidlo: Nastavit UTM parametry** Toto pravidlo je vhodné pro e-shopy, které chtějí měřit výkon kampaní v Google Analytics nebo jiných analytických nástrojích. **Zdroje** * [Nastavit UTM parametry | Mergado Fórum](https://forum.mergado.cz/t/nastavit-utm-parametry/1981) **Extra funkce** * Povolit diakritiku pro hodnoty * Do všech polí lze vložit text i proměnnou **Konkrétní příklady** Příklad 1: Doplnit UTM parametry do URL produktů pro měření návštěvnosti * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavit UTM parametry**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, u kterého chcete provést změnu. * V našem případě to bude element s (například: g:link, URL, atd) * **Vyplňte pole pro specifikace kampaň (pole nejsou povinné)** * V každém parametru můžete použít nejen pevné hodnoty (text), ale také proměnné, které vám umožní dynamicky generovat hodnoty pro každý produkt. * **utm\_id** – unikátní ID kampaně, například: `123` * **utm\_source** – identifikace zdroje návštěvnosti, například: `Google` * **utm\_medium** – marketingové médium, například: `cpc`, `email` * **utm\_campaign** – název kampaně, například: `letni_vyprodej_2025` * **utm\_source\_platform** – multiplatformní reklamní sítě, například: `instagram_ads` * **utm\_content** – slouží k odlišení odkazů, například: `tlačítko_sleva` * **utm\_term** – klíčové slovo použité v reklamě, například: `produkt-xyz` * **Checkbox “Povolit diakritiku”** * Zaškrtněte, pokud chcete v parametrech použít diakritiku. V opačném případě je Mergado nepoužije * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla. Příklad 2: Doplnit do UTM parametrů hodnotu jiných elementů, například: hodnotu z `custom_label` * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavit UTM parametry**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, u kterého chcete provést změnu. * V našem případě to bude element s (například: g:link, URL, atd) * **Vyplňte pole pro specifikace kampaň (pole nejsou povinné)** * V každém parametru můžete použít nejen pevné hodnoty (text), ale také proměnné, které vám umožní dynamicky generovat hodnoty pro každý produkt. * **utm\_id –** unikátní ID kampaně. Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%id%`. * **utm\_source** – identifikace zdroje návštěvnosti. Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%source%`. * **utm\_medium** – marketingové médium (např. cpc, email). Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%medium%` * **utm\_campaign** – název kampaně. Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%campaign%`. * **utm\_source\_platform** – multiplatformní reklamní sítě. Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%source_platform%`. * **utm\_content –** rozlišení odkazů (např. tlačítko, banner, text). Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%content%`. * **utm\_term –** klíčové slovo použité v reklamě. Použijte hodnotu jiného elementu zadáním jeho cesty, například: `%term%`. * **Checkbox “Povolit diakritiku”** * Zaškrtněte, pokud chcete v parametrech použít diakritiku. V opačném případě je Mergado nepoužije * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla. FAQ: **1\. K čemu slouží pravidlo Nastavit UTM parametry?** Pravidlo slouží k **automatickému přidávání UTM parametrů do URL adres produktů**. Pomáhá e-shopům sledovat výkon kampaní v **Google Analytics, GA4, Sklik, Meta Ads** a dalších nástrojích. Lze ho použít pro všechny produkty nebo jen pro vybrané výběry. **2\. Jaké UTM parametry mohu nastavit?** Pravidlo podporuje všechny běžné parametry: * `utm_id` – unikátní ID kampaně, např. `123` * `utm_source` – zdroj návštěvnosti, např. `Google`, `Facebook` * `utm_medium` – marketingové médium, např. `cpc`, `email` * `utm_campaign` – název kampaně, např. `letni_vyprodej_2025` * `utm_source_platform` – platforma, např. `instagram_ads` * `utm_content` – rozlišení odkazu, např. `tlačítko_sleva`, `banner` * `utm_term` – klíčové slovo v kampani, např. `produkt-xyz` **3\. Mohu v UTM parametrech použít proměnné?** Ano. V každém poli můžete místo textu zadat **proměnnou** – např.: `%id%`, `%source%`, `%medium%`, `%campaign%`, `%content%`. Tím se parametry dynamicky doplní hodnotami z jiných elementů. 💡 Například: `utm_campaign = %custom_label_0%` → Mergado doplní hodnotu z elementu `custom_label_0`. **4\. Co se stane, když je proměnná prázdná?** Pokud je proměnná prázdná, Mergado příslušný UTM parametr do URL **nepřidá**. 💡 Pokud ale prázdná proměnná leží mezi dvěma jinými hodnotami, mohou ve výsledku zůstat **dvojité mezery nebo prázdné znaky**. V takovém případě doporučujeme následně použít pravidlo **Najít a nahradit** s hledaným výrazem `\s{2,}` (dvě a více mezer) a nahradit ho jednou mezerou. **5\. Jak se UTM parametry přidávají k URL adresám?** Mergado automaticky rozpozná, zda URL již obsahuje otazník `?`: * pokud **neobsahuje**, přidá parametry ve tvaru `?utm_source=...`, * pokud **obsahuje**, přidá nové parametry pomocí `&utm_medium=...`. Tím zajistí, že výsledná URL zůstane platná. **6\. Mohu povolit použití diakritiky v parametrech?** Ano. Zaškrtnutím volby **„Povolit diakritiku“** můžete ponechat diakritiku v hodnotách parametrů. Pokud tuto volbu necháte vypnutou (doporučeno), Mergado všechny znaky automaticky převede na **ASCII bez diakritiky**, např.: `křenová` → `krenova`. **7\. Co když chci přidat UTM parametry jen pro část produktů (např. jen pro výběr „Letní akce“)?** Stačí v poli **„Výběr“** vybrat příslušný produktový výběr (např. `Letní_akce`) – UTM parametry se pak aplikují pouze na produkty v tomto výběru. Ostatní produkty zůstanou beze změny. **8\. Co když už URL obsahuje jiné UTM parametry?** Pokud URL již obsahuje UTM parametry, Mergado nové hodnoty **nepřidá znovu**, ale **přepíše existující**. Tím se zabrání duplicitám a zachová čistá URL struktura. **9\. Lze pravidlo použít i pro jiné analytické systémy než Google Analytics?** Ano. UTM parametry jsou standardní napříč systémy. Můžete je použít také pro **GA4, Meta Ads, Sklik, TikTok Ads, Heureka měření konverzí** apod. Stačí zvolit odpovídající hodnoty v polích parametrů. **10\. Jak poznám, že se pravidlo správně aplikovalo?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** zkontrolujte výsledek: * v **náhledu produktu** (element URL), nebo * pomocí funkce **Průchod pravidly**, kde vidíte, jak se parametry k URL přidaly. 💡 Doporučuje se také test pomocí **UTM builderu** nebo **Google Campaign URL Builder** pro ověření správné syntaxe. **11\. Dá se pravidlo kombinovat s jinými pravidly?** Ano, často se používá spolu s: * **Přepsat** – pro úpravu samotné URL před přidáním UTM parametrů, * **Najít a nahradit** – pro čištění URL od nežádoucích znaků, * **Odstranit diakritiku** – pokud exportní platforma neumožňuje diakritiku v odkazech. **12\. Mohu pravidlo naplánovat (např. pro krátkodobé kampaně)?** Ano. Pomocí **časovače** můžete určit období, kdy má být pravidlo aktivní – např. během trvání konkrétní marketingové kampaně. Po skončení období se parametry přestanou přidávat. --- ## [Pravidlo: Skrytí produktů](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-skryti-produktu/) # Pravidlo: Skrytí produktů ## **Pravidlo: Skrytí produktů** Toto pravidlo zcela skryje produkt na výstupu z Mergada. **Zdroje** * [Skrytí produktů | Mergado Fórum](https://forum.mergado.cz/t/skryti-produktu/1987) **Extra funkce** * Pravidlo je specifické v tom, oproti dalších pravidel, že nevyžaduje aplikovaní pravidel, ale v rámci Mergada skryje produkty okamžitě. Na výstupní feed to vliv ale nemá. Pro skrytí produktů i z výstupního feedu potřebujete feed přegenerovat. * Další specifikum je, že skrývací pravidla se řadí vždy na konec seznamu vytvořených pravidel, tím pádem se aplikují jako poslední. **Konkrétní příklady** **Příklad 1**: Skrýt všechny produkty na výstupu (například: sezónní zboží) Tento příklad ukazuje, jak dočasně skrýt všechny produkty z výstupního feedu, * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Skrýt produkty**. * **Výběr produktů ke skrytí**: * V poli **Výběr** zvolte výběr **Všechny produkty**. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například Skrýt produkty. **Příklad 2**: Skrýt produkty s nízkou marží, vyprodané, příliš levné apod. Tento příklad ukazuje, jak skrýt levné produkty z výstupního feedu, * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Skrýt produkty**. * **Výběr produktů**: * V poli **Výběr** vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít, např. produkty levnější než 200 Kč (`g:price < 500)` * **💡Tip**: V poli výběr můžete přidat více výběrů najednou. Skrývací pravidlo se pak bude aplikovat na všechny vybrané výběry. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například Skrýt levné produkty. **Příklad 3**: Skrýt produkty bez obrázků. Tento příklad ukazuje, jak z výstupního feedu skrýt produkty, kterým chybí URL obrázku. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Skrýt produkty**. * **Výběr produktů**: * V poli **Výběr** vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít, např. produkty, kterým chybí URL obrázku (`g:image_link = “”)` * **💡Tip**: V poli výběr můžete přidat více výběrů najednou. Skrývací pravidlo se pak bude aplikovat na všechny vybrané výběry. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například Skrýt produkty, kterým chybí URL obrázku. **Další využití pravidla** * Skrýt produkty s nedostupnými nebo nekvalitními obrázky (je potřeba využít rozšíření Feed Image Editor pro detekci nedostupných/nekvalitních obrázků) FAQ: **1\. K čemu slouží pravidlo Skrýt produkty?** Pravidlo umožňuje **dočasně nebo trvale skrýt produkty** z výstupního feedu. Skrytý produkt se: * **nepřestane zobrazovat v rozhraní Mergada**, jen bude označený jako skrytý * **neexportuje do výstupního feedu** (po přegenerování feedu). Používá se pro filtrování sezónního zboží, nedostupných produktů, testovacích položek nebo produktů s chybějícími daty. **2\. Jak rychle se pravidlo projeví?** Okamžitě. Na rozdíl od jiných pravidel **nevyžaduje aplikaci pravidel** – produkty se v rozhraní Mergada skryjí ihned po uložení. 💡 Aby se změna projevila i ve **výstupním feedu**, je nutné projekt **přegenerovat**. **3\. V jakém pořadí se skrývací pravidla aplikují?** Skrývací pravidla se vždy řadí **automaticky na konec seznamu pravidel**. Tím je zajištěno, že se aplikují **až po všech ostatních pravidlech** (např. po úpravách názvů, cen apod.). 💡 Na již skryté produkty se nové změny neaplikují. **4\. Dá se pravidlo použít jen na určitou skupinu produktů?** Ano. V poli **„Výběr**“ můžete: * vybrat některý z existujících výběrů, nebo * vytvořit **vlastní Produktový výběr**, například: * produkty s cenou \< 200 Kč (`g:price < 200`), * produkty bez obrázku (`g:image_link = ""`), * produkty s dostupností `out_of_stock`. 💡 Můžete přidat i více výběrů najednou – pravidlo se pak aplikuje na všechny. **5\. Jak poznám, že je produkt skrytý?** Skrytý produkt se v Mergadu označí ikonou a hláškou **„produkt je skrytý pravidlem“** ale nezmizí ze seznamu produktů. Při práci s katalogem produktů doporučujeme používat filtr v horní části stránky **„Zobrazit \- viditelné (**v katalogu uvidíte **pouze NEskryté produkty)“** nebo naopak **„Zobrazit \- skryté (**v katalogu uvidíte **pouze skryté produkty)“**. **6\. Dá se skrytí zrušit?** Ano Můžete: * **dočasně pozastavit** samotné skrývací pravidlo, nebo * ho **smazat trvale** – tím se všechny skryté produkty znovu objeví ve feedu. Pokud chcete odkrýt pouze vybrané produkty, postupujte následovně: 1. Otevřete stránku „Produkty“. 2. Zapněte filtr „Zobrazit skryté produkty“, nebo produkt vyhledejte ručně. 3. Vpravo u produktu klikněte na ikonu oka 👁️. ➡️ Produkt se okamžitě znovu zobrazí v Mergadu a po přegenerování feedu i ve výstupním souboru. **7\. Má skrytí produktu vliv na ostatní pravidla?** Ne. Skrývací pravidla se aplikují až po všech ostatních úpravách, takže žádná jiná pravidla (např. Přepsat, Výpočet, Zaokrouhlit cenu) už nemají na skrytý produkt vliv. **8\. Lze pravidlo využít pro automatické skrývání podle dat (např. dostupnosti)?** Ano. Stačí vytvořit **podmíněný Produktový výběr** – např.: `availability = out_of_stock` a tento výběr použít v pravidle **Skrýt produkty**. Při každém přegenerování feedu Mergado automaticky skryje produkty, které odpovídají dané podmínce. **9\. Dá se pravidlo naplánovat pomocí časovače (např. skrýt zboží jen o víkendu)?** Ano. V dolní části stránky můžete aktivovat **časovač** a nastavit, kdy má být pravidlo aktivní. Například: * Pátek–Neděle → skrýt produkty (výprodej ukončen), * Pondělí–Čtvrtek → produkty opět zobrazit. **10\. Jak zjistím, že se produkty skryly i ve výstupním feedu?** Po **přegenerování feedu** můžete výsledek ověřit: * otevřením výstupního XML/CSV souboru, nebo * pomocí náhledu v Mergadu – skryté produkty se zde nezobrazí. **11\. Dá se skrývací pravidlo kombinovat s jinými (např. Přepsat, Výpočet)?** Ano, ale pouze v opačném pořadí. Skrývací pravidla se aplikují **vždy jako poslední** – po všech úpravách, výpočtech a přepisech. Tím je zajištěno, že se skrytí produktu neovlivní jinými pravidly. **12\. Jak poznám, které pravidlo skrývá můj produkt?** Na stránce produkty najděte v katalogu konkrétní produkt, např. pomocí id nebo názvu produktu. U produktu se přepněte na záložku Výběry. V seznamu jsou uvedeny všechny uložené výběry, ve kterých se produkt nachází. Vpravo je pak u každého výběru informace, zda je daný výběr použitý v nějakém skrývacím pravidle, a pokud ano tak ve kterém a rovnou se dá prokliknout na dané pravidlo. **13\. Jak jednoduše odkrýt konkrétní skrytý produkt?** Odkrývací pravidlo v Mergadu není. Jediný postup jak skrytý produkt odkrýt je vyloučit ho z výběru použitém ve skrývacím pravidle upravením podmínky výběru. Alternativou je pak ještě speciální funkce u projektu s názvem Schvalování produktů. --- ## [Pravidlo: Nastavit parametry produktů](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-nastavit-parametry-produktu/) # Pravidlo: Nastavit parametry produktů ## **Pravidlo: Nastavit parametry produktů** Toto pravidlo slouží k **nastavení parametrů produktů a jejich hodnot**. Pomocí jednoho pravidla můžete **nastavit různé parametry pro různé skupiny produktů** (na základě produktových výběrů). Pravidlo je ideální pro **automatické doplnění parametrů** jako například objem, barva, materiál nebo hmotnost. **Zdroje** * [Nastavit parametry produktů | Mergado Fórum](https://forum.mergado.cz/t/nastavit-parametry-produktu/1976) * [YouTube: Nastavení parametrů v Mergadu](https://www.youtube.com/watch?v=y0b0I8Q0KIo) **Extra funkce** * Našeptávání názvů parametrů * Hromadné kopírování hodnot například: z Google Sheets * Možnost výběru typu parametrů (textový, číselný, boolean…) * Možnost přidat více řádků **Konkrétní příklady** **Příklad 1**: Nastavit nové parametry pro všechny nebo vybrané produkty Tento příklad ukazuje, jak **hromadně a automatizovaně nastavit nové produktové parametry** různým segmentům produktů. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavit parametry produktů**. * **Volba elementu pro změnu:** * elementy, do kterých se nové parametry vloží není potřeba vybírat, Mergado je vybere samo podle zvoleného výstupního formátu projektu, například: `g:product_detail` v Google projektu * **Přidání řádků**: * Každý řádek v pravidle **Nastavit parametry produktů** má 3 sloupce: * Výběry \- umožňuje vybrat jeden či více výběrů * Parametr \- určuje název parametru, který se má nastavit. * Hodnota \- určuje hodnotu, která se parametru přiřadí. * Řádky v pravidle tak umožňují nastavit parametry pro různé segmenty produktů * **Výběry produktů**: * V levém sloupci v poli **Výběry** * ze Selectboxu vyberte existující uložené výběry produktů z projektu (každý na samostatný řádek). * **💡 Tip:** můžete vybrat jeden i více výběrů. * nebo ze Selectboxu zvolte “Vytvořit nový výběr” a vytvořte nové **Produktové výběry** pro specifické produkty, na které chcete pravidlo použít. * **Nastavení parametrů pro zvolený výběr:** * Vpravo v sloupci **Parametr** přidejte v jednotlivých polích pod sebe názvy parametrů jako textovou hodnotu, např. `Objem` * Pokud vyberete existující název parametru, hodnota se upraví. * Pokud zadáte nový název, **vznikne nový parametr**. * Vpravo v sloupci **Hodnota** přidejte v jednotlivých polích pod sebe hodnoty parametrů jako: * textovou hodnotu, například: `250 ml` * proměnnou, například: `%objem%` * kombinaci proměnné a textu, například: `%objem% ml` * **Nastavení parametrů pro další výběry:** * Opakujte předchozí kroky “**Výběry produktů”** a **“Nastavení parametrů pro zvolený výběr”** v dalším prázdném řádku * **💡 Tip:** vyplněním dalšího řádku se automaticky přidá další prázdný řádek * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení parametrů”. **Příklad 2**: Přepsat stávající parametry produktů Tento příklad ukazuje, jak hromadně a automatizovaně přepsat existující produktové parametry různým segmentům produktů. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavit parametry produktů**. * **Volba elementu pro změnu:** * elementy, ve kterých jsou stávající parametry uloženy, není potřeba vybírat, Mergado je vybere samo podle zvoleného výstupního formátu projektu, např. `g:product_detail` v Google projektu * **Přidání řádků**: * Každý řádek v pravidle **Nastavit parametry produktů** má 3 sloupce: * Výběry \- umožňuje vybrat jeden či více výběrů * Parametr \- umožňuje nastavit jeden či více parametrů pro daný řádek * Hodnota \- umožňuje nastavit hodnotu parametru pro každý parametr * Řádky v pravidle tak umožňují nastavit parametry pro různé segmenty produktů * **Výběry produktů**: * V levém sloupci v poli **Výběry** * ze Selectboxu zvolte připravené uložené výběry z projektu, každý na samostatný řádek, * **💡 Tip:** můžete vybrat jeden i více výběrů. * nebo ze Selectboxu zvolte “Vytvořit nový výběr” a vytvořte nové **Produktové výběry** pro specifické produkty, na které chcete pravidlo použít. * **Nastavení parametrů pro zvolený výběr:** * Vpravo v sloupci Parametr ze Selectboxu vyberte názvy existujících parametrů v projektu, které chcete přepsat, např. `Objem` * můžete vybrat více parametrů pro zvolený výběr, vždy jeden parametr na jeden řádek * Vpravo v sloupci Hodnota přidejte v jednotlivých polích pod sebe nové hodnoty parametrů jako: * textovou hodnotu, například: `250 ml` * proměnnou, například: `%objem%` * kombinaci proměnné a textu, například: `%objem% ml` * **Nastavení parametrů pro další výběry:** * Opakujte předchozí kroky “**Výběry produktů”** a **“Nastavení parametrů pro zvolený výběr”** v dalším prázdném řádku * **💡 Tip:** vyplněním dalšího řádku se automaticky přidá další prázdný řádek * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení parametrů”. **Příklad 2**: Odstranit všechny hodnoty parametru u produktů Tento příklad ukazuje, jak různým segmentům produktů smazat všechny hodnoty parametru a zároveň zachovat názvy parametrů. **💡 Tip:** pokud chcete **smazat jen konkrétní hodnoty parametru**, nebo **smazat celý parametr včetně názvu a hodnot parametru**, použijte pravidlo **Odstranit parametry produktů** * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavit parametry produktů**. * **Volba elementu pro změnu:** * elementy, ve kterých jsou stávající parametry uloženy, není potřeba vybírat, Mergado je vybere samo podle zvoleného výstupního formátu projektu, např. `g:product_detail` v Google projektu * **Přidání řádků**: * Každý řádek v pravidle **Nastavit parametry produktů** má 3 sloupce: * Výběry \- umožňuje vybrat jeden či více výběrů * Parametr \- umožňuje nastavit jeden či více parametrů pro daný řádek * Hodnota \- umožňuje nastavit hodnotu parametru pro každý parametr * Řádky v pravidle tak umožňují nastavit parametry pro různé segmenty produktů * **Výběry produktů**: * V levém sloupci v poli **Výběry** * ze Selectboxu zvolte připravené uložené výběry z projektu, každý na samostatný řádek, * **💡 Tip:** můžete vybrat jeden i více výběrů. * nebo ze Selectboxu zvolte “Vytvořit nový výběr” a vytvořte nové **Produktové výběry** pro specifické produkty, na které chcete pravidlo použít. * **Nastavení parametrů pro zvolený výběr:** * Vpravo v sloupci Parametr ze Selectboxu vyberte názvy existujících parametrů v projektu, kterým chcete smazat hodnoty, např. `Objem` * můžete vybrat více parametrů pro zvolený výběr, vždy jeden parametr na jeden řádek * Vpravo v sloupci Hodnota ponechte pole prázdné pro každý parametr, kterému chcete smazat hodnoty * **Nastavení parametrů pro další výběry:** * Opakujte předchozí kroky “**Výběry produktů”** a **“Nastavení parametrů pro zvolený výběr”** v dalším prázdném řádku * **💡 Tip:** vyplněním dalšího řádku se automaticky přidá další prázdný řádek * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Smazat hodnoty parametrů”. FAQ: **1\. K čemu slouží pravidlo Nastavit parametry produktů?** Pravidlo umožňuje **nastavit, upravit nebo smazat hodnoty parametrů** u produktů. Každý parametr má svůj název a hodnotu (např. *Barva \= Červená*). Lze ho využít pro: * doplnění chybějících parametrů (např. *Objem*, *Materiál*), * přepis existujících parametrů podle výběru, * mazání hodnot parametrů bez odstranění samotného názvu, * automatické doplnění hodnot pro různé segmenty produktů. **2\. Jaký je rozdíl mezi tímto pravidlem a pravidlem Odstranit parametry produktů?** * **Nastavit parametry produktů** – umí přidávat, přepisovat i mazat **hodnoty parametrů** (název zůstává zachován). * **Odstranit parametry produktů** – odstraní celý parametr včetně názvu i hodnot, případně pro konkrétní parametr umožní **odstranit vybrané hodnoty** parametru 💡 Pokud chcete jen vymazat hodnotu, ale zachovat název (např. prázdný parametr), použijte **Nastavit parametry produktů** s prázdným polem **Hodnota**. **3\. Mohu pomocí pravidla vytvořit nové parametry?** Ano. Pokud do sloupce **Parametr** zapíšete název, který v projektu ještě neexistuje, Mergado automaticky vytvoří nový parametr. Pokud naopak zvolíte existující název ze Selectboxu, hodnota bude přepsána. **4\. Jaký formát mohu použít pro hodnoty parametrů?** V poli **Hodnota** lze použít: * **textovou hodnotu** – např. `250 ml`, * **proměnnou** – např. `%volume%`, * **kombinaci proměnné a textu** – např. `%volume% ml`. 💡 Můžete tak kombinovat hodnoty z různých elementů nebo doplňovat jednotky automaticky. **5\. Jak fungují výběry produktů v tomto pravidle?** Každý řádek pravidla obsahuje tři části: * **Výběr** – definuje, na které produkty se pravidlo vztahuje, * **Parametr** – určuje, který parametr se má přidat nebo upravit, * **Hodnota** – určuje, jaká hodnota se má parametru přiřadit. Tím lze v jednom pravidle nastavit **různé parametry pro různé skupiny produktů**. **6\. Mohu přidat více parametrů pro jeden výběr?** Ano. Stačí pro stejný výběr vytvořit více řádků — každý s jiným názvem parametru a hodnotou. 💡 Po vyplnění posledního řádku se automaticky přidá nový prázdný řádek. **7\. Dá se tímto pravidlem smazat hodnota parametru?** Ano. Pokud necháte pole **Hodnota** prázdné, Mergado danému parametru odstraní jeho obsah (hodnotu), ale zachová samotný název parametru. 💡 Pokud chcete odstranit celý parametr, použijte místo toho pravidlo **Odstranit parametry produktů**. **8\. Můžu použít proměnné i v názvu parametru?** Ne. V názvu parametru lze zadat pouze **text** – proměnné se zde nepodporují. Proměnné můžete používat pouze v poli **Hodnota**. **9\. Jaký typ parametrů mohu nastavit?** Můžete vybírat z více typů: * textové (např. *Barva \= Modrá*), * číselné (např. *Hmotnost \= 250*), * boolean (např. *Dostupné \= true*). 💡 Typ parametru přizpůsobte podle výstupního formátu projektu – např. Google Merchant Center vyžaduje konkrétní formát hodnot. **10\. Dá se pravidlo použít i pro hromadné úpravy parametrů?** Ano. Pomocí checkboxu „Režim chytrého vkládání“ můžete připravit hodnoty například v Google Sheets a následně je hromadně vložit do pravidla. Mergado automaticky rozdělí jednotlivé hodnoty do odpovídajících polí podle struktury tabulky. **11\. Co když chci nastavit parametr jen pro určitou kategorii nebo značku?** Vytvořte **Produktový výběr** obsahující pouze tyto produkty (např. `CATEGORYTEXT CONTAINS "Kabelky"`). Pak pravidlo aplikujte jen na tento výběr — ostatní produkty zůstanou beze změny. **12\. Lze pravidlo kombinovat s jinými pravidly?** Ano. Nejčastější kombinace: * **Odstranit parametry produktů** – pro vyčištění parametrů před jejich novým nastavením, * **Přepsat** – pro vložení hodnot parametrů do názvů produktů, * **Změna velikosti písmen** – pro úpravu formátu textových parametrů. **13\. Jak ověřím, že se parametry nastavily správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** zkontrolujte výsledek: * v náhledu produktů, nebo * pomocí funkce **Průchod pravidly**, kde uvidíte, jaké parametry byly přidány nebo změněny. --- ## [Pravidlo: Odstranit parametry produktů](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-odstranit-parametry-produktu/) # Pravidlo: Odstranit parametry produktů ## **Pravidlo: Odstranit parametry produktů** Toto pravidlo slouží k odstranění konkrétních hodnot parametrů produktů z feedu, nebo k odstranění celého parametru včetně názvu a všech hodnot parametru. Je užitečné pro pročištění dat, kdy je potřeba odstranit nežádoucí nebo neaktuální informace. **Zdroje** * [Odstranit hodnoty parametru | Mergado Fórum](https://forum.mergado.cz/t/odstranit-hodnoty-parametru/2684) * [YouTube: Pravidla pro práci s parametry – Mergado](https://www.youtube.com/watch?v=hoET4hgjfpU&t=616s) **Extra funkce** * Našeptávání názvů parametrů * Hromadné kopírování hodnot například: z Google Sheets * Možnost výběru typu parametrů * Možnost přidat více řádků **Konkrétní příklady** **Příklad 1:** Odstranit konkrétní parametr z feedu Tento příklad ukazuje, jak odstranit hodnotu parametru z feedu, například hodnoty **Černá** a **Bílá** z parametru **Barva**. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Odstranit hodnoty parametrů**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Výběr parametru:** * V poli **Parametr** zapište, nebo vyberte ze seznamu element u které chcete odstranit parametr. * V našem případě to bude hodnota Barva. * **💡Tip**: *Pomocí **„Předvyplnit levou stranu“** můžete načíst všechny parametry daného projektu. Tento krok se v našem příkladu nehodí, protože vybíráme pouze konkrétní hodnotu.* * **Výběr hodnot k odstranění:** * V poli **„Odstranit následující hodnoty“** zadejte hodnotu, kterou chcete odstranit. * Například: **„Černá“** a **“Bílá”**. * 💡Tip: *Lze použít také proměnnou nebo kombinaci proměnné a textu.* * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Odstranit hodnoty parametru Barva”. **Příklad 2**: Odstranit všechny hodnoty parametru (Barva) z dodavatelského feedu Tento příklad ukazuje, jak odstranit **všechny hodnoty parametru Barva** z feedu, včetně názvu parametru. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Odstranit hodnoty parametrů**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Výběr Parametru:** * V poli **„Parametr“** zadejte nebo vyberte ze **Selectboxu** parametr, u kterého chcete odstranit všechny hodnoty. * V našem případě to bude **parametr “Barva“**. * **Výběr hodnot k odstranění:** * V poli **„Odstranit následující hodnoty“** není potřeba uvádět žádné konkrétní hodnoty. * Stačí zaškrtnout **selectbox „Odstranit všechny hodnoty“**, čímž odstraníte všechny hodnoty tohoto parametru. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Odstranit parametr Barva”. **Další využití pravidla** * Odstranit platební metody * Odstranit dopravce * Odstranit všechny parametry, které odkazují na dodavatele nebo jiné nežádoucí hodnoty. FAQ: **1\. K čemu slouží pravidlo Odstranit parametry produktů?** Toto pravidlo umožňuje **odstranit konkrétní hodnoty parametrů** nebo **celé parametry včetně jejich názvů a hodnot**. Používá se například pro: * odstranění neaktuálních informací (např. staré barvy, zastaralé velikosti), * vyčištění feedu od zbytečných nebo duplicitních parametrů, * odstranění parametrů dodavatelů, které nechcete exportovat do výstupních feedů. **2\. Jaký je rozdíl mezi tímto pravidlem a pravidlem Nastavit parametry produktů?** * **Odstranit parametry produktů** → smaže celý parametr nebo konkrétní hodnotu parametru. * **Nastavit parametry produktů** → umožňuje doplnit, upravit nebo smazat **pouze hodnotu** (název zůstává zachován). 💡 Pokud chcete hodnotu jen „vyčistit“, ale parametr zachovat, použijte **Nastavit parametry produktů** s prázdným polem **Hodnota**. **3\. Lze odstranit pouze vybrané hodnoty v rámci jednoho parametru?** Ano. V poli **„Odstranit následující hodnoty“** zadejte hodnoty, které chcete smazat (např. *Černá*, *Bílá*). Můžete zadat více hodnot, případně použít **proměnnou** nebo **kombinaci textu a proměnné**. **4\. Jak odstranit všechny hodnoty jednoho parametru?** Pokud chcete odstranit celý parametr včetně všech hodnot, stačí **zaškrtnout checkbox „Odstranit všechny hodnoty“**. Tím se z feedu odstraní celý parametr, například celý blok: `` `Barva` `Černá` `` ➡️ po aplikaci pravidla: parametr *Barva* v produktu už nebude vůbec uveden. **5\. Mohu tímto pravidlem odstranit více parametrů najednou?** Ano. Stačí do pravidla přidat více řádků — každý pro jeden parametr. 💡 Pomocí tlačítka **„Předvyplnit levou stranu“** můžete načíst všechny parametry projektu a pak vybrat ty, které chcete smazat. **6\. Lze tímto způsobem odstranit například dopravce nebo platební metody?** Ano. Pokud jsou dopravci nebo platební metody uloženi jako parametry (např. *Doprava \= Česká pošta*), můžete je odstranit stejným způsobem. Stačí v poli **„Parametr“** vybrat příslušný název (např. *Doprava*, *Platba*). **7\. Může pravidlo odstranit všechny parametry z celého feedu?** Ano, ale je třeba být opatrný. Pokud načtete všechny parametry pomocí **„Předvyplnit levou stranu“** a ve všech řádcích zaškrtnete **„Odstranit všechny hodnoty“**, Mergado odstraní všechny parametry ze všech produktů. **8\. Ovlivní odstranění parametrů strukturu XML feedu?** Ne. Pravidlo pracuje pouze s obsahem elementů — XML struktura zůstává platná a neporušená. Pouze se odstraní konkrétní `` bloky (včetně názvu a hodnot). **9\. Dá se pravidlo použít jen pro určitou skupinu produktů?** Ano. Můžete vytvořit **Produktový výběr** (např. podle dodavatele, značky nebo kategorie) a aplikovat pravidlo pouze na tyto produkty. Ostatní produkty zůstanou beze změny. **10\. Mohu kontrolovat, co bylo odstraněno?** Ano. Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** zkontrolujte změny na stránce Produkty, případně použijte **Průchod pravidly**. Tato funkce vám umožní porovnat původní a výslednou verzi produktu a přesně vidět, které parametry byly odstraněny. --- ## [Pravidlo: Odstranit HTML značky](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-odstranit-html-znacky/) # Pravidlo: Odstranit HTML značky ## **Pravidlo: Odstranit HTML značky** Toto pravidlo z obsahu elementu odstraní HTML značky. **Zdroje** * [Odstranit HTML značky | Mergado Fórum](https://forum.mergado.cz/t/odstranit-html-znacky/1980) **Extra funkce** * Nejsou **Konkrétní příklady:** Příklad 1: Odstranit HTML značky z popisů produktů (například: ``, ``, ``) * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Odstranit HTML značky**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, u kterého chcete provést změnu. * V našem případě to bude popis produktu (description) * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například *„Odstranit HTML znaky z elementu description“*. FAQ: **1\. K čemu slouží pravidlo Odstranit HTML značky?** Toto pravidlo odstraní všechny **HTML značky** (tagy) z obsahu vybraného elementu, například ``, ``, ``, `` apod. Používá se nejčastěji pro: * čištění popisů produktů před exportem, * přípravu textů pro platformy, které nepodporují HTML (např. Google Merchant Center), * sjednocení obsahu pro export do jednoduchých CSV nebo XML feedů bez formátování. **2\. Co přesně se z textu odstraní?** Odstraní se všechny **HTML značky** včetně jejich atributů, např.: `Nová kolekce – doprava zdarma!` ➡ Výsledek: `Nová kolekce – doprava zdarma!` Pravidlo neodstraňuje textový obsah, pouze značky. **3\. Odstraní se i HTML entity jako** ` ` **nebo &?** Ne. Pravidlo odstraňuje pouze **HTML tagy** (značky). Entity jako ` ` (nedělitelná mezera), `&` (ampersand) nebo `€` (symbol €) zůstanou zachovány. 💡 Pokud je chcete odstranit nebo nahradit, použijte následně pravidlo **Najít a nahradit**. **4\. Lze pravidlo použít i na jiné elementy než popis produktu?** Ano. Můžete ho aplikovat na libovolný textový element, například: * `g:title` – pokud do názvů pronikly HTML značky, * `custom_label_0` – pokud obsahuje formátovaný text, * nebo i `g:product_type`, pokud byl importován z HTML zdroje. **5\. Ovlivní odstranění HTML značek strukturu XML feedu?** Ne. Pravidlo pracuje **pouze s obsahem elementů**, nikoli s jejich strukturou. Vaše XML zůstane validní — Mergado nikdy neodstraní samotné XML elementy, pouze HTML kód uložený v jejich textu. **6\. Dá se pravidlo aplikovat jen na část produktů?** Ano. V poli **„Výběr“** můžete vybrat **Všechny produkty**, nebo pouze konkrétní **Produktový výběr** (například jen produkty z určité kategorie nebo dodavatele). **7\. Může pravidlo poškodit text (např. odstranit i něco, co HTML není)?** Ne. Pravidlo rozpoznává skutečné HTML značky podle syntaxe (`...`). Nevymaže text, který pouze obsahuje znaky `` bez uzavřeného HTML páru. **8\. Lze pravidlo kombinovat s jinými pravidly pro čištění textu?** Ano — to je dokonce doporučený postup. Po odstranění HTML tagů můžete použít: * **Najít a nahradit** – pro odstranění entit jako ` `, * **Odstranit diakritiku** – pro přípravu dat bez akcentů, * **Zkrácení hodnoty** – pokud potřebujete omezit délku textu po očištění. **9\. Jak zjistím, že pravidlo fungovalo správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** zkontrolujte výsledek: * v náhledu produktu, nebo * pomocí funkce **Průchod pravidly**, kde uvidíte přesně, jak byly HTML značky odstraněny z konkrétního elementu. --- ## [Pravidlo: Odstranit diakritiku](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-odstranit-diakritiku/) # Pravidlo: Odstranit diakritiku ## **Pravidlo: Odstranit diakritiku** Toto pravidlo umožňuje **odstranit diakritické znaky** (např. ě, š, č, ť, ž) z textu v elementech feedu a nahradit je jejich **latinkovými ekvivalenty** podle tabulky **ASCII**. Používá se například pro exporty, které neumožňují znaky s diakritikou, nebo pro sjednocení názvů produktů. **Zdroje** * Odtranit diakritiku **Extra funkce** * Žádné dodatečné funkce **Konkrétní příklady:** Příklad 1: Odstranit diakritiku z názvu nebo popisu produktu 1. **Vytvoření nového pravidla**: 1. Otevřete stránku "Pravidla". 2. Klikněte na tlačítko **Nové pravidlo**. 2. **Výběr typu pravidla**: 1. V poli **Typ pravidla** vyberte možnost **Odstranit diakritiku**. 3. **Výběr produktů**: 1. V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. 4. **Volba elementu pro změnu**: 1. V poli **Element** vyberte element, u kterého chcete provést změnu. 1. V našem případě to bude buď element s názvem (například: g:title, Productname, name\_Exact) nebo popis produktu (description) 5. **Pojmenování pravidla**: 1. V posledním kroku Zadejte název pravidla, například *„Odstranit diakritiku z názvu produktu“*. FAQ: **1\. K čemu slouží pravidlo Odstranit diakritiku?** Toto pravidlo převádí všechny znaky s diakritikou (např. *ě, š, č, ř, ť, ž*) na jejich **ASCII ekvivalenty** (*e, s, c, r, t, z*). Používá se především: * při exportu feedů do systémů, které nepodporují znaky s diakritikou, * pro sjednocení názvů produktů nebo URL adres, * při přípravě dat pro porovnání, filtrování nebo párování. **2\. Jaký je výsledek po aplikování pravidla?** Například: * *Červené tričko s nápisem* → *Cervene tricko s napisem* * *Dámská kabelka Žofie* → *Damska kabelka Zofie* * *Zboží.cz – Pánská obuv Šimon* → *Zbozi.cz – Panska obuv Simon* **3\. Na jaké elementy mohu pravidlo použít?** Na jakýkoli textový element v projektu, například: * názvy produktů (`g:title`, `product_name`, `name_Exact`), * popisy (`description`), * značky (`brand`), * kategorie (`product_type`). 💡 Tip: Nejčastější použití je pro názvy a popisy produktů při exportu na zahraniční trhy. **4\. Lze pravidlo použít i na parametry produktu?** Ano. Stačí v poli **„Element“** vybrat element `PARAM | PARAM_VALUE`. Pravidlo pak odstraní diakritiku i z názvů nebo hodnot parametrů. **5\. Ovlivní odstranění diakritiky strukturu HTML kódu nebo speciální znaky (např. &)?** Ne. Pravidlo pracuje pouze s **běžnými písmeny abecedy** a **diakritikou**. HTML značky, entity (``, `&`, ` ` apod.) ani číslice zůstanou nedotčené. **6\. Mohu použít pravidlo i na URL adresy?** Ano, ale s opatrností. Při odstranění diakritiky se znaky převedou do základní latinky, ale **mezery a speciální znaky zůstanou zachovány**. Doporučuje se kombinovat toto pravidlo s pravidlem **Najít a nahradit** (např. pro nahrazení mezer pomlčkami nebo odstranění nedovolených znaků). **7\. Lze pravidlo aplikovat jen na vybrané produkty?** Ano. Můžete vytvořit **vlastní Produktový výběr** (např. podle jazyka nebo kategorie) a pravidlo aplikovat pouze na něj. Například: odstranit diakritiku jen u produktů exportovaných do zahraničí. **8\. Dá se pravidlo použít opakovaně?** Ano. Pravidlo lze aplikovat v jakékoliv fázi úpravy feedu — i opakovaně, například po doplnění nových dat nebo po importu externího souboru. Stačí adekvátně upravit pořadí pravidel. Pokud text už neobsahuje diakritiku, pravidlo žádné změny neprovede. **9\. Mohu kontrolovat výsledek před exportem?** Ano. Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** zkontrolujte výsledek: * v náhledu produktu, nebo * pomocí funkce **Průchod pravidly**, kde uvidíte přesně, jak se text změnil po odstranění diakritiky. **10\. Lze pravidlo kombinovat s jinými pravidly?** Ano. Nejčastěji se kombinuje s: * **Najít a nahradit** – pro dodatečné odstranění mezer nebo speciálních znaků, * **Přepsat** – pro doplnění upraveného textu do jiného elementu, --- ## [Pravidlo: Změna velikosti písmen](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-zmena-velikosti-pismen/) # Pravidlo: Změna velikosti písmen ## **Pravidlo: Změna velikosti písmen** Toto pravidlo umožňuje upravit velikost písmen v elementech feedu. Lze například přepsat názvy produktů z velkých písmen na normální, nebo sjednotit formát písmen v parametrech. **Zdroje** * [Změna velikosti písmen | Mergado Fórum](https://forum.mergado.cz/t/zmena-velikosti-pismen/1983) **Extra funkce** Možnost **výběru ze 6 variant** velikosti písmen: * vše malými písmeny * VŠE VELKÝMI PÍSMENY * Velká písmena na začátcích vět * Velká Písmena Na Začátcích Slov * Velké první písmeno, zbytek ponechat * Pouze první písmeno velké u slov s více než dvěma znaky **Konkrétní příklady** Příklad 1: Přepsat produktové názvy napsané velkými písmeny Tento příklad ukazuje, jak změnit velikost písmen v názvech produktů. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Změna velikosti písmen**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, do kterého chcete zapsat výsledek zkrácení. * V našem případě to bude element: `g:title` * **Zvolte velikost písmen** * V poli **Velikost písmen** vyberte požadovanou variantu. * V našem případě zvolíme **„Velká písmena na začátcích vět“.** * **Pojmenování pravidla**: * *V posledním kroku zadejte **název pravidla**, například „Změna velikosti písmen v názvu“.* Příklad 2: Změnit velikost písmen u parametrů pro další využití (například: přidání do produktových názvů) Tento příklad ukazuje, jak změnit velikost písmen v hodnotách parametrů, aby bylo možné je dále přidat do produktových názvu. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Změna velikosti písmen**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, do kterého chcete zapsat výsledek zkrácení. * V našem případě to bude element: `PARAM | PARAM_VALUE` * **Zvolte velikost písmen** * V poli **Velikost písmen** vyberte požadovanou variantu. * V našem případě zvolíme **„vše malými písmeny“.** * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například *„Změna velikosti písmen u parametrů“*. * **💡 Tip:** Upravené parametry můžete následně použít pro rozšíření produktových názvů pomocí pravidla **„Přepsat**“. **Další využití pravidla** * Upravit texty v popiscích produktů na **všechna malá písmena**. * Sjednotit písmena v parametrech nebo názvech pro **konsistentní export do různých feedů**. FAQ: **1\. K čemu slouží pravidlo Změna velikosti písmen?** Pravidlo umožňuje **sjednotit formát textu** v libovolném elementu feedu. Lze ho využít např. pro: * úpravu názvů produktů psaných VELKÝMI PÍSMENY, * převod textů v popisech na malá písmena, * sjednocení formátu parametrů nebo značek, * přípravu textů pro následné využití (např. v pravidle „Přepsat“). **2\. Jaké varianty velikosti písmen mohu zvolit?** V poli **„Velikost písmen“** lze vybrat jednu z těchto 6 možností: 1. **vše malými písmeny** – např. *nike air zoom*, 2. **VŠE VELKÝMI PÍSMENY** – např. *NIKE AIR ZOOM*, 3. **Velká písmena na začátcích vět** – např. *Nike air zoom je oblíbený model.*, 4. **Velká Písmena Na Začátcích Slov** – např. *Nike Air Zoom Pegasus*, 5. **Velké první písmeno, zbytek ponechat** – zachová původní formát po prvním písmenu, 6. **Pouze první písmeno velké u slov s více než dvěma znaky** – vhodné pro korekci textů s přehnanou kapitalizací. **3\. Mohu tímto pravidlem opravit názvy psané celými velkými písmeny?** Ano. Stačí v poli **„Velikost písmen“** vybrat možnost **„Velká písmena na začátcích vět“** nebo **„Velká Písmena Na Začátcích Slov“**. Mergado automaticky převede texty do běžného čitelného formátu (např. *ADIDAS TENISKY BÍLÉ* → *Adidas tenisky bílé*). **4\. Dá se pravidlo použít i na parametry produktů?** Ano. V poli **„Element“** vyberte například `PARAM | PARAM_VALUE`. Tím můžete hromadně upravit formát názvů parametrů, které pak snadno přidáte do názvů produktů pomocí pravidla **„Přepsat“**. **5\. Ovlivní změna velikosti písmen i hodnoty jako EAN nebo ID produktu?** Ne. Pravidlo **nemění číselné hodnoty** ani kódy, pouze textové řetězce. Použití na pole obsahující identifikátory (např. EAN, SKU, ID) se nedoporučuje. **6\. Mohu pravidlo aplikovat jen na část textu (např. první slovo)?** Ne přímo. Pravidlo mění velikost písmen v rámci celého obsahu elementu. Pokud potřebujete změnit velikost jen části textu, rozdělte data do více elementů nebo použijte pravidlo **„Najít a nahradit“** s regulárními výrazy. **7\. Co když potřebuji různé formáty písmen pro různé výběry produktů?** Vytvořte více pravidel „Změna velikosti písmen“ a každé aplikujte na jiný **Produktový výběr**. Např. * u značek: *Velká Písmena Na Začátcích Slov*, * u popisů: *vše malými písmeny*. **8\. Lze pravidlo použít i pro SEO optimalizaci (např. sjednocení značek)?** Ano. Pomocí tohoto pravidla můžete sjednotit formát značek, názvů nebo kategorií, což přispívá ke konzistenci dat v exportech a lepší indexaci produktů ve vyhledávačích. **9\. Jak poznám, že se pravidlo správně aplikovalo?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** zkontrolujte výsledek: * v náhledu produktu, nebo * pomocí funkce **Průchod pravidly**, kde vidíte přesně, jak se text změnil. **10\. Dá se pravidlo kombinovat s jinými pravidly?** Ano, velmi často se používá spolu s: * **Přepsat** – pro doplnění přeformátovaných parametrů do názvů, * **Najít a nahradit** – pro odstranění zbytečných částí před úpravou, * **Zkrácení hodnoty** – pro následné oříznutí textu na požadovanou délku. --- ## [Pravidlo: Zkrácení hodnoty](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-zkraceni-hodnoty/) # Pravidlo: Zkrácení hodnoty ## **Pravidlo: Zkrácení hodnoty** Toto pravidlo umožňuje zkrátit obsah elementu na stanovenou délku. Je užitečné, když potřebujete omezit délku textu v polích jako description, title, nebo pro optimalizaci zobrazení na různých platformách. **Zdroje** * [Zkrácení hodnoty | Mergado Fórum](https://forum.mergado.cz/t/zkraceni-hodnoty/1984) **Extra funkce** * Zkrácení hodnot na zvolený počet znaků * Při zkrácení lze doplnit vlastní text (například: "... více na e-shopu") * Snaha nerozdělovat slova a závorky * Odstranění jednopísmenných předložek a spojek na konci **Konkrétní příklady:** **Příklad 1:** Zkrátit délku elementu s popisem (description) na 5000 znaků Tento příklad ukazuje, jak zkrátit text v elementu (např. description, title, url) na stanovený počet znaků, aby splnil požadavky pro exporty nebo zobrazování na platformách. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Zkrácení hodnoty**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, do kterého chcete zapsat výsledek zkrácení. * V našem případě to bude element `description` * **Zadejte maximální délku** * V poli **Maximální délka** zadejte požadovanou maximální délku textu, například: 5000 znaků. * **Zadejte text při zkrácení** * V poli „Při zkrácení doplnit…“ zadejte text, který se přidá na konec zkráceného textu, například: „… další informace na webu“. * Tento text bude připojen, ale nikdy nebudete překračovat maximální délku. * **Nastavení dalších možností** * **Pokud možno nerozdělovat slova a závorky:** Tato volba je defaultně povolená, což znamená, že pravidlo se pokusí nezkracovat text na půlce slova nebo ve špatném místě. * **Odstranit zbylé jednopísmenné předložky a spojky**: Tato volba je defaultně povolená a zajistí, že z textu zmizí jednopísmenné předložky, jako „a“, „v“, „k“, pokud se objeví na konci textu. * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například: “*Zkrácení popisu na 5000 znaků”.* **Další využití pravidla** * Zkrátit délku názvů produktů na 150 znaků. * Zkrácení URL pro Heureku na 300 znaků max. FAQ: **1\. K čemu slouží pravidlo Zkrácení hodnoty?** Toto pravidlo umožňuje **zkrátit délku textu** v libovolném elementu na zvolený počet znaků. Používá se např. pro úpravu: * příliš dlouhých popisů produktů, * názvů (title) pro zbožové srovnávače, * URL adres nebo metapopisů, aby splňovaly limity konkrétní platformy (např. Heureka, Google, Zboží.cz apod.). **2\. Mohu při zkrácení přidat text, například „… více na webu“?** Ano. V poli **„Při zkrácení doplnit…“** můžete zadat libovolný text (např. `… více na e-shopu`). Tento text se automaticky přidá na konec zkráceného textu, **aniž by překročil maximální délku**, kterou jste nastavili. **3\. Jak funguje volba „Pokud možno nerozdělovat slova a závorky“?** Tato volba je **defaultně zapnutá**. Při zkracování Mergado automaticky kontroluje, aby nedošlo k rozdělení slova uprostřed nebo k odříznutí závorky. Výsledkem je čitelnější text i při omezení délky. **4\. Co dělá volba „Odstranit zbylé jednopísmenné předložky a spojky“?** Tato funkce odstraní **jednopísmenné předložky** a **spojky** (např. *a, v, k, s, z*), pokud by po zkrácení zůstaly na konci textu. Výsledek pak působí přirozeněji a vizuálně čistěji. **5\. Jak mohu určit maximální délku textu?** Do pole **„Maximální délka“** zadejte počet znaků, který text nemá překročit — např. `5000`. Započítávají se i mezery a doplňkový text (např. `… více na webu`). **6\. Co se stane, pokud je text kratší než nastavený limit?** Pokud text nepřekročí zadaný počet znaků, **pravidlo se neaplikuje** a hodnota elementu zůstane beze změny. **7\. Lze tímto pravidlem zkrátit i URL adresy nebo HTML kód?** Ano, ale s opatrností. Zkrácení se aplikuje čistě podle délky textu, nikoli podle struktury HTML nebo URL. Pokud zkrátíte HTML nebo odkaz na špatném místě (např. uprostřed tagu nebo URL), může to vést k nefunkčnímu odkazu. 💡 V těchto případech doporučujeme kombinovat pravidlo **Zkrácení hodnoty** s pravidlem **Najít a nahradit**, které odstraní celé části textu bezpečněji. **8\. Mohu tímto pravidlem zkrátit názvy produktů pro určité výběry?** Ano. Stačí vytvořit **Produktový výběr** (např. produkty s dlouhými názvy) a pravidlo aplikovat pouze na tento výběr. Můžete tak např. omezit názvy jen u určité značky nebo kategorie produktů. **9\. Dá se pravidlo použít i pro zkracování podle slov místo znaků?** Ne, aktuálně je možné zkracovat pouze podle **počtu znaků**. Pokud potřebujete upravovat text podle struktury (např. odstranit větu nebo blok), použijte kombinaci s pravidlem **Najít a nahradit** nebo **Regulární výrazy**. **10\. Co když chci, aby se text zkracoval automaticky jen v určitém období (např. během kampaně)?** Využijte funkci **Časovače** v dolní části stránky s pravidlem. Můžete nastavit konkrétní **dny a hodiny**, kdy se pravidlo aplikuje, nebo omezit jeho platnost na určité **datumové období**. **11\. Jak ověřím, že se text zkrátil správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu** můžete výsledek zkontrolovat ve **vizualizaci produktu** nebo pomocí funkce **Průchod pravidly**. Uvidíte, jak přesně se text zkrátil a zda byl doplněn o zadaný text („… více na webu“). **12\. Mohu pravidlo kombinovat s jinými pravidly?** Ano, velmi často se kombinuje s: * **Najít a nahradit** – pro odstranění zbytečných částí textu ještě před zkrácením, * **Přepsat** – pro následné doplnění textu nebo formátování, --- ## [Pravidlo: Výpočet](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-vypocet/) # Pravidlo: Výpočet ## **Pravidlo: Výpočet** Toto pravidlo umožňuje provádět výpočty s proměnnými v rámci feedu. Můžete například vypočítat ceny bez DPH, upravit hodnoty podle sazby DPH, nebo provádět složitější aritmetické operace. **Zdroje** * [Výpočet – výpočtové pravidlo | Mergado Fórum](https://forum.mergado.cz/t/vypocet-vypoctove-pravidlo/1978) **Extra funkce** * Do pole *výpočet* lze zadat operace: sčítání, odčítání, násobení, dělení, práce se závorkami i proměnnými * Zaokrouhlení výsledných hodnot (na desetiny, stovky atd.) **Konkrétní příklady** **Příklad 1:** Vypočítat cenu bez DPH Tento příklad ukazuje, jak použít výpočet pro odstranění DPH z ceny například pro maďarské Árukereső, kde je to povinný element. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Výpočet**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, do kterého chcete zapsat výsledek výpočtu. * V našem případě to bude element `netprice` * **Zadejte hodnotu pro výpočet:** * V poli **Výpočet** zadejte vzorec pro výpočet ceny bez DPH: `%g:price%/1,27` * Tento výpočet vezme cenu s DPH a **vydělí ji hodnotou 1,27** (předpokládaná sazba DPH 27%). * **Nastavení typu zaokrouhlení**: * V poli **Typ zaokrouhlení** vyberte požadovanou metodu, například: **nahoru**, **dolu**, **matematicky**, **0** nebo **0,5,**. * **Výběr zaokrouhlení**: * V poli **Zaokrouhlit na** zvolte jednotky, desetiny, setiny atd., podle toho, jaký typ zaokrouhlení potřebujete. * **Nastavení desetinné značky**: * Vyberte, zda chcete použít **čárku** nebo **tečku** jako desetinnou značku. * **Nastavení oddělovače tisíců**: * V poli **Oddělovač tisíců** vyberte požadovaný oddělovač (mezera, tečka, čárka nebo žádný oddělovač). * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například: “*Výpočet ceny bez DPH”.* **Příklad 2:** Navýšit cenu o X % Tento příklad ukazuje, jak použít výpočet pro navýšení ceny o 15% (například pro akci nebo zvýšení marže). * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Výpočet**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, do kterého chcete zapsat výsledek výpočtu. * V našem případě to bude element `g:price` * **Zadejte hodnotu pro výpočet:** * V poli **Výpočet** zadejte vzorec pro navýšení ceny: `%g:price%*1,15` * Tento výpočet **vynásobí cenu o 1,15**, čímž zvýší cenu o 15%. * **Nastavení typu zaokrouhlení**: * V poli **Typ zaokrouhlení** vyberte požadovanou metodu, například: **nahoru**, **dolu**, **matematicky**, **0** nebo **0,5,**. * **Výběr zaokrouhlení**: * V poli **Zaokrouhlit na** zvolte jednotky, desetiny, setiny atd., podle toho, jaký typ zaokrouhlení potřebujete. * **Nastavení desetinné značky**: * Vyberte, zda chcete použít **čárku** nebo **tečku** jako desetinnou značku. * **Nastavení oddělovače tisíců**: * V poli **Oddělovač tisíců** vyberte požadovaný oddělovač (mezera, tečka, čárka nebo žádný oddělovač). * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například: “*Navýšení ceny pro Allegro”.* Příklad 3: Výpočet výše slevy v procentech Tento příklad ukazuje, jak použít výpočet pro zjištění procentuální výše slevy na produkt. * **Vytvoření pomocného elementu**: * Na stránce **„Elementy“** v pravém horním rohu klikněte na tlačítko **„Nový element“**. * Vytvořte pomocný element, například *„vyse\_slevy“*. * Nepovinné: **Skryjte tento element** pomocí přepínače na konci řádku. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Výpočet**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu pro změnu**: * V poli **Element** vyberte element, do kterého chcete zapsat výsledek výpočtu. * V našem případě to bude element vyse\_slevy * **Zadejte hodnotu pro výpočet:** * V poli **Výpočet** zadejte vzorec pro výpočet výše slevy: `((%g:price%-%g:sale_price%)/%g:price%)*100` * Tento vzorec vypočítá procentuální **rozdíl mezi původní a slevněnou cenou**. * 💡 **Tip:** Pokud potřebujete za výsledek výpočtu umístit text, např. znak **%** (procenta) nebo třeba měnu (Kč), je třeba vytvořit pomocné pravidlo typu **Přepsat**. * **Nastavení typu zaokrouhlení**: * V poli **Typ zaokrouhlení** vyberte požadovanou metodu, například: **nahoru**, **dolu**, **matematicky**, **0** nebo **0,5,**. * **Výběr zaokrouhlení**: * V poli **Zaokrouhlit na** zvolte jednotky, desetiny, setiny atd., podle toho, jaký typ zaokrouhlení potřebujete. * V našem případě to budou jednotky. * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například: “*Výpočet výše slevy”.* **Další využití pravidla** * Navýšit cenu o provizi pro partnery * Výpočet sazby DPH * Výpočet prodejní ceny z nákupní ceny * Přepočítat ceny do jiné měny pomocí dynamického nebo pevného měnového kurzu * [https://www.bidding-fox.cz/elements-sparovanost](https://www.bidding-fox.cz/elements-sparovanost) * Vypočítat cenu po slevě (často do g:sale price) **FAQ**: **1\. K čemu slouží pravidlo Výpočet?** Toto pravidlo umožňuje provádět **výpočty** s hodnotami v elementech feedu. Můžete ho použít například pro: * výpočet ceny bez DPH, * navýšení ceny o procento nebo pevnou částku, * přepočet měny, * výpočet slevy v procentech, * výpočet provizí či marží. * výpočet ceny po slevě **2\. Jaké matematické operace mohu použít?** Do pole **„Výpočet“** můžete zadat běžné matematické operace: * `sčítání (+)` – např. `%price%+50`, * `odčítání (–)` – např. `%price%-100`, * `násobení (*)` – např. `%price%*1.15`, * `dělení (/)` – např. `%price%/1.21`, * závorky pro určení pořadí výpočtu, např. `(%price%-100)*1.15`. **3\. Jaké typy zaokrouhlení mohu použít?** V poli **„Typ zaokrouhlení“** můžete zvolit: * **nahoru** – vždy zaokrouhlí směrem nahoru, * **dolů** – vždy směrem dolů, * **matematicky** – běžné zaokrouhlení podle hodnoty za desetinnou čárkou, * **na 0 nebo 0,5** – na nejbližší půl jednotky nebo 0, * **na 0,9** – zaokrouhlí na nejbližší hodnotu s koncovkou „,9“, * **na 0,99** – zaokrouhlí na nejbližší hodnotu s koncovkou „,99“. **4\. Jak zvolím úroveň zaokrouhlení?** V poli **„Zaokrouhlit na“** můžete nastavit, na kolik míst se má hodnota zaokrouhlit: * jednotky, * desetiny, * setiny, * stovky, podle potřeby formátu výstupního feedu. **5\. Jaký formát čísel mohu nastavit?** V poli **„Desetinná značka“** zvolte, zda se má použít čárka nebo tečka (,) / (.). V poli **„Oddělovač tisíců“** vyberte mezeru, tečku, čárku nebo žádný oddělovač. 💡 Například: 1 000,50 nebo 1.000,50 podle požadavků cílového formátu. **6\. Co se stane, když použiji proměnnou, která neexistuje nebo neobsahuje číselnou hodnotu?** Mergado takovou proměnnou nevyhodnotí a řádek přeskočí. V editoru se neznámá proměnná zobrazí s **červeným pozadím**. Doporučuje se testovat výpočet na menším vzorku produktů pomocí **Průchodu pravidly**. **7\. Mohu do výpočtu zahrnout i textové elementy (např. měnu)?** Ne. Výpočet funguje pouze s číselnými hodnotami. Pokud chcete k výsledku doplnit text nebo měnu (např. „Kč“, „%“), vytvořte následné pravidlo **Přepsat**, které tyto znaky doplní. **8\. Jak vypočítám cenu bez DPH?** Zadejte do pole „Výpočet“ vzorec: `%g:price%/1,21` (nebo 1,27 podle sazby DPH). Výsledek uložte např. do elementu `netprice`. Pravidlo tak vypočítá cenu bez DPH z původní ceny s DPH. **9\. Jak vypočítám výši slevy v procentech?** Zadejte vzorec: `((%g:price%-%g:sale_price%)/%g:price%)*100`. Výsledek bude procentuální rozdíl mezi původní a slevněnou cenou. 💡 Pokud potřebujete přidat znak „%“, použijte následné pravidlo **Přepsat**. **10\. Jak navýším cenu o procento nebo pevnou částku?** Do pole „Výpočet“ zadejte např.: * pro navýšení o 15 % → `%g:price%*1,15`, * pro navýšení o 20 Kč → `%g:price%+20`. Mergado automaticky přepočítá novou hodnotu a zapíše ji do zvoleného elementu. **11\. Mohu pravidlo použít pro přepočet měn?** Ano. Do výpočtu můžete zahrnout pevný nebo dynamický měnový kurz. Například pro přepočet z CZK na EUR (1 EUR \= 24,50 Kč): `%g:price%/24.5`. 💡 Pokud používáte **dynamické kurzy**, je vhodné data načítat z externího souboru pomocí **Importu datového souboru** nebo rozšíření **Bidding Fox Elements**. **12\. Lze v pravidle kombinovat více operací?** Ano. Do výpočtu můžete vkládat více operací najednou a využít závorky pro definici pořadí, např.: `((%g:price%+50)*1.2)/1.21`. Mergado dodržuje standardní matematické pořadí operací. **13\. Jak zaokrouhlím výsledek výpočtu?** V rámci výpočetního pravidla použijte nastavení „Typ zaokrouhlení“ a „Zaokrouhlit na“ stejně jako v pravidle **Zaokrouhlit cenu**. Například: `nahoru` \+ `na setiny` → 123,456 → 123,46. Díky tomu můžete v jednom kroku počítat i formátovat výsledky. **14\. Co se stane, pokud výpočet obsahuje chybu (např. dělení nulou)?** Mergado záznam přeskočí a ponechá původní hodnotu. Při aplikaci pravidel Mergado upozorní na problém u daného produktu. Před nasazením doporučujeme výpočty otestovat na vzorku produktů pomocí **Průchodu pravidly**. **15\. Jak zjistím, jestli se výsledek vypočetl správně?** Po **uložení a aplikování pravidel nebo po přegenerování feedu** otevřete **náhled produktů** nebo použijte **Průchod pravidly**. Uvidíte, jak se výsledná hodnota elementu změnila a zda odpovídá očekávanému výpočtu. **16\. Mohu pravidlo naplánovat, aby se spouštělo jen v určitou dobu (např. při přepočtu cen v noci)?** Ano. Pomocí **Časovače** můžete určit konkrétní časové sloty nebo data, kdy má být pravidlo aktivní. --- ## [Výpočet a filtrace procentuální slevy v Mergadu](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/vypocet-a-filtrace-procentualni-slevy-v-mergadu/) # Výpočet a filtrace procentuální slevy v Mergadu # Jak spočítat a filtrovat procentuální slevu v Mergadu Tato nápověda vás provede výpočtem procentuální slevy mezi původní cenou a akční cenou a ukáže, jak podle slevy filtrovat produkty. Potřebujete mít ve feedu dvojici elementů – například ve formátu Google: * původní cena: `g:price` * akční cena: `g:sale_price` Ze těchto hodnot snadno spočítáte výši slevy v procentech a můžete ji využít pro úpravy feedu, exporty či filtrování (např. zobrazit jen produkty se slevou > 10 %) a podle toho plánovat kampaně. **Vzorec slevy:** `((původní cena - akční cena) / původní cena) * 100` --- ## Postup 1: Uložení slevy do nového elementu Chcete mít slevu přímo ve feedu jako vlastní element? Postupujte takto: 1. **Vytvořte nový element** Přejděte na **Elementy → Přidat nový element** (tlačítko je dole pod seznamem elementů). **Název elementu:** `SLEVA` (nebo např. `DISCOUNT_PERCENTAGE`). 2. **Vytvořte pravidlo „Výpočet“** Otevřete **Pravidla → Nové pravidlo → Výpočet**. * **Název pravidla:** „Výpočet slevy“. * **Cílový element:** `SLEVA`. * **Vzorec výpočtu:** `((%g:price% - %g:sale_price%) / %g:price%) * 100` * **Doporučení:** nastavte zaokrouhlení na celé číslo. 3. **Uložte a aplikujte pravidla.** 4. **Zkontrolujte výsledek (příklad)** * `g:price = 1000` * `g:sale_price = 750` → element `SLEVA` bude mít hodnotu **25**. --- ## Postup 2: Filtrování produktů se slevou bez nového elementu Potřebujete jen rychle filtrovat podle slevy? Využijte výpočet přímo ve **výběru (MQL)** – nový element není nutný. **Příklad výběru pro slevu > 10 %:** `([g:price] - [g:sale_price]) / [g:price] * 100 > 10` Tento dotaz najde všechny produkty, jejichž sleva je větší než 10 %. --- ## Tipy * **Výběry v Mergadu umí počítat.** Můžete používat matematické operace přímo v podmínkách – nejen statické hodnoty. Hodí se to pro kontrolu slev nebo poměru ceny a hodnoty bez vytváření dalších elementů. * **Výpočet marže podobně jako slevy.** Pokud máte ve feedu nákupní a prodejní cenu, můžete spočítat procentuální marži: `((%g:price% - %PURCHASE_PRICE%) / %g:price%) * 100` Vytvořte buď nové pravidlo **Výpočet** (např. do elementu `MARGIN_PERCENTAGE`), nebo použijte přímo ve **výběrech** k filtrování produktů s marží vyšší než zvolené procento. --- ## FAQ **Jaký je správný vzorec pro výpočet slevy?** `((původní cena - akční cena) / původní cena) * 100` **Musím pro filtrování podle slevy vytvářet nový element?** Nemusíte. Použijte výpočet přímo v MQL výběru, např.: `([g:price] - [g:sale_price]) / [g:price] * 100 > 10` **Kde vytvořím nový element pro slevu?** V **Elementy → Přidat nový element**. Doporučený název: `SLEVA` (nebo `DISCOUNT_PERCENTAGE`). **Jak nastavit pravidlo pro výpočet slevy do elementu?** **Pravidla → Nové pravidlo → Výpočet**, název „Výpočet slevy“, cílový element `SLEVA`, vzorec: `((%g:price% - %g:sale_price%) / %g:price%) * 100`. Doporučujeme zaokrouhlit na celé číslo. **Mohu spočítat i procentuální marži?** Ano. Použijte: `((%g:price% - %PURCHASE_PRICE%) / %g:price%) * 100` Buď jako nové pravidlo do elementu (např. `MARGIN_PERCENTAGE`), nebo přímo ve výběrech. --- ## [Pravidlo: Zaokrouhlit číslo](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-zaokrouhlit-cislo/) # Pravidlo: Zaokrouhlit číslo ## **Pravidlo: Zaokrouhlit číslo** ℹ️ Toto pravidlo je také součástí pravidla **„Výpočet“**. Toto pravidlo umožňuje **zaokrouhlit číselné hodnoty** (například ceny) v konkrétním elementu na zvolený počet míst — například na jednotky, desetiny nebo setiny. **Zdroje** * [Zaokrouhlit číslo – Mergado Fórum](https://forum.mergado.cz/t/zaokrouhlit-cislo/1985) **Extra funkce** * Zaokrouhlení na různé úrovně: **jednotky, desetiny, setiny, stovky** * Výběr **typu zaokrouhlení**: nahoru, dolů, matematicky, na nulu * Výběr **desetinné značky** (tečka nebo čárka) * Výběr **oddělovače tisíců** (mezera, tečka, čárka, žádný) **Konkrétní příklady:** Příklad: Zaokrouhlit částky na jednotky, desetiny nebo setiny: 1. **Vytvoření nového pravidla**: 1. Otevřete stránku "Pravidla". 2. Klikněte na tlačítko **Nové pravidlo**. 2. **Výběr typu pravidla**: 1. V poli **Typ pravidla** vyberte možnost **Zaokrouhlit číslo**. 3. **Výběr produktů**: 1. V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. 4. **Volba elementu pro změnu**: 1. V poli **Element** vyberte element, u kterého chcete provést změnu. 5. **Nastavení typu zaokrouhlení**: 1. V poli **Typ zaokrouhlení** vyberte požadovanou metodu, například: **nahoru**, **dolu**, **matematicky**, **0** nebo **0,5,**. 6. **Výběr zaokrouhlení**: 1. V poli **Zaokrouhlit na** zvolte jednotky, desetiny, setiny atd., podle toho, jaký typ zaokrouhlení potřebujete. 7. **Nastavení desetinné značky**: 1. Vyberte, zda chcete použít **čárku** nebo **tečku** jako desetinnou značku. 8. **Nastavení oddělovače tisíců**: 1. V poli **Oddělovač tisíců** vyberte požadovaný oddělovač (mezera, tečka, čárka nebo žádný oddělovač). 9. **Pojmenování pravidla**: 1. V posledním kroku zadejte název pravidla, například: “*Zaokrouhlení ceny na jednotky”.* **FAQ**: **1\. K čemu slouží pravidlo Zaokrouhlit číslo?** Toto pravidlo umožňuje **zaokrouhlit číselné hodnoty** (např. ceny, slevy nebo marže) v libovolném elementu na požadovaný počet míst — například na jednotky, desetiny nebo setiny. Lze jej použít i k úpravě formátu čísel (desetinná tečka/čárka, oddělovače tisíců apod.). **2\. Na jaké hodnoty mohu zaokrouhlovat?** V poli **„Zaokrouhlit na“** můžete zvolit: * jednotky (např. 123,45 → 123), * desetiny (např. 123,45 → 123,5), * setiny (např. 123,456 → 123,46), * stovky (např. 1234 → 1200). **3\. Jaké typy zaokrouhlení mohu použít?** V poli **„Typ zaokrouhlení“** jsou k dispozici tyto možnosti: * **nahoru** – vždy zaokrouhlí směrem nahoru, * **dolů** – vždy směrem dolů, * **matematicky** – běžné zaokrouhlování podle hodnoty po desetinné čárce, * **na 0** **nebo 0,5** – zaokrouhlí na nejbližší půl jednotky nebo 0, * **na 0,9 \-** zaokrouhlí na nejbližší hodnotu s koncovkou ,9 * **na 0,99 \-** zaokrouhlí na nejbližší hodnotu s koncovkou ,99 **4\. Lze toto pravidlo použít i na jiné elementy než ceny?** Ano. Pravidlo lze použít na **jakýkoli číselný element**, např. hmotnost, marži, procentuální hodnoty nebo počet kusů. Důležité je, aby element obsahoval **platné číselné hodnoty**. **5\. Co se stane, pokud v elementu není číselná hodnota (např. text nebo prázdná hodnota)?** Mergado tento záznam **přeskočí** a žádnou změnu neprovede. Pravidlo se aplikuje pouze na hodnoty, které lze jednoznačně převést na číslo. **6\. Mohu si vybrat, zda se použije čárka nebo tečka jako desetinná značka?** Ano. V poli **„Desetinná značka“** zvolte, zda chcete používat **čárku (,) nebo tečku (.)**. 💡 Například pro české feedy bývá vhodnější čárka, zatímco pro mezinárodní projekty tečka. **7\. Jak nastavit oddělovač tisíců?** V poli **„Oddělovač tisíců“** vyberte jednu z možností: * mezera (např. 1 000), * tečka (např. 1.000), * čárka (např. 1,000), * žádný oddělovač (např. 1000). **8\. Mohu pravidlo použít jen pro vybrané produkty?** Ano. V poli **„Výběr“** zvolte buď **„Všechny produkty“**, nebo vytvořte **vlastní Produktový výběr**, například podle typu, značky nebo ceny. Tím můžete zaokrouhlovat jen určitou skupinu produktů. **9\. Dá se tímto pravidlem odstranit desetinná část ceny úplně?** Ano. Zvolte typ zaokrouhlení **„matematicky**“ a následně nastavte zaokrouhlení na **jednotky**. Mergado automaticky odstraní vše za desetinnou čárkou, např.: (např. 123,99 → 123). **10\. Mohu pomocí pravidla převádět ceny např. z 123,4567 na 123,46?** Ano. Zvolte typ zaokrouhlení **„matematicky“** a v poli **„Zaokrouhlit na“** vyberte **setiny**. Mergado výsledek automaticky upraví na dvě desetinná místa. **11\. Lze tímto pravidlem formátovat i měnu (např. přidat Kč)?** Ne. Pravidlo **Zaokrouhlit cenu** pracuje pouze s číselnými hodnotami. Pokud chcete doplnit měnu, použijte následně pravidlo **Přepsat** nebo **Najít a nahradit**. **12\. Mohu použít toto pravidlo jako součást jiného výpočtu?** Ano. Pravidlo **Zaokrouhlit cenu** je také **součástí pravidla Výpočet**. To znamená, že můžete nejdříve provést výpočet (např. cenu bez DPH) a pak výsledek rovnou stejným pravidlem zaokrouhlit. **13\. Jak zkontroluji, zda se zaokrouhlení aplikovalo správně?** Po **uložení a aplikování pravidel nebo po přegenerování feedu** otevřete **náhled produktů** nebo využijte funkci **„Průchod pravidly“**. Zde si můžete ověřit, zda se hodnota skutečně změnila podle zvoleného typu a úrovně zaokrouhlení. --- ## [Pravidlo: Hromadné přepisování dle hodnot](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-hromadne-prepisovani-dle-hodnot/) # Pravidlo: Hromadné přepisování dle hodnot ## **Pravidlo: Hromadné přepisování dle hodnot** Toto pravidlo umožňuje upravit nebo zcela přepsat hodnoty elementu na základě hodnot v jiném elementu. Lze použít pro automatickou aktualizaci nebo přiřazení hodnot v závislosti na hodnotách v jiných polích, například při přiřazování Google kategorií podle kategorií v e-shopu. **Zdroje** * [Hromadné přepisování dle hodnot na Mergado Fórum](https://forum.mergado.cz/t/hromadne-prepisovani-dle-hodnot/1989) **Extra funkce** * Podpora regulárních výrazů * Hromadné kopírování hodnot například: z Google Sheets * Do nových hodnot lze použít: * jednoduchý text * proměnnou * prázdnou hodnotu **Konkrétní příklady** **Příklad 1**: Nastavit Google kategorie podle kategorií e-shopu Tento příklad ukazuje, jak pomocí hromadného přepisování dle hodnot elementu s kategoriemi e-shopu nastavit různé Google kategorie * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přepisování dle hodnot**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Volba elementu, podle kterého se bude hledat:** * V levém sloupci v poli **Element, ve kterém hledáte** * ze Selectboxu vyberte element, podle kterého se bude hledat * v našem případu to bude element `product_type` * **Volba elementu pro změnu:** * V pravém sloupci v poli **Element, do kterého zapisujete** * ze Selectboxu vyberte element, do kterého chcete nové hodnoty zapisovat * v našem případu to bude element `g:google_product_category` * **Zadejte hodnotu, podle kterého se bude hledat:** * V levém sloupci do pole “Pokud hodnota elementu obsahuje:” zadejte pro každý řádek: * textovou hodnotu, například: přesnou hledanou hodnotu (`Dárky | Dárky pro ženy`) nebo klíčové slovo (`Dárky`), nebo * klikněte na tlačítko předvyplnit levou stranu a Mergado vám do levého sloupce předvyplní všechny existující výběry * 💡 **Tip:** *v poli lze použít i proměnnou nebo kombinaci proměnné a textu, ale v našem příkladě to není vhodné* * **Zadejte novou hodnotu:** * V pravém sloupci do pole “Do elementu bude zapsána tato hodnota” zadejte pro každý řádek: * textovou hodnotu, například: vybranou Google kategorii (`Umění a zábava > Párty a oslavy > Dárky`) * 💡 **Tip:** u vybraných formátů Mergadu umí načítat hodnoty z oficiálního stromu kategorií a zjednodušit tak mapování kategorií * 💡 **Tip:** *v poli lze použít i proměnnou nebo kombinaci proměnné a textu, ale v našem příkladě to není vhodné* * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení Google kategorií”. **Další využití pravidla** * Přepsat kategorie na výstupu podle kategorií e-shopu * Doplnit elementy **custom\_label** podle různých parametrů FAQ: **1\. K čemu slouží pravidlo Hromadné přepisování dle hodnot?** Toto pravidlo umožňuje **měnit nebo přepisovat hodnoty jednoho elementu** podle **hodnot v jiném elementu**. Přesněji se dá fungování popsat takto: Pokud element A obsahuje hodnotu X pak do elementu B zapiš hodnotu Z. Například můžete nastavit **Google kategorie podle kategorií e-shopu**, nebo doplnit štítky **custom\_label** podle hodnot parametru. **2\. Jaký je rozdíl mezi přepisováním dle výběrů a dle hodnot?** * **Dle výběrů**: určujete, které produkty měnit, pomocí **vlastních uložených produktových výběrů**. * **Dle hodnot**: určujete, co se má změnit, na základě **konkrétních hodnot jiného elementu** (např. text v kategorii, značka, parametry). Pravidlo tak automaticky rozpozná produkty podle obsahu vybraného elementu. **3\. Jak vyberu, podle kterého elementu se má hledat?** V levém sloupci vyberte element, podle jehož **hodnot se bude hledat shoda** – například `product_type`, `category_text`, nebo `PARAM|PARAM_NAME`. Mergado podle těchto hodnot rozhoduje, do kterých produktů se má nová hodnota zapsat. **4\. Jak zvolím element, do kterého se zapíší nové hodnoty?** V pravém sloupci vyberte element, do kterého se budou hodnoty zapisovat. Například při mapování kategorií vyberte `g:google_product_category`. **5\. Mohu v pravidle použít i částečnou shodu textu?** Ano. V poli **„Pokud hodnota elementu obsahuje“** zadejte jen část textu (např. „Dárky“). Mergado pak najde všechny produkty, kde se tato hodnota **vyskytuje kdekoliv v textu** elementu. Pro přesnou shodu zadejte celý text (např. `Dárky | Dárky pro ženy`). **6\. Jak mohu načíst všechny existující hodnoty z elementu, podle kterého chci přepisovat?** Klikněte na tlačítko **„Předvyplnit levou stranu“** – Mergado automaticky načte všechny existující hodnoty vybraného elementu ze vstupního feedu. Tento seznam pak můžete ručně upravit, odstranit nepotřebné řádky nebo doplnit nové. **7\. Lze použít i regulární výrazy pro hledání hodnot?** Ano. Po aktivaci volby **„Regulární výrazy“** můžete použít pokročilé vzory (regex) pro hledání textu. Například: * `^Dárky.*` → najde všechny hodnoty začínající slovem „Dárky“ * `.*Dětsk.*` → najde všechny hodnoty, které obsahují slova „Dětské“, “Dětský” atd.. **8\. Co mohu zadat do pole „Do elementu bude zapsána tato hodnota“?** Do pravého sloupce můžete vložit: * **text** – např. `Umění a zábava > Dárky > Pro ženy`, * **proměnnou** – např. `%category%`, * nebo **kombinaci obojího**, např. `%category% – Rozšířená sada`. 💡 Pokud chcete hodnotu odstranit, nechte pole prázdné. **9\. Co se stane, pokud produkt nesplňuje žádnou z podmínek uvedených v levém sloupci?** Produkt zůstane **beze změny** – Mergado k němu nenajde odpovídající hodnotu a neprovede žádnou úpravu. **10\. Jak se vyhodnocuje pořadí řádků v pravidle?** Mergado aplikuje pravidlo **shora dolů**. Pokud produkt odpovídá více podmínkám, použije se **hodnota z posledního odpovídajícího řádku**. Pořadí řádků tedy ovlivňuje výslednou hodnotu elementu. **11\. Jak mohu použít pravidlo pro mapování kategorií na Google kategorie?** * V levém sloupci vyberte `product_type` nebo `CATEGORYTEXT`. * Do pravého sloupce zadejte odpovídající `g:google_product_category`. 💡 Mergado dokáže načíst **oficiální strom Google kategorií**, takže můžete vybírat z našeptávače správné kategorie podle klíčového slova. **12\. Lze tímto pravidlem doplňovat i jiné hodnoty, než kategorie?** Ano. Pravidlo lze použít pro **libovolné párování hodnot** mezi elementy – např.: * přiřazení `custom_label` podle marže, * doplnění `shipping_label` podle země, * doplnění `condition` podle textu v názvu produktu. **13\. Mohu tímto pravidlem odstranit hodnoty v elementech?** Ano. Pokud v pravém sloupci **necháte pole prázdné**, Mergado odpovídající hodnoty z daného elementu **vymaže**. To je užitečné např. při čištění chybných nebo duplicitních údajů. **14\. Jak mohu zkontrolovat, jestli se pravidlo aplikovalo správně?** Po **uložení a aplikování pravidel nebo po přegenerování feedu** otevřete **náhled produktů** nebo použijte **Průchod pravidly**. Tato funkce zobrazí, jak se jednotlivé hodnoty mění po aplikaci pravidla, a umožní zkontrolovat správnost přiřazení. **15\. Mohu pravidlo naplánovat, aby se spouštělo jen v určitých dnech (např. pro sezónní kategorizaci)?** Ano. Pomocí funkce **Časovač** můžete určit konkrétní dny, hodiny nebo datumové rozmezí, kdy má být pravidlo aktivní. 💡 Příklad: Aktivujte pravidlo jen v období sezónního výprodeje – např. od 1\. do 15\. prosince. **16\. Co se stane, pokud omylem zadám špatný název elementu nebo neexistující proměnnou?** Pokud Mergado proměnnou nerozpozná, **nezapíše žádnou hodnotu** a řádek se přeskočí. Chybné proměnné jsou v rozhraní zvýrazněny **červeným pozadím**. Doporučuje se pravidlo otestovat na menším vzorku produktů pomocí **Průchodu pravidly**. **17\. Jak pracovat s duplicitními hodnotami v levém sloupci?** Pokud se stejná hodnota vyskytuje vícekrát, použije se **první shora uvedený výskyt**. Mergado postupuje od prvního řádku dolů – další shodné výrazy se ignorují. **18\. Lze použít pravidlo i pro mapování parametrů (např. převod názvů parametrů na standardizované)?** Ano. V levém sloupci vyberte `PARAM|PARAM_NAME` a v pravém sloupci opět `PARAM|PARAM_NAME` nebo jiný cílový element. Tím můžete sjednotit názvy parametrů, např. „Velikost“ → „Size“, „Barva“ → „Color“. **19\. Můžu hodnoty importovat hromadně z tabulky (např. Google Sheets)?** Ano. Pravidlo podporuje **režim chytrého vkládání** – můžete zkopírovat dvojice hodnot (např. levý a pravý sloupec) přímo z Google Sheets. Mergado automaticky správně rozdělí hodnoty podle řádků a sloupců. 20\. Jak v pravidle Hromadné přepisování dle hodnot použít přesnou shodu? [https://forum.mergado.cz/t/jak-v-pravidle-hromadne-prepisovani-dle-hodnot-pouzit-presnou-shodu/2498](https://forum.mergado.cz/t/jak-v-pravidle-hromadne-prepisovani-dle-hodnot-pouzit-presnou-shodu/2498) --- ## [Pravidlo: Hromadné přepisování dle výběru](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-hromadne-prepisovani-dle-vyberu/) # Pravidlo: Hromadné přepisování dle výběru ## **Pravidlo: Hromadné přepisování dle výběru** Toto pravidlo umožňuje zcela přepsat hodnoty elementu na základě předem definovaných výběrů produktů. Lze použít pro automatické nastavení hodnot pro různé segmenty produktů (např. nastavování ceny, výrobce, nebo štítků). **Zdroje** * [Hromadné přepisování dle výběru na Mergado Fórum](https://forum.mergado.cz/t/hromadne-prepisovani-dle-vyberu/1988) **Extra funkce** * Předvyplnění levé strany – načte hodnoty ze vstupního feedu pro zvolený element * Odstranění řádků bez hodnot * Do nových hodnot lze použít: * jednoduchý text * proměnnou * prázdnou hodnotu **Konkrétní příklady** **Příklad 1**: Nastavit **CPC** hodnotu podle výběru produktů Tento příklad ukazuje, jak pomocí hromadného přejmenování dle výběrů nastavit různým segmentům produktů různé CPC * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přepisování dle výběrů**. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu * V našem případě to bude element `HEUREKA_CPC` * **Výběry produktů**: * V levém sloupci v poli **Výběr** * ze Selectboxu zvolte připravené uložené výběry z projektu, každý na samostatný řádek, nebo * klikněte na tlačítko předvyplnit levou stranu a Mergado vám do levého sloupce předvyplní všechny existující výběry z projektu * Smažte ty řádky, které obsahují výběry, které nechcete použít * 💡 **Tip**: toto je vhodné v případě, že chcete použít větší část z existujících výběrů v projektu * ze Selectboxu zvolte **Vytvořit nový výběr** a vytvořte nové **Produktové výběry** pro specifické produkty, na které chcete pravidlo použít. * **Zadejte novou hodnotu:** * V pravém sloupci do pole “Nová hodnota” zadejte pro každý řádek: * textovou hodnotu, například: konkrétní výši CPC (`15`) * *v poli lze použít i proměnnou nebo kombinaci proměnné a textu, ale v našem příkladě to není vhodné* * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení CPC”. **Příklad 2**: Nastavit **výrobce** podle výběrů Tento příklad ukazuje, jak pomocí hromadného přejmenování dle výběrů nastavit automatizovaně výrobce různým segmentům produktů * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přepisování dle výběrů**. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu. * V našem případě to bude element `g:brand` * **Výběry produktů**: * V levém sloupci v poli **Výběr** * ze Selectboxu zvolte připravené uložené výběry z projektu, každý na samostatný řádek, nebo * klikněte na tlačítko předvyplnit levou stranu a Mergado vám do levého sloupce předvyplní všechny existující výběry * Smažte ty řádky, které obsahují výběry, které nechcete použít * toto je vhodné v případě, že chcete použít větší část z existujících výběrů v projektu * ze Selectboxu zvolte **Vytvořit nový výběr** a vytvořte nové **Produktové výběry** pro specifické produkty, na které chcete pravidlo použít. * **Zadejte novou hodnotu:** * V pravém sloupci do pole “Nová hodnota” zadejte pro každý řádek: * textovou hodnotu, například: konkrétního výrobce (`Nike`) * *v poli lze použít i proměnnou nebo kombinaci proměnné a textu, ale v našem příkladě to není vhodné* * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení výrobce”. **Příklad 3**: Nastavit element **custom\_label** dle cenových hladin Tento příklad ukazuje, jak pomocí hromadného přepisování dle výběrů nastavit štítky custom\_label pro různé cenové hladiny. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přepisování dle výběrů**. * **Volba elementu pro změnu:** * V poli **Element** vyberte element, u kterého chcete provést změnu. * V našem případě to bude element `g:custom_label_0` * **Výběry produktů**: * V levém sloupci v poli **Výběr** * ze Selectboxu zvolte připravené uložené výběry z projektu, každý na samostatný řádek, nebo * klikněte na tlačítko předvyplnit levou stranu a Mergado vám do levého sloupce předvyplní všechny existující výběry * Smažte ty řádky, které obsahují výběry, které nechcete použít * toto je vhodné v případě, že chcete použít větší část z existujících výběrů v projektu * ze Selectboxu zvolte Vytvořit nový výběr a vytvořte nové **Produktové výběry** pro specifické produkty, na které chcete pravidlo použít. * **Zadejte novou hodnotu:** * V pravém sloupci do pole “Nová hodnota” zadejte pro každý řádek: * textovou hodnotu nového štítku pro daný výběr, například: label\_1 (`Heroes`) * *v poli lze použít i proměnnou nebo kombinaci proměnné a textu, ale v našem příkladě to není vhodné* * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení g:custom\_label\_0”. **Další využití pravidla** * Nastavit **custom\_label** dle výše marže * Doplnění GPSR údajů (odpovědná osoba za uvedení na EU trh) do feedu * Nastavení kategorií dle výběrů **FAQ:** **1\. K čemu slouží pravidlo Hromadné přepisování dle výběru?** Toto pravidlo umožňuje **automaticky přepsat jeden element různými hodnoty** pro **různé produktové výběry**. Můžete ho využít například pro nastavení **cen za proklik (CPC)**, **výrobce (brand)** nebo **štítků (custom\_label)** pro různé skupiny produktů. **2\. Jaký je rozdíl mezi tímto pravidlem a běžným pravidlem Přepsat?** Pravidlo **Přepsat** mění hodnotu v různých elementech pro **právě jeden** Produktový výběr. Naopak **Hromadné přepisování dle výběru** umožňuje nastavit **různé hodnoty pro různé výběry produktů** pro **právě jeden** element – vše v rámci jednoho pravidla. **3\. Jak mohu rychle načíst všechny existující výběry do pravidla?** Klikněte na tlačítko **„Předvyplnit levou stranu“**. Mergado automaticky načte všechny **uložené produktové výběry** z projektu do levého sloupce. Poté můžete **smazat ty řádky, které nechcete použít**. **4\. Co dělat, pokud výběr, který potřebuji, zatím neexistuje?** Zvolte možnost **„Vytvořit nový výběr“** přímo v poli **„Výběr“**. Můžete tak založit nový **Produktový výběr** bez nutnosti opustit editor pravidla. **5\. Mohu kombinovat text a proměnné v poli „Nová hodnota“?** Ano. V poli **„Nová hodnota“** můžete použít: * **text** (např. `Nike`), * **proměnnou** (např. `%brand%`), * nebo jejich **kombinaci** (např. `%brand% – nová kolekce`). 💡 Většina případů u tohoto pravidla využívá prostý text, ale proměnné jsou podporovány. **6\. Jaký význam má funkce „Odstranit řádky bez hodnot“?** Tato funkce automaticky **smaže všechny prázdné řádky** v pravidle, u kterých chybí hodnota v poli **„Nová hodnota“**. Díky tomu se pravidlo přehledněji udržuje a nezpomalí při vyhodnocování. **7\. Co se stane, pokud produkt spadá do více výběrů najednou?** Mergado zpracovává řádky **shora dolů**. Pokud produkt odpovídá více výběrům, použije se **hodnota z posledního shora uvedeného řádku**, který produkt splňuje. Pořadí řádků tedy ovlivňuje výsledek. **8\. Mohu pomocí pravidla nastavit CPC pro různé produktové kategorie?** Ano. Vytvořte pro každou kategorii samostatný výběr (např. „Kuchyňské spotřebiče“, „Mobilní telefony“) a v poli **„Nová hodnota“** u každého řádku zadejte odpovídající CPC (např. `15`, `25`, `30`). Tímto způsobem lze nastavit **různé hodnoty CPC** pro různé produktové segmenty. **9\. Jak mohu tímto pravidlem nastavit různé výrobce (brand) pro různé produkty?** Vytvořte výběry produktů podle potřeby (např. podle názvu, kategorie nebo dodavatele). Poté v poli **„Element“** vyberte `g:brand` a v pravém sloupci **„Nová hodnota“** zadejte názvy výrobců: * Výběr „Boty“ → hodnota: `Nike` * Výběr „Batohy“ → hodnota: `Osprey` * Výběr „Trička“ → hodnota: `Adidas`. **10\. Jak použít pravidlo pro nastavení štítků (custom\_label) podle cenové hladiny?** V levém sloupci vytvořte výběry podle ceny (např. `Cena 1000`). V pravém sloupci do pole **„Nová hodnota“** zadejte štítky: * Výběr 1 → `label_low` * Výběr 2 → `label_medium` * Výběr 3 → `label_high`. Tímto způsobem přiřadíte produktům dynamické štítky podle jejich ceny. **11\. Mohu pomocí pravidla odstranit hodnotu u vybraných produktů?** Ano. Pokud v poli **„Nová hodnota“** ponecháte řádek prázdný, Mergado daný element **vymaže** u všech produktů, které do daného výběru spadají. **12\. Dá se pravidlo naplánovat, aby se spouštělo jen v určitých dnech (např. při sezónní kampani)?** Ano. Pomocí **Časovače** můžete určit, kdy má být pravidlo aktivní – například **pouze o víkendech**, nebo **v konkrétním datovém rozmezí** (např. 1.–15. července). To se hodí pro dočasné úpravy jako **sezónní štítky, akční CPC** nebo **promo značky**. **13\. Jak poznám, které výběry už pravidlo využívá?** V levém sloupci jsou uvedeny všechny aktivní výběry použité v pravidle. Pokud jste použili funkci **„Předvyplnit levou stranu“**, zobrazí se zde kompletní seznam všech výběrů projektu. Můžete ručně smazat nebo upravit ty, které nechcete použít. **14\. Co se stane, pokud v poli „Nová hodnota“ použiju chybnou proměnnou nebo prázdnou hodnotu?** Pokud Mergado proměnnou nerozpozná, zůstane element **beze změny**. Taková proměnná bude mít **červené pozadí** místo zeleného, což signalizuje chybu nebo neexistující element. Prázdná hodnota naopak způsobí, že element bude **vymazán** (nahrazen prázdným řetězcem). Doporučuje se proto pravidlo otestovat na menším vzorku produktů pomocí **Průchodu pravidly**. **15\. Můžu tímto pravidlem měnit více elementů najednou?** Ne. V rámci jednoho pravidla „Hromadné přepisování dle výběru“ lze pracovat pouze s **jedním vybraným elementem** (např. `g:brand` nebo `HEUREKA_CPC`). **16\. Jak zkontroluji, jestli se změny aplikovaly správně?** Po **uložení a aplikování pravidel nebo po přegenerování feedu** otevřete **náhled produktů** nebo použijte funkci **„Průchod pravidly“**. Uvidíte, jak se hodnota elementu mění podle zvolených výběrů a zda se nová data správně propsala do výstupu. **17\. Je možné použít toto pravidlo i pro doplňování GPSR údajů nebo jiných legislativních informací?** Ano. Pomocí výběrů můžete určit, které produkty spadají pod konkrétní legislativu (např. kosmetika, potraviny). V poli **„Element“** vyberte příslušný element (např. `g:responsible_person`) a v poli **„Nová hodnota“** zadejte odpovědnou osobu nebo subjekt. --- ## [Pravidlo: Nastavení ceny dopravy](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-nastaveni-ceny-dopravy/) # Pravidlo: Nastavení ceny dopravy ## **Pravidlo: Nastavení ceny dopravy** Toto pravidlo slouží k jednoduchému nastavení dopravců a cen dopravy pro vaše produkty. Umožňuje hromadně doplnit dopravce a cenu za dopravu, ať už číselnou hodnotou, nebo proměnnou. **Zdroje** * [Nastavení ceny dopravy – Mergado Fórum](https://forum.mergado.cz/t/nastaveni-ceny-dopravy/1977) * [Video: Jak nastavit cenu dopravy v Mergadu](https://youtu.be/EVO8eOPqxyg?si=D5KPplZsmeCd-ATY) **Extra funkce** * Hromadné kopírování hodnot například: z Google Sheets * Odstranění řádků bez ceny * Předdefinovaný seznam dopravců \+ možnost přidat nové * Do ceny lze zadat číselnou hodnotu nebo proměnnou * Možnost přidat více řádků **Konkrétní příklady** Příklad 1: Přidat cenu dopravy ke všem nebo jen vybraným produktům * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavení ceny dopravy**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplnění dopravců:** * V poli **Dopravce** uveďte název společnosti (například *Zásilkovna*, *DPD*, *Česká pošta*). * Můžete použít **předdefinovaný seznam dopravců** nebo přidat **nové dopravce** podle potřeby. * Počet řádků není omezen – přidejte tolik dopravců, kolik potřebujete. * **Nastavení ceny za dopravu** * V poli **Při platbě předem** zadejte hodnotu ceny dopravy. * Lze zadat: * **konkrétní číselnou hodnotu** (například `89`), nebo * **proměnnou**, která obsahuje cenu z feedu (například `%delivery_price%`). * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například “*Nastavení ceny dopravy”.* Příklad 2: Přepsat existující cenu u konkrétního dopravce * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavení ceny dopravy**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplnění dopravců:** * V poli **Dopravce** uveďte název společnosti u kterého chcete hodnotu přepsat (například *Zásilkovna*, *DPD*, *Česká pošta*). * **Nastavení ceny za dopravu** * V poli **Při platbě předem** zadejte novou hodnotu ceny dopravy. * Lze zadat: * **konkrétní číselnou hodnotu** (například `89`), nebo * **proměnnou**, která obsahuje cenu z feedu (například `%delivery_price%`). * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například *„DPD – nová cena dopravy“*. Příklad 3: Nastavit dopravu zdarma pro všechny nebo jen vybrané produkty * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavení ceny dopravy**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplnění dopravců:** * V poli **Dopravce** uveďte název společnosti (například *Zásilkovna*, *DPD*, *Česká pošta*). * Můžete použít **předdefinovaný seznam dopravců** nebo přidat **nové dopravce** podle potřeby. * Počet řádků není omezen – přidejte tolik dopravců, kolik potřebujete. * **Nastavení ceny za dopravu** * V poli **Při platbě předem** zadejte novou číselnou hodnotu. * V našem případě zadejte **0**, protože doprava bude zdarma. * 💡 **Tip:** Pokud máte více dopravců, můžete zadat nulovou hodnotu pro všechny nebo jen pro vybrané dopravce. * **Pojmenování pravidla**: * V posledním kroku zadejte název pravidla, například: “*Doprava zdarma”.* Příklad 4: Nastavit dopravu zdarma jen o víkendu * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavení ceny dopravy**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplnění dopravců:** * V poli **Dopravce** uveďte název společnosti (například *Zásilkovna*, *DPD*, *Česká pošta*). * Můžete použít **předdefinovaný seznam dopravců** nebo přidat **nové dopravce** podle potřeby. * Počet řádků není omezen – přidejte tolik dopravců, kolik potřebujete. * **Nastavení ceny za dopravu** * V poli **Při platbě předem** zadejte novou číselnou hodnotu. * V našem případě zadejte **0**, protože doprava bude zdarma. * 💡 **Tipp:** Pokud máte více dopravců, můžete zadat nulovou hodnotu pro všechny nebo jen pro vybrané dopravce. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například *„Doprava zdarma – víkend“*. * **Nastavení časovače pro pravidlo** * Přejděte do **dolní části stránky** a klikněte na tlačítko **„Další možnosti“**. * Po rozbalení sekce klikněte na **„Zapnout časovač“**. * Otevře se tabulka, ve které můžete určit **dny a hodiny**, kdy bude pravidlo aktivní. * Aktivní časové sloty jsou označeny **fajfkou (✓)**. * V našem případě vyberte **pátek, sobotu a neděli**. * Ostatní dny (pondělí–čtvrtek) **ponechte neaktivní**. * V horní části časovače můžete volitelně nastavit **datum platnosti** (od kdy a do kdy má být pravidlo aktivní). * Pokud tyto hodnoty nenastavíte, pravidlo bude platit **od okamžiku uložení**, dokud **časovač nevypnete**. Příklad 5\. Odstranění vybraného dopravce z feedu FAQ: **1\. K čemu pravidlo slouží?** Pomocí tohoto pravidla můžete **hromadně doplnit dopravce a ceny dopravy** ke všem nebo jen vybraným produktům. Hodnotu lze zadat jako **konkrétní číslo** nebo **proměnnou** obsahující cenu z feedu. **2\. Lze nastavit různé ceny pro různé dopravce?** Ano. Pro každý řádek můžete zadat jiného dopravce (např. Zásilkovna, DPD, Česká pošta) i jinou cenu dopravy. Počet řádků není omezen. **3\. Dá se zadat cena jako proměnná?** Ano. Místo pevné částky můžete použít proměnnou, například `%delivery_price%`. Tím se cena automaticky načítá z feedu. **4\. Jak nastavit dopravu zdarma pro všechny produkty?** V poli **„Při platbě předem“** zadejte hodnotu **0**. Tím nastavíte dopravu zdarma pro všechny produkty, které spadají do vybraného výběru. **5\. Dá se doprava zdarma nastavit jen pro vybrané produkty?** Ano. V poli **„Výběr“** zvolte uložený produktový výběr – například produkty s cenou vyšší než 1000 Kč – a zadejte cenu dopravy **0**. Pravidlo se aplikuje jen na tento výběr. **6\. Lze přepsat existující cenu dopravy?** Ano. Pokud pro stejného dopravce existuje ve feedu cena, pravidlo ji přepíše novou hodnotou. Hodnoty ostatních dopravců zůstanou beze změny. **7\. Jak přidat nového dopravce, který není v seznamu?** Stačí do pole **„Dopravce“** napsat jeho název ručně – například „GLS“ nebo „PPL Express“. **8\. Dá se nastavit více dopravců najednou?** Ano. Do pravidla přidejte další řádky – pro každý dopravce jeden – a u každého nastavte jinou cenu. Pravidlo pak při přegenerování feedu vytvoří odpovídající záznamy. **9\. Dá se pravidlo časově omezit (např. doprava zdarma o víkendu)?** Ano. V sekci **„Další možnosti“** zapněte **časovač pravidla** a zvolte dny nebo časové sloty, kdy má být pravidlo aktivní. Můžete tak například nastavit, aby doprava zdarma platila jen od pátku do neděle. **10\. Co se stane, pokud se dopravce v projektu nevyskytuje?** Mergado dopravce automaticky vytvoří jako nový záznam. Díky tomu nemusíte dopravce předem zakládat ručně. **11\. Jak ověřím, že pravidlo funguje správně?** Po uložení **a přegenerování feedu** otevřete stránku **Elementy** → `shipping` (nebo příslušný element podle formátu). Zkontrolujte, že se noví dopravci a jejich ceny zobrazují správně. Mimo to můžete výsledek ověřit také: * na stránce Produkty, kde se nově nastavené hodnoty projeví v přehledu produktů, nebo * přímo ve výstupním feedu, který si otevřete v prohlížeči a vyhledáte konkrétní element. 💡 Pro detailní kontrolu jednotlivých produktů můžete použít funkci Průchod pravidly, která zobrazí, jak se pravidlo na daný produkt aplikovalo. --- ## [Pravidlo: Sloučení variant](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-slouceni-variant/) # Pravidlo: Sloučení variant ## **Pravidlo: Sloučení variant** Toto pravidlo je určeno pro **převod více samostatných produktů**, typicky **produktových variant**, které ve vstupním feedu tvoří skupinu položek sdruženou (nejčastěji) pomocí elementu **`ITEMGROUP_ID`**. Pravidlo umožňuje **sjednotit varianty produktu** pod jednu hlavní položku (tzv. *Master produkt*), čímž dojde k zjednodušení feedu a správné prezentaci produktů v e-shopových platformách nebo marketingových nástrojích. **Zdroje** * [Sloučení variant | Mergado Fórum](https://forum.mergado.cz/t/slouceni-variant/2795) **Extra funkce** * Výběr společných elementů (pouze pro vybrané formáty) * Předvyplnění levé strany * Možnost přidat více řádků * Pravidlo je dostupné pouze pro vybrané formáty * Shoptet Kompletní a Dodavatelský * Upgates Produkty * Woocommerce CSV * Shopify CSV * Samba.ai **Konkrétní příklady:** Příklad 1: Sloučení variantních produktů z Heureka feedu pro Shoptet * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Sloučení variant**. * **Element pro výběr Master položky** * Toto pole slouží k definici elementu, který se použije pro výběr hlavní (tzv. *Master*) položky. * Master položka je ta, pod kterou budou ostatní varianty sdruženy. * Systém hledá položku, která odpovídá logice zvoleného elementu – např. u **`ITEM_ID`** se použije položka s **nejnižším ID** jako hlavní. * **V našem případě použijeme:** `ITEM_ID`. * 💡 **Tip:** Master položka představuje produkt, který bude po sloučení viditelný jako hlavní produkt. Ostatní varianty zůstávají připojené, ale samostatně se již nevypisují. * **Element se sdružovacím kódem** * Tento element určuje, **jakým způsobem se varianty poznají**, že patří k sobě. * Element musí obsahovat **shodnou hodnotu u všech variant** jednoho produktu. * Nejčastěji se používá element **`ITEMGROUP_ID`**. * **V našem případě použijeme:** `ITEMGROUP_ID`. * 💡 **Tip:** Kód ve sdružovacím elementu musí být **totožný** u všech variant jednoho produktu. Např. všechny varianty trička s různými velikostmi (S, M, L) budou mít stejný `ITEMGROUP_ID`. * **Parametry tvořící variantu produktu** * V Selectbox poli **Parametry tvořící variantu produktu** vyberte všechny parametry, které tvoří varianty produkty, např. Barva, Velikost, atd. * **💡Tip:** Pole je multiselect, takže můžete vybrat více parametrů * **Maximální počet parametrů, které tvoří variantu** * V Selectbox poli **Maximální počet parametrů, které tvoří variantu** zvolte, kolik parametrů bude tvořit variantu, např. 2 * **Výběr společných elementů:** * V sekci **„Pokročilé nastavení“** vyberte elementy, které jsou **společné pro všechny varianty** daného produktu. * Tyto elementy se po sloučení zapíší **pouze do hlavní (Master) položky**, zatímco u variant se **už nebudou opakovat**. * například: `CATEGORYTEXT, DESCRIPTION, IMGURL` * V poli **„Element“** (levý sloupec) vyberte ze Selectboxu element, který chcete nastavit jako společný pro všechny varianty. * Pro přidání více elementů přidejte nové řádky * V poli **„Typ akce“** (pravý sloupec) určete, **jak se má Mergado zachovat při slučování různých hodnot**: * **Převzít z master položky** * Vezme se hodnota pouze z hlavní položky, ostatní hodnoty se zahodí. * Příklad: `CATEGORYTEXT` nebo `DESCRIPTION`, protože jsou hodnoty stejné pro všechny varianty * **Sluč hodnoty a odstraň duplicity** * Mergado vezme všechny **unikátní hodnoty** vybraného elementu a sloučí je do seznamu. * Příklad: `IMGURL`, protože varianty mohou mít různou URL obrázku a chceme je zachovat všechny * **💡Tip:** tato sekce je dostupná jen pro slučování variant v XML feedech (Shoptet, Upgates, Samba AI) * **💡Tip:** Mergado vybere elementy samo, stačí tak nastavení pouze zkontrolovat. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Slučování variant*”. FAQ: **1\. K čemu slouží pravidlo Sloučení variant?** Pravidlo umožňuje **sjednotit více produktových variant do jednoho hlavního produktu (tzv. Master produktu)**. Využívá se zejména tehdy, když se ve feedu varianty (např. různé barvy, velikosti nebo rozměry) zobrazují jako samostatné produkty a je potřeba je seskupit pod jeden produkt. **2\. Pro jaké formáty je pravidlo dostupné?** Pravidlo lze použít pouze pro vybrané formáty, které podporují práci s variantami: * **Shoptet (Kompletní i Dodavatelský feed)** * **Upgates Produkty** * **WooCommerce CSV** * **Shopify CSV** * [**Samba.ai**](http://Samba.ai) Pokud potřebujete podporu pro jiný formát, napište nám na mergado@mergado.cz **3\. Co znamená element „Master položky“ a jak se určuje?** Master položka je **hlavní produkt**, pod který se všechny varianty seskupí. V poli *Element pro výběr Master položky* zvolíte prvek (např. `ITEM_ID`), podle kterého se určí, která varianta bude hlavní. Nejčastěji se vybírá položka s **nejnižším ID** nebo první výskyt ve feedu. **4\. K čemu slouží element se sdružovacím kódem?** Tento element (nejčastěji `ITEMGROUP_ID`) určuje, **které produkty patří do jedné skupiny variant**. Všechny varianty jednoho produktu musí mít stejný kód v tomto elementu – např. tričko ve velikostech S, M, L bude mít stejné `ITEMGROUP_ID`. **5\. Co se stane, pokud některé produkty nemají `ITEMGROUP_ID`?** Takové produkty **nebudou sloučeny**, protože Mergado nedokáže rozpoznat, které položky patří k sobě. Doporučuje se proto předem zkontrolovat, zda element `ITEMGROUP_ID` existuje a obsahuje hodnoty u všech variant. **6\. Jak nastavit parametry, které tvoří variantu produktu?** V poli **„Parametry tvořící variantu produktu“** vyberte všechny atributy, podle kterých se varianty liší – např. *Barva*, *Velikost*, *Materiál*. Pole podporuje **multiselect**, takže můžete vybrat více parametrů najednou. **7\. K čemu slouží „Maximální počet parametrů, které tvoří variantu“?** Určuje, kolik parametrů se bude brát v úvahu při seskupování variant. Např. pokud mají varianty dvě vlastnosti (barvu a velikost), nastavte hodnotu **2**. Tím Mergado zajistí, že kombinace parametrů bude správně seskupena. **8\. Co dělá sekce „Výběr společných elementů“?** Slouží k určení elementů, které jsou **stejné pro všechny varianty** a mají být zachovány pouze u Master produktu. Např. `CATEGORYTEXT`, `DESCRIPTION` nebo `BRAND`. Tyto hodnoty se uloží jen do hlavního produktu, aby se zbytečně neopakovaly u každé varianty. **9\. Jaký je rozdíl mezi akcemi „Převzít z Master položky“ a „Sluč hodnoty a odstraň duplicity“?** * **Převzít z Master položky:** použije se hodnota pouze z hlavního produktu (ostatní se ignorují). Typicky se používá pro texty nebo kategorie. * **Sluč hodnoty a odstraň duplicity:** spojí všechny unikátní hodnoty ze všech variant, např. obrázky (`IMGURL`). **10\. Dá se pravidlo použít i pro produkty bez variant?** Ano, ale nemá to efekt — produkty bez sdružovacího kódu (`ITEMGROUP_ID`) zůstanou nezměněny. Pravidlo se použije pouze na položky, které splňují podmínku společného kódu. **11\. Co se stane, pokud mají varianty různé hodnoty v elementu, který má být společný?** Záleží na nastavené akci: * Pokud je zvoleno **„Převzít z Master položky“**, Mergado zachová pouze hodnotu Master produktu. * Pokud je zvoleno **„Sluč hodnoty a odstraň duplicity“**, Mergado spojí všechny hodnoty do jednoho seznamu a odstraní duplicity. **12\. Jak poznám, že sloučení variant proběhlo správně?** Po **uložení a aplikování pravidel** nebo **přegenerování feedu**: * Otevřete výstupní feed a zkontrolujte, že produkty se správně seskupily pod jeden Master produkt. **13\. Dá se pravidlo použít i pro slučování obrázků variant?** Ano. Pomocí nastavení **„Sluč hodnoty a odstraň duplicity“** můžete spojit URL adresy obrázků ze všech variant do jednoho elementu `IMGURL`. Tím zajistíte, že hlavní produkt bude mít všechny relevantní obrázky. **14\. Co dělat, pokud se varianty nespárují správně?** Zkontrolujte, že: * všechny varianty mají stejné `ITEMGROUP_ID`, * parametry variant jsou vyplněné a odpovídají hodnotám ve feedu, * v pravidle není chybně nastavený element pro Master položku. 💡 Pokud problém přetrvává, zkuste vytvořit testovací projekt s menším počtem produktů a otestovat logiku slučování. **15\. Lze po sloučení variant původní varianty z feedu odstranit?** Ano, Mergado je **skryje automaticky** — na výstupu zůstane pouze Master produkt. Varianty zůstávají v projektu pro referenci, ale do výstupního feedu se již nezapíší. **16\. Dá se výsledek sloučení exportovat pro kontrolu nebo zálohu?** Ano. Otevřete výstupní feed a zkontrolujte, že produkty se správně seskupily pod jeden Master produkt. **17\. Dá se toto pravidlo kombinovat s pravidlem „Výpočet“ nebo „Přepsat“?** Ano, ale pravidlo **Sloučení variant** bude v pořadí pravidel automaticky vždy poslední. Nejprve se tedy upraví hodnoty elementů, a až potom se varianty sloučí. --- ## [Pravidlo: Hromadné přejmenování kategorií*](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-hromadne-prejmenovani-kategorii/) # Pravidlo: Hromadné přejmenování kategorií* ## **Pravidlo: Hromadné přejmenování kategorií** Toto pravidlo umožňuje **hromadně přepsat nebo napárovat kategorie** z e-shopu na odpovídající kategorie konkrétního srovnávače. **Zdroje** * [Hromadné přejmenování kategorií | Mergado Fórum](https://forum.mergado.cz/t/hromadne-prejmenovani-kategorii/1990) **Extra funkce** * Hromadné kopírování kategorií například: z Google Sheets * Hromadné zkopírování celé struktury kategorií * **Předvyplnit levou stranu** – automatické natažení kategorií z e-shopu * **Navrhnout kategorie** – Mergado podle podoby klíčových slov doporučí 3 kategorie na které je možné každou vstupní kategorii namapovat * **Řazení kategorií** – možnost upravit pořadí řádku s kategoriemi a tím ovlivnit pořadí v jakém budou řádky aplikovány * **Našeptávání** kategorií ze stromu konkrétního srovnávače **Konkrétní příklady** **Příklad 1:** Napárovat kategorie e-shopu na Google kategorie * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přejmenování kategorií**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplňte kategorie ze vstupu:** * V levém sloupci **„Pokud aktuální kategorie obsahuje“** zadejte všechny kategorie z e-shopu, které chcete napárovat. * 💡 **Tip:** Klikněte na **šipku** vedle tlačítka **„**Navrhnout kategorie**“** a klikněte na **„Předvyplnit levou stranu“** a Mergado vám automaticky načte všechny existující kategorie. * **Pořadí kategorií je důležité** – pravidlo řádky aplikuje postupně od shora dolů. * Vyplňte kategorie na které se má přepsat * V pravém sloupci **„Přepíše se touto kategorií“** zadejte vhodnou kategorii pro konkrétní platformu. * Nové hodnoty můžete: * napsat přímo textovou hodnotu, * využít našeptávač (např. klíčové slovo a výběr z nabízených kategorií), * u Google formátu využít funkci **„Navrhnout kategorie“**, která na základě podoby klíčových slov doporučí každé vstupní kategorii 3 možné kategorie ze stromu kategorií Google. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Párování kategorií na Google kategorie*”. **Příklad 2:** Přepsat kategorie e-shopu v elementu (např. `CATEGORY`) * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přejmenování kategorií**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplňte kategorie ze vstupu:** * V levém sloupci **„Pokud aktuální kategorie obsahuje“** zadejte všechny kategorie z e-shopu, které chcete napárovat. * 💡 **Tip:** Klikněte na **„Předvyplnit levou stranu“** a Mergado vám automaticky načte všechny existující kategorie. * **Pořadí kategorií je důležité** – řádky se aplikují postupně od shora dolů. * **Vyplňte kategorie na které se má přepsat** * V poli na pravé straně “**Přepíše se toutu kategorií”** vyplňte kategorie dané platformy * Nové hodnoty můžete: * rovnou napsat textovou hodnotu * využít (u vybraných formátů) našeptávač, kde stačí napsat klíčové slovo, a vybrat z nabízených kategorii * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Přejmenování kategorii*”. **Příklad 3**: Přepsat kategorie dodavatele na vlastní kategorie Tento příklad ukazuje, jak nastavit k produktům **kategorie z vašeho e-shopu**, místo kategorií dodavatele. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Hromadné přejmenování kategorií**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Vyplňte kategorie ze vstupu:** * V poli na levé straně “**Pokud aktuální kategorie obsahuje”** můžete vypsat všechny kategorie dodavatele ze vstupního feedu * **💡Tip**: použijte tlačítko “**Předvyplnit levou stranu**”, který vám automaticky vytáhne všechny vstupní kategorie. * Na pořadí kategorií záleží \- řádky se aplikují postupně od shora dolu * **Vyplňte kategorie na které se má přepsat** * V pravém sloupci **„Přepíše se touto kategorií“** zadejte vlastní cílové kategorie e-shopu. * Nové hodnoty lze: * zadat ručně jako textovou hodnotu * kopírovat a vložit z tabulky (zaškrtněte checkbox **„Režim chytrého vkládání“**), * využít **našeptávač**, pokud máte importovaný vlastní strom kategorií. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “*Přejmenování kategorii dodavatele na kategorie e-shopu*”. FAQ: **1\. K čemu slouží pravidlo Hromadné přejmenování kategorií?** Pravidlo umožňuje **hromadně upravit nebo napárovat kategorie** ze vstupního feedu (např. e-shopu nebo dodavatele) na cílové kategorie požadované konkrétní platformou – typicky Google, Heureka, Zboží.cz nebo Glami. Pomáhá sjednotit strukturu kategorií, což zjednodušuje exporty a zvyšuje kvalitu dat. **2\. Jaký je rozdíl mezi přejmenováním a napárováním kategorií?** V rámci tohoto pravidla mají pojmy stejný význam. Pravidlo páruje vstupní kategorie na kategorie výstupního formátu. Namapovanou hodnotu přepíše do správného elementuů. **3\. Musím vstupní kategorie e-shopu zadávat ručně, nebo je Mergado umí načíst samo?** Nemusíte je vypisovat ručně. Pomocí funkce **„Předvyplnit levou stranu“** Mergado automaticky načte všechny vstupní kategorie ze zdrojového feedu. Tím si ušetříte práci a minimalizujete chyby při přepisování. **4\. Jak funguje funkce „Navrhnout kategorie“?** Mergado podle **klíčových slov v názvech vstupních kategorií** automaticky nabídne tři možné odpovídající kategorie ze stromu vybraného srovnávače (např. Google nebo Heureka). Z návrhů jde vybrat jeden správný výsledek, nebo hledat ručně lepší alternativu. **5\. Jaký význam má pořadí řádků v pravidle?** Pořadí je velmi důležité. Mergado **aplikuje řádky shora dolů** a pro levý sloupec platí “pokud element se vstupními kategoriemi hodnotu **OBSAHUJE**” (tedy ne že se hodnoty rovnají). Doporučuje se proto řadit obecnější kategorie nahoru a nejpřesnější kategorie dolů. **6\. Mohu vložit už namapované kategorie hromadně z tabulky (např. z Google Sheets)?** Ano. Aktivujte checkbox **„Režim chytrého vkládání“** a vložte dvojice kategorií (vstupní → cílové) přímo z tabulky. Mergado automaticky rozdělí hodnoty do odpovídajících polí, což je ideální pro rozsáhlé mapování. **7\. Dá se použít i pro přejmenování kategorií od více dodavatelů najednou?** Ano. Pravidlo můžete aplikovat na produkty z různých dodavatelských feedů a sjednotit je do jedné kategorie e-shopu. V případě většího počtu dodavatelů je vhodné použít více pravidel, aby byla struktura přehlednější. **8\. Jak se chová pravidlo, pokud některé kategorie ve vstupním feedu chybí?** Pokud produkt danou kategorii nemá, **pravidlo se na něj neaplikuje**. Pro tyto případy můžete vytvořit samostatné pravidlo typu **„Přepsat“**, kterým prázdné kategorie doplníte výchozí hodnotou (např. „Nezařazeno“). **9\. Lze kombinovat textový zápis kategorií s proměnnými?** Ano. Do pole „Přepíše se touto kategorií“ můžete vložit **kombinaci textu a proměnných**, např.: `%CATEGORY% | %brand%`, což vytvoří komplexnější strukturu pro export. **10\. smazáno** **11\. Dá se pravidlo naplánovat, například pro sezónní přemapování kategorií?** Ano. Můžete použít **časovač pravidla** a určit, kdy se má aplikovat — např. při přechodu ze sezónního sortimentu (Zima → Léto). Po uplynutí zadaného intervalu se pravidlo prestane automaticky aplikovat. **12\. Jak poznám, že přemapování kategorií proběhlo správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu**: * otevřete detail produktu a zkontrolujte, že kategorie odpovídá výstupu, * nebo použijte funkci **Průchod pravidly**, která ukáže, jak se hodnota elementu změnila po aplikaci pravidla. **13\. Co se stane, pokud je stejná vstupní kategorie uvedena vícekrát?** Mergado použije **poslední výskyt** (podle pořadí řádků). **14\. Lze exportovat vytvořené mapování kategorií pro zálohu nebo další projekty?** Ano. V rozšířených funkcích projektu lze exportovat data pravidla do **CSV** nebo **Google Sheets**, a ta následně použít v jiném projektu. Je to ideální způsob pro přenos mapování mezi projekty nebo jazykovými verzemi e-shopu. **15\. smazáno** **16\. Co dělat, když se kategorie nespárují správně?** Zkontrolujte, že: * kategorie ve vstupu odpovídají přesně textem nebo obsahem hledané hodnotě, * nepoužíváte zbytečné mezery nebo jiné znaky, * a pořadí řádků odpovídá logice přemapování. 💡 V případě složitějších struktur použijte dočasné testovací pravidlo pouze pro několik řádků. **17\. Dá se tímto pravidlem úplně odstranit kategorie?** Ne. Pokud chcete kategorii odstranit, použijte pravidlo **„Přepsat“** a zadejte **prázdnou hodnotu** pro daný element. Pravidlo „Hromadné přejmenování kategorií“ slouží výhradně k nahrazení nebo mapování hodnot, nikoliv k jejich mazání. --- ## [Pravidlo: Přičtení dnů k datu](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-pricteni-dnu-k-datu/) # Pravidlo: Přičtení dnů k datu ## **Pravidlo: Přičtení dnů k datu** Toto pravidlo zapíše do zvoleného elementu **datum, které odpovídá dnešnímu datu plus počtu dní, které zadáte**. Díky tomu můžete mít například **vždy aktuální datum očekávaného dodání**. Pravidlo se využívá **nejčastěji u Google formátů**, konkrétně u **dostupnosti produktů**, když je v elementu **`availability`** uvedena hodnota **`preorder`** nebo **`backorder`**. V těchto případech je totiž nutné doplnit také **konkrétní datum** dostupnosti. **Zdroje** * [https://forum.mergado.cz/t/novinky-a-release-v-mergadu/633/174](https://forum.mergado.cz/t/novinky-a-release-v-mergadu/633/174) **Extra funkce** * Pravidlo dokáže přepisovat hodnotu u více výběrů * Ukázka výstupní hodnoty \- slouží ke kontrole * Výsledná hodnota elementu po aplikování pravidla je datum: 2025-10-16T16:13:19 * Formáty k použití: * **YYYY-MM-DD** \- Rok-Měsíc-Den (standard ISO 8601\) * **YYYY-MM-DDTHH:MM:SS** \- Datum a čas s oddělovačem “T” (např. 2025-06-24T12:46:12) * **YYYY/MM/DD** \- Rok/Měsíc/Den s lomítky * **DD/MM/YYYY** \- Den/Měsíc/Rok (evropský formát) * **MM/DD/YYYY** \- Měsíc/Den/Rok (americký formát) * **YYYYMMDD** \-Kompaktní formát bez oddělovačů * **DD.MM.YYYY** \- Den.Měsíc.Rok * Unix timestamp \- Počet sekund od 1\. 1\. 1970 (pro systémy a API) **Konkrétní příklady:** **Příklad 1:** Nastavení elementů expiration\_date a availability\_date pro Google feedy Tento příklad ukazuje, jak jednoduše nastavit **datum vypršení platnosti** (`expiration_date`) a **dostupnosti** (`availability_date`), pokud má produkt ve feedu hodnotu `preorder` nebo `backorder`. V těchto případech je nutné uvést i **konkrétní termín**, jinak Google feed nebude kompletní. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Přičtení dnů k datu**. * **Volba elementu pro změnu**: * V poli **Element** vyberte prvek, **do kterého se má zapsat výsledné datum**. * V našem případě to může být například [`[expiration_date]`](https://support.google.com/merchants/answer/12471622) nebo `[availability_date]` * **Zvolte formát zápisu** * Ze seznamu vyberte následující formát, který je pro Google vhodný: **YYYY-MM-DDTHH:MM:SS** * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr,** pokud chcete pravidlo aplikovat jen na určité produkty (např. g:availability \= `preorder`) * **Zadejte počet dní k navýšení** * V poli **„O kolik dní se zvýší“** zadejte číselnou hodnotu, o kolik dní chcete posunout dnešní datum. * Například: `5` znamená, že výsledné datum bude dnešek \+ 5 dní. * **Kontrola výsledku** * Ve sloupci “**Ukázka výstupní hodnoty”** se zobrazí výsledná hodnota, která bude zapsána do výstupního feedu. * Například: `2025-10-21T16:13:19`. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení data dostupnosti pro preorder produkty”. FAQ: **1\. K čemu pravidlo Přičtení dnů k datu slouží?** Pravidlo automaticky zapíše do vybraného elementu **aktuální datum posunuté o zadaný počet dní**. Nejčastěji se používá pro nastavení hodnot jako `availability_date` nebo `expiration_date` v Google feedech – typicky u produktů s hodnotou *preorder* nebo *backorder*. **2\. V jakých situacích je toto pravidlo nejčastěji potřeba?** Používá se především pro: * doplnění povinných datumů do Google feedů, * zajištění, že datum dostupnosti bude vždy aktuální, * automatické prodlužování datumů (např. `expiration_date` \+ 30 dní). **3\. Jaký formát data mám použít pro Google Merchant feedy?** Pro Google formáty je doporučený formát: 👉 **`YYYY-MM-DDTHH:MM:SS`** Příklad: `2025-06-24T12:46:12` Tento formát obsahuje jak datum, tak čas a odpovídá standardu ISO 8601, který Google vyžaduje. **4\. Dá se vybrat jiný formát data?** Ano. Mergado podporuje různé formáty, například: * `YYYY-MM-DD` (např. 2025-10-16) * `DD.MM.YYYY` (např. 16.10.2025) * `YYYY/MM/DD` * `YYYYMMDD` * nebo i `Unix timestamp` (např. 1739625600\) 💡 To se hodí při exportech do systémů, které používají vlastní formát dat. **5\. Co znamená pole „O kolik dní se zvýší“?** Do tohoto pole zadáte **počet dní, o které se má dnešní datum posunout**. Např.: * Hodnota `+5` → dnešní datum \+ 5 dní * Hodnota `0` → dnešní datum Výsledek se ihned zobrazí ve sloupci *Ukázka výstupní hodnoty*. **6\. Dá se pravidlo použít pro více výběrů najednou?** Ano. Pravidlo podporuje **aplikaci na více produktových výběrů současně**, takže můžete různým skupinám produktů nastavit různé časové posuny (např. preorder \+5 dní, backorder \+14 dní). **7\. Můžu tímto pravidlem přepsat existující datum v elementu?** Ano. Pokud element (např. `availability_date`) už obsahuje hodnotu, pravidlo ji **nahradí nově vypočteným datem**. **8\. Dá se přičítání dnů kombinovat s jinými pravidly, například Výpočet nebo Přepsat?** Ano. Obvykle se používá v kombinaci s pravidlem **Přepsat**, pokud potřebujete předem doplnit prázdné elementy, nebo s pravidlem **Výpočet**, pokud chcete hodnotu upravit dynamicky podle jiného elementu. 💡 Doporučené pořadí: nejdříve doplňte / upravte data, až poté aplikujte „Přičtení dnů k datu“. **9\. Jak zjistím, jestli se datum do feedu opravdu propsalo správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu**: * zobrazte výstupní feed a zkontrolujte element `availability_date` nebo `expiration_date`, * nebo spusťte funkci **„Průchod pravidly“** u konkrétního produktu – uvidíte původní i novou hodnotu data. **10\. Můžu použít časovou složku (hodiny, minuty, sekundy)?** Ano. Ve formátu `YYYY-MM-DDTHH:MM:SS` můžete nastavit i konkrétní čas. Například `2025-10-21T08:00:00` zajistí, že produkt bude označen jako dostupný přesně od 8:00. **11\. Co se stane, když zadám zápornou hodnotu (např. \-2)?** Vyskočí chybová hláška. Pravidlo v poli počet dní neumí pracovat se zápornými čísly. Je tedy možné zadat pouze pozitivní číslo (0, 1, 2,...) **12\. Jaké jsou nejčastější chyby při použití pravidla?** * Nesprávný formát data (např. chybí časová složka u Google feedu). * Zápis do nesprávného elementu (`availability` místo `availability_date`). * Zadání příliš vysokého čísla (např. \+999), které může způsobit, že datum bude mimo reálný rozsah. 💡 Doporučuje se pravidlo otestovat na menším vzorku produktů. **13\. Můžu přičítat dny na základě hodnot z jiného elementu (např. podle skladové dostupnosti)?** Ne **14\. Je možné použít toto pravidlo i mimo Google feedy?** Ano. I když je nejčastěji využíváno pro Google Merchant feedy, můžete ho použít **v jakémkoliv formátu**, kde se pracuje s daty — například pro exporty do ERP systémů nebo vlastní XML struktury. --- ## [Pravidlo: Nastavení cen za prokliky](https://help.mergado.com/cs/mergado-editor/pravidla/knihovna-pravidel/pravidlo-nastaveni-cen-za-prokliky/) # Pravidlo: Nastavení cen za prokliky ## **Pravidlo: Nastavení cen za prokliky** Toto pravidlo umožňuje **nastavit individuální ceny za prokliky (CPC)** pro jednotlivé produkty. Pravidlo je určeno pro správu a optimalizaci **nabídek za proklik** v rámci porovnávačů zboží, jako jsou **Heureka** a **Zboží.cz**. Výpočet ceny za proklik lze provést dvěma způsoby: * **fixní částkou**, která se přičítá k minimální hodnotě CPC pro daný produkt, * nebo **procentem z prodejní ceny bez DPH**. **Extra funkce** * Pravidlo je dostupné pro formáty: * Heureka * Zboží.cz **Konkrétní příklady:** **Příklad 1**: Nastavit ceny za prokliky jako fixní částka Tento příklad ukazuje, jak nastavit nabídky za proklik na základě **fixní částky**, která se přičte k minimální CPC stanovené vyhledávačem. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavení cen za prokliky**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Stanovit nabídky za proklik dle:** * Ze **Selectboxu** *Stanovit nabídky za proklik dle* vyberte možnost **„Minimální ceny prokliku“**. * Vyhledávač zboží určuje **minimální cenu prokliku** pro každou kategorii. * Nabídka za proklik se vypočítá tak, že se tato minimální cena navýší o částku, kterou zadáte v dalším kroku. * **Přičíst k minimálnímu CPC (Kč)** * V poli **Přičíst k minimálnímu CPC (Kč)** zadejte částku, která se má přičíst k minimální ceně za proklik, například `10` * 💡 Tip: Tímto způsobem můžete jednoduše zvýšit nabídku všech produktů v určité kategorii o stejnou částku. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení CPC”. **Příklad 2**: Nastavit ceny za proklik jako procento z ceny produktu Tento příklad ukazuje, jak nastavit nabídky za proklik podle **procenta z ceny produktu bez DPH**. Výpočet automaticky zohledňuje minimální i maximální limity CPC stanovené vyhledávačem. * **Vytvoření nového pravidla**: * Otevřete stránku "Pravidla". * Klikněte na tlačítko **Nové pravidlo**. * **Výběr typu pravidla**: * V poli **Typ pravidla** vyberte možnost **Nastavení cen za prokliky**. * **Výběr produktů**: * V poli **Výběr** zvolte buď **Všechny produkty**, nebo vytvořte vlastní **Produktový výběr** pro specifické produkty, na které chcete pravidlo použít. * **Stanovit nabídky za proklik dle:** * Ze **Selectboxu** *Stanovit nabídky za proklik dle* vyberte možnost **„Procento z ceny zboží“**. * Nabídka za proklik bude stanovena jako **procento z ceny produktu bez DPH**. * Pokud produkt **neobsahuje informaci o DPH**, použije se **základní sazba DPH** pro výpočet. * Výpočet zároveň zohledňuje **minimální i maximální limity** ceny za proklik, které stanovuje vyhledávač. * **Procento z ceny produktu** * V poli **Procento z ceny produktu** zadejte číslo (0-100), které bude použito při výpočtu ceny za proklik, například `10` * Hodnota 10 znamená, že CPC \= 10 % z ceny produktu bez DPH. * 💡 Tip: Toto nastavení je vhodné pro produkty s různými cenovými hladinami – vyšší cena produktu → vyšší CPC, nižší cena → nižší CPC. * **Pojmenování pravidla** * V posledním kroku zadejte **název pravidla**, například “Nastavení CPC”. **Další využití pravidla** * Hromadné nastavení cen za proklik podle různých výběrů produktů. * Kombinace s pravidlem „Import datového souboru“ (např. pro import historických CPC hodnot z jiných systémů). * Automatické úpravy CPC podle marží nebo výkonu produktů (v kombinaci s rozšířením Pricing Fox nebo výpočtovými pravidly). FAQ: **1\. K čemu pravidlo „Nastavení cen za prokliky“ slouží?** Toto pravidlo umožňuje **nastavit individuální nabídky CPC (Cost Per Click)** pro produkty v porovnávačích zboží, jako jsou **Heureka** nebo **Zboží.cz**. Pomocí pravidla lze určit, zda se má CPC vypočítávat jako fixní částka navíc k minimální CPC, nebo jako **procento z ceny produktu bez DPH**. **2\. Pro které formáty je toto pravidlo dostupné?** Pravidlo lze použít pouze pro následující formáty: * **Heureka.cz** * **Zboží.cz** 💡 Pokud potřebujete pracovat s CPC i u jiných srovnávačů, lze použít pravidla **Výpočet** nebo **Import datového souboru**, kde lze s hodnotami CPC pracovat individuálně. **3\. Jaký je rozdíl mezi „Minimální cenou prokliku“ a „Procentem z ceny zboží“?** * **Minimální cena prokliku** – CPC se vypočítá jako *minimální hodnota* určená vyhledávačem **\+ vámi zadaná fixní částka**. Např. minimální CPC 3 Kč \+ přičíst 2 Kč \= výsledná nabídka 5 Kč. * **Procento z ceny zboží** – CPC se vypočítá jako určité **procento z ceny produktu bez DPH**, např. 10 % z 1000 Kč \= CPC 100 Kč (zohlední se však limity dané Heurékou/Zboží.cz). **4\. Co znamená pole „Přičíst k minimálnímu CPC (Kč)“?** Do tohoto pole zadáte **částku, která se přičte k minimální CPC hodnotě** stanovené vyhledávačem. Např. zadáte-li 10 Kč, a minimální CPC kategorie je 5 Kč → výsledná nabídka bude 15 Kč. **5\. Jak funguje nastavení „Procento z ceny produktu“?** Do pole zadáte číselnou hodnotu mezi **0–100**, která určí procento z ceny produktu bez DPH. Např.: * Produkt stojí 2000 Kč bez DPH * Zadané procento \= 5 👉 výsledná CPC \= 100 Kč Pokud produkt nemá vyplněnou hodnotu DPH, Mergado použije **základní sazbu DPH** pro výpočet. **6\. Jak se pravidlo chová, pokud produkt spadá do kategorie s omezením CPC?** Mergado respektuje **minimální i maximální limity** CPC stanovené vyhledávačem (např. Heureka má limity pro každou kategorii). To znamená, že pokud by výpočet překročil povolenou hranici, systém CPC **automaticky omezí na maximum povolené vyhledávačem**. **7\. Dá se pravidlo použít jen pro určitou skupinu produktů?** Ano. V poli **„Výběr“** můžete použít existující výběr produktů nebo vytvořit vlastní – např. * produkty s vyšší marží, * produkty nad určitou cenovou hladinou, * produkty v konkrétní kategorii. 💡 Díky tomu lze CPC řídit strategicky podle výkonu nebo segmentu sortimentu. **8\. Co se stane, pokud produkt nemá cenu bez DPH?** Pokud není v elementu s cenou bez DPH (`price_vat` nebo `price_excl_vat`) žádná hodnota, Mergado použije výchozí hodnotu se základní sazbou DPH (např. 21 %). Doporučuje se ověřit, že feed obsahuje konzistentní data o cenách. **9\. Dá se pravidlo použít pro hromadné změny CPC podle různých výběrů?** Ne. Pravidlo umožňuje aplikovat na více výběrů produktů – všem ale přiřadí stejnou výpočetní metodu (např. 5 % z ceny u jednoho výběru a \+10 Kč k minimu u jiného). Pokud potřebujete použít jinou logiku pro různé výběry, vytvořte pro každý výběr nové pravidlo, tím vytvoříte **automatizovanou cenovou strategii** pro různé segmenty produktů. **10\. Jak zjistím, zda se nová CPC hodnota aplikovala správně?** Po **uložení a aplikování pravidel** nebo po **přegenerování feedu**: * otevřete výstupní feed a zkontrolujte element s CPC (`HEUREKA_CPC`, `ZBOZI_CPC`), * nebo použijte funkci **„Průchod pravidly“**, která zobrazí, jak se hodnota CPC přepočítala pro konkrétní produkt. **11\. Lze kombinovat pravidlo s výpočtovými pravidly nebo importem dat?** Ano. Můžete např. kombinovat s: * pravidlem **Výpočet** – pro dynamické stanovení CPC podle marže nebo výkonu, * pravidlem **Import datového souboru** – pro načtení historických CPC nebo výkonnostních dat z Google Sheets. 💡 Doporučené pořadí: nejdříve importujte nebo vypočítejte hodnoty, poté vytvořte segmenty podle výsledků a následně aplikujte „Nastavení cen za prokliky“. **12\. Co když chci upravovat CPC dynamicky podle výkonu produktů?** V tom případě doporučujeme propojit Mergado s rozšířením **Bidding Fox**, které umožňují dynamicky přizpůsobovat CPC na základě marží, konverzí nebo konkurence. **13\. Dá se tímto pravidlem snižovat CPC?** Ne **14\. Co se stane, když produkt nepatří do žádné kategorie s minimálním CPC?** Mergado v takovém případě použije **výchozí minimální hodnotu CPC** (definovanou vyhledávačem) nebo zachová původní hodnotu, pokud není dostupný referenční údaj. **15\. Dá se pravidlo naplánovat?** Ano. Pomocí **časovače** můžete určit, kdy se má CPC aktualizovat – např. jednou týdně nebo v konkrétní den. To se hodí u kampaní, které se mění podle sezónnosti nebo reklamního kalendáře. **16\. Jaké jsou nejčastější chyby při nastavování CPC v Mergadu?** * Použití špatného typu výpočtu (např. procento z ceny, ale v jiném formátu feedu). * Nevyplněný element s cenou bez DPH. * Překročení maximální hodnoty CPC povolené vyhledávačem. * Nesprávné pořadí pravidel (např. aplikace před výpočtem nebo přepisem cen). 💡 Doporučení: vždy po nastavení otestujte pravidlo na menším počtu produktů pomocí funkce **„Průchod pravidly“**. --- ## [Jak zajistit napojení e-shopové platformy UNAS na Mergado Editor](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/napojeni-dat/jak-zajistit-napojeni-e-shopove-platformy-unas-na-mergado-editor/) # Jak zajistit napojení e-shopové platformy UNAS na Mergado Editor ## Jak napojit eshop provozovaný na platformě UNAS na Mergado Editor přes API ### 1. krok Nejprve je třeba v rámci eshopové platformy zajistit vytvoření přístupového klíče. Jděte do části *Beállítások* -> *Külső kapcsolatok* -> *API kapcsolat* *Ukázka celé cesty:* ---------------- ### 2. krok Následně na stránce zvolte vytvoření nového API klíče. Tlačítko s názvem "*API kulcs létrehozása*" ----------------- ### 3. krok Zde je pak ponechte aktivované všechny volby, zadejte název připojení (třeba Mergado) a uložte nastavení: ----------------- ### 4. krok Zkopírujte si vytvořený *API klíč* a *eshop ID* ----------------- ### 5. krok V rámci vytvoření nového projektu zvolte jako zdroj dat UNAS ----------------- ### 6. krok Zadejte APi klíč a eshop ID v rámci průvodce: ----------------- ### 7. krok Dále již pokračujete běžným výběrem výstupního formátu a dokončením projektu :information_source: TIP: Volitelné napojení přes Mergado Keychain Napojení na UNAS lze realizovat i mimo průvodce vytvořením projektu. Přímo v rámci Mergado Keychain, kdy si můžete dopředu připravit napojení na UNAS a následně při vytvoření projektu již nemusíte údaje zadávat znovu. Vytvořte napojení v rámci Mergado Keychain: Když si nebudete vědět s napojením na UNAS, napište nám na adresu mergado@mergado.com. Rádi vám s nastavením pomůžeme. --- ## [Jak zajistit napojení e-shopové platformy Shopify na Mergado Editor](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/napojeni-dat/jak-zajistit-napojeni-e-shopove-platformy-shopify-na-mergado-editor/) # Jak zajistit napojení e-shopové platformy Shopify na Mergado Editor # Jak vygenerovat Shopify API údaje pro Mergado (od 1. ledna 2026) --- ## ⚠️ DŮLEŽITÉ instrukce pro napojení >Do pole `URLs > App URL` > vložte: ```https://app.mergado.com/``` 💡Tuto URL adresu musíte vložit do pole **App URL** při vytváření custom aplikace v Shopify. > Minimální oprávnění (scopes), která Mergado potřebuje. >⚠️ Bez těchto oprávnění nebude integrace fungovat. ```text write_products,read_products,write_markets,read_markets,read_metaobjects ``` > Oprávnění (scopes), pokud chcete využívat také Mergado Marketplaces ```text read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits ``` --- > Tento návod **striktně vychází z oficiální dokumentace Shopify a aktuálního uživatelského rozhraní** pro vytváření aplikací pomocí **Shopify Developer Dashboardu**. > > **Oficiální zdroje:** > [https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard) --- ## Pro koho je tento návod určen Tento článek je určen pro: - obchodníky na Shopify, kteří chtějí propojit svůj e‑shop s **Mergadem** - agentury a vývojáře nastavující integraci Shopify ↔ Mergado pro klienty - kohokoliv, kdo potřebuje získat **Shopify API přístupový token** > Vytváříte **vlastní (custom), čistě API aplikaci pro jeden konkrétní e‑shop**. Aplikaci **není potřeba** publikovat do Shopify App Store. --- ## Co budete potřebovat - Shopify účet s **admin přístupem** k e‑shopu - přístup do **Shopify Developer Dashboardu** ## Než začnete: Zkontrolujte nastavení trhů (Markets) > ⚠️ **Tento krok je nutný, aby Mergado mohlo importovat produkty pro jednotlivé trhy.** Ještě před vytvářením aplikace doporučujeme zkontrolovat nastavení **Markets** v administraci Shopify. ### Co je potřeba nastavit Pro **každý trh (Market)** , ze kterého chcete do Mergada importovat produkty, musí být: * přiřazena **doména** * přiřazen **jazyk** * obě hodnoty musí být **explicitně přidány do sekce** ***Customized*** Nestačí, aby byly pouze zděděné ze sekce **Inherited** nebo nastavené jako **Primary** . ### Postup v Shopify administraci 1. Otevřete **Shopify administraci** 2. V hlavním levém menu klikněte na **Markets** 3. Otevřete konkrétní trh (např. *Czechia* ) 4. Sjeďte do sekce **Inherited** 5. U položky **Domain / language** klikněte na ikonu **+** 6. V modálním okně: * zaškrtněte požadovanou **doménu** * zaškrtněte požadovaný **jazyk** 7. Potvrďte kliknutím na **Done** 8. Ověřte, že se **Domain / language** přesunuly do sekce **Customized** 9. Změny potvrďte kliknutím na **Save** :warning: > Pokud **Domain / language** zůstanou pouze v části **Inherited** , Shopify API neposkytne data pro daný trh a Mergado nebude moci produkty importovat. --- --- ## Krok 1: Otevřete Shopify Developer Dashboard Do Shopify Developer Dashboardu se můžete dostat dvěma způsoby: ### Varianta A: Přímý přístup 1. Otevřete https://dev.shopify.com/ 2. Přihlaste se pomocí svého Shopify účtu 3. V levém menu otevřete sekci **Apps** ### Varianta B: Přes Shopify administraci 1. Otevřete **Shopify administraci** svého e‑shopu 2. Přejděte do **Settings** → **Apps** 3. Klikněte na **Develop apps** 4. Klikněte na **Build apps in Dev Dashboard** --- ## Krok 2: Vytvořte novou aplikaci 1. Ujistěte se, že jste v sekci **Apps** 2. Klikněte na **Create app** 3. Zvolte **Start from Dev Dashboard** 4. Zadejte název aplikace (např. `Mergado integration`) 5. Klikněte na **Create** Po vytvoření aplikace budete přesměrováni na záložku **Versions**. --- ## Krok 3: Vytvořte verzi aplikace a nastavte oprávnění (scopes) Každá aplikace musí mít alespoň jednu **verzi**, aby ji bylo možné nainstalovat do e‑shopu. ### 3.1 Nastavení URL aplikace a embedování 1. V sekci **URLs** najděte pole **App URL** 2. Výchozí hodnotu `https://example.com` nahraďte za: ``` https://app.mergado.com ``` > Tento krok je **nutný pro správnou funkčnost integrace s Mergadem** . Pokud zůstane výchozí hodnota, autorizace nebude fungovat správně. 3. Pod polem **App URL** zrušte zaškrtnutí volby **Embed app in Shopify admin** ### 3.2 Nastavení přístupových oprávnění 1. V sekci **Access** klikněte na **Select scopes** 2. V modálním okně vyhledejte a zaškrtněte: - `read_products` - `write_products` - `read_markets` - `write_markets` - `read_metaobjects` 3. Potvrďte kliknutím na **Done** > Tato oprávnění jsou nutná, aby Mergado mohlo načítat produkty a data specifická pro jednotlivé trhy. ### 3.3 Publikování (Release) verze 1. Sjeďte níže na stránce 2. Klikněte na **Release** 3. V potvrzovacím okně můžete název verze ponechat prázdný 4. Potvrďte kliknutím na **Release** Verze aplikace je nyní publikovaná a připravená k instalaci. --- ## Krok 4: Nainstalujte aplikaci do e‑shopu 1. V levém menu otevřete **Home** 2. Vpravo nahoře klikněte na **Install app** 3. Vyberte Shopify e‑shop, který chcete propojit s Mergadem 4. Budete přesměrováni do Shopify administrace 5. Instalaci potvrďte kliknutím na **Install** Aplikace je nyní nainstalována v e‑shopu. --- ## Krok 5: Získejte API přístupové údaje (Client ID a token) Po instalaci aplikace je potřeba získat **dvě hodnoty** , které budete používat pro integraci s Mergadem: 1. **Client ID** 2. **API přístupový token (Secret)** Postup: 1. Vraťte se do **Shopify Developer Dashboardu** 2. Otevřete svou aplikaci 3. Přejděte do **Settings** 4. V sekci **Credentials** : * zkopírujte hodnotu **Client ID** (pole se nachází **nad** hodnotou Secret) * zkopírujte hodnotu **Secret** > **Client ID** slouží k identifikaci aplikace, **Secret** funguje jako API přístupový token. Pro správnou funkčnost integrace s Mergadem jsou **nutné obě hodnoty** . --- ## Krok 6: Získejte URL e‑shopu 1. Otevřete **Shopify administraci** připojeného e‑shopu 2. V levém menu otevřete **Home** 3. V sekci **Domains** zkopírujte URL e‑shopu Příklad: `your-store.myshopify.com` --- ## Krok 7: Propojte Shopify s Mergadem 1. Otevřete **Mergado** 2. Vytvořte nový projekt 3. Jako zdroj dat zvolte **Shopify** 4. Vyplňte: * **Shopify URL** → vložte URL e-shopu * **Client ID** → vložte zkopírovaný **Client ID** z Shopify Developer Dashboardu * **Client Secret** → vložte zkopírovaný **Secret** 5. Klikněte na **Log in** --- ## FAQ – Nejčastější dotazy z podpory ### Po zvolení Market se mi nenačítá jazyk. Proč? Nejčastější příčina je v nastavení sekce **Markets** v Shopify administraci. Pokud je **Domain / language** uveden pouze v sekci **Inherited** a není přidaný do sekce **Customized** , Shopify API pro daný trh neposkytne data. V důsledku toho se v Mergadu po výběru Market nenačte jazyk. Řešení: * Otevřete **Shopify admin → Markets** * Otevřete konkrétní trh * U položky **Domain / language** klikněte na **+** * Vyberte doménu a jazyk * Klikněte na **Done** a poté **Save** * Ověřte, že se položka přesunula do sekce **Customized** * Více info viz sekce: [Než začnete: Zkontrolujte nastavení trhů (Markets)](https://forum.mergado.cz/t/novy-projekt-vygenerovani-shopify-api-credentials/2915#p-7873-ne-zanete-zkontrolujte-nastaven-trh-markets-5) ### Mergado nenačítá správně hodnotu některých metafield. Proč? Pokud se u některých metafield zobrazuje správný název (key), ale hodnota (value) je uvedena jako ID (např. `["gid://shopify/Metaobject/94942036012"]` ) nebo se zobrazí hláška **"Missing required scope"** , aplikaci chybí oprávnění pro čtení metaobjektů. Je potřeba přidat další scope: ` read_metaobjects ` ### Postup 1. Přejděte do **Shopify Developer Dashboardu** 2. Otevřete aplikaci vytvořenou pro integraci s Mergadem 3. V levém menu přejděte na **Versions** 4. Klikněte na **New version** 5. V sekci **Scopes** přidejte nový scope `read_metaobjects` 6. Potvrďte změny a dokončete novou verzi kliknutím na **Release** Po vydání nové verze je nutné napojení znovu autorizovat. ### Reautorizace v Mergadu 1. Otevřete rozšíření **Mergado Keychain** 2. Zrušte stávající spojení 3. Znovu vyplňte autorizační údaje: * **Shopify URL** * **Client ID** * **Secret** 4. Přihlaste se znovu (Log in) Po přidání scope a reautorizaci se budou hodnoty metafield načítat správně. --- --- ## [Autorizace produktů](https://help.mergado.com/cs/mergado-editor/obecne-o-mergadu/napojeni-dat/autorizace-produktu/) # Autorizace produktů # Autorizace produktů Autorizace produktů vám umožní rozhodnout, které položky ze vstupního feedu pustíte do Mergada a které naopak zablokujete. Hodí se, když máte feed od dodavatele a nechcete nabízet celý sortiment, nebo když chcete mít pod kontrolou každý nový produkt, který se ve feedu objeví. Níže najdete postup, jak autorizaci zapnout, pracovat se schvalováním a jak ji případně znovu vypnout. ## Postup krok za krokem ### 1) Zapnutí při vytváření projektu 1. Ve wizardu (poslední krok) najdete pod **Párovacími elementy** dvě tlačítka. 2. Spodní z nich je **Zapnout autorizaci produktů** – kliknutím ji aktivujete. ### 2) Co uvidíte po vytvoření projektu * V **Přehledu** bude na výstupu zobrazeno **0 produktů**. * V levém dolním okně se zobrazí hláška **„Produkty čekající na schválení“**. * To znamená, že produkty ze vstupního feedu musíte nejprve autorizovat. ### 3) Schvalování produktů 1. Přejděte do sekce **Produkty** a otevřete záložku **Autorizace produktů** (v horní části). 2. Zobrazí se seznam všech produktů ze vstupního feedu. 3. Označujte jednotlivé produkty, které chcete schválit. * Chcete-li označit všechny, použijte **zaškrtávací políčko** na **první černé liště úplně vlevo**. 4. Klikněte na **Schválit** (nebo **Zamítnout**). > Po schválení se právě schválené produkty **přepíšou do Mergada**. ### 4) Vypnutí / opětovné zapnutí autorizace * Autorizaci lze **vypnout i znovu zapnout** i u již vytvořeného projektu. * Přejděte do **Nastavení**, sjeďte níže a **pod párovacími elementy** najdete okénko s možností **vypnutí/zapnutí „Autorizace projektů“**. ## Tipy * **Rychlý start**: Pokud chcete pustit celý feed, využijte hromadné označení pomocí zaškrtávacího políčka na první černé liště a potvrďte **Schválit**. * **Pečlivá kontrola**: Chcete-li mít jistotu nad novými položkami, procházejte záložku **Autorizace produktů** pravidelně a schvalujte jen to, co opravdu chcete na výstupu. ## FAQ **K čemu slouží autorizace produktů?** K řízení, které produkty ze vstupního feedu pustíte do Mergada a které zablokujete. Užitečné, když nechcete nabízet celý feed nebo chcete hlídat novinky. **Kde autorizaci zapnu při vytváření projektu?** V posledním kroku wizardu pod **Párovacími elementy** kliknutím na **Zapnout autorizaci produktů**. **Proč po vytvoření projektu vidím 0 produktů a hlášku „Produkty čekající na schválení“?** Protože je nejprve potřeba produkty ze vstupního feedu **schválit** v záložce **Autorizace produktů**. **Jak hromadně označím všechny produkty ke schválení nebo zamítnutí?** V záložce **Autorizace produktů** použijte **zaškrtávací políčko** na **první černé liště úplně vlevo**, pak klikněte na **Schválit** nebo **Zamítnout**. **Co se stane po schválení?** Schválené produkty se **přepíšou do Mergada** a objeví se na výstupu. **Lze autorizaci později vypnout nebo znovu zapnout?** Ano. V **Nastavení** pod **párovacími elementy** je okénko s možností **vypnutí/zapnutí „Autorizace projektů“**. --- ## [Jak a proč v Mergadu nastavit cenové hladiny?](https://help.mergado.com/cs/mergado-editor/automatizace/jak-a-proc-v-mergadu-nastavit-cenove-hladiny/) # Jak a proč v Mergadu nastavit cenové hladiny? ## Co jsou cenové hladiny Nastavení cenových hladin znamená rozdělení vašeho sortimentu do skupin (tzv. výběrů) podle cenového rozpětí (např. na produkty s cenou 0–199 Kč, 200–499 Kč, 500–999 Kč, 1000+ Kč). V Mergadu vám tato segmentace umožní lépe cílit úpravy (např. marži nebo dopravu), zvolit vhodnou cenu za proklik (CPC) u biddingu a efektivně nastavit PPC kampaně právě podle úrovně ceny. Každý segment zboží vyžaduje specifickou strategii a znalost, v jakých cenových pásmech máte nejvíce produktů, největší obrat nebo největší náklady, vám dává strategickou výhodu. ## Kdy využiju rozdělení do cenových hladin * Nastavení rozdílných strategií pro „levné“ a „prémiové“ produkty, např. vyšší CPC u dražších produktů. * Nastavení ceny dopravy na základě ceny produktů, např. doprava zdarma nad určitou cenovou hladinou. * Identifikace produktů, které generují nejvyšší obrat nebo náklady (viz nastavení cenových hladin v segmentovém reportu rozšíření „Pricing Fox“). ## Jak v Mergadu nastavit cenové hladiny ### 1. Nastavení pomocí automatizace První a nejrychlejší možností, jak nastavit cenové hladiny pro vaše produkty, je s pomocí předpřipravené automatizace. S její pomocí během pár kliknutí vytvoříte až pět cenových hladin. 1. U vybraného projektu přejděte na stránku Automatizace. 2. Vyberte automatizaci Segmentace do 5. cenových hladin. 3. V části Parametry automatizace vyplňte v prvním řádku název elementu, ve kterém se ve vašem feedu nachází informace o ceně produktu (např. PRICE_VAT) *Tip! Dejte si pozor, abyste vybrali správný element na základě toho, zda chcete produkty rozdělit podle ceny bez DPH nebo ceny včetně DPH.* 4. Vyplňte do příslušných řádků horní hranici ceny pro danou cenovou hladinu. 5. Potvrďte kliknutím na tlačítko Spustit automatizaci. Pokud chcete některé cenové hladiny editovat, odstranit nebo přidat další, můžete to udělat na stránce Produkty. Zde najdete v záložce Uložené výběry seznam všech vašich výběrů produktů, včetně vytvořených cenových hladin. Cenové hladiny můžete kliknutím na ikonku koše smazat, nebo kliknutím na název přejít k jejich editaci. ### 2. Manuální nastavení V případě, že se rozhodnete nevyužít automatizaci, můžete si skupiny (v Mergadu tzv. výběry) produktů pro jednotlivé cenové hladiny vytvořit a nastavit také manuálně. Stejně postupujte i v případě, že jste si vytvořili pět cenových hladin s pomocí automatizace, ale chcete přidat další. 1. U vybraného projektu přejděte na stránku Produkty. 2. V úvodu stránky klikněte na Jednoduché rozhraní. 3. Do kolonky vyplňte název elementu, ve kterém se nachází informace o ceně produktu (např. PRICE_VAT). 4. Následně zvolte podmínku pro cenovou hladinu. Například pokud chcete vytvořit výběr produktů, ve kterém budou obsaženy produkty v ceně od 200 do 999 Kč, vyberte operátor ≥ je větší nebo rovno než a zadejte 200. 5. Klikněte na ikonku „+“ a vyplňte horní hranici cenové hladiny. Opět vyplňte element obsahující cenu (např. PRICE_VAT), vyberte operátor ≤ je menší nebo rovno než a zadejte 999. *TIP! Ujistěte se, že ve chvíli, kdy zadáváte dvě podmínky, je vlevo vedle kolonek políčko s nápisem „and“ (tzn. a zároveň). V případě, že je zde políčko s nápisem „or“ (tzn. nebo), klikněte na něj a tím se políčko změní na „and“.* 6. Klikněte na Hledat. 7. Zadejte název výběru pro tuto cenovou hladinu (např. cenová hladina od 200 do 999). 8. Klikněte na Uložit. Výběr následně uvidíte v seznamu na stránce Produkty v záložce Uložené výběry, odkud jej můžete smazat nebo editovat. ## Aplikování pravidel na výběry dle cenových hladin Po vytvoření požadovaných cenových hladin přejděte na stránku Pravidla a vytvořte si pro jednotlivé výběry potřebná pravidla a následně je aplikujte. #### Příklady využití: ### Nastavení různých CPC podle cenové hladiny Proč to využít: Pokud máte některé produkty s velmi nízkými cenami a nízkou marží, je vhodné nastavit jim nižší CPC, aby se jejich inzerce vyplatila a vy jste na nich neprodělávali. Naopak u dražších produktů se může vyplatit mít vyšší CPC, protože marže bývá obvykle větší. Jak na to: 1. Nejdříve si vytvořte vhodné výběry produktů dle cenových hladin podle návodu výše. 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Nastavení cen za prokliky. 4. V kolonce Výběry zvolte cenovou hladinu, pro kterou chcete nastavit cenu za proklik. 5. Zvolte, zda chcete cenu za proklik vypočítávat podle: a. Minimální ceny prokliku – Pravidlo zohlední minimální ceny za proklik pro zboží v jednotlivých kategoriích (minimální ceny udává inzertní platforma) a vy můžete navýšit tuto cenu o libovolnou částku, kterou vyplníte do kolonky Přičíst k minimálnímu CPC (Kč). b. Procenta z ceny zboží – Zde si v kolonce Procento z ceny produktu určíte procentuální hodnotu z ceny zboží, kterou chcete nabídnout za proklik. Např. Pokud nastavíte 1 % z ceny, u produktu za 500 Kč bude pravidlo nabízet cenu za proklik 5 Kč. 6. Vyplňte Název pravidla. 7. Klikněte na Vytvořit. 8. Stejně postupujte i u ostatních cenových hladin a nezapomeňte následně vytvořená pravidla aplikovat. *Tip! Sledujte výkon (prokliky, konverze) zvlášť pro každou hladinu a upravujte CPC podle skutečné ziskovosti.* ### Nastavení ceny dopravy pro různé cenové hladiny Proč to využít: U samostatně zakoupených levnějších produktů často nemusí být doprava zdarma výhodná, zatímco u dražších je možné dopravu nabídnout jako bonus pro zákazníky. Jak na to: 1. Nejdříve si vytvořte vhodné výběry produktů dle cenových hladin podle návodu výše. 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Nastavení ceny dopravy. 4. V kolonce Výběry zvolte cenovou hladinu (cenové hladiny), pro kterou (které) chcete nastavit cenu dopravy. 5. Postupně vyplňte Dopravce a ceny za dopravu při platbě předem a na dobírku. 6. Vyplňte Název pravidla. 7. Klikněte na Vytvořit. 8. Stejně postupujte i u ostatních cenových hladin a nezapomeňte následně vytvořená pravidla aplikovat. ### Analýza sortimentu pomocí segmentového reportu v rozšíření Pricing Fox Proč to využít: Rozdělením svého portfolia na cenové hladiny a následnou analýzou získáte přehled, ve kterých cenových hladinách máte největší obrat, prokliky či náklady, a podle toho nastavíte efektivnější strategie. Jak na to: Využijte rozšíření [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about), ve kterém si v Segmentovém reportu nastavíte vlastní cenové hladiny. Následně zvolíte metriku, kterou chcete sledovat (např. Obrat nebo Počet produktů), a zjistíte tak podrobné informace o svém sortimentu. Na základě získaných informací snadno nastavíte efektivnější marketingovou strategii. Více o Segmentové reportu se dozvíte v [tomto článku](https://pricing-fox.cz/navody/segmentovy-report?utm_source=chatgpt.com#vykon-top-segmentu) nebo [videu](https://www.youtube.com/watch?v=J3zZEfb9JUg). *Tip! Například pokud uvidíte, že nízká cenová hladina generuje mnoho prokliků, ale nízký obrat, zvažte snížení CPC nebo zvýšení marže pro tento segment.* ### Pokročilé biddování s pomocí rozšíření Bidding Fox Proč to využít: Rozdělení produktů do cenových hladin je ideálním základem pro pokročilé řízení biddingu pomocí rozšíření [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about), kde si pro jednotlivé segmenty zvolíte samostatné strategie (např. jiné CPC nebo PNO pro levné a prémiové produkty). Jak na to: V Bidding Foxu si vytvoříte novou strategii, kde jako cílový výběr zvolíte vybranou cenovou hladinu (můžete použít výběry nastavené v Mergadu nebo si je nastavit přímo v Bidding Foxu). Nastavíte si cíle (např. CPC, PNO nebo pozice na inzertní platformě) a strategii uložíte. Více o nastavování strategií v Bidding Foxu se dozvíte v [tomto článku](https://www.bidding-fox.cz/prvni-strategie?utm_source=chatgpt.com). *Tip! Pro nízkou cenovou hladinu můžete například zkusit nastavit konzervativní bidding, pro střední cenovou hladinu optimalizovat bidding na základě výkonu a pro vysokou cenovou hladinu zvolit agresivní bidding s vyšším CPC.* ## FAQ: Jak a proč v Mergadu nastavit cenové hladiny? ### Co jsou cenové hladiny a proč je mám v Mergadu nastavovat? Cenové hladiny jsou skupiny produktů (tzv. výběry) rozdělené podle ceny (např. 0–199 Kč, 200–499 Kč, 500–999 Kč, 1000+ Kč). V Mergadu vám tyto výběry umožní přizpůsobovat pravidla, CPC nebo dopravu podle ceny zboží a zefektivnit tak vaše kampaně. Pomáhají také při analýze výkonu sortimentu a rozpoznání, které produkty přinášejí největší zisk či náklady. ### Jak můžu nastavit cenové hladiny? Výběry produktů na základě cenových hladin můžete vytvořit pomocí automatizace „Segmentace do 5 cenových hladin“. S touto automatizací jednoduše vytvoříte až pět výběrů produktů během pár kliknutí. Stačí zadat element s cenou (např. PRICE_VAT) a horní cenové hranice jednotlivých hladin. Hladiny můžete následně kdykoliv editovat nebo smazat. Cenové hladiny lze vytvořit také manuálně, což je ideální postup v případě, že potřebujete vytvořit více než 5 hladin. ### Je možné cenové hladiny vytvořené pomocí automatizace editovat nebo přidat další? Ano. V sekci Produkty → Uložené výběry uvidíte všechny cenové hladiny, které automatizace vytvořila. Kliknutím na název výběru ho můžete upravit (změnit hranici, podmínky nebo název), případně kliknutím na ikonu koše smazat. V sekci Produkty → Výpis produktů můžete kdykoliv ručně vytvořit další výběry dle cenové hladiny. ### Co když potřebuji produkty rozdělit podle více kritérií než jen cenové hladiny (např. značka + cenová hladina)? V Mergadu můžete při tvorbě výběrů kombinovat více podmínek pomocí logického operátoru AND (a zároveň). Například: BRAND = Nike *AND* PRICE_VAT >= 1000 *AND* PRICE_VAT <= 2000 Takto si vytvoříte výběr pro produkty značky Nike v ceně od 1000 do 2000 Kč. ### Jak nastavit různé CPC pro jednotlivé cenové hladiny? 1. Nejdříve si vytvořte vhodné výběry produktů dle cenových hladin. 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Nastavení cen za prokliky. 4. V kolonce Výběry zvolte cenovou hladinu, pro kterou chcete nastavit cenu za proklik. 5. Zvolte, zda chcete cenu za proklik vypočítávat podle: a. Minimální ceny prokliku – Pravidlo zohlední minimální ceny za proklik pro zboží v jednotlivých kategoriích (minimální ceny udává inzertní platforma) a vy můžete navýšit tuto cenu o libovolnou částku, kterou vyplníte do kolonky Přičíst k minimálnímu CPC (Kč). b. Procenta z ceny zboží – Zde si v kolonce Procento z ceny produktu určíte procentuální hodnotu z ceny zboží, kterou chcete nabídnout za proklik. Např. Pokud nastavíte 1 % z ceny, u produktu za 500 Kč bude pravidlo nabízet cenu za proklik 5 Kč. 6. Vyplňte Název pravidla. 7. Klikněte na Vytvořit. 8. Stejně postupujte i u ostatních cenových hladin a nezapomeňte následně vytvořená pravidla aplikovat. Další možností je využití pokročilejšího nastavení CPC v rozšíření [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about). ### Jak nastavit dopravu zdarma pro dražší produkty? 1. Vytvořte výběr produktů na základě požadované cenové hladiny (např. PRICE_VAT ≥ 1500). 2. Na stránce Pravidla klikněte na Nové pravidlo. 3. Jako Typ pravidla vyberte Nastavení ceny dopravy. 4. V kolonce Výběry zvolte danou cenovou hladinu (např. PRICE_VAT ≥ 1500), pro kterou chcete nastavit dopravu zdarma. 5. Vyplňte Dopravce a jako cenu nastavte 0. 6. Vyplňte Název pravidla. 7. Klikněte na Vytvořit. 8. Nezapomeňte následně vytvořené pravidlo aplikovat. ### Jak mohu zjistit, které cenové hladiny mi přinášejí nejvyšší tržby? K analýze cenových hladin je ideální rozšíření [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about) a jeho Segmentový report. V reportu si nastavíte hranice cenových hladin a uvidíte, kolik produktů, obratu či nákladů každá hladina tvoří. Díky tomu snadno upravíte bidding, marži nebo CPC podle skutečné výkonnosti. Více o Segmentové reportu se dozvíte v [tomto článku](https://pricing-fox.cz/navody/segmentovy-report?utm_source=chatgpt.com#vykon-top-segmentu) nebo [videu](https://www.youtube.com/watch?v=J3zZEfb9JUg) ### Jak poznám, že mám cenové hladiny správně nastavené? Na stránce Produkty → Uložené výběry zkontrolujte, kolik produktů každý výběr obsahuje. Pokud součet všech produktů ve výběrech odpovídá celkovému počtu produktů ve feedu, je rozdělení kompletní. Pokud některé produkty chybí, zkontrolujte, zda hranice hladin na sebe navazují a nepřekrývají se. ### Kolik cenových hladin můžu vytvořit? Můžete vytvořit libovolný počet cenových hladin. S pomocí automatizace rychle a jednoduše vytvoříte maximálně 5, ale další můžete ručně doplnit na stránce Produkty. ### Co dělat, pokud když výběry dle cenových hladin neobsahují žádné produkty? Zkontrolujte: * zda používáte správný element s cenou (např. g:price nebo PRICE_VAT), * zda jsou podmínky pro stanovení dolní a horní cenové hranice nastaveny správně a kombinovány pomocí operátoru „AND“, nikoliv „OR“. --- ## [Mergado Audit: Průvodce technickou kontrolou produktových feedů](https://help.mergado.com/cs/audit-produktovych-dat/mergado-audit/mergado-audit-pruvodce-technickou-kontrolou-produktovych-feedu/) # Mergado Audit: Průvodce technickou kontrolou produktových feedů Pro úspěšnou inzerci na srovnávačích zboží a v reklamních systémech je klíčové, aby byla vaše produktová data správná, úplná a validní. Technický stav feedu přímo ovlivňuje schvalování produktů, jejich párování i výkon kampaní. [Mergado Audit](https://audit.mergado.com/) je bezplatný online nástroj, který vám během několika minut ukáže, v jaké kondici váš XML nebo CSV feed skutečně je – a poradí, co konkrétně opravit. ## 1. Co je Mergado Audit Mergado Audit je nástroj, který automatizovaně provede technickou kontrolu vašeho produktového XML nebo CSV feedu, a odhalí chybná místa vyžadující kontrolu. Mergado Audit: * jednorázově načte váš datový soubor z veřejné URL adresy, * provede nad ním sadu testů založených na tzv. validátorech, * vyhodnotí nalezené chyby, varování a doporučení, * zobrazí konkrétní návrhy řešení. Audit funguje jako diagnostika feedu. Neprovádí úpravy dat, pouze analyzuje jejich kvalitu a soulad s požadavky vybraného inzertního kanálu (např. Google nebo Heureka). Je však důležité dodat, že Audit neodhalí úplně všechny možné problémy. Zaměřuje se na technickou a formální správnost dat podle definovaných validačních pravidel. Nehodnotí například obchodní strategii, konkurenceschopnost cen, kvalitu produktových textů nebo výkon kampaní jako takový. ## 2. K čemu slouží Hlavním cílem auditu je odhalit nedostatky, které mohou: * způsobit zamítnutí produktů, * omezit jejich zobrazování ve filtrech, * zhoršit párování s konkurenčními nabídkami, * negativně ovlivnit výkon inzerce. Praktické přínosy: * Odhalení kritických chyb – Zjistíte, proč mohou srovnávače nebo reklamní systémy (např. Google či Heureka) vaše produkty zamítat. * Kontrola povinných parametrů – Audit prověřuje přítomnost a správnost povinných elementů (např. cena, dostupnost, EAN, URL). * Analýza kvality dat – Kontroluje nejen přítomnost povinných elementů, ale i validitu samotných dat. Například formát ceny, správnost EAN kódů nebo unikátnost URL adres. * Zlepšení filtrování a párování – Audit kontroluje, zda jsou správně vyplněné parametry, které mají vliv na párování produktů a lepší viditelnost ve filtrech. * Konkrétní doporučení k opravě – Výsledky obsahují popis problému a doporučení, jak jej vyřešit (často s odkazy na dokumentaci nebo videonávody). ## 3. Jak Mergado Audit funguje Použití Mergado Auditu je navrženo tak, aby bylo co nejjednodušší i pro netechnické uživatele. Kde audit spustit: * na samostatné stránce [audit.mergado.com](http://audit.mergado.com) * nebo přímo z prostředí Mergado Editoru Co ke spuštění potřebujete: * URL adresu vašeho XML nebo CSV feedu (veřejně dostupnou) * e-mailovou adresu pro zaslání výsledků Jak spustit audit: 1. Zadáte URL feedu. 2. Vyberete cílový formát (např. Google, Heureka), nebo necháte systém formát automaticky detekovat. → Tento krok je důležitý proto, že každý inzertní kanál má vlastní strukturu feedu, povinné elementy a specifická validační pravidla. Audit proto musí vědět, podle jakých pravidel má data kontrolovat. Jinými slovy, jinak je hodnocen feed pro Google a jinak pro Heureku. 3. Vyplníte e-mail, na který chcete zaslat výsledky auditu. 4. Kliknete na Provést audit a audit provede kontrolu. Doba zpracování se pohybuje od několika minut po maximálně několik hodin u rozsáhlých feedů (záleží na velikosti souboru a vytížení systému). ## 4. Vyhodnocení výsledků Výsledky jsou přehledně rozděleny do tří úrovní závažnosti: 🔴 Chyby (červená barva) Závažné problémy, které mohou vést k zamítnutí produktů nebo znemožnit jejich správné zpracování. 🟡 Varování (žlutá barva) Nedostatky, které inzerci přímo neblokují, ale mohou snižovat její výkon nebo kvalitu dat. 🟢 Doporučení (zelená barva) Tipy pro další optimalizaci feedu a zvýšení konkurenceschopnosti a výkonu inzerce. ## 5. Cena, limity a dostupnost * Cena: Mergado Audit je zdarma. * Registrace: Není nutná registrace do Mergada. * Opakované použití: Audit lze spouštět opakovaně a bez omezení. * Doporučená frekvence: Minimálně 1× měsíčně (ideálně po větších úpravách feedu). * Maximální velikost feedu: Aktuální limit je 256 MB. Pokud potřebujete zkontrolovat feed, který tento limit přesahuje, návod, jak na to najdete v článku [Jak postupovat, když má feed pro Audit více než 256 MB](https://forum.mergado.cz/t/jak-postupovat-kdyz-ma-feed-pro-audit-vice-nez-256-mb/jak-postupovat-kdyz-ma-feed-pro-audit-vice-nez-256-mb). * Dostupnost výsledků: Výsledky jsou online přístupné po dobu 10 dní. ## 6. Pro koho je Mergado Audit vhodný * Pro e-shopy, které chtějí rychle zkontrolovat kvalitu feedu. * Pro PPC specialisty při přebírání nového účtu. * Pro agentury jako vstupní diagnostiku projektu. * Pro firmy, které chtějí odhalit technické problémy bez zásahu programátora. ## 7. Specializované audity Kromě základního auditu produktového feedu Mergado nabízí i specializované nástroje, které se zaměřují na kontrolu specifických oblastí e-commerce. Všechny specializované audity jsou zdarma. Audit obrázků ([audit-obrazku.cz](http://audit-obrazku.cz)): Audit obrázků kontroluje technické parametry produktových fotografií, jako je rozlišení, pozadí, formát nebo dostupnost URL. Pomáhá předcházet zamítání obrázků v reklamních systémech. Biddingový audit ([bidding-audit.cz](http://bidding-audit.cz)): Biddingový audit se zaměřuje na kondici sortimentu v biddingových kampaních na Heurece. Hodnotí konkurenceschopnost, párování nebo efektivitu strategie. Pricingový audit ([pricing-audit.cz](http://pricing-audit.cz)): Pricingový audit odhaluje nedostatky v cenotvorbě na Heurece, srovnává vaše ceny s konkurencí a pomáhá identifikovat nespárované produkty nebo nabídky s nulovou nebo extrémní cenou. ## Shrnutí Mergado Audit je bezplatný nástroj pro technickou kontrolu XML a CSV feedů, který pomáhá rychle odhalit nedostatky v produktových datech. Upozorní na chyby ovlivňující schvalování produktů, jejich párování i viditelnost v reklamních systémech a díky přehlednému vyhodnocení nabídne konkrétní doporučení k nápravě. Je však důležité vnímat jej jako diagnostický nástroj zaměřený primárně na kvalitu dat – nikoliv jako komplexní marketingovou nebo strategickou analýzu. Největší přínos přináší tehdy, když na jeho výstupy navazuje další práce s kampaněmi, cenotvorbou či sortimentem. Chcete-li mít jistotu, že vaše inzerce stojí na pevných datech, pravidelná kontrola feedu by měla být přirozenou součástí vaší e-commerce rutiny. ## FAQ - Co je Mergado Audit? Mergado Audit je bezplatný online nástroj pro technickou kontrolu produktových XML a CSV feedů. Automaticky analyzuje kvalitu dat a upozorňuje na chyby, varování a doporučení podle pravidel vybraného inzertního kanálu (např. Google nebo Heureka). Rovnou také doporučí konkrétní řešení. - Je Mergado Audit zdarma? Ano. Použití Mergado Auditu je zcela zdarma. - Musím mít pro spuštění Auditu účet v Mergadu? Ne. Pro spuštění auditu není nutná registrace do Mergada. Můžete jej spustit na samostatné stránce [audit.mergado.com](http://audit.mergado.com). - Upravuje Audit data v mém feedu? Ne. Audit pouze analyzuje data a vyhodnocuje jejich kvalitu. Žádné změny ve feedu neprovádí. - Proč bych měl/a audit feedu vůbec provádět? Stav feedu ovlivňuje schvalování produktů, jejich zobrazování ve filtrech, párování s konkurenčními nabídkami a celkový výkon inzerce. Audit pomůže odhalit problémy, které mohou inzerci brzdit nebo blokovat. - Jaké chyby Audit odhalí? Audit kontroluje feed podle pravidel konkrétní cílové platformy, pro kterou jsou data určená (např. Google nebo Heureka). Každý inzertní kanál má vlastní požadavky na strukturu feedu, povinné elementy i formát hodnot. Právě podle těchto pravidel Audit data vyhodnocuje. Odhalí například chybějící povinné elementy (cena, dostupnost, EAN, URL apod.), neplatný formát ceny, nevalidní EAN kódy, duplicitní nebo nefunkční URL, strukturální chyby feedu nebo nesoulad dat s požadavky vybrané platformy. - Kontroluje Audit i kvalitu dat, nebo jen jejich přítomnost? Kontroluje obojí. Sleduje nejen to, zda element existuje, ale i to, zda je jeho hodnota validní a správně formátovaná. - Pomůže Audit zlepšit párování produktů? Ano. Kontrola správně vyplněných parametrů může výrazně zlepšit párování a viditelnost produktů ve filtrech. - Jak Mergado Audit spustím? 1. Audit najdete na adrese [audit.mergado.com](http://audit.mergado.com). 2. Zde zadejte URL adresu vašeho feedu. 3. Vyberte cílový formát nebo nechte systém formát automaticky detekovat. 4. Zadejte e-mail pro zaslání výsledků. 5. Klikněte na „Provést audit“. - Proč je nutné vybrat cílový formát? Každý inzertní kanál má vlastní strukturu feedu a validační pravidla. Audit potřebuje vědět, podle jakých pravidel má data vyhodnotit. Feed pro Google se kontroluje jinak než feed pro Heureku. - Co potřebuji ke spuštění auditu? 1. Veřejně dostupnou URL adresu XML nebo CSV feedu. 2. E-mailovou adresu pro zaslání výsledků. - Jak dlouho kontrola trvá? Obvykle několik minut. U rozsáhlých feedů může zpracování trvat déle (až několik hodin), v závislosti na velikosti souboru a vytížení systému. - Mohu audit spustit opakovaně? Ano. Audit lze spouštět opakovaně a bez omezení. - Jak často bych měl/a audit provádět? Doporučujeme minimálně 1× měsíčně, ideálně po každé větší úpravě feedu nebo e-shopu. - Jak vypadají výsledky auditu? Výsledky jsou rozděleny do tří úrovní: 🔴 Chyby – Závažné problémy, které mohou způsobit zamítnutí produktů. 🟡 Varování – Nedostatky, které mohou snižovat výkon inzerce. 🟢 Doporučení – Tipy pro další optimalizaci. - Jak dlouho jsou výsledky dostupné? Výsledky jsou online přístupné po dobu 10 dní. - Obsahují výsledky i návod na opravu? Ano. Každý nalezený problém obsahuje popis a doporučení řešení. Často jsou připojeny odkazy na dokumentaci nebo videonávody. - Jaká může být maximální velikost feedu, který chci auditovat? Maximální velikost souboru je 256 MB. - Co když je můj feed větší než maximální limit pro Audit? Feed je potřeba rozdělit. Postupovat můžete podle návodu v článku „[Jak postupovat, když má feed pro Audit více než 256 MB](https://forum.mergado.cz/t/jak-postupovat-kdyz-ma-feed-pro-audit-vice-nez-256-mb/jak-postupovat-kdyz-ma-feed-pro-audit-vice-nez-256-mb)“. - Podporuje Audit XML i CSV feedy? Ano, podporuje oba formáty. - Je Audit vhodný i pro začátečníky? Ano. Nástroj je navržen tak, aby jej zvládli i netechničtí uživatelé. - Využijí Audit i agentury a PPC specialisté? Ano. Audit je vhodný jako vstupní diagnostika při přebírání nového projektu. - Potřebuji k opravě chyb programátora? Ne vždy. Mnoho chyb lze opravit pomocí nástrojů na úpravu feedů (např. v Mergado Editoru). U zásadních strukturálních problémů může být zásah vývojáře nutný. - Existují i jiné typy auditů než základní feed audit? Ano. Mergado nabízí i specializované audity – audit obrázků, audit cen a biddingový audit. - Co je Audit obrázků? Nástroj kontrolující technické parametry produktových fotografií (rozlišení, formát, dostupnost URL, pozadí). Pomáhá předcházet jejich zamítnutí v reklamních systémech. - Co je Biddingový audit? Analyzuje stav biddingových kampaní na Heurece. Hodnotí konkurenceschopnost, párování a efektivitu strategie. - Co je Pricingový audit? Zaměřuje se na cenotvorbu na Heurece. Identifikuje nespárované produkty, nulové nebo extrémní ceny nebo cenovou nekonkurenceschopnost. - Jsou specializované audity zdarma? Ano, všechny typy auditů jsou zdarma. - Je Audit vhodný jako pravidelná kontrola kvality dat? Ano. Pravidelné spouštění auditu pomáhá udržovat feed dlouhodobě v dobré kondici. --- ## [Jak postupovat, když má feed pro Audit více než 256 MB](https://help.mergado.com/cs/audit-produktovych-dat/mergado-audit/jak-postupovat-kdyz-ma-feed-pro-audit-vice-nez-256-mb/) # Jak postupovat, když má feed pro Audit více než 256 MB # Jak postupovat, když má feed pro Audit více než 256 MB Mergado Audit kontroluje technickou správnost a kvalitu dat ve feedu. Aktuálně však zpracuje pouze soubory do velikosti **256 MB**. Pokud feed limit překročí, Audit se nespustí a v aplikaci uvidíte hlášení: **„Překročena maximální povolená velikost souboru.“** Tato nápověda vysvětluje, proč k tomu dochází, a ukáže osvědčené postupy, jak feed dočasně zmenšit nebo rozdělit, abyste Audit mohli provést. --- ## Postup krok za krokem ### 1) Rozdělení feedu na menší části Pokud to vaše infrastruktura dovoluje, rozdělte původní feed na dvě menší části a každou zkontrolujte samostatně v Auditu. **Na co si dát pozor:** * Každá část feedu musí mít kompletní strukturu (hlavičku i konec), aby Audit proběhl správně. --- ### 2) Dočasné zmenšení feedu skrytím části produktů v Mergadu Když rozdělení není možné, zmenšete data přímo v Mergadu. **Postup:** 1. **Vytvořte výběr produktů** * Přejděte na **Produkty** a vytvořte výběr zhruba pro polovinu položek. * Kritéria zvolte podle struktury feedu – např. **kategorie**, **cenový rozsah** nebo **číslo v `ITEM_ID`**. 2. **Aplikujte pravidlo pro skrytí** * Otevřete **Pravidla** → **Nové pravidlo**. * Jako typ pravidla zvolte **Skrytí produktu** a aplikujte na vytvořený výběr. 3. **Přegenerujte feed** * **Nastavení** → **Přegenerování** → **Přegenerovat změněné**. 4. **Spusťte Audit** * Audit proveďte nad takto „zmenšeným“ **výstupním feedem**. --- ### 3) Další způsoby, jak ještě snížit velikost Pokud výstupní feed stále překračuje 256 MB, zkuste: * **Skrýt více produktů** (rozšiřte výběr, např. o další kategorie nebo značky). * **Dočasně skrýt velké elementy**, typicky **`DESCRIPTION`**. * Proveďte na stránce **Elementy** pomocí **přepínače** na pravé straně. > 💡 **Mergado tip:** > Elementy skryjte jen dočasně pro účely Auditu. Po dokončení kontroly je opět **zapněte**, aby feed zůstal kompletní pro export. --- ## Kdy kontaktovat podporu Jste si jistí, že feed má méně než 256 MB, ale Audit přesto hlásí chybu? Obraťte se na **technickou podporu Mergada** – rádi problém prověříme. --- ## FAQ **Proč Mergado Audit nezpracuje feed větší než 256 MB?** Současná verze Auditu pracuje s limitem **256 MB**. Větší soubory nelze zkontrolovat, zobrazí se chyba „Překročena maximální povolená velikost souboru.“ **Co mám dělat, když feed limit překračuje?** Buď feed **rozdělte** na menší části (každá s kompletní strukturou), nebo jej v Mergadu **dočasně zmenšete** skrytím části produktů či vybraných elementů. **Jak dočasně skryji část produktů?** Na stránce **Produkty** vytvořte výběr (např. podle kategorií, cen nebo `ITEM_ID`). V **Pravidlech** založte **Nové pravidlo** → **Skrytí produktu** a aplikujte jej na výběr. **Jak skryji konkrétní elementy (např. DESCRIPTION)?** Na stránce **Elementy** použijte **přepínač** u daného elementu. Po Auditu je nezapomeňte **znovu zapnout**. **Musím po změnách feed přegenerovat?** Ano. Běžte na **Nastavení** → **Přegenerování** → **Přegenerovat změněné** a až poté spusťte Audit na výstupním feedu. **Kdy se obrátit na podporu?** Pokud je feed **menší než 256 MB**, ale Audit stále hlásí překročení limitu či jinou chybu, kontaktujte **technickou podporu Mergada**. --- ## [Google Feed Validators 1 – definice chyb a doporučená řešení (Mergado Audit)](https://help.mergado.com/cs/audit-produktovych-dat/google-validatory/google-feed-validators-1-definice-chyb-a-doporucena-reseni-mergado-audit/) # Google Feed Validators 1 – definice chyb a doporučená řešení (Mergado Audit) Tento dokument obsahuje přehled validátorů vztahujících se výhradně ke **Google elementům v produktovém feedu**, používaných v nástroji **Mergado Audit**. Každý validátor popisuje konkrétní problém ve feedu, jeho význam a doporučený postup opravy v Mergadu. | title | description | |:-----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Element BARCODE obsahuje neplatnou hodnotu | Element BARCODE obsahuje neplatnou hodnotu | | Element EAN obsahuje neplatnou hodnotu | Element EAN obsahuje neplatnou hodnotu EAN představuje unikátní číselný kód zboží. Na obalech je uváděn jako tzv. čárový kód. Heureka podporuje EAN-13, který sestává z 13 číslic, které mají svůj řád.*Jak tuto chybu opravit?*Malé množství produktů s touto chybou lze opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným EAN kódem. Pomocí ikonky tužky na řádku s elementem EAN manuálně editujte jeho hodnotu a chybný EAN opravte, případně smažte. Stejně tak u dalších.U většího množství chybných EAN kódů záleží na konkrétní situaci, co je v elementu EAN špatně:- Například když EAN obsahuje nějaký znak navíc, můžete použít pravidlo typu Najít a nahradit, kterým takový znak odstraníte.- Nebo se vám může hodit vytvořit si nejprve na stránce Produkty výběr produktů se špatnou hodnotou EAN a následně si přidáte pravidlo typu Přepsat aplikované na tento výběr, kde pole pro novou hodnotu necháte prázdné. Tím chybné hodnoty v elementu EAN u produktů z výběru smažete.- Máte-li k dispozici správné EAN kódy například v CSV souboru, můžete je k produktům ve feedu naimportovat pravidlem typu "Import datového souboru".Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element ean obsahuje neplatnou hodnotu | Element ean obsahuje neplatnou hodnotu EAN představuje unikátní číselný kód zboží. Na obalech je uváděn jako tzv. čárový kód. EAN se skládá z 8 nebo 12-14 číslic, které mají svůj řád. | | Element EANCODE obsahuje neplatnou hodnotu | Element EANCODE obsahuje neplatnou hodnotu EAN představuje unikátní číselný kód zboží. Na obalech je uváděn jako tzv. čárový kód. Árukereső podporuje EAN-13, který sestává z 13 číslic, které mají svůj řád.*Jak tuto chybu opravit?*Malé množství produktů s touto chybou lze opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným EAN kódem. Pomocí ikonky tužky na řádku s elementem EAN manuálně editujte jeho hodnotu a chybný EAN opravte, případně smažte. Stejně tak u dalších.U většího množství chybných EAN kódů záleží na konkrétní situaci, co je v elementu EAN špatně:- Například když EAN obsahuje nějaký znak navíc, můžete použít pravidlo typu Najít a nahradit, kterým takový znak odstraníte.- Nebo se vám může hodit vytvořit si nejprve na stránce Produkty výběr produktů se špatnou hodnotou EAN a následně si přidáte pravidlo typu Přepsat aplikované na tento výběr, kde pole pro novou hodnotu necháte prázdné. Tím chybné hodnoty v elementu EAN u produktů z výběru smažete.- Máte-li k dispozici správné EAN kódy například v CSV souboru, můžete je k produktům ve feedu naimportovat pravidlem typu "Import datového souboru".Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element ean obsahuje neplatnou hodnotu | Element ean obsahuje neplatnou hodnotu Element ean obsahuje unikátní číselný kód zboží. Na obalech je uváděn jako tzv. čárový kód. EAN se skládá z 8 nebo 13 číslic, které mají svůj řád. | | Hodnota elementu G:GTIN má nesprávný formát | Hodnota elementu G:GTIN má nesprávný formát Element g:gtin je unikátním identifikátorem produktů, eshopaři jej obvykle naplňují hodnotou kódu EAN. Ve feedu pro Google nákupy může g:gtin obsahovat 0, 8, 12, 13 nebo 14 znaků. Mezery nebo pomlčky jsou povoleny, ale budou ignorovány. U některých produktů je tento kód chybný, tj. nemá správný formát.Jak tuto chybu opravit?Malé množství produktů s touto chybou lze opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným g:gtin kódem. Pomocí ikonky tužky na řádku s elementem g:gtin manuálně editujte jeho hodnotu a chybný g:gtin opravte, případně smažte. Stejně tak u dalších.U většího množství chybných g:gtin kódů záleží na konkrétní situaci, co je v elementu g:gtin špatně:- Například když g:gtin obsahuje nějaký znak navíc, můžete použít pravidlo typu Najít a nahradit, kterým takový znak odstraníte.- Nebo se vám může hodit vytvořit si nejprve na stránce Produkty výběr produktů se špatnou hodnotou g:gtin a následně si přidáte pravidlo typu Přepsat aplikované na tento výběr, kde pole pro novou hodnotu necháte prázdné. Tím chybné hodnoty v elementu g:gtin u produktů z výběru smažete.- Máte-li k dispozici správné g:gtin kódy například v CSV souboru, můžete je k produktům ve feedu naimportovat pravidlem typu "Import datového souboru".Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Hodnota elementu gtin má nesprávný formát | Hodnota elementu gtin má nesprávný formát Element gtin je unikátní identifikátorem vašeho produktu. Může obsahovat 0, 8, 12, 13 nebo 14 znaků. Mezery nebo pomlčky jsou povoleny, ale budou ignorovány. | | Hodnota elementu GTIN má nesprávný formát | Hodnota elementu GTIN má nesprávný formát Element GTIN je unikátní identifikátorem vašeho produktu. Může obsahovat 0, 8, 12, 13 nebo 14 znaků. Mezery nebo pomlčky jsou povoleny, ale budou ignorovány. | | Hodnota elementu G:GTIN má nesprávný formát | Hodnota elementu G:GTIN má nesprávný formát Element G:GTIN je unikátní identifikátorem vašeho produktu. Může obsahovat 0, 8, 12, 13 nebo 14 znaků. Mezery nebo pomlčky jsou povoleny, ale budou ignorovány. | | Element ISBN obsahuje neplatnou hodnotu | Element ISBN obsahuje neplatnou hodnotu ISBN je jednoznačný identifikátor knih. Obsahuje čísla oddělená pomlčkami.Heureka podporuje formáty ISBN-10 a ISBN-13.Jak tuto chybu opravit?Malé množství produktů s touto chybou lze opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným ISBN kódem. Pomocí ikonky tužky na řádku s elementem ISBN manuálně editujte jeho hodnotu a chybný ISBN opravte. Stejně tak u dalších.U většího množství chybných ISBN kódů záleží na konkrétní situaci, co je v elementu ISBN špatně:- Například když ISBN obsahuje nějaký znak navíc, můžete použít pravidlo typu Najít a nahradit, kterým takový znak odstraníte.- Máte-li k dispozici správné ISBN kódy například v CSV souboru, můžete je k produktům ve feedu naimportovat pravidlem typu "Import datového souboru".Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Hodnota elementu StructuredId má nesprávný formát | Hodnota elementu StructuredId má nesprávný formát Element StructuredId je unikátní identifikátorem vašeho produktu. Může obsahovat 0, 8, 12, 13 nebo 14 znaků. Mezery nebo pomlčky jsou povoleny, ale budou ignorovány. | | Element PRODUCTNO obsahuje neplatnou hodnotu | Element PRODUCTNO obsahuje neplatnou hodnotu | | Hodnota elementu gtin má nesprávný formát | Hodnota elementu gtin má nesprávný formát Element gtin je unikátním identifikátorem vašeho produktu. Může obsahovat 0, 8, 12, 13 nebo 14 znaků. Mezery nebo pomlčky jsou povoleny, ale budou ignorovány. | | Element PRODUCTNAME obsahuje nepovolenou hodnotu | Element PRODUCTNAME obsahuje nepovolenou hodnotu V elementu PRODUCTNAME se nesmí vyskytovat pevné mezery  . | | Element CATEGORY obsahuje nepovolenou hodnotu | Element CATEGORY obsahuje nepovolenou hodnotu V elementu CATEGORY se nesmí vyskytovat pevné mezery  . | | Element DESCRIPTION obsahuje nepovolenou hodnotu | Element DESCRIPTION obsahuje nepovolenou hodnotu V elementu DESCRIPTION se nesmí vyskytovat pevné mezery  . | | Element EAN obsahuje nepovolenou hodnotu | Element EAN obsahuje nepovolenou hodnotu V elementu EAN se nesmí vyskytovat pevné mezery  . | | Element ITEMGROUP_ID obsahuje nepovolenou hodnotu | Element ITEMGROUP_ID obsahuje nepovolenou hodnotu V elementu ITEMGROUP_ID se nesmí vyskytovat pevné mezery  . | | Element ITEM_ID obsahuje nepovolenou hodnotu | Element ITEM_ID obsahuje nepovolenou hodnotu V elementu ITEM_ID se nesmí vyskytovat pevné mezery  . | | Element MANUFACTURER obsahuje nepovolenou hodnotu | Element MANUFACTURER obsahuje nepovolenou hodnotu V elementu MANUFACTURER se nesmí vyskytovat pevné mezery  . | | Element PRODUCTNAME obsahuje nepovolenou hodnotu | Element PRODUCTNAME obsahuje nepovolenou hodnotu V elementu PRODUCTNAME se nesmí vyskytovat pevné mezery  . | | Element PRODUCTNO obsahuje nepovolenou hodnotu | Element PRODUCTNO obsahuje nepovolenou hodnotu V elementu PRODUCTNO se nesmí vyskytovat pevné mezery  . | | Element SEO_PREFIX obsahuje nepovolenou hodnotu | Element SEO_PREFIX obsahuje nepovolenou hodnotu V elementu SEO_PREFIX se nesmí vyskytovat pevné mezery  . | | Hodnota elementu DELIVERY_DATE má hraniční hodnotu 8 dní | Hodnota elementu DELIVERY_DATE má hraniční hodnotu 8 dní Heureka dobu expedice zboží z elementu DELIVERY_DATE zaokrouhluje. Pokud uvedete například 2 dny, Heureka zobrazí "do 3 dnů", stejně jako u položek, které uvedou 3 dny. Zákazníci přitom na tuto informaci dbají. Je proto vhodné u hodnot, jako např. "8 dnů" zvážit, zda nedokážete zboží odeslat již o den dříve.Samotnou úpravu hodnoty v elementu DELIVERY_DATE můžete provést pomocí pravidla typu "Hromadné přepisování dle hodnot", případně "Najít a nahradit".Pokud si s úpravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Hodnota elementu DELIVERY_DATE má hraniční hodnotu 4 dní | Hodnota elementu DELIVERY_DATE má hraniční hodnotu 4 dní Heureka dobu expedice zboží z elementu DELIVERY_DATE zaokrouhluje. Pokud uvedete například 2 dny, Heureka zobrazí "do 3 dnů", stejně jako u položek, které uvedou 3 dny. Zákazníci přitom na tuto informaci dbají. Je proto vhodné u hodnot, jako např. "4 dny" zvážit, zda nedokážete zboží odeslat již o den dříve.Samotnou úpravu hodnoty v elementu elementu DELIVERY_DATE můžete provést pomocí pravidla typu "Hromadné přepisování dle hodnot", případně "Najít a nahradit".Pokud si s úpravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Hodnota elementu DELIVERY_DATE má hraniční hodnotu | Hodnota elementu DELIVERY_DATE má hraniční hodnotu Zboží.cz dobu expedice zboží zaokrouhluje. Pokud uvedete například 7 dní, Zboží.cz zobrazí "více jak týden", stejně jako u položek, které uvedou např. 10 dní. Zákazníci přitom na tuto informaci dbají. Je proto vhodné u hodnot, jako např. "7 dní" zvážit, zda nedokážete zboží odeslat již o den dřív. | | Element obsahuje nepovolenou hodnotu | Element obsahuje nepovolenou hodnotu Neuvádějte odkazy na jiné stránky, kde je váš produkt také k zakoupení. Nesmí obsahovat slova: akció, szállítás, garancia, atd. | | Zboží je asi vyprodáno | Zboží je asi vyprodáno V elementu DESCRIPTION se nachází klíčová slova, která mohou značit, že je produkt vyprodán či nedostupný. Zkontrolujte uvedené zboží, zda není vyprodáno.Pokud je produkt skutečně vyprodaný či nedostupný, v datech pro inzerci jej uvádět nedoporučujeme. Z feedu můžete takové produkty odstranit pomocí pravidla typu "Skrytí produktu".Pokud si s opravou nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element G:TITLE obsahuje nepovolenou hodnotu | Element G:TITLE obsahuje nepovolenou hodnotu Hodnota elementu g:title nesmí obsahovat informace o dopravě zdarma, distribuci, autorizovaném prodejci apod., tj. žádné dodatečné zprávy, které vaše zboží promují. Zkontrolujte, zda g:title neobsahuje u následujících produktů pojmy "doprava zdarma", "distribuce", "autorizovaný prodejce","dostupnost', "splátkový prodej", "splátky", "sleva", "akční cena", "bonus", "osobní odběr", "vyprodan", "vyprodán", "vypredan", "nedostupný" a případně je odstraňte.Jak tuto chybu pomocí Mergada opravit?Nechtěná slova z elementu g:title můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte hledané slovo, pole Nahradit necháte prázdné. Tím se nalezený text odstraní. V případě, že se hledaný text nenajde (nenachází se v g:title), tak se s takovou hodnotou elementu nic nestane.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element TITLE obsahuje nepovolenou hodnotu | Element TITLE obsahuje nepovolenou hodnotu V elementu G:TITLE se nesmí vyskytovat informace o dopravě zdarma, distribuci, autorizovaném prodejci apod. | | Element G:TITLE obsahuje nepovolenou hodnotu | Element G:TITLE obsahuje nepovolenou hodnotu Hodnota v elementu g:title nemůže obsahovat URL odkazy. U některých produktů však v tomto elementu odkazy nebo části URL adresy uvádíte.Jak tuto chybu opravit?Odkazy z elementu g:title můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte odkaz, který chcete smazat, pole Nahradit necháte prázdné. Tím se nalezený text odstraní.Pokud je odkazů hodně a jsou různé (každý je jiný), můžete je hromadně odstranit s využitím tzv. regulárních výrazů. Budete-li potřebovat se sestavením vhodného regulárního výrazu pomoci, ozvěte se prosím na naši technickou podporu, poradíme vám. | | Element GIFT obsahuje nepovolenou hodnotu | Element GIFT obsahuje nepovolenou hodnotu Element GIFT nesmí obsahovat slovo "sleva". Tohle slovo odstraňte editací pravidla, kterým dárek vytváříte nebo pomocí pravidla typu Najít a nahradit. Podle specifikace Heureky nemá být dárkem k produktu sleva ani služba.Pokud si s opravou nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element ITEM_TYPE obsahuje hodnotu „bazar“ | Element ITEM_TYPE obsahuje hodnotu „bazar“ Hodnota „Bazar“ v elementu ITEM_TYPE označuje prodej již použitého zboží. Takovou položku vyhledávač zboží zobrazuje pramálo, nedostane se do produktových karet v kategoriích. Je možné ji dohledat pouze ve fulltextu Heureky.Zvažte takové produkty z feedu skrýt. To můžete provést ve dvou krocích:1. na stránce Produkty si vytvoříte výběr s podmínkou ITEM_TYPE = "Bazar" a poté:2. na stránce Pravidla si přidáte nové, typ zvolíte "Skrytí produktu" a výběr použijete ten z kroku č. 1. | | Element NAME obsahuje nepovolenou hodnotu | Element NAME obsahuje nepovolenou hodnotu Hodnota v elementu Name nemůže obsahovat slova jako 'kedvezmény', 'kedvezményes', 'kedvezményesen', 'kedvező', 'akció', 'akciós', 'ingyen', 'ingyenes', 'árengedmény', 'kiárusítás', 'árleszállítás'.Jak tuto chybu opravit?Odkazy z elementu Name můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte odkaz, který chcete smazat, pole Nahradit necháte prázdné. Tím se nalezený text odstraní.Pokud je odkazů hodně a jsou různé (každý je jiný), můžete je hromadně odstranit s využitím tzv. regulárních výrazů. Budete-li potřebovat se sestavením vhodného regulárního výrazu pomoci, ozvěte se prosím na naši technickou podporu, poradíme vám. | | Distribuci zboží uvádíte jako neznámou | Distribuci zboží uvádíte jako neznámou Parametr "Distribuce" udává, pro jaký trh je zboží určeno. Pro zboží prodávané v ČR jsou nejčastějšími hodnotami "CZ" a "EU". U některého zboží udáváte distribuci neznámou. Zkontrolujte, zda je to úmyslné.Jak tuto chybu opravit? Hodnotu parametru "Distribuce" přepište například na "CZ" nebo na "EU", pokud je zboží určeno pro český trh. To můžete provést pravidlem typu Přepsat nebo pravidlem typu Najít a nahradit. Cesta k elementu (k hodnotě parametru "Distribuce") by v obou pravidlech vypadala takto: PARAM { PARAM_NAME = "Distribuce" } | VALPokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element PARAM_NAME obsahuje nepovolenou hodnotu | Element PARAM_NAME obsahuje nepovolenou hodnotu Název parametru v elementu PARAM | PARAM_NAME nemůže obsahovat odkazy. U některých produktů v názvech parametrů odkazy uvádíte.Jak tuto chybu opravit?Odkazy z názvů parametrů můžete odstranit například pravidlem typu Najít a nahradit.Úplná cesta k elementu, ve kterém budete nahrazení provádět, by vypadala takto: PARAM | PARAM_NAMEPokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Parametr PARAM obsahuje nepovolenou hodnotu | Parametr PARAM obsahuje nepovolenou hodnotu Hodnota parametru v elementu PARAM | VAL slouží pro uvedení konkrétní hodnoty parametru zboží. Například konkrétní barvy, velikosti, funkce atp. Měla by být rozumně dlouhá, neměla by obsahovat například adresy na cizí weby, atp.U některých produktů se však v hodnotách parametrů tyto nedovolené odkazy nachází.Jak chybu opravit?Odkazy z hodnot parametrů můžete odstranit například pravidlem typu Najít a nahradit.Úplná cesta k elementu, ve kterém budete nahrazení provádět, by vypadala takto: PARAM | VALPokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element PRODUCTNAME obsahuje nepovolená slova nebo znaky | Element PRODUCTNAME obsahuje nepovolená slova nebo znaky Hodnota elementu PRODUCTNAME by neměla obsahovat slova benefitů, jako jsou "dárek" či "doprava". Rovněž by neměla obsahovat znaky "©", "™" ani informace, že je produkt vyprodán nebo nedostupný.Jak tuto chybu opravit?Nechtěná slova z elementu PRODUCTNAME můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte hledané slovo, pole Nahradit necháte prázdné. Tím se nalezený text odstraní. V případě, že se hledaný text nenajde (nenachází se v PRODUCTNAME), tak se s takovou hodnotou elementu nic nestane.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element PRODUCT obsahuje nepovolenou hodnotu | Element PRODUCT obsahuje nepovolenou hodnotu Hodnota elementu PRODUCT by neměla obsahovat slova navíc, jako jsou "splátky", "akční cena", "sleva", "bonus", "osobní odběr", "doprava zdarma" apod., ani informace, že je produkt vyprodán nebo nedostupný.Jak tuto chybu opravit?Nechtěná slova z elementu PRODUCT můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte hledané slovo, pole Nahradit necháte prázdné. Tím se nalezený text odstraní. V případě, že se hledaný text nenajde (nenachází se v PRODUCT), tak se s takovou hodnotou elementu nic nestane.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element TITLE obsahuje nepovolenou hodnotu | Element TITLE obsahuje nepovolenou hodnotu Element TITLE nesmí obsahovat žádné dodatečné zprávy, které vaše zboží promují. Zkontrolujte, zda neobsahuje pojmy "doprava zdarma", "distribuce", "autorizovaný prodejce","dostupnost', "splátkový prodej", "splátky", "sleva", "akční cena", "bonus", "osobní odběr", "vyprodan", "vyprodán", "vypredan", "nedostupný" a případně je odstraňte. | | Element PRODUCTNAME obsahuje nepovolenou hodnotu | Element PRODUCTNAME obsahuje nepovolenou hodnotu Název zboží by neměl obsahovat slova jako akce, sleva atd. | | Element Termeknev obsahuje nepovolenou hodnotu | Element Termeknev obsahuje nepovolenou hodnotu Element Termeknev nesmí obsahovat žádné dodatečné zprávy, které vaše zboží promují. Zkontrolujte, zda neobsahuje pojmy 'áron alul', 'legjobbár', 'bónusz', 'vadonatúj', 'ingyenes', 'raktáron', 'minimum vásárlás', 'most rendelni', 'kedvezmény', 'felújított', 'garancia' a případně je odstraňte. | | Element CATEGORYTEXT obsahuje odkaz | Element CATEGORYTEXT obsahuje odkaz Kategorizační cesta v elementu CATEGORYTEXT nemůže obsahovat odkazy. U některých produktů však v tomto elementu odkazy uvádíte.Jak tuto chybu opravit?Odkazy z elementu CATEGORYTEXT můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte odkaz, který chcete smazat, pole Nahradit necháte prázdné. Tím se nalezený text odstraní.Pokud je odkazů hodně a jsou různé (každý je jiný), můžete je hromadně odstranit s využitím tzv. regulárních výrazů. Budete-li potřebovat se sestavením vhodného regulárního výrazu pomoci, ozvěte se prosím na naši technickou podporu, poradíme vám. | | Element PRODUCT obsahuje odkaz | Element PRODUCT obsahuje odkaz Hodnota v elementu PRODUCT nemůže obsahovat odkazy. U některých produktů však v tomto elementu odkazy uvádíte.Jak tuto chybu opravit?Odkazy z elementu PRODUCT můžete odstranit například pravidlem typu Najít a nahradit.Do pole Najít zadáte odkaz, který chcete smazat, pole Nahradit necháte prázdné. Tím se nalezený text odstraní.Pokud je odkazů hodně a jsou různé (každý je jiný), můžete je hromadně odstranit s využitím tzv. regulárních výrazů. Budete-li potřebovat se sestavením vhodného regulárního výrazu pomoci, ozvěte se prosím na naši technickou podporu, poradíme vám. | | Element PRODUCTNAME obsahuje odkaz | Element PRODUCTNAME obsahuje odkaz Element PRODUCTNAME slouží k identifikaci zboží a nesmí obsahovat URL odkaz, pouze text. | | Element TITLE obsahuje URL odkaz | Element TITLE obsahuje URL odkaz Element TITLE slouží k identifikaci zboží a nesmí obsahovat URL odkaz, pouze text. | | Element VISIBILITY obsahuje hodnotu 0 | Element VISIBILITY obsahuje hodnotu 0 Hodnota elementu VISIBILITY značí, zda se má produkt objevit v inzerci vyhledávače zboží. Ve vašem XML u některých produktů element nabývá hodnoty 0 a proto se nakonec v inzerci neobjeví. | | Element CATEGORYTEXT obsahuje neplatný oddělovač | Element CATEGORYTEXT obsahuje neplatný oddělovač | | Element CATEGORYTEXT se vyskytuje více než jednou | Element CATEGORYTEXT se vyskytuje více než jednou | | Element CATEGORYTEXT obsahuje přebytečné oddělovače | Element CATEGORYTEXT obsahuje přebytečné oddělovače | | Element CATEGORYTEXT obsahuje pouze jednu hodnotu | Element CATEGORYTEXT obsahuje pouze jednu hodnotu Označení kategorie by mělo obsahovat plnou cestu ke zboží. Tedy kategorii včetně podkategorií. | | Element CATEGORYTEXT má neplatnou hodnotu | Element CATEGORYTEXT má neplatnou hodnotu Element má označovat kategorii zboží. Kategorie by měla být pěkně popsána, včetně zanoření do podkategorií. | | Element CATEGORY obsahuje neplatný oddělovač | Element CATEGORY obsahuje neplatný oddělovač | | Element CATEGORY se ve feedu vyskytuje víckrát | Element CATEGORY se ve feedu vyskytuje víckrát Ve vašem feedu se element CATEGORY smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element CATEGORY obsahuje přebytečné oddělovače | Element CATEGORY obsahuje přebytečné oddělovače V elementu CATEGORY se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element CATEGORY obsahuje pouze jednu kategorii | Element CATEGORY obsahuje pouze jednu kategorii Element CATEGORY obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element CATEGORY obsahuje neplatnou hodnotu | Element CATEGORY obsahuje neplatnou hodnotu Do feedu je potřeba uvést kompletní cestu kategorie ze stromu kategorií Zboží.cz. Jako oddělovač slouží svislá čára. | | Element fb_product_category obsahuje neplatný oddělovač | Element fb_product_category obsahuje neplatný oddělovač | | Element fb_product_category se ve feedu vyskytuje víckrát | Element fb_product_category se ve feedu vyskytuje víckrát Ve vašem feedu se element fb_product_category smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element fb_product_category obsahuje přebytečné oddělovače | Element fb_product_category obsahuje přebytečné oddělovače V elementu fb_product_category se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element fb_product_category obsahuje pouze jednu kategorii | Element fb_product_category obsahuje pouze jednu kategorii Element fb_product_category obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element fb_product_category obsahuje neplatnou hodnotu nebo je příliš krátký | Element fb_product_category obsahuje neplatnou hodnotu nebo je příliš krátký Element fb_product_category obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element product_type obsahuje neplatný oddělovač | Element product_type obsahuje neplatný oddělovač | | Element product_type se ve feedu vyskytuje víckrát | Element product_type se ve feedu vyskytuje víckrát Ve vašem feedu se element product_type smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element product_type obsahuje přebytečné oddělovače | Element product_type obsahuje přebytečné oddělovače V elementu product_type se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element product_type obsahuje pouze jednu kategorii | Element product_type obsahuje pouze jednu kategorii Element product_type obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element product_type obsahuje neplatnou hodnotu nebo je příliš krátký | Element product_type obsahuje neplatnou hodnotu nebo je příliš krátký Element product_type obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje neplatný oddělovač | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje neplatný oddělovač | --- ## [Google Feed Validators 2 – definice chyb a doporučená řešení (Mergado Audit)](https://help.mergado.com/cs/audit-produktovych-dat/google-validatory/google-feed-validators-2-definice-chyb-a-doporucena-reseni-mergado-audit/) # Google Feed Validators 2 – definice chyb a doporučená řešení (Mergado Audit) Tento dokument obsahuje přehled validátorů vztahujících se výhradně ke **Google elementům v produktovém feedu** , používaných v nástroji **Mergado Audit** . Každý validátor popisuje konkrétní problém ve feedu, jeho význam a doporučený postup opravy v Mergadu. | title | description | |:-----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Element G:GOOGLE_PRODUCT_CATEGORY se ve feedu vyskytuje víckrát | Element G:GOOGLE_PRODUCT_CATEGORY se ve feedu vyskytuje víckrát Ve vašem feedu se element G:GOOGLE_PRODUCT_CATEGORY smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje přebytečné oddělovače | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje přebytečné oddělovače V elementu G:GOOGLE_PRODUCT_CATEGORY se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje pouze jednu kategorii | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje pouze jednu kategorii Element G:GOOGLE_PRODUCT_CATEGORY obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje neplatnou hodnotu nebo je příliš krátký | Element G:GOOGLE_PRODUCT_CATEGORY obsahuje neplatnou hodnotu nebo je příliš krátký Element G:GOOGLE_PRODUCT_CATEGORY obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element GOOGLE_PRODUCT_CATEGORY obsahuje neplatný oddělovač | Element GOOGLE_PRODUCT_CATEGORY obsahuje neplatný oddělovač | | Element GOOGLE_PRODUCT_CATEGORY se ve feedu vyskytuje víckrát | Element GOOGLE_PRODUCT_CATEGORY se ve feedu vyskytuje víckrát Ve vašem feedu se element G:GOOGLE_PRODUCT_CATEGORY smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element GOOGLE_PRODUCT_CATEGORY obsahuje přebytečné oddělovače | Element GOOGLE_PRODUCT_CATEGORY obsahuje přebytečné oddělovače V elementu G:GOOGLE_PRODUCT_CATEGORY se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element GOOGLE_PRODUCT_CATEGORY obsahuje pouze jednu kategorii | Element GOOGLE_PRODUCT_CATEGORY obsahuje pouze jednu kategorii Element GOOGLE_PRODUCT_CATEGORY obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element GOOGLE_PRODUCT_CATEGORY obsahuje neplatnou hodnotu nebo je příliš krátký | Element GOOGLE_PRODUCT_CATEGORY obsahuje neplatnou hodnotu nebo je příliš krátký Element GOOGLE_PRODUCT_CATEGORY obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element CATEGORYTEXT obsahuje neplatný oddělovač | Element CATEGORYTEXT obsahuje neplatný oddělovač Jako oddělovač úrovní jednotlivých kategorií se používá svislítko: |Jak tuto chybu opravit?Pokud máte v elementu CATEGORYTEXT jiný znak jako oddělovač, můžete jej snadno nahradit za "svislítko" pomocí pravidla typu Najít a nahradit.Do pole Najít zadejte aktuální oddělovač, do pole Nahradit zadejte znak: |Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element CATEGORYTEXT se vyskytuje více než jednou | Element CATEGORYTEXT se vyskytuje více než jednou Heureka zpracovává pouze první výskyt elementu CATEGORYTEXT u každé položky. Nemá tedy význam posílat do Heureky vícekrát element CATEGORYTEXT u jednoho produktu.Jak tuto chybu opravit?U produktů můžete smazat druhý a další výskyt elementu CATEGORYTEXT tak, že si přidáte pravidlo typu Přepsat, kde jako cestu k elementu zadáte:CATEGORYTEXT { @@POSITION > 1 }a pole pro novou hodnotu necháte prázdné.Tímto způsobem smažete obsah druhého a případných dalších elementů CATEGORYTEXT a Mergado potom prázdné elementy CATEGORYTEXT do výstupního feedu nebude generovat. Zůstane tak pouze jeden CATEGORYTEXT u každého produktu.Poznámka: Pokud pravidlo nechcete aplikovat na všechny produkty, ale pouze na ty relevantní, vytvořte si nejprve na stránce Produkty výběr produktů, kde použijete cestu k elementu:CATEGORYTEXT { @@POSITION > 1 }a podmínku výběru zvolte "není prázdný". Na tento výběr potom aplikujte přepisovací pravidlo.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element CATEGORYTEXT obsahuje přebytečné oddělovače | Element CATEGORYTEXT obsahuje přebytečné oddělovače Oddělovací znak úrovně kategorií "svislítko": | by se měl vyskytovat pouze mezi jednotlivými kategoriemi. U některých produktů máte tento znak uvedený vícekrát za sebou nebo za ním (či před ním) není uvedena další úroveň kategorie.Jak tuto chybu opravit?Tady záleží na konkrétní situaci. Například pokud máte oddělovací znak jen zdvojený, můžete jej zredukovat pomocí pravidla typu Najít a nahradit, ve kterém nahradíte dva oddělovače: || za jeden: |Budete-li chtít hodnoty v elementu CATEGORYTEXT nastavit kompletně a správně, doporučujeme použít typ pravidla Hromadné přejmenování kategorií, které obsahuje našeptávač Heureka kategorií ve správném tvaru.Pokud je problém složitější, kontaktujte prosím naši technickou podporu, s konkrétním řešením vám poradíme. | | Element CATEGORYTEXT obsahuje pouze jednu hodnotu | Element CATEGORYTEXT obsahuje pouze jednu hodnotu Element CATEGORYTEXT by měl obsahovat plnou cestu k nejvíce zanořené kategorii zboží. To znamená hlavní kategorii včetně podkategorií oddělených znakem | .Jak tuto chybu opravit?Budete-li chtít hodnoty v elementu CATEGORYTEXT nastavit kompletně a správně, doporučujeme použít typ pravidla Hromadné přejmenování kategorií, které obsahuje našeptávač Heureka kategorií ve správném tvaru.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element CATEGORYTEXT má neplatnou hodnotu | Element CATEGORYTEXT má neplatnou hodnotu Element CATEGORYTEXT by měl obsahovat plnou cestu k nejvíce zanořené kategorii zboží. To znamená hlavní kategorii včetně podkategorií oddělených znakem | .Jak tuto chybu opravit?Budete-li chtít hodnoty v elementu CATEGORYTEXT nastavit kompletně a správně, doporučujeme použít typ pravidla Hromadné přejmenování kategorií, které obsahuje našeptávač Heureka kategorií ve správném tvaru.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element Kategoria obsahuje neplatný oddělovač | Element Kategoria obsahuje neplatný oddělovač | | Element Kategoria se ve feedu vyskytuje víckrát | Element Kategoria se ve feedu vyskytuje víckrát Ve vašem feedu se element Kategoria smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element Kategoria obsahuje přebytečné oddělovače | Element Kategoria obsahuje přebytečné oddělovače V elementu Kategoria se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element Kategoria obsahuje pouze jednu kategorii | Element Kategoria obsahuje pouze jednu kategorii Element Kategoria obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element Kategoria obsahuje neplatnou hodnotu nebo je příliš krátký | Element Kategoria obsahuje neplatnou hodnotu nebo je příliš krátký Element Kategoria obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element PRODUCT_TYPE obsahuje neplatný oddělovač | Element PRODUCT_TYPE obsahuje neplatný oddělovač | | Feed obsahuje víckrát element PRODUCT_TYPE | Feed obsahuje víckrát element PRODUCT_TYPE Ve vašem feedu se element PRODUCT_TYPE smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element PRODUCT_TYPE obsahuje přebytečné oddělovače | Element PRODUCT_TYPE obsahuje přebytečné oddělovače V elementu PRODUCT_TYPE se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element PRODUCT_TYPE obsahuje pouze jednu hodnotu | Element PRODUCT_TYPE obsahuje pouze jednu hodnotu Element PRODUCT_TYPE obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element PRODUCT_TYPE obsahuje neplatnou hodnotu nebo je příliš krátký | Element PRODUCT_TYPE obsahuje neplatnou hodnotu nebo je příliš krátký Element PRODUCT_TYPE obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element G:PRODUCT_TYPE obsahuje neplatný oddělovač | Element G:PRODUCT_TYPE obsahuje neplatný oddělovač | | Feed obsahuje víckrát element G:PRODUCT_TYPE | Feed obsahuje víckrát element G:PRODUCT_TYPE Ve vašem feedu se element G:PRODUCT_TYPE smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element G:PRODUCT_TYPE obsahuje přebytečné oddělovače | Element G:PRODUCT_TYPE obsahuje přebytečné oddělovače V elementu G:PRODUCT_TYPE se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element G:PRODUCT_TYPE obsahuje pouze jednu hodnotu | Element G:PRODUCT_TYPE obsahuje pouze jednu hodnotu Element G:PRODUCT_TYPE obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element G:PRODUCT_TYPE obsahuje neplatnou hodnotu nebo je příliš krátký | Element G:PRODUCT_TYPE obsahuje neplatnou hodnotu nebo je příliš krátký Element G:PRODUCT_TYPE obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element G:PRODUCT_TYPE obsahuje neplatný oddělovač | Element G:PRODUCT_TYPE obsahuje neplatný oddělovač | | Feed obsahuje víckrát element G:PRODUCT_TYPE | Feed obsahuje víckrát element G:PRODUCT_TYPE Ve vašem feedu se element G:PRODUCT_TYPE smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element G:PRODUCT_TYPE obsahuje přebytečné oddělovače | Element G:PRODUCT_TYPE obsahuje přebytečné oddělovače V elementu G:PRODUCT_TYPE se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element G:PRODUCT_TYPE obsahuje pouze jednu hodnotu | Element G:PRODUCT_TYPE obsahuje pouze jednu hodnotu Element G:PRODUCT_TYPE obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element G:PRODUCT_TYPE obsahuje neplatnou hodnotu nebo je příliš krátký | Element G:PRODUCT_TYPE obsahuje neplatnou hodnotu nebo je příliš krátký Element G:PRODUCT_TYPE obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element google_product_category obsahuje neplatný oddělovač | Element google_product_category obsahuje neplatný oddělovač | | Feed obsahuje víckrát element google_product_category | Feed obsahuje víckrát element google_product_category Ve vašem feedu se element google_product_category smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element google_product_category obsahuje přebytečné oddělovače | Element google_product_category obsahuje přebytečné oddělovače V elementu google_product_category se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element google_product_category obsahuje pouze jednu hodnotu | Element google_product_category obsahuje pouze jednu hodnotu Element google_product_category obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element google_product_category obsahuje neplatnou hodnotu nebo je příliš krátký | Element google_product_category obsahuje neplatnou hodnotu nebo je příliš krátký Element google_product_category obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element product_type obsahuje neplatný oddělovač | Element product_type obsahuje neplatný oddělovač | | Feed obsahuje víckrát element product_type | Feed obsahuje víckrát element product_type Ve vašem feedu se element product_type smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element product_type obsahuje přebytečné oddělovače | Element product_type obsahuje přebytečné oddělovače V elementu product_type se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element product_type obsahuje pouze jednu hodnotu | Element product_type obsahuje pouze jednu hodnotu Element product_type obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element product_type obsahuje neplatnou hodnotu nebo je příliš krátký | Element product_type obsahuje neplatnou hodnotu nebo je příliš krátký Element product_type obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element google_product_category obsahuje neplatný oddělovač | Element google_product_category obsahuje neplatný oddělovač | | Feed obsahuje víckrát element google_product_category | Feed obsahuje víckrát element google_product_category Ve vašem feedu se element google_product_category smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element google_product_category obsahuje přebytečné oddělovače | Element google_product_category obsahuje přebytečné oddělovače V elementu google_product_category se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element google_product_category obsahuje pouze jednu hodnotu | Element google_product_category obsahuje pouze jednu hodnotu Element google_product_category obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element google_product_category obsahuje neplatnou hodnotu nebo je příliš krátký | Element google_product_category obsahuje neplatnou hodnotu nebo je příliš krátký Element google_product_category obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element product_type obsahuje neplatný oddělovač | Element product_type obsahuje neplatný oddělovač | | Feed obsahuje víckrát element product_type | Feed obsahuje víckrát element product_type Ve vašem feedu se element product_type smí vyskytovat pouze jednou. Zkontrolujte jeho výskyt. | | Element product_type obsahuje přebytečné oddělovače | Element product_type obsahuje přebytečné oddělovače V elementu product_type se nachází přebytečné oddělovače kategorií, pravděpodobně na konci. Odstraňte je. | | Element product_type obsahuje pouze jednu hodnotu | Element product_type obsahuje pouze jednu hodnotu Element product_type obsahuje pouze jednu kategorii, což vyhledávač neumožňuje. Doplňte další kategorie. | | Element product_type obsahuje neplatnou hodnotu nebo je příliš krátký | Element product_type obsahuje neplatnou hodnotu nebo je příliš krátký Element product_type obsahuje informaci o kategorii, do které je zboží zařazeno u prodejce. Zkontrolujte, zda využívá platnou taxonomii a obsahuje dostatek kategorií. | | Element CATEGORYTEXT obsahuje neplatný oddělovač | Element CATEGORYTEXT obsahuje neplatný oddělovač | | Element CATEGORYTEXT se vyskytuje více než jednou | Element CATEGORYTEXT se vyskytuje více než jednou | | Element CATEGORYTEXT obsahuje přebytečné oddělovače | Element CATEGORYTEXT obsahuje přebytečné oddělovače | | Element CATEGORYTEXT obsahuje pouze jednu hodnotu | Element CATEGORYTEXT obsahuje pouze jednu hodnotu | | Element CATEGORYTEXT obsahuje neplatnou hodnotu nebo je příliš krátký | Element CATEGORYTEXT obsahuje neplatnou hodnotu nebo je příliš krátký | | Element PRODUCT neobsahuje hodnotu elementu PRODUCTNAME | Element PRODUCT neobsahuje hodnotu elementu PRODUCTNAME Element PRODUCT by měl obsahovat název zboží včetně přívlastků, například „dárek zdarma“, „+ pouzdro“ apod. Na Heurece bude zobrazen v porovnání cen. | | Element G:TITLE neobsahuje text | Element G:TITLE neobsahuje text Element g:title představuje přesný název zboží. A název obvykle obsahuje alespoň nějaká písmena. Pokud se zboží jmenuje například "48", je pravděpodobné, že zákazníci ani vyhledávače nemusejí poznat, oč jde.Jak tuto chybu opravit?Je-li takových produktů málo, můžete názvy opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným názvem. Pomocí ikonky tužky na řádku s elementem g:title manuálně editujte jeho hodnotu a název opravte. Stejně tak u dalších.- Pokud je takových produktů více a máte správné názvy produktů jen v nějakém jiném elementu ve feedu (např. v NAME, NAME_EXACT, PRODUCTNAME apod.), potom stačí použít pravidlo typu "Hromadné zkopírování hodnot", kterým si překopírujete hodnoty z toho jiného elementu do g:title.- Lze využít i pravidlo typu Import datového souboru, kterým můžete naimportovat správné hodnoty do g:title pomocí CSV souboru.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element PRODUCT neobsahuje žádné písmeno | Element PRODUCT neobsahuje žádné písmeno PRODUCT představuje rozšířený název zboží. A název obvykle obsahuje alespoň nějaká písmena. Pokud se zboží jmenuje například "48", je pravděpodobné, že zákazníci ani vyhledávače nemusejí poznat, oč jde.Jak tuto chybu opravit?Je-li takových produktů málo, můžete názvy opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným názvem. Pomocí ikonky tužky na řádku s elementem PRODUCT manuálně editujte jeho hodnotu a název opravte. Stejně tak u dalších.Pokud je takových produktů více, doporučujeme nejprve na stránce Produkty vytvořit výběr produktů se špatnými hodnotami a následně na tento výběr aplikovat některé z následujících pravidel:- pravidlo typu "Hromadné zkopírování hodnot", kterým si překopírujete hodnoty z PRODUCTNAME do PRODUCT.nebo- pravidlo typu Přepsat, kterým můžete špatnou hodnotu v elementu PRODUCT smazat a produkty budou mít vyplněný jen element PRODUCTNAME.U obou pravidel je předpokladem, že v elementu PRODUCTNAME máte název v pořádku.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element PRODUCTNAME neobsahuje žádné písmeno | Element PRODUCTNAME neobsahuje žádné písmeno PRODUCTNAME představuje přesný název zboží. A název obvykle obsahuje alespoň nějaká písmena. Pokud se zboží jmenuje například "48", je pravděpodobné, že zákazníci ani vyhledávače nemusejí poznat, oč jde.Jak tuto chybu opravit?Je-li takových produktů málo, můžete názvy opravit pomocí manuální editace. Na stránce Produkty si vyhledejte konkrétní produkt s chybným názvem. Pomocí ikonky tužky na řádku s elementem PRODUCTNAME manuálně editujte jeho hodnotu a název opravte. Stejně tak u dalších.- Pokud je takových produktů více a máte správné názvy produktů jen v nějakém jiném elementu ve feedu (např. v NAME nebo v PRODUCT apod.), potom stačí použít pravidlo typu "Hromadné zkopírování hodnot", kterým si překopírujete hodnoty z toho jiného elementu do PRODUCTNAME.- Správné názvy můžete produktům nastavit i doplňkovými aplikacemi Pairing Bear či Heureka Watchdog, které se používají při párování produktů do produktových karet.- Lze využít i pravidlo typu Import datového souboru, kterým můžete naimportovat správné hodnoty do PRODUCTNAME pomocí CSV souboru.Pokud si s opravou přesto nebudete vědět rady, kontaktujte prosím naši technickou podporu. S konkrétním řešením vám poradíme. | | Element TITLE neobsahuje text | Element TITLE neobsahuje text Element TITLE musí být textovým popisem názvu a výrobce vašeho zboží. Zkontrolujte, že tyto informace skutečně obsahuje. | | Element actionFlagActive obsahuje nepovolenou hodnotu | Element actionFlagActive obsahuje nepovolenou hodnotu Element actionFlagActive by měl obsahovat 0 nebo 1. | | Element ACTIVE obsahuje nepovolenou hodnotu | Element ACTIVE obsahuje nepovolenou hodnotu Element ACTIVE by měl obsahovat true nebo false. | | Element ADULT obsahuje nepovolenou hodnotu | Element ADULT obsahuje nepovolenou hodnotu Element ADULT by měl obsahovat 0 nebo 1. | | Element adult obsahuje nepovolenou hodnotu | Element adult obsahuje nepovolenou hodnotu Element adult by měl obsahovat 0 nebo 1. | | Element ALLOWS_IPLATBA obsahuje nepovolenou hodnotu | Element ALLOWS_IPLATBA obsahuje nepovolenou hodnotu Element ALLOWS_IPLATBA by měl obsahovat 0 nebo 1. | --- ## [Změna uživatelských údajů v Mergado účtu](https://help.mergado.com/cs/sprava-uctu-a-fakturace/uzivatelsky-ucet/zmena-uzivatelskych-udaju-v-mergado-uctu/) # Změna uživatelských údajů v Mergado účtu # Změna uživatelských údajů v Mergado účtu Máte nový e-mail nebo telefonní číslo, chcete, aby faktury chodily na e-mail rovnou účetní, stali jste se plátci DPH a potřebujete do fakturačních údajů doplnit DIČ, změnili jste název nebo sídlo firmy? Všechny tyto změny zvládnete jednoduše a rychle sami upravit přímo ve vašem Mergado účtu. Krok za krokem vám ukážeme, co a kde můžete ve svém uživatelském účtu sami změnit nebo doplnit. Změna jména, příjmení a telefonního čísla: 1. Na [Hlavní straně](https://accounts.mergado.com/) (Rozcestník) svého Mergado účtu přejděte do sekce [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/). 2. Jméno, příjmení a telefonní číslo upravte v příslušných kolonkách. 3. Po požadovaných úpravách nezapomeňte na konci stránky kliknout na Uložit nastavení. Změna e-mailu: 1. Na [Hlavní straně](https://accounts.mergado.com/) (Rozcestník) svého Mergado účtu přejděte do sekce [Bezpečnost](https://accounts.mergado.com/security/). 2. V části Změna e-mailu vyplňte do kolonky nový e-mail, který si přejete ve spojení s Mergado Editorem využívat (např. pro příjem faktur nebo upozornění z Mergado Editoru nebo jeho rozšíření). 3. Změnu e-mailu potvrďte kliknutím na tlačítko Odeslat žádost o změnu e-mailu, čímž se změna ihned provede. Změna hesla: 1. Na [Hlavní straně](https://accounts.mergado.com/) (Rozcestník) svého Mergado účtu přejděte do sekce [Bezpečnost](https://accounts.mergado.com/security/). 2. V části Změna hesla vyplňte všechny kolonky. 3. Změnu hesla potvrďte kliknutím na tlačítko Změnit heslo, čímž se změna ihned provede. Změna fakturačních údajů: 1. Na [Hlavní straně](https://accounts.mergado.com/) (Rozcestník) svého Mergado účtu přejděte do sekce [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/). 2. V části Fakturační údaje upravte nebo doplňte do příslušných kolonek informace spojené s fakturací (název firmy, fakturační e-mail, IČO, DIČ, adresa, měna, případně číslo objednávky). 3. Po požadovaných úpravách nezapomeňte na konci stránky kliknout na Uložit nastavení. TIP! V části fakturační údaje se nachází kolonka Fakturační e-mail, kde můžete doplnit libovolný počet e-mailových adres, na které si přejete zasílat faktury (např. účetní, společníci, obchodní partneři). Pokud kolonku necháte prázdnou, faktury budou chodit na váš e-mail vyplněný v části Uživatelské údaje. Změna fakturačního období: 1. Pokud si přejete změnit fakturační období (např. z měsíčního na roční pro získání 20% slevy), přejděte na [Hlavní straně](https://accounts.mergado.com/) (Rozcestník) svého Mergado účtu do sekce [Nastavení plateb](https://accounts.mergado.com/payment_options/). 2. V části Fakturační období zvolte 1 měsíc (pro měsíční fakturaci) nebo 12 měsíců (pro roční fakturaci). 3. Po požadovaných úpravách nezapomeňte na konci stránky kliknout na Uložit nastavení. TIP! Změny fakturačních období provádějte vždy s koncem aktuálně zvoleného fakturačního období. Veškeré změny týkající se fakturace se projeví v následující faktuře. Pokud potřebuje změnit údaje na již vystaveném dokladu, kontaktujte prosím technickou podporu na e-mailové adrese [billing@mergado.com](mailto:billing@mergado.com). Podrobnosti o fakturaci Mergada a jeho rozšíření najdete v [tomto článku](https://forum.mergado.cz/t/zmena-frekvence-fakturace-za-mergado-a-jeho-rozsireni/zmena-frekvence-fakturace-za-mergado-a-jeho-rozsireni). Pokud se nacházíte přímo v Mergado Editoru, ke změně uživatelských nebo fakturačních údajů se dostane kliknutím na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména), kde následně kliknete na možnost Nastavení účtu, čímž budete odkázání do sekce [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/). FAQ: Jak změnit uživatelské a fakturační údaje v Mergado účtu ### Jak změním své uživatelské údaje v Mergado účtu? Své údaje, jako je jméno, heslo, e-mail nebo fakturační údaje, si můžete snadno sami změnit v nastavení vašeho Mergado účtu. Stačí na [Hlavní straně](https://accounts.mergado.com/) (Rozcestník) svého Mergado účtu přejít do sekce [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/), případně [Nastavení plateb](https://accounts.mergado.com/payment_options/) nebo [Bezpečnost](https://accounts.mergado.com/security/). ### Jak změním jméno, příjmení nebo telefonní číslo v Mergado účtu? 1. Na hlavní straně (Rozcestník) vašeho uživatelského účtu přejděte do sekce Uživatelské a fakturační údaje. 2. Upravte jméno, příjmení nebo telefonní číslo v příslušných polích. 3. Nezapomeňte dole na stránce kliknout na Uložit nastavení. ### Jak změním e-mail spojený s Mergado účtem? 1. Na hlavní straně (Rozcestník) vašeho Mergado účtu přejděte do sekce Bezpečnost. 2. V části Změna e-mailu zadejte novou e-mailovou adresu (slouží např. pro zasílání faktur nebo upozornění). 3. Klikněte na Odeslat žádost o změnu e-mailu – změna se ihned provede. ### Jak změním heslo k Mergado účtu? 1. Na hlavní straně (Rozcestník) vašeho Mergado účtu přejděte do sekce Bezpečnost. 2. V části Změna hesla vyplňte všechny kolonky. 3. Klikněte na Změnit heslo – nové heslo se nastaví okamžitě. ### Jak se dostanu k nastavení účtu přímo z Mergado Editoru? Klikněte na ikonu šipky v pravém horním rohu stránky (u svého uživatelského jména). Poté zvolte možnost Nastavení účtu – budete přesměrováni do sekce Uživatelské a fakturační údaje. Jak změním své fakturační údaje v Mergado účtu? Na Hlavní straně (Rozcestník) přejděte do sekce Uživatelské a fakturační údaje. V části Fakturační údaje můžete upravit nebo doplnit: název firmy, fakturační e-mail, IČO, DIČ, adresu, měnu, číslo objednávky. Po změnách klikněte dole na Uložit nastavení. Úpravy se projeví v následující faktuře. ### Mohu přesměrovat faktury přímo na účetní? Ano. V sekci Uživatelské a fakturační údaje je kolonka Fakturační e-mail, kde můžete zadat libovolný počet e-mailových adres, na které budou faktury automaticky zasílány. Faktury tedy mohou chodit přímo účetní nebo třeba vašim obchodním partnerům či společníkům. ### Jak změním fakturační období? Na Hlavní straně (Rozcestník) přejděte do sekce Nastavení plateb. V části Fakturační období zvolte: * 1 měsíc – měsíční fakturace * 12 měsíců – roční fakturace (se slevou 20 %) Nezapomeňte kliknout na Uložit nastavení. Změny fakturačního období provádějte vždy na konci aktuálně zvoleného fakturačního období. Změna se projeví v následující faktuře. ### Co když potřebuji změnit údaje na už vystavené faktuře? V tomto případě kontaktujte naši podporu na e-mailu billing@mergado.com. --- ## [Vytvoření a zrušení účtu v Mergado přes Google účet](https://help.mergado.com/cs/sprava-uctu-a-fakturace/uzivatelsky-ucet/vytvoreni-a-zruseni-uctu-v-mergado-pres-google-ucet/) # Vytvoření a zrušení účtu v Mergado přes Google účet # Vytvoření a zrušení účtu v Mergado přes Google účet Tento návod vás provede vytvořením (nebo přihlášením) účtu v Mergadu pomocí tlačítka **Přihlásit se přes Google** a také ukáže, jak napojení na Google zase zrušit. Přihlášení přes Google je rychlé – nemusíte vyplňovat registrační formulář. Zrušení propojení se naopak nedělá v Mergadu, ale v nastavení Google účtu. ## Postup krok za krokem ### A) Vytvoření nového účtu / přihlášení do Mergada přes Google 1. Na přihlašovací stránce Mergada klikněte na **Přihlásit se přes Google**. 2. Zadejte své standardní přihlašovací údaje ke Google účtu (e-mail/jméno a heslo). 3. Po úspěšném přihlášení budete automaticky přesměrováni do Mergada na **Rázcestník**, kde se přepnete tam, kam potřebujete. > Vytvoření/přihlášení přes Google je jednoduché a rychlé. ### B) Jak zrušit napojení Google účtu na Mergado > Pozor: zrušení napojení se **neprovádí v Mergadu**, ale v nastavení vašeho Google účtu. 1. Otevřete svůj **Google účet** a přejděte na záložku **Zabezpečení**. 2. Na pravé straně najdete seznam **aplikací a služeb**, ke kterým je Google připojen. * Pokud se nezobrazují všechny aplikace, klikněte na **Zobrazit všechna připojení**. 3. V seznamu vyhledejte **Mergado** a klikněte na **šipku** na pravé straně. 4. Zobrazí se podrobnosti o propojení účtu Google s Mergadem včetně možnosti **smazat všechna propojení** se službou Mergado. 5. Smazáním propojení **přerušíte napojení Google na Mergado** – tím se **zruší i váš účet v Mergadu**. ## Tipy * Pokud Mergado v seznamu připojených služeb nevidíte, použijte volbu **Zobrazit všechna připojení**. * Při přihlašování přes Google si připravte své **e-mailové/jmenné** přihlašovací údaje a **heslo** k Google účtu. * Pamatujte, že **zrušení napojení řešíte výhradně v Google účtu** – v Mergadu žádný krok navíc není potřeba. ## FAQ **Mohu si vytvořit účet v Mergadu přes Google?** Ano. Klikněte na **Přihlásit se přes Google**, přihlaste se ke svému Google účtu a budete přesměrováni do Mergada na **Rázcestník**. **Co přesně zadávám při přihlášení přes Google?** Standardní údaje ke Google účtu: **e-mail/jméno a heslo**. **Kde po přihlášení v Mergadu skončím?** Po úspěšném přihlášení budete přesměrováni na **Rázcestník** a dál pokračujete podle potřeby. **Jak zruším napojení Google účtu na Mergado?** V **Google účtu** na záložce **Zabezpečení** otevřete seznam připojených aplikací, vyhledejte **Mergado**, rozklikněte šipkou a zvolte **smazání propojení**. **Nevidím Mergado v připojených aplikacích. Co s tím?** Klikněte na **Zobrazit všechna připojení** a hledejte znovu. **Co se stane po smazání propojení v Google účtu?** Propojení se přeruší a tím se **zruší i váš účet v Mergadu**. **Musím pro zrušení účtu něco dělat přímo v Mergadu?** Ne. Zrušení napojení i účtu vyřešíte **v nastavení Google účtu**. --- ## [Změna Vlastníka e-shopu](https://help.mergado.com/cs/sprava-uctu-a-fakturace/vlastnictvi-a-dalsi-opravneni/zmena-vlastnika-e-shopu/) # Změna Vlastníka e-shopu Jste v situaci, kdy chcete správu svého e-shopu (včetně fakturace) předat agentuře? Nebo jste naopak agentura, která předává e-shop zpět do rukou klienta? Prodali jste e-shop a potřebujete jej předat novému majiteli? Všechny tyto změny jednoduše a sami vyřešíte změnou oprávnění, kdy svou roli Vlastníka e-shopu přesunete na jiného uživatele nebo subjekt (např. agenturu). Krok za krokem vám ukážeme, jak na to. Vezmeme to ale od základu a nejdříve si vysvětlíme, jaké druhy oprávnění můžete v rámci Mergada mít. ### Úrovně oprávnění v Mergadu V Mergadu existují tři úrovně oprávnění, které vám umožňují rozdílně nakládat s jednotlivými e-shopy: 1. Vlastník (Owner) * Tomuto uživateli/subjektu jsou fakturovány zvolené služby v rámci konkrétního e-shopu. Má plný přístup k úpravě fakturačních údajů, frekvenci plateb a fakturám. * Má možnost přidávat/odebírat oprávnění (Zápis/Čtení) k danému e-shopu dalším uživatelům nebo subjektům. * Může svou roli Vlastníka předat jinému uživateli. (V tu chvíli automaticky získává roli Zápis a přichází o výše uvedená oprávnění.) * Může upravovat obsah e-shopu. * Jeden e-shop může mít pouze jednoho Vlastníka. 2. Zápis (Write) * Může upravovat obsah e-shopu, ke kterému mu Vlastník daného e-shopu umožnil přístup v roli Zápis. * Nemá přístup k úpravě fakturačních údajů a fakturám. * Nemůže přidávat nebo odebírat další uživatelská oprávnění k e-shopu a nevidí jiné uživatele než sebe a vlastníka. * K jednomu e-shopu je možné přidat libovolné množství uživatelů s oprávněním Zápis. 3. Čtení (Read) * Má přístup k prohlížení e-shopu, ale nemůže provádět žádné změny. * K jednomu e-shopu je možné přidat libovolné množství uživatelů s oprávněním Čtení. Jak přidat oprávnění jiným uživatelům (Zápis/Čtení) V okamžiku, kdy si ve svém uživatelském účtu vytvoříte e-shop, automaticky se stáváte jeho Vlastníkem. Faktury za využívané služby budou chodit vám, můžete upravovat fakturační údaje a máte veškeré kompetence uvedené výše. Pokud chcete k vybranému e-shopu umožnit přístup i jiným lidem, ujistěte se nejdříve, že tito lidé mají v Mergadu vytvořený svůj vlastní uživatelský účet (samotný uživatelský účet je zdarma). 1. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 3. V pravé části stránky je část Pozvat uživatele, kde vyplníte e-mail uživatele, kterému chcete udělit oprávnění. Pod tím vybere oprávnění, které mu chcete udělit (Zápis/Čtení) a kliknete na Poslat pozvánku. 4. Uživatel pozvánku obdrží do e-mailu a oprávnění získá ve chvíli, kdy tuto pozvánku přijme. Pokud ji nepřijme, oprávnění nezíská. 5. Na této stránce také uvidíte seznam veškerých uživatelů, kterým jste udělili oprávnění k vybranému e-shopu. Zde můžete kliknutím na ikonku tužky uživatelům změnit oprávnění nebo jej kliknutím na ikonku koše odebrat. Podobně můžou i vám jiní uživatelé udělovat oprávnění ke svým e-shopů. Seznam všech e-shopů, ke kterým máte nějaký typ oprávnění, uvidíte v sekci Detaily uživatele ve svém Mergado účtu. Jak změnit Vlastníka e-shopu Vlastníkem e-shopu se můžete stát tak, že vytvoříte e-shop ve svém uživatelském účtu. Případně tak, že vám jiný uživatel toto oprávnění předá a vy jej přijmete. Jako Vlastníkovi jsou vám fakturovány zvolené služby v rámci konkrétního e-shopu. Máte plný přístup k úpravě fakturačních údajů, frekvenci plateb a veškerým fakturám. Máte možnost přidávat nebo odebírat oprávnění (Zápis/Čtení) dalším uživatelům nebo subjektům a můžete upravovat obsah e-shopu. V případě, že se rozhodnete předat Vlastnictví e-shopu jinému uživateli nebo subjektu, postup je podobný, jako u přidělování oprávnění Zápis nebo Čtení. Rozdíl je však v tom, že jeden e-shop může mít pouze jednoho Vlastníka. Proces změny probíhá tak, že udělíte jinému uživateli oprávnění Vlastník. Tento uživatel musí následně pozvánku k tomuto oprávnění přijmout ve svém vlastním uživatelském účtu. V tu chvíli přijdete o oprávnění Vlastník (a veškeré pravomoci s tím spojené) a automaticky je vám pro daný e-shop uděleno oprávnění Zápis (může upravovat obsah e-shopu, ale nejsou vám fakturovány placené služby spojené s tímto e-shopem). Jak postupovat při změně Vlastníka e-shopu: Ujistěte se, že uživatel, kterému chcete předat oprávnění Vlastník, má v Mergadu již vytvořený uživatelský účet. 1. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 3. V pravé části stránky je část Pozvat uživatele, kde vyplníte e-mail uživatele, kterému chcete udělit oprávnění. Pod tím vybere oprávnění Vlastník a kliknete na Poslat pozvánku. 4. Poté, co uživatel ve svém uživatelském účtu pozvánku přijme, stává se Vlastníkem e-shopu. Vaše oprávnění se automaticky změní na Zápis. Od této chvíle jsou placené služby spojené s tímto e-shopem fakturovány novému Vlastníkovi a vy již nemáte přístup k fakturám ani změně fakturačních údajů. ## FAQ: Jak změnit Vlastníka e-shopu v Mergadu? ### Jaké druhy oprávnění existují v Mergadu? V Mergadu existují tři druhy oprávnění k e-shopu. * Vlastník (Owner) – má plný přístup k úpravám v e-shopu, včetně fakturace, nastavení plateb a správy oprávnění pro další uživatele. Může předat vlastnictví jinému uživateli. Každý e-shop může mít pouze jednoho vlastníka. * Zápis (Write) – může upravovat obsah e-shopu, ale nemá přístup k fakturaci ani správě uživatelů. * Čtení (Read) – má pouze náhled do e-shopu, bez možnosti provádět změny. ### Jak mohu přidat oprávnění dalším uživatelům? Přidat oprávnění k e-shopu můžete pouze pokud jste Vlastníkem daného e-shopu. Postup je následující: 1. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 3. V části Pozvat uživatele zadejte e-mail uživatele, kterému chcete udělit přístup (tento uživatel musí mít vytvořen svůj vlastní uživatelský účet v Mergadu). 4. Zvolte typ oprávnění (Zápis/Čtení) a klikněte na Poslat pozvánku. 5. Uživatel pozvánku obdrží do e-mailu a oprávnění získá ve chvíli, kdy tuto pozvánku přijme. Pokud ji nepřijme, oprávnění nezíská. Na stejné stránce vidíte seznam všech uživatelů s přístupem k danému e-shopu, kde můžete jejich oprávnění změnit nebo odebrat. ### Jak změním Vlastníka e-shopu? 1. Ujistěte se, že uživatel nebo subjekt, kterému chcete vlastnictví předat, má v Mergadu vytvořený uživatelský účet. 2. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 3. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 4. V části Pozvat uživatele zadejte e-mail uživatele nebo subjektu a jako oprávnění zvolte Vlastník. 5. Klikněte na Poslat pozvánku. 6. Jakmile uživatel nebo subjekt pozvánku přijme, stává se novým Vlastníkem. Vaše oprávnění k e-shopu automaticky přejde do role Zápis. ### Co se stane po předání Vlastnictví e-shopu? Novému Vlastníkovi jsou fakturovány všechny služby spojené s daným e-shopem. Dosavadní Vlastník automaticky získá roli Zápis (může spravovat obsah, ale už ne fakturaci). Původní Vlastník ztrácí přístup k fakturám a fakturačním údajům. ### Jak mohu předat správu e-shopu agentuře nebo klientovi? Správu e-shopu (včetně fakturace) předáte tak, že změníte oprávnění a svou roli Vlastníka e-shopu přesunete na jiného uživatele nebo subjekt (např. agenturu). ### Co dělat, když prodám e-shop a potřebuji ho převést na nového majitele? Stačí novému majiteli udělit oprávnění Vlastník. Jakmile pozvánku přijme, stává se Vlastníkem e-shopu a vám se automaticky přiřadí role Zápis, kterou vám může nový Vlastník odebrat. --- ## [Změna Oprávnění v e-shopu](https://help.mergado.com/cs/sprava-uctu-a-fakturace/vlastnictvi-a-dalsi-opravneni/zmena-opravneni-v-e-shopu/) # Změna Oprávnění v e-shopu # Změna Oprávnění v e-shopu Máte v Mergadu e-shop, ale potřebujete, aby v něm mohl úpravy provádět i někdo další (např. váš zaměstnanec nebo agentura)? Nebo jste naopak freelancer či agentura, která e-shop spravuje pro klienta, ale ten chce mít k úpravám v e-shopu také přístup? Případně jej nechce upravovat, ale chce se čas od času podívat, jak to ve feedech vypadá? Chce váš nadřízený nebo obchodní partner vidět, co se v e-shopu děje, ale zároveň si chce pojistit, že v nastavení něco omylem nezmění? Všechny situace vyřešíte tak, že dalším uživatelům umožníte přístup k e-shopu v takové formě, v jaké to vám i jim bude nejvíce vyhovovat. Jednoduše jim udělíte jedno z možných Oprávnění. Jedinou podmínkou je, aby tito lidé nebo subjekty měli v Mergadu vytvořené vlastní uživatelské účty, které jsou zdarma. Jaké jsou v Mergadu typy Oprávnění V Mergadu existují tři úrovně oprávnění, které vám umožňují rozdílně nakládat s jednotlivými e-shopy: 1. Vlastník (Owner) * Tomuto uživateli/subjektu jsou fakturovány zvolené služby v rámci konkrétního e-shopu. Má plný přístup k úpravě fakturačních údajů, frekvenci plateb a fakturám. * Má možnost přidávat/odebírat oprávnění (Zápis/Čtení) k danému e-shopu dalším uživatelům nebo subjektům. * Může svou roli Vlastníka předat jinému uživateli. (V tu chvíli automaticky získává roli Zápis a přichází o výše uvedená oprávnění.) * Může upravovat obsah e-shopu. * Jeden e-shop může mít pouze jednoho Vlastníka. 2. Zápis (Write) * Může upravovat obsah e-shopu, ke kterému mu Vlastník daného e-shopu umožnil přístup v roli Zápis. * Nemá přístup k úpravě fakturačních údajů a fakturám. * Nemůže přidávat nebo odebírat další uživatelská oprávnění k e-shopu a nevidí jiné uživatele než sebe a vlastníka. * K jednomu e-shopu je možné přidat libovolné množství uživatelů s oprávněním Zápis. 3. Čtení (Read) * Má přístup k prohlížení e-shopu, ale nemůže provádět žádné změny. * K jednomu e-shopu je možné přidat libovolné množství uživatelů s oprávněním Čtení. Jak přidat nebo odebrat oprávnění jiným uživatelům (Zápis/Čtení) V okamžiku, kdy si ve svém uživatelském účtu vytvoříte e-shop, automaticky se stáváte jeho Vlastníkem. Faktury za využívané služby budou chodit vám, můžete upravovat fakturační údaje a máte veškeré kompetence uvedené výše. Pokud chcete k vybranému e-shopu umožnit přístup i jiným lidem, ujistěte se nejdříve, že tito lidé mají v Mergadu vytvořený svůj vlastní uživatelský účet. 1. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 3. V pravé části stránky je část Pozvat uživatele, kde vyplníte e-mail uživatele, kterému chcete udělit oprávnění. Pod tím vybere oprávnění, které mu chcete udělit (Zápis/Čtení) a kliknete na Poslat pozvánku. 4. Uživatel pozvánku obdrží do e-mailu. Přes odkaz v e-mailu je přesměrován do svého uživatelského účtu v Mergadu a oprávnění získá ve chvíli, kdy tuto pozvánku v Mergadu přijme. Pokud ji nepřijme, oprávnění nezíská. 5. Na této stránce (Oprávnění uživatelů) také uvidíte seznam veškerých uživatelů, kterým jste udělili oprávnění k vybranému e-shopu. Zde můžete kliknutím na ikonku tužky uživatelům změnit oprávnění nebo jej kliknutím na ikonku koše odebrat. Podobně můžou i vám jiní uživatelé udělovat oprávnění ke svým e-shopů. Seznam všech e-shopů, ke kterým máte nějaký typ oprávnění, uvidíte v sekci Detaily uživatele ve svém Mergado účtu. Jak změnit oprávnění Vlastníka e-shopu Vlastníkem e-shopu se můžete stát tak, že vytvoříte e-shop ve svém uživatelském účtu. Případně tak, že vám jiný uživatel toto oprávnění předá a vy jej přijmete. Jako Vlastníkovi jsou vám fakturovány zvolené služby v rámci konkrétního e-shopu. Máte plný přístup k úpravě fakturačních údajů, frekvenci plateb a veškerým fakturám. Máte možnost přidávat nebo odebírat oprávnění (Zápis/Čtení) dalším uživatelům nebo subjektům a můžete upravovat obsah e-shopu. V případě, že se rozhodnete předat Vlastnictví e-shopu jinému uživateli nebo subjektu, postup je podobný, jako u přidělování oprávnění Zápis nebo Čtení. Rozdíl je však v tom, že jeden e-shop může mít pouze jednoho Vlastníka. Proces změny probíhá tak, že udělíte jinému uživateli oprávnění Vlastník. Tento uživatel obdrží do e-mailu pozvánku. Přes odkaz v e-mailu je přesměrován do svého uživatelského účtu v Mergadu, kde musí pozvánku přijmout. V tu chvíli přijdete o oprávnění Vlastník (a veškeré pravomoci s tím spojené) a automaticky je vám pro daný e-shop uděleno oprávnění Zápis (můžete upravovat obsah e-shopu, ale nejsou vám fakturovány placené služby spojené s tímto e-shopem). Jak postupovat při změně Vlastníka e-shopu: Ujistěte se, že uživatel, kterému chcete předat oprávnění Vlastník, má v Mergadu již vytvořený uživatelský účet. 1. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 3. V pravé části stránky je část Pozvat uživatele, kde vyplníte e-mail uživatele, kterému chcete udělit oprávnění. Pod tím vybere oprávnění Vlastník a kliknete na Poslat pozvánku. 4. Uživatel pozvánku obdrží do e-mailu, ze kterého je přesměrován do svého uživatelského účtu v Mergadu. Oprávnění získá ve chvíli, kdy tuto pozvánku v Mergadu přijme. Pokud ji nepřijme, oprávnění nezíská. 5. Po přijetí pozvánky se uživatel stává Vlastníkem e-shopu. Vaše oprávnění se automaticky změní na Zápis. Od této chvíle jsou placené služby spojené s tímto e-shopem fakturovány novému Vlastníkovi a vy nemáte přístup k jeho fakturačním údajům a fakturám na ně vystaveným. Jak při práci v Mergadu využívat Oprávnění Udělit nebo mít oprávnění Zápis můžete chtít například z těchto důvodů: * Jsem majitelem a Vlastníkem e-shopu, platím faktury za Mergado, ale inzerci mi spravuje zaměstnanec nebo externí agentura či freelancer, udělím jim tedy oprávnění Zápis. * Jsem majitelem e-shopu, ale jeho správu (včetně fakturace) má na starosti externí agentura, nicméně stále chci mít možnost upravovat e-shop. Externí agentura tedy bude mít oprávnění Vlastník a já si nechám oprávnění Zápis. * Nejsem majitelem ani Vlastníkem e-shopu (a tedy neplatím faktury za Mergado), ale jsem zaměstnanec nebo externí agentura či freelancer, který spravuje feedy klienta. Budu mít tedy oprávnění Zápis. Udělit nebo mít oprávnění Čtení můžete chtít například z těchto důvodů: * Jsem majitelem e-shopu, ale jeho správu (editování i fakturaci) má plně v rukou externí agentura. Chci mít možnost nahlédnout, co se v e-shopu děje, ale nechci provádět žádné úpravy, případně se chci vyhnout situaci, že omylem něco upravím. Agentura bude mít oprávnění Vlastník, já budu mít oprávnění Čtení. * Jsem majitelem e-shopu, ale mám obchodního partnera nebo společníka, který chce mít možnost nahlédnout, co se v e-shopu děje, bude mít proto oprávnění Zápis. Udělit nebo mít oprávnění Vlastník můžete chtít například z těchto důvodů: * Jsem majitelem e-shopu a chci mít pod kontrolou kompletní správu e-shopu zahrnující fakturaci, editování feedů a udělování oprávnění Zápis nebo Čtení dalším uživatelům. A to včetně situace, kdy mi feedy spravuje zaměstnanec nebo externí agentura či freelancer, kterým v takovém případě udělím oprávnění Zápis. * Jsem externí agentura či freelencer, který svému klientovi fakturuje kompletní správu e-shopu včetně ceny za Mergado. Jsem proto Vlastníkem e-shopu a klientovi podle potřeby udělím oprávnění Zápis nebo Čtení. Jak zjistím, kdo má oprávnění k mému e-shopu Informace o tom, kdo má uděleno oprávnění k e-shopu, jehož jste Vlastníkem, zjistíte na stránce Oprávnění uživatelů. Na tuto stránku se dostanete následujícím způsobem: 1. V Mergadu klikněte na ikonku šipky v pravém horním rohu stránky (vedle svého uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Na stránce Detaily uživatele uvidíte seznam e-shopů, jejichž jste Vlastníkem. U vybraného e-shopu klikněte na ikonku tří postav a tím budete odkázání na stránku Oprávnění uživatelů. 3. Tady uvidíte seznam veškerých uživatelů, kterým bylo k tomuto e-shopu uděleno oprávnění Zápis nebo Čtení. 4. Zde můžete kliknutím na ikonku tužky uživatelům změnit oprávnění nebo jej kliknutím na ikonku koše odebrat. Jak zjistím, jaké mám oprávnění k jiným e-shopům Informace o tom, k jakým e-shopům máte oprávnění, najdete na stránce Detaily uživatele. Dostanete se k ní tak, že v Mergadu kliknete na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejdete na stránku Detaily uživatele. Tato stránka slouží jako přehledný dashboard, kde najdete důležité informace o vašem uživatelském účtu, e-shopech, rozšířeních i fakturaci. Uvidíte zde seznam e-shopů, jejichž jste Vlastníkem, a také seznam e-shopů, ke kterým vám bylo uděleno oprávnění v roli Zápis nebo Čtení. FAQ: Jak v Mergadu změnit Oprávnění e-shopu? ### Jaké typy oprávnění existují v Mergadu? V Mergadu rozlišujeme tři úrovně oprávnění: Vlastník, Zápis a Čtení. Vlastník má plnou kontrolu nad e-shopem i fakturací, Zápis umožňuje upravovat obsah e-shopu bez přístupu k fakturaci nebo správě oprávnění a Čtení slouží pouze k náhledu bez možnosti úprav. Jak mohu udělit přístup dalším uživatelům k mému e-shopu? Přidat oprávnění k e-shopu můžete pouze pokud jste Vlastníkem daného e-shopu. Postup je následující: 1. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 2. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 3. V části Pozvat uživatele zadejte e-mail uživatele, kterému chcete udělit přístup (tento uživatel musí mít vytvořen svůj vlastní uživatelský účet v Mergadu). 4. Zvolte typ oprávnění (Zápis/Čtení) a klikněte na Poslat pozvánku. 5. Uživatel pozvánku obdrží do e-mailu. Přes odkaz v e-mailu je přesměrován do svého uživatelského účtu a oprávnění získá ve chvíli, kdy tuto pozvánku v Mergadu přijme. Pokud ji nepřijme, oprávnění nezíská. Na stejné stránce (Oprávnění uživatelů) uvidíte seznam všech uživatelů s přístupem k danému e-shopu, kde můžete jejich oprávnění změnit nebo odebrat. ### Jak změním Vlastníka e-shopu? 1. Ujistěte se, že uživatel nebo subjekt, kterému chcete vlastnictví předat, má v Mergadu vytvořený uživatelský účet. 2. V Mergadu klikněte na ikonku šipky v horním pravém rohu stránky (u vašeho uživatelského jména) a přejděte na stránku Detaily uživatele. 3. Zde najdete seznam svých e-shopů. U vybraného e-shopu klikněte na ikonku tří postav, což vás odkáže do sekce Oprávnění uživatelů. 4. V části Pozvat uživatele zadejte e-mail uživatele nebo subjektu a jako oprávnění zvolte Vlastník. 5. Klikněte na Poslat pozvánku. 6. Jakmile uživatel nebo subjekt pozvánku přijme, stává se novým Vlastníkem. Vaše oprávnění k e-shopu automaticky přejde do role Zápis. ### Jak zjistím, kdo má oprávnění k mému e-shopu? Informace o tom, kdo má uděleno oprávnění k e-shopu, jehož jste Vlastníkem, zjistíte na stránce Oprávnění uživatelů. Dostanete se k ní tak, že ve svém uživatelském účtu kliknete na ikonku šipky v pravém horním rohu stránky a přejdete na stránku Detaily uživatele. Zde uvidíte seznam e-shopů, jejichž jste Vlastníkem. U vybraného e-shopu kliknete na ikonku tří postav, což vás odkáže na stránku Oprávnění uživatelů. Tady najdete seznam veškerých uživatelů, kteří mají k e-shopu přístup v roli Zápis nebo Čtení. Na tomto místě můžete oprávnění kdykoliv změnit nebo odebrat. ### Potřebuje mít každý, komu chci dát přístup k e-shopu, vlastní Mergado účet? Ano, každý uživatel musí mít svůj vlastní účet v Mergadu. Registrace je zdarma. ### Kolik uživatelů může mít k e-shopu přístup? Počet uživatelů s oprávněním Zápis nebo Čtení není nijak omezen. Omezení je pouze u role Vlastník – ten může být vždy jen jeden. ### Mohu uživateli změnit nebo odebrat oprávnění, které jsem mu přidělil? Pokud jste Vlastníkem e-shopu, tak ano. V sekci Oprávnění uživatelů můžete kdykoliv změnit typ oprávnění (např. z Čtení na Zápis) nebo přístup zcela odebrat. Pokud máte k e-shopu oprávnění Zápis, nemáte možnost přidávat nebo odebírat jiným uživatelům oprávnění, a to ani v případě, že jste někdy v minulosti byl Vlastníkem daného e-shopu. ### Může mi někdo jiný udělit přístup k jeho e-shopu? Ano, přístup k jinému e-shopu vám může udělit jeho Vlastník. Podmínkou je, že jste registrovaným uživatelem Mergada. Ve chvíli, kdy vám Vlastník daného e-shopu udělí oprávnění, přijde vám do e-mailu pozvánka, přes odkaz v e-mailu budete přesměrování do svého uživatelského účtu, kde pozvání přijmete. Všechny e-shopy, kam máte přístup, uvidíte v sekci Detaily uživatele. ### Jak přijmu oprávnění, které mi k e-shopu udělil jeho Vlastník? Pokud vám Vlastník e-shopu udělí oprávnění (Zápis, Čtení nebo Vlastník), dorazí vám do e-mailu pozvánka z Mergada. Přes odkaz v e-mailu budete odkázání do svého Mergado účtu, kde pozvánku potvrdíte a oprávnění se aktivuje. Pokud pozvánku nepotvrdíte, přístup k e-shopu nezískáte. Po přijetí uvidíte e-shop v přehledu svých projektů a také na stránce Detaily uživatele. ### Může jeden e-shop v Mergadu spravovat více lidí? Ano. Každý e-shop může mít jednoho Vlastníka, na jehož fakturační údaje je vystavována faktura. Dále může mít k e-shopu přístup neomezené množství další uživatelů s oprávněním Zápis nebo Čtení, které jim udělí (nebo odebere) Vlastník e-shopu. Ostatní uživatelé e-shop spravují nebo prohlížejí ze svého vlastního uživatelského účtu. ### Kdy mám udělit oprávnění Zápis? Pokud chcete, aby někdo jiný mohl upravovat obsah e-shopu (např. zaměstnanec, externí agentura nebo freelancer), ale nechcete mu dát přístup k fakturaci. Oprávnění Zápis je ideální také tehdy, když jste majitel a chcete e-shop upravovat, ale nechcete řešit fakturaci, kterou má na starosti někdo jiný. ### Kdy je vhodné udělit oprávnění Čtení? Pokud chcete, aby měl někdo pouze náhled do e-shopu bez možnosti cokoliv měnit. Hodí se např. pro obchodní partnery, nadřízené nebo majitele, kteří chtějí mít přehled, ale nechtějí riskovat nechtěné úpravy. ### Kdy potřebuji oprávnění Vlastník? Pokud chcete mít plnou kontrolu nad e-shopem, včetně fakturace, nastavení plateb a správy přístupů. Oprávnění Vlastník se také využívá například tehdy, když e-shop kompletně spravuje agentura a jejich fakturace pro klienta zahrnuje také částku zaplacenou za služby Mergada. --- ## [Změna frekvence fakturace za Mergado a jeho rozšíření](https://help.mergado.com/cs/sprava-uctu-a-fakturace/tarify-a-fakturace/zmena-frekvence-fakturace-za-mergado-a-jeho-rozsireni/) # Změna frekvence fakturace za Mergado a jeho rozšíření # Fakturace za Mergado a jeho rozšíření ## Úvod Vítejte! Pokud se právě zabýváte fakturací za Mergado a jeho rozšíření, jste na správném místě. Tento článek vám pomůže porozumět, jak správně nastavit fakturaci a jaké možnosti máte při správě plateb. S naším návodem to zvládnete snadno a bez stresu. 😌 ## Jak začít s nastavením fakturace Nastavení fakturace v Mergadu je jednoduché a můžete si ho přizpůsobit podle svých potřeb. Pokud chcete začít, stačí se přihlásit do svého účtu. V sekci Uživatelské a fakturační údaje můžete změnit své fakturační údaje a v sekci Nastavení plateb si zvolíte frekvenci plateb, které probíhají inkasem z platební karty. ### Krok za krokem: 1. Na [Hlavní stránce](https://accounts.mergado.com/) vašeho účtu přejděte do sekce: * [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/) – zde vyplňte své fakturační údaje. 2. Přejděte do sekce [Nastavení plateb](https://accounts.mergado.com/payment_options/) a zvolte platební bránu (Stripe nebo GoPay), přes kterou chcete, aby probíhala platba inkasem z vaší platební karty. 3. Ve stejné sekci si zvolte frekvenci plateb (Fakturační období): * 1 měsíc – fakturace probíhá jednou za měsíc * 12 měsíců – fakturace probíhá jednou ročně Při změně frekvence plateb se změny projeví u nově vystavených faktur. ## Kdo může měnit fakturaci a spravovat fakturační údaje? Fakturaci v Mergadu může spravovat pouze uživatel s rolí Vlastník (Owner). Tento uživatel má plný přístup k veškerým finančním a fakturačním záležitostem e-shopu. ### Pravomoci Vlastníka v oblasti fakturace: * Zodpovědnost za faktury: Vlastník je odpovědný za fakturační údaje, které jsou při vystavení faktury použity. Faktura vždy přijde na e-mail Vlastníka, případně na e-mail/y osoby nebo subjektu, který/které vyplníte v sekci Uživatelské a fakturační údaje do kolonky Fakturační e-mail. * Nastavení fakturační frekvence: Vlastník může změnit frekvenci plateb (např. na roční pro získání slevy). Tato změna se provádí v sekci [Nastavení plateb](https://accounts.mergado.com/payment_options/). * Správa fakturačních údajů: Vlastník má přístup k úpravám fakturačních údajů a může je spravovat v sekci [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/). * Zobrazení faktur: Faktury mohou dohledat a stáhnout pouze Vlastníci účtu. Mají přístup k sekci Faktury ve svém účtu, kde si je mohou stáhnout. * Opakovaná platba: Vlastník může nastavit nebo zrušit opakovanou platbu (inkaso) v sekci Uživatelské a fakturační údaje svého účtu. ### Převod oprávnění Vlastníka Pokud je potřeba fakturaci služeb převést na jiného uživatele nebo subjekt, je možné změnit roli Vlastníka. Tato změna se provádí u konkrétního E-shopu, v sekci Nastavení a záložce Oprávnění uživatelů. Ke změně dojde v okamžiku, kdy nový nový Vlastník přijme vlastnictví ve svém účtu. Novému Vlastníkovi začnou chodit faktury a bude mít přístup k sekci Faktury, zatímco původní vlastník automaticky získá oprávnění Zápis. ### Úrovně oprávnění v Mergadu V Mergadu existují tři úrovně oprávnění: 1. Vlastník (Owner): Tomuto uživateli/subjektu jsou fakturovány zvolené služby. Má plný přístup k úpravě fakturačních údajů a frekvenci plateb. Má možnost přidávat/odebírat oprávnění ke svému e-shopu dalším uživatelům nebo subjektům. Může upravovat obsah svého e-shopu. 2. Zápis (Write): Může upravovat obsah e-shopu, ale nemá přístup k úpravě fakturačních údajů a fakturám. Nemůže také přidávat nebo odebírat další uživatelská oprávnění k e-shopu a nevidí jiné uživatele než sebe a vlastníka. 3. Čtení (Read): Má přístup k prohlížení e-shopu, ale nemůže provádět žádné změny. ## Jaké jsou výhody roční fakturace? Pokud si nastavíte roční frekvenci plateb, získáte výraznou finanční slevu. ### Výhody roční fakturace: * Sleva 20 % z Mergado tarifu. * Sleva 20 % na doplňková rozšíření z Mergado Store. Tato sleva se týká jak nových, tak stávajících zákazníků. Pokud přejdete z měsíční fakturace na roční, sleva se projeví při nejbližší fakturaci po vypršení aktuálního předplaceného období. ## Možnosti fakturace doplňkových rozšíření Důležité je vědět, že fakturace Mergado tarifu a doplňkových rozšíření je propojená. To znamená, že doplňková rozšíření se fakturují ve stejné frekvenci jako Mergado tarif. Pokud si pro fakturování Mergado tarifu zvolíte roční fakturaci, budou ročně fakturována také vámi používaná rozšíření. ## Jak změnit frekvenci zpět na měsíční? Pokud chcete přejít zpět na měsíční fakturaci, stačí změnit frekvenci plateb v nastavení (viz Jak začít s nastavením fakturace). S tím ale přijdete o slevu 20 % na tarif i rozšíření. Změna se projeví až po vypršení aktuálního předplaceného období. ### Kdy je nutná technická podpora? V některých případech je nutné obrátit se na technickou podporu: * Úpravy již vystavených faktur: Pokud potřebujete změnit fakturační údaje nebo období na zálohové (proforma) faktuře, napište technické podpoře. * Požadavky na převedení přeplatku do následujícího fakturačního období: Pokud nechcete, aby vám byla platba navíc automaticky vrácena, ale chcete přeplatek použít pro pokrytí platby v následujícím fakturačním období. Pokud máte jakýkoliv problém s fakturací, rádi vám pomůžeme. Kontaktujte nás na billing@mergado.com. ## Často kladené otázky ### Můžu změnit frekvenci fakturace kdykoliv? Frekvenci fakturace můžete změnit s koncem aktuálně zvoleného fakturačního období. ### Jak změním údaje na vystavené faktuře? Pokud potřebujete změnit údaje na již vystavené faktuře, kontaktujte naši technickou podporu. ### Co se stane, když nezaplatím fakturu? Pokud nezaplatíte fakturu, Mergado dočasně vypne veškeré služby, které využíváte, tedy včetně používaných rozšíření. V takovém případě stačí zaplatit dlužnou částku a kontaktovat technickou podporu pro opětovnou aktivaci. ## Závěr Správné nastavení fakturace v Mergadu vám ušetří čas a peníze. Můžete si přizpůsobit frekvenci plateb, a využít tak dvacetiprocentní slevy, která se odečítá při roční fakturaci. Pokud máte jakýkoliv problém, naše technická podpora je vám vždy k dispozici. ## FAQ: Fakturace za Mergado a jeho rozšíření ### Jak začnu s nastavením fakturace v Mergadu? Stačí se přihlásit do svého účtu Mergado a přejít do sekce Nastavení plateb, kde můžete zvolit platební bránu a frekvenci plateb. V sekci Uživatelské a fakturační údaje vyplníte své fakturační údaje. ### Kdo může měnit fakturační údaje? Fakturaci může spravovat pouze uživatel s rolí Vlastník (Owner), který má plný přístup k fakturačním údajům a veškerým záležitostem ohledně svého uživatelského účtu. ### Jaké jsou výhody roční fakturace? Pokud zvolíte roční fakturaci, získáte: * Slevu 20 % na Mergado tarif. * Slevu 20 % na doplňková rozšíření z Mergado Store. ### Jak změním fakturační frekvenci? Pro změnu fakturační frekvence přejděte v nastavení uživatelského účtu do sekce Nastavení plateb. ### Můžu měnit frekvenci fakturace kdykoliv? Frekvenci fakturace můžete změnit s koncem aktuálně zvoleného fakturačního období. ### Jak se změní fakturační údaje na vystavené faktuře? Pokud potřebujete změnit údaje na již vystavené faktuře, kontaktujte technickou podporu. ### Co se stane, pokud nezaplatím fakturu? Pokud nezaplatíte fakturu, Mergado dočasně vypne veškeré služby, které využíváte, tedy včetně používaných rozšíření. Po zaplacení dlužné částky kontaktujte technickou podporu pro opětovnou aktivaci. ### Jak získám slevu na doplňková rozšíření? Pokud si nastavíte roční fakturaci, získáte slevu 20 % na všechna doplňková rozšíření z Mergado Store. ### Kdy je nutné kontaktovat technickou podporu? Kontaktujte technickou podporu v těchto případech: * Úpravy již vystavených faktur (např. změna údajů na zálohové faktuře). * Požadavky na převedení přeplatku do následujícího fakturačního období: Pokud nechcete, aby vám byla platba navíc automaticky vrácena, ale chcete přeplatek použít pro pokrytí platby v následujícím fakturačním období. * Požadavek na jinou formu platby než inkasem. * Požadavek na ukončení fakturace a tedy placených služeb Mergado Editoru. ### Je možné za služby platit i jinak než inkasem? Pokud vám nevyhovuje platba inkasem, kontaktuje podporu na e-mailu [billing@mergado.com a pokusíme se společně najít způsob platby, který vám bude vyhovovat více.](mailto:billing@mergado.com) ### Jak mohu zrušit fakturaci a ukončit používání Mergada? Pro ukončení placených služeb Mergado Editoru prosím kontaktujte podporu na e-mailu [billing@mergado.com](mailto:billing@mergado.com). --- ## [Změna tarifu pro e-shop](https://help.mergado.com/cs/sprava-uctu-a-fakturace/tarify-a-fakturace/zmena-tarifu-pro-e-shop/) # Změna tarifu pro e-shop # Změna tarifu pro e-shop Pokud si přejete změnit tarif pro svůj e-shop, tak vám musíme rovnou říct, že manuálně změnu neprovedete. Úroveň tarifu automaticky určuje Mergado na základě počtu produktů ve výstupních feedech. Jinými slovy, Mergado se podívá, kolik projektů (neboli integrací) máte v rámci daného e-shopu a kolik produktů je na výstupu každého projektu. Tyto produkty na výstupu sečte a na základě výsledného počtu určí typ tarifu. Pokud máte e-shopů více, Mergado počítá tarif zvlášť pro každý e-shop. Na faktuře tedy budete mít každý e-shop vyfakturovaný samostatně. ## FAQ: Jak změnit tarif ve svém e-shopu? ### Jak zjistím, jaký mám aktuálně tarif? Aktuální tarif snadno zjistíte přímo v Mergadu. 1. Na [hlavní stránce](https://app.mergado.com/) Mergada klikněte na e-shop, u kterého si přejete zjistit aktuální tarif. 2. Na posledním řádku ve sloupci Produkty uvidíte celkový počet produktů na výstupu, na základě kterého se určuje tarif. 3. Klikněte na černé liště na ikonku „i“. Zde uvidíte aktuální tarif a také další informace – jaký je limit produktů pro tento tarif a kolik z něj využíváte, jaké fakturační období máte nastaveno i do kdy máte tento tarif předplacen. Informace o tarifu u všech svých e-shopů také přehledně uvidíte na stránce Detaily uživatele. Zde se dostanete kliknutím na šipku v pravém horním rohu stránky (vedle svého uživatelského jména) a kliknutím na Detaily uživatele. ### Jak změním tarif ve svém e-shopu? Tarif ve svém e-shopu sami změnit nemůžete. Úroveň tarifu Mergado určuje automaticky na základě počtu produktů ve všech výstupních feedech daného e-shopu. ### Chci do svého e-shopu přidat produkty nebo vytvořit další projekt. Jak zjistím, v jakém budu tarifu? Výši tarifu si můžete snadno ověřit v [Ceníku](https://www.mergado.cz/cenik), který najdete na našich webových stránkách. 1. V levém zeleném poli zvolte, zda si přejete zjistit cenu pro měsíční nebo roční fakturaci. 2. V pravém zeleném poli zvolte, zda chcete zobrazit ceny v korunách nebo eurech. 3. Zadejte počet produktů ve vašem e-shopu. 4. Zadejte počet integrací (projektů) pro tento e-shop. 5. Podívejte se, do jakého tarifu bude váš e-shop spadat. ### Jak zjistím, že se mi zvýšil tarif? Ve chvíli, kdy přesáhnete aktuálně předplacený tarif, obdržíte upozornění do e-mailu. Pokud na základě tohoto upozornění provedete v daném e-shopu změny, které povedou k vrácení do původního nižšího tarifu (např. smažete projekt nebo snížíte počet produktů), nebudeme vám toto krátkodobé navýšení fakturovat. Pokud změny neprovedete, v blízké době vám zašleme fakturu za navýšení tarifu. ### Co když snižuji počet produktů nebo ruším některé projekty? Jak snížím tarif? Pokud ze svého e-shopu odstraníte takové množství produktů nebo projektů, že začne spadat do nižšího tarifu, než v jaké se aktuálně nachází, nemusíte nic dělat, ani nám to oznamovat. Mergado snížení počtu produktů samo rozpozná a automaticky vám tarif sníží. ### Jak se fakturují rozdíly při změně tarifů? Fakturace za Mergado probíhá formou předplatného. Rozdíl v ceně, který vznikne při zvýšení tarifu, proto fakturujeme pomocí rozdílové faktury. * Pokud se váš tarif v průběhu aktuálního předplaceného období sníží, tato změna ceny se projeví v následujícím fakturačním období. * Pokud se váš tarif v průběhu aktuálního předplaceného období zvýší, tato změna ceny se projeví v aktuálním fakturačním období a vzniklé navýšení vám vyfakturujeme rozdílovou fakturou. Více informací o fakturaci při změně tarifu najdete v [tomto článku](https://forum.mergado.cz/t/jak-v-mergadu-funguje-rozdilova-faktura/jak-v-mergadu-funguje-rozdilova-faktura). ### Jak se počítá počet produktů pro výpočet výsledné ceny? Celkový počet produktů pro fakturaci se vypočítá součtem produktů ve všech výstupních feedech (projektech) ve vybraném fakturovaném e-shopu. Pro příklad: Vlastníte e-shop, ve kterém máte vytvořeny tři projekty. Jeden pro Heureku, kde je ve výstupním feedu 2 000 produktů. Druhý pro Zboží.cz, kde je ve výstupním feedu také 2 000 produktů. Třetí pro Google Merchants, kde je ve výstupním feedu 1 500 produktů. To znamená: 2 000 + 2 000 + 1 500 = 5 500 produktů, tedy tarif Basic, který má limit do 10 000 produktů. ### Mám více e-shopů, můžu sečíst všechny feedy a mít tarif podle součtu všech položek? Ne. Mergado vypočítává tarif samostatně pro každý e-shop zvlášť. Tedy i pokud jde o jeho cizojazyčné mutace (např. sk./.de/.pl), které jsou počítány jako samostatné e-shopy, protože e-shop je v kontextu Mergada definován doménou vstupního feedu. ### Jak se určuje tarif pro rozšíření Mergada? Jednotlivá rozšíření Mergada mají stanovenou pevnou cenu, kterou najdete v našem [Ceníku](https://www.mergado.cz/cenik) nebo [Mergado Storu](https://store.mergado.com/?lang=cs&_gl=1*1kpj2mz*_gcl_aw*R0NMLjE3NTk0NzE4NDMuRUFJYUlRb2JDaE1JcnByYnJxLUhrQU1WcVplREJ4MkJVUnNERUFBWUFTQUFFZ0pyWWZEX0J3RQ..*_gcl_au*MTQxMzgxMjk1My4xNzU5NDcxODQz*_ga*MTg3MjUyNzAwMi4xNzU5NDcxODQz*_ga_5JED3N4VLV*czE3NTk0NzE4NDEkbzEkZzAkdDE3NTk0NzE4NDEkajYwJGwwJGgw&pk_vid=df7426b737b461c117594718457f8268&_cl=MTsxOzE7NDQxcUdLRkZCbDI5SEViMWxqZks4UGh0MGJpTVIzbEd4amlnaUU1Zk9acThPNXNCQjBqUnpkUno0Q1pkS3R4bzs=). Cena je daná a počet produktů na výstupu ji nijak neovlivní. --- ## [Jak provádět změny fakturačních údajů](https://help.mergado.com/cs/sprava-uctu-a-fakturace/tarify-a-fakturace/jak-provadet-zmeny-fakturacnich-udaju/) # Jak provádět změny fakturačních údajů # Jak provádět změny fakturačních údajů ## Úvod Pokud potřebujete upravit fakturační údaje ve vašem účtu Mergado, máte několik možností v závislosti na tom, zda chcete změnit údaje pro budoucí faktury, nebo pro již vystavené doklady. Tento návod vás provede celým procesem, abyste to zvládli snadno a rychle. 😊 ## 1. Změna fakturačních údajů pro budoucí faktury (Administrace) Pokud chcete upravit fakturační údaje pro budoucí faktury (např. změnit IČO, DIČ, název společnosti nebo fakturační frekvenci), můžete to provést přímo v nastavení svého účtu. ### Jak na to: * Úprava fakturačních údajů: Změnu fakturačních údajů (například kontaktních informací) provedete v nastavení svého účtu v sekci Uživatelské a fakturační údaje. * Změna fakturační frekvence: Pokud chcete změnit fakturační období (například přejít z měsíční fakturace na roční pro získání slevy), upravte tuto možnost v nastavení svého účtu v sekci Nastavení plateb. ### Krok za krokem: 1. V nastavení vašeho uživatelského účtu přejděte do sekce [Uživatelské a fakturační údaje](https://accounts.mergado.com/settings/) a proveďte požadované změny. 2. Pokud chcete upravit frekvenci fakturace (měsíční/roční), přejděte do sekce [Nastavení plateb](https://accounts.mergado.com/payment_options/) a zvolte požadovanou frekvenci. Důležité upozornění: Změny se projeví pouze u nově vystavených faktur. To znamená, že faktury, které již byly vystaveny, nebudou těmito změnami ovlivněny. ## 2. Změna údajů na již vystavené faktuře (Technická podpora) Pokud potřebujete upravit fakturační údaje nebo fakturační období na již vystavené zálohové (proforma) faktuře nebo daňovém dokladě, změny nemůžete provést sami. V tomto případě je nutné kontaktovat technickou podporu. ### Jak na to: 1. Napište na e-mail billing@mergado.com, kde uvedete, co konkrétně chcete změnit na vystavené faktuře. 2. Technická podpora vám s úpravami pomůže a provede je za vás. ## Závěr Změny fakturačních údajů pro budoucí faktury zvládnete jednoduše sami v nastavení účtu. Pro úpravy na již vystavených fakturách je potřeba kontaktovat technickou podporu. # FAQ: Jak provádět změny fakturačních údajů v Mergadu ### Jak změním fakturační údaje pro budoucí faktury? Změnu fakturačních údajů pro budoucí faktury provedete přímo v nastavení fakturačních údajů ve vašem účtu. Můžete upravit kontaktní údaje, IČO, DIČ nebo změnit fakturační frekvenci (měsíční/roční). ### Jak změním frekvenci fakturace (měsíční/roční)? Pro změnu fakturační frekvence přejděte do sekce Nastavení plateb ve vašem uživatelském účtu. ### Kdy se změny fakturačních údajů projeví? Změny fakturačních údajů se projeví pouze u nově vystavených faktur. Faktury, které již byly vystaveny, nebudou těmito změnami ovlivněny. ### Jak změním údaje na již vystavené faktuře? Pokud potřebujete upravit fakturační údaje na již vystavené zálohové (proforma) faktuře nebo daňovém dokladě, kontaktujte technickou podporu na e-mailu billing@mergado.com, kde uvedete požadované změny. ### Můžu změnit údaje na již vystavených fakturách sám? Ne, pro změny na již vystavených fakturách je nutné obrátit se na technickou podporu. --- ## [Jak v Mergadu funguje rozdílová faktura](https://help.mergado.com/cs/sprava-uctu-a-fakturace/tarify-a-fakturace/jak-v-mergadu-funguje-rozdilova-faktura/) # Jak v Mergadu funguje rozdílová faktura # Jak v Mergadu funguje rozdílová faktura ## Úvod Rozdílové faktury jsou vystavovány z důvodu automatických úprav tarifu a cenových rozdílů, které vznikají při změně počtu produktů ve vašem feedu, při vytvoření nových e-shopů nebo aktivování rozšíření. ## Automatické změny tarifu Fakturace v Mergadu je založena na automatických úpravách tarifu podle počtu produktů ve vašich výstupních feedech. Pokud se počet produktů změní a dosáhne jiného tarifu, systém automaticky upraví fakturaci. Tímto způsobem dochází k promítnutí cenových rozdílů mezi starým a novým tarifem na vaší faktuře. ### Jak to funguje: 1. Změna tarifu: * Pokud se počet položek ve vašem feedu zvýší a dosáhne dražšího tarifu, Mergado automaticky přepne tarif na vyšší úroveň. * Pokud se počet produktů sníží a e-shop se dostane do nižšího tarifu, tarif se v Mergadu automaticky upraví. Pokud už však byla strhnuta platba, případně vystavena zálohová nebo rozdílová faktura s vyšším tarifem, je potřeba pro úpravu dokladu kontaktovat technickou podporu. 2. Fakturace změny: * Pokud se váš tarif v průběhu aktuálního předplaceného období sníží, tato změna ceny se projeví v následujícím fakturačním období. * Pokud se váš tarif v průběhu aktuálního předplaceného období zvýší, tato změna ceny se projeví v aktuálním fakturačním období a vzniklé navýšení vám vyfakturujeme rozdílovou fakturou. 3. Navýšení tarifu: * Navýšení tarifu, když počet produktů vzroste a e-shop spadne do dražšího tarifu, probíhá automaticky ode dne, kdy proběhla změna. 4. Snížení tarifu: * Pokud počet produktů klesne a e-shop se dostane do nižšího tarifu, tarif se v Mergadu automaticky upraví a nižší cena bude fakturována od následujícího fakturačního období. Pokud už však byla strhnuta platba, případně vystavena zálohová nebo rozdílová faktura s vyšším tarifem, je potřeba pro úpravu dokladu kontaktovat technickou podporu. ## Ostatní rozdíly a přeplatky Pokud dojde k přeplatku (například pokud zaplatíte více, než je požadováno), Mergado vám přeplatek automaticky vrátí. Pokud si přejete platbu navíc použít pro pokrytí platby v následujícím fakturačním období, je potřeba kontaktovat technickou podporu. Pokud změníte fakturační frekvenci (například přechod z měsíční na roční pro získání slevy 20 %), tato změna se projeví u nově vystavených faktur po doběhnutí aktuálního předplaceného období. Pokud potřebujete změnit fakturační údaje na již vystavené zálohové (proforma) faktuře nebo daňovém dokladě, musíte se obrátit na technickou podporu. ## Závěr Mergado automaticky upravuje tarif, rozdíly v ceně mezi starým a novým tarifem se promítají do vystavených faktur. Pokud dojde k přeplatku nebo změně tarifu, systém se postará o úpravu fakturace a v případě potřeby můžete kontaktovat technickou podporu pro manuální zásahy. # FAQ: Jak v Mergadu funguje rozdílová faktura ### Co je rozdílová faktura v Mergadu? Rozdílová faktura zohledňuje automatické úpravy tarifu a promítnutí cenových rozdílů mezi starým a novým tarifem a navýšení ceny z důvodu vytvoření nových e-shopů nebo aktivace rozšíření. ### Jak probíhá změna tarifu v Mergadu? Fakturace v Mergadu se automaticky přizpůsobuje změnám v počtu produktů ve vašem feedu. Pokud se počet produktů zvýší nebo sníží, systém automaticky přepne tarif na vyšší nebo nižší úroveň. ### Kdy se změna tarifu promítne do faktury? Pokud dojde ke změně tarifu, rozdíl v ceně mezi starým a novým tarifem se promítne do nejbližší vystavené faktury. Tato změna se provádí spolu s další fakturací. ### Jak probíhá navýšení tarifu? Pokud se počet produktů zvýší a e-shop spadne do dražšího tarifu, navýšení probíhá automaticky ode dne, kdy proběhla změna. ### Co když potřebuji snížit tarif? Pokud se počet produktů sníží a e-shop se dostane do nižšího tarifu, tarif se v Mergadu automaticky upraví. Pokud už však byla vystavena zálohová nebo rozdílová faktura s vyšším tarifem, je potřeba pro úpravu dokladu kontaktovat technickou podporu. ### Co se stane, když zaplatím více, než je požadováno (mám přeplatek)? Pokud zaplatíte více než požadováno, Mergado vám přeplatek automaticky vrátí. Pokud si přejete platbu navíc použít pro pokrytí platby v následujícím fakturačním období, je potřeba kontaktovat technickou podporu. ### Můžu změnit fakturační údaje na již vystavené zálohové faktuře nebo daňovím dokladě? Pokud potřebujete změnit fakturační údaje na již vystavené zálohové (proforma) faktuře, musíte se obrátit na technickou podporu. ### Co se stane, když změním fakturační frekvenci? Pokud změníte fakturační frekvenci (například přechod z měsíční na roční pro získání slevy 20 %), změna se projeví u nově vystavených faktur po doběhnutí aktuálního předplaceného období. --- ## [Jak v Mergadu provést storno faktury](https://help.mergado.com/cs/sprava-uctu-a-fakturace/tarify-a-fakturace/jak-v-mergadu-provest-storno-faktury/) # Jak v Mergadu provést storno faktury # Jak v Mergadu provést storno faktury ## Úvod V Mergadu není možné storno faktury provést přímo v uživatelské administraci, ale je potřeba kontaktovat technickou podporu. Tento proces se týká situací, kdy chcete zrušit nebo upravit již vystavené faktury. Následující návod vám ukáže, jak správně postupovat při stornování faktury a jaké kroky podniknout. ## Kdy je nutné kontaktovat technickou podporu? ### 1. Změna nebo storno zálohové (proforma) faktury a daňového dokladu Pokud jste obdrželi zálohovou (proforma) fakturu nebo daňový doklad a potřebujete v nich provést změnu (například změnu fakturačních údajů nebo fakturačního období) nebo je stornovat, musíte kontaktovat technickou podporu. * Důvod: Změny provedené v nastavení účtu se projevují pouze u nově vystavených faktur. Pokud tedy potřebujete upravit již vystavenou zálohovou fakturu, podpora provede potřebné úpravy za vás. ### 2. Vrácení přeplatku Pokud došlo k přeplatku nebo duplicitní platbě, bude vám automaticky vrácena. Pokud si přejete platbu navíc použít pro pokrytí platby v následujícím fakturačním období, je potřeba kontaktovat technickou podporu. ### 3. Kontakt pro fakturaci Veškeré dotazy ohledně faktur a dokladů směřujte na e-mailovou adresu: billing@mergado.com ### 4. Zobrazení stornovaných dokladů Důležité je vědět, že stornované doklady se nezobrazují v sekci Faktury ve vašem uživatelském účtu. Pokud tedy proběhlo storno faktury, nebude již zobrazena v seznamu dokladů. ## Závěr Pokud potřebujete stornovat fakturu nebo provést jakoukoliv jinou změnu, která se týká již vystavených dokladů, nezapomeňte se obrátit na technickou podporu. Rádi vám pomohou s úpravami, ať už jde o storno zálohové faktury, převod přeplatku do následujícího fakturačního období nebo jakýkoliv jiný problém. Pro jakékoliv dotazy nás neváhejte kontaktovat na billing@mergado.com. 😊 ## FAQ: Jak v Mergadu provést storno faktury ### Mohu provést storno faktury přímo v administraci? Ne, storno faktury nelze provést přímo v administraci. Pro storno faktury nebo úpravu již vystavených faktur musíte kontaktovat technickou podporu. ### Kdy je nutné kontaktovat technickou podporu? Kontaktujte technickou podporu v následujících případech: 1. Pokud potřebujete změnit nebo stornovat zálohovou (proforma) fakturu nebo daňový doklad, např. změnit fakturační údaje nebo období. 2. Pokud máte přeplatek a chcete požádat, aby vám nebyl automaticky vrácen, ale byl převeden do následujícího fakturačního období. ### Jak požádat o vrácení přeplatku? Pokud máte přeplatek nebo platbu navíc, bude vám automaticky vrácena. Pokud si přejete platbu navíc použít pro pokrytí platby v následujícím fakturačním období, je potřeba kontaktovat technickou podporu. ### Kde najdu stornovanou fakturu? Stornované faktury se nezobrazují v sekci Faktury ve vašem účtu. Po provedení storna již nebude faktura v seznamu dokladů. ### Jak mohu kontaktovat podporu pro fakturační dotazy? Veškeré dotazy ohledně faktur a dokladů směřujte na e-mail billing@mergado.com. --- ## [Co je rozšíření Mergado Marketplaces?](https://help.mergado.com/cs/mergado-marketplaces/co-je-rozsireni-mergado-marketplaces/) # Co je rozšíření Mergado Marketplaces? *Mergado Marketplaces* je rozšíření v rámci ekosystému Mergada, které umožňuje automaticky nahrávat a spravovat tisíce produktů na online tržištích (marketplaces) Allegro a Kaufland Global Marketplace. Rozšíření spáruje produkty s katalogem tržiště, zalistuje i ty unikátní a zajistí, že skladové zásoby i ceny budou vždy aktuální. Díky pravidelné synchronizaci nabízí produkty, které jsou opravdu skladem, čímž předchází stornu objednávek i nespokojeným zákazníkům. Uživatelé e-shopových platforem Shopify, WooCommerce, Shoptet Premium a UNAS a účetního systému POHODA navíc mohou pohodlně spravovat objednávky přímo v administraci využívaného systému. Rozšíření také výrazně usnadňuje dodržování legislativních požadavků nařízení GPSR a nabídky tak zůstávají stále viditelné. ## Cena a fakturace Cena rozšíření je: * 286 Kč za měsíc při měsíční fakturaci, * 228,80 Kč za měsíc při roční fakturaci. Cena je stanovena pro jeden e-shop (v Mergadu) a je fixní, bez ohledu na počet produktů, objednávek či napojení na marketplaces. Vzhledem k technické návaznosti je rozšíření fakturováno v souladu se zvolenou frekvencí fakturace v Mergado Editoru. Pro jednotlivé služby nelze zvolit různé frekvence fakturace. Rozšíření Mergado Marketplaces má 30denní zkušební dobu zdarma. ## Základní pojmy spojené s rozšířením Mergado Markeplaces - Marketplace – Internetová platforma, která na jednom místě sdružuje produkty jiných obchodů a e-shopů (např. Allegro, Kaufland). - API napojení – API napojení umožňuje efektivní komunikaci mezi Mergadem a marketplacem, tzn. pravidelnou a častou synchronizaci dat. Hlavní výhodou API napojení na marketplace je zejména frekvence aktualizace dostupnosti. - E-shop (v Mergadu) – Sdružení jednoho a více projektů patřících pod jednu doménu e-shopu (např. Muj-obchod.cz). - Projekt – Po nahrání vstupního feedu do Mergado Editoru se vytvoří projekt. V projektu se dělají veškeré úpravy dat (např. pomocí výběru, pravidel a automatizací). - Výběr – Skupina produktů vyhovující zadané podmínce (např. ze všech produktů filtrujeme produkty s cenou nad 500 Kč). - Produktový feed – Strukturovaný datový soubor, který obsahuje elementy s informacemi o produktech (název, kategorie, prodejní cena atd.). - Dostupnostní feed – Datový soubor, který obsahuje informace o skladové dostupnosti produktů. Rozšíření Mergado Marketplaces přijímá dostupnostní feed v Heureka nebo Mall formátu nebo ve formátu Mergado Marketplaces. - Kampaň – V rozšíření Mergado Marketplaces se zakládají kampaně, které načítají data z produktového feedu a vytvářejí nabídky na marketplace. Výhodou je možnost různých nastavení kampaní, např. pokud máte jiný ceník dopravy pro malé a velké produkty, založíte si dvě kampaně s různými ceníky. - Výchozí prodejní kanál – Allegro trh, na kterém jste si zaregistrovali svůj firemní účet. Pokud se následně rozhodnete prodávat i na jiných trzích, je potřeba, aby byly nabídky na výchozím prodejním kanálu aktivní. Nelze mít nabídky na výchozím prodejním kanálu neaktivní a zároveň prodávat na jiném trhu. Pokud jste si tedy zaregistrovali svůj firemní účet na allegro.cz, máte český výchozí prodejní kanál. - Element – Základní prvek feedu nesoucí data (např. PRICE, PARAM atd.). - Vnořený element – Element je zanořený, pokud se v XML feedu nachází mezi počátečním a ukončovacím tagem jiného elementu. Nejčastějším příkladem jsou elementy PARAM_NAME a PARAM_VAL zanořené do elementu PARAM. - Hodnota elementu – Element nese data, která označujeme jako hodnotu daného elementu (např. hodnotou elementu `99` je 99). - Produkt – Data ve vstupním feedu jsou rozdělena na jednotlivé položky obsahující data o dané položce. Tuto položku nazýváme produktem. - Nabídka – Po nahrání produktového feedu do rozšíření Mergado Marketplaces se z produktů stanou nabídky na marketplace. Na marketplace existuje pro každý produkt jedna produktová karta, ke které se připojí nabídky různých prodejců. Nabídky se od sebe tedy liší cenou a nákupními podmínkami, ale základní údaje o výrobku na produktové kartě, jako je EAN kód, výrobce či značka, jsou identické. - Status nabídky – Rozšíření Mergado Marketplaces dostane od marketplace každých 15 minut statusy jednotlivých nabídek (např. aktivní, nekompletní, s chybou). - Katalog marketplace – Katalog produktů, ve kterém existuje pro každý unikátní produkt jedna produktová karta, ke které se mohou prodejci připojit se svými nabídkami. - Produktová karta – Karta v katalogu marketplace, která obsahuje všechny povinné a fixní parametry o výrobku. K produktové kartě se pak dle identifikátoru produktu napojí nabídka. - Synchronizace produktového feedu – Synchronizace všech dat mezi produktovým feedem a marketplace. Při automatickém přegenerování feedu v Mergado Editoru dojde k synchronizaci pouze změněných produktů. - Přegenerování – Přegenerování umožňuje aktualizovat data v projektu včetně výstupního feedu. Skládá se ze tří procesů: import, aplikace pravidel a export. - Validace – Sekce validace obsahuje chybové hlášky, které vysvětlují případné problémy, ke kterým došlo při nahrávání produktových dat na marketplace. - Prodejní dokumenty – Jedná se o podmínky pro vrácení, reklamační podmínky a ceník dopravy, které je nutné před zahájením prodeje na Allegru vyplnit v administraci Allegra. ## Co je potřeba pro spuštění Mergado Marketplaces * Ověřený firemní účet na vybraném marketplace (Allegro nebo Kaufland) * Aktivní účet v Mergado Editoru * Produktový feed v Mergado Editoru s EAN kódy (z databáze GS1) * [Dostupnostní feed](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed) ve formátu Heureka/Mall nebo [produktový feed ve formátu Mergado Marketplaces](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu) ## Hlavní funkce ### 1. Automatický listing a párování produktů Mergado Marketplaces umožňuje: * automaticky a v reálném čase nahrát tisíce položek na tržiště [Kauflandu](https://forum.mergado.cz/t/jak-vytvorit-kampan-a-nahrat-produkty-na-kaufland-marketplace/jak-vytvorit-kampan-a-nahrat-produkty-na-kaufland-marketplace) a [Allegra](https://forum.mergado.cz/t/jak-vytvorit-kampan-a-nahrat-produkty-na-allegro/jak-vytvorit-kampan-a-nahrat-produkty-na-allegro), * spárovat položky s existujícím katalogem tržiště, * [vytvořit zcela nové produktové karty](https://forum.mergado.cz/t/zakladani-produktovych-karet-pro-allegro-a-kaufland/zakladani-produktovych-karet-pro-allegro-a-kaufland) pro zboží, které v katalogu ještě není, * [doplnit povinné parametry](https://forum.mergado.cz/t/doplneni-produktovych-karet-allegra/doplneni-produktovych-karet-allegra) do již existujících nekompletních produktových karet Allegra. Rozšíření Mergado Marketplaces aktuálně umožňuje nahrání maximálně 200 tisíc produktů v rámci kampaně a maximálně 800 tisíc produktů v rámci rozšíření. V případě většího počtu produktů kontaktujte naši zákaznickou podporu na e-mailu mergado@mergado.cz. ### 2. Rychlá synchronizace skladových zásob Dostupnost produktů se aktualizuje každých 15 minut. Vyprodané položky se automaticky skryjí v nabídce a po naskladnění znovu aktivují, takže budete vždy prodávat pouze to, co máte opravdu skladem. Pro synchronizaci dostupnosti je nezbytné napojit do Mergado Marketplaces [dostupnostní feed](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed) ve formátu Heureka/Mall nebo [produktový feed ve formátu Mergado Marketplaces](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). ### 3. Pravidelná aktualizace produktových dat Veškerá produktová data se automaticky aktualizují po každém přegenerování feedu v Mergado Editoru. ### 4. Synchronizace objednávek s e-shopovým řešením V Mergado Marketplaces je možné aktivovat [synchronizaci objednávek](https://forum.mergado.cz/t/sprava-objednavek-v-mergado-marketplaces/sprava-objednavek-v-mergado-marketplaces). Objednávky z Allegra a Kauflandu se pak každých 5 minut automaticky přenášejí přímo do vašeho e-shopového řešení, což vám umožní spravovat objednávky z marketplace přímo ve vašem e-shopu. Aktuálně je možné objednávky napojit na e-shopové platformy [Shopify](https://forum.mergado.cz/t/vytvoreni-shopify-napojeni-pro-mergado-marketplaces/vytvoreni-shopify-napojeni-pro-mergado-marketplaces), [WooCommerce](https://forum.mergado.cz/t/napojeni-objednavek-do-woocommerce-s-mergado-marketplaces/napojeni-objednavek-do-woocommerce-s-mergado-marketplaces), [UNAS](https://forum.mergado.cz/t/napojeni-objednavek-do-unas-s-mergado-marketplaces/napojeni-objednavek-do-unas-s-mergado-marketplaces) a [Shoptet Premium](https://forum.mergado.cz/t/import-objednavek-do-shoptet-premium/import-objednavek-do-shoptet-premium). Napojení objednávek na e-shopové platformy vytvoříte vložením příslušného API klíče buď do rozšíření Mergado Keychain (Shopify, UNAS) nebo přímo do Mergado Marketplaces (WooCommerce, Shoptet Premium). ### 5. Export objednávek v CSV souboru nebo objednávkovém XML feedu Objednávky z tržišť můžete jednoduše převést do [účetního systému POHODA](https://forum.mergado.cz/t/import-objednavek-do-systemu-pohoda/import-objednavek-do-systemu-pohoda) pomocí připraveného objednávkového XML feedu nebo objednávky exportovat do CSV souboru a dál s nimi pracovat podle potřeby. ### 6. Dodržování nařízení GPSR Rozšíření Mergado Marketplaces usnadní [doplnění povinných údajů](https://forum.mergado.cz/t/gpsr-na-allegru-a-kauflandu/gpsr-na-allegru-a-kauflandu) o výrobci, odpovědné osobě nebo bezpečnostních pokynech. Díky tomu zůstávají nabídky viditelné a nehrozí, že je Allegro nebo Kaufland skryjí. ## Notifikace a validační hlášky Přímo v rozšíření Mergado Marketplaces je možné nastavit si, jaké [tipy notifikací chcete dostávat](https://forum.mergado.cz/t/mergado-marketplaces-nastaveni-notifikaci/mergado-marketplaces-nastaveni-notifikaci). V rozšíření se také zobrazují [validační hlášky](https://forum.mergado.cz/t/mergado-marketplaces-validacni-hlasky/mergado-marketplaces-validacni-hlasky), které upozorní na chyby nebo nesrovnalosti ve vložených datech. --- ## [Mergado Marketplaces formát feedu](https://help.mergado.com/cs/mergado-marketplaces/mergado-marketplaces-format-feedu/) # Mergado Marketplaces formát feedu ## Co je to Mergado Marketplaces formát feedu? Mergado Marketplaces formát feedu je založený na formátu Mergado XML. Slouží pro uživatele, kteří chtějí používat rozšíření Mergado Marketplaces, ale nejsou si jistí, jaký formát feedu je pro tento doplněk vhodný. Kromě usnadnění rozhodování při tvorbě projektu v Mergado Editoru přináší ale tento formát také výhody v podobě rychlejšího úvodního nastavení Mergado Marketplaces a možnosti synchronizace dostupnosti přes tento formát feedu. ## K čemu tento formát feedu slouží? Při používání aplikace Mergado Marketplaces jsou zapotřebí dva typy údajů: * Údaje o produktech * Údaje o dostupnosti > Dostupnostní feed má většina prodejců k dispozici přímo ze svého řešení. Nejste si jistí, kde ve svém eshopovém řešení tento feed s dostupností najít? V článku [zde](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed/1) se dozvíte, kde v Shoptetu, Upgates, Eshop-rychle, WooCommerce, FASTCentrik dostupnostní feed získat :bulb: Pokud nemáte dostupnostní feed k dispozici, nemusíte si dělat starosti. S Mergado Editorem tento problém snadno vyřešíte :white_check_mark: 1. První možností je, že si v Mergado Editoru vytvoříte nový projekt čistě s dostupností. Jako výstupní formát tedy zvolíte `Mall či Heureka dostupnostní feed` a ten pak využijete v Mergado Marketplaces. Podrobný návod naleznete [zde](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed). 2. Pokud ovšem máte dostupnost (počet kusů v číselném formátu) a údaje o produktech uvedeny v jednom feedu, můžete si vytvořit projekt v Mergado Editoru a jako výstupní formát zvolit `Mergado Marketplaces`. Díky tomu vám bude stačit pouze jeden feed pro synchronizaci jak produktových dat, tak pro synchronizaci dostupnosti. ## Výhody a nevýhody Mergado Marketplaces formátu feedu **Výhody:** - Stačí vám pouze jeden feed v Mergado Editoru, který bude obsahovat jak produktová, tak dostupnostní data. - Rychlejší tvorba kampaně v Mergado Marketplaces. Pro tento element se vám v našem průvodci vytvořením kampaně předvyplní elementy a nemusíte zadávat dostupnostní feed. **Nevýhody:** - I přes to, že doplněk Mergado Marketplaces bude synchronizovat dostupnost každých 15 minut, údaje ve vašem Mergado Marketplaces feedu se budou aktualizovat podle toho, jak často se bude přegenerovávat feed v Mergado Editoru. Pro nejaktuálnější dostupnost je tedy stále nejlepším řešením získání dostupnostního feedu přímo ze svého eshopového řešení. --- ## [Dostupnostní feed](https://help.mergado.com/cs/mergado-marketplaces/dostupnostni-feed/) # Dostupnostní feed # **Co je to dostupnostní feed?** Dostupnostní feed je soubor, který obsahuje aktuální informace o skladových zásobách a dostupnosti produktů v e-shopu. ## **Jak má správný dostupnostní feed vypadat** Správný dostupnostní feed by měl obsahovat tyto klíčové informace: - Identifikátor produktu - Počet kusů na skladě > Formát se může lišit v závislosti na platformě, pro kterou je feed určen (např. Heureka vs. Mall). ## **Heureka dostupnostní feed** Heureka dostupnostní feed by měl mít následující strukturu: ```xml 13 2011-09-11 13:00 2 2011-09-11 18:00 ``` ## **Mall dostupnostní feed** Mall dostupnostní feed má podobnou strukturu: ```xml 1 5 true ``` Klíčové elementy jsou: - **`item id/ID`**: Tento element reprezentuje jednotlivý produkt v dostupnostním feedu, přičemž atribut **`id`** slouží jako jedinečný identifikátor produktu, který se MUSÍ PŘESNĚ SHODOVAT s ID produktu v produktovém feedu, jinak nebude možné dostupnost správně napárovat. - **`stock_quantity/IN_STOCK`**: Tento element obsahuje číselný údaj o aktuálním počtu kusů daného produktu na skladě. # **Jak získat dostupnostní feed** 1. Zkontrolujte, zda váš e-shopový systém automaticky generuje dostupnostní feed. 2. Pokud ne, můžete ho vytvořit manuálně pomocí nástrojů jako Mergado Editor. > Nově můžete také využít `Mergado Marketplaces` formát feedu, který lze využít jako produktový i dostupnostní feed. Díky tomu tedy nemusíte mít v Mergado Editoru dva separátní feedy, stačí pouze jeden :bulb: Více informací naleznete [zde](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). ## **Kde najít dostupnostní feed ve vašem e-shopu** ## **Shoptet** 1. V administraci Shoptetu přejděte do sekce Propojení → Heureka. 2. Vyberte možnost "XML feedy". 4. Vyhledejte sekci "Dostupnostní XML feed" 5. Zkopírujte vygenerovanou URL adresu feedu. 6. Tuto URL můžete použít jako dostupnostní feed v Mergado Marketplaces nebo jiných službách. :information_source: **Více informací můžete najít na stránkách Shoptetu [zde](https://podpora.shoptet.cz/heureka-xml-feedy/).** ## **UPgates** - Abyste měli přístup k Heureka dostupnostnímu feedu, je zapotřebí **aktivovat** doplněk **Heureka** (doplněk je zdarma). - Ve svém e-shopu otevřete sekci "**Doplňky**" a vyhledejte "**Heureka**". - U doplňku Heureka klikněte na "**Aktivovat**". - Přejděte do sekce "**Doplňky > Heureka**". - V této sekci najdete oddíl "**Dostupnostní feed**". - Zde naleznete vygenerovanou URL adresu vašeho dostupnostního feedu. - Zkopírujte tuto URL adresu. - Tuto URL můžete použít jako dostupnostní feed v Mergado Marketplaces nebo jiných službách. :information_source: **Více informací můžete najít na stránkách UPgates [zde](https://www.upgates.cz/a/export-produktu-na-heureku).** >⚠️ Na prvním screenshotu můžete vidět testovací e-shop. Export dostupnosti na vašem skutečném e-shopu bude nabízet URL adresu. ## **Eshop-rychle** - Dostupnostní feed se generuje automaticky a najdete ho v E-shop → Export → Export produktů. - Vyberte si v sekci "**Portál**" možnost "**heureka.cz dostupnost**". - Vygenerujte feed. - Zkopírujte vygenerovanou URL adresu feedu. - Tuto URL můžete použít jako dostupnostní feed v Mergado Marketplaces nebo jiných službách. :information_source: **Více informací můžete najít na stránkách Eshop-rychle [zde](https://helpdesk.eshop-rychle.cz/docs/export-import/export-do-porovnavacu-zbozi/).** ## **WooCommerce** - I když WooCommerce nenabízí přímo vytváření dostupnostních feedů pro Heureku nebo Mall, pluginy jako [Toret](https://toret.cz/produkt/xml-feedy-pro-porovnavace-zbozi/ref/68/) nebo [WPify Woo Feedy](https://wpify.io/dokumentace/wpify-woo-feedy/#kontakt) vám s tím dokážou pomoci. ## **FASTCentrik** Dostupnostní feed si můžete snadno vygenerovat v sekci "XML feedy". ## **Zabezpečení dostupnostního feedu** >⚠️ Při generování feedu z vašeho e-shopu si dejte pozor na nastavení přístupu. Některé e-shopy mohou feedy automaticky uzamknout, proto je důležité zkontrolovat a nastavit je jako veřejně přístupné. Pokud v aplikaci Mergado Marketplaces narazíte na chybovou hlášku “*Nastala chyba při stahování dostupnostního feedu, ujistěte se, že je soubor dostupný*”, je pravděpodobné, že máte dostupnostní feed zabezpečený a aplikace tak k němu nemá přístup. Pokud máte svůj e-shop na Shoptetu, tak **[zde ](https://www.mergado.cz/zabezpeceni-shoptet-feedu)** naleznete návod, jak v Shoptet administraci upravit zabezpečení vašeho dostupnostního feedu tak, aby k němu měla aplikace přístup. # Jak si vytvořit dostupnostní feed v Mergado Editoru Pokud vaše e-shopové řešení nenabízí dostupnostní feed, tak máte dvě možnosti, jak tuto situaci vyřešit pomocí Mergado Editoru: * Pokud máte ve svém produktovém feedu obsaženou dostupnost v číselném formátu, tak při vytváření projektu v Mergado Editoru zvolte jako výstupní formát `Mergado Marketplaces`. Díky tomu budete moci tento feed použít v doplňku Mergado Marketplaces nejen pro synchronizaci produktových dat, ale i pro synchronizaci dostupnosti. Více informací naleznete [zde](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). * Pokud nemáte ve svém produktovém feedu obsaženou dostupnost, můžete si dostupnostní feed v Mall či Heureka formátu vytvořit jako separátní projekt a na vstupu zvolit vstupní feed s dostupností (postačí i Google Sheets tabulka). 1. Připravte svůj feed, který musí obsahovat identifikátor produktu a počet kusů na skladě. > ⚠️ Identifikátor produktu se MUSÍ PŘESNĚ SHODOVAT s ID produktu ve vašem existujícím produktovém feedu, jinak nebude možné dostupnost správně napárovat. 2. Přihlaste se do Mergado Editoru a klikněte na "Nový projekt". 3. Zadejte URL vašeho vstupního feedu. Mergado Editor podporuje tyto formáty: XML, JSON, CSV nebo Google Sheets. 4. Počkejte na dokončení počáteční analýzy feedu a zvolte e-shop. 5. Po analýze feedu Editor předvybere správný formát vašeho feedu podle jeho obsahu. Není ale nutné se na předvyplněný formát vázat. 7. Pokud Mergado nedokázalo rozpoznat formát vstupního feedu, můžete si definovat vlastní formát. Pokud víte, o jaký formát se jedná, vyberte si jej z nabídky vstupních formátů. 8. Na stránce výstupního formátu vyberte buď Heureka dostupnostní nebo MALL marketplace dostupnostní feed. 9. V rekapitulaci si můžete zkontrolovat všechny údaje, které jste vyplnili. 10. Pokud byste viděli hlášku "Chyba v párovacích elementech", klikněte na tlačítko "Upravit" (vpravo) a přidejte ID produktu jako párovací element . 11. Klikněte na tlačítko "Dokončit". # Jak správně použít dostupnostní feed v Mergado Marketplaces 1. V Mergado Marketplaces vytvořte novou kampaň. 2. Při nastavování kampaně se dostanete na krok přidání dostupnostního feedu. 3. Zadejte URL adresu vašeho dostupnostního feedu. Dostupnostní feed musí splňovat následující podmínky pro úspěšné spárování s produkty z produktového feedu: * Daná URL adresa musí být Heureka nebo Mall dostupnostní feed, případně feed v Mergado Marketplaces formátu. * Dostupnostní feed musí obsahovat stejná ID produktů jako v produktovém feedu. * Dostupnostní feed musí být pro aplikaci přístupný. 4. Svůj dostupnostní feed získáte buď ze svého e-shopu (jak je uvedeno v příkladech výše) nebo pomocí Mergado Editoru. V Mergado Editoru můžete najít svůj dostupnostní feed v sekci "Přehled", kde najdete možnost "Zkopírovat url adresu do schránky". 5. Zadejte tuto URL do textového pole: 5. Pokud použijete jakoukoliv jinou URL adresu než XML formát, nebo URL adresa nebude kompletní (v příkladu na obrázku chybí přípona XML), uvidíte chybovou hlášku "Neplatná URL" či "Nastala chyba" a vytváření kampaně vám zabrání pokračovat dále. V tomto případě se ujistěte, že URL adresa je celá, je v XML formátu a jedná se o Heureka nebo Mall dostupnostní feed, případně Mergado Marketplaces formát feedu. 6. Pokud se některá ID produktů nebudou shodovat nebo budou v dostupnostním feedu chybět, při kliknutí na "Další krok" obdržíte notifikaci o počtu chybějících ID produktů. Toto upozornění vám však nezabrání pokračovat ve vytváření kampaně a všechny ostatní produkty budou spárovány správně. Pokud se jedná pouze o několik produktů, je pravděpodobné, že jde o vyprodané zboží a nejedná se o chybu. Pokud byste v upozornění viděli, že počet chybějících produktů je roven celkovému počtu produktů ve vašem produktovém feedu, znamená to, že dostupnostní feed neobsahuje ani jedno správné ID a žádný produkt nebude nahrán na marketplace. Zkontrolujte, zda nahráváte správný dostupnostní feed a zda obsahuje správná ID produktů jako v produktovém feedu. 7. Pokud je dostupnostní feed správný, dokončete vytváření kampaně. Po úspěšném vytvoření kampaně a její synchronizaci uvidíte, které produkty se správně nahrály. 8. Všechny produkty, které nebyly nahrány z důvodu problému v dostupnostním feedu, můžete najít v detailu kampaně → Validace, kde uvidíte seznam s názvem "U nabídky chybí dostupnost, zkontrolujte, zda má dostupnostní feed správný formát a zda se 'ID produktu' v produktovém a dostupnostním feedu shoduje". > Pokud se jedná pouze o několik produktů, je pravděpodobné, že jde o vyprodané produkty a nejedná se o chybu. Při nejbližším naskladnění se daná nabídka aktivuje (za předpokladu, že pro daný produkt existuje na tržišti produktová karta). --- ## [Správa objednávek v Mergado Marketplaces](https://help.mergado.com/cs/mergado-marketplaces/sprava-objednavek-v-mergado-marketplaces/) # Správa objednávek v Mergado Marketplaces V Mergado Marketplaces si můžete nově aktivovat stahování objednávek, díky čemuž budete mít objednávky ze všech marketplaces na jednom místě :tada: Objednávky si můžete dále napojit na: * [Shopify](https://forum.mergado.cz/t/vytvoreni-shopify-napojeni-pro-mergado-marketplaces/vytvoreni-shopify-napojeni-pro-mergado-marketplaces) * [UNAS](https://forum.mergado.cz/t/napojeni-objednavek-do-unas-s-mergado-marketplaces/napojeni-objednavek-do-unas-s-mergado-marketplaces) * [Účetní systém POHODA](https://forum.mergado.cz/t/import-objednavek-do-systemu-pohoda/import-objednavek-do-systemu-pohoda) * [WooCommerce](https://forum.mergado.cz/t/napojeni-objednavek-do-woocommerce-s-mergado-marketplaces/napojeni-objednavek-do-woocommerce-s-mergado-marketplaces) * [Shoptet Premium](https://forum.mergado.cz/t/import-objednavek-do-shoptet-premium/import-objednavek-do-shoptet-premium) > V případě, že byste narazili na chyby nebo máte nápady, jak tuto funkcionalitu dále rozšířit, neváhejte se na nás obrátit na naší e-mailové adrese [mergado@mergado.cz](mailto:mergado@mergado.cz). ## Aktivace Pro spuštění stahování objednávek je nejprve potřeba si tuto funkci aktivovat v sekci "Aktivace". Zde zvolíte požadované platformy a změny uložíte: > :warning: **Pro aktivaci objednávek je nutné mít aktivní napojení na požadovanou platformu v sekci 'Napojení'.** ## Historie V sekci historie naleznete informace o aktivaci a deaktivaci objednávek a o průběhu jejich synchronizace: Zároveň v dodatečných datech naleznete informace o počtu nových objednávek, o změně statusu či dat objednávky: ## Přehled objednávek Na přehledu objednávek zjistíte ty nejdůležitější informace o vašich objednávkách: * Logo tržiště * Trh nákupu * ID objednávky + proklik na detail objednávky na daném tržišti pomocí ikonky * Datum vytvoření objednávky * Jméno zákazníka * Položky objednávky * Celková cena objednávky * Fulfillment * FBM (Fulfillment by Merchant) * FBK (Fulfillment by Kaufland) * One Fulfillment by Allegro * Status objednávky (otevřeno, neodesláno, odesláno, pozastaveno, vráceno, zrušeno, neznámá) * Stav synchronizace > Objednávky synchronizujeme každých 5 minut. Po kliknutí na danou objednávku se vám otevře detail objednávky: > Pokud jste si na Allegru či Kauflandu vložili k objednávce interní poznámku, tak tato poznámka se zobrazí i u nás v aplikaci. Jakmile ale přes aplikaci Mergado Marketplaces k objednávce vložíte poznámku nebo poznámku upravíte, tak se interní poznámka přestane synchronizovat s tržištěm. ## Notifikace V sekci notifikací si můžete nastavit upozornění na nové objednávky. Zde si můžete nastavit, v jaké dny a hodiny si přejete upozornění dostávat a také si zvolíte, zda chcete být informováni přes Mergado zprávy či e-mailem: E-mailová notifikace vás kliknutím na ID objednávky přesměruje přímo na detail objednávky na Allegru/Kauflandu, případně si můžete nové objednávky zobrazit v Mergado Marketplaces: ## Export objednávek Při exportu objednávek si můžete zvolit, jaké objednávky chcete do CSV zahrnout: Zároveň si můžete zvolit, jaké údaje chcete mít v CSV obsažené a případně si také zvolit vlastní názvy sloupců: --- ## [Mergado Marketplaces nastavení notifikací](https://help.mergado.com/cs/mergado-marketplaces/mergado-marketplaces-nastaveni-notifikaci/) # Mergado Marketplaces nastavení notifikací **Jak si nastavit notifikace v aplikaci Mergado Marketplaces? Pojďme si to ukázat krok za krokem.** Notifikace si můžete nastavit v hlavním menu aplikace v sekci “Notifikace”. Zde si můžete aktivovat upozornění na vybrané problémy prostřednictvím e-mailu a Mergado zpráv. Díky nastavení notifikací se můžete sami rozhodnout, o jakých problémech a kampaních chcete být informováni. > :information_source: **Zasílání notifikací je možné v této sekci také kdykoli deaktivovat.** Po rozkliknutí sekce nastavení notifikací si můžete povšimnout 3 hlavních sekcí: * Obecné nastavení * Upozornění na chyby * Správa objednávek ## 1. Obecné nastavení Je na vás, jakým způsobem chcete být o případných problémech informováni. Pokud si zvolíte Mergado zprávy, budou se vám notifikace zobrazovat v pravém horním rohu Mergada: Pokud si přejete dostávat notifikace e-mailovou cestou, stačí si tuto možnost aktivovat a doplnit do kolonky e-mailovou adresu, na kterou chcete e-maily zasílat. Pomocí tlačítka “Přidat e-mail” můžete přidávat více políček pro zadání e-mailové adresy. Samotný e-mail s upozorněním pak může vypadat třeba takto: ## 2. Upozornění na chyby Důležité také je si zvolit, o jakých problémech byste chtěli být informováni. Nyní máte na výběr ze dvou možností: * **Chyby napojení** - v případě, že by došlo k problému s napojením na Kaufland či Allegro, budete o tom informováni zvoleným komunikačním kanálem. * **Chyby v synchronizaci objednávek** * **Chyby dostupnostního feedu** - může se stát, že váš dostupnostní feed je z nějakého důvodu nedostupný a nedochází tak k aktualizaci dostupnosti na marketplace. * **Neúspěšná synchronizace feedu** - upozornění na chybu při synchronizaci produktového feedu. * **Drop aktivních nabídek** - upozornění na výrazný propad aktivních nabídek u kterékoliv kampaně. V případě upozornění na chybu dostupnostního feedu se vám zobrazí okno s přehledem vašich kampaní a vy si tak můžete vybrat, u kterých kampaní chcete být na problém s dostupnostním feedem upozorněni. ## 3. Správa objednávek V sekci notifikací si můžete nastavit také upozornění na nové objednávky. Můžete si sami nastavit, v jaké dny a hodiny si přejete upozornění dostávat a také si zvolíte, zda chcete být informováni přes Mergado zprávy či e-mailem: E-mailová notifikace vás kliknutím na ID objednávky přesměruje přímo na detail objednávky na Allegru/Kauflandu, případně si můžete nové objednávky zobrazit v Mergado Marketplaces: > A na závěr nezapomeňte provedené změny uložit kliknutím na modré tlačítko “Uložit změny” v pravém horním rohu :bulb: --- ## [Mergado Marketplaces validační hlášky](https://help.mergado.com/cs/mergado-marketplaces/mergado-marketplaces-validacni-hlasky/) # Mergado Marketplaces validační hlášky V tomto článku naleznete vysvětlení těch nejčastějších validačních hlášek: #### V Allegro katalogu nebyla pod tímto identifikátorem produktu nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty'` * Tyto produkty se ještě nenachází v produktovém katalogu Allegra a je tedy nutné pro ně založit produktovou kartu v sekci "Produktové karty". Podrobný návod naleznete [zde](https://forum.mergado.cz/t/zakladani-produktovych-karet-pro-allegro/zakladani-produktovych-karet-pro-allegro-a-kaufland). #### V Kaufland katalogu nebyla pod tímto EAN kódem nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty' * Tyto produkty se ještě nenachází v produktovém katalogu Kauflandu a je tedy nutné pro ně založit produktovou kartu v sekci "Produktové karty". Podrobný návod naleznete [zde](https://forum.mergado.cz/t/zakladani-produktovych-karet-pro-allegro/zakladani-produktovych-karet-pro-allegro-a-kaufland). #### 'Údaje výrobců' jménem '...' neexistuje * Na Allegru nemáte připravenou kartu výrobce s tímto 'vlastním názvem'. Karty výrobců a jejich vlastní názvy si můžete zkontrolovat [zde](https://salescenter.allegro.com/responsible-producers). Vlastní název se musí zcela shodovat, aby se karta mohla k nabídce napárovat. #### Pro parametr "Značka" byla zadána nesprávná hodnota "..." / Pro parametr "Výrobce" byla zadána nesprávná hodnota "..." * Allegro před nedávnem udělalo změnu, kdy u parametru značka/výrobce už není možné používat hodnotu "ostatní" a zadat svou vlastní značku/výrobce, pokud není v seznamu povolených hodnot. Nově je tedy potřeba na Allegru zažádat o přidání nové hodnoty do seznamu povolených značek/výrobců a až po schválení se strany Allegra půjde produktová karta zalistovat. Zažádat o přidání nové hodnoty můžete [zde](https://salescenter.allegro.com/parameter-value-suggestions/create-suggestion). > Povolené hodnoty pro parametr značka/výrobce se liší pro různé kategorie. Pokud chcete zalistovat produkty dané značky/výrobce ve více kategoriích, je potřeba vyplnit formulář na straně Allegra pro všechny požadované kategorie. #### Kvůli chybějícímu potvrzení podmínek ochrany značky nemůžete uvádět nabídky s produkty chráněných značek * Na Allegru musíte nejprve potvrdit podmínky ochrany značek [zde](https://salescenter.allegro.com/brands-to-protect?bi-s=art). Více se dozvíte v [tomto článku](https://help.allegro.com/cs/sell/a/jak-se-starame-o-ochranu-znacek-na-allegru-q08bykna8fE) od Allegra. #### Nabídka nebyla nalezena, pravděpodobně došlo k jejímu smazání z Vašeho sortimentu na Allegru * Jedná se o situaci, kdy uživatel buď nabídku z Allegra smazal sám a nebo byla nabídka více než 60 dnů na Allegru jako ukončená (ale celou tu dobu byla nabídka v kampani v Mergado Marketplaces). Jakmile je nabídka více než 60 dnů ukončená, tak ji Allegro samo archivuje a v naší aplikaci máme pořád uložené staré Allegro ID nabídky a snažíme se k ní napojit. * :bulb: Tento proces jsme již vylepšili a jakmile tuto hlášku od Allegra obdržíme, tak se dá k nabídce štítek "nesynchronizováno" a při dalším přegenerování vytvoříme na Allegru novou nabídku. * Pokud v Mergado Marketplaces tuto hlášku stále máte, stačí provést v nastavení kampaně manuální synchronizaci produktového feedu a poté vyčkat do další automatické synchronizace feedu. #### U nabídky chybí dostupnost, zkontrolujte, zda má dostupnostní feed správný formát a zda se 'ID produktu' v produktovém a dostupnostním feedu shoduje * V případě této hlášky je možné, že se pod daným ID produktu v dostupnostním feedu nenachází žádná hodnota, případně v dostupnostního feedu produkt zcela chybí. Pokud se vám tato hláška zobrazila u všech produktů, **zkontrolujte formát dostupnostního feedu ([Heureka](https://sluzby.heureka.cz/napoveda/dostupnostni-feed/) a [Mall](https://knowledgebase.mallgroup.com/marketplace-mall-xml-feed/3/)) a zda se 'ID produktu' v produktovém a dostupnostního feedu shoduje**. Při řešení postupujte následovně: 1. Přejděte do sekce validace a klikněte na tuto validační hlášku. 2. Zobrazí se nabídky, u kterých chybí dostupnost. Zkopírujte si 'ID produktu' některého z produktů. 3. Přejděte do nastavení kampaně a dole si zkopírujte link dostupnostního feedu a ten si otevřete. 4. Pomocí CTRL + F vyhledejte zkopírované 'ID produktu' a zkontrolujte, zda se dostupnost ve feedu nachází či nikoli. 5. Zkontrolujte, jestli jste v nastavení kampaně k 'ID produktu' napárovali správný element z vašeho produktového feedu. Pokud potřebujete napárování změnit, tak stačí v nastavení kampaně rozkliknout sekci elementy, změnit napárování, změn uložit a kliknout na "Synchronizovat produktový feed". 6. Pokud se dostupnost pro daný produkt v dostupnostním feedu nenachází, tak zkontrolujte, zda se například nejedná o vyprodané produkty. Takové produkty stejně nechcete na marketplace vystavit a tato chybová hláška tedy ničemu nevadí. #### Na Allegro produktové kartě chybí povinné parametry, přidejte je přes 'Doplnění produktových karet' v sekci 'Produktové karty' * Na produktové kartě Allegra chybí povinné parametry. Tato hláška se netýká vašich dat, ale dat toho uživatel, který na Allegru produktovou kartu založil a my k ní nyní chceme napojit vaši produktovou nabídku. Tyto parametry můžete doplnit v sekci produktových karet v části "Doplnění produktových karet". Více informací naleznete [zde](https://forum.mergado.cz/t/doplneni-produktovych-karet-allegra/doplneni-produktovych-karet-allegra). #### Allegru se nepodařilo najít přesně odpovídající produkt * S touto chybovou hláškou, která se zobrazuje v případě, že se v produktovém katalogu Allegra nachází více produktových karet se stejným identifikátorem, byste se již měli setkávat jen ve výjimečných případech. Naše aplikace zhodnotí stav produktových karet na Allegru a přiřadí nabídku k té nejlépe vyplněné. Pokud ovšem není žádná z produktových karet validní, tak se nabídka k žádné nepřiřadí a zobrazí se ve validaci tato hláška. #### Došlo k chybě na straně Allegra: produktová karta v Allegru neobsahuje žádný obrázek, proto nedošlo ke spárování nabídky s produktovou kartou * Naše aplikace nyní posílá na Allegro produktové obrázky, ale posílá je pouze jako obrázky nabídky. Pokud tedy není na Allegru produktová karta v pořádku a chybí v ní nějaké parametry či obrázky, přes naši aplikaci není možné tyto údaje do produktové karty doplnit. Obrázky ale můžete zkusit doplnit manuálně přímo ve vystavovacím formuláři Allegra. Stačí na Allegru přejít do sekce “Vystavit pomocí formuláře”, zadat do vyhledávání EAN daného produktu, zvolit nalezenou produktovou kartu a kliknout na možnost “NAHLÁSIT CHYBNÉ INFORMACE O PRODUKTU”. Následně můžete chybějící obrázky doplnit a návrh Allegru odeslat. #### Parametr [shipping_group] není uveden nebo má chybnou hodnotu * Jedná se o chybovou hlášku, která vás informuje o tom, že nemáte správně vyplněné přepravní skupiny v Seller Portalu Kauflandu. Přejděte tedy v Seller Portalu do sekce 'Nastavení' > '[Nastavení dopravy](https://sellerportal.kaufland.de/shipping-groups)' a zkontrolujte / přidejte přepravní skupinu. Aplikace automaticky přiřadí k nabídkám vaši výchozí přepravní skupinu. > :information_source: **Pokud vaše validační hláška nebyla v seznamu obsažena nebo si stále s něčím nevíte rady, neváhejte se na nás obrátit.** --- ## [Jak vytvořit kampaň a nahrát produkty na Allegro](https://help.mergado.com/cs/mergado-marketplaces/jak-vytvorit-kampan-a-nahrat-produkty-na-allegro/) # Jak vytvořit kampaň a nahrát produkty na Allegro [](https://allegro.cz/kampan/zacnete-prodavat/partners?affiliation=mergado-cz&affiliation_source=mergado-cz) > V první řadě je nutné si aktivovat aplikaci [Mergado Marketplaces v **Mergado Store**](https://store.mergado.com/detail/ordelogyproducts/#about). Než začnete, ujistěte se, že máte připravený: :white_check_mark: Ověřený firemní účet na Allegru :white_check_mark: Produktový feed v Mergado Editoru s EAN kódy :white_check_mark: Heureka/Mall dostupnostní feed/Mergado Marketplaces produktový feed > :bulb: Nevíte jaký formát výstupního feedu je nejvhodnější? Doplněk Mergado Marketplaces přijímá veškeré formáty, které nabízí Mergado Editor. Novinkou je ale **Mergado Marketplaces formát feedu**, který můžete využít k synchronizaci jak produktových dat, tak dostupnosti. Více informací [zde](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). V tomto příspěvku si ukážeme, jak vytvořit kampaň a nahrát produkty na Allegro. Než začneme, ujistěte se, že máte na Allegru vytvořený a **ověřený firemní účet**, a že máte **vyplněný ceník dopravy, reklamační podmínky a podmínky pro vrácení zboží**. Podrobný postup registrace firemního účtu na Allegru naleznete [zde](https://help.allegro.com/sell/cs/c/registrace-uctu-allegro#q0aPBB8B0Cj). :warning: **Vezměte prosím na vědomí, že trh, na kterém si založíte účet, bude vaším výchozím prodejním kanálem.** Výchozí prodejní kanál pak již nelze změnit a na tomto trhu musíte mít své nabídky vždy vystavené. Pokud tedy chcete prodávat na allegro.cz, založte si účet na českém Allegru, pokud chcete prodávat na allegro.pl, založte si účet na polském Allegru a pro prodej na allegro.sk si založte účet na slovenském Allegru. V rámci Allegra pak můžete tyto nabídky zveřejnit i na dalších trzích, více informací se dozvíte [zde](https://help.allegro.com/sell/cs/c/sdileni-nabidek-na-zahranicnich-trzich). ## Tvorba napojení Jako první je třeba vytvořit si nové napojení do Allegra v aplikaci. Přejděte do sekce napojení a následně klikněte na logo Allegra. Klikněte na tlačítko "Připojit". Po kliknutí na tlačítko "Připojit" se vám otevře nová stránka v prohlížeči, klikněte na tlačítko "Next" / "Dalej": Pokud nejste přihlášeni, tak zadejte přihlašovací údaje a přihlaste se: Potvrďte napojení aplikace pro daný účet kliknutím na "Continue": Allegro vám na poslední stránce oznámí, že jste se úspěšně napojili: Poté se vraťte do aplikace, kde uvidíte hlášku o úspěšném napojení: ## Vytvoření kampaně Po tvorbě napojení přejděte v menu do záložky "Kampaně", kde uprostřed stránky uvidíte tlačítko "Vytvořit kampaň". Přivítá vás náš průvodce pro tvorbu kampaně s 5 kroky. ### 1. Obecné Prvním krokem je určení názvu kampaně. Název může být libovolný, doporučujeme však takový, abyste na první pohled zjistili, o co se v kampani jedná. ### 2. Marketplace Dalším krokem je zvolení a nastavení správného marketplace, v našem případě se jedná o Allegro. Informační okno vás upozorní na to, jaký je váš výchozí prodejní kanál na Allegru, na kterém budete prodávat. Na tomto trhu budou nabídky vystaveny, proto je nutné napárovat cenu v měně výchozího prodejního kanálu. Nyní je nutné vybrat pro kampaň **[ceník dopravy](https://salescenter.allegro.com/delivery-settings), [reklamační podmínky](https://salescenter.allegro.com/complaints-terms) a [podmínky pro vrácení](https://salescenter.allegro.com/returns-terms)**. Volitelně můžete připojit i [záruční informace](https://salescenter.allegro.com/warranty-information). Tyto prodejní dokumenty můžete vytvořit přímo v administraci Allegra v sekci nastavení prodeje. ### 3. Mergado V následujícím kroku je nutné vybrat, ze kterého Mergado projektu a výběru chcete produkty na marketplace nahrát. > Ještě nemáte žádný projekt na výběr? Podívejte se, jak nahrát produktový feed do Mergado Editoru [zde](https://forum.mergado.cz/t/novy-projekt/2733). >:information_source: Pokud nechcete na marketplaces zasílat všechny produkty z daného projektu, **vytvořte si v Mergado Editoru výběr produktů, které chcete na marketplace zalistovat**. Následně se otevře část pro namapování elementů z vybraného projektu v Mergado Editoru na elementy v aplikaci Marketplaces. Povinně je nutné namapovat elementy **'EAN', 'ID produktu', 'Cena s DPH' a 'Stav zboží'**. V tomto kroku také můžete zvolit **'Stav zboží'** a **'Čas odbavení objednávky'** jednotně pro celou kampaň (například pokud prodáváte pouze nové produkty). Druhou možností je napárovat tyto hodnoty na vaše elementy z feedu. > :warning: **Nařízení GPSR** V závěru sekce Mergado je třeba vyplnit informace spojené s nařízením GPSR. Více informací naleznete [zde](https://forum.mergado.cz/t/gpsr-na-allegru-a-kauflandu/gpsr-na-allegru-a-kauflandu). ### 4. Dostupnostní feed Předposledním krokem je nastavení dostupnostního feedu. Zde stačí uvést adresu vašeho dostupnostního feedu. Podporujeme Mall a [Heureka dostupnostní feed ](https://forum.mergado.cz/t/dostupnostni-feed-heureka/2427), případně [Mergado Marketplaces formát feedu](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). Aplikace zkontroluje vložený dostupnostní feed. Pokud dostanete informaci, že chybí všechny produkty, pravděpodobně jste vložili jiný dostupnostní feed, nebo jste špatně namapovali ID produktu v kroku **Mergado.** :bulb: **Pokud nemáte k dipozici dostupnostní feed v Mall či Heureka formátu, je možné si jej vytvořit pomocí Mergado Editoru. Více informací naleznete v našem článku [zde](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed).** > :information_source: Pokud narazíte na chybovou hlášku “Nastala chyba při stahování dostupnostního feedu, ujistěte se, že je soubor dostupný”, je pravděpodobné, že máte dostupnostní feed zabezpečený a aplikace tak k němu nemá přístup. Pokud máte svůj e-shop na Shoptetu, tak **[zde](https://www.mergado.cz/zabezpeceni-shoptet-feedu)** naleznete návod, jak v Shoptet administraci upravit zabezpečení vašeho dostupnostního feedu tak, aby k němu měla aplikace přístup. ### 5. Dokončení Poslední krok je shrnutím nastavení kampaně. Zde si pouze zkontrolujte, že jste vše nastavili správně, případně údaje opravte. Na závěr klikněte na "Uložit". :white_check_mark: **Kampaň byla vytvořena a vaše nabídky se nyní nahrávají na Allegro.** Tento proces může chvíli trvat, tak vás prosíme o trpělivost. Tímto ale proces nahrávání nabídek na Allegro nekončí. Je dobré zkontrolovat počet nahraných a nenahraných produktů a případné chyby opravit. > **Po dokončení synchronizace produktového feedu si rozklikněte detail kampaně a v sekci validace zkontrolujte případné chybové hlášky.** Vysvětlení těch nejčastějších validačních hlášek naleznete [zde](https://forum.mergado.cz/t/mergado-marketplaces-validacni-hlasky/mergado-marketplaces-validacni-hlasky). :question: Máte ve validaci chybovou hlášku “**V Allegro katalogu nebyla pod tímto identifikátorem produktu nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty'**"? Tato hláška znamená, že pro dané produkty ještě v katalogu Allegra neexistuje produktová karta. Podrobný návod, jak produktovou kartu založit přes naši aplikaci, naleznete [zde](https://forum.mergado.cz/t/zakladani-produktovych-karet-pro-allegro/zakladani-produktovych-karet-pro-allegro-a-kaufland). --- ## [Jak vytvořit kampaň a nahrát produkty na Kaufland marketplace](https://help.mergado.com/cs/mergado-marketplaces/jak-vytvorit-kampan-a-nahrat-produkty-na-kaufland-marketplace/) # Jak vytvořit kampaň a nahrát produkty na Kaufland marketplace > V první řadě je nutné si aktivovat aplikaci [Mergado Marketplaces v Mergado Store](https://store.mergado.com/detail/ordelogyproducts/#about). Než začnete, ujistěte se, že máte připravený: :white_check_mark: Ověřený firemní účet na Kauflandu :white_check_mark: Produktový feed v Mergado Editoru s EAN kódy :white_check_mark: Heureka/Mall dostupnostní feed/Mergado Marketplaces feed > :bulb: Nevíte jaký formát výstupního feedu je nejvhodnější? Doplněk Mergado Marketplaces přijímá veškeré formáty, které nabízí Mergado Editor. Novinkou je ale **Mergado Marketplaces formát feedu** , který můžete využít k synchronizaci jak produktových dat, tak dostupnosti. Více informací [zde](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). V tomto návodu si ukážeme, **jak vytvořit kampaň a nahrát produkty na Kaufland Global Marketplace**. Nejprve je nutné založit a správně nastavit svůj účet na Kaufland Global Marketplace. Detailní informace o registraci na Kaufland marketplace naleznete zde: https://www.kaufland.de/i/seller-university/cz/registration/. ## Vytvoření napojení V aplikaci Marketplaces je nejprve nutné přejít na kartu „Napojení“ a následně kliknout na logo Kauflandu: Na kartě detailu napojení je nutné vložit **API klíče**, které naleznete ve své administraci přímo na stránkách Kaufland marketplace. Zde přejdeme do „Nastavení“ → „Nastavení obchodu“ → „API“. Nahoře jsou uvedeny vaše API klíče („Client Key“ a „Secret Key“). Pokud zde zatím žádné nejsou, jednoduše si vygenerujte nové. **Klíče si po vygenerování bezpečně uložte, uvidíte je pouze po jejich vygenerování – poté už nebude možné je znovu zobrazit.** Tyto klíče následně vložte do aplikace Mergado Marketplaces a pokračujte tlačítkem připojit – napojení by nyní mělo být aktivní. > :information_source: Pokud v Kaufland administraci dáte znovu vygenerovat klíče a získáte nové, tak ty původní ztratí svoji platnost. Pokud tedy budete mít v aplikaci Marketplaces uložené staré klíče a vygenerujete v Kaufland administraci nové, **napojení přestane být funkční**. ## Vytvoření kampaně Po tvorbě napojení přejděte v menu do záložky "Kampaně", kde uprostřed stránky uvidíte tlačítko "Vytvořit kampaň". Přivítá vás náš průvodce pro tvorbu kampaně s 5 kroky. ### 1. Obecné Prvním krokem je určení názvu kampaně. Název může být libovolný, doporučujeme však takový, abyste na první pohled zjistili, o co se v kampani jedná. ### 2. Marketplace V dalším kroku je nutné zvolit, na který marketplace chcete nabídky nahrát. Vybereme tedy „Kaufland“. Následně se otevře pole pro výběr **prodejního kanálu** (země, ve které se budou nabídky prodávat) a **přepravní skupiny**, kterou nastavíte v [administraci Kauflandu](https://sellerportal.kaufland.de/shipping-groups/). ´ ### 3. Mergado V následujícím kroku je nutné vybrat, ze kterého Mergado projektu a výběru chcete produkty na marketplace nahrát. > Ještě nemáte žádný projekt na výběr? Podívejte se, jak nahrát produktový feed do Mergado Editoru [zde](https://forum.mergado.cz/t/novy-projekt/2733). :information_source: Pokud nechcete na marketplaces zasílat všechny produkty z daného projektu, **vytvořte si v Mergado Editoru výběr produktů, které chcete na marketplace zalistovat** . Následně se otevře část pro namapování elementů z vybraného projektu v Mergado Editoru na elementy v aplikaci Marketplaces. Povinně je nutné namapovat elementy **'EAN', 'ID produktu', 'Cena s DPH', 'Stav zboží' a 'Čas odbavení objednávky'**. Elementy 'Název produktu', 'Popis produktu' a 'Obrázky jsou nepovinné a na Kaufland se posílají pouze v případě vytváření či doplňování produktových karet. U nabídek, pro které již v katalogu Kauflandu existuje produktová karta, se použijí obrázky z produktové karty Kauflandu. > :exclamation: **Vezměte prosím na vědomí, že pro DE, AT, SK, IT a FR prodejní kanál musíte napárovat cenu v EUR, pro CZ prodejní kanál v CZK a pro PL prodejní kanál v PLN.** V tomto kroku také můžete zvolit **'DPH'**, **'Stav zboží'** a **'Čas odbavení objednávky'** jednotně pro celou kampaň (například pokud prodáváte pouze nové produkty). Druhou možností je napárovat tyto hodnoty na vaše elementy z feedu. ### 4. Dostupnost Předposledním krokem je nastavení dostupnostního feedu. Zde stačí uvést adresu vašeho dostupnostního feedu. Podporujeme Mall a [Heureka dostupnostní feed ](https://forum.mergado.cz/t/dostupnostni-feed-heureka/2427), případně [Mergado Marketplaces formát feedu](https://forum.mergado.cz/t/mergado-marketplaces-format-feedu/mergado-marketplaces-format-feedu). Aplikace zkontroluje vložený dostupnostní feed. Pokud dostanete informaci, že chybí všechny produkty, pravděpodobně jste vložili jiný dostupnostní feed, nebo jste špatně namapovali ID produktu v kroku **Mergado.** :bulb: **Pokud nemáte k dipozici dostupnostní feed v Mall či Heureka formátu, je možné si jej vytvořit pomocí Mergado Editoru. Více informací naleznete v našem článku [zde](https://forum.mergado.cz/t/dostupnostni-feed/dostupnostni-feed).** > :information_source: Pokud narazíte na chybovou hlášku “Nastala chyba při stahování dostupnostního feedu, ujistěte se, že je soubor dostupný”, je pravděpodobné, že máte dostupnostní feed zabezpečený a aplikace tak k němu nemá přístup. Pokud máte svůj e-shop na Shoptetu, tak **[zde](https://www.mergado.cz/zabezpeceni-shoptet-feedu)** naleznete návod, jak v Shoptet administraci upravit zabezpečení vašeho dostupnostního feedu tak, aby k němu měla aplikace přístup. ### 5. Dokončení Poslední krok je pouze závěrečné shrnutí. Ujistěte se, že máte vše správně vyplněno a případně údaje opravte. Tvorbu kampaně dokončíte tlačítkem „Uložit“ vpravo dole. Tímto je kampaň vytvořena a nabídky se začnou automaticky nahrávat do Kaufland marketplace. Tento proces může nějakou chvíli trvat. > :exclamation: **Po dokončení synchronizace produktového feedu si rozklikněte detail kampaně a v sekci validace zkontrolujte případné chybové hlášky.** Vysvětlení těch nejčastějších validačních hlášek naleznete [zde](https://forum.mergado.cz/t/mergado-marketplaces-validacni-hlasky/mergado-marketplaces-validacni-hlasky). :question: Máte ve validaci chybovou hlášku “**V Kaufland katalogu nebyla pod tímto EAN kódem nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty'** "? Tato hláška znamená, že pro dané produkty ještě v katalogu Kauflandu neexistuje produktová karta. Podrobný návod, jak produktovou kartu založit přes naši aplikaci, naleznete [zde](https://forum.mergado.cz/t/zakladani-produktovych-karet-pro-allegro/zakladani-produktovych-karet-pro-allegro-a-kaufland). --- ## [Zakládání produktových karet pro Allegro a Kaufland](https://help.mergado.com/cs/mergado-marketplaces/zakladani-produktovych-karet-pro-allegro-a-kaufland/) # Zakládání produktových karet pro Allegro a Kaufland Pokud jste se po založení kampaně setkali v sekci validace s hláškou “**V Allegro katalogu nebyla pod tímto identifikátorem produktu nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty'**” či "**V Kaufland katalogu nebyla pod tímto EAN kódem nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty'**", tak to znamená, že pro daný produkt ještě v katalogu marketplace neexistuje produktová karta a je potřeba založit novou. V tomto článku si ukážeme, jak na to. :warning: V případě Kauflandu jsou do procesu vytváření produktových karet zahrnuty jak produkty s validační hláškou “V Kaufland katalogu nebyla pod tímto EAN kódem nalezena žádná produktová karta, pro její vytvoření přejděte do sekce 'Produktové karty'”, tak produkty ve statusu "Nekompletní". Tento status znamená, že vaši nabídku se sice podařilo na Kaufland nahrát, ale produktová karta, ke které se nabídka napojila, je nekompletní a je potřeba k ní doplnit produktová data, aby se mohla nabídka aktivovat. **Po vytvoření nové kampaně pro Kaufland je tedy dobré vyčkat do první synchronizace statusů a až poté se pustit do vytváření produktových karet.** Díky tomu budete mít už od začátku v procesu zařazeny všechny relevantní produkty. > :notebook_with_decorative_cover: **Slovník pojmů:** **Katalog marketplace** = Katalog produktů, ve kterém je pro každý produkt jedna produktová karta, ke které se mohou prodejci připojit se svými nabídkami. **Produktová karta** = Karta v katalogu marketplace, která obsahuje všechny povinné parametry o výrobku (rozměry, materiál, barva atd.). K produktové kartě se pak dle identifikátoru produktu napojí nabídka. **Nabídka** = Po nahrání produktového feedu do aplikace Mergado Marketplaces se z produktů stanou nabídky na marketplace. Na marketplace existuje pro každý produkt jedna produktová karta, ke které se připojí nabídky různých prodejců. Nabídky se od sebe tedy liší cenou a nákupními podmínkami, ale základní údaje o výrobku na produktové kartě, jako je EAN kód, výrobce či značka, jsou identické. Do sekce produktových karet se dostanete buď přímo z menu kampaně a nebo pomocí ikonky u validační hlášky: **1. NAPÁROVÁNÍ VŠECH POVINNÝCH ELEMENTŮ** Pro založení produktových karet je nutné napárovat některé elementy, které byly doposud v rámci aplikace nepovinné. Jedná se o elementy: * **Obrázky** * **Název produktu**: Dbejte na to, aby byl název produktu v jazyce storefrontu, na kterém prodáváte. * **Kategorie** * **Popis produktu**: Tento element je povinný pouze pro Kaufland. > :exclamation: Jako identifikátor produktu je potřeba mít vyplněný EAN kód. V případě, že jste tyto elementy ještě nenapárovali, stačí přejít do nastavení kampaně, rozkliknout si sekci elementy a požadované elementy dopárovat. Poté změny uložte a dole v nastavení kampaně klikněte na možnost “Synchronizovat produktový feed”. **2. NAPÁROVÁNÍ KATEGORIÍ** Po dopárování těchto elementů se vám odemče sekce produktových karet: **Zde pak stačí napárovat vaše kategorie z produktového feedu na odpovídající kategorie na Allegru/Kauflandu a napárování uložit.** Díky tomu bude možné zjistit, jaké jsou na marketplace pro danou kategorii povinné parametry. Při párování kategorií máte několik možností: - Hromadné předpárování kategorií pomocí funkce "Navrhnout kategorie": - Nalezení vhodné kategorie pomocí stromu kategorií: - Vyhledávání ve stromu kategorií: - Využití funkce "Navrhnout kategorii", kdy se Allegro a Kaufland pokusí navrhnout tu nejvhodnější kategorii: - Vyhledávání přes návrh kategorie, kdy si do vyhledávacího políčka zadáte vlastní výraz: **3. DOPLNĚNÍ PARAMETRŮ** Kliknutím na napárovanou kategorii se vám zobrazí tabulka s produkty, pro které je v dané kategorii potřeba založit produktovou kartu. V tabulce naleznete přehled všech povinných parametrů, které Allegro/Kaufland pro založení produktové karty vyžaduje. V tabulce máte možnost vyplnit dva druhy parametrů: * **Povinné parametry**, které jsou červeně podbarvené a jejich vyplnění je nutné pro založení produktové karty. * **Nepovinné parametry**, kterou jsou bíle podbarvené a jejich vyplnění je dobrovolné. Nepovinných parametrů můžete vyplnit libovolný počet a zároveň máte možnost tyto hodnoty smazat. Upozorňujeme, že stejně jako v případě povinných parametrů není možné jejich hodnoty měnit po úspěšném vytvoření produktové karty. Při vyplňování parametrů máte možnost doplnit hodnoty: * Na úrovni daného produktu * Nebo vyplnit hodnoty pro celý sloupec daného parametru Zároveň máte na výběr mezi zvolením vlastní hodnoty a mezi napárováním na element z produktového feedu. Vlastní hodnota: Napárování na element z produktového feedu: Při napárování na hodnotu z produktového feedu se v tabulce zobrazí pouze název elementu, ale na marketplace pak budou při zalistování zaslány konkrétní hodnoty. > :information_source: Pokud se vaše značka nenachází v seznamu povolených hodnot od Allegra, můžete zvolit "žádná značka" a nebo zažádat o přidání značky do seznamu Allegra přes [tento formulář](https://salescenter.allegro.com/parameter-value-suggestions/create-suggestion). Jakmile Allegro přidání značky pro danou kategorii schválí, můžete přes nás zalistovat produktové karty s touto značkou. **4. SPUŠTĚNÍ ZALISTOVÁNÍ** Po vyplnění všech povinných parametrů u alespoň jednoho produktu se vám odemče tlačítko “**Spustit zalistování produktových karet**”. > :bulb: Po úspěšném zalistování produktů můžete editovat parametry na produktové kartě v sekci "**Úpravy zalistovaných karet**". U Allegra i Kauflandu se zasílá pouze **návrh na změnu produktové karty** a záleží na samotném marketplace, zda změnu přijme či zamítne. V případě Allegra vám po kliknutí na “Navrhnout změny produktových karet” vyskočí okno, kde si můžete zvolit, zda chcete být Allegrem informováni o výsledku zpracování návrhu na změnu (výsledek Allegro zašle na e-mail, pod kterým máte zaregistrovaný účet na Allegru). U Kauflandu je nutné si výsledek zkontrolovat přímo u produktu v Seller Portal. **Výsledek zalistování** zjistíte po nějaké době přímo v tabulce zalistování produktů, kde máte následující ikonky: Produktová karta ještě nebyla zalistována. Při zalistování produktu došlo k chybě, kliknutím na ikonku zjistíte konkrétní chybu. Produktová karta byla úspěšně vytvořena. Tento status se zobrazuje **pouze u Kauflandu** a znamená, že produktová karta je v procesu schvalování ze strany Kauflandu. Tento **proces může trvat i několik dní**, jakmile od Kauflandu obdržíme zpětnou vazbu, tak se status změní na vykřičník či fajfku. Pokud bude produktová karta schválena, tak vaše nabídka k ní bude napojena při další synchronizaci produktového feedu. Výsledek zalistování můžete ale také zkontrolovat v sekci historie: **5. KONTROLA PRODUKTŮ NA MARKETPLACE** Po zalistování produktové karty na marketplace zkontrolujte daný produkt a nabídky také přímo v administraci daného tržiště. > Schvalování produktové karty na Kauflandu může trvat i několik dní. Jakmile bude karta schválena, přiřadíme k nabídce status "Nesynchronizováno" a nabídka se k vaší nově vytvořené kartě napojí hned při další synchronizaci produktového feedu. :BULB: **TIP NA ZÁVĚR**: Automatické zakládání produktových karet u nových produktů V sekci vytváření produktových karet si u povinných i nepovinných parametrů můžete zakliknout možnost ‘**Vyplnit i pro nové produkty**’ při vyplňování parametru pro celý sloupec. Jakmile budete mít tuto možnost povolenou u všech povinných parametrů, odemče se vám možnost ‘**Aktivovat automatické listování nových produktů**’. > Aktivací automatického listování nových produktů se ihned spustí vytvoření produktových karet pro všechny nezalistované produkty s vyplněnými povinnými parametry. Po úspěšném zalistování produktů je možné údaje na produktové kartě upravit v sekci "Úpravy zalistovaných karet". Automatické listování nových produktů si můžete kdykoli deaktivovat. Pokud by při automatickém zalistování došlo u některé produktové karty k chybě, tak je stále potřeba údaje dle validační hlášky od Allegra upravit a pokusit se produkt zalistovat manuálně. --- ## [Doplnění produktových karet Allegra](https://help.mergado.com/cs/mergado-marketplaces/doplneni-produktovych-karet-allegra/) # Doplnění produktových karet Allegra Do aplikace jsme přidali možnost **doplnit povinné parametry do již existujících karet z katalogu Allegra**. Jedná se o případy, kdy Allegro pod daným identifikátorem produktu má ve svém katalogu produktovou kartu, ale produktová karta není kompletní. Abychom tedy k této kartě mohli nabídku napojit, je nutné tuto Allegro produktovou kartu doplnit. To je možné v nové sekci “Doplnění produktových karet”. Do této sekce se uživatel může dostat přes sekci produktových karet nebo také pomocí ikonky u dané validační hlášky "**Na Allegro produktové kartě chybí povinné parametry, přidejte je přes 'Doplnění produktových karet' v sekci 'Produktové karty'**". ## 1. Zjištění Allegro kategorií Prvním krokem je spuštění procesu, který u daných produktových karet zjistí, v jaké se na Allegru nachází kategorii, aby aplikace mohla podle toho nabídnout vhodné povolené hodnoty pro chybějící parametry: > Vezměte prosím na vědomí, že zjištění Allegro kategorií může při velkém počtu produktů s touto hláškou trvat delší dobu. Seznam kategorií bude v anglickém jazyce, jelikož v této podobě nám Allegro kategorie zašle. Nemusíte mít ale obavy, parametry budou doplněny do produktové karty na tom trhu, na kterém prodáváte. ## 2. Doplnění chybějících parametrů Po rozkliknutí kategorie se zobrazí seznam produktů, pro které je v dané kategorii potřeba doplnit nějaké parametry. Chybějící parametr je červeně podbarvený a po jeho doplnění se Vám odemče tlačítko “**Spustit doplnění produktových karet**”: ## 3. Výsledek doplnění parametrů - ✅ Pokud bude parametr úspěšně doplněn, tak produkt z tabulky zmizí a nabídka se k opravené kartě automaticky napojí. - ❗ V případě, že nám Allegro vrátí chybu, tak se v tabulce zobrazí ikonka vykřičníku s chybovou hláškou a parametr bude potřeba opravit. Po opravení hodnoty parametru je možné opětovně spustit doplnění produktové karty. --- ## [GPSR na Allegru a Kauflandu](https://help.mergado.com/cs/mergado-marketplaces/gpsr-na-allegru-a-kauflandu/) # GPSR na Allegru a Kauflandu > **GPSR ve zkratce** Od 13.12.2024 vchází v platnost nařízení EU o obecné bezpečnosti výrobků, které se vztahuje na většinu spotřebních produktů (více [zde](https://eur-lex.europa.eu/CS/legal-content/summary/general-product-safety-regulation-2023.html)). Online tržiště včetně Kauflandu a Allegra vyžadují na základě toho od prodejců dodatečné informace, při jejichž neposkytnutí si vyhrazují právo nabídky prodejce skrýt. U Allegra je nutné vyplnit pokyny a bezpečnostní informace a údaje výrobce / údaje o osobě odpovědné za uvedení produktu na evropský trh. U Kauflandu se jedná o elementy jméno výrobce / zodpovědné osoby v EU, označení CE, bezpečnostní pokyny. V článku se dozvíte, jak tyto údaje ke svým produktům na online tržištích doplnit. # Co je GPSR? Možná už jste zaznamenali, že od **13. prosince 2024** vchází v platnost nařízení EU o obecné bezpečnosti výrobků (GPSR), které zavádí změny pro prodejce na online platformách. GPSR pokrývá většinu spotřebních produktů, včetně nových, použitých, opravených a renovovaných produktů a náhradních dílů. **Z nařízení jsou vyloučeny:** * léky určené pro lidi nebo zvířata * potraviny * krmiva * živé rostliny a zvířata, geneticky modifikované organismy a geneticky modifikované mikroorganismy v uzavřených prostorech, jako jsou výrobky z rostlin a zvířat přímo se vztahující na jejich budoucí reprodukci * vedlejší živočišné produkty a odvedené produkty * přípravky na ochranu rostlin * zařízení, kterými se spotřebitelé přepravují nebo kterými cestují, pokud toto zařízení přímo obsluhuje poskytovatel služeb v rámci dopravní služby poskytované spotřebitelům * letadla uvedená v článku 2. odst. 3 písm. d) nařízení (EU) 2018/1139 * starožitnosti Ke splnění informační povinnosti týkající se bezpečnosti produktů musí být pro každý produkt, na který se nařízení vztahuje, poskytnuty alespoň následující údaje: a. název, registrovaný obchodní název nebo registrovaná ochranná známka **výrobce**, poštovní a e-mailová adresa výrobce * **údaje o osobě odpovědné za uvedení produktu na evropský trh** – je třeba je poskytnout pouze v případě, že se sídlo výrobce nachází mimo Evropskou unii: název, poštovní a e-mailová adresa b. **údaje umožňující identifikaci produktu** včetně jeho obrázku, kategorie a dalších identifikátorů, jako je například kód EAN, model atd. c. **varování a bezpečnostní informace** – informující o tom, jak produkt bezpečně používat, například: * uživatelská příručka produktu – přidejte přílohy v úředním jazyce země, ve které produkt prodáváte * obrázky štítků na obalu produktu * poznámka s upozorněními, která se týkají produktu d. pokud je to vyžadováno, **označení CE a dokumenty o shodě** :information_source: Více informací o GPSR naleznete zde: https://eur-lex.europa.eu/CS/legal-content/summary/general-product-safety-regulation-2023.html # Jak přidat informace k vašim produktům na online tržištích? # Allegro DŮLEŽITÉ ZMĚNY NA ALLEGRO OD SRPNA 2025 **💡Jak to bylo do teď?** Allegro na své platformě v minulosti zavedlo možnost vyplnění parametru ‘Produkty uvedené na trh v EU před 13.12.2024’ a pokud byly vaše produkty uvedeny na evropský trh před tímto datem, nemuseli jste vyplňovat další povinné údaje týkající se GPSR. Nyní i kvůli tlaku od regulátora mění Allegro přístup k GPSR údajům. **📢 Co se na Allegru mění od srpna 2025?** 1️⃣ Pole ‘Produkty uvedené na trh v EU před 13.12.2024’ Od 12.8.2025 půjde nastavit jen u produktů se stavem 'Použité', 'Protektorované', 'Na díly', 'Regenerované', 'Poškozené', 'Repasované výrobcem', 'Repasované prodejcem', 'K restaurování', 'Zrekonstruované', 'Nevyžaduje žádnou renovaci' a 'Po demontáži'. **U veškerého nového zboží bude nutné vyplnit kompletní bezpečnostní informace a údaje o výrobci – bez ohledu na datum uvedení na trh.** 2️⃣ Pole ‘Varování a bezpečnostní informace’ Od 4.8.2025 nebude možné používat hodnotu ‘Neposílat bezpečnostní informace’, kterou mohli prodejci oznámit, že k produktu nejsou k dispozici bezpečnostní informace. **Nově tedy musíte dodat bezpečnostní informace v podobě přílohy nebo textu.** **⚠️ Proč to řešit a jaké kroky mám podstoupit?** Jakmile změny vejdou v platnost, tak při editaci aktivních nabídek vrátí Allegro chybovou hlášku a nabídka nebude aktivní, dokud nebudou údaje doplněny. Hrozí tedy, že se Vám deaktivuje velké množství nabídek v řádu dnů od zavedení změn. Doplnění těchto údajů může být časově náročné, proto je lepší, začít na tom pracovat co nejdříve. Návod pro doplnění elementů “Varování a bezpečnostní informace”, “Údaje výrobců” a “Odpovědné osoby za uvedení na evropský trh” naleznete níže. >:bulb: Pokud nevyplníte u nabídek GPSR informace, pokusíme se tyto údaje doplnit z produktového katalogu Allegra při **manuální synchronizaci produktového feedu** (kliknutím na "Synchronizovat produktový feed" v nastavení kampaně) a také při **vytváření nabídek** (u tvorby nové kampaně či u nových produktů v kampani). Jedná se o údaje generované Allegrem prostřednictvím umělé inteligence, proto doporučujeme údaje u nabídek následně důkladně zkontrolovat. --- V rámci GPSR se na Allegru na úrovni nabídky vyplňují tyto údaje: * **Produkty uvedené na trh v EU před 13.12.2024** * Od 12.8.2025 půjde nastavit parametr "Produkty uvedené na trh v EU před 13.12.2024" jen u produktů se stavem 'Použité', 'Protektorované', 'Na díly', 'Regenerované', 'Poškozené', 'Repasované výrobcem', 'Repasované prodejcem', 'K restaurování', 'Zrekonstruované', 'Nevyžaduje žádnou renovaci' a 'Po demontáži'. * **Údaje výrobců** * **Odpovědné osoby za uvedení na evropský trh** * **Varování a bezpečnostní informace** **1. Údaje výrobce a údaje o osobě odpovědné za uvedení produktu na evropský trh** Údaje o výrobci můžete přidat v části “[Údaje výrobců](https://salescenter.allegro.com/responsible-producers)” v záložce “Nastavení prodeje” přímo v Sales Center Allegra. Údaje o osobě odpovědné za uvedení produktu na evropský trh je potřeba uvést pouze v případě, že se sídlo výrobce nachází mimo Evropskou unii. Informace můžete doplnit v části “[Odpovědné osoby](https://salescenter.allegro.com/responsible-persons)” v záložce “Nastavení prodeje” přímo v Sales Center Allegra. Tím si tedy na Allegru předpřipravíte všechny karty výrobců a odpovědných osob, které mají obsahovat: * jméno a příjmení, registrované obchodní jméno nebo registrovaná ochranná známka * adresu * e-mailovou adresu či odkaz na kontaktní formulář Ke každému výrobci / osobě zadáváte také “Vlastní název” - tomuto údaji věnujte pozornost, protože pomocí tohoto názvu budete k nabídkám přiřazovat výrobce a odpovědnou osobu v Mergado Marketplaces. Jakmile budete mít všechny výrobce a odpovědné osoby v Sales Center Allegra připravené, můžete přejít do aplikace Mergado Marketplaces. Tyto údaje pak můžete doplnit v nastavení kampaně v Mergado Marketplaces, kde máte možnost zvolit jednotného výrobce pro všechny produkty v kampani nebo element napárovat na feed. V případě napárování na element z feedu uveďte jako hodnoty vlastní názvy prodejců tak, jak jste je vyplnili v Allegro administraci. Poté změny v nastavení kampaně uložte a klikněte ve spodní části nastavení na "Synchronizovat produktový feed". :information_source: Vlastní názvy výrobců a odpovědných osob můžete do feedu doplnit 2 způsoby: 1. Vytvoření nového elementu a doplnění hodnoty pomocí výběrů Přejděte do sekce “Elementy” u projektu, který používáte v aplikaci Mergado Marketplaces. Následně klikněte na “Přidat nový element”: Název je zcela na vás, pro naše účely jsme zvolili název RESPONSIBLE_PRODUCER pro údaje o výrobci: Vytvořte si v Mergado Editoru různé výběry produktů pro skupiny produktů, ke kterým chcete přiřadit stejné údaje o výrobci. Například podle hodnot v elementu výrobce “MANUFACTURER”: Jakmile budete mít všechny výběry připraveny, můžete přejít do sekce “Pravidla” a zvolit možnost “Nové pravidlo”. Název pravidla je libovolný, v našem případě například “Doplnění vlastních názvů pro RESPONSIBLE_PRODUCER”. Jako typ pravidla zvolte “Hromadné přepisování dle výběrů” a zvolte vámi nově vytvořený element: Pod “Nová hodnota” pak uveďte k jednotlivým výběrům produktů “Vlastní název” daného výrobce z vaší Allegro administrace: V nastavení kampaně Mergado Marketplaces napárujte “Údaje výrobců” na vámi vytvořený element z feedu a spusťte synchronizaci produktového feedu: Po dokončení synchronizace zkontrolujte v aplikaci Mergado Marketplaces sekci “Validace”, zda nedošlo u některých nabídek k chybě při nahrávání těchto údajů na Allegro. Stejný postup můžete využít v případě “Odpovědné osoby za uvedení na evropský trh”. Pokud nechcete daný údaj u některých produktů zasílat, stačí u vámi vytvořeného elementu ve feedu nic nevyplňovat. 2. Import CSV souboru Údaje můžete také do feedu importovat pomocí CSV, kde první sloupec bude sloužit jako identifikátor produktu a další sloupce budou obsahovat elementy a jejich hodnoty, které chcete do feedu naimportovat. Pojďme si to ukázat na příkladu “Odpovědné osoby za uvedení na evropský trh”. Na Allegru si připravíme jednotlivé karty osob: V daném projektu v Mergado Editoru si vytvoříme nový element, který budeme pomocí CSV importu naplňovat hodnotami: Názvy sloupců v CSV souboru musí mít stejné názvy, jako již existující elementy ve vašem projektu. Zároveň nezapomeňte na to, že je potřeba vkládat “Vlastní názvy” jednotlivých odpovědných osob z administrace Allegra: Jakmile budete mít CSV soubor připravený, můžete u daného projektu přejít do sekce “Pravidla” a vytvořit nové pravidlo. Jako typ pravidla zvolte “Import datového souboru” a nahrajte CSV soubor: Po aplikování pravidel si můžete na přehledu produktů zkontrolovat, zda se hodnoty elementu správně doplnily: V nastavení kampaně Mergado Marketplaces poté napárujte “Odpovědné osoby za uvedení na evropský trh” na vámi vytvořený element z feedu a spusťte synchronizaci produktového feedu. :link: Více informací o importu CSV naleznete zde: https://www.mergado.cz/blog/csv-import-mergado-release > :bulb: Pokud jste jako "**Vlastní název**" na Allegru pro údaje o výrobci uvedli **stejnou** (včetně velikosti písma apod.) hodnotu jako máte ve feedu pro element MANUFACTURER (či jinak nazvaný element pro výrobce), tak můžete karty výrobců napárovat podle tohoto elementu a není třeba vytvářet element nový. **2. Varování a bezpečnostní informace** Může se jednat o uživatelskou příručku produktu v jazyce prodejního kanálu, obrázky štítků na obalu produktu či text s upozorněními. Tento údaj můžete doplnit v nastavení kampaně v Mergado Marketplaces napárováním na element z feedu nebo uvedením jednotné hodnoty pro všechny produkty v kampani: * Při zvolení jednotné hodnoty pro celou kampaň uveďte **text bez HTML formátování s maximální délkou 2000 znaků** * Při napárování na element z feedu mohou být hodnoty následující: * Veřejně přístupné **URL adresy** začínající na http:// či https://, ze kterých lze stáhnout soubory ve formátu PDF, JPEG, JPG, PNG o maximální velikosti 50 MB. * Obyčejné **texty bez HTML** formátování s upozorněními týkající se produktu. :information_source: Informace do feedu opět můžete doplnit dvěma způsoby (postup viz výše): * Vytvoření nového elementu a doplnění hodnoty pomocí výběrů * Import CSV souboru > ⚠️ Jelikož se všechny GPSR údaje vyplňují u Allegra na úrovni nabídky, můžete tyto údaje v nastavení kampaně kdykoli změnit. :link: Více informací naleznete na stránkách Allegra [zde](https://help.allegro.com/sell/cs/a/jake-povinnosti-vam-uklada-gpsr-O3YPWLrz4im#). # Kaufland U Kauflandu se údaje v rámci GPSR uvádí na úrovni produktových karet a u produktů, kterých se nařízení týká, se má doplnit: * **Jméno výrobce / zodpovědné osoby v EU** * **Označení CE** * **Bezpečnostní pokyny** Prodej na Kauflandu přes Mergado Marketplaces (API napojení) Tyto údaje se dají přes aplikaci Mergado Marketplaces doplnit pouze v případě, že pro produkty vytváříte nové produktové karty, nebo doplňujete nekompletní karty. **Aplikace Mergado Marketplaces totiž neumožňuje editaci již existujících produktových karet.** **1. Vytváření nových produktových karet či doplňování nekompletních karet** Pokud tedy budete vytvářet či doplňovat produktové karty v sekci “Produktové karty”, tak stačí doplnit tyto tři údaje, pokud daný produkt spadá pod GPSR: **2. Doplnění údajů do již existujících produktových karet** Pokud již máte na Kauflandu produkty vystavené, můžete potřebná data do produktových karet doplnit 2 způsoby: a) Pomocí jednorázového importu: Import by měl obsahovat: * **ean** * **locale** (např. cs-CZ) A následně elementy, které chcete v rámci GPSR doplnit, tedy například: * **product_safety_contact.name** * **product_safety_contact.address** (ve formátu Ulice 1, Město, 615 00, CZ”) * **product_safety_contact.email_address** * **product_safety_contact.phone_number** * **safety_guidelines** (jedná se o právní texty, u kterých má Kaufland konkrétní povolené hodnoty, jako například: "'Pozor! Výrobek není vhodný pro děti mladší 36 měsíců”) * **ce_certificate** (veřejně přístupná URL adresa, ze které lze stáhnout soubor ve formátu jpg, gif, svg, png, pdf) Seznam povolených hodnot pro safety_guidelines **[zde](https://docs.google.com/spreadsheets/d/17uu69dyqQ8BkfpWVfeM7CvY9KtnNyC9QUIM0P5dcMRI/edit?gid=2131277475#gid=2131277475)**. Soubor si můžete vytvořit například v Google Sheet a vypadat by mohl takto: Soubor si poté stáhnete ve formátu CSV a nahrajete jej na Kaufland. b) Přes Mergado Editor, kde si můžete tyto elementy snadno vytvořit a opět jejich hodnoty doplnit dvěma způsoby (postup viz výše): * Vytvoření nových elementů a doplnění jejich hodnot pomocí výběrů * Import CSV souboru V Mergado Editoru si stačí připravit tyto elementy a ty naplnit povolenými hodnotami: Pro účely jednorázového importu může soubor obsahovat pouze ean, locale a nové elementy, které chcete v rámci GPSR přidat. Feed si poté z Editoru stáhněte a proveďte jednorázový import na Kaufland. Prodej na Kauflandu přes Mergado Editor (napojení přes feedy) Pokud jste na Kaufland napojení přes feedy a již tedy na Kaufland pravidelně zasíláte produktový feed, tak si můžete do feedu přidat níže uvedené elementy (viz obrázek výše): * product_safety_contact.name * product_safety_contact.address (ve formátu “Ulice 1, Město, 615 00, CZ”) * product_safety_contact.email_address * product_safety_contact.phone_number * safety_guidelines (jedná se o právní texty, u kterých má Kaufland konkrétní povolené hodnoty, jako například: "'Pozor! Výrobek není vhodný pro děti mladší 36 měsíců”) * ce_certificate (veřejně přístupná URL adresa, ze které lze stáhnout soubor ve formátu jpg, gif, svg, png, pdf) Seznam povolených hodnot pro safety_guidelines **[zde](https://docs.google.com/spreadsheets/d/17uu69dyqQ8BkfpWVfeM7CvY9KtnNyC9QUIM0P5dcMRI/edit?gid=2131277475#gid=2131277475)**. Pokud máte v Kauflandu nastavené “Automatické nahrávání údajů o produktech”, tak není třeba provádět jednorázový import. Nová data budou na Kaufland automaticky zaslána při nejbližším stažení výstupního feedu Kauflandem. :link: Více informací naleznete zde: https://www.kauflandglobalmarketplace.com/cs/seller-university/pravni-pruvodce/gpsr/ >**Vyloučení odpovědnosti:** Tyto informace nepředstavují ani nenahrazují právní poradenství. Informujte se prosím na vlastní odpovědnost a v případě potřeby si vyžádejte právní poradenství ohledně toho, zda vámi nabízené produkty spadají do příslušných kategorií a požadavků. --- ## [Import objednávek do Shoptet Premium](https://help.mergado.com/cs/mergado-marketplaces/import-objednavek-do-shoptet-premium/) # Import objednávek do Shoptet Premium Běží váš e-shop na Shoptet Premium? Přes Mergado Marketplaces můžete importovat objednávky z marketplaces přímo do vašeho e-shopového řešení. Synchronizace objednávek probíhá každých 5 minut a do Shoptetu se importují nové objednávky ve stavu "Neodesláno". Ve směru z Mergado Marketplaces do Shoptetu, dochází k synchronizaci statusů: * "Neodesláno" :backhand_index_pointing_right: "Nevyřízená" * "Odesláno" :backhand_index_pointing_right: "Objednávka vyřízena" * "Zrušeno" :backhand_index_pointing_right: "Zrušena" ## Jak spustit import objednávek do Shoptet Premium? ### 1. Vytvořte API klíče🗝️ V administraci Shoptet Premium jděte do `Propojení > Private API` a přidejte si nový privátní token. ### 2. Propojte Shoptet Premium s Mergado Marketplaces :link: V Mergado Marketplaces přejděte do sekce **Napojení** a vyberte napojení na Shoptet Premium. Zde stačí vyplnit dříve vygenerovaný API token a napojení se úspěšně spustí. ### 2. Aktivujte synchronizaci :counterclockwise_arrows_button: Přejděte do sekce **Objednávky > Aktivace** a aktivujte synchronizaci a uložte změny. Synchronizaci můžete na stránce aktivace kdykoliv jednoduše pozastavit. > :two_o_clock: Systém správy objednávek nesynchronizuje zpětně. Nemusíte se tedy bát, že by spuštěním byl váš systém zaplaven všemi předchozími objednávkami. ### :bulb: **Důležité informace:** * Produkty se na váš Shoptet katalog párují podle shody "ID produktu" v Mergado Marketplaces a "Kód produktu" v Shoptetu katalogu. * Sazba DPH se u produktů napárovaných na váš katalog propíše přímo z něj, v případě nenapárovaných produktů se použije defaultní sazba DPH z vaší Shoptet administrace * Pro import objednávek v cizí měně si musíte v Shoptet administraci v sekci "Nastavení" -> "Základní nastavení" -> "Měny" cizí měny povolit > :information_source: Pokud narazíte na potíže nebo budete mít nápad na zlepšení, dejte vědět na support [mergado@mergado.cz](mailto:mergado@mergado.cz) nebo zde na fóru. Děkujeme! --- ## [Napojení objednávek do WooCommerce s Mergado Marketplaces](https://help.mergado.com/cs/mergado-marketplaces/napojeni-objednavek-do-woocommerce-s-mergado-marketplaces/) # Napojení objednávek do WooCommerce s Mergado Marketplaces V aplikaci Mergado Marketplaces můžete využít **správu objednávek přes WooCommerce**. Pokud provozujete e-shop na WooCommerce a prodáváte na Allegro nebo Kaufland, můžete nyní pracovat se svými objednávkami přímo ve své e-shopové administraci. > :circus_tent: **Naše vize** je jednoduchá: Ovládejte marketplace jako svůj e-shop. Jednoduše přes nás zalistujete produkty a následnou správu objednávek můžete dělat, ve vaší e-shopové platformě jako jste zvyklí. První integrovanou platformou je právě WooCommerce, ale můžete se těšit, jak na **přídávání funkcí v této integraci**, tak na **integrace na další e-shopové platformy**. --- ## Jak to funguje? Objednávky z Allegro nebo Kaufland se každých 5 minut automaticky přenáší skrze Mergado Marketplaces do WooCommerce. Jakmile v e-shopu objednávku změníte (např. označíte jako odeslanou), stav se synchronizuje i zpět na marketplace. Pokud z WooCommerce získáme sledovací číslo objednávky předáme do marketplace i to. **Stále ale musíte kontrolovat i marketplace administraci.** --- ## Jak spustit správu objednávek pro WooCommerce? ### 1. Vytvořte API klíče🗝️ V administraci WooCommerce jděte do `WooCommerce > Nastavení > Pokročilý > REST API` a vygenerujte si přístupové klíče **s oprávněním Číst/Zapisovat** (klíč uživatele + tajný klíč). > :warning: Klíče si bezpečně uložte, zobrazí se jen jednou. --- ### 2. Propojte WooCommerce s Mergado Marketplaces 🔗 V Mergado Marketplaces přejděte do sekce **Napojení** a vyberte napojení na WooCommerce. Vyplňte: * URL vašeho e-shopu (včetně https) * API klíče z předchozího kroku Po úspěšném napojení bude detail vypadat následovně. Můžete využít odkaz na přesunutí do sekce **Aktivace**, kde je potřeba udělat poslední krok nastavení synchronizace. --- ### 3. Aktivujte synchronizaci 🔄️ Přejděte do sekce **Objednávky > Aktivace** a aktivujte synchronizaci a uložte změny. Synchronizaci můžete na stránce aktivace kdykoliv jednoduše pozastavit. > :information_source: Systém správy objednávek nesynchronizuje zpětně. Nemusíte se tedy bát, že by spuštěním byl váš systém zaplaven všemi předchozími objednávkami. Hotovo! :tada: Od teď už se objednávky budou pravidelně přenášet mezi vašimi Marketplaces a WooCommerce. --- ## Metadata v objednávce Jediné místo, kam můžeme v objednávce předávat další informace jsou metadata objednávky. Momentálně v metadatech objednávky naleznete: * Číslo objednávky z marketplace * Pokud jde o Allegro: kód a lokaci výdejního místa (pickup point) --- ## Současná omezení * Získávat sledovací (dopravní) číslo objednávky umíme zatím **pouze** při používání oficiálního [pluginu Zásilkovna](https://www.zasilkovna.cz/digitalni-integrace/woocommerce) a pluginu [Toret Zásilkovna](https://toret.cz/produkt/woocommerce-zasilkovna/) . * Bez sledovacího čísla neumíme změnit stav na Kauflandu na **"odesláno"**. * Nepracujeme s **vlastními (custom) statusy** ve WooCommerce (u nás se změní stav na "neznámý" na marketplace nic neměníme). * Nevyvíjíme plugin pro WooCommerce, pouze využíváme API napojení. Neobohatíme vám tedy nijak vaši e-shopovou administraci. --- >:information_source: Pokud narazíte na potíže nebo budete mít nápad na zlepšení, dejte vědět na support [mergado@mergado.cz](mailto:mergado@mergado.cz) nebo zde na fóru. Děkujeme! --- ## [Napojení objednávek do UNAS s Mergado Marketplaces](https://help.mergado.com/cs/mergado-marketplaces/napojeni-objednavek-do-unas-s-mergado-marketplaces/) # Napojení objednávek do UNAS s Mergado Marketplaces V aplikaci Mergado Marketplaces můžete využít **správu objednávek přes UNAS**. Pokud provozujete e-shop na UNAS a prodáváte na Allegru nebo Kauflandu, můžete nyní pracovat se svými objednávkami přímo ve své e-shopové administraci. Níže naleznete postup, jak si synchronizaci objednávek s UNAS nastavit. **1. Vytvoření napojení na UNAS v Mergado Keychain** Pro vytvoření napojení je potřeba v Mergado Keychain vyplnit: * API klíč * Název obchodu (ID) Tyto informace naleznete v UNAS v sekci `Beállítások` > `Külső kapcsolatok` > `API kapcsolat`. Zde klikněte na tlačítko `API kulcs létrehozása` a vytvořte si API klíč pro Mergado. Pro správné fungování potřebuje Mergado Marketplaces provádět následující operace: * getOrder * setOrder * getOrderStatus * setOrderStatus * getMethod Po uložení si zkopírujte API klíč a spolu s názvem obchodu jej vložte do Mergado Keychain: **2. Nastavení měn v UNAS** Pokud prodáváte přes Mergado Marketplaces na více trzích, je potřeba si v nastavení UNAS povolit zahraniční měny v sekci `Beállítások` > `Pénznemek, Árkijelzés` > `Pénznemek`. Zde si přidejte všechny měny pro země, kde přes Mergado Marketplaces prodáváte. **3. Aktivace UNAS v Mergado Marketplaces** Jakmile budete mít úspěšně vytvořené napojení v Mergado Keychain a připravené měny, můžete si aktivovat objednávky v Mergado Marketplaces v sekci `Objednávky` > `Aktivace`. Zaklikněte UNAS a změny uložte. Pro správné fungování synchronizace objednávek je nutné mít aktivované objednávky i pro alespoň jeden marketplace. **4. Dodatečná nastavení v Mergado Marketplaces** **Napárování způsobů dopravy a platby** Po aktivaci objednávek máte možnost si v sekci "Napojení" napárovat způsoby dopravy a platby z marketplaces na vaše hodnoty z UNAS. V této sekci se dynamicky načítají hodnoty způsobu dopravy a plateb podle příchozích objednávek. Je tedy dobré tuto sekci pravidelně kontrolovat a případně dopárovat nové hodnoty, které se v sekci mohly objevit. > Pokud si způsoby dopravy a platby nenapárujete, pošleme do UNAS způsob platby a dopravy v takovém formátu, jak je obdržíme z marketplace. **Sazby DPH** Pro vytvoření objednávky v UNAS je povinné uvádět u položek objednávky cenu bez DPH. Sazbu DPH si můžete vyplnit v nastavení jednotlivých kampaní pro Allegro i Kaufland. Pokud nemáte sazbu DPH u nabídek vyplněnou, bude pro výpočet ceny bez DPH použita standardní sazba pro danou zemi. **Párování statusů mezi Mergado Marketplaces a UNAS** * Neodesláno :backhand_index_pointing_right: Waiting for processing (Feldolgozásra vár) * Zpracovává se :backhand_index_pointing_right: Confirmed (Visszaigazolva) * Odesláno :backhand_index_pointing_right: Delivery (Kiszállítás) * Zrušeno :backhand_index_pointing_right: pokud nemáte tento status v UNAS k dispozici, tak si naše aplikace vytvoří vlastní status 'Cancelled' --- ## [Import objednávek do systému POHODA](https://help.mergado.com/cs/mergado-marketplaces/import-objednavek-do-systemu-pohoda/) # Import objednávek do systému POHODA Potřebujete dostat své objednávky z marketplaces do systému POHODA? Mergado Marketplaces vám nově vygeneruje feed s novými objednávkami, pomocí kterého si je můžete do POHODY naimportovat. V tomto návodu vám vysvětlíme vše krok za krokem: > :memo: **Poznámky na úvod:** > * U Allegro ID objednávky se do feedu propíše pouze prvních 30 znaků z důvodu omezení na straně POHODY > * POHODA si sama hlídá, aby nedošlo k duplicitnímu importu objednávky > * Importují se pouze objednávky ve stavu "Neodesláno" ## Nastavení v Mergado Marketplaces 1. V sekci "Napojení" klikněte na logo POHODA a následně vyplňte tyto údaje: * **IČO společnosti**: IČO firmy se musí shodovat s IČO nastaveným v účetní jednotce systému POHODA. * Autorizace: vyplňte **uživatelské jméno a heslo** pro zabezpečení objednávkového feedu. Tyto údaje si důkladně uložte, jelikož je následně bude potřeba zadat do systému POHODA. 2. Po úspěšném uložení přejděte do 'Objednávky' -> 'Aktivace', zvolte POHODA a marketplaces, ze kterých chcete stahovat objednávky a změny uložte. 4. Poté se můžete vrátit zpět do detailu napojení na systém POHODA v sekci 'Napojení', kde naleznete URL adresu objednávkového feedu, kterou podle návodu níže vložíte do systému POHODA. ### Párování plateb a dopravců Platby i dopravci se párují podle pole **'Název'**. Název uvedený v Mergado Marketplaces a v systému POHODA musí být zcela totožný, aby se platby a dopravci správně napárovaly. V sekci párování plateb a dopravců v Mergado Marketplaces uvidíte vždy pouze ty hodnoty, které se objevily u vašich objednávek ve stavu "Neodesláno": > :bulb: Doporučujeme nechat export objednávek zapnutý alespoň týden a poté napárovat platební metody a dopravce. **Zároveň doporučujeme, pravidelně tuto sekci kontrolovat, zda se neobjevila nová platební metoda či dopravce, které by bylo třeba napárovat.** :warning: Pokud se objeví objednávka s neznámou metodou platby či dopravcem (údaj ještě není napárovaný), tak se objednávka do feedu propíše, ale dopravce se do systému POHODA nepropíše a platba se automaticky nastaví jako “Příkazem”. ### Sazby DPH u položek v objednávce Pokud obdržíme u objednávky z marketplace sazbu DPH pro objednané zboží, zobrazíme danou sazbu také v objednávkovém feedu. Ve feedu uvedeme hodnotu sazby pro danou zemi a k tomu příznak high či low (např. `high`) podle toho, zda se jedná o standardní nebo sníženou sazbu pro konkrétní zemi. Zkontrolujte si tedy, že máte správně nastavené sazby DPH ve vaší POHODA administraci. > Pokud nemáte u objednávek uvedenou sazbu DPH, stačí si v nastavení kampaně pro jednotlivé marketplaces sazbu DPH zvolit buď jednotně, nebo ji napárovat na element z feedu. Pokud u zboží v objednávce neobdržíme sazbu DPH, propíše se do objednávkového feedu zboží bez sazby DPH. ## Základní nastavení v systému POHODA V POHODA účetní jednotce zvolte 'Nastavení -> Internetové obchody -> Nastavení internetových obchodů': * Internetový obchod: vyberte 'Obecný internetový obchod' * Záložka 'Obecné': vyplňte alespoň "Název obchodu" (např. doména e-shopu) * Záložka 'Nastavení': zaškrtněte 'Maximální doba odpovědi [s]' a zvyšte číslo např. na cca 120 (při průměrném počtu objednávek) * Záložka 'WEB klient': zaškrtněte 'Webová služba vyžaduje ověření' a vyplňte 'Uživatelské jméno' a 'Heslo', které jste vyplnili v Mergado Marketplaces * Záložka 'Import': Do 'URL pro Objednávky' vložte URL adresu feedu zkopírovanou z Mergado Marketplaces > Nezapomeňte změněné údaje uložit! > :warning: Pokud prodáváte přes marketplaces na zahraničních tržištích, je potřeba mít v systému POHODA povolené zahraniční měny. Návod naleznete [zde](https://www.stormware.cz/prirucka-pohoda-online/nastaveni/cizi_meny/). ## Jednorázový import objednávek 1) V POHODA účetní jednotce zvolte 'Soubor -> Datová komunikace -> Internetové obchodování'. 2) Zvolte internetový obchod a možnost 'Stáhnout z internetu': 3) Zaklikněte 'Přijaté objednávky' -> 'všechny' (všechny objednávky z Mergado Marketplaces ve stavu 'neodesláno'): 4) Kliknutím na 'Další' spustíte přenos -> pokud proběhl přenos v pořádku, zobrazí se 'Stav: OK': > :warning: **Pokud došlo při importu k chybě, nebo například nebyl import kompletní, zobrazí se v okně také odkaz na soubor. Tento soubor si stáhněte a následně nám dokument s názvem "responseStatePohoda_XYZ" zašlete na support, abychom zjistili příčinu problému.** 5) V sekci 'Fakturace -> Přijaté objednávky' vidíte naimportované objednávky: ## Automatický import objednávek U verze POHODA E1 lze nastavit import objednávek jako automatickou úlohu. Nastavení je možné provést následujícím způsobem: 1) V systému POHODA přejděte do 'Nastavení – Internetové obchody – Nastavení internetových obchodů': 2) Zde klikněte na 'Scénáře', a poté pravým kliknutím na 'Zkratka' dáte 'Vytvořit scénář': 3) V nastavení scénáře si vyberete název a jeho popis, poté si vyberete činnost, kterou tento scénář má dělat. Na závěr scénář uložte. 4) Dalším krokem je vytvoření automatických úloh. Klikněte na 'Soubor -> Účetní jednotky', kde zakliknete svou účetní jednotku, pro kterou se budou úlohy dělat. 5) V menu zvolte 'Databáze' -> 'Automatické úlohy': 6) Prvním nastavením bude nastavení činnosti. Zde vyberete obecný internetový obchod, účetní jednotku, uživatele a heslo, pokud je potřeba, o jaký internetový obchod se jedná a jaký scénář chcete nastavovat. 7) V poli 'Automatická úloha' poté nastavíte název a popis dané úlohy a dáte nastavení plánovače. Vyberete četnost, čas prvního spuštění a jeho opakování, nejdelším obdobím, který je možný nastavit, je 1 rok. >:information_source: Pokud narazíte na potíže nebo budete mít nápad na zlepšení, dejte vědět na support [mergado@mergado.cz](mailto:mergado@mergado.cz) nebo zde na fóru. Děkujeme! --- ## [Vytvoření Shopify napojení pro Mergado Marketplaces](https://help.mergado.com/cs/mergado-marketplaces/vytvoreni-shopify-napojeni-pro-mergado-marketplaces/) # Vytvoření Shopify napojení pro Mergado Marketplaces Pokud si přejete využívat import objednávek pro Shopify, je nutné si nejprve vytvořit napojení na Shopify v Mergado Keychain. > Pokud již máte v Mergado Keychain napojení na Mergado přes API prostřednictvím "vlastní aplikace" v Shopify administraci, stačí si u dané aplikace v Shopify upravit seznam oprávnění viz níže. Tento návod **striktně vychází z oficiální dokumentace Shopify a aktuálního uživatelského rozhraní** pro vytváření aplikací pomocí **Shopify Developer Dashboardu**. **Oficiální zdroje:** https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard > Vytváříte **vlastní (custom) API aplikaci pro jeden konkrétní e‑shop**. Aplikaci **není potřeba** publikovat do Shopify App Store. ## **1. Vytvoření aplikace v Shopify** Aby mělo Mergado Marketplaces API přístup k vašemu Shopify účtu, je nutné si vytvořit aplikaci s potřebnými oprávněními: ### a) Otevřete Shopify Developer Dashboard Do Shopify Developer Dashboardu se můžete dostat dvěma způsoby: **Varianta A: Přímý přístup** 1. Otevřete https://dev.shopify.com/ 2. Přihlaste se pomocí svého Shopify účtu 3. V levém menu otevřete sekci **Apps** **Varianta B: Přes Shopify administraci** 1. Otevřete **Shopify administraci** svého e‑shopu 2. Přejděte do **Settings** → **Apps** 3. Klikněte na **Develop apps** 4. Klikněte na **Build apps in Dev Dashboard** --- ### b) Vytvořte novou aplikaci 1. Ujistěte se, že jste v sekci **Apps** 2. Klikněte na **Create app** 3. Zvolte **Start from Dev Dashboard** 4. Zadejte název aplikace (např. `Mergado integration`) 5. Klikněte na **Create** Po vytvoření aplikace budete přesměrováni na záložku **Versions**. --- ### c) Vytvořte verzi aplikace a nastavte oprávnění (scopes) Každá aplikace musí mít alespoň jednu **verzi**, aby ji bylo možné nainstalovat do e‑shopu. --- ### d) Nastavení přístupových oprávnění 1. V sekci **Access** klikněte na **Select scopes** 2. V modálním okně vyhledejte a zaškrtněte: > Potřebná oprávnění pro Mergado Marketplaces: > * `read_customers` + `write_customers` > * `write_orders` + `read_orders` > * `read_products` > * `read_shipping` + `write_shipping` > * `write_order_edits` + `read_order_edits` > A pokud si chcete přes API také importovat produkty do Mergada, tak přidejte: > * `write_products` > * `read_products` > * `read_markets` 3. Potvrďte kliknutím na **Done** --- ### e) Publikování (release) verze 1. Sjeďte níže na stránce 2. Klikněte na **Release** 3. V potvrzovacím okně můžete název verze ponechat prázdný 5. Potvrďte kliknutím na **Release** Verze aplikace je nyní publikovaná a připravená k instalaci. --- ### f) Nainstalujte aplikaci do e‑shopu 1. V levém menu otevřete **Home** 2. Vpravo nahoře klikněte na **Install app** 3. Vyberte Shopify e‑shop, který chcete propojit s Mergadem 4. Budete přesměrováni do Shopify administrace 7. Instalaci potvrďte kliknutím na **Install** Aplikace je nyní nainstalována v e‑shopu. --- ### 2. Napojení Shopify v Mergado Keychain Pro připojení Shopify v Mergado Keychain je potřeba: * **Shopify URL:** * Otevřete **Shopify administraci** připojeného e‑shopu * V levém menu otevřete **Home** * V sekci **Domains** zkopírujte URL e‑shopu * Příklad: `your-store.myshopify.com` * **Přístupový klíč k Shopify API**: * Vraťte se do **Shopify Developer Dashboardu** * Otevřete svou aplikaci * Přejděte do **Settings** * V sekci **Credentials** zkopírujte hodnotu **Secret** a vložte ji do Mergado Keychain --- ### 3. Aktivace objednávek v Mergado Marketplaces Přejděte do sekce **Objednávky > Aktivace** v Mergado Marketplaces, klikněte na ikonku Shopify a změny uložte. Synchronizaci můžete na stránce aktivace kdykoliv jednoduše pozastavit. Objednávky se synchronizují každých 5 minut. > :information_source: Systém správy objednávek nesynchronizuje zpětně. Nemusíte se tedy bát, že by spuštěním byl váš systém zaplaven všemi předchozími objednávkami. Hotovo! :tada: Od teď už se objednávky budou pravidelně přenášet mezi vašimi marketplaces a Shopify. --- ## [Napojení objednávek do Upgates s Mergado Marketplaces](https://help.mergado.com/cs/mergado-marketplaces/napojeni-objednavek-do-upgates-s-mergado-marketplaces/) # Napojení objednávek do Upgates s Mergado Marketplaces V rozšíření Mergado Marketplaces můžete využít správu objednávek přes Upgates. Pokud provozujete e-shop na Upgates a prodáváte na Allegru nebo Kauflandu, můžete nyní pracovat se svými objednávkami přímo ve své e-shopové administraci. ### Jak aktivovat doplněk v Upgates? První krokem je aktivace oficiálního doplňku ve vaší Upgates administraci. V Upgates přejděte do sekce Doplňky > Seznam doplňků a zde vyhledejte Mergado Marketplaces. Po kliknutí na Aktivovat se vám zobrazí upozornění s přehledem všech oprávnění, která doplněk pro synchronizaci objednávek potřebuje. Odkaz na Mergado Marketplaces doplněk: https://doplnky.upgates.cz/detail/mergado-marketplaces ### Jak vytvořit napojení v Mergado Marketplaces? Po aktivaci doplňku v Upgates se vám přímo v Upgates zobrazí další postup. Důležité je si zkopírovat API token, který naleznete ve spodní části stránky. Tento token následně vložíte v Mergado Marketplaces v sekci Napojení na detailu Upgates do pole API Token. ### Jak nastavit synchronizaci v Mergado Marketplaces? Po úspěšném napojení se zobrazí sekce pro párování Upgates jazykových mutací vašeho eshopu na marketplace prodejní kanály. Pro každý trh můžete napárovat: * Statusy Mergado Marketplaces na vaše statusy objednávek v Upgates * Způsoby plateb a dopravy na vaše hodnoty v Upgates Věnujte pozornost napárování jazykových mutací a statusů objednávek. Bez jejich napárování nebude synchronizace objednávek fungovat ideálním způsobem. Pro vytvoření objednávky v Upgates je povinné uvádět u položek objednávky sazbu DPH. Sazbu DPH si můžete vyplnit v nastavení jednotlivých kampaní pro Allegro i Kaufland. ### Jak aktivovat objednávky? V sekci Objednávky > Aktivace aktivujte synchronizaci objednávek pro Upgates. Pro správné fungování je nutné mít aktivované objednávky i pro alespoň jeden marketplace. --- ## [Co je rozšíření Keychain a jak ho nastavit?](https://help.mergado.com/cs/mergado-keychain/co-je-rozsireni-keychain-a-jak-ho-nastavit/) # Co je rozšíření Keychain a jak ho nastavit? ### Co je Mergado Keychain [Mergado Keychain](https://store.mergado.com/detail/mergadokeychain/#about) je rozšíření, které propojuje váš účet v Mergadu s externími systémy, jako jsou například Heureka, Zboží.cz, Google Analytics, Shopify a mnoho dalších. Funguje jako bezpečný klíč – místo, kde si uložíte přihlašovací údaje k těmto platformám, a Mergado si díky tomu může automaticky stahovat potřebná data pro další rozšíření, jako například [Bidding Fox](https://store.mergado.com/detail/biddingfox.dev/#about) nebo [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about), nebo pro tvorbu statistik a analýz. Jakmile si jednou propojíte své účty z jiných platforem, nemusíte přihlašovací údaje zadávat pokaždé znovu. Mergado se k platformám připojuje samo a udržuje přístup aktuální. ### K čemu je Mergado Keychain potřebné Keychain potřebujete ve chvíli, kdy se rozhodnete používat některá [rozšíření Mergada](https://store.mergado.com/), která pracují s daty z externích platforem, které využíváte. Pokud se tedy například rozhodnete na Heurece biddovat s pomocí rozšíření Bidding Fox, je pro správné fungování Bidding Foxu nutné, abyste v Keychainu nastavili propojení s Heurekou. Propojení v Keychainu je potřeba nastavit také v případě, že chcete u svých projektů na záložce *Analytika* sledovat statistiky a analýzy týkající se vašich prodejů na Heurece nebo Zboží.cz. Zajistíte tak, že Mergado Editor a jeho rozšíření mohou pracovat s aktuálními daty z externích zdrojů. Bez nutnosti ručního přihlašování nebo nahrávání souborů. Díky Keychainu: * máte všechna připojení a přístupové údaje na jednom místě, * nemusíte opakovaně zadávat přístupové údaje k externím platformám do jednotlivých rozšíření, * vaše data z Heureky, Zboží.cz, Google Analytics a dalších systémů se synchronizují automaticky, * všechna připojení jsou šifrovaná a zabezpečená a vaše přístupové údaje nevidí ani pracovníci naší technické podpory. Rozšíření je pro všechny uživatele zcela zdarma a aktivuje se automaticky při vytváření projektu v Mergadu. Napojení na konkrétní platformu je pak potřeba dokončit vyplněním vašich přístupových údajů ke konkrétní platformě. [K čemu slouží jednotlivá napojení v Mergado Keychain, zjistíte v tomto článku.](https://forum.mergado.cz/t/k-cemu-slouzi-jednotliva-napojeni-v-mergado-keychain/k-cemu-slouzi-jednotliva-napojeni-v-mergado-keychain) ### Jak Mergado Keychain funguje Poté, co v Keychainu vyplníte své přihlašovací údaje do vybraného externího systému (např. Heureky), je Keychain uloží, bezpečně zašifruje a zpřístupní je pouze Mergado Editoru a jeho vybraným rozšířením. Díky tomu může Mergado a jeho vybraná rozšíření například načítat data o výkonu kampaní, sledovat prokliky, tržby a konverze, kontrolovat stav kreditu na srovnávačích nebo pracovat s exporty a statistikami z vašich účtů. ### Jak aktivovat Mergado Keychain Keychain se pro každý váš e-shop automaticky aktivuje při vytváření projektu v Mergadu a není potřeba jej spouštět ručně. Propojení s jednotlivými platformami nastavíte následujícím způsobem: 1. Na [hlavní straně](https://app.mergado.com/) Mergado Editoru klikněte na vybraný e-shop, pro který chcete v Keychainu nastavit propojení s externím systémem. 2. Na levé liště uvidíte seznam svých spuštěných rozšíření. Klikněte na Mergado Keychain. 3. V části Spojení vyberte ze seznamu platformu (např. Heureka, Zboží.cz, Google Analytics nebo Shopify), pro kterou chcete vytvořit spojení a klikněte na Vytvořit. 4. Vyplňte požadované údaje a klikněte na Přihlásit. V části Zdroje je přes Keychain do Mergada možné napojit také statický XML soubor. Umožníte tak Mergadu zpracovávat pokročilé informace, jako např. náklady na pořízení zboží nebo kalkulace zisku. ### Jak vyřešit nejčastější problémy #### 1. Keychain hlásí chybu spojení Nejčastěji k tomu dochází z důvodu změny hesla na dané platformě, kvůli dočasnému výpadku služby na straně platformy nebo kvůli vypršení připojení (typicky po delší době nečinnosti nebo změně bezpečnostních pravidel platformy). V takovém případě zrušte v Keychainu stávající propojení, obnovte přihlášení a potvrďte přístup znovu. #### 2. Po změně hesla na Heurece nefunguje připojení Po každé změně přihlašovacích údajů je nutné propojení v Keychainu obnovit, tzn. odhlásit se a znovu přihlásit s novými údaji. #### 3. Spojení se nedaří obnovit Pokud připojení opakovaně selhává, zkuste: 1. přihlášení v anonymním okně, 2. vymazání cache v prohlížeči, 3. ověření, že přihlašovací údaje fungují přímo na platformě. ## FAQ: Co je rozšíření Keychain a jak ho nastavit? ### Co je Mergado Keychain? Mergado Keychain je rozšíření, které propojuje váš Mergado účet s externími platformami, jako jsou například Heureka, Zboží.cz/Sklik, Google Analytics nebo Shopify. Umožňuje bezpečně uložit vaše přihlašovací údaje, aby Mergado Editor a jeho rozšíření (např. Bidding Fox nebo Pricing Fox) mohli pracovat s potřebnými daty z vámi používaných platforem. ### Potřebuji Keychain, i když používám jen Mergado Editor? Pokud při úpravě feedů pracujete pouze s Mergado Editorem, Keychain není vždy nezbytně nutný. Pokud však chcete u projektů pro Zboží.cz nebo Heureku sledovat na záložkách *Přehled* nebo *Analytika* statistiky a analýzy týkající se vašich prodejů, je potřeba nastavit spojení v Keychainu. Spojení v Keychainu je nutné také v případě, že vytváříte projekt, kde jako zdroj svých produktových dat využíváte data z vašeho e-shopu, který provozujete například na e-shopové platformě Shopify nebo UNAS. Propojení v Keychainu je nezbytné pro využívaní rozšíření jako například Pricing Fox, Bidding Fox nebo Mergado Marketplaces. ### Je Mergado Keychain placený? Ne. Rozšíření Mergado Keychain je pro uživatele Mergado Editoru zdarma a aktivuje se automaticky při vytvoření projektu. ### Jak zjistím, že mám Keychain aktivovaný? V Mergadu na stránce [Detaily uživatele](https://app.mergado.com/user/details/) přejděte do části Přístup k rozšířením a zde ve sloupci Pro e-shopy uvidíte Mergado Keychain, který se aktivuje automaticky při vytvoření projektu. Kliknutím na Mergado Keychain se vám zobrazí seznam e-shopů, pro které je Keychain aktivní (to znamená seznam e-shopů, pod kterými máte vytvořeny projekty). Můžete se odtud rovnou prokliknout do konkrétního e-shopu, kde chcete nastavit propojení. ### Jak vytvořím propojení s Heurekou nebo Zboží.cz? 1. Na [hlavní straně](https://app.mergado.com/) Mergado Editoru klikněte na vybraný e-shop, pro který chcete v Keychainu nastavit propojení s externím systémem. 2. Na levé liště uvidíte seznam svých spuštěných rozšíření. Klikněte na Mergado Keychain. 3. V části Spojení vyberte ze seznamu platformu (např. Heureka, Sklik API Fénix, Google Analytics nebo Shopify), pro kterou chcete vytvořit spojení a klikněte na Vytvořit. 4. Vyplňte požadované údaje a klikněte na Přihlásit. ### Lze přes Keychain připojit Sklik? Ano. Pokud chcete Mergadu umožnit přístup k datům z Skliku/Zboží.cz, nastavte v Keychainu spojení pro Sklik API Fénix. ### Co dělat, když se Keychain odpojí nebo hlásí chybu spojení? Nejčastěji k tomu dochází kvůli změně hesla na externí platformě, dočasnému výpadku služby nebo vypršení připojení (např. po delší době nečinnosti). V takovém případě zrušte v Keychainu stávající propojení, znovu se přihlaste a potvrďte přístup. ### Po změně hesla na Heurece mi nefunguje propojení. Co mám dělat? Po každé změně přihlašovacích údajů je potřeba v Keychainu propojení znovu nastavit. Tedy odhlásit se a znovu přihlásit s novým přihlašovacími údaji. To platí nejen pro Heureku, ale i pro všechny další externí systémy, pro které máte v Keychainu vytvořeno propojení. ### Spojení v Keychainu se mi nedaří obnovit, co zkusit dál? Vyzkoušejte tyto kroky: * přihlaste se v anonymním okně prohlížeče, * vymažte cache a cookies, * v případě Heureky ověřte, že vaše přihlašovací údaje fungují přímo v administraci Heureky. ### Jsou moje přihlašovací údaje v bezpečí? Ano. Všechny údaje, které zadáte do Keychainu, jsou šifrované a bezpečně uložené. Nejsou viditelné ani pracovníkům technické podpory Mergada. --- ## [K čemu slouží jednotlivá napojení v Mergado Keychain?](https://help.mergado.com/cs/mergado-keychain/k-cemu-slouzi-jednotliva-napojeni-v-mergado-keychain/) # K čemu slouží jednotlivá napojení v Mergado Keychain? ## 1. Sklik API Fénix Napojení s Sklik API Fénix vytvořte v případě, že využíváte rozšíření, která pro správné fungování potřebují přístup k datům ze Zboží.cz/Skliku, resp. k datům spojeným s inzercí na Seznam Nákupech. Napojení vytvořte i pokud nevyužíváte žádné rozšíření, ale chcete v projektu na stránce *Analytika* v přehledných grafech sledovat například vývoj ceny za inzerci nebo prokliky. Získávaná data slouží výhradně k analytickým a optimalizačním účelům. Mergado nezískává přístup k osobním údajům zákazníků ani k detailům jednotlivých objednávek. ### Rozšíření, která pro přístup k datům z Skliku vyžadují nastavení spojení v Keychainu * [Pricing Fox](https://store.mergado.com/detail/pricingfox) – Aby mohl Pricing Fox získávat a zpracovávat data o konkurenci (cena, skladová dostupnost, pozice v biddingu, jaké dávají dárky k nákupu, kdo jsou jejich výrobci, v jakých kategoriích prodávají) a získávat statistiky o výkonu produktů, je potřeba vytvořit spojení vložením Sklik API Fénix do Keychainu. * [Bidding Fox](https://store.mergado.com/detail/biddingfox) – Aby mohl Bidding Fox získávat a zpracovávat data o pozicích na produktových kartách, cenách produktů a dopravy, dostupnosti konkurence a získávat statistiky o výkonu produktů, je potřeba vytvořit spojení vložením Sklik API Fénix do Keychainu. * [Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements) – Aby mohl Bidding Fox Elements získávat a zpracovávat statistiky o výkonu vaší inzerce, je potřeba vytvořit spojení vložením Sklik API Fénix do Keychainu. ### Jak vytvořit spojení v Keychainu 1. V Keychainu v nabídce Spojení najděte Sklik API Fénix a klikněte na Vytvořit. 2. Zadejte ID Provozovny a API Fénix klíč, který získáte ve svém Sklik účtu. Přesný postup, [jak získat API Fénix klíč najdete v nápovědě na stránkách Skliku](https://napoveda.sklik.cz/pokrocila-prace-s-daty/sklik-api/#api-fenix-klic). * Pro vygenerování API klíče je nutné se do Skliku přihlásit přímo účtem a heslem, pro který chcete vygenerovat API klíč. Nestačí se přihlásit pouze jako Administrátor účtu. 3. Klikněte na Uložit, čímž se vytvoří spojení. ## 2. Heureka Napojení s Heurekou vytvořte v případě, že využíváte rozšíření, která pro správné fungování potřebují přístup k datům z Heureky. Napojení vytvořte i pokud nevyužíváte žádné rozšíření, ale chcete v projektu na záložce *Analytika* sledovat výkonnost vaší inzerce na Heurece. Najdete pak zde statistiky a grafy týkající se: * tržeb, * ceny za inzerci, * prokliků, * konverzí, * zisku, * produktů se statistikami, * konverzního poměru, * průměrného CPC, * průměrného CPO, * průměrného PNO, * průměrné hodnoty konverze, * průměrného zisku z konverze. Vytvořením spojení v Keychainu se také záložka *Přehled* rozšíří o statistiky týkající se: * spárovanosti produktů, * počtu e-shopů na produktové kartě, * počtu prokliků, * objednávek, * tržeb. Po vytvoření spojení v Keychainu bude mít Mergado přístup k vybraným statistickým datům z vašeho účtu na Heurece. Konkrétně se jedná o: ### Výkonnostní data * počet prokliků * náklady na prokliky (CPC) * počet objednávek * tržby * zisk a podíl nákladů na obratu (PNO) * počet produktů zahrnutých do statistiky * počet produktů bez dostupných statistických dat ### Údaje o stavu účtu * výše kreditu a jeho stav * informace o aktivním PPC režimu * informace o certifikaci (např. Ověřeno zákazníky) * informace, zda obchod odpovídá na zákaznické dotazy * dostupnost produktového XML feedu * kontaktní údaje uvedené v administraci Heureky * logo obchodu * počet zahraničních mutací účtu ### Souhrnné statistiky účtu * celkové náklady * celkový počet prokliků Načítaná data slouží výhradně pro statistické účely, vyhodnocování výkonnosti produktů a optimalizaci kampaní. Mergado nezískává přístup k osobním údajům zákazníků ani k detailům jednotlivých objednávek. ### Rozšíření, která pro přístup k datům z Heureky vyžadují nastavení spojení v Keychainu * [Pricing Fox](https://store.mergado.com/detail/pricingfox) – Aby mohl Pricing Fox získávat a zpracovávat data o konkurenci (cena, skladová dostupnost, pozice v biddingu, jaké dávají dárky k nákupu, kdo jsou jejich výrobci, v jakých kategoriích prodávají), je potřeba vytvořit spojení v Keychainu a vložit Heureka API klíč přímo do rozšíření Pricing Fox. * [Bidding Fox](https://store.mergado.com/detail/biddingfox) – Aby mohl Bidding Fox získávat data ze Sortiment reportu Heureky a zpracovávat statistiky o výkonu vaší inzerce a aktuální informace z produktové karty, je potřeba vytvořit spojení v Keychainu a vložit Heureka API přímo do rozšíření Bidding Fox. * [Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements) – Aby mohl Bidding Fox Elements získávat data ze Sortiment reportu Heureky a zpracovávat statistiky o výkonu vaší inzerce, je potřeba vytvořit spojení v Keychainu a vložit Heureka API přímo do rozšíření Bidding Fox Elements. * [Pricing Rank](https://store.mergado.com/detail/pricingrank) – Aby mohl Pricing Rank získávat a zpracovávat data ze Sortiment reportu Heureky, je potřeba vytvořit spojení v Keychainu. * [Heureka Watchdog](https://store.mergado.com/detail/heurekawatchdog) – Aby mohl Heureka Watchdog odhalit nespárované zboží, najít produkty, které jsou na kartách osamocené nebo odhalit další chyby, které brání inzerci, je potřeba vytvořit spojení v Keychainu. * [Pricing Monitor](https://store.mergado.com/detail/pricingmonitor) – Aby mohl Pricing Monitor sledovat a analyzovat ceny vašeho zboží v porovnání s konkurencí, je potřeba vytvořit spojení v Keychainu. * [Credito](https://store.mergado.com/detail/credito) – Aby mohlo Credito kontrolovat stav vašeho kreditu, je potřeba vytvořit spojení v Keychainu. ### Jak vytvořit spojení v Keychainu 1. V Keychainu v nabídce Spojení najděte Heureka a klikněte na Vytvořit. 2. Zadejte stejné přihlašovací údaje (e-mail a heslo), kterými se přihlašujete do administrace vašeho Heureka účtu. * Pokud si ve svém Heureka účtu změníte přihlašovací údaje, nezapomeňte aktualizovat údaje také zde, jinak vám bude Keychain hlásit chybu spojení. Spojení zrušte a znovu jej vytvořte s novými přihlašovacími údaji. 3. Zvolte, zda chce vytvořit spojení pro českou nebo slovenskou Heureku. 4. Klikněte na Uložit, čímž se vytvoří spojení. ## 3. Google Analytics 4 Toto napojení vytvořte v případě, že využíváte rozšíření, která pro správné fungování potřebují přístup k datům z Google Analytics 4. Napojení vytvořte i pokud nevyužíváte žádné z následujcícíh rozšíření, ale chcete ve svých projektech na záložkách Analytika a Přehled sledovat analýzy a výkonnost vaší inzerce. Konkrétně zde bude Mergado zobrazovat získaná data o: * počtu návštěv/kliknutí, * počtu objednávek, * celkové hodnotě objednávek. ### Rozšíření, která pro přístup k datům z Google Analytics 4 vyžadují nastavení spojení v Keychainu * [Pricing Fox](https://store.mergado.com/detail/pricingfox) * [Bidding Fox](https://store.mergado.com/detail/biddingfox) * [Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements) * [Fox Data+](https://store.mergado.com/detail/foxplus) ### Jak vytvořit spojení v Keychainu 1. V Keychainu v nabídce Spojení najděte Google Analytics 4 a klikněte na Vytvořit. 2. Přihlašte se pomocí svého Google účtu a odsouhlaste přístup Mergadu k vašim datům, čímž se vytvoří spojení. ## 4. Google Tabulky Propojení vám umožní export výstupního feedu z Mergada do Google Tabulek na vašem Google Disku. ### Jak vytvořit spojení v Keychainu 1. V Keychainu v nabídce Spojení najděte Google Tabulky a klikněte na Vytvořit. 2. Přihlašte se pomocí svého Google účtu a odsouhlaste přístup Mergadu k vašim datům, čímž se vytvoří spojení. Pokud potřebujete naopak importovat data z vašich Google Tabulek do Mergada, není potřeba vytvářet spojení v Keychainu, ale je nutné u vybrané tabulky [správně nastavit sdílení tabulky jako CSV](https://support.google.com/docs/answer/183965?hl=cs). ## 5. Shopify Toto napojení vytvořte v případě, že svůj e-shop provozujete na e-shopové platformě Shopify a chcete svá produktová data dostat do projektu v Mergado Editoru. Napojení budete potřebovat také v případě, že se rozhodnete používat rozšíření [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts). Díky napojení může [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) synchronizovat objednávky z online tržišť a každých 5 minut je automaticky přenášet přímo do vašeho e-shopu, odkud je můžete pohodlně spravovat společně s objednávkami z vašeho e-shopu. Pro vytvoření spojení v Keychainu budete potřebovat Client ID a Client Secret. Jak vygenerovat tyto potřebné Shopify API credentials najdete v článku [Nový projekt - Vygenerování Shopify API credentials](https://forum.mergado.cz/t/novy-projekt-vygenerovani-shopify-api-credentials/jak-zajistit-napojeni-e-shopove-platformy-shopify-na-mergado-editor). ### Jak vytvořit spojení v Keychainu 1. V Keychainu v nabídce Spojení najděte Shopify a klikněte na Vytvořit. 2. Vyplňte Shopify Store URL pro Admin API. * Nejde o běžnou URL vašeho e-shopu. Jedná se o adresu Shopify store pro API komunikaci. Tato adresa je ve tvaru store-name.myshopify.com. * Store-name najdete v administraci Shopify v URL. Příklad: admin.shopify.com/store/{store-name}/ 3. Vyplňte Client ID. 4. Vyplňte Client Secret. 5. Klikněte na Přihlásit, čímž se vytvoří spojení. ## 6. UNAS Toto napojení vytvořte v případě, že svůj e-shop provozujete na e-shopové platformě Shopify a chcete svá produktová data dostat do projektu v Mergado Editoru. Napojení budete potřebovat také v případě, že se rozhodnete používat rozšíření [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts). Díky napojení může Mergado Marketplaces synchronizovat objednávky z online tržišť a každých 5 minut je automaticky přenášet přímo do vašeho e-shopu, odkud je můžete pohodlně spravovat společně s objednávkami z vašeho e-shopu. Pro vytvoření spojení v Keychainu budete potřebovat API klíč. Jak v UNAS vygenerovat potřebný API klíč, najdete v článku [Jak zajistit napojení e-shopové platformy UNAS na Mergado Editor](https://forum.mergado.cz/t/jak-zajistit-napojeni-e-shopove-platformy-unas-na-mergado-editor/jak-zajistit-napojeni-e-shopove-platformy-unas-na-mergado-editor). ### Jak vytvořit spojení v Keychainu 1. V Keychainu v nabídce Spojení najděte UNAS a klikněte na Vytvořit. 2. Vyplňte Název obchodu (ID). 3. Vyplňte API klíč. 4. Klikněte na Uložit, čímž se vytvoří spojení. --- ## [Jaké IP adresy používá Mergado a jeho rozšíření?](https://help.mergado.com/cs/bezpecnost-a-technicke-pozadavky/jake-ip-adresy-pouziva-mergado-a-jeho-rozsireni/) # Jaké IP adresy používá Mergado a jeho rozšíření? ## Proč byste měli znát IP adresy Mergada Pokud máte svůj e-shop nebo server, odkud poskytujete datové feedy, chráněné a přístup k nim ověřujete pomocí whitelistu IP adres (tj. povolujete přístup pouze z konkrétních adres), potřebujete znát, z jaké IP adresy k nim bude Mergado a jeho rozšíření přistupovat. Pokud tyto IP adresy nepovolíte, Mergado nebude moci stáhnout váš feed a rozšíření nebudou fungovat správně. ## Jaká je IP adresa Mergada Pro fungování samotného Mergado Editoru stačí, pokud povolíte následující IP adresu: #### 81.31.39.112 ## Jaké jsou IP adresy Mergado rozšíření Pokud se rozhodnete začít používat některé z Mergado rozšíření, které si můžete aktivovat v [Mergado Storu](https://store.mergado.com/?lang=cs), je potřeba, abyste na svůj whitelist přidali také příslušnou IP adresu daného rozšíření: |Rozšíření|IP adresa| | --- | --- | |[Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about)|81.31.39.116| |[Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements/?lang=cs#about)|81.31.39.116| |[Blending Bull](https://store.mergado.com/detail/blendingbull/?lang=cs#about)|178.238.44.169| |[Credito](https://store.mergado.com/detail/credito/?lang=cs#about)|178.238.44.138| |[Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about)|81.31.39.116| |[Fox Data+](https://store.mergado.com/detail/foxplus/?lang=cs#about)|81.31.39.116| |[Heureka Watchdog](https://store.mergado.com/detail/heurekawatchdog/?lang=cs#about)|178.238.44.138| |[Kvinono](https://store.mergado.com/detail/kvinono/?lang=cs#about)|81.31.39.114| |[Mergado Agencies](https://store.mergado.com/detail/mergadoagencies/?lang=cs#about)|81.31.39.114| |[Mergado Dashboards](https://store.mergado.com/detail/mergadodashboards/?lang=cs#about)|81.31.39.114| |[Mergado Drive](https://store.mergado.com/detail/mergadodrive/?lang=cs#about)|178.238.44.165| |[Mergado Files](https://store.mergado.com/detail/files/?lang=cs#about)|178.238.44.163| |[Mergado Keychain](https://store.mergado.com/detail/mergadokeychain/?lang=cs#about)|81.31.39.112| |[Mergado Logbook](https://store.mergado.com/detail/logbook/?lang=cs#about)|178.238.44.138| |[Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts/?lang=cs#about)|81.31.39.114| |[Mergado Notifications](https://store.mergado.com/detail/mergadonotifications/?lang=cs#about)|81.31.39.114| |[Mergado Orders](https://store.mergado.com/detail/mergadoorders/?lang=cs#about)|81.31.39.114| |[Mergado Pages](https://store.mergado.com/detail/pages/?lang=cs#about)|178.238.44.138| |[Mergado Sources](https://store.mergado.com/detail/clickinggoat/?lang=cs#about)|81.31.39.114| |[Mergado ToDo List](https://store.mergado.com/detail/todo/?lang=cs#about)|178.238.44.138| |[Mergado Translate](https://store.mergado.com/detail/ordelogytranslate/?lang=cs#about)|81.31.39.114| |[Pairing Bear](https://store.mergado.com/detail/pairingbear/?lang=cs#about)|81.31.39.112| |[PPC Wolf](https://store.mergado.com/detail/ppcwolf/?lang=cs#about)|178.238.44.164| |[Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about)|81.31.39.116| |[Pricing Monitor](https://store.mergado.com/detail/pricingmonitor/?lang=cs#about)|178.238.44.138| |[Pricing Rank](https://store.mergado.com/detail/pricingrank/?lang=cs#about)|178.238.44.138| |[Repairman](https://store.mergado.com/detail/xmlrepairman/?lang=cs#about)|178.238.44.138| |[Scraping Camel](https://store.mergado.com/detail/scrapingcamel/?lang=cs#about)|178.238.44.145| |[Seznam Index Checker](https://store.mergado.com/detail/seznamindexchecker/?lang=cs#about)|178.238.44.138| |[Symlink Stork](https://store.mergado.com/detail/symlinkstork/?lang=cs#about)|178.238.44.138| |[URL Checker](https://store.mergado.com/detail/urlchecker/?lang=cs#about)|178.238.44.138| ## FAQ: Jaké IP adresy používá Mergado a jeho rozšíření? ### Proč potřebuju znát IP adresu Mergada? Pokud je váš vstupní feed chráněn tzv. whitelistem IP adres, musíte mezi povolené adresy přidat i tu, ze které Mergado stahuje váš feed. Jinak se Mergado k vašim datům nedostane a projekt nebude možné zpracovat. ### Co dělat, když mám feed chráněný whitelistem a Mergado jej nedokáže stahovat? Pokud máte svůj vstupní feed zabezpečený tzv. whitelistem IP adres, znamená to, že přístup k feedu je povolen pouze z předem určených IP adres. Aby Mergado mohlo feed načíst, musí být mezi povolenými adresami také ta, ze které Mergado k vašemu feedu přistupuje. Přidejte tedy na whitelist IP adresu 81.31.39.112. V případě, že používáte i některá rozšíření Mergada, zkontrolujte, zda není potřeba na whitelist přidat také jejich IP adresu (pokud se liší od IP adresy Mergada). ### Stačí povolit jen jednu IP adresu, nebo musím přidat všechny? Pokud používáte pouze Mergado Editor (bez rozšíření), stačí povolit IP adresu 81.31.39.112. Pokud ale využíváte některá rozšíření (např. Bidding Fox, Pricing Fox, Feed Image Editor), je nutné přidat na whitelist i IP adresy těchto rozšíření. ### Co mám udělat, když Mergado hlásí, že se feed nepodařilo stáhnout? Zkontrolujte: 1. zda je IP adresa 81.31.39.112 uvedena ve whitelistu vašeho e-shopu, 2. zda server neblokuje přístup kvůli SSL nebo certifikátu, 3. že feed není chráněn současně více způsoby (např. whitelist + hash, což bývá častá chyba u Shoptet feedů). ### Mění se IP adresy Mergada často? Ne. IP adresy Mergada jsou stabilní a změny se dějí jen výjimečně. V případě změny informaci o tom vždy včas zveřejníme na našem [fóru](https://forum.mergado.cz/). ### Jak zjistím, že Mergado feed opravdu stahuje? V projektu v Mergadu přejděte na stránku Historie a zde si v kolonce Typ události vyfiltrujte Stahování. Uvidíte tak záznamy o každém pokusu o stažení feedu včetně času a IP adresy, ze které k němu došlo. To vám pomůže ověřit, zda přístup funguje správně. --- ## [Je možné v Mergadu zabezpečit výstupní feed?](https://help.mergado.com/cs/bezpecnost-a-technicke-pozadavky/je-mozne-v-mergadu-zabezpecit-vystupni-feed/) # Je možné v Mergadu zabezpečit výstupní feed? ### Proč zabezpečit výstupní feed Výstupní feed z Mergada obsahuje všechna data, která po úpravách odesíláte na inzertní platformy (např. Heureku, Google nebo Facebook). Přestože tento feed obvykle čte pouze platforma, které ho předáte, je pochopitelné, že chcete data o své inzerci chránit a nechcete, aby se k nim dostal někdo nepovolaný. ### Jak Mergado chrání výstupní feedy Mergado sice neumožňuje zabezpečit výstupní feed heslem (HTTP autentizace), nicméně přístup k výstupním feedům je přirozeně omezen díky jejich unikátní a nedohledatelné URL. #### 1. Dlouhý hash v adrese Každý výstupní feed, který Mergado vygeneruje, má jedinečnou URL adresu obsahující dlouhý bezpečnostní klíč (hash). Tento hash není možné odhadnout a tím pádem feed není veřejně dohledatelný ani indexovatelný vyhledávači. Váš výstupní feed bude vypadat například nějak takto: https://data.mergado.com/12345/export_87f14aab7e9d4c21.xml URL vašeho výstupního feedu tedy budou znát pouze ti, kterým adresu nasdílíte (např. reklamní platforma pro kterou je výstupní feed určen). #### 2. Přístup přes zabezpečené HTTPS Veškerá komunikace mezi Mergadem a cílovými platformami probíhá přes šifrovaný protokol HTTPS, takže data z feedu nelze číst ani zachytit během přenosu. #### 3. Logování přístupů Mergado zaznamenává historii stahování feedů (včetně datumu, času, IP adresy a odpovědi serveru). Díky tomu můžete sledovat, zda feed stahují pouze očekávané platformy, nebo zda k němu přistupuje někdo neoprávněný. Informace o stahování projektů najdete na stránce Historie u jednotlivých projektů, kde si můžete ze zaznamenaných událostí vyfiltrovat pouze Stahování a zjistit tak, kdy a kdo výstupní feed stahoval. *TIP! Pro usnadnění vyhledávání doporučujeme stáhnout si vyfiltrovanou historii stahování do CSV souboru a následně si jej otevřít například v Excelu, kde si pak budete moci vyhledávat například konkrétní user-agenty, snadno si data seskupíte nebo dále vyfiltrujete.* #### 4. Ochrana pomocí rozšíření Symlink Stork Pokud chcete mít plnou kontrolu nad tím, kdo se dostane k vašemu výstupnímu feedu, můžete využít rozšíření[ Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about). To vám umožní povolit přístup k URL vašeho výstupního pouze z vybrané IP adresy. Více o Symlink Storku a této funkci se dozvíte [tady](https://forum.mergado.cz/t/symlink-stork-news/1386/6). ### Jak získat novou URL výstupního feedu u stávajícího projektu V Nastavení projektu je možné vygenerovat si pro stávající URL nový bezpečnostní klíč (hash). Změní se tedy 32-znakový náhodný řetězec v původní URL. Pro vygenerování nového hashe: 1. Ve vybraném projektu přejděte na stránku *Nastavení*. 2. U kolonky *Výstupní feed* klikněte na ikonku tužky. 3. Zaškrtněte políčko *Vím, co dělám*. 4. Potvrďte kliknutím na *Vygenerovat novou URL*. 5. Změna výstupní adresy se projeví až po provedení dalšího exportu dat. Pokud nechcete čekat na automatické přegenerování dat, spusťte export dat manuálně. Přejděte na stránku *Nastavení*, tam v záložce *Přegenerování* klikněte na *Spustit export*. Poté, co se export dokončí, uvidíte na stránce *Přehled* aktualizovanou URL výstupního feedu. *TIP! Změna URL adresy výstupního feedu má vliv na všechny návazné služby. Nezapomeňte tedy zkontrolovat služby, kde tuto URL používáte a případně ji na příslušných místech aktualizovat.* Další možností, jak můžete získat zcela nové URL výstupního feedu, je duplikace projektu a následné smazání toho původního. Při duplikaci se z původního projektu přenesou téměř všechny informace, ale pro duplikovaný projekt se vytvoří nová unikátní URL výstupního feedu. Původní projekt pak můžete smazat (čímž zanikne i URL jeho výstupního feedu) a nahradit původní URL na inzertních kanálech novou. Více o duplikaci projektu si můžete přečíst v [tomto článku](https://forum.mergado.cz/t/jak-v-mergadu-duplikovat-projekt/jak-v-mergadu-duplikovat-projekt). ## FAQ: Je možné v Mergadu zabezpečit výstupní feed? ### Je možné zaheslovat výstupní feed? Ne, výstupní feedy v Mergadu nelze zabezpečit heslem (např. pomocí HTTP autentizace). Jsou však chráněné svým unikátním odkazem, který není možné uhodnout ani dohledat veřejně přes vyhledávače. ### Jak je chráněn výstupní feed? Každý výstupní feed má vlastní unikátní URL, která obsahuje dlouhý bezpečnostní klíč (tzv. hash). Díky tomu není feed indexovatelný a odkaz znají pouze ti, komu ho sami sdílíte (např. Heureka, Google, Facebook). Navíc Mergado přenáší všechna data přes šifrovaný HTTPS protokol, takže je během přenosu nikdo nemůže číst. ### Dá se zjistit, kdo výstupní feed stahuje? Ano. Na stránce Historie u každého projektu si můžete zobrazit záznamy o stahování feedů, tedy kdy byly staženy, z jaké IP adresy a jakou odpověď server vrátil. Díky tomu můžete zkontrolovat, jestli feed stahují jen očekávané systémy (např. Heureka, Google) nebo někdo cizí. Historii stahování si můžete také vyfiltrovat a exportovat do CSV pro další analýzu. ### Co když chci, aby měl výstupní feed novou adresu? Novou adresu výstupního feedu můžete získat dvěma způsoby: ##### 1. Vygenerováním nového bezpečnostního klíče (hashe): V projektu přejděte do *Nastavení* a u kolonky *Výstupní feed* a klikněte na ikonku tužky. Zaškrtněte možnost *Vím, co dělám* a potvrďte kliknutím na *Vygenerovat novou URL*. Tím se změní 32-znakový bezpečnostní klíč v původní URL. Změna adresy se projeví po dalším exportu dat. Pokud nechcete čekat na automatické přegenerování, můžete export spustit ručně v *Nastavení* → *Přegenerování* → *Spustit export*. Po dokončení exportu najdete aktualizovanou URL na stránce *Přehled*. *Tip: Změna URL ovlivní všechny služby, které tuto adresu používají (např. inzertní platformy nebo analytické systémy). Nezapomeňte ji proto na těchto místech aktualizovat.* ##### 2. Vytvořením duplikátu projektu: Pokud potřebujete zcela novou URL, můžete projekt duplikovat. Nový projekt si zachová většinu nastavení, ale získá novou unikátní adresu výstupního feedu. Původní projekt poté můžete smazat, čímž zanikne i URL výstupního feedu, a nahradit ji novou adresou v inzertních kanálech. Více o duplikaci projektu najdete v tomto [článku článku](https://forum.mergado.cz/t/jak-v-mergadu-duplikovat-projekt/jak-v-mergadu-duplikovat-projekt). ### Proč Mergado neumožňuje klasické zaheslování? Zaheslování by znemožnilo přímý přístup inzertním systémům (např. Heurece nebo Googlu), které se k feedu připojují automaticky a neumí zadávat přihlašovací údaje. Unikátní adresa s hashem proto představuje bezpečnější a univerzálnější řešení, které neomezuje funkčnost vašich kampaní. ### Můžu přístup k výstupnímu feedu omezit jen na určité IP adresy? Ano, můžete. Pokud chcete, aby se k vašemu výstupnímu feedu dostaly pouze konkrétní servery, využijte rozšíření[ Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about). To vám umožní nastavit, že se k výstupnímu feedu dostanou jen vybrané IP adresy, ostatní pokusy o přístup budou zablokovány. Zajistíte si tak maximální kontrolu nad tím, kdo vaše data může stahovat. --- ## [Dokáže Mergado stahovat i zabezpečené feedy?](https://help.mergado.com/cs/bezpecnost-a-technicke-pozadavky/dokaze-mergado-stahovat-i-zabezpecene-feedy/) # Dokáže Mergado stahovat i zabezpečené feedy? Nechcete riskovat, že se k vašim produktovým datům dostane někdo, kdo nemá, a zároveň přemýšlíte, jak to udělat, aby k nim mělo Mergado přístup? Nemusíte dělat kompromisy mezi bezpečím a snadnou správou dat. Ukážeme vám, jak to udělat, aby si Mergado poradilo i s vaším zabezpečeným vstupním feedem. ### Jaké jsou možnosti zabezpečení vstupního feedu #### 1. HTTP autentizace (uživatelské jméno + heslo) Pokud je váš feed chráněn přihlášením, Mergado jej zvládne načíst pouze v případě, že v URL feedu uvedete přihlašovací údaje. Feed vložte do Mergada v tomto tvaru: https://uzivatel:heslo@www.vas-eshop.cz/feed.xml (kdy část za znakem @ je URL vašeho feedu). ##### a. Vytvářím nový projekt Při tvorbě nového projektu vložte URL vstupního feedu ve tvaru https://uzivatel:heslo@www.vas-eshop.cz/feed.xml ##### b. Zabezpečil/a jsem vstupní feed u již existující projektu Pokud jste se rozhodli zaheslovat dříve nezabezpečený vstupní feed u již existujícího projektu v Mergadu, stačí když v daném projektu vyměníte původní URL vstupního feedu za URL ve tvaru https://uzivatel:heslo@www.vas-eshop.cz/feed.xml Vstupní feed vyměníte v Nastavení projektu: * V Mergadu přejděte do projektu, kde jste jako vstupní feed použili feed, který jste nově zabezpečili heslem. * V levé menu klikněte na Nastavení. * V záložce Obecná nastavení projektu v kolonce Vstupní feed vyměňte původní URL za URL ve tvaru https://uzivatel:heslo@www.vas-eshop.cz/feed.xml * Klikněte na Uložit. * Následně doporučujeme spustit přegenerování projektu (na stejné stránce Nastavení klikněte na záložku Přegenerování a zde na Přegenerovat vše) a zkontrolovat výstupní data. #### 2. Omezení přístupu na základě IP adres (whitelist) Pokud máte svůj feed chráněn tvz. whitelistem, tedy že je přístupný pouze pro konkrétní předem povolené IP adresy, je potřeba, abyste na whitelist (seznam povolených IP adres) přidali IP adresu Mergada. Mergado bude váš vstupní feed stahovat z následující IP adresy: 81.31.39.112 #### 3. Zabezpečení pomocí hashe (tajného klíče v URL) Možná máte svůj feed zabezpečený tzv. hashem, tedy dlouhým řetězcem znaků, který funguje jako přístupový klíč. Díky tomu není feed veřejně dohledatelný, ale Mergado jej bez problému načte. Stačí do Mergada vložit URL vstupního feedu, která bude obsahovat také hash. Například: https://www.vas-eshop.cz/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a V případě, že jste se rozhodli pomocí hashe zabezpečit vstupní feed u již dříve vytvořeného projektu v Mergadu, stačí v daném projektu vyměnit stávající URL vstupního feedu za URL, která bude obsahovat hash. Vstupní feed vyměníte v Nastavení projektu: * V Mergadu přejděte do projektu, kde jste jako vstupní feed použili feed, který jste nově zabezpečili hashem. * V levé menu klikněte na Nastavení. * V záložce Obecná nastavení projektu v kolonce Vstupní feed vyměňte původní URL za URL ve tvaru https://www.vas-eshop.cz/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a * Klikněte na Uložit. * Následně doporučujeme spustit přegenerování projektu (na stejné stránce Nastavení klikněte na záložku Přegenerování a zde na Přegenerovat vše) a zkontrolovat výstupní data. ### Zabezpečení Shoptet feedů Stalo se vám, že Mergado nechce stahovat vstupní feed ze Shoptetu? Problém bude pravděpodobně v nastavení zabezpečení. V administraci Shoptetu je možné xml feedy zabezpečit dvě způsoby: a. Omezením přístupu na základě IP adres (whitelistem) b. Zabezpečením pomocí hashe Mergado si s prvním i druhým způsobem zabezpečení dokáže poradit, avšak problém nastává, pokud máte svůj Shoptet feed chráněn oběma způsoby najednou. Je tedy potřeba, abyste v administraci svého Shoptet účtu povolili pouze jeden způsob zabezpečení a podle zvoleného způsobu následně buď přidali IP adresu Mergada na whitelist, nebo vložili do Mergada URL vstupního feedu, která bude obsah hash. Postup: 1. Přihlašte se do svého Shoptet účtu. 2. V administraci klikněte v levém menu na *Propojení* a následně na *XML feedy*. 3. Klikněte na záložku *Zabezpečení*. 4. V části *Ochrana přístupu* zaškrtněte pouze jeden vybraný způsob zabezpečení. 5. Vybrané nastavení uložte. ## FAQ: Dokáže Mergado stahovat i zabezpečené feedy? ### Poradí si Mergado se zaheslovaným feedem? Ano. Mergado dokáže načíst feed, který je chráněný uživatelským jménem a heslem (tzv. HTTP autentizací). Stačí do Mergada vložit URL vstupního feedu ve tvaru: https://uzivatel:heslo@www.vas-eshop.cz/feed.xml Pokud jste feed zaheslovali až po vytvoření projektu, vyměňte původní URL za tuto novou v Nastavení projektu. ### Můžu zaheslovat vstupní feed u již existujícího projektu? Ano. V případě, že jste se rozhodli chránit vstupní feed pomocí hesla, je potřeba u daného projektu vyměnit původní URL vstupního feedu za URL, která bude obsahovat uživatelské jméno a heslo, kterým jste feed zabezpečili. Nové URL tedy bude ve tvaru: https://uzivatel:heslo@www.vas-eshop.cz/feed.xml URL vstupního feedu vyměníte následujícím způsobem: 1. V Mergadu přejděte do projektu, kde jste jako vstupní feed použili feed, který jste nově zabezpečili heslem. 2. V levém menu klikněte na Nastavení. 3. V záložce Obecná nastavení projektu v kolonce Vstupní feed vyměňte původní URL za URL ve tvaru https://uzivatel:heslo@www.vas-eshop.cz/feed.xml 4. Klikněte na Uložit. 5. V záložce Přegenerování klikněte na Přegenerovat vše a zkontrolujte, zda se data načítají správně. ### Můžu zabezpečit vstupní feed pomocí hashe u už existujícího projektu? Ano. V případě, že jste se rozhodli chránit vstupní feed pomocí hashe, je potřeba u daného projektu vyměnit původní URL vstupního feedu za URL, která bude obsahovat hash. Nové URL tedy bude ve tvaru: https://www.vas-eshop.cz/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a URL vstupního feedu vyměníte následujícím způsobem: 1. V Mergadu přejděte do projektu, kde jste jako vstupní feed použili feed, který jste nově zabezpečili hashem. 2. V levém menu klikněte na Nastavení. 3. V záložce Obecná nastavení projektu v kolonce Vstupní feed vyměňte původní URL za URL ve tvaru https://www.vas-eshop.cz/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a 4. Klikněte na Uložit. 5. V záložce Přegenerování klikněte na Přegenerovat vše a zkontrolujte, zda se data načítají správně. ### Můj feed má omezení přístupu jen pro určité IP adresy. Co s tím? Pokud pro zabezpečení svého feedu používáte tzv. whitelist, je nutné, abyste na něj přidali IP adresu Mergada. Mergado stahuje feedy z IP adresy: 81.31.39.112 ### Mám feed zabezpečený hashem. Zvládne jej Mergado stáhnout? Ano. Stačí vložit do Mergada plnou adresu včetně hashe (např.: https://www.vas-eshop.cz/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a). Mergado hash rozpozná a feed bez problému načte. ### Mergado nechce načíst feed ze Shoptetu. Co s tím? Zkontrolujte nastavení zabezpečení v administraci Shoptetu. Shoptet umožňuje dva typy ochrany: * omezení přístupu podle IP adres (whitelist), * zabezpečení pomocí hashe. Pokud máte aktivní oba způsoby zároveň, Mergado se k feedu nedostane. Nechte zapnutý pouze jeden způsob a na základě vybraného zabezpečení buď přidejte IP adresu Mergada na whitelist, nebo do Mergada vložte URL s hashem. Postup v Shoptetu: 1. Přihlaste se do administrace. 2. Klikněte na Propojení → XML feedy → Zabezpečení. 3. V části Ochrana přístupu zaškrtněte jen jeden způsob zabezpečení. 4. Nastavení uložte. --- ## [Přístup k demo prostředí](https://help.mergado.com/cs/pro-vyvojare/pristup-k-demo-prostredi/) # Přístup k demo prostředí # Přístup k demo prostředí Tato nápověda vás provede vytvořením vlastní aplikace pro Mergado Store, její napojením na Mergado API a bezpečným testováním přímo v Mergadu bez nutnosti platby. Mergado umožňuje vývojářům tvořit vlastní integrace („appky“), které rozšiřují funkce editoru nebo komunikují s jeho API. Oficiální „demo prostředí“ s předem nahranými daty neexistuje — místo toho si během pár kroků připravíte vlastní testovací projekt. --- ## Postup krok za krokem ### 1) Založte si účet v Mergadu Pokud účet ještě nemáte, vytvořte si ho na **app.mergado.com**. ### 2) Vytvořte vlastní aplikaci (appku) 1. Otevřete: **[https://app.mergado.com/developers/create-app/](https://app.mergado.com/developers/create-app/)** 2. Vyplňte základní údaje o aplikaci. 3. Po vytvoření získáte přístupové údaje (respektive přístup k entitám, u kterých je appka zapnutá). ### 3) Připravte testovací projekt *(pokud appka pracuje na úrovni projektu)* 1. V Mergadu založte **nový projekt** pro testování. 2. Nahrajte do něj **testovací feed** – stačí váš **malý feed** s několika produkty. 3. V **nastavení projektu** přepněte projekt do **testovacího režimu**, aby se za testování **neplatilo**. ### 4) Zapněte appku na projektu V **nastavení projektu** povolte (zapněte) vaši appku. Tím získá přístup k **entitám** (feedům/projektům), které má právo číst a upravovat. ### 5) Autorizace a volání API * Postup autorizace: **[https://mergado.github.io/docs/api/authorization.html](https://mergado.github.io/docs/api/authorization.html)** * Dokumentace API: **[https://mergado.docs.apiary.io/#](https://mergado.docs.apiary.io/#)** > **Pozor na verzi API:** Používaná verze ovlivňuje chování endpointů. Pokud verze nesouhlasí, může se chování lišit od dokumentace. --- ## Tipy pro efektivní testování * **Neexistuje centrální demo shop** – každý vývojář si připravuje vlastní testovací projekt. * **Testovací režim** zajistí, že za testování **neplatíte**. * Pokud appka vyžaduje **přístup na úrovni projektu**, **povolte ji** na konkrétním projektu. * Na **rychlé testy** stačí **malý feed** s pár produkty – **není nutné** nahrávat produkční data. * Používejte **samostatný testovací účet/projekt** pro integrace, abyste **nezasahovali** do produkčních dat. --- ## FAQ **Existuje oficiální demo prostředí s daty?** Ne. Nejsou k dispozici centrální demo data. Vytvořte si vlastní testovací projekt v Mergadu. **Kde založím účet do Mergada?** Na **app.mergado.com**. **Kde vytvořím svou appku?** Na **[https://app.mergado.com/developers/create-app/](https://app.mergado.com/developers/create-app/)**. Po vyplnění základních údajů získáte přístup k entitám, kde je appka zapnutá. **Jak testovat bez poplatků?** V **nastavení projektu** zapněte **testovací režim**. **Potřebuji projekt, když moje appka pracuje s projekty?** Ano. Založte **testovací projekt**, nahrajte **malý feed** a appku na projektu **povolte**. **Jak appce udělím přístup k datům projektu?** V **nastavení projektu** appku **zapněte**. Získá tak přístup k feedům/projektům, které může číst/upravovat. **Kde najdu postup autorizace vůči API?** V dokumentaci: **[https://mergado.github.io/docs/api/authorization.html](https://mergado.github.io/docs/api/authorization.html)**. **Kde je kompletní API dokumentace?** Na **[https://mergado.docs.apiary.io/#](https://mergado.docs.apiary.io/#)**. **Endpoint se chová jinak než v dokumentaci. Co s tím?** Zkontrolujte **verzi API**. Chování endpointů je verzované a odlišná verze může vést k jinému chování. **Jak velký feed mám použít pro testy?** Stačí **malý feed** s několika produkty – je ideální pro rychlé iterace. **Jak ochráním produkční data při vývoji?** Používejte **samostatný testovací účet/projekt**, ať se změny nedotknou produkce. --- # Mergado Súgó – Teljes tartalom > A Mergado tudásbázis teljes tartalma LLM modellek indexeléséhez – magyar nyelv. ## [Shopify csatlakoztatása a Mergado Editorhoz](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/adatkapcsolas/shopify-api-csatlakoztatas/) # **Shopify csatlakoztatása a Mergado Editorhoz** ## **Fontos tudnivalók a csatlakoztatáshoz** > Az `URLs > App URL` mezőbe írd be: `https://app.mergado.com/` > > Ezt az URL-t kell megadnod az **App URL** mezőben, amikor egyedi alkalmazást hozol létre a Shopifyban. > Minimális jogosultságok (scopes), amelyekre a Mergadónak szüksége van – ezek nélkül az integráció nem működik: ```text write_products,read_products,write_markets,read_markets,read_metaobjects ``` > Ha a Mergado Marketplaces-t is használni szeretnéd, ezekre a jogosultságokra is szükség van: ```text read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits ``` --- > Ez az útmutató a **Shopify hivatalos dokumentációján és az aktuális felhasználói felületen** alapul, a **Shopify Developer Dashboard** segítségével történő alkalmazáslétrehozáshoz. > > **Hivatalos forrás:** > [https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard) --- ## **Kinek szól ez az útmutató** - Shopify kereskedőknek, akik össze akarják kapcsolni a webáruházukat a **Mergadóval** - Ügynökségeknek és fejlesztőknek, akik a Shopify ↔ Mergado integrációt állítják be - Bárkinek, aki **Shopify API hozzáférési tokent** szeretne szerezni > **Saját (custom) API alkalmazást** hozol létre egyetlen webáruház számára. Az alkalmazást **nem kell** közzétenni a Shopify App Store-ban. --- ## **Amire szükséged lesz** - Shopify fiók **admin hozzáféréssel** a webáruházhoz - Hozzáférés a **Shopify Developer Dashboardhoz** ## **Mielőtt elkezded: Ellenőrizd a piacok (Markets) beállítását** > **Ez a lépés szükséges ahhoz, hogy a Mergado importálhassa az egyes piacok termékeit.** Az alkalmazás létrehozása előtt ellenőrizd a **Markets** beállítást a Shopify adminisztrációban. ### **Amit be kell állítani** Minden **piac (Market)** esetében, amelyből termékeket szeretnél a Mergadóba importálni: * hozzá kell rendelni egy **domaint** * hozzá kell rendelni egy **nyelvet** * mindkét értéknek a ***Customized*** **szekcióban** kell szerepelnie Nem elég, ha csak az **Inherited** szekcióból vannak örökölve vagy **Primary** értékként vannak beállítva. ### **Lépések a Shopify adminisztrációban** ![chrome-capture-2026-02-05 (2)|690x458](upload://4KwkolMkTWQJTzhP0vcdM2RcFHh.jpeg) ![chrome-capture-2026-02-05 (3)|690x458](upload://ifPuFbmraLWFvoCvEE9cOF6TU6s.jpeg) ![chrome-capture-2026-02-05 (4)|690x458](upload://58oFrKi3NPgIy42R41woXA0qsQ.jpeg) ![chrome-capture-2026-02-06|690x288](upload://ivJxwy3wHiaDI4g5r9BiSODrAjn.png) 1. Nyisd meg a **Shopify adminisztrációt** 2. A bal oldali főmenüben kattints a **Markets** elemre 3. Nyisd meg az adott piacot (pl. *Hungary*) 4. Görgess le az **Inherited** szekcióhoz 5. A **Domain / language** tételnél kattints a **+** ikonra 6. A felugró ablakban: * jelöld be a kívánt **domaint** * jelöld be a kívánt **nyelvet** 7. Erősítsd meg a **Done** gombbal 8. Ellenőrizd, hogy a **Domain / language** átkerült a **Customized** szekcióba 9. Mentsd el a **Save** gombbal > Ha a **Domain / language** csak az **Inherited** részben marad, a Shopify API nem ad adatot az adott piachoz, és a Mergado nem tudja importálni a termékeket. --- ## **1. lépés – Shopify Developer Dashboard megnyitása** ![chrome-capture-2026-01-21|690x363](upload://yi6GOpgymNKPGNIwieYIEm0BHWX.jpeg) A Developer Dashboard-ot kétféleképpen érheted el: ### **A variáns: Közvetlen hozzáférés** 1. Nyisd meg a https://dev.shopify.com/ oldalt 2. Jelentkezz be a Shopify fiókoddal 3. A bal menüben nyisd meg az **Apps** szekciót ### **B variáns: A Shopify adminisztráción keresztül** 1. Nyisd meg a webáruházad **Shopify adminisztrációját** 2. Menj a **Settings** → **Apps** menübe 3. Kattints a **Develop apps** gombra 4. Kattints a **Build apps in Dev Dashboard** gombra --- ## **2. lépés – Új alkalmazás létrehozása** ![chrome-capture-2026-01-21 (1)|690x363](upload://8FjBEpoi86YFJFvAvjwu3m6pb2U.jpeg) 1. Győződj meg róla, hogy az **Apps** szekcióban vagy 2. Kattints a **Create app** gombra 3. Válaszd a **Start from Dev Dashboard** lehetőséget 4. Add meg az alkalmazás nevét (pl. `Mergado integration`) 5. Kattints a **Create** gombra Ezután átirányítanak a **Versions** fülre. --- ## **3. lépés – Alkalmazásverzió létrehozása és jogosultságok beállítása** ![chrome-capture-2026-01-21 (3)|690x363](upload://n2eN7qTp5uEwW4Vg107cgWPlaEN.jpeg) Minden alkalmazásnak legalább egy **verzióval** kell rendelkeznie ahhoz, hogy telepíthető legyen. ### **3.1 App URL és beágyazás beállítása** ![chrome-capture-2026-02-04|690x362](upload://bfcEWSbrACMUU1QqpKc2ZpTNr7C.jpeg) 1. A **URLs** szekcióban keresd meg az **App URL** mezőt 2. Az alapértelmezett `https://example.com` értéket cseréld le erre: ``` https://app.mergado.com ``` > Ez a lépés **szükséges a Mergado integrációjának helyes működéséhez**. Ha az alapértelmezett érték marad, az engedélyezés nem fog működni. 3. Az **App URL** mező alatt töröld az **Embed app in Shopify admin** jelölőnégyzetet ### **3.2 Hozzáférési jogosultságok beállítása** ![chrome-capture-2026-01-21 (4)|690x363](upload://a9N5N5ZyBYPIqLQzjeOHSoDJAvH.jpeg) ![chrome-capture-2026-01-21 (5)|690x363](upload://c9BK7RdunT6Bk1LuqVSRy02vqT3.jpeg) 1. Az **Access** szekcióban kattints a **Select scopes** gombra 2. A felugró ablakban keresd meg és jelöld be: - `read_products` - `write_products` - `read_markets` - `write_markets` - `read_metaobjects` 3. Erősítsd meg a **Done** gombbal > Ezek a jogosultságok szükségesek ahhoz, hogy a Mergado be tudja tölteni a termékeket és a piacokra vonatkozó adatokat. ### **3.3 Verzió közzététele (Release)** ![chrome-capture-2026-01-21 (6)|690x363](upload://d1AdzGBUU2NC2Uwd53o1XxnqjwJ.jpeg) ![chrome-capture-2026-01-21 (7)|690x363](upload://msYm8un3v1sfB2h8SW0wmY5u2iA.jpeg) 1. Görgess lejjebb az oldalon 2. Kattints a **Release** gombra 3. A megerősítő ablakban a verziónevet üresen hagyhatod 4. Erősítsd meg a **Release** gombbal Az alkalmazás verziója most közzé van téve és készen áll a telepítésre. --- ## **4. lépés – Alkalmazás telepítése a webáruházba** ![chrome-capture-2026-01-21 (8)|690x363](upload://eM5OjIktwKtAtKiUmQ46Lnaaj7j.jpeg) ![chrome-capture-2026-01-21 (9)|690x363](upload://ehh1CVDX6VdLfZqToOLrSzzhU7w.jpeg) 1. A bal menüben nyisd meg a **Home** elemet 2. Jobb felül kattints az **Install app** gombra 3. Válaszd ki a Shopify webáruházat, amelyet a Mergadóval szeretnél összekapcsolni 4. Átirányítanak a Shopify adminisztrációba 5. A telepítést erősítsd meg az **Install** gombbal Az alkalmazás most telepítve van a webáruházban. --- ## **5. lépés – API hozzáférési adatok megszerzése (Client ID és token)** ![chrome-capture-2026-01-21 (10)|690x363](upload://3xzEN9UzDGXs7EaTcqSHOcX9GCP.jpeg) A telepítés után szükséged lesz **két értékre** a Mergadóval való összekötéshez: 1. **Client ID** 2. **API hozzáférési token (Secret)** Lépések: 1. Menj vissza a **Shopify Developer Dashboardba** 2. Nyisd meg az alkalmazásodat 3. Menj a **Settings** menübe 4. A **Credentials** szekcióban: * másold ki a **Client ID** értéket (a Secret **felett** található) * másold ki a **Secret** értéket > A **Client ID** az alkalmazás azonosítója, a **Secret** az API hozzáférési token. A Mergado integrációjához **mindkét érték szükséges**. --- ## **6. lépés – Webáruház URL-jének megszerzése** ![chrome-capture-2026-01-21 (11)|690x363](upload://swlRwAilFrTllSBnz2OGN42uLxr.jpeg) 1. Nyisd meg a webáruház **Shopify adminisztrációját** 2. A bal menüben nyisd meg a **Home** elemet 3. A **Domains** szekcióban másold ki a webáruház URL-jét Példa: `your-store.myshopify.com` --- ## **7. lépés – Shopify összekötése a Mergadóval** ![chrome-capture-2026-02-04 (1)|690x457](upload://1D3aZv97jesYUpV6LGiWExj6DGt.png) 1. Nyisd meg a **Mergadót** 2. Hozz létre egy új projektet 3. Adatforrásként válaszd a **Shopify**-t 4. Töltsd ki: * **Shopify URL** → a webáruház URL-je * **Client ID** → a Developer Dashboardból kimásolt Client ID * **Client Secret** → a kimásolt Secret érték 5. Kattints a **Log in** gombra --- ## **GYIK** ### **A Market kiválasztása után nem töltődik be a nyelv. Miért?** A leggyakoribb ok a **Markets** szekció beállításában van. Ha a **Domain / language** csak az **Inherited** szekcióban szerepel és nincs a **Customized** szekcióban, a Shopify API nem ad adatot az adott piachoz. Megoldás: * Nyisd meg a **Shopify admin → Markets** menüt * Nyisd meg az adott piacot * A **Domain / language** tételnél kattints a **+** gombra * Válaszd ki a domaint és a nyelvet * Kattints a **Done**, majd a **Save** gombra * Ellenőrizd, hogy a tétel átkerült a **Customized** szekcióba ![chrome-capture-2026-02-18|690x362](upload://yZxZconuA082jT0vgNumGmoEsaX.jpeg) ### **A Mergado egyes metafield értékeket nem tölt be helyesen. Miért?** Ha egyes metafield-eknél a helyes név (key) jelenik meg, de az érték (value) ID-ként látszik (pl. `["gid://shopify/Metaobject/94942036012"]`) vagy a **„Missing required scope"** üzenet jelenik meg, az alkalmazásnak hiányzik a `read_metaobjects` jogosultsága. ![Screenshot 2026-02-20 at 10.12.15|690x201](upload://78r54J7onUpuj1HEONlApXYjlU7.png) **Megoldás:** 1. Menj a **Shopify Developer Dashboardba** 2. Nyisd meg a Mergado integrációhoz létrehozott alkalmazást 3. A bal menüben menj a **Versions** menüre 4. Kattints a **New version** gombra 5. A **Scopes** szekcióban add hozzá a `read_metaobjects` scope-ot 6. Erősítsd meg és kattints a **Release** gombra Az új verzió kiadása után újra kell engedélyezni a csatlakozást: 1. Nyisd meg a **Mergado Keychain** bővítményt 2. Töröld a meglévő kapcsolatot 3. Töltsd ki újra az adatokat: **Shopify URL**, **Client ID**, **Secret** 4. Jelentkezz be újra (**Log in**) A scope hozzáadása és az újraengedélyezés után a metafield értékek helyesen töltődnek be. --- ## [Termékek engedélyezése](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/adatkapcsolas/termek-engedelyezes/) # **Termékek engedélyezése** A termékek engedélyezésével eldöntheted, melyik tételeket engeded be a bemeneti feedből a Mergadóba, és melyeket blokkolod. Hasznos, ha beszállítói feeded van és nem akarod a teljes kínálatot megjeleníteni, vagy ha minden új terméket ellenőrizni szeretnél. ## **Lépésről lépésre** ### **1) Bekapcsolás projekt létrehozásakor** 1. A varázslóban (utolsó lépés) a **Párosító elemek** alatt két gombot találsz. 2. Az alsó gomb a **Termékek engedélyezésének bekapcsolása** – kattints rá az aktiváláshoz. ### **2) A projekt létrehozása után** * Az **Áttekintésben** a kimeneten **0 termék** jelenik meg. * A bal alsó ablakban megjelenik a **„Jóváhagyásra váró termékek"** üzenet. * Ez azt jelenti, hogy a bemeneti feed termékeit először engedélyezned kell. ### **3) Termékek jóváhagyása** 1. Menj a **Termékek** szekcióba, és nyisd meg a **Termékek engedélyezése** fület. 2. Megjelenik a bemeneti feed összes termékének listája. 3. Jelöld ki a jóváhagyni kívánt termékeket. * Ha mindet ki akarod jelölni, használd a **jelölőnégyzetet** az **első fekete sáv bal szélén**. 4. Kattints a **Jóváhagyás** (vagy **Elutasítás**) gombra. > A jóváhagyott termékek **bekerülnek a Mergadóba** és megjelennek a kimeneten. Ha azt szeretnéd, hogy az engedélyezett termékek azonnal megjelenjenek a kimeneti feedben, indítsd el a *Beállítások* → *Teljes újragenerálás* funkciót. Ha nem sürgős, megvárhatod az automatikus frissítést is. ### **4) Kikapcsolás / újbóli bekapcsolás** Az engedélyezés bármikor kikapcsolható és újra bekapcsolható egy már létrehozott projektnél is. Menj a **Beállítások**ba, és a **párosító elemek alatt** találod a **Termékek engedélyezése** ki-/bekapcsolási lehetőséget. ## **Tippek** * **Gyors indulás**: Ha az egész feedet be akarod engedni, használd a tömeges kijelölést az első fekete sáv jelölőnégyzetével, majd kattints a **Jóváhagyás** gombra. * **Gondos ellenőrzés**: Ha minden új tételt ellenőrizni szeretnél, rendszeresen nézd meg a **Termékek engedélyezése** fület, és csak azt hagyd jóvá, amit tényleg a kimeneten szeretnél látni. ## **GYIK** ### **Mire szolgál a termékek engedélyezése?** Annak szabályozására, mely termékeket engeded be a bemeneti feedből a Mergadóba és melyeket blokkolod. Hasznos, ha nem akarod a teljes feedet megjeleníteni, vagy figyelni akarod az új tételeket. ### **Hol kapcsolom be az engedélyezést projekt létrehozásakor?** A varázsló utolsó lépésében a **Párosító elemek** alatt a **Termékek engedélyezésének bekapcsolása** gombra kattintva. ### **Miért látok 0 terméket és a „Jóváhagyásra váró termékek" üzenetet?** Mert először jóvá kell hagynod a bemeneti feed termékeit a **Termékek engedélyezése** fülön. ### **Hogyan jelölöm ki tömegesen az összes terméket?** A **Termékek engedélyezése** fülön használd a **jelölőnégyzetet** az **első fekete sáv bal szélén**, majd kattints a **Jóváhagyás** vagy **Elutasítás** gombra. ### **Mi történik jóváhagyás után?** A jóváhagyott termékek bekerülnek a Mergadóba és megjelennek a kimeneten. Ha azt szeretnéd, hogy azonnal a kimeneti feedbe kerüljenek, indítsd el a *Beállítások* → *Teljes újragenerálás* funkciót. Egyébként a következő automatikus frissítésnél jelennek meg. ### **Kikapcsolható az engedélyezés később?** Igen. A **Beállítások**ban a **párosító elemek alatt** bármikor ki- és bekapcsolhatod. --- ## [UNAS csatlakoztatása a Mergado Editorhoz](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/adatkapcsolas/unas-api-csatlakoztatas/) # **UNAS csatlakoztatása a Mergado Editorhoz** ## **1. lépés – Integráció aktiválása** Elsőként a webáruház platformján kell létrehoznod egy API kulcsot. Menj a *Beállítások* → *Külső kapcsolatok* → *Piacterek* menübe. --- ## **2. lépés – API kulcs aktiválása** A megnyíló oldalon hozd létre az új API kulcsot a Mergado boxban található „Hozzáad“ gombra kattintva. --- ## **3. lépés – Adatok másolása** Másold ki az API kulcsot és a webáruház ID-t. --- ## **4. lépés – UNAS kiválasztása adatforrásként** A Mergado Editorban új projekt létrehozásakor válaszd adatforrásként az **UNAS**-t. --- ## **5. lépés – Adatok megadása a varázslóban** A projekt létrehozási varázslóban add meg az API kulcsot és a webáruház ID-t. --- ## **6. lépés – Kimeneti formátum és befejezés** Válaszd ki a kimeneti formátumot, és fejezd be a projekt létrehozását. --- *Tipp: Az UNAS csatlakoztatása a Mergado Keychainben is elvégezhető. Így a projekt létrehozásakor nem kell újra megadnod az adatokat.* Ha elakadsz az UNAS csatlakoztatásával, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ## **GYIK** ## **Hol találom az API kulcs létrehozásának lehetőségét az UNAS-ban?** A *Beállítások* → *Külső kapcsolatok* → *Piacterek* menüben. Keresd a Mergado boxot, és kattints a „Hozzáad" gombra. ## **Hol találom a webáruház ID-t?** Az adminisztráció jobb felső sarkában találod. ## **Létrehozhatom a kapcsolatot a Mergado Keychainben is?** Igen. A Mergado Keychainben előre elkészítheted az UNAS csatlakoztatást, és a projekt létrehozásakor nem kell újra megadnod az adatokat. ## **Milyen kimeneti formátumot válasszak?** A céljaidnak megfelelően – például Google Shopping, Heureka vagy Mergado Marketplaces formátumot. ## **Mi a teendő, ha nem sikerül a csatlakoztatás?** Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre – segítünk a beállításban. --- ## [A Mergado használatának előnyei](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/mi-a-mergado-es-hogyan-mukodik/mergado-elonyei/) # **A Mergado használatának előnyei** "Megéri használni a Mergadót?" Rövid válasz: igen, megéri. Ha megfelelően beállítod, akár több tíz százalékkal is növelheted a bevételeidet, és könnyedén túlszárnyalod a Mergado havi költségeit. Ráadásul rengeteg időt is megtakarítasz. De nézzük részletesebben az előnyöket. ## **1. Azonnali módosítások programozó nélkül** A Mergado „fordítóként" működik a webáruházad és a hirdetési csatornák között. Betöltöd a termék feededet, és az átlátható felületen elvégzed a szükséges módosításokat fejlesztők bevonása nélkül. Amit egyébként programozónak kellene megoldania, azt néhány perc alatt elintézed kattintásokkal. Nem kell kézzel módosítanod több száz vagy ezer terméket minden alkalommal, amikor valami változik. Beállítasz egy szabályt, és a Mergado tömegesen módosítja az összes érintett tételt. Ezzel nemcsak felgyorsítod a munkát, hanem komoly költségeket is megtakarítasz. *Példa: Van 1000 terméked, amelyeknél a Heureka követelményei szerint módosítanod kell a nevet. Ahelyett, hogy egyenként módosítanád vagy várnál a programozóra, megnyitod a Mergadót, beállítasz egy szabályt, és az összes terméknév módosul – azonnal, a webáruházadba való beavatkozás nélkül.* ## **2. Hirdetési teljesítmény és bevétel növelése** A hirdetési rendszerekbe küldött adatok minősége közvetlenül befolyásolja, hogy mennyire jól jelennek meg a termékeid. A Mergadóval könnyen feltárod és kijavítod azokat a hibákat, amelyek akadályozzák a hirdetést vagy csökkentik a teljesítményét. Jobb minőségű adatokkal magasabb keresési pozíciókat érsz el. Megfelelő beállítás mellett növelheted az átkattintási arányt (CTR) és a bevételeidet akár több tíz százalékkal. *Példa: Ha egy terméknek hiányzik az EAN kódja vagy rossz kategóriába van sorolva, a hirdetési platformon nem fog megjelenni vagy hibásan lesz besorolva. A Mergadóval ezeket a hibákat néhány kattintással kijavítod.* ## **3. Áttekintés és rend az adatokban** A [Mergado Audit](https://audit.mergado.com/) ingyenesen ellenőrzi a termék feeded minőségét. Feltárja a hibákat – hiányzó vagy hibás elemeket, nem engedélyezett értékeket, duplikált tételeket –, és javaslatot ad a javításukra. Így biztos lehetsz benne, hogy a termékadataid teljesek és készen állnak a hirdetésre. *Példa: Az Audit feltárja, hogy a kategórianevek nem felelnek meg a hirdetési platform kategóriáinak. Az automatikus javaslatok segítségével beállítod a megfelelő kategóriákat, és a termékeid helyesen jelennek meg.* ## **4. Hirdetési költségek megtakarítása** A Mergadóban lekérdezéseket hozhatsz létre különböző kritériumok alapján – elérhetőség, árrés, szezon vagy kampánytípus szerint. Így mindig csak azt hirdeted, aminek hirdetése megéri, és a költségvetéseddel hatékonyan gazdálkodol. *Példa: A katalógusodban nyári és téli áru is van. Nyáron nem akarsz szánkót hirdetni. A Mergadóban beállítasz egy szabályt, amely kizárja a téli termékeket a nyári kampányokból – csökkented a felesleges költségeket és javítod a hatékonyságot.* ## **5. Könnyű és gyors terjeszkedés** A Mergado több száz hirdetési platformot, árösszehasonlítót, marketplace-t és analitikai rendszert támogat. Egyszerűen és gyorsan érhetsz el új vásárlókat itthon és külföldön egyaránt. *Példa: A Kauflandon hirdetsz és az olasz vagy francia piacra is terjeszkedni szeretnél? A Mergadóban ez néhány kattintás – az előkészített integrációt használod, bonyolult előkészületek nélkül.* ## **6. Funkciók, amelyek időt takarítanak meg** A Mergado nem csak az alapvető feed módosításokról szól. A funkciói és [bővítményei](https://store.mergado.com/) automatikus fordításokat, licitálást, árazást, tömeges képszerkesztést, adatszinkronizálást és még sok mást tesznek lehetővé. *Példa: Kapsz egy feedet a szállítódtól, amelynek más a formátuma, mint amit a webáruházad igényel? A Mergadóval átalakítod a megfelelő struktúrába.* ## **7. Alacsony költségek, ingyenes kipróbálás és támogatás** A Mergado kisebb webáruházak számára is elérhető. Az [ár](https://www.mergado.hu/arjegyzek) a hirdetett termékek számától függ. 30 napos ingyenes próbaverzióval kipróbálhatod az összes funkciót. Ha elakadsz, rendelkezésedre áll az ingyenes [támogatás](https://www.mergado.hu/elerhetosegek) és [képzések](https://www.mergado.hu/mergado-academy). ## **GYIK** ## **Mi a Mergado és mire használhatom?** A Mergado egy eszköz a termék feedek szerkesztéséhez, kezeléséhez és optimalizálásához. Segít javítani az adatok minőségét, megtakarítani a hirdetési költségeket, terjeszkedni külföldi piacokra és automatizálni a marketing folyamatokat – programozó nélkül. ## **Hogyan segít a Mergado Audit?** A [Mergado Audit](https://audit.mergado.com/) ingyenesen ellenőrzi a termék feeded minőségét. Feltárja a hibákat (hiányzó elemek, nem engedélyezett értékek, duplikátumok, rossz kategóriák) és javaslatot ad a javításukra. ## **Megtakaríthatok pénzt a hirdetésen?** Megfelelő beállítás mellett igen. Lekérdezésekkel szűrheted a termékeket árrés, elérhetőség, szezonalitás vagy kampánytípus szerint – így csak azt hirdeted, ami megéri. ## **Segít a Mergado a külföldi terjeszkedésben?** Igen. Több száz csatornát, árösszehasonlítót és marketplace-t támogat világszerte. Az előkészített integrációk segítségével egyszerűen elkezdhetsz hirdetni külföldön. ## **Segít a szállítói feedek kezelésében is?** Igen. Ha a szállítói feed más formátumban van, a Mergadóban átalakíthatod a webáruház-platformod által kezelhető formátumba – kattintásokkal, programozás nélkül. ## **Milyen további funkciókat kínál a Mergado?** * automatikus fordítások külföldi terjeszkedéshez, * automatikus licitálás és árazás, * szállítói feedek kezelése, * tömeges képszerkesztés, * adatok szinkronizálása több forrásból, * elemzések, * és sok más funkció a [Mergado bővítményeken](https://store.mergado.com/) keresztül. ## **Alkalmas kis webáruházak számára is?** Igen. Az ár a termékek számától függ, így kisebb katalógusokkal is elérhető. ## **Kipróbálhatom ingyen?** Igen, 30 napos ingyenes próbaverzióval az összes funkciót kipróbálhatod. ## **Kaphatok segítséget, ha elakadok?** Igen. Rendelkezésedre áll az ingyenes [technikai támogatás](https://www.mergado.hu/elerhetosegek), [fórum](https://forum.mergado.hu/) és [ingyenes képzések](https://www.mergado.hu/mergado-academy). ## **Milyen gyorsan kezdhetem el használni?** Azonnal. Importáld a termék feedet, futtasd az Auditot és kezdd el a szabályok létrehozását – fejlesztő nélkül is megoldhatod. --- ## [A Mergado működése és beállítása](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/mi-a-mergado-es-hogyan-mukodik/mergado-mukodese-beallitasa/) # **A Mergado működése és beállítása** ## **Mi a Mergado és hogyan segít neked** A Mergado egy webalkalmazás a termékadatok kezelésére és szerkesztésére, elsősorban webáruházak és digitális ügynökségek számára. Gondolj rá úgy, mint egy okos közvetítőre a webáruházad és a hirdetési platformok (pl. Árukereső, Google, Facebook) között. Amikor termékadatokat küldesz a webáruházadból (pl. UNASból, Shopifyból vagy WooCommerce-ből), a Mergado lehetővé teszi, hogy ezeket az adatokat tömegesen módosítsd, kiegészítsd vagy az egyes hirdetési csatornák igényeihez igazítsd. Például: * szegmentálhatod a termékeket, * tömegesen hozzáadhatsz márkanevet a terméknevekhez, * pótolhatod a hiányzó paramétereket, * párba állíthatod a kategóriákat, * elrejthetsz kiválasztott termékeket, * tömegesen szerkesztheted a termékképeket az egyes platformok követelményei szerint, * több feed verziót hozhatsz létre különböző hirdetési csatornákhoz. A szerkesztési lehetőségek szinte végtelenek. Ennek köszönhetően a termékeid helyesen, teljes információkkal és jobban célzottan jelennek meg – ami a gyakorlatban magasabb kampányteljesítményt és kevesebb hirdetési hibát jelent. Ráadásul rengeteg időt is megtakarítasz. Képzeld el, mennyi időbe telne kézzel átárazni több ezer terméket. Vagy mennyi ideig tartana több száz termékképet a Google által megkövetelt méretekre szerkeszteni. ## **Ki állítja be a Mergadót** A Mergado óriási mértékben megkönnyíti a termékadatokkal végzett munkát, de nem egy varázslatos eszköz, ami mindent magától megcsinál. Minden webáruház-tulajdonosnak saját stratégiái és céljai vannak – ezeket a Mergado nem találja ki helyetted. Neked kell az úgynevezett szabályokon keresztül beállítanod, hogy mi történjen az adataiddal, és idővel tovább finomhangolnod. Az előny viszont az, hogy a szabályokat elég egyszer beállítani, és a Mergado automatikusan alkalmazza őket több száz vagy több ezer termékedre. ## **Milyen tudás kell a Mergadóval való munkához** A Mergado egy no-code eszköz – a termék feedek szerkesztéséhez nem kell programoznod. Mindent kattintásokkal állítasz be: szabályokkal, szűrőkkel és egyszerű űrlapokkal. A legtöbb szabályt az útmutatóink vagy az ügyfélszolgálatunk segítségével be tudod állítani. ## **Kik dolgoznak leggyakrabban a Mergadóval** A gyakorlatban általában a webáruházak marketing osztályának munkatársai használják a Mergadót. Ha a webáruház külső ügynökséggel vagy freelancerrel dolgozik, gyakran az ügynökség veszi át a feedek beállítását. A Mergado egyes ügynökségekkel és freelancerekkel is együttműködik – a szükséges képzések elvégzése után ők tanúsított partnerekké válnak, akik szakszerűen segítenek a termékfeedek kezelésében. Tanúsított partnereink listáját [itt](https://www.mergado.hu/minositett-partnerek) találod. ## **Hogyan zajlik a csatlakoztatás és beállítás** ### **1. Termékadatok forrásának csatlakoztatása és kimeneti formátum kiválasztása** Hozz létre egy Mergado fiókot, csatlakoztasd a termék feededet vagy kapcsolódj API-val, és válaszd ki, hova szeretnéd küldeni az adataidat – pl. Árukereső, Kaufland Marketplaces, ChatGPT vagy Facebook. Az első projekt létrehozásáról szóló útmutatót az Új projekt létrehozása cikkben találod. ### **2. Audit / adatminőség-ellenőrzés** Ha az adatforrás csatlakoztatásakor ezt a lehetőséget választod, a Mergado ingyenesen elvégzi az adataid ellenőrzését. A [Mergado Audit](https://audit.mergado.com/) figyelmeztet a technikai hibákra, és segít kijavítani őket. ### **3. Szabályok, szűrők és módosítások meghatározása** Beállítod, milyen változtatásokat kell végrehajtani – pl. nevek módosítása, hiányzó elemek pótlása, árak átszámítása, termékek szűrése, kategóriák leképezése. Ez a kulcsfontosságú lépés, amit a Mergado nem végez el magától – a szabályokat és stratégiát neked kell megtervezned. ### **4. Automatizálás / frissítések ütemezése** A Mergado lehetővé teszi a rendszeres újragenerálás, automatikus módosítások és adatküldés ütemezését. Az üzemmódot és gyakoriságot te állítod be. ### **5. Monitorozás, finomhangolás és karbantartás** Az indítás után figyelned kell, hogy a hirdetés megfelel-e az elvárásaidnak, nincsenek-e hibák, és az adatok alapján finomhangolnod kell a szabályokat vagy újakat hozzáadni. ## **Milyen előnyöket nyújt a Mergado** Még ha úgy is tűnhet, hogy a webáruházadból közvetlenül a hirdetési csatornákba áramló adatok jól működnek, a Mergadóval tovább léphetsz: * jobban igazítod az adatokat az egyes csatornák követelményeihez, * teljes kontrollt kapsz afelett, hogy mi kerül a hirdetésbe, * könnyen létrehozol különböző feedeket különböző piacokra, * áttekintést kapsz a hibákról és javaslatokat a javításukra, * a hirdetést egyetlen helyről irányíthatod, * tömeges módosításokkal jelentősen csökkented a kézi munkát, * nem kell programozót bevonnod a szokásos változtatásokhoz, * a Mergadóval gyakorlatilag bárki tud dolgozni, * a Mergado több mint 650 formátumhoz támogatja a csatlakozást, így a terjeszkedés vagy platformváltás egyszerűbb, * rendelkezésedre áll az [ingyenes ügyfélszolgálat](https://www.mergado.hu/elerhetosegek) és sok [ingyenes képzés](https://www.mergado.hu/mergado-academy), * a [Mergado Fórumon](https://forum.mergado.hu/) útmutatókat, súgókat találsz és tapasztalatokat cserélhetsz más felhasználókkal. ## **Mítoszok vs. valóság** | Mítosz | Valóság | | --- | --- | | „Elég csatlakoztatni a feedet, és a Mergado mindent megold." | A forrásadatok csatlakoztatása csak a kiindulópont. A szabályokat és stratégiát neked kell meghatároznod. | | „Ha egyszer be van állítva, többé nem kell foglalkoznom vele." | A piaci helyzet változik, a kínálatod megújul, a csatornák követelményei frissülnek. Rendszeres karbantartás szükséges. | | „Az ügyfélszolgálat beállítja nekem a hirdetést." | Az ügyfélszolgálat szívesen konzultál és tanácsot ad. A szabályok beállítása és kezelése viszont a te feladatod, a saját stratégiád szerint. A Mergado viszont jelentősen megkönnyíti a folyamatokat. | ## **Hol találsz segítséget, ha elakadsz** ### **1. Technikai ügyfélszolgálat** Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. [Technikai támogatásunk](https://www.mergado.hu/elerhetosegek) munkanapokon 9:00-tól 16:00-ig ingyenesen áll rendelkezésedre. ### **2. Ingyenes onboarding** Új vagy a Mergadóban? Beszélj meg velünk egy egyszeri, ingyenes egyórás megbeszélést, amelyen megmutatjuk az alapokat. Ha az alapokat már ismered, az onboardingot egy konkrét probléma megoldására vagy a beállításaid áttekintésére is használhatod. ### **3. Ingyenes webináriumok** Jelentkezz ingyenes webináriumainkra – gyakorlati eljárásokat mutatunk, amelyeket magad is alkalmazni tudsz. Az aktuális időpontokat [itt](https://www.mergado.hu/mergado-academy) találod. ### **4. Mergado Fórum** Látogasd meg a [Mergado Fórumot](https://forum.mergado.hu/), ahol útmutatókat, tippeket és tapasztalt marketingesek közösségét találod. ### **5. Tanúsított partnerek** Ha nem szeretnéd magad beállítani a Mergadót, vagy szakértői segítségre van szükséged, vedd fel a kapcsolatot [tanúsított partnereinkkel](https://www.mergado.hu/minositett-partnerek). Ők képzett szakértők igazolt gyakorlattal. ### **6. További források** A [Mergado blog](https://www.mergado.hu/blog)-on rengeteg cikket és esettanulmányt találsz. Súgót közvetlenül a Mergado Editorban is találsz a [Mergado Editor Útmutató](https://app.mergado.com/guide) vagy a [Videó súgó](https://app.mergado.com/guide/video) szekcióban. ### **7. AI segítők** Ha gyors tanácsra van szükséged, használhatod az AI eszközöket is, amelyek jól ismerik a Mergadót és lépésről lépésre el tudják magyarázni a teendőket. ## **Felelősség a Mergado használatáért** A Mergado használata a felhasználó saját felelősségére történik. Szívesen nyújtunk útmutatókat, támogatást és konzultációkat, de nem vállalunk felelősséget az esetleges károkért, amelyek a feed hibás beállításából vagy helytelen exportból eredhetnek. Javasoljuk, hogy a módosítások után ellenőrizd a kimeneteket, és bizonytalanság esetén konzultálj az ügyfélszolgálatunkkal. A Felhasználási feltételeket [itt](https://www.mergado.hu/podminky-uzivani) olvashatod. ## **GYIK** ## **Mi a Mergado és hogyan segít nekem?** A Mergado egy online eszköz a webáruházad termékadatainak szerkesztésére és kezelésére. Segít, hogy a termékeid helyesen jelenjenek meg a hirdetési csatornákban (Árukereső, Google, Facebook, ChatGPT Shopping). Tömegesen szerkesztheted a termékneveket, leírásokat, árakat, pótolhatod a hiányzó paramétereket, szűrheted a termékeket, és több feed verziót hozhatsz létre – mindezt programozás nélkül. ## **Mire jó a Mergado, ha a feedeket már közvetlenül küldöm az Árukeresőre?** A Mergadóval jobban testreszabhatod, bővítheted és kezelheted az adatokat. Tömegesen módosíthatsz paramétereket vagy képeket, automatikusan licitálhatsz, átárazhatsz, szűrheted a kínálatot vagy különböző feedeket hozhatsz létre különböző csatornákhoz – mindezt a webáruházadba való beavatkozás nélkül. ## **Ki állítja be a Mergadót?** Te magad. A Mergado teljes kontrollt ad afelett, mi történik az adataiddal. Neked kell beállítanod a szabályokat, a Mergado ezután automatikusan és tömegesen végrehajtja őket. Ha nem szeretnéd magad végezni, javasoljuk a [tanúsított partnereinkkel](https://www.mergado.hu/minositett-partnerek) való együttműködést. ## **Tudok dolgozni a Mergadóval programozási tudás nélkül?** Igen. A Mergado no-code eszköz – a szabályokat kattintásokkal, egyszerű űrlapok segítségével állítod be. Videó útmutatók, fórum és ingyenes ügyfélszolgálat is rendelkezésedre áll. ## **Használhatom a Mergadót, ha a hirdetésemet ügynökség kezeli?** Igen. Elég hozzáférést adnod a projektedhez, és az ügynökség ugyanúgy dolgozhat az adatokkal. Ha még nem döntötted el, kire bízd, javasoljuk a [tanúsított partnereinket](https://www.mergado.hu/minositett-partnerek). ## **Mi kell ahhoz, hogy elkezdhessek dolgozni a Mergadóval?** Egy termék feed a webáruházadból és egy Mergado-fiók. Az első projekt létrehozásáról szóló útmutatót az Új projekt létrehozása cikkben találod. Megbeszélhetsz velünk egy bevezető megbeszélést is, ahol végigvezetünk az alapokon. ## **Mi a Mergado Audit és miért érdemes használni?** A [Mergado Audit](https://audit.mergado.com/) a termék feeded ingyenes ellenőrzése. Feltárja a hibákat és hiányosságokat, és javaslatot ad a javításukra. Új projekt létrehozásakor és bármikor máskor is elindítható. ## **Kell rendszeresen valamit csinálnom a Mergadóban?** Igen. A piacok, a kínálat és a csatornák feltételei változnak, ezért rendszeres karbantartás szükséges. De nem kell órákat töltened vele – a legtöbb dolgot néhány perc alatt elvégezheted, például hetente egyszer vagy a webáruházad nagyobb változásainál. ## **Hol találok segítséget, ha elakadok?** * Ingyenes technikai ügyfélszolgálat – írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre (H–P, 9:00–16:00). * Ingyenes onboarding – egyórás bevezető megbeszélés. * Ingyenes [webináriumok](https://www.mergado.hu/mergado-academy) – gyakorlati képzések. * [Mergado Fórum](https://forum.mergado.hu/) – útmutatók és közösség. * [Mergado Blog](https://www.mergado.hu/blog) – cikkek és esettanulmányok. * [Tanúsított partnerek](https://www.mergado.hu/minositett-partnerek) – szakértők igazolt tapasztalattal. ## **Ki felel a beállítási hibákért?** Szívesen nyújtunk útmutatókat és támogatást, de a beállításaid helyességéért te felelsz. Javasoljuk, hogy a módosítások után ellenőrizd a kimeneteket, és bizonytalanság esetén konzultálj velünk. --- ## [Projekt áthelyezése másik webáruházba](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/projektkezeles-a-mergadoban/projekt-athelyezese-masik-webaruhazba/) # **Projekt áthelyezése másik webáruházba** Több webáruházat kezelsz a Mergadóban, és véletlenül rossz webáruház alá hoztad létre a projektet? Semmi gond! Ha az eredeti és a cél webáruházhoz is **Tulajdonos vagy Írás jogosultságod van**, egyszerűen magad áthelyezheted a projektet a megfelelő webáruház alá. ℹ️ A projektek áthelyezésekor ne feledd, hogy a [Felhasználási feltételek](https://www.mergado.hu/podminky-uzivani) szerint egyetlen webáruházon belül nem működtethetsz több különböző online áruházat. Ha tehát két online áruházad van, mindkettőnek saját domainen, a Mergadóban is két webáruházat kell létrehoznod, és alattuk az egyes hirdetési platformokhoz a megfelelő projekteket. ## **Áthelyezés lépései** 1. A *[Felhasználói adatok](https://app.mergado.com/user/details/)* oldalon a felhasználói fiókodban kattints arra a webáruházra, amelyben az áthelyezni kívánt projekt található. 2. Az áthelyezni kívánt projektnél kattints jobbra a fogaskerék ikonra – ez a *Projekt általános beállításai* oldalra visz. 3. Görgess le a *Projekt áthelyezése másik webáruházba* részhez, és kattints a *Projekt áthelyezése* gombra. 4. A *Cél webáruház* mezőben válaszd ki a célwebáruházat. 5. Kattints az *Áthelyezés* gombra. 6. A projekt az új webáruház alá kerül **a teljes változási előzményeivel és beállításaival együtt**. ## **Áthelyezés olyan webáruházba, amelyhez nincs hozzáférésed** Ha olyan webáruházba kell áthelyezned a projektet, amelyhez csak Olvasás jogosultságod van, vagy amelyhez a Mergadóban nincs semmilyen kapcsolatod, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre, és mi áthelyezzük a projektet. Szükségünk lesz **a cél webáruház Tulajdonosának e-mailes megerősítésére**, amelyben igazolja, hogy az általad létrehozott projekt áthelyezhető az ő webáruháza alá. ## **GYIK** ### **Hogyan helyezem át a projektet másik webáruházba?** 1. A *Felhasználói adatok* oldalon a fiókodban kattints arra a webáruházra, ahol a projekt található. 2. Az áthelyezni kívánt projektnél kattints a fogaskerék ikonra – ez a *Projekt általános beállításai* oldalra visz. 3. A *Projekt áthelyezése másik webáruházba* részben kattints a *Projekt áthelyezése* gombra. 4. Válaszd ki a cél webáruházat, és kattints az *Áthelyezés* gombra. ### **Áthelyezhetek projektet olyan webáruházba, amelyet nem én kezelek?** Ha olyan webáruházba kell áthelyezned a projektet, amelyhez csak Olvasás jogosultságod van, vagy amelyhez nincs kapcsolatod a Mergadóban, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. Szükségünk lesz a cél webáruház Tulajdonosának e-mailes megerősítésére, hogy beleegyezik a projekt áthelyezésébe. ### **Mi a teendő, ha véletlenül rossz webáruház alá hoztam létre a projektet?** Egyszerűen áthelyezheted: 1. A *Felhasználói adatok* oldalon a fiókodban kattints arra a webáruházra, ahol a projekt található. 2. Az áthelyezni kívánt projektnél kattints a fogaskerék ikonra – ez a *Projekt általános beállításai* oldalra visz. 3. A *Projekt áthelyezése másik webáruházba* részben kattints a *Projekt áthelyezése* gombra. 4. Válaszd ki a cél webáruházat, és kattints az *Áthelyezés* gombra. A projektet törölni és újra létrehozni nem kell – **az áthelyezéssel minden beállítás megmarad**. ### **Lehet egyetlen webáruházon belül a Mergadóban több különböző online áruházat működtetni?** Nem, a [Felhasználási feltételek](https://www.mergado.hu/podminky-uzivani) szerint egyetlen webáruházon belül nem működtethetsz több különböző online áruházat. Ha több webáruházad van, mindegyiknek saját webáruháznak kell lennie a Mergadóban is, és alattuk hozd létre a hozzájuk tartozó projekteket. --- ## [Projekt duplikálása a Mergadóban](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/projektkezeles-a-mergadoban/projekt-duplikasa-mergadoban/) # **Projekt duplikálása a Mergadóban** Létre kell hoznod egy új projektet, ami lényegében megegyezik egy meglévővel, de nem akarod újra létrehozni az összes szabályt? Új webáruházat hozol létre a Mergadóban – egy másik webáruházad nyelvi mutációjaként, más domainen –, és szinte azonos projekteket szeretnél benne? Ki akarsz próbálni néhány új szabályt, de nem akarod kockáztatni az éles projektet? Vagy csak biztonsági mentést készítenél? Mindezeket megoldja a *Projekt duplikálása* funkció: **egyetlen kattintással** másolatot készíthetsz a kiválasztott projektről. Duplikáláskor megadhatod, hogy a másolatot ugyanabba a webáruházba vagy egy másikba hozza létre – ahhoz, amelynek Tulajdonosa vagy, vagy amelyhez Írás jogosultságod van. A duplikálás során **az összes szabály is másolódik**, így rengeteg időt spórolsz meg. Az új projektben elég például kicserélni a bemeneti feedet, elvégezni néhány módosítást – és kész. ## **Milyen információk kerülnek át a duplikált projektbe** Duplikáláskor egy új, önálló projekt jön létre a választott névvel, a kiválasztott webáruház alatt. Az eredeti projektből szinte minden átkerül: * a bemeneti feed URL-je és formátuma * a kimeneti feed formátuma * az összes létrehozott lekérdezés * az összes létrehozott szabály (valamint néhány, a bővítmények által létrehozott szabály is, amelyek az eredeti projekten futottak) * az összes létrehozott elem és változó (a bővítmények által létrehozott elemek értékkel csak akkor töltődnek fel, ha az új projekten is elindítod a megfelelő bővítményt) Ami nem kerül át: * az eredeti projekten bekapcsolt bővítmények **nem indulnak el automatikusan** (és egyes bővítmények által létrehozott szabályok sem kerülnek át) * a termékek kézi módosításai * az eredeti projekt módosítási és változtatási előzményei * **új kimeneti URL jön létre** ℹ️ Ha a duplikált projektnél módosítani szeretnéd a bemeneti vagy kimeneti feed formátumát, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ## **Projekt duplikálása lépésről lépésre** 1. A *Felhasználói adatok* oldalon a fiókodban kattints arra a webáruházra, ahol a duplikálni kívánt projekt található. 2. A duplikálni kívánt projektnél kattints a fogaskerék ikonra – ez a *Projekt általános beállításai* oldalra visz. 3. A *Duplikálás* részben add meg az új projekt nevét és válaszd ki a cél webáruházat. 4. Kattints a *Duplikálás* gombra. 5. A duplikálás befejezésekor e-mail értesítést kapsz. ## **GYIK** ### **Mire szolgál a Projekt duplikálása funkció?** A projekt duplikálása lehetővé teszi, hogy gyorsan létrehozz másolatot egy meglévő projektről – ugyanabban vagy másik webáruházban (amelyhez Tulajdonos vagy Írás jogosultságod van). Hasznos új szabályok teszteléséhez, biztonsági mentéshez, vagy ha szeretnéd újrafelhasználni a meglévő beállításokat anélkül, hogy mindent újra létre kellene hoznod. ### **Milyen információk kerülnek át a duplikált projektbe?** Szinte minden: a bemeneti feed URL-je és formátuma, a kimeneti feed formátuma, a lekérdezések, az összes szabály (köztük néhány bővítmény által létrehozott) és az összes elem és változó. ### **Van valami, ami nem kerül át a duplikált projektbe?** Az eredeti projekten bekapcsolt bővítmények nem indulnak el automatikusan, és egyes bővítmények által létrehozott szabályok sem kerülnek át. Szintén nem másolódnak a termékek kézi módosításai és az eredeti projekt módosítási előzményei. Új kimeneti feed URL jön létre. ### **Hogyan hozok létre másolatot egy projektről?** A *Felhasználói adatok* oldalon kattints arra a webáruházra, ahol a projekt található, majd a projektnél kattints a fogaskerék ikonra. A *Projekt általános beállításai* oldalon a *Duplikálás* részben add meg az új projekt nevét, válaszd ki a cél webáruházat, és kattints a *Duplikálás* gombra. A duplikálás befejezésekor e-mail értesítést kapsz. ### **Mi a teendő, ha a duplikált projektnél módosítani szeretném a bemeneti vagy kimeneti feed formátumát?** Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ### **Duplikálhatok projektet olyan webáruházba, amelynek nem vagyok Tulajdonosa?** Igen, ha a cél webáruházhoz Írás jogosultságod van. Ha csak Olvasás jogosultságod van, vagy semmilyen jogosultságod sincs, nem tudod duplikálni a projektet az adott webáruházba. ### **Hogyan hozok létre új projektet, ami szinte megegyezik egy másik projektemmel, anélkül, hogy újra létrehoznám az összes szabályt?** A Projekt duplikálása funkcióval gyorsan létrehozhatsz másolatot az összes szabállyal és beállítással együtt. Válaszd ki az eredeti projektet, add meg a cél webáruházat, és kattints a *Duplikálás* gombra. Ezután kicserélheted a bemeneti feedet, vagy elvégezheted a szükséges módosításokat. Ha a duplikált projektnél módosítani akarod a bemeneti vagy kimeneti feed formátumát, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ### **Hogyan próbálhatok ki új szabályokat a meglévő projekt kockáztatása nélkül?** A legegyszerűbb megoldás a meglévő projekt duplikálása. A másolaton kipróbálhatod az új szabályokat – az eredeti projekt érintetlen és működőképes marad. ### **Hogyan készíthetek biztonsági mentést az aktuális projektről?** Duplikálással létrehozhatsz biztonsági másolatot, amely tartalmazza az összes szabályt és beállítást. Szükség esetén bármikor felhasználhatod vagy módosíthatod. --- ## [Projekt előzmények megtekintése a Mergadóban](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/projektkezeles-a-mergadoban/projekt-elozmenyek-megtekintese/) # **Projekt előzmények megtekintése a Mergadóban** Valami nem úgy működik a projektedben, ahogy kellene, és nem tudod, hol történt a hiba? Elemzed a hirdetésedet, és tudni szeretnéd, miért voltak bizonyos ingadozások? A webáruházadat több felhasználó kezeli, és meg kell tudnod, ki és mikor állított be bizonyos szabályokat? Az adott projekt feedjében történt összes fontos eseményt és változást az *Előzmények* oldalon találod. Könnyen feltárhatod, hol történt hiba, vagy felhasználhatod az adatokat elemzéshez és a projekten végzett további munkához. Az előzményeket szűrheted az esemény típusa (pl. termékimport, szabályok alkalmazása, letöltés, bővítmény bekapcsolása, lekérdezések), dátum vagy a módosítást végző felhasználó alapján. Minden eseményt a jobb oldali nyílra kattintva kibonthatsz a részletekért. A teljes *Előzményeket* **CSV fájlba is letöltheted** – például a Mergadón kívüli elemzéshez. ## **Milyen információkat találok a projekt előzményeiben** Megtudhatod, mikor jött létre a projekt, mikor lett ki- vagy bekapcsolva, mikor lettek alkalmazva a szabályok, **ki hozta létre őket**, mikor volt újragenerálva, vagy mikor történt **termékimport/export**. Láthatod, mikor töltötte le az adataidat egy másik személy vagy hirdetési platform, és megtalálod a **letöltő IP-címét** vagy az úgynevezett UserAgentet. ## **Milyen információk nincsenek a projekt előzményeiben** Az importált értékekre vonatkozó információk **nem tárolódnak**. Tehát azt nem tudod meg, mikor és milyen értékek kerültek konkrét elemekbe. ## **Előzmények megtekintése** 1. A *Felhasználói adatok* oldalon a fiókodban kattints arra a webáruházra, ahol a projekt található. 2. Kattints a kiválasztott projektre. 3. Az oldal bal paneljén kattints az *Előzmények* fülre. 4. Megjelenik a projekt eseményeinek és változásainak teljes listája. 5. Szükség szerint szűrheted az előzményeket eseménytípus, dátum vagy felhasználó alapján. ## **GYIK** ### **Hol találom a projekt változásainak és eseményeinek részleteit?** Az *Előzmények* oldalon. A fiókodban menj a *Felhasználói adatok* oldalra, kattints a webáruházra, majd a projektre. A bal panelen kattints az *Előzmények* fülre. ### **Mit találok a projekt előzményeiben?** Az összes fontos eseményt és változást: a projekt létrehozását, ki-/bekapcsolást, szabályok alkalmazását, termékimportot/exportot, adatletöltéseket és sok mást. Megtudhatod, ki és mikor végzett módosításokat, és további részleteket is kaphatsz, pl. a letöltő IP-címéről vagy UserAgentjéről. ### **Szűrhetők az előzmények?** Igen, eseménytípus (pl. termékimport, szabályok alkalmazása, letöltés), dátum vagy a módosítást végző felhasználó alapján. ### **Letölthetők az előzmények egyetlen fájlba?** Igen, a teljes előzmények letölthetők CSV fájlba – például a Mergadón kívüli elemzéshez. ### **Hogyan tudhatom meg, mikor volt újragenerálva a projekt, vagy mikor történt import/export?** Az *Előzmények* oldalon megtalálod a konkrét dátumot és időpontot minden importhoz, exporthoz, újrageneráláshoz és szabályalkalmazáshoz. ### **Megtudhatom, mikor és milyen értékek kerültek konkrét elemekbe?** Nem, ezeket az információkat a projekt előzményei nem tartalmazzák. --- ## [Projekt ki- és bekapcsolása a Mergadóban](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/projektkezeles-a-mergadoban/projekt-ki-es-bekapcsolasa-mergadoban/) # **Projekt ki- és bekapcsolása a Mergadóban** Létrehoztál egy projektet egy speciális hirdetési platformhoz (pl. Favi vagy Biano), de éppen nincs kapacitásod foglalkozni vele? A projekt most inkább csak költség lenne, de a jövőben újra be akarod indítani? Szezonális termékeket árulsz (pl. síléceket vagy karácsonyfákat), amelyeket csak szezonban érdemes hirdetni, és szezonon kívül szüneteltetni szeretnéd a projektet? Optimalizálni szeretnéd a költségeket, és úgy döntöttél, hogy egy időre szünetet tartasz valamelyik projekttel? Vagy csak elfelejtettél időben fizetni a Mergado számláját, és szeretnéd az emiatt kikapcsolt projekteket újra aktiválni? Ezek egyikét sem kell **a projekt törlésével vagy új projektek létrehozásával** megoldanod. Ha a webáruházhoz, amelyhez a projekt tartozik, Tulajdonos vagy Írás jogosultságod van, egyszerűen ki- vagy bekapcsolhatod a kiválasztott projektet. Ha ideiglenesen ki vagy újra be szeretnél kapcsolni egy projektet, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. Ha a kérésed számlázási okokból merül fel (például határidő után fizetett számla miatt), írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ℹ️ Ha az ideiglenesen kikapcsolni kívánt projektekhez fizetős Mergado bővítmények is be vannak kapcsolva, ezek a projekt kikapcsolásával automatikusan szintén kikapcsolódnak. Ha azonban webáruház- vagy felhasználói szinten vannak bekapcsolt fizetős bővítményeid, javasoljuk, hogy a projekt kikapcsolásának idejére ezeket is kapcsold ki. Egyes bővítmények ugyanis inaktív exporttal is képesek működni, és így **számlázásra kerülhetnek**. ## **GYIK** ### **Hogyan kapcsolom ki a projektet törlés nélkül?** Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. A kiválasztott projektet bármikor ki- vagy bekapcsoljuk. ### **Hogyan kapcsolom be az ideiglenesen kikapcsolt projektet?** Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. Ha a projektet késedelmes számlafizetés miatt kapcsolták ki, írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ### **Szüneteltethetem a projektet törlés nélkül?** Igen, a projekteket egyszerűen ki- és bekapcsolhatod anélkül, hogy törölnöd és újra létrehoznod kellene őket. Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre, és mi intézzük. ### **Mi a teendő, ha a projektem kifizetetlen számla miatt lett kikapcsolva?** Írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ### **Mi a teendő, ha szezonális projektemet nem akarom most futtatni, de a következő szezonra meg szeretném tartani?** A projektet törlés nélkül kikapcsolhatod. A következő szezonban egyszerűen újra aktiváltatod. Írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. --- ## [Projekt törlése a Mergadóban](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/projektkezeles-a-mergadoban/projekt-torlese-a-mergadoban/) # **Projekt törlése a Mergadóban** Ha úgy döntöttél, hogy véglegesen eltávolítasz egy projektet (pl. már nem akarsz hirdetni egy bizonyos platformon, vagy csökkenteni szeretnéd a költségeket), és **biztos vagy benne, hogy soha nem térsz vissza hozzá**, egyszerűen törölheted. *TIPP! Ha a projektet csak ideiglenesen nem akarod használni (pl. szezonális termékeknél szezonon kívül), javasoljuk, hogy inkább [kapcsold ki a projektet](../projekt-ki-es-bekapcsolasa-mergadoban/), és a megfelelő pillanatban kapcsold vissza.* ## **Törlés lépései** 1. A *Felhasználói adatok* oldalon a fiókodban kattints arra a webáruházra, ahol a törölni kívánt projekt található. 2. A törölni kívánt projektnél kattints a fogaskerék ikonra – ez a *Projekt általános beállításai* oldalra visz. 3. A *Projekt törlése* részben jelöld be a megerősítő jelölőnégyzetet. 4. Kattints a *Projekt törlése* gombra. 5. A törlés után e-mail értesítést kapsz. ## **Véletlenül törölt projekt visszaállítása** Ha véletlenül törölted a projektet, **azonnal** írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre vagy hívj minket a +420 530 513 050 számon. *TIPP! A visszaállítás **csak röviddel a törlés után lehetséges**, és csak **munkaidőben** tudunk segíteni. Ha több projektet is tervezel törölni, ezt munkanapokon, lehetőleg délelőtt végezd, hogy legyen időnk reagálni.* ## **GYIK** ### **Hogyan törlök projektet a Mergadóban?** A *Felhasználói adatok* oldalon kattints arra a webáruházra, ahol a projekt található. A projektnél kattints a fogaskerék ikonra, majd a *Projekt általános beállításai* oldalon a *Projekt törlése* részben jelöld be a megerősítő jelölőnégyzetet, és kattints a *Projekt törlése* gombra. A törlés után e-mail értesítést kapsz. ### **Visszaállíthatom a véletlenül törölt projektet?** Igen, de csak röviddel a törlés után. Azonnal írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre, vagy hívj minket a +420 530 513 050 számon. ### **Mi a teendő, ha nem akarom, hogy a projekt aktív legyen, de a jövőben újra szükségem lesz rá?** Nem kell törölnöd. Inkább [kapcsold ki a projektet](../projekt-ki-es-bekapcsolasa-mergadoban/), és amikor újra szükséged van rá, visszakapcsoltatod. --- ## [Új projekt létrehozása a Mergadóban](https://help.mergado.com/hu/mergado-editor/altalanos-a-mergadorol/projektkezeles-a-mergadoban/uj-projekt-letrehozasa-mergadoban/) # **Új projekt létrehozása a Mergadóban** Belépnél egy új hirdetési platformra (pl. Heureka, Sklik, Google, Kaufland vagy ChatGPT), és ehhez a Mergadót választottad? Új projektet pár lépéssel, egyedül is létrehozhatsz. ## **Mi a különbség a webáruház és a projekt között** A Mergadóban a webáruház fogja össze az egyes projekteket. Egy webáruház alatt annyi projekted lehet, amennyire szükséged van. Képzeld el a Mergadóban lévő webáruházat úgy, mint a saját online boltodat (pl. az-en-webaruhazam.hu), a projekteket pedig úgy, mint azokat a platformokat, amelyeken ennek a webáruháznak a termékeit hirdetni szeretnéd (pl. Heureka, Allegro, ChatGPT, Facebook stb.). Ha több online boltod van, hozz létre a Mergadóban mindegyikhez külön webáruházat, és alattuk add hozzá az egyes projekteket. Minden webáruház külön van számlázva. ℹ️ A Mergado [Felhasználási feltételei](https://www.mergado.hu/podminky-uzivani) szerint egyetlen webáruházon belül nem működtethetsz több különböző online áruházat. Ha tehát két online áruházad van, mindkettőnek saját domainen, a Mergadóban is két webáruházat kell létrehoznod, és alattuk a megfelelő projekteket az egyes hirdetési platformokhoz. ## **Mi a termék feed** A termék (vagy adat-) feed egy strukturált adatfájl, amely elemeket tartalmaz. Ezek az elemek hordozzák az általad értékesített áruk adatait – például neveket, leírásokat, árakat, elérhetőséget és kategóriákat. A projekt létrehozásához ezeket a strukturált adatokat kell biztosítanod a Mergadónak. A Mergadóba töltött feedet **bemeneti feednek** nevezzük. A **kimeneti feed** ezzel szemben tartalmazza az összes adatodat és a Mergado Editorban elvégzett módosításokat – testre szabottan készen áll a hirdetési platform számára. bemeneti feed → Mergado → kimeneti feed ## **Mi a termék feed formátuma** Ahogy a dokumentumaidat elmentheted Word (docx) vagy Excel (xlsx) formátumban, a termék feed is különböző formátumokban tárolható. A leggyakoribbak az XML, CSV, JSON és a Google Sheet. A Mergado mindegyiket támogatja – te döntöd el, melyikben töltöd be a bemeneti feededet. A projekt létrehozásakor azt is kiválasztod, milyen formátumban legyen a kimeneti feed. Ezt aszerint válaszd, melyik platformnak szánsz adatokat (pl. Heureka, Google, Kaufland Marketplaces). Ha a projektet csak adatmódosításra akarod használni (pl. saját webáruházadon belül), a bemeneten és a kimeneten ugyanazt a formátumot válaszd. ## **A bemeneti feed URL-je** A bemeneti feed betöltéséhez meg kell adnod a Mergadónak a feed URL-jét – azt a hivatkozást, ahol a feed tárolva van. Ez nem a webáruházad főoldalának a címe, hanem közvetlenül az az URL, ahol a termékadatok vannak. A feed URL-jét általában a webáruház-platformod adminisztrációjában vagy a rendszergazdánál találod. Például: *https://webaruhaz.hu/feed.xml* Ha a webáruházad Prestashop, WooCommerce vagy Opencart platformon fut, használhatod az ingyenes [Mergado Pack](https://pack.mergado.hu/) bővítményünket, amely segít létrehozni az XML fájlt a Mergadóhoz. Ha a feeded FTP szerveren van, és nincs hozzá nyilvános URL, a [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about) bővítmény nyilvánosan elérhető URL-re alakítja az adatokat. ℹ️ A Mergado a bemeneti feededet a 81.31.39.112 IP-ről tölti le. Ha a feedjeid védelméhez IP whitelistet használsz, add hozzá a Mergado IP-jét. ## **Projekt létrehozása** 1. A Mergadóba való bejelentkezés után kattints az *Új projekt* gombra. Ez a projekt létrehozási oldalra visz, ahol néhány lépésben elvégzed a beállítást. > Ha először vagy a Mergadóban, javasoljuk, hogy először nézd meg a [Mergado Editor Útmutatót](https://app.mergado.com/guide), ahonnan a *Projekt létrehozása* gombra kattintva is eljutsz a projekt létrehozásához. 2. Az első lépésben kattints a *Webáruház* mezőre, és válaszd ki, melyik webáruház alá kerüljön az új projekt. a. Ha először vagy a Mergadóban (még nincs webáruházad) vagy teljesen új webáruház alá szeretnéd létrehozni a projektet, kattints a *Webáruház létrehozása* gombra. Írd be az új webáruház nevét és kattints a *Megerősítés* gombra. b. Ha már vannak webáruházaid a Mergadóban, válaszd ki a kívántat a listából. 3. Kattints a *Tovább* gombra. 4. A következő lépésben válaszd ki a *bemeneti feed forrását* (azt a helyet, ahol a termékadataid vannak). A következő lehetőségek közül választhatsz: a. Termék feed (URL) -- ha a termék feeded URL-en érhető el, kattints a *Feed URL használata* gombra b. Shopify -- ha a webáruházad Shopify platformon fut, kattints a *Csatlakozás Shopify-on keresztül* gombra c. UNAS -- ha a webáruházad UNAS platformon fut, kattints a *Csatlakozás UNAS-on keresztül* gombra d. Malfini - beszállítói feed -- ha a Malfini szállítói feedet szeretnéd csatlakoztatni, kattints a *Malfini csatlakoztatása* gombra 5. Az egyes csatlakoztatási módokat a cikk következő részében mutatjuk be részletesen. Miután csatlakoztattad az adatokat, kattints a *Tovább* gombra. 6. A következő lépésben válaszd ki a *kimeneti feed formátumát* (vagyis az adataid célállomását). Válaszd ki a platformot, amelyen hirdetni szeretnél (pl. Heureka, Google, Facebook, marketplace stb.), és kattints a *Tovább* gombra. > A Mergado a bemeneti feed elemzése alapján előválasztja a kimeneti formátumot. Természetesen bármelyik formátumot választhatod. > Ha az elérhető kimeneti formátumok egyike sem felel meg, kattints az *Egyedi formátum meghatározása* gombra. 7. Az utolsó lépésben ellenőrizd (és szükség esetén a ceruza ikonra kattintva módosítsd), hogy minden beállítás rendben van-e. > A projekt neve automatikusan a kimeneti formátum neve lesz. Ezt is módosíthatod a ceruza ikonra kattintva. > Látni fogod a *Párosító elemek* módosításának lehetőségét is. Ezek egyedi adatokat tartalmaznak, amelyek alapján a Mergado megkülönbözteti az egyes termékeket. A Mergado automatikusan javasolja a legmegfelelőbb elemeket – módosításuk haladó funkció, amelyre az első projektednél valószínűleg nem lesz szükséged. 8. Kattints a *Befejezés* gombra. A Mergado elkezdi letölteni és importálni az adatokat. Az import sebessége a feed méretétől függ – kis feednél gyors, **több tízezer termékes feednél néhány percig tarthat**. A projekt létrehozása után *megjelenik a kimeneti feed URL-je*. Ezt az URL-t *illeszd be abba a platformba, amelyhez a projektet létrehoztad*. A projekt összes adatához bármikor hozzáférhetsz a *[Felhasználói adatok](https://app.mergado.com/user/details/)* oldalon a Mergado fiókodban. Az adott webáruházra kattintva megjelenik az összes projekt listája, a projektre kattintva pedig minden részlet, köztük a kimeneti feed URL-je. ℹ️ Ha egy már meglévő webáruház alá hozol létre új projektet, és az új aktív projekttel túllépnéd a jelenlegi előfizetési csomag limitjét, e-mail értesítést kapsz a csomagváltásról. Ha az új projektet újonnan létrehozott webáruház alatt hozod létre, a számlázásban új tétel jelenik meg a megfelelő csomaggal. ## **Különböző termékadatforrások csatlakoztatása** ### **Termék feed (URL)** Ezt a lehetőséget válaszd, ha rendelkezésedre áll a termék feeded URL-je, amelyet a *webáruház-platformod adminisztrációjában vagy a rendszergazdánál* szereztél meg. Vagy ha már használod a Mergadót és bemeneti feedként például egy másik projekted kimeneti feedjét szeretnéd használni. 1. Miután kiválasztottad/létrehoztad a webáruházat, kattints a *Feed URL használata* gombra. 2. Add meg a bemeneti feed URL-jét: a. Az *Add meg a bemeneti feed URL címét* mezőbe illeszd be a termék feeded URL-jét. b. Ha már használod a Mergadót és egy másik projekted feedjét szeretnéd bemeneti feedként használni, válaszd ki a *Meglévő URL* mezőben a kívánt feedet. 3. Kattints a *Tovább* gombra. 4. Ebben a lépésben a Mergado automatikusan felismeri a bemeneti feeded formátumát. Kattints a *Tovább* gombra. a. Ha a Mergado nem ismerte fel helyesen a formátumot, kattints a *Másik formátum kiválasztása* gombra, válaszd ki a helyes formátumot és kattints a *Tovább* gombra. b. Ha a bemeneti feeded formátuma nem szerepel a listában (pl. nagyon specifikus szállítói feed), kattints az *Egyedi formátum meghatározása* gombra, állítsd be a forrás formátumát, majd kattints a *Mentés és tovább* gombra. 5. Ezután fejezd be a projekt létrehozását a *Projekt létrehozása* fejezetben leírt lépések szerint. ### **Shopify** Ezt a csatlakozási módot javasoljuk mindenkinek, aki *Shopify platformon működteti a webáruházát*. A Shopify alapból nem teszi lehetővé a termék feed exportját (csak fizetős alkalmazással). A közvetlen Mergado–Shopify integráció egyszerűsíti a csatlakoztatást: API-n keresztül működik, tehát a Mergadónak nincs szüksége feedre – a termékadatokat közvetlenül a webáruházadból veszi. 1. Miután kiválasztottad/létrehoztad a webáruházat, kattints a *Csatlakozás Shopify-on keresztül* gombra. 2. Töltsd ki a *Shopify Store URL az Admin API-hoz* mezőt *nev.myshopify.com* formátumban. Megtalálod a webáruházad adminisztrációjában a *Beállítások* menüben a webáruházad neve alatt (pl. az-en-boltom.myshopify.com). 3. Töltsd ki a *Client ID* és *Client Secret* mezőket. > A Shopify API Credentials (Client ID és Client Secret) beszerzéséhez szóló útmutatót a Mergado Keychain kapcsolatok céljai cikkben találod. 4. Kattints a *Tovább* gombra. 5. Ezután fejezd be a projekt létrehozását a *Projekt létrehozása* fejezetben leírt lépések szerint. ### **UNAS** Ezt a csatlakozási módot javasoljuk mindenkinek, aki *UNAS platformon működteti a webáruházát*. A közvetlen Mergado–UNAS integráció API-n keresztül működik, tehát a Mergadónak nincs szüksége feedre – a termékadatokat közvetlenül a webáruházadból veszi. 1. A webáruház adminisztrációjában menj a *Beállítások → Külső kapcsolatok → Piacterek* menübe. 2. A megnyíló oldalon hozd létre az új API kulcsot a Mergado boxban található *Hozzáad* gombra kattintva. 3. Másold ki az *API kulcsot* és a *webáruház ID-t*. 4. A Mergado Editorban új projekt létrehozásakor válaszd adatforrásként az *UNAS*-t. 5. A projekt létrehozási varázslóban add meg az *API kulcsot* és a *webáruház ID-t*. 6. Válaszd ki a kimeneti formátumot, és fejezd be a projekt létrehozását. > 💡 **Tipp:** Az UNAS csatlakoztatása a Mergado Keychainben is elvégezhető. Így a projekt létrehozásakor nem kell újra megadnod az adatokat. Ha elakadsz az UNAS csatlakoztatásával, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ### **Szállítói feed Malfini** Ezt a csatlakoztatást ajánljuk azoknak a *webáruház-tulajdonosoknak, akiknek a Malfini a szállítójuk*, és a termékeiket egyszerűen, pár kattintással szeretnék a webáruházukba bevinni. Az adatokat a választott nyelven importálhatod, módosíthatod a neveket, árakat – a Malfini adatai mindig naprakészek maradnak. További előny, hogy ha Shoptet, Shopify vagy WooCommerce platformot használsz, a *Mergado néhány szabályt előre elkészít* – például az eladási ár kiszámításához, kiválasztott kategóriák elrejtéséhez vagy terméknevek módosításához. 1. Miután kiválasztottad/létrehoztad a webáruházat, kattints a *Malfini csatlakoztatása* gombra. 2. Válaszd ki a *Malfini forrásfájlt*, vagyis az importálni kívánt adatok nyelvi verzióját. 3. Kattints a *Tovább* gombra. 4. Válaszd ki az adatok kimeneti formátumát (a webáruház-platformodat, esetleg más formátumot) és kattints a *Tovább* gombra. 5. Ezután fejezd be a projekt létrehozását a *Projekt létrehozása* fejezetben leírt lépések szerint. ## **GYIK** ### **Mi a "projekt" a Mergadóban?** A Mergadóban a projekt egy konkrét adatbeállítást jelent, amelyet egy bizonyos platformra küldesz. Például ha a webáruházad adatait egy hirdetési platformra (Heureka, Google, Facebook, Kaufland stb.) szeretnéd küldeni, és közben a Mergadóban az adott platform igényeihez igazítod azokat. Projektet akkor is létrehozol, ha nem akarsz adatokat másik platformra küldeni, hanem a Mergadóban akarod módosítani – a módosított adatok visszakerülnek a webáruházadba. ### **Mi a "webáruház" a Mergadóban?** A Mergadóban a webáruház fogja össze azokat a projekteket, amelyek egy online boltodhoz tartoznak. Képzeld el úgy, mint a saját webáruházadat (pl. az-en-webaruhazam.hu), alatta a projekteket pedig úgy, mint azokat a platformokat, amelyeken a termékeit hirdetni akarod (pl. Heureka, Allegro, ChatGPT, Facebook stb.). Ha több webáruházad van, hozz létre mindegyikhez sajátot a Mergadóban is. ### **Lehet egy webáruház alatt több projektem?** Igen, annyi projekted lehet, amennyire szükséged van. Minden projekt egy másik platformra szól – például az egyik a Heurekára, a második a Google Ads-re, a harmadik a Facebookra. A Mergado [Felhasználási feltételei](https://www.mergado.hu/podminky-uzivani) szerint azonban egyetlen webáruházon belül nem működtethetsz több különböző online áruházat. Ha tehát két online áruházad van, mindkettőnek saját domainen, a Mergadóban is két webáruházat kell létrehoznod. ### **Mikor kell új webáruházat és mikor csak új projektet létrehozni?** Új webáruházat akkor hozz létre, ha teljesen más online boltról van szó (más domainnel). Új projektet akkor, ha ugyanannak az online boltnak a termékeit szeretnéd hirdetni egy újabb platformon, amelyhez már van webáruházad a Mergadóban. ### **Mi a termék feed?** A termék feed egy strukturált adatfájl, amely tartalmazza a termékeid összes adatát: neveket, árakat, leírásokat, elérhetőséget és egyebeket. ### **Mi a különbség a bemeneti és a kimeneti feed között?** A bemeneti feed az, amelyet a Mergadóba küldesz (a forrásadatok a webáruházadból). A kimeneti feed az, amelyet a Mergado hoz létre. Tartalmazza a forrásadataidat és az összes módosítást, amelyet a Mergadóban végeztél. ### **Milyen formátumú lehet a feed?** A leggyakoribb formátumok az XML, CSV, JSON és a Google Sheet. A Mergado mindegyiket támogatja, és szükség esetén egyedi formátumot is meghatározhatsz. ### **A bemeneti és kimeneti feed formátumnak ugyanannak kell lennie?** Nem, ez az adataid célállomásától függ. Ha a projektet csak belső módosításokra használod (pl. a webáruházadon belül), választhatod ugyanazt a formátumot a bemeneten és a kimeneten. ### **Mi a feed URL?** Ez egy hivatkozás arra a helyre, ahol a termékadataidat tartalmazó fájl tárolva van. Például: https://az-en-boltom.hu/feed.xml. Ez nem a webáruházad főoldalának a címe, hanem közvetlenül a termékadatfájlra mutató hivatkozás. ### **Hol szerzem meg a feed URL-jét?** Általában a webáruház-platformod adminisztrációjában találod, vagy a rendszergazda adja meg. Ha a webáruházad Prestashop, WooCommerce vagy Opencart platformon fut, használhatod az ingyenes [Mergado Pack](https://pack.mergado.hu/) bővítményt. Ha a feeded FTP szerveren van, a [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about) bővítmény segít. ### **Mi van, ha a feed FTP szerveren van és nincs hozzá URL?** Használd a [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about) bővítményt, amely nyilvánosan elérhető URL-re alakítja az FTP-n tárolt adatokat, így a Mergado dolgozni tud velük. ### **Mi a Mergado Pack?** Egy ingyenes bővítmény Prestashop, WooCommerce és Opencart platformokhoz, amely segít egyszerűen létrehozni a feedet a megfelelő formátumban a Mergado számára. ### **Mi van, ha a feed védett? A Mergado hozzáfér?** Ha a feeded védelméhez IP whitelistet használsz, add hozzá a Mergado IP-jét (81.31.39.112), hogy a rendszer le tudja tölteni a feededet. ### **Hogyan hozok létre új projektet a Mergadóban?** 1. A Mergadóba való bejelentkezés után kattints az *Új projekt* gombra. > Ha először vagy a Mergadóban, javasoljuk, hogy először nézd meg a [Mergado Editor Útmutatót](https://app.mergado.com/guide), ahonnan a *Projekt létrehozása* gombra kattintva is eljutsz. 2. Kattints a *Webáruház* mezőre és válaszd ki a webáruházat. a. Ha először vagy a Mergadóban vagy teljesen új webáruház alá hoznád létre a projektet, kattints a *Webáruház létrehozása* gombra. Írd be a nevet és kattints a *Megerősítés* gombra. b. Ha már vannak webáruházaid, válaszd ki a kívántat a listából. 3. Kattints a *Tovább* gombra. 4. Válaszd ki a bemeneti feed forrását: a. Termék feed (URL) -- ha a feeded URL-en érhető el, kattints a *Feed URL használata* gombra b. Shopify -- ha a webáruházad Shopify platformon fut, kattints a *Csatlakozás Shopify-on keresztül* gombra c. Szállítói feed Malfini -- ha a Malfini szállítói feedet akarod csatlakoztatni, kattints a *Malfini csatlakoztatása* gombra d. UNAS -- ha a webáruházad UNAS platformon fut, kattints a *Csatlakozás UNAS-on keresztül* gombra 5. Miután csatlakoztattad az adatokat, kattints a *Tovább* gombra. 6. Válaszd ki a kimeneti feed formátumát és kattints a *Tovább* gombra. > A Mergado a bemeneti feed elemzése alapján előválasztja a kimeneti formátumot. Természetesen bármelyik formátumot választhatod. > Ha az elérhető formátumok egyike sem felel meg, kattints az *Egyedi formátum meghatározása* gombra. 7. Az utolsó lépésben ellenőrizd a beállításokat. > A projekt neve automatikusan a kimeneti formátum neve lesz. A ceruza ikonra kattintva módosíthatod. > Látni fogod a *Párosító elemek* módosításának lehetőségét is. Ezek egyedi adatokat tartalmaznak, amelyek alapján a Mergado megkülönbözteti a termékeket. A Mergado automatikusan javasolja a legmegfelelőbbeket – módosításuk haladó funkció, amelyre az első projektednél valószínűleg nem lesz szükséged. 8. Kattints a *Befejezés* gombra. ### **Melyik bemeneti adatforrást válasszam?** A következő lehetőségek közül választhatsz: * Termék feed (URL) -- ha rendelkezésedre áll a feeded URL-je. * Shopify -- ha a webáruházad Shopify platformon fut. * Szállítói feed Malfini -- ha a szállítód a Malfini, és az adataikat a webáruházadba vagy hirdetési platformodra szeretnéd importálni. * UNAS -- ha a webáruházad UNAS platformon fut. ### **Hogyan válasszam ki a bemeneti feed formátumát?** A Mergado automatikusan felismeri a bemeneti feed formátumát. Ha rosszul ismeri fel, a projekt létrehozásakor kézzel módosíthatod a *Másik formátum kiválasztása* gombra kattintva. Ha a formátumod nincs a listában, kattints az *Egyedi formátum meghatározása* gombra. ### **Hogyan válasszam ki a kimeneti feed formátumát?** A kimeneti feed formátumát az adataid célállomása alapján válaszd – aszerint, melyik platformnak szánsz adatokat az adott projektben (pl. Heureka, Google, Kaufland Marketplaces). Ha a projektet belső adatmódosításra használod, a kimeneten ugyanazt a formátumot válaszd, mint a bemeneten. ### **Mik a párosító elemek?** A párosító elemek a feedben található egyedi adatok, amelyek alapján a Mergado felismeri az egyes termékeket (pl. termék ID). Általában nem kell módosítani – a Mergado automatikusan kiválasztja a megfelelőket. ### **Honnan tudom, hogy a projekt helyesen jött létre?** A bemeneti feed importálásának befejezése után megjelenik a kimeneti feed URL-je. Ezt a címet illeszd be abba a platformba, amelyhez a projektet létrehoztad. ### **Hogyan csatlakoztassam a feedet URL segítségével?** A projekt létrehozásának második lépésében kattints a *Feed URL használata* gombra, add meg a feed URL-jét, és folytasd a projekt létrehozásával. Ha már használod a Mergadót és egy másik projekted feedjét szeretnéd bemeneti feedként használni, válaszd ki a *Meglévő URL* mezőben a kívánt feedet. ### **Hogyan csatlakoztassam a Shopify webáruházamat a Mergadóhoz?** A projekt létrehozásának második lépésében kattints a *Csatlakozás Shopify-on keresztül* gombra, add meg a Shopify Store URL-t az Admin API-hoz, a Client ID-t és a Client Secretet, majd folytasd a projekt létrehozásával. A szükséges Shopify API Credentials beszerzéséhez szóló útmutatót a Mergado Keychain kapcsolatok céljai cikkben találod. ### **Hol találom a Shopify Store URL-t a Shopify Mergadóba való csatlakoztatásához?** A Shopify adminisztrációjában, a webáruházad *Beállítások* menüjében, a webáruházad neve alatt. *nev.myshopify.com* formátumban jelenik meg (pl. az-en-boltom.myshopify.com). ### **Mire szolgál a Malfini csatlakoztatás?** Ideális azoknak, akiknek a Malfini a szállítójuk, és a termékeiket egyszerűen szeretnék a webáruházukba bevinni. A Malfini termékeket a választott nyelven importálhatod, módosíthatod a neveket, árakat – az adatok mindig naprakészek maradnak. ### **Hogyan állítsam be a Malfini csatlakoztatást?** A projekt létrehozásának második lépésében kattints a *Malfini csatlakoztatása* gombra, válaszd ki a feed nyelvi verzióját, kattints a *Tovább* gombra, válaszd ki a kimeneti formátumot, és folytasd a projekt létrehozásával. ### **Hogyan csatlakoztassam az UNAS webáruházamat a Mergadóhoz?** A webáruház adminisztrációjában menj a *Beállítások → Külső kapcsolatok → Piacterek* menübe, és a Mergado boxban hozd létre az új API kulcsot. Másold ki az *API kulcsot* és a *webáruház ID-t*, majd a Mergadóban új projekt létrehozásakor válaszd adatforrásként az *UNAS*-t, és add meg ezeket az adatokat. Az UNAS csatlakoztatása a Mergado Keychainben is elvégezhető – így a következő projektnél nem kell újra megadnod az adatokat. ### **Mi van, ha az új projekt létrehozása után túllépem a jelenlegi csomagomat?** Ha egy webáruházon belül több aktív projekted van, és az újonnan létrehozottal túlléped a csomag limitjét, a Mergado e-mailben értesít a csomagváltásról. ### **Mi a teendő, ha a Mergado hibát jelez a feed importálásakor?** Ellenőrizd, hogy a feeded URL-je nyilvánosan elérhető-e. Ha IP whitelist védi, add hozzá a Mergado IP-jét (81.31.39.112). Ha a probléma fennáll, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ### **Mi a teendő, ha a projekt létrehozásakor nem mentettem el a kimeneti feed URL-jét?** Ne aggódj, a kimeneti feed URL-je sehova nem vész el. Megtalálod a Mergado fiókodban: 1. Jelentkezz be a Mergadóba és menj a *[Felhasználói adatok](https://app.mergado.com/user/details/)* oldalra. 2. A webáruházaid listájából válaszd ki azt, amelyik alá a projektet létrehoztad. 3. Megjelenik az adott webáruház összes projektje. Kattints a keresett projektre. 4. A projekt részleteiben megtalálod a kimeneti feed URL-jét, amelyet bármikor kimásolhatsz és beilleszthetsz a célplatformba. --- ## [Árszintek beállítása a Mergadóban](https://help.mergado.com/hu/mergado-editor/automatizalas/arszintek-beallitasa-a-mergadoban/) # **Árszintek beállítása a Mergadóban** ## **Mik azok az árszintek** Az árszintek beállítása azt jelenti, hogy a szortimentedet csoportokra (ún. **Lekérdezésekre**) osztod ártartomány szerint (pl. 0–199, 200–499, 500–999, 1000+ értékű termékek). A Mergadóban ez a szegmentálás lehetővé teszi, hogy jobban célozd a módosításokat (pl. árrés vagy szállítás), válaszd ki a megfelelő **kattintásonkénti árat (CPC)** a biddingnél, és hatékonyan állítsd be a PPC kampányokat az árszint szerint. Minden termékszegmens más stratégiát igényel – és annak ismerete, hogy melyik ársávban van a legtöbb terméked, a legnagyobb forgalmad vagy a legnagyobb költséged, stratégiai előnyt ad. ## **Mikor hasznos az árszintekre bontás** * Eltérő stratégiák beállítása az „olcsó" és a „prémium" termékekhez – pl. magasabb CPC a drágább termékeknél. * Szállítási költség beállítása a termékár alapján – pl. ingyenes szállítás egy bizonyos árszint felett. * Azon termékek azonosítása, amelyek a legnagyobb forgalmat vagy költséget generálják (lásd a Pricing Fox bővítmény szegmensriportját). ## **Hogyan állítsd be az árszinteket** ### **1. Beállítás Automatizálással** Az első és leggyorsabb lehetőség az előre elkészített **Automatizálás** használata. Segítségével néhány kattintással akár öt árszintet hozhatsz létre. 1. A kiválasztott projektnél lépj az **Automatizálás** oldalra. 2. Válaszd a **Szegmentálás 5 árszintre** Automatizálást. 3. Az **Automatizálás paraméterei** részben az első sorba írd be annak az elemnek a nevét, amelyben a feedben a termék árinformációja található (pl. `PRICE_VAT`). > **Tipp:** Figyelj arra, hogy a megfelelő elemet válaszd aszerint, hogy nettó vagy bruttó ár alapján szeretnéd a termékeket csoportosítani. 4. Töltsd ki a megfelelő sorokban az adott árszint felső árhatárát. 5. Kattints az ***Automatizálás futtatása*** gombra. Ha egyes árszinteket szerkeszteni, törölni vagy újakat hozzáadni szeretnél, a **Termékek** oldalon teheted meg. A **Mentett Lekérdezések** fülön megtalálod az összes Lekérdezésedet, beleértve a létrehozott árszinteket. Az árszinteket a kuka ikonra kattintva törölheted, vagy a nevükre kattintva szerkesztheted. ### **2. Manuális beállítás** Ha nem használod az Automatizálást, a csoportokat (a Mergadóban ún. Lekérdezéseket) manuálisan is létrehozhatod. Ugyanígy járj el akkor is, ha az Automatizálással már létrehoztad az öt árszintet, de továbbiakat szeretnél hozzáadni. 1. A kiválasztott projektnél lépj a **Termékek** oldalra. 2. Az oldal tetején kattints az **Egyszerű felület** lehetőségre. 3. A mezőbe írd be annak az elemnek a nevét, amely a termék árinformációját tartalmazza (pl. `PRICE_VAT`). 4. Válaszd ki az árszinthez tartozó feltételt. Például ha 200 és 999 közötti árú termékeket szeretnél: válaszd a `>=` operátort és írd be: `200`. 5. Kattints a **„+"** ikonra és töltsd ki az árszint felső határát. Ismét add meg az árat tartalmazó elemet (pl. `PRICE_VAT`), válaszd a `<=` operátort és írd be: `999`. > **Tipp:** Győződj meg róla, hogy két feltétel megadásakor a mezők mellett balra az **„and"** (azaz és egyidejűleg) felirat látható. Ha „or" (azaz vagy) felirat van ott, kattints rá, és átváltozik „and"-re. 6. Kattints a ***Keresés*** gombra. 7. Add meg a Lekérdezés nevét ehhez az árszinthez (pl. `árszint 200-tól 999-ig`). 8. Kattints a ***Mentés*** gombra. A Lekérdezést ezután a Termékek oldalon a **Mentett Lekérdezések** fülön láthatod, ahol törölheted vagy szerkesztheted. ## **Szabályok alkalmazása az árszintek szerinti Lekérdezésekre** A kívánt árszintek létrehozása után lépj a **Szabályok** oldalra, hozd létre az egyes Lekérdezésekhez szükséges szabályokat, és alkalmazd őket. ### **Különböző CPC beállítása árszint szerint** **Miért érdemes:** Ha vannak alacsony árú és alacsony árrésű termékeid, érdemes alacsonyabb CPC-t beállítani nekik, hogy a hirdetésük ne legyen veszteséges. A drágább termékeknél magasabb CPC lehet kifizetődő, mert az árrés általában nagyobb. 1. Először hozd létre a megfelelő Lekérdezéseket az árszintek szerint a fenti útmutató alapján. 2. A **Szabályok** oldalon kattints az **Új Szabály** gombra. 3. Szabály típusaként válaszd a **Kattintásonkénti árak beállítása** lehetőséget. 4. A **Lekérdezések** mezőben válaszd ki azt az árszintet, amelyhez CPC-t szeretnél beállítani. 5. Válaszd ki, hogy a kattintásonkénti árat mi alapján számítod: **a. Minimális kattintásonkénti ár** – A szabály figyelembe veszi az egyes kategóriákban a minimális CPC-t (a hirdetési platform határozza meg), és te hozzáadhatsz egy tetszőleges összeget a **Hozzáadás a minimális CPC-hez** mezőben. **b. Termékár százaléka** – A **Termékár százaléka** mezőben megadod, hogy a termékár hány százalékát ajánld CPC-ként. Pl. 1%-nál egy 500-as termék esetén a szabály 5-öt ajánl. 6. Töltsd ki a szabály nevét. 7. Kattints a **Létrehozás** gombra. 8. Ugyanígy járj el a többi árszintnél is, és ne felejtsd el a szabályokat alkalmazni. > **Tipp:** Kövesd a teljesítményt (kattintások, konverziók) külön-külön minden szintnél, és a CPC-t a tényleges jövedelmezőség alapján módosítsd. ### **Szállítási költség beállítása különböző árszintekhez** **Miért érdemes:** Az olcsóbb termékeknél az ingyenes szállítás gyakran nem kifizetődő, míg a drágábbaknál bónuszként kínálható a vásárlóknak. 1. Először hozd létre a megfelelő Lekérdezéseket az árszintek szerint a fenti útmutató alapján. 2. A **Szabályok** oldalon kattints az **Új Szabály** gombra. 3. Szabály típusaként válaszd a **Szállítási költség beállítása** lehetőséget. 4. A **Lekérdezések** mezőben válaszd ki az árszintet (vagy árszinteket), amelyhez szállítási költséget szeretnél beállítani. 5. Töltsd ki a szállítót és a szállítási költségeket előre fizetésnél és utánvételnél. 6. Töltsd ki a szabály nevét. 7. Kattints a **Létrehozás** gombra. 8. Ugyanígy járj el a többi árszintnél is, és ne felejtsd el a szabályokat alkalmazni. ### **Szortiment elemzés a Pricing Fox bővítmény szegmensriportjával** **Miért érdemes:** A portfóliód árszintekre bontásával átlátod, melyik szintben van a legnagyobb forgalmad, kattintásszámod vagy költséged, és ennek alapján hatékonyabb stratégiákat állíthatsz be. Használd a [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about) bővítményt, amelyben a szegmensriportban saját árszinteket állíthatsz be. Kiválasztod a metrikát (pl. forgalom vagy termékek száma), és részletes képet kapsz a szortimentedről. Többet a szegmensriportról [ebben a cikkben](https://pricing-fox.cz/navody/segmentovy-report#vykon-top-segmentu) vagy [videóban](https://www.youtube.com/watch?v=J3zZEfb9JUg) tudhatsz meg. > **Tipp:** Ha például azt látod, hogy az alacsony árszint sok kattintást generál, de alacsony forgalmat, fontold meg a CPC csökkentését vagy az árrés növelését ennél a szegmensnél. ### **Haladó bidding a Bidding Fox bővítménnyel** **Miért érdemes:** Az árszintek ideális alapot adnak a haladó bidding-kezeléshez a [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about) bővítménnyel, ahol az egyes szegmensekhez önálló stratégiákat választhatsz (pl. eltérő CPC vagy PNO az olcsó és prémium termékekhez). A Bidding Foxban hozz létre egy új stratégiát, ahol célként a kiválasztott árszintet választod (használhatod a Mergadóban beállított Lekérdezéseket, vagy közvetlenül a Bidding Foxban állítod be). Beállítod a célokat (pl. CPC, PNO vagy pozíció a hirdetési platformon) és elmented a stratégiát. Többet a Bidding Fox stratégiák beállításáról [ebben a cikkben](https://www.bidding-fox.cz/prvni-strategie) tudhatsz meg. > **Tipp:** Az alacsony árszinthez pl. konzervatív biddinget próbálhatsz, a közepeshez teljesítményalapú optimalizálást, a magashoz pedig agresszívebbet magasabb CPC-vel. ## **GYIK** ### **Mik azok az árszintek és miért érdemes beállítani őket?** Az árszintek ár szerint csoportosított termékcsoportok (ún. **Lekérdezések**) – pl. 0–199, 200–499, 500–999, 1000+. Lehetővé teszik a szabályok, CPC vagy szállítás testreszabását a termékár alapján, így hatékonyabbá teszik a kampányaidat. Segítenek a szortiment teljesítményének elemzésében is. ### **Hogyan állíthatom be az árszinteket?** A legegyszerűbb módja a **Szegmentálás 5 árszintre** Automatizálás – néhány kattintással akár öt Lekérdezést készíthetsz. Elég megadni az árat tartalmazó elemet (pl. `PRICE_VAT`) és az egyes szintek felső árhatárát. A szinteket utána bármikor szerkesztheted vagy törölheted. Az árszinteket manuálisan is létrehozhatod – ez ideális, ha ötnél több szintre van szükséged. ### **Szerkeszthetem az Automatizálással létrehozott árszinteket, vagy hozzáadhatok újakat?** Igen. A **Termékek → Mentett Lekérdezések** szekcióban láthatod az összes árszintet. A Lekérdezés nevére kattintva szerkesztheted (módosíthatod a határt, feltételeket vagy nevet), a kuka ikonra kattintva pedig törölheted. A **Termékek → Terméklista** szekcióban bármikor manuálisan is létrehozhatsz további Lekérdezéseket. ### **Mi van, ha több szempont alapján kell csoportosítanom a termékeket (pl. márka + árszint)?** A Lekérdezések létrehozásakor több feltételt is kombinálhatsz az **AND** (és egyidejűleg) logikai operátorral. Például: ``` BRAND = Nike AND PRICE_VAT >= 1000 AND PRICE_VAT <= 2000 ``` Így létrehozol egy Lekérdezést a Nike márka 1000 és 2000 közötti árú termékeire. ### **Hogyan állíthatok be különböző CPC-t az egyes árszintekhez?** 1. Először hozd létre a megfelelő Lekérdezéseket az árszintek szerint. 2. A **Szabályok** oldalon kattints az **Új Szabály** gombra. 3. Szabály típusaként válaszd a **Kattintásonkénti árak beállítása** lehetőséget. 4. A **Lekérdezések** mezőben válaszd ki az árszintet. 5. Válaszd ki a számítás módját: a. Minimális kattintásonkénti ár – a hirdetési platform minimuma + tetszőleges összeg b. Termékár százaléka – a termékár adott százaléka (pl. 1% → 500-as terméknél 5) 6. Töltsd ki a szabály nevét, és kattints a **Létrehozás** gombra. 7. Ugyanígy járj el a többi árszintnél is, majd alkalmazd a szabályokat. Haladóbb CPC-beállításhoz használhatod a [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about) bővítményt is. ### **Hogyan állíthatok be ingyenes szállítást a drágább termékekhez?** 1. Hozz létre egy Lekérdezést a kívánt árszint alapján (pl. `PRICE_VAT >= 1500`). 2. A **Szabályok** oldalon kattints az **Új Szabály** gombra. 3. Szabály típusaként válaszd a **Szállítási költség beállítása** lehetőséget. 4. A **Lekérdezések** mezőben válaszd ki az adott árszintet. 5. Töltsd ki a szállítót, és a költségnek állíts be 0-t. 6. Töltsd ki a szabály nevét, és kattints a **Létrehozás** gombra. 7. Ne felejtsd el a szabályt alkalmazni. ### **Hogyan tudom meg, melyik árszint hozza a legnagyobb bevételt?** Ideális erre a [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about) bővítmény szegmensriportja. Beállítod az árszintek határait, és látod, melyik szint hány terméket, mekkora forgalmat vagy költséget jelent. Ennek alapján módosíthatod a biddinget, az árrést vagy a CPC-t. Többet [ebben a cikkben](https://pricing-fox.cz/navody/segmentovy-report#vykon-top-segmentu) vagy [videóban](https://www.youtube.com/watch?v=J3zZEfb9JUg) olvashatsz. ### **Honnan tudhatom, hogy az árszintek jól vannak beállítva?** A **Termékek → Mentett Lekérdezések** oldalon ellenőrizd, hogy az egyes Lekérdezések hány terméket tartalmaznak. Ha az összes Lekérdezésben lévő termékek összege megegyezik a feedben lévő összes termék számával, a felosztás teljes. Ha egyes termékek hiányoznak, ellenőrizd, hogy a szintek határai illeszkednek-e egymáshoz, és nem fedik-e át egymást. ### **Hány árszintet hozhatok létre?** Tetszőleges számú árszintet. Az Automatizálással gyorsan legfeljebb **5-öt** készíthetsz, de továbbiakat manuálisan adhatsz hozzá a Termékek oldalon. ### **Mi a teendő, ha az árszintek szerinti Lekérdezések nem tartalmaznak egyetlen terméket sem?** Ellenőrizd: * hogy a megfelelő árat tartalmazó elemet használod-e (pl. `g:price` vagy `PRICE_VAT`) * hogy az alsó és felső árhatár feltételei helyesen vannak-e beállítva, és **AND** operátorral vannak kombinálva, nem **OR**-ral --- ## [Egyedi feed formátum (Custom Format) útmutató](https://help.mergado.com/hu/mergado-editor/feed-formatumok-es-halado-adatkezeles/egyedi-formatum/egyedi-feed-formatum-utmutato/) # **Egyedi feed formátum (Custom Format) útmutató** ## **1. Bevezetés** ### **Mi az egyedi formátum** Az egyedi formátum egy olyan funkció, amellyel megtaníthatod a Mergadót szinte bármilyen XML vagy CSV fájl felismerésére és feldolgozására. Lehetővé teszi tetszőleges feed betöltését a Mergadóba, struktúrájának definiálását, majd az adatokkal való munkát ugyanúgy, mint a beépített integrált formátumoknál. Ezenkívül lehetővé teszi olyan formátumú feed létrehozását a Mergadóban, amely nincs a hivatalos integrációk között. Az egyedi formátumot te határozod meg -- leírod a Mergadónak, milyen Elemeket importáljon vagy exportáljon, és hogyan kezelje őket. Ez a funkció elsősorban a kevésbé szokásos, módosított vagy géppel felismerhetetlen formátumokhoz készült, amelyeket a Mergado a te definíciód nélkül **nem tudna betölteni**. ### **Mire szolgál** Az egyedi formátumnak több kulcsfontosságú felhasználása van: #### **1. Bemenet és kimenet testreszabása** Lehetővé teszi az adatstruktúra igényeidhez igazítását -- a Projekt bemenetén és kimenetén egyaránt. #### **2. Nagyobb kontroll az adatok felett** Segít pontosan meghatározni, hogyan dolgozza fel, jelenítse meg és exportálja a Mergado a termékadatokat. #### **3. Ismeretlen feedek importja** Hasznos a Mergado által nem felismert formátumokkal való munkánál: beszállítói feedek, elavult vagy jelentősen módosított struktúrák, egyedi feedek vagy kiegészítő feedek (pl. készlet, utazási ajánlatok, értékelések). #### **4. A feed eredeti struktúrájának megőrzése** Ha a bemeneti XML a gyökérelem után közvetlenül tartalmazza az egyes termékeket, az egyedi formátummal megőrizheted az eredeti struktúrát módosítás nélkül -- hasznos instabil beszállítói forrásoknál. #### **5. Export egyedi formátumba** Olyan kimeneti feed létrehozására is szolgál, amelynek formátumát a Mergado hivatalosan még nem támogatja. Ez jellemző új piacokra való terjeszkedésnél vagy kisebb összehasonlítóknál. Elég egy minta feedet használni, amely legalább egy mintaelemet tartalmaz. ### **Hogyan dolgozik a Mergado az adatokkal (Mergado XML és konverter)** #### **Mergado XML** A Mergadóban minden adatkonverzió az egységes **Mergado XML** köztes formátumon keresztül történik. Ez „univerzális nyelvként" szolgál, amelyre a bemeneti adatok konvertálódnak, és amelyből a kimeneti formátumok generálódnak. #### **Konverter** A **konverter** az a mechanizmus, amely a formátumok közötti adatkonverziót végzi. Mindig aktiválódik, ha a bemeneti és kimeneti formátum eltér. * Újdonság: a konverter mostantól akkor is aktiválódik, ha a bemeneten és a kimeneten is Google Merchants formátum van. #### **Az egyedi formátum szerepe** Az egyedi formátummal saját konvertert hozhatsz létre. A CF definiálásakor elmagyarázod a Mergadónak, hogy a feed melyik része mit jelent, és melyik Mergado XML ekvivalenshez kell hozzárendelni. A legfontosabb lépés (csak XML feed esetén érvényes) az Elemek helyes kiválasztása: * **CHANNEL** (Elem neve a Mergado XML-ben) * Ún. Root, azaz a gyökérelem, amely az XML feedben az összes terméket foglalja magába * az XML feedben ilyen Elem csak egy van, * általában a nyitó tagje a feed legelején, a záró tagje a feed legvégén található * a gyökérelem neve feedenként más lehet, példák formátum szerint: * Google: * Heureka * Mergado XML * **ITEM** (Elem neve a Mergado XML-ben) * az egyes termékek/tételek obaló Eleme, * az XML feedben annyiszor fordul elő, ahány tételed/terméked van, * minden termék/tétel pontosan egy obaló Elemmel rendelkezik * a termék obaló Elemének neve feedenként más lehet, példák formátum szerint: * Google: * Heureka * Mergado XML Ez a két Elem határozza meg a struktúrát, amelyben a Mergado az adatokat feldolgozza. ### **Mikor érdemes egyedi formátumot használni** #### **Bemeneten** * A Mergado nem ismeri fel a feed formátumát. * Ismeretlen, módosított vagy egyedi formátummal dolgozol. * Meg kell őrizned a feed eredeti struktúráját. * Kiegészítő adatokat csatlakoztatol, amelyek nincsenek integrálva (készlet, szolgáltatások, értékelések). #### **Kimeneten** * Nem támogatott formátumú feedre van szükséged. * Kontrollt szeretnél a gyökérelemek és a kimeneti XML struktúrája felett. * Rendelkezésedre áll egy minta feed, amelyből sablon készíthető. ### **Korlátozások és mire figyelj** #### **1. Az ITEM-en kívüli Elemek figyelmen kívül hagyása** Az egyedi formátum nem tudja feldolgozni a tétel obaló Elemén kívül elhelyezkedő Elemeket. Ami nincs az ITEM alatt, azt az Editor az egyedi formátumon keresztül feldolgozott feednél nem látja. Ez azt jelenti, hogy a CHANNEL és az ITEM között elhelyezkedő információk elveszhetnek. Megoldás összetett struktúrákhoz: a feed szétbontása két Projektre és azok újbóli összekapcsolása a **Blending Bull Bővítménnyel**. #### **2. A konverzió adatvesztást okozhat** A konverter akkor is érvényesül, ha ugyanabból az egyedi formátumból ugyanabba konvertálsz. Ha a leképezés nem teljes, az új feedben információvesztés következhet be – az adatok az eredeti feedben megmaradnak, a Mergado csak nem dolgozik velük. #### **3. Gyökérelemek a kimeneten** A kimeneti feed gyökérelemei a választott kimeneti formátum szerint jönnek létre, és nem szerkeszthetők közvetlenül. Ha más struktúrára van szükséged, minta feed alapján létrehozott egyedi formátumot kell használnod, vagy a Blending Bull-lal módosítanod. #### **4. Frissítés szükségessége változásokkor** Ha a bemeneti fájlban új Elem jelenik meg, az egyedi formátumnak nincs hozzá beállított viselkedése. A Mergado az ilyen Elemet automatikusan importálja és **NEM rejti el**, így módosítás nélkül bekerül a kimeneti feedbe. Ilyenkor frissíteni kell az egyedi formátum struktúráját és kiegészíteni az új Elem leképezését. Mentés és a Projekt újragenerálása után a változások automatikusan érvényre jutnak. Ha az új Elemek érvénytelen kimeneti feedet okoznának, a leggyorsabb megoldás az új Elemek manuális elrejtése az Elemek oldalon, majd a Projekt exportjának futtatása (Szabályok alkalmazása nélkül). ## **GYIK** ### **Mi az egyedi formátum a Mergadóban?** Az egyedi formátum egy funkció, amellyel megtaníthatod a Mergadót szinte bármilyen XML vagy CSV fájl feldolgozására, függetlenül attól, hogy a Mergado szokásosan támogatja-e. Lehetővé teszi annak definiálását, milyen Elemeket tartalmaz a feed, és hogyan kezelje a rendszer importkor és exportkor. Saját formátumú kimeneti feed létrehozására is szolgál. ### **Mire szolgál az egyedi formátum?** Lehetővé teszi a Projekt adatstruktúrájának igényeidhez igazítását. Segít pontosan szabályozni, hogyan töltse be, jelenítse meg és exportálja a Mergado a termékadatokat. Különösen hasznos nem szabványos vagy módosított feedek importjánál és olyan formátumokba való exportnál, amelyek nem részei az integrált csatornáknak. ### **Mikor érdemes egyedi formátumot használni a bemeneten?** Akkor, ha a Mergado nem ismeri fel a feedet, vagy ha egyedi, módosított vagy kiegészítő feedekkel dolgozol. Segít ott is, ahol meg kell őrizni az eredeti feed struktúrát. Használhatod bemeneti kiegészítő adatokhoz is, mint készlet, szolgáltatások vagy értékelések. ### **Mikor érdemes egyedi formátumot használni a kimeneten?** Ha nem támogatott formátumú feedre van szükséged. Gyakran új platformokra való terjeszkedéskor vagy saját XML struktúrájú belső rendszerekhez való csatlakozáskor. Elég egy minta feed, amely alapján a Mergado létrehozza a kimeneti sablont. ### **Mi az a Mergado XML és miért fontos?** A Mergado XML egy belső köztes formátum, amelyen keresztül minden adatkonverzió történik. „Univerzális nyelvként" működik, amelyre a bemeneti adatok fordítódnak, és amelyből a kimeneti formátumok generálódnak. Ennek köszönhetően nem kell minden formátumpár számára külön konverter. ### **Mit csinál a konverter?** A konverter az értékeket konvertálja a formátumok között -- tetszőleges bemenetből Mergado XML-be és onnan a kimeneti formátumba. Egyes formátumoknál (pl. Google Merchants) akkor is aktiválódik, ha a bemeneten és kimeneten ugyanaz a formátum van. Ha a leképezés nem teljes, a konverter egyes értékeket kihagyhat. ### **Milyen szerepe van az egyedi formátumnak az adatkonverzióban?** Az egyedi formátum lehetővé teszi saját, a feedre szabott konverter létrehozását. Pontosan megadod, mit jelentenek az egyes Elemek, és hogyan konvertálandók Mergado XML-be. Ezzel kontrollt kapsz az adatok strukturálása felett, még a Mergado által nem ismert platformoknál is. ### **Mit jelent a CHANNEL és ITEM helyes kiválasztása?** A CHANNEL a Mergado XML feed gyökéreleme, és meghatározza, hol kezdődik és végződik az egész dokumentum. Az ITEM egy tétel obaló Eleme, és a Mergado XML-ben annyiszor fordul elő, ahány terméked van. E két Elem helyes leképezése alapvető előfeltétele annak, hogy a Mergado a feededet feldolgozza. A CSV feednek nincsenek ilyen Elemei, így ott a leképezés elmarad. ### **Milyen korlátozásai vannak az egyedi formátumnak?** Nem tudja feldolgozni az ITEM-en kívül elhelyezkedő Elemeket, pl. a CHANNEL és ITEM közötti információkat. Konverziónál adatvesztés lehetséges, ha a leképezés nem teljes. Új bemeneti Elemek automatikusan importálódnak, de a rendszer nem tudja, mit kezdjen velük -- manuálisan kell frissíteni a leképezést. ### **Miért következhet be adatvesztés konverziónál?** Az egyedi formátum figyelmen kívül hagyja az ITEM-en kívüli Elemeket az XML feedekben. Ha ilyen Elemek fontos információkat tartalmaznak, más megoldást kell alkalmaznod, pl. kétprojektes modellt és Blending Bull-lal történő összevonást. ### **Hogyan kezeli a Mergado a gyökérelemeket a kimeneten?** A gyökérelemek a választott kimeneti formátum szerint jönnek létre, és nem szerkeszthetők közvetlenül. Ha más struktúrára van szükséged, minta feed alapján készített egyedi formátumot kell használnod, vagy a Blending Bull-lal módosítanod. ### **Mi a teendő, ha a bemeneti feedben új Elem jelenik meg?** Az új Elem automatikusan importálódik a Projektbe, de a Mergado nem tudja, mit kezdjen vele, mert nem része az eredeti leképezésnek. Frissíteni kell az egyedi formátum struktúráját és kiegészíteni a leképezést. Ezután a Projektet újra kell generálnod. ### **Hogyan tudom megállapítani, mikor jobb nem használni egyedi formátumot?** Ahol létezik hivatalos integráció, ott nincs szükség egyedi formátumra. Kétség esetén írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ### **Mire szolgál a minta feed?** A minta feed sablonként szolgál a kimeneti egyedi formátum létrehozásakor. A Mergado ebből határozza meg a gyökérelemek struktúráját, az obaló tageket és a megőrzendő elemeket. Elég egy minimális példa -- akár egyetlen termék is. A minta feednek URL címen kell elérhetőnek lennie. ### **Honnan tudom, hogy az egyedi formátum helyesen van konfigurálva?** A formátum helyes definiálását onnan ismered fel, hogy a Projekt betölti az összes szükséges Elemet, és a kimeneti feed az elvárt struktúrával rendelkezik. Kritikus pont a CHANNEL és ITEM helyes leképezése, valamint a Projektben a párosító Elem. Ha a kimeneti adatok megfelelnek a kívánt sablonnak és nincs információvesztés, a konfiguráció rendben van. ### **Mi a teendő, ha az egyedi formátummal történő Projekt-létrehozás hibával végződik?** Ellenőrizd az egyedi formátum leképezését. XML feedeknél gyakori hiba a rosszul leképezett gyökérelem vagy a tételt obaló Elem. Mindkét Elem csak egyszer, egy-egy feedbeli Elemre képezhető le. További gyakori hiba a rosszul választott párosító Elem. A legbiztosabb a termék-azonosítót tartalmazó Elemet választani, kombinálva pl. EAN-okat vagy termék-URL-eket/kép-URL-eket tartalmazó Elemmel. Kétség esetén írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. --- ## **2. Hol hozható létre és kezelhető az egyedi formátum** Az egyedi formátumot a Mergadóban kétféleképpen hozhatod létre: közvetlenül a Projekt létrehozásakor, vagy az egyedi formátumok kezelésére szolgáló önálló szekcióban. A két módszer kiegészíti egymást, és bármilyen formátumdefiníció elkészítésére és újrafelhasználására alkalmas. ### **Definíció a Projekt létrehozásakor** A Projekt létrehozásakor megadhatod az egyedi formátumot mind a bemeneti, mind a kimeneti feedhez. Ez a lehetőség mindig megjelenik, ha a Mergado nem tud a bemeneti fájlhoz integrált formátumot rendelni, vagy ha egyedi kimenetre van szükséged. ### **Egyedi formátum a bemeneten** A bemeneti feed egyedi formátumát a Projekt-létrehozó varázsló 3. lépésében állíthatod be. Ha a rendszer felismeri a csatlakoztatott feed struktúráját, felajánlja a *Másik formátum választása* gombot – így vagy másik hivatalos formátumot választhatsz, vagy a *Saját formátum definiálása* gombbal egyedi formátumot hozhatsz létre. Ha a rendszer nem ismeri fel a struktúrát, közvetlenül felajánlja az egyedi formátum létrehozását, vagy egy hivatalos formátum manuális kiválasztását. A bemeneti feed egyedi formátumának létrehozásakor két megközelítés áll rendelkezésre: * Egyszerűsített varázsló -- gyors alapstruktúra-beállításhoz. * Részletes beállítás -- az összes talált Elem részletes leképezéséhez. Mindkét módszer ugyanazt a célt szolgálja: meghatározni, hol kezdődik a feed, mely Elemek képviselik az egyes termékeket, és melyik Elem tartalmaz egyedi értéket minden terméknél. A bemeneti feed helyes feldolgozásához legalább ezeket kell leképezni: * gyökérelem (CHANNEL), * termékek obaló Eleme (ITEM), * termékazonosító (ITEM_ID) -- egyedi értékű Elem minden tételnél. Természetesen a bemeneti feed összes Elemét is leképezheted, ami megkönnyítheti a későbbi munkát (pl. csökkenti a szükséges Szabályok számát). Magához az adatimporthoz ez azonban nem szükséges. ### **Egyedi formátum a kimeneten** A kimeneti feed egyedi formátumát a Projekt-létrehozó varázsló 4. lépésében állíthatod be – kattints a *Saját formátum definiálása* gombra. Ezután meg kell adnod a minta feed URL-jét, amelynek alapján a Mergado összeállítja a kimeneti formátum struktúráját. *Figyelem: A minta feed nem tölthető fel feltöltéssel (Upload), az URL kötelező. Ha a sablonod fájlként van, hozz létre URL-t felhőszolgáltatással (pl. Dropbox), vagy használd a **Mergado Files Bővítményt**.* Ha már van kész egyedi formátumod, kimeneti formátumként választhatod a Projekthez. Ezzel meghatározod a végleges XML vagy CSV kinézetét, függetlenül attól, hogy a Mergado szokásosan támogatja-e az adott formátumot. Ha a formátum minta feedből készült, a Mergado megőrzi a gyökérelemeket és elrendezésüket. A kimeneti feed egyedi formátumának létrehozásakor csak egy megközelítés áll rendelkezésre: * Részletes beállítás -- az összes talált Elem részletes leképezéséhez. * Egyszerűsített varázsló itt nem elérhető. A kimeneti feed helyes létrehozásához legalább ezeket kell leképezni: * gyökérelem (CHANNEL), * termékek obaló Eleme (ITEM). Ebben az esetben a Mergado elkészíti a kimeneti feedet, létrehozza a sablon összes Elemét a Projektben, de mivel nem tudja, mit jelentenek az egyes Elemek, az Elemeket nem tölti ki értékekkel -- Szabályokkal kell beállítani. Természetesen a minta feed összes többi Elemét is leképezheted, ami megkönnyíti a további munkát (pl. csökkenti a szükséges Szabályok számát). ### **„Egyedi formátumok" szekció a főmenüben** Az egyedi formátumok önálló kezelőfelületét a Mergado Editor bal oldali menüjében találod, felhasználói szinten. (A bal menü aszerint változik, hogy felhasználót, webáruházat vagy Projektet kezelsz.) Ez a szekció a fiókban létrehozott összes formátum központi kezelőhelye. Itt lehetőséged van: * új formátumot létrehozni konkrét Projekthez való kötés nélkül, * minta fájl URL-jét megadni, * Elemek leképezését elvégezni, * meglévő formátumot szerkeszteni vagy újra elemezni. Ez a szekció központi helyként szolgál, ahol az egyedi formátumokat karbantarthatod, tesztelheted és előkészítheted további Projektekhez. ### **Egyedi formátumok újrafelhasználása** Miután létrehozol egy egyedi formátumot -- akár a varázslóban, akár az önálló szekcióban -- a Mergadóban eltárolódik, és tetszőlegesen hosszú ideig használhatod: * a bemeneten, ha ugyanolyan struktúrájú újabb feedet szeretnél feldolgozni, * a kimeneten, ha ugyanolyan formátumú feedet kell generálnod. Ha már van legalább egy mentett egyedi formátumod, egy újabb létrehozásakor elérhető az *Előtöltés alapján* funkció, amellyel átveheted egy meglévő formátum struktúráját és leképezését. Ez sokat gyorsít, ha hasonló sémájú feedekkel dolgozol. ## **GYIK** ### **Hol hozhatok létre egyedi formátumot a Mergadóban?** Kétféleképpen -- közvetlenül a Projekt létrehozásakor vagy az Egyedi formátumok szekcióban a bal menüben. Mindkét mód kiegészíti egymást, és lehetővé teszi gyors vagy előzetes formátum-előkészítést. A mentett formátum az összes Projektben újra felhasználható. ### **Hogyan hozok létre egyedi formátumot a bemeneten Projekt létrehozásakor?** A varázsló 3. lépésében a Mergado felajánlja az egyedi formátum létrehozását, ha nem ismeri fel a feed struktúráját, vagy ha manuálisan választod a „Másik formátum" lehetőséget. Használhatod az egyszerűsített varázslót vagy a részletes beállítást. Legalább a CHANNEL-t, ITEM-et (XML feedeknél) és lehetőleg a termékazonosítót kell leképezned. ### **Mit kell minimálisan leképezni, hogy a Mergado be tudja tölteni a feedet?** A minimális működéshez le kell képezni a CHANNEL-t, ITEM-et (XML feedeknél) és egy egyedi értékű Elemet (leggyakrabban ITEM_ID). Ez elég ahhoz, hogy a Mergado azonosítsa a dokumentum elejét, az egyes termékeket és azok egyértelmű kulcsát. A többi Elem később is kiegészíthető. ### **Hogyan hozok létre egyedi formátumot a kimeneten?** A Projekt létrehozásának 4. lépésében a Saját formátum definiálása lehetőséggel. Be kell illeszteni a minta XML fájl URL-jét, amely alapján a Mergado összeállítja a kimenet struktúráját. Ezután leképezed legalább az alap Elemeket és elmented. ### **Miért kell a minta feednek URL-en elérhetőnek lennie?** A Mergado a kimeneti formátumot kizárólag URL-en elérhető fájlból hozza létre, mert elemzéskor importálnia kell a struktúrát. Feltöltés nem támogatott. Ha nincs saját hostingod, használhatsz felhőszolgáltatást (Dropbox, OneDrive) vagy a Mergado Files Bővítményt. ### **Miért nincs egyszerűsített varázsló a kimeneti formátumhoz?** A kimeneti formátumnál mindig csak a részletes beállítás áll rendelkezésre. Ez szándékos, mert a célstruktúra a minta feedből származik, és teljes kontrollra van szükség a sablonba való konverzióhoz. ### **Mi történik, ha a kimeneti formátumnál csak a minimumot képezem le?** A Mergado ugyan létrehozza a kimeneti feedet a sablon gyökérelemeivel, és a Projektben létrehozza az üres Elemeket, de a le nem képezett Elemek nem lesznek kitöltve értékekkel. Ezeket Szabályokkal kell kiegészíteni. Ezért érdemes minél több Elemet leképezni a minta feedből. ### **Mire szolgál az „Egyedi formátumok" szekció a bal menüben?** A fiókban lévő összes egyedi formátum központi kezelésére. Új formátumokat hozhatsz létre, meglévőket szerkeszthetsz, struktúrájukat frissítheted. Ideális hely a jövőben ismételten használandó formátumok előkészítéséhez. ### **Használhatom ugyanazt az egyedi formátumot különböző Projektekben?** Igen, minden mentett egyedi formátum újra felhasználható. Bemeneten és kimeneten is használhatod tetszőleges számú Projektben. ### **Mire szolgál az „Előtöltés alapján" lehetőség új formátum létrehozásakor?** Lehetővé teszi egy korábban létrehozott egyedi formátum struktúrájának (leképezésének) átvételét. Ideális, ha több hasonló sémájú formátummal dolgozol, így nem kell mindent az elejéről kezdened. --- ## **3. Egyszerűsített varázsló vs. Részletes beállítás** A bemeneti egyedi formátum létrehozásakor a Projekt-létrehozó varázslón belül kétféle módszer áll rendelkezésedre: egyszerűsített varázsló vagy részletes beállítás. Mindkét megközelítés ugyanazt a célt szolgálja -- elmagyarázni a Mergadónak a feed struktúráját -- de különböznek abban, milyen mértékű kontrollt és mennyi lehetőséget kínálnak. Az egyszerűsített varázsló a feedek gyors feldolgozásához alkalmas. A részletes beállítás teljes kontrollt ad az Elemek leképezése és a formátum konfigurálása felett. ### **Egyszerűsített varázsló** Az egyszerűsített varázsló csak a bemeneti egyedi formátum létrehozásakor jelenik meg, a Projekt-létrehozó varázslón belül. Gyors utat kínál az alapstruktúra definiálásához – csak a legfontosabb Elemeket mutatja, a haladó beállításokat elrejti. #### **Mikor használatos** * A Projekt létrehozási varázslóján belül a bemeneti feed formátumának beállításakor. * Ha a lehető leggyorsabban szeretnél működő leképezést létrehozni. #### **Mit kínál** * Alapvető Elemek áttekinthető megjelenítése, * hirdetési csatornák által használt kulcsfontosságú elemek kiemelése, * érthetőbb Elem-nevek, mint a technikai nézetben, * intelligens leképezés, amely a nevek és jelentés alapján automatikusan próbálja hozzárendelni az Elemeket. #### **Hogyan működik az intelligens leképezés** A rendszer párosítást javasol -- pl. description -> DESCRIPTION, EAN -> EAN, ID -> ITEM_ID. Neked csak ellenőrizned kell a javaslatok helyességét, és szükség esetén módosítani. #### **Mikor ideális az egyszerűsített varázsló** * Ha gyorsan el kell kezdened az adatokkal dolgozni, * ha a feed struktúrája nagyrészt szokásos konvenciókat követ, * ha egyszeri vagy kevésbé összetett leképezésről van szó. ### **Részletes beállítás (teljes egyedi formátum definíció)** A részletes beállítás az egyedi formátum definiálásának teljes felülete. Az Elemek leképezésénél felhasználható összes lehetőséget tartalmazza. #### **Mikor használatos** * A feed összetett vagy szokatlan struktúrájú, * minden Elem feldolgozását pontosan kontrollálni kell, * formátumot készítesz ismételt használatra vagy kimeneti feedhez, * al-Elemek, variánsok vagy paraméterek jelentését kell definiálni. #### **Mit tartalmaz** **1. Az egyedi formátum paraméterei** Általános konfiguráció, amely meghatározza a formátum viselkedését: * megfelelő formátumnév, * ország beállítása (hatással a pénznemekre), * meglévő formátumból való átvétel lehetősége, * variánsok önálló termékekre bontásának opciója, * saját kategóriafa definiálása. **2. Adatfeldolgozás beállítása (Elemek leképezése)** A kulcsrész, amely meghatározza, hogyan értelmezi a Mergado a feed egyes részeit. Alapvető Elemek: * gyökérelem (pl. CHANNEL), * termékek obaló Eleme (pl. ITEM), * termékazonosító (pl. ITEM_ID) -- egyedi értékű Elem minden tételnél. További lehetőségek: * közvetlen Mergado XML leképezés, * műveletek al-Elemek nélküli Elemeknél (Változatlanul hagyás, Elrejtés, Elem jelentése), * speciális műveletek obaló Elemeknél (pl. DELIVERY, PARAM, VARIANT), * tetszőleges mennyiségű Elem leképezése a Projektben végzett munka megkönnyítéséhez. ### **Összehasonlítás: Egyszerűsített varázsló vs. Részletes beállítás** |Szempont|Egyszerűsített varázsló|Részletes beállítás| | --- | --- | --- | |Munka sebessége|Gyors alapbeállítás|Hosszabb, de pontosabb| |Kontroll szintje|Korlátozott, egyszerű struktúrákhoz|Teljes kontroll minden Elem felett| |Alkalmas|Ismeretlen feedek szokásos logikával|Összetett, módosított vagy hierarchikus feedek| |Intelligens leképezés|Igen -- automatikus javaslatok|Igen -- automatikus javaslatok| |Formátum paraméterek beállítása|Korlátozott|Teljes (név, ország, variánsok, saját kategóriák)| |Al-Elemek kezelése|Alapvető|Részletes, speciális műveletekkel| |Eredmény pontossága|Elégséges a legtöbb szokásos feedhez|Legmagasabb konverziós pontosság| ### **Melyik módszert válaszd** * Használd az egyszerűsített varázslót, ha gyorsan kell Projektet létrehoznod és a feed viszonylag áttekinthető struktúrájú. * Válaszd a részletes beállítást, ha összetett feedekkel dolgozol, kimeneti sablont készítesz, vagy pontosan kell definiálnod az egyes Elemek jelentését. ## **GYIK** ### **Mi az egyszerűsített varázsló az egyedi formátum létrehozásakor?** A varázsló 3. lépésében elérhető felület, amely csak a legfontosabb Elemeket mutatja és gyorsan átvezet a működő leképezésig. Nem terhel haladó beállításokkal, és intelligens leképezést kínál – a nevek és jelentés alapján automatikusan javasolja az Elemek hozzárendelését. ### **Mikor jelenik meg az egyszerűsített varázsló?** Kizárólag bemeneti egyedi formátum létrehozásakor, ha a Mergado nem ismeri fel a feed struktúráját, vagy ha manuálisan választod az egyedi formátum definiálását. ### **Hogyan működik az intelligens leképezés?** Automatikusan megpróbálja hozzárendelni az Elemeket a nevük és tipikus jelentésük alapján. Csak ellenőrizd a javasolt értékeket, és szükség esetén módosíts. ### **Mikor érdemes egyszerűsített varázslót használni?** Ha gyorsan el kell kezdened az adatokkal dolgozni, és a feed viszonylag szabványos struktúrájú. Egyszeri feldolgozásnál is alkalmas, vagy ha nem szeretnél rögtön az elején részletes beállításokkal foglalkozni. ### **Mi a részletes beállítás?** Az egyedi formátum teljes definiálási felülete, amelyen minden Elem és al-Elem maximális pontossággal leképezhető. Tartalmazza a formátum összes paraméterét is, mint az ország, név vagy variánsok bontása, és lehetővé teszi összetettebb struktúrák viselkedésének definiálását. ### **Mikor érdemes részletes beállítást használni?** Ha a feed összetett, nem szabványos vagy többszintű struktúrájú. Ha pontosan kontrollálnod kell az adatok feldolgozását és exportálását. Ismételten használandó vagy kimeneti formátumoknál is szükséges. ### **Mely Elemeket kell mindkét esetben leképezni?** Akár egyszerűsített varázslót, akár részletes beállítást használsz, mindig meg kell adnod a gyökérelemet (CHANNEL) (XML feedeknél), a termék obaló Elemét (ITEM) (XML feedeknél) és legalább egy termékazonosítót (leggyakrabban ITEM_ID). ### **Mit kínál a részletes beállítás az egyszerűsítetten felül?** Lehetővé teszi minden Elem jelentésének definiálását és speciális műveletek beállítását az al-Elemekkel rendelkező Elemeknél, pl. paramétereknél, szállításnál vagy variánsoknál. Tartalmazza a formátum összes paraméterét és lehetőséget ad meglévő CF struktúrájának átvételére. ### **Melyik módszert válasszam?** Az egyszerűsített varázslót gyors Projekt-létrehozáshoz és egyszerű feed struktúrához. A részletes beállítást, ha hosszú távon tervezel az adatokkal dolgozni, vagy ha a feed összetett és pontos leképezést igényel. ### **Kiválthatja az egyszerűsített varázsló a részletes beállítást?** Igen, sok egyszerűbb esetben elegendő. Ha azonban a feed variánsokat, paramétereket, többszintű struktúrát tartalmaz, vagy további exportokat tervezel, a részletes beállítás pontosabb és stabilabb eredményt ad. --- ## **4. Egyedi formátum létrehozása -- Részletes beállítás** A részletes beállítás az a lépés, amelyben pontosan megadod a Mergadónak, hogyan értelmezze a feed struktúráját. Ezek alapján jön létre a konverter a te adatformátumod és a Mergado XML között. Ez a fázis a forrásfájl struktúraelemzése után következik. ### **A feed struktúrájának elemzése** Az egyedi formátum létrehozásakor a Mergado először betölti és elemzi a csatlakoztatott fájlt. A struktúrából meghatározza, mely Elemek képezhetők le, és összeállítja a leképezési listát. ### **Mit csinál az elemzés** * betölti az XML vagy CSV struktúráját a megadott URL-ről, * azonosítja az elérhető Elemeket és struktúrájukat, * előkészíti a leképezhető Elemek listáját a Mergado XML-hez. ### **Struktúra frissítése** Ha később a bemeneti fájlban új Elem jelenik meg, azt be kell pótolni az egyedi formátum beállításába. Erre szolgál a **Struktúra frissítése fájlból** lehetőség, amely betölti az új elemeket és lehetővé teszi a feldolgozási mód meghatározását. ### **Alapvető paraméterek beállítása** Ebben a részben a formátum általános paramétereit határozod meg. Ezek a beállítások nem az egyes Elemekre, hanem a formátum egészének viselkedésére vonatkoznak. #### **Elérhető paraméterek** |Paraméter|Leírás| | --- | --- | |Formátum neve|Könnyű azonosíthatóság érdekében adj jól felismerhető nevet.| |Ország|Hatással van a pénznem-konfigurációra.| |Előtöltés alapján|Meglévő egyedi formátumból való beállítás átvétele. Csak akkor jelenik meg, ha már van létrehozott egyedi formátumod.| |Variánsok bontása|Minden variáns (pl. szín, méret) önálló termékként kezelődik a Mergadóban.| |Saját kategóriafa|Aktiválja a saját kategóriafával és kategória-javaslatokkal való munkát (kimeneti formátumoknál).| ### **Elemek leképezése (Adatfeldolgozás beállítása)** Ez a rész határozza meg, hogyan értelmezi a Mergado a feed Elemeit. A leképezés definiálja az egyes Elemek és Mergado XML ekvivalensük közötti kapcsolatot. #### **Kötelező Elemek (csak XML-nél)** A feed működő feldolgozásához legalább ezt a két elemet le kell képezni: * CHANNEL -- az egész feed gyökéreleme, * ITEM -- egy tétel obaló Eleme. E két Elem nélkül az XML feed nem importálható. #### **Ajánlott Elemek** A Mergado tetszőleges mennyiségű további Elem leképezését teszi lehetővé. Minél több Elemet képezel le, annál kevesebb munka vár rád később a Szabályokkal, és annál jobban konvertálható a feed más kimeneti formátumokba. #### **Műveletek egyszerű Elemeknél** Az al-Elemek nélküli Elemeknél háromféle művelet használható: |Művelet|Jelentés| | --- | --- | |Változatlanul hagyás|Az Elem változás nélkül importálódik és exportálódik, hacsak a Konverter Szabály vagy a felhasználó el nem rejti.| |Elrejtés|Az Elem importálódik és elrejtettként állítódik be, de Szabályokban használható, vagy manuálisan felfedhető.| |Elem jelentése|Az Elem hozzárendelése a Mergado XML ekvivalenséhez. Az Elem importálódik, elrejtettként állítódik be, és a Konverter Szabály az értékeit a kimeneti ekvivalens Elembe konvertálja.| #### **Műveletek obaló Elemeknél** Az al-struktúrával rendelkező Elemeknél speciális műveletek választhatók, amelyek hozzáférhetővé teszik az al-Elemek beállítását. Példák: * DELIVERY -- szállítási költség, szállító neve vagy kódja, * PARAM -- termékparaméterek definiálása, * VARIANT -- egyes tételvariánsokkal való munka. #### **A leképezés hatásai** * Bővebb leképezés megkönnyíti a más formátumokba való exportot. * Minimális leképezés több munkát igényel a Szabályokban (értékek másolása és kiegészítése). * Az ITEM-en kívüli Elemek nem feldolgozhatók -- a Mergado figyelmen kívül hagyja őket. ## **GYIK** ### **Mit jelent a feed struktúra elemzése?** Az első lépés, amelyben a Mergado betölti a fájlt az URL-ről és azonosítja az összes elérhető Elemet. Hierarchiájukból összeállítja a struktúrát, amelyet leképezésre kínál. ### **Mi a teendő, ha a bemeneti feedben új Elem jelenik meg?** Nyisd meg az egyedi formátum definícióját és használd a **Struktúra frissítése fájlból** lehetőséget. Az új Elem megjelenik a listában, és meghatározhatod a feldolgozási módját. Mentés és újragenerálás után az új Elem a Projekt részévé válik. ### **Mire szolgálnak az alapbeállítások?** Ezek a formátum egészének viselkedését határozzák meg. Ide tartozik a formátumnév, az ország beállítása, a variánsokkal való munka, vagy a saját kategóriafa aktiválása. Helyes beállításuk egyszerűsíti a jövőbeli használatot. ### **Miért fontos jól elnevezni az egyedi formátumot?** A formátum neve a formátumlistában jelenik meg, és megkönnyíti a tájékozódást, különösen ha több formátumod van. Jól megválasztott névvel gyorsan azonosíthatod, milyen típusú feedhez készült. ### **Hogyan működik az „Előtöltés alapján" lehetőség?** Hozzáférést ad a meglévő egyedi formátumokhoz és lehetővé teszi struktúrájuk átvételét. Hasznos, ha hasonló formátumot kell létrehoznod, vagy azonos sémájú feedekkel dolgozol. ### **Mit jelentenek a „Változatlanul hagyás", „Elrejtés" és „Elem jelentése" műveletek?** * „Változatlanul hagyás" -- Az Elem változás nélkül importálódik és exportálódik, hacsak el nem rejtik. * „Elrejtés" -- Az Elem importálódik, de elrejtettként. Szabályokban, Lekérdezésekben használható, vagy manuálisan felfedhető. * „Elem jelentése" -- Az Elem leképezése a Mergado XML ekvivalenséhez. ### **Mikor éri meg a kötelezőkön kívül további Elemeket is leképezni?** Ha más formátumokba tervezel exportálni vagy Szabályokban dolgozol az adatokkal, a részletes leképezés jelentős előnyt jelent. Kevesebb leképezett Elem több munkát jelent az értékek kiegészítésénél. ### **Hogyan működnek a speciális műveletek az obaló Elemeknél?** Akkor használatosak, ha az Elemnek saját beágyazott struktúrája van, pl. paraméterek, szállítás vagy variánsok. A speciális művelet kiválasztásával hozzáférsz az al-Elemek beállításához. ### **Miért hagyja figyelmen kívül a Mergado az ITEM-en kívüli Elemeket?** Az egyedi formátum csak az XML azon részével tud dolgozni, amelyet az egyes termékek alkotnak. Az ITEM feletti Elemek nem részei a termékadatok modelljének, ezért importkor figyelmen kívül maradnak. ### **Honnan tudom, hogy a leképezés elegendő?** Ha a feedet be tudod tölteni, az adatokkal kiterjedt Szabályok nélkül tudsz dolgozni, és az export információvesztés nélkül történik, a leképezés jól van beállítva. Ha gyakran kell Szabályokkal kiegészítened értékeket, a leképezés valószínűleg túl szűkös. ### **Mi a kapcsolat a leképezés és a konverter között?** A leképezést te határozod meg, és annak alapján konvertálja a konverter az adatokat Mergado XML-be. Ha egy Elemet nem képezel le, a konverter „nem tud róla" és nem dolgozik vele. --- ## **5. Egyedi formátum a bemeneten** A bemeneti egyedi formátummal a Mergado által nem felismert feedeket is be tudod tölteni és a belső Mergado XML struktúrába konvertálni. Ezzel szinte tetszőleges XML vagy CSV fájl feldolgozható a Mergadóban. ### **Mikor használatos** Egyedi formátumra akkor van szükséged, ha a rendszer nem ismeri fel a bemeneti feed struktúráját, és jelzi, hogy a formátum ismeretlen. Ilyenkor felajánlja az egyedi formátum létrehozását. #### **Tipikus helyzetek** * Beszállítói feedek vagy máshogy strukturált XML/CSV, * egyedileg készített feedek, jellemzően nagyobb webáruházaknál, * ismert formátumok elavult vagy jelentősen módosított változatai, * kiegészítő feedek, pl. készlet vagy szerviz feedek, * más típusú szolgáltatásokat nyújtó feedek (értékelések, utazási ajánlatok). ### **Egyedi formátum létrehozásának menete feed importnál** Az egyedi formátum definiálása a Projekt-létrehozó varázsló 3. lépésében történik. #### **Lépések** 1. Hozz létre új Projektet és add meg a bemeneti feed URL-jét. 2. Ha a Mergado nem ismeri fel a struktúrát, válaszd a Saját formátum definiálása lehetőséget. 3. Képezd le a kötelező Elemeket: * CHANNEL, * ITEM. 4. Képezd le a további Elemeket, amelyekkel a Projektben dolgozni fogsz (URL, NAME, ITEM_ID, ...). 5. Nevezd el és mentsd el a formátumot. 6. A 4. lépésben: * meghagyhatod ugyanazt az egyedi formátumot a kimeneten is, így a feed struktúrája nem változik * választhatsz más hivatalos formátumot, pl. Google, Meta stb. * vagy létrehozhatsz új egyedi formátumot a kimenetre 7. Az utolsó lépésben ellenőrizd a párosító Elemek kiválasztását. Ha nincsenek beállítva, be kell állítanod. ### **A párosító Elem beállítása** A **párosító Elem** kulcsfontosságú adat, amelyet a Mergado az egyes tételek egyértelmű azonosítására használ a Projektben. **Ami fontos** * minden terméknél egyedi értékkel kell rendelkeznie, * leggyakrabban a termék-azonosítót vagy más egyértelmű azonosítót tartalmazó Elemet használjuk (URL, EAN, ...), * az összefoglaló lépésben ellenőrizni kell, hogy a párosító Elem helyesen van kiválasztva. A párosító Elem úgy működik, mint minden tétel „személyi száma" – ennek segítségével követi és dolgozza fel a Mergado az egyes termékeket, függetlenül attól, hogyan változnak az értékeik. ### **Hány Elemet érdemes leképezni** #### **Minimum -- a működéshez** Az importhoz elegendő csak a kötelező Elemeket leképezni (CHANNEL, ITEM és esetleg ITEM_ID). #### **Maximum -- a hatékonysághoz** Több Elem leképezése egyszerűbb munkát jelent a Projekt további lépéseiben. A részletes leképezés előnyei: * kevesebb szükséges Szabály az értékek másolásához, * gyorsabb konverzió más kimeneti formátumokba, * jobb olvashatóság és a Projekt stabilitása. Példa: Ha nem képezed le a terméknevet tartalmazó Elemet, később Szabállyal kell kiegészítened. Ha már a CF definiálásakor leképezed, a Mergado automatikusan helyesen konvertálja a kimeneti feedbe. ### **Struktúra frissítése feed változásokkor** Ha a bemeneti feedben új Elemek jelennek meg, a mentett egyedi formátum automatikusan nem veszi át őket. Ilyenkor tedd a következőt: 1. Nyisd meg az adott egyedi formátumot. 2. Kattints a **Struktúra frissítése fájlból** lehetőségre. 3. Rendeld hozzá a feldolgozási módot az újonnan talált Elemekhez. 4. Mentsd el, és generáld újra az ezzel a formátummal rendelkező Projekteket. Ezzel biztosítod, hogy a feed a változások után is konzisztensen dolgozódjon fel. ## **GYIK** ### **Mikor szükséges bemeneti egyedi formátumot használni?** Akkor, ha a Mergado nem ismeri fel a bemeneti feed struktúráját, és jelzi, hogy a formátum ismeretlen. Jellemzően beszállítói, egyedi, elavult vagy jelentősen módosított feedekről van szó. ### **Milyen típusú feedek igénylik leggyakrabban a bemeneti egyedi formátumot?** Leggyakrabban beszállítói és egyedi feedek, amelyeknek nincs nyilvános specifikációja, vagy eltérnek a szabványoktól. Ide tartoznak a kiegészítő feedek, pl. készlet, szerviz vagy értékeléseket és utazási ajánlatokat tartalmazó feedek. ### **Hogyan történik az egyedi formátum létrehozása importnál?** A Projekt-létrehozó varázsló 3. lépésében, ahol a „Saját formátum definiálása" lehetőséget választod. Ezután leképezed a kötelező CHANNEL és ITEM Elemeket (XML feedeknél) és további tételeket, amelyekkel a Projektben dolgozni fogsz. Végül elmented a formátumot. ### **Mi az a párosító Elem és miért olyan fontos?** A párosító Elem az az adat, amely lehetővé teszi a Mergado számára, hogy egyértelműen azonosítsa az egyes tételeket. Minden terméknél egyedi értékkel kell rendelkeznie -- leggyakrabban ITEM_ID, URL vagy EAN. Helyes párosító Elem nélkül a feed importja és a változások párosítása nem működik megfelelően. ### **Hány Elemet érdemes leképezni?** Az alapműködéshez elég a CHANNEL, ITEM (XML feedeknél) és egy egyedi azonosító. Ha azonban minimalizálni szeretnéd a későbbi munkát, érdemes további Elemeket is leképezni, mert ez egyszerűsíti a Szabályokkal való munkát és megkönnyíti a konverziót más formátumokba. ### **Mi történik, ha nem képezek le fontos Elemeket?** A le nem képezett Elemek ugyan megjelennek a Projektben, de a Mergado nem tudja helyesen használni őket, és Szabályokkal kell manuálisan kiegészíteni. Ez nagyobb munkaterhet jelent és exportnál hibákat okozhat. ### **Hogyan járjak el, ha a bemeneti feedben új adatmezők jelennek meg?** Nyisd meg az egyedi formátum definícióját és használd a **Struktúra frissítése fájlból** lehetőséget. A Mergado betölti az új Elemeket és te hozzárendeled a feldolgozási módot. Ezután a Projektet újragenerálod. ### **Használható az egyedi formátum akkor is, ha a Mergado felismeri a formátumot?** Igen, bizonyos esetekben előnyös lehet egyedi formátumot létrehozni felismert feednél is, pl. ha meg akarod őrizni az eredeti struktúrát. Ilyenkor egyszerűen válaszd a „Másik formátum" lehetőséget. ### **Mi a teendő, ha nem vagyok biztos, hogy az egyedi formátum helyesen van beállítva?** Ellenőrizd a betöltött Elemeket, a párosító Elemet és a Projekt kimeneti feedjének struktúráját. Ha látod az összes szükséges értéket és az adatok helyesen párosulnak, a formátum rendben van. Probléma esetén térj vissza a leképezéshez, vagy írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. --- ## **6. Egyedi formátum használata a kimeneten** A kimeneti egyedi formátum arra szolgál, hogy a Mergado olyan struktúrájú termékfeedet generáljon, amelyet alapból nem támogat. Akkor jön jól, ha a kimeneti fájlnak pontosan meg kell felelnie egy platform, rendszer vagy belső folyamat egyedi követelményeinek. ### **Mikor használatos** A kimeneti egyedi formátum elsősorban akkor jön jól, ha: * a Mergadóban nem integrált platformhoz kell feed, * új e-commerce csatornához készítesz csatlakozást, * kisebb összehasonlítókkal vagy saját adatstruktúrájú belső rendszerekkel dolgozol, * a gyökérelemek specifikus struktúrájára van szükség (pl. ...). ### **Mi az a minta feed és miért szükséges** A kimeneti egyedi formátum **minta feed** alapján készül -- ez egy minta XML vagy CSV fájl, amely legalább egy tételt tartalmaz. ### **Miért fontos** * Sablonként szolgál, amely alapján a Mergado megtanulja, hogyan nézzen ki a végleges feed. * Meghatározza a gyökérelemeket a célstruktúrában. * Lehet teljesen fiktív -- elég egyetlen fiktív tétel, az értékek nem számítanak. ### **Követelmények** * **URL-en kell elérhetőnek lennie** (feltöltés nem támogatott), * tartalmaznia kell a kívánt kimeneti gyökérstruktúrát, * minimális tartalom is elegendő. ### **Hogyan hozz létre minta feedet** Két módszer létezik: #### **1. Manuális fájl létrehozása** * XML-t szövegszerkesztőben vagy CSV-t táblázatszerkesztőben készítesz, * szerverre mented, * URL-en elérhetővé teszed. #### **2. A Mergado Files Bővítménnyel** * aktiválod a Mergado Files Bővítményt, * létrehozol egy új fájlt, * beilleszted a mintatételt, * XML vagy CSV formátumban mented, * megkapod az URL-t a formátumdefinícióhoz. ### **A kimeneti egyedi formátum létrehozásának menete** A kimeneti egyedi formátum az Egyedi formátumok szekcióban a felhasználói szintű bal menüben, vagy közvetlenül a Projekt-létrehozó varázsló 4. lépésében hozható létre. #### **Lépések** 1. Nyisd meg az Egyedi formátumokat és kattints az Új egyedi formátum lehetőségre. 2. A „Forrásfájl" mezőbe illeszd be a minta feed URL-jét. 3. Nevezd el a formátumot. 4. Képezd le az Elemeket: * minimum a gyökér obaló Elemek (CHANNEL, ITEM), * ajánlott az összes kimeneten generálandó Elem leképezése. 5. Mentsd el a formátumot. Mentés után az egyedi formátum újra felhasználhatóvá válik. Bármely Projektben kimeneti (és bemeneti) formátumként választható. ### **Hogyan generálja a Mergado a kimeneti feedet egyéni sablon alapján** A kimeneti egyedi formátum határozza meg a feed végleges struktúráját. A Mergado a kimenet generálásakor: * a gyökérelemeket pontosan a minta feedből veszi, * az értékek konvertálásához a definiált leképezést használja, * megőrzi az Elemek sorrendjét és struktúráját a sablon szerint. Ezzel gyorsan elkészíthető tetszőleges XML vagy CSV feed anélkül, hogy a Mergadónak új integrációt kellene fejlesztenie. ## **GYIK** ### **Mikor érdemes kimeneti egyedi formátumot használni?** Ha olyan struktúrájú feedre van szükséged, amelyet a Mergado alapból nem kínál. Jellemzően új platformhoz, kisebb összehasonlítóhoz vagy saját struktúrájú belső rendszerhez. ### **Mi az a minta (example) feed?** Minta XML vagy CSV fájl, amely legalább egy tételt tartalmaz és megfelel a generálni kívánt célstruktúrának. A Mergado ebből olvassa ki a gyökérelemeket, a belső struktúrát és az Elemek sorrendjét. ### **Kell-e a minta feednek valósnak lennie?** Nem, teljesen fiktív is lehet -- elég egyetlen tétel minimális értékekkel. A lényeg a helyes Elem-struktúra, nem a konkrét adatok. ### **Miért kell a minta feednek URL-en elérhetőnek lennie?** A Mergado a struktúrát közvetlenül az URL-ről tölti be elemzéskor. URL nélküli feltöltés nem lehetséges. Ha nincs saját hostingod, használhatsz felhőszolgáltatást vagy a Mergado Files Bővítményt. ### **Hogyan történik a kimeneti egyedi formátum létrehozása?** Az Egyedi formátumok szekcióban az „Új egyedi formátum" lehetőséget választod, forrásfájlként megadod a minta feed URL-jét. Elemzés után elnevezed és leképezed a szükséges Elemeket. Alternatívaként a Projekt-létrehozó varázsló 4. lépésében is létrehozhatod. ### **Hogyan használja a Mergado az egyedi formátumot a kimenet generálásakor?** A minta feedből betöltött sablonból indul ki, megőrzi a gyökérelemeket és struktúrát. A leképezés segítségével konvertálja az értékeket a Mergado XML-ből a kimeneti Elemekbe. ### **Mi történik, ha csak a minimumot képezem le a kimeneten?** A Mergado létrehozza a helyes struktúrájú kimeneti feedet, de az Elemek nem lesznek adatokkal töltve. A le nem képezett Elemek értékeit Szabályokkal kell kiegészíteni. ### **Miért érdemes a kimeneten is minél több Elemet leképezni?** Jobb kontrollt kapsz a kimenet felett, kevesebb Szabályra van szükséged, és egyszerűbb az újrafelhasználás más Projektekben. ### **Használható a kimeneti egyedi formátum bemenetként is?** Igen, létrehozása után a formátumok listájában bemenetre és kimenetre is elérhető. --- ## **7. Munka összetett XML struktúrákkal** Ez a rész azokat az eseteket írja le, amikor a feed az ITEM-en kívüli elemeket is tartalmaz. Ilyen feedeknél az egyedi formátum korlátokba ütközik, és alternatív megoldásra van szükség. ### **Az egyedi formátum korlátai importnál** Az egyedi formátum csak az ITEM obaló Elemén belüli Elemekkel tud dolgozni. Az ITEM felett vagy azon kívül lévő elemeket a Mergado Editor figyelmen kívül hagyja. ### **A CHANNEL és ITEM közötti információk** * Egyes XML feedek a CHANNEL és ITEM között további adatszinteket tartalmaznak (pl. kategóriák, szállítás, metaadatok). * Ezek az Elemek nem részei a tételnek, ezért importkor nem töltődnek be. ### **Tipikus problémás feedek példái** * XML feedek globális kategória-információkkal a termékeken kívül, * adatforrások CHANNEL szinten definiált szállítási információkkal, * összetett, többszintű feedek a gyökérelem és az egyes tételek között. ### **Megoldás: kétprojektes modell + Blending Bull** Ha az XML feed teljes struktúráját meg kell őrizni, beleértve az ITEM-en kívüli elemeket, kétlépcsős megoldás alkalmazható: 1. **Első Projekt** -- termékeket tartalmaz. 2. **Második Projekt** -- a kiegészítő információkat tartalmazza, amelyek nem részei az ITEM-nek. 3. **Összevonás** -- mindkét Projekt kimeneti adatai a **Blending Bull Bővítménnyel** egyesülnek. #### **Hogyan működik** |Lépés|Termékek Projektje|Specifikációk Projektje| | --- | --- | --- | |CF definíció|CHANNEL és a termékek obaló Elemének (ITEM) leképezése.|A CHANNEL ugyanaz marad. ITEM-ként a kiegészítő információkat tartalmazó obaló Elemet válaszd.| |Párosító Elem|Válassz egyedi értékű Elemet minden termékhez.|Válassz egyedi azonosítót a tételeknél.| |Bemenet|Az eredeti feed.|Ugyanaz a bemeneti feed.| #### **Összevonás Blending Bull-lal** 1. Aktiváld a Blending Bull Bővítményt. 2. Az Adatforrások részben válaszd ki mindkét Projekt kimenetét. 3. A Fájlok szekcióban hozz létre új kimeneti fájlt és válaszd ki az előző lépésben létrehozott adatforrásokat. 4. Szükség szerint egészítsd ki Szabályokkal. #### **Miért működik** Minden Projekt csak azt a részt tölti be, amellyel a Mergado dolgozni tud. A Blending Bull ezután összevonja mindkét kimenetet, és előállítja a teljes adatkimenetet. ### **Gyökérelemek szerkesztése a kimeneten** A kimeneti feed gyökérelemei **nem szerkeszthetők közvetlenül** a Mergadóban. Ha más obaló Elem-struktúrára van szükséged, két alternatíva létezik: módosítás Blending Bull-lal vagy saját sablon létrehozása. #### **Módosítás Blending Bull-lal** A Blending Bull lehetővé teszi, hogy a kimeneti feedet szöveges fájlként kezeld. Ezzel módosíthatók: * gyökérelemek, * fejléc, * lábléc, * Elem-nevek. **„Keresés és csere" típusú Szabályok** A Blending Bull Szabályaival tömeges Elem-névváltoztatások végezhetők. Például: * SHOP -> PRODUCTS, * SHOPITEM -> PRODUCT. Ezzel a kimeneti struktúra könnyen módosítható magába a Projektbe való beavatkozás nélkül. #### **Alternatívák a Blending Bull-hoz (a kimeneti struktúra kontrollálására)** **1. Sablon létrehozása egyedi formátummal** * A kívánt gyökérelemeket tartalmazó fiktív vagy meglévő feedet használsz. * Ezt a feedet kimeneti egyedi formátum létrehozásakor használod. * A Mergado pontosan a minta feedben szereplő gyökérelemeket őrzi meg. **2. Új integrált formátum hozzáadásának kérése** * Ha rendelkezel a célformátum specifikációjával, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. * A formátum bekerülhet a hivatalosan támogatott integrációk közé. * Ezután szokásos kimeneti formátumként választható. * A hozzáadás prioritizálási folyamaton megy keresztül, és tovább tarthat. ## **GYIK** ### **Miért hagyja figyelmen kívül a Mergado a bemeneti XML feed egyes Elemeit?** Az egyedi formátum csak az ITEM obaló Elemén belüli Elemekkel tud dolgozni. Ami azon kívül van, importkor nem kerül feldolgozásra. ### **Hogyan ismerem fel, hogy a feed problémás és speciális megoldást igényel?** A legegyszerűbb a kimeneti feedet összehasonlítani a bemeneti feeddel. Ha import után fontos adatok hiányoznak, az annak a jele, hogy az ITEM-en kívüli struktúrában vannak. ### **Mi az a kétprojektes modell?** Az egyik Projekt a termékeket tölti be, a másik a kiegészítő információkat. Ezután mindkét kimenet a Blending Bull Bővítménnyel egyesül. ### **Lehet a Mergadóban közvetlenül szerkeszteni a kimeneti feed gyökérelemeit?** Nem. Minta feed alapján készített egyedi formátummal vagy a Blending Bull-lal módosíthatók. ### **Mikor érdemes kimeneti egyedi formátummal sablont készíteni?** Ha pontosan meghatározott kimeneti XML struktúrád van, pl. partner vagy saját rendszer specifikációja. Ez a legstabilabb megoldás hosszú távú használatra. ### **Kérhető új hivatalos formátum hozzáadása a Mergadóhoz?** Igen, dokumentáció és specifikáció birtokában. A folyamat prioritizálás alá esik, és tovább tarthat. Ha gyors eredményre van szükséged, az egyedi formátum vagy a Blending Bull gyorsabb megoldás. --- ## **8. Fogalmak magyarázata** ### **Mergado XML mint univerzális nyelv** * A Mergado XML univerzális köztes formátumként működik, amelyen keresztül a Mergado minden termékadatot konvertál. Nem kell minden bemeneti-kimeneti formátumpárhoz külön konverter – elég egyetlen közös struktúra, amelyre az adatok konvertálódnak. ### **Egyedi formátum mint szótár és nyelvtani szabályok** * Az egyedi formátum határozza meg, hogyan „fordíthatók le" a feed egyes Elemei Mergado XML-re. Ez egy szabálykészlet, amely lehetővé teszi a Mergado számára szinte bármilyen feed struktúrájának felismerését. ### **Minta feed mint célnyelv** * A kimeneti formátum létrehozásakor a minta feed definiálja, hogyan nézzen ki a végső struktúra. A Mergado ebből olvassa ki: * a gyökérstruktúrát, * az Elem-neveket, * a tételek szervezését. Ezzel a saját specifikációdnak pontosan megfelelő kimeneti feedet kapsz. ### **Konverziós példák** * Import (beszállítói feed -> webáruház formátuma) * A Mergado úgy készíti elő a struktúrát, hogy kompatibilis legyen a webáruház formátumával, beleértve az árakat, elérhetőségeket és paramétereket. --- ## [CDATA a Mergadóban](https://help.mergado.com/hu/mergado-editor/feed-formatumok-es-halado-adatkezeles/formatumok-technikai-reszletei/cdata-a-mergadoban/) # **CDATA a Mergadóban** ## **Mire való a CDATA és miért fontos** A CDATA (angolul *Character Data*) egy módszer, amellyel XML-ben megvédheted a szöveg egy részét, hogy ne értékelődjön ki kódként. Az e-kereskedelmi feedekben főleg ott hasznos, ahol az Elemek HTML-t vagy speciális karaktereket tartalmaznak – jellemzően a `` vagy `` esetében. CDATA nélkül a HTML tagek (pl. `

`, ``) XML Elemekként értelmeződhetnének, ami érvénytelen feedhez vagy tartalomvesztéshez vezet. Ez a cikk bemutatja, mi az a CDATA, és hogyan csomagolhatsz be egy Elemet CDATA-ba a Mergadóban – akár egyetlen kattintással az **Elemek** fülön, akár a **Felülírás** Szabály segítségével. ## **Mi az a CDATA (röviden)** A CDATA egy szövegrészt jelöl, amely **nem XML-ként van értelmezve**, hanem pontosan úgy marad, ahogy be van írva. **Példa:** ```xml Stílusos ing pamutból

]]> ``` CDATA nélkül a `

` és `` HTML-tagek XML Elemekként lennének értelmezve, és hibát okoznának a feedben. ## **Hogyan adj hozzá CDATA-t a Mergadóban (lépésről lépésre)** ### **A) Legegyszerűbb módszer (ajánlott): az Elemek fülön** 1. Lépj az **Elemek** fülre. 2. A kívánt Elemnél (pl. `DESCRIPTION`) kattints a **CDATA** ikonra. 3. **Generáld újra a kimeneti feedet**: **Beállítások → Újragenerálás**, hogy a változás érvényre jusson. 4. Szeretnéd visszavonni a CDATA-t? Ugyanannál az Elemnél **kapcsold ki újra** a becsomagolást. ### **B) Manuális módszer: Felülírás Szabállyal** 1. Hozz létre egy **Felülírás** Szabályt az adott Elemhez. 2. Az **Új érték** mezőbe írd be a CDATA burkot, pl.: ``` ``` 3. Újragenerálás után a kimeneti feedben pl. ezt látod: ```xml ``` ## **Gyakorlati tippek** * **Használj CDATA-t** a HTML formázást tartalmazó Elemeknél (pl. `DESCRIPTION`) vagy speciális karaktereknél. * Minden módosítás után **ne feledkezz meg a feed újragenerálásáról** (**Beállítások → Újragenerálás**). * Ha hiányzik a CDATA, egyes HTML-tagek **hibás validációt** okozhatnak, vagy **nem jelennek meg** helyesen. ## **GYIK** ### **Pontosan mi az a CDATA?** Egy szakasz az XML-ben, amelynek tartalma **nem kódként van kiértékelve**, hanem szó szerint szövegként kezelődik. ### **Mikor használjam a CDATA-t?** Ha az Elem **HTML-t** vagy speciális karaktereket tartalmaz – leggyakrabban a `DESCRIPTION` vagy `LONGDESC` esetében. ### **Hogyan csomagolok be egy Elemet CDATA-ba a leggyorsabban a Mergadóban?** Az **Elemek** fülön kattints az adott Elemnél a **CDATA ikonra**, majd **generáld újra** a feedet. ### **Hogyan adok hozzá CDATA-t manuálisan?** Hozz létre egy **Felülírás** Szabályt, és az új értékbe írd be a CDATA-t, pl. ``. ### **Kell-e valamit tennem a módosítás után, hogy érvényre jusson?** Igen, **újra kell generálnod a kimeneti feedet**: **Beállítások → Újragenerálás**. ### **Mi történik, ha nem használok CDATA-t?** A HTML-tagek XML-elemekként értelmezhetők, ami **validációs hibához** vagy **tartalom elvesztéséhez/torzulásához** vezet. ### **Ki lehet kapcsolni a CDATA becsomagolást?** Igen, az **Elemek** fülön az adott Elemnél **szüntesd meg a becsomagolást** ugyanazzal az ikonnal. --- ## [JSON a Mergadóban](https://help.mergado.com/hu/mergado-editor/feed-formatumok-es-halado-adatkezeles/formatumok-technikai-reszletei/json-a-mergadoban/) # **JSON a Mergadóban** Ez a cikk bemutatja, hogyan használhatsz JSON formátumú feedet a Mergado Editorban, milyen legyen az alapstruktúrája, és mire figyelj a betöltésnél. A Mergadóban leggyakrabban **XML** és **CSV** fájlokkal dolgozol. Az Editor azonban **JSON**, **TSV** és **TXT** fájlokat is elfogad. Előfordulhat, hogy a beszállítód éppen JSON feedet biztosít, és azt kell betöltened a Mergadóba. Ha a Projekt létrehozásakor a JSON nem töltődik be, vagy hibaüzenetet kapsz, ennek oka általában a feed **helytelen formátuma vagy tartalma**. ## **Mi az a JSON?** Könnyűsúlyú szöveges adatcsere-formátum. Ember számára is érthető, és a programok is könnyen feldolgozzák – „univerzális nyelv strukturált adatok átadására" rendszerek között. ## **A JSON feed elvárt szerkezete** Ahhoz, hogy **JSON formátumú feed URL-jét** be lehessen tölteni a Mergadóba, **objektumok listájának (tömbjének)** kell lennie, pl.: ```json [ { "ITEM_ID": "342", "AVAILABILITY": "preorder", "URL": "https://wp533.mergadoshop.com/produkt/woocommerce-simple-product-test/", "NAME_EXACT": "WooCommerce Simple product TEST", "CURRENCY": "EUR", "VAT": "21", "PRICE": "0.068302", "PRICE_VAT": "0.08", "IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2020/06/tricko-nastvany-bily-tygr-white-edition.jpg", "PARAM": [ { "NAME": "Size", "VALUE": "SM | S | M | L" }, { "NAME": "EAN", "VALUE": "ean222" }, { "NAME": "Příušniče", "VALUE": "Druhá vlastnost, žeřemě" } ], "STOCK_QUANTITY": "0", "DESCRIPTION_SHORT": "[WCMC]", "CATEGORY": "Polštáře", "CATEGORY_ALTERNATIVE": [ "Nezařazené", "Čaje, káva" ], "PRODUCTNO": "SKU01-6", "VISIBILITY": "public", "CATALOG_VISIBILITY": "visible" }, { "ITEM_ID": "11089", "AVAILABILITY": "in stock", "URL": "https://wp533.mergadoshop.com/produkt/voyage-451-mikina-damska/?attribute_pa_barva=cerna&attribute_pa_varianta=xs", "NAME_EXACT": "Voyage 451 Mikina dámská - černá, XS", "CURRENCY": "EUR", "VAT": "21", "PRICE": "650", "PRICE_VAT": "786.5", "IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg", "PARAM": [ { "NAME": "Barva", "VALUE": "černá" }, { "NAME": "Varianta", "VALUE": "XS" } ], "STOCK_QUANTITY": "156", "DESCRIPTION": "lehce vypasovaný střih s bočními švy\ncelopropínací kovový zip\ntáhlo zipu s gravírovaným logem\nkapuce s podšívkou, na stažení šňůrkou\nvnitřní průkrčník začištěn páskou\nraglánové rukávy s ozdobným prošitím\nnakládané kapsy ve stylu klokanky\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\nkontrastní prvky\nvnitřní strana nepočesaná lehce vypasovaný střih s bočními švy\\ncelopropínací kovový zip\\ntáhlo zipu s gravírovaným logem\\nkapuce s podšívkou, na stažení šňůrkou\\nvnitřní průkrčník začištěn páskou\\nraglánové rukávy s ozdobným prošitím\\nnakládané kapsy ve stylu klokanky\\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\\nkontrastní prvky\\nvnitřní strana nepočesaná", "DESCRIPTION_SHORT": "Výplňková pletenina, vnitřní strana nepočesaná\n100 % bavlna (barva 12 - složení se může lišit - 85 % bavlna, 15 % viskóza)", "CATEGORY": "Nezařazené", "VISIBILITY": "public", "CATALOG_VISIBILITY": "visible", "IMAGE_ALTERNATIVE": [ "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_bw600.jpg" ], "SHIPPING_WEIGHT": "500 g", "ITEMGROUP_ID": "11088", "VARIANT_DESCRIPTION": "lehce vypasovaný střih s bočními švy\\ncelopropínací kovový zip\\ntáhlo zipu s gravírovaným logem\\nkapuce s podšívkou, na stažení šňůrkou\\nvnitřní průkrčník začištěn páskou\\nraglánové rukávy s ozdobným prošitím\\nnakládané kapsy ve stylu klokanky\\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\\nkontrastní prvky\\nvnitřní strana nepočesaná" } ] ``` ## **Példák a gyakorlatból** * Van egy JSON a beszállítódtól, és a Mergado nem tölti be a Projekt létrehozásakor → ellenőrizd, hogy **objektumok listája** formátumban van-e a fenti minta szerint. * A Projekt kimenetén **XML**-t szeretnél, de a JSON-od olyan Elem-neveket tartalmaz, amelyek XML-ben nem érvényesek (pl. számmal kezdődnek vagy szóközt tartalmaznak) → ezeket az Elemeket a Projektben **el kell rejtened**, ha XML kimenetet szeretnél. ## **Tippek** * A **natív JSON formátumoknak**, amelyeket a Mergado ismer (jelenleg **csak Shopify**), **nem kell** megfelelniük a fenti formátumnak. * Más JSON-t (vagy általában fájlt) kell az objektumlista formátumra hoznod? Gyakran megoldható a **Blending Bull** Bővítménnyel. * **A JSON – akárcsak a CSV – tartalmazhat érvénytelen XML Elemeket** – ha XML kimenetre törekszel, **rejtsd el őket** a Projektben. ## **GYIK** ### **Használhatok JSON feedet a Mergadóban?** Igen. Az XML és CSV mellett az Editor JSON, TSV és TXT fájlokat is támogat. ### **Mi a leggyakoribb oka, ha a JSON feed nem töltődik be?** A feed nem megfelelő formátuma vagy tartalma. ### **Hogyan kell strukturálva lennie a JSON-nak, hogy betölthető legyen?** **Objektumok listájaként (tömbjeként)**: `[ { ...termek_1... }, { ...termek_2... } ]`. ### **A megadott formátum érvényes minden "natív" JSON-ra?** Nem. A Mergado **natív JSON formátumainak** (jelenleg **csak Shopify**) **nem kell** megfelelniük. ### **Más JSON-om van -- hogyan alakítsam át a szükséges formátumra?** Gyakran megoldható a **Blending Bull** Bővítménnyel. ### **Mi van, ha a JSON olyan neveket tartalmaz, amelyek XML-ben nem érvényesek?** Ha a kimeneted **XML**, **rejtsd el** a Projektben az XML szempontjából érvénytelen Elemeket (pl. számmal kezdődnek vagy szóközt tartalmaznak). --- ## [Adatoptimalizálás a Heurekához – hibák javítása](https://help.mergado.com/hu/mergado-editor/hirdetesi-csatornak/heureka/adatoptimalizalas-heureka/) # **Adatoptimalizálás a Heurekához – hibák javítása** A sikeres Heureka hirdetéshez a termék XML feednek meg kell felelnie a [Heureka összes követelményének](https://sluzby.heureka.cz/napoveda/xml-feed/). A feednek tartalmaznia kell az adatfájl alapvető építőköveit: az Elemeket. A Mergado gondoskodik arról, hogy a bemeneti feed Elemstruktúrája átalakul a Heureka által elvárt struktúrává. Te mondod meg a Mergadónak, milyen adatokkal töltse ki az egyes Elemeket – ezeket az adatokat a bemeneti feedben kell biztosítanod. Ez a cikk bemutatja, mire valók az egyes Elemek, melyek szükségesek a Heurekán való megjelenéshez, hogyan kell kinéznie az adatoknak, és hogyan tölthetők ki automatikusan a Mergadóban. ## **A Heureka Elemek fontossága** Ha azt tapasztaltad, hogy a Heureka egyes Termékeidet ismételten elutasítja, annak oka a rosszul kitöltött Elemek – ezek miatt a Heureka nem tudja a Termékeidet a termékkártyákhoz társítani. Nem kell azonban ezer Terméknél kézzel átírni az összes Elemet. Erre van a Mergado. A Heureka által használt Elemek teljes listáját a [weboldalukon](https://sluzby.heureka.cz/napoveda/xml-feed/) találod. Egyes Elemek kötelezőek és pontosan meghatározott struktúrájúak, mások nem kötelezőek. Minél teljesebb a feed, annál jobban jeleníti meg a Heureka a Termékeidet. ## **Kötelező Elemek** A Termékek megjelenítéséhez és a Heureka termékkártyáihoz való helyes társításhoz a legfontosabb Elemek: * PRODUCTNAME – kötelező, a Termék pontos neve * CATEGORYTEXT – az út a helyes termékkategóriába a Heureka katalógusa szerint * ITEM_ID – kötelező, a Termék egyedi és állandó azonosítója a Webáruházon belül * PRICE_VAT – kötelező, a Termék ára * URL – kötelező, egyedi cím, amely a Termék oldalára mutat a Webáruházban * DELIVERY – tartalmazza a szállítási módokat és költségeket * DELIVERY_DATE – a Termék kiszállításáig eltelt napok száma * IMGURL – a Termék fő képének hivatkozása * ITEMGROUP_ID – az egy Termék variánsait jelölő csoport azonosítója * HEUREKA_CPC – maximális átkattintási ár (maximális CPC) * EAN – a Termék vonalkódja További Heureka feed Elemek: SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, MANUFACTURER_POSTAL_ADDRESS, MANUFACTURER_ELECTRONIC_ADDRESS, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE és SALES_VOUCHER. ### **PRODUCTNAME** A PRODUCTNAME a Termék pontos nevét tartalmazza – kötelező Elem, és szükséges a helyes megjelenítéshez. A helyes társításhoz a PRODUCTNAME Elemnek a kiválasztott kategória összes kötelező adatát tartalmaznia kell. A kötelező adatokat az egyes kategóriákhoz a [Heureka weboldalán](https://sluzby.heureka.cz/napoveda/povinne-nazvy/) találod. Az Elem nem tartalmazhat felesleges információkat (ajándék, garancia stb.). A maximális hossz 200 karakter, amelyet az Érték rövidítése Szabállyal biztosíthatsz. #### **Gyártónév hozzáadása a PRODUCTNAME Elemhez** A Mergado Automatizálása segítségével: 1. A kiválasztott Projektnél kattints az **Automatizálás** fülre. 2. Kattints a **Gyártó hozzáadása a névhez** Automatizálásra. 3. Töltsd ki a gyártó Elemnevét (pl. MANUFACTURER). 4. Töltsd ki a Terméknév Elemnevét (pl. PRODUCTNAME). 5. Kimeneti Elemnévként: PRODUCTNAME. 6. Kattints az **Automatizálás indítása** gombra. #### **Paraméter hozzáadása a PRODUCTNAME Elemhez** 1. Hozz létre Lekérdezést a Termékek oldalon az érintett Termékekhez. Nézd meg a [Lekérdezések kezelése](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=5) útmutatót. 2. Lépj a **Szabályok** oldalra, kattints az **Új Szabály** gombra. 3. Típus: Felülírás. 4. Válaszd ki a Lekérdezést. 5. Elem: PRODUCTNAME. 6. Új érték: írd be az összes Elemet Változóként (% jellel keretezve). Példa: Ha a PRODUCTNAME „Nike póló zöld", és az „Nike póló zöld XL"-t szeretnéd, az Új értékbe írd: %PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL% 7. Töltsd ki a Szabály nevét, és kattints a **Létrehozás** gombra. További információk a PRODUCTNAME Elemről. ### **CATEGORYTEXT** A CATEGORYTEXT a Heureka katalógusa szerinti teljes kategóriaútvonalat tartalmazza. Ha hibásan van kitöltve, a Heureka nem társítja a kategóriákat, és a Termék nem jelenik meg. A teljes útvonalat kell megadni, ideálisan a [Heureka kategóriafa](https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml) szerint. #### **Helyes kategóriák beállítása** A **Kategóriák tömeges átnevezése** Szabállyal: 1. A **Szabályok** oldalon kattints az **Új Szabály** gombra. 2. Típus: Kategóriák tömeges átnevezése. 3. Válaszd ki a Lekérdezést (vagy Összes Termék). 4. Kattints a **Kategóriák javaslata** gombra. A Mergado kitölti a Webáruházad kategóriáit és hozzárendeli a Heureka kategóriákat. Ellenőrizd és módosítsd szükség szerint. 5. Szűrheted a hibás sorokat a **Megjelenítés csak** mezővel. 6. Töltsd ki a Szabály nevét, és kattints a **Létrehozás** gombra. Részletek a [Kategóriák tömeges átnevezése](https://www.youtube.com/watch?v=Bdm0gnnzz4s) Szabályról. További információk a CATEGORYTEXT Elemről. ### **ITEM_ID** Az ITEM_ID a Termék egyedi azonosítóját tartalmazza – kötelező Elem. Nélküle a Termék nem jelenik meg a Heurekán. Megváltoztatásakor a Termékek szétválnak és újra társítás alá kerülnek. Maximum 36 karakter, ékezet nélküli betűk, számok, kötőjel és aláhúzás használható. #### **Hiányzó ITEM_ID pótlása** Az ITEM_ID MERGADO_ID-ból Automatizálással: 1. Lépj az **Automatizálás** oldalra. 2. Kattints az **ITEM_ID MERGADO_ID-ból** Automatizálásra. 3. Nem kell semmit kitölteni, kattints az **Automatizálás indítása** gombra. További információk az ITEM_ID Elemről. ### **PRICE_VAT** A PRICE_VAT a Termék végső bruttó árát tartalmazza – kötelező Elem. Az ár automatikus kezeléséhez ideális a [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about) Bővítmény. További információk a PRICE_VAT Elemről. ### **URL** Az URL a Termék linkjét tartalmazza a Webáruházban – kötelező Elem. Minden Terméknek egyedi URL-je kell. Maximum 300 karakter. #### **Variáns URL-ek elkülönítése** Felülírás Szabállyal add hozzá az URL végéhez: `%URL%#%@MERGADO_ID%` #### **UTM paraméterek hozzáadása** Használd az UTM paraméterek beállítása Szabályt. További információk az URL Elemről. ### **DELIVERY** A DELIVERY tartalmazza a szállítási módokat és költségeket: DELIVERY_ID, DELIVERY_PRICE, DELIVERY_PRICE_COD. #### **Szállítási költség beállítása** A **Szállítási költség beállítása** Szabállyal: 1. Hozd létre a Lekérdezéseket a Termékek oldalon (pl. Szegmentálás 5 árszintre Automatizálással). 2. **Szabályok → Új Szabály → Szállítási költség beállítása**. 3. Válaszd ki a Lekérdezést, töltsd ki a szállítókat és a költségeket. #### **Ingyenes szállítás beállítása** Ugyanez a Szabály, de az ár mezőbe írj 0-t. #### **Szállító törlése a feedből** Szállítási költség beállítása Szabály, de a jobb oldali mezőket hagyd üresen. További információk a DELIVERY Elemről. ### **DELIVERY_DATE** A DELIVERY_DATE a szállítási időt tartalmazza napokban. Egyetlen szám, nem tartomány. | DELIVERY_DATE | Megjelenítés a Heurekán | | --- | --- | | 0 | raktáron | | 1-3 | 3 napon belül | | 4-7 | 1 héten belül | | 8-14 | 2 héten belül | | 15-30 | 1 hónapon belül | | 31+ | több mint egy hónap | | üres | infó a boltban | #### **Hosszú szállítási idejű Termékek elrejtése** 1. Hozz létre Lekérdezést (pl. DELIVERY_DATE > 10). 2. **Szabályok → Új Szabály → Termék elrejtése**. 3. Válaszd ki a Lekérdezést, mentsd. Az aktuális elérhetőséghez elérhetőségi feedet is használhatsz, amelyet a Heureka 10 percenként tölt le. További információk a DELIVERY_DATE Elemről. ### **IMGURL** Az IMGURL a fő termékkép URL-jét tartalmazza. Ajánlott minimum 175×175 pixel, maximum 4096×4096 pixel. A képen nem szerepelhet vízjel, leárazás jelzés stb. A képek ellenőrzéséhez: [Kép Audit](https://audit-obrazku.cz/) (ingyenes). Méret és minőség módosításához: [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about) Bővítmény. További információk az IMGURL Elemről. ### **ITEMGROUP_ID** Az ITEMGROUP_ID közös azonosítóval jelöli az egy Termék variánsait. Maximum 36 karakter. A Heureka elvárja, hogy minden variáns önálló Termékként szerepeljen a feedben. További információk az ITEMGROUP_ID Elemről. ### **HEUREKA_CPC** A HEUREKA_CPC a maximális átkattintási árat tartalmazza. Tizedes elválasztó: vessző. Maximum: 1000 Kc. Automatikus biddinghez ideális a [Bidding Fox](https://store.mergado.com/detail/biddingfox) Bővítmény. További információk a HEUREKA_CPC Elemről. ### **EAN** Az EAN a Termék vonalkódját tartalmazza. A Heureka az EAN-13 formátumot támogatja. Kötelező a Könyvek, Tankönyvek, Térképek, Filmek, Zene és Képregények kategóriáknál. A [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about) Bővítménnyel automatikusan társíthatsz az EAN-ek alapján. #### **Hibás EAN-ek keresése** Használd az **Érvénytelen EAN-ű Termékek keresése** Automatizálást. #### **Hiányzó EAN-ek keresése** A **Termékek** oldalon: Egyszerű felület → EAN → üres → Keresés → **Mentés Lekérdezésként**. További információk az EAN Elemről. ### **További Heureka Elemek** A többi Heureka feed Elem: SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE és SALES_VOUCHER. ## **GYIK** ### **Miért nem jeleníti meg vagy utasítja el a Heureka egyes Termékeimet?** Leggyakrabban a hiányzó vagy hibásan kitöltött Elemek miatt. A Mergado ingyenes [Feed Auditja](https://audit.mergado.com/) bármikor lefuttatható – feltárja a hibákat és megoldást javasol. ### **Hogyan segít a Mergado a Heureka terméktársításban?** A Mergado a bemeneti feed struktúráját Heureka formátumra konvertálja, és Szabályokkal, Automatizálásokkal tömegesen javíthatod az Elemértékeket. ### **Mely Elemek a legfontosabbak a Heurekán való társításhoz?** PRODUCTNAME, CATEGORYTEXT, ITEM_ID, PRICE_VAT, URL, DELIVERY, DELIVERY_DATE, IMGURL, ITEMGROUP_ID, HEUREKA_CPC és EAN. ### **Hogyan pótold a hiányzó ITEM_ID-t?** Használd az **ITEM_ID MERGADO_ID-ból** Automatizálást. ### **Hogyan mérd le, hány vásárló érkezik a Heurekáról?** Adj hozzá UTM paramétereket az UTM paraméterek beállítása Szabállyal. ### **Hogyan adj hozzá szállítót a Heureka feedhez?** A **Szállítási költség beállítása** Szabállyal. ### **Hogyan jelöld, hogy a Termék raktáron van?** A DELIVERY_DATE Elembe írj 0-t. ### **Hogyan rejtsd el a hosszú szállítási idejű Termékeket?** Hozz létre Lekérdezést (pl. DELIVERY_DATE > 10), majd állíts be **Termék elrejtése** Szabályt. ### **Hogyan biztosítsd az aktuális elérhetőségi adatokat?** Elérhetőségi feed segítségével, amelyet a Heureka 10 percenként tölt le. ### **Milyen méretűek legyenek a termékképek a Heurekán?** Ajánlott minimum 175×175 pixel. Maximum 4096×4096 pixel és 2000 kB. A [Kép Audit](https://audit-obrazku.cz/) ingyenesen ellenőriz, a [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about) Bővítmény tömegesen módosít. ### **Tartalmazhatnak vízjelet a termékképek?** Nem. A képek nem tartalmazhatnak vízjelet, leárazás jelzést vagy díj kiemelést. ### **Hogyan jelöld az összes variánst a Heureka feedben?** Az ITEMGROUP_ID Elem segítségével, amelyben az egy Termék összes variánsát közös kóddal jelölöd. ### **Hogyan állítsd be a CPC-t a Heurekához?** Az **Átkattintási árak beállítása** Szabállyal, vagy a [Bidding Fox](https://store.mergado.com/detail/biddingfox) Bővítménnyel az automatikus biddinghez. ### **Kötelező az EAN feltüntetése?** Kötelező a Könyvek, Tankönyvek, Térképek, Filmek, Zene és Képregények kategóriáknál. Más kategóriáknál ajánlott. ### **Hogyan könnyítsd meg a Heureka terméktársítást?** Használd a [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about) Bővítményt, amely automatikusan társít az EAN-ek alapján és javaslatokat ad a nem társítható tételeknél. --- ## [Heureka szortiment riport a Mergadóban](https://help.mergado.com/hu/mergado-editor/hirdetesi-csatornak/heureka/heureka-szortiment-riport/) # **Heureka szortiment riport a Mergadóban** ## **Szortiment riport a Heurekáról** Ez a cikk a **Heureka.cz** és **Heureka.sk** felületén elérhető szortiment riport funkcióról szól – azoknak hasznos, akik cseh vagy szlovák piacon hirdetnek. Egyes Mergado Bővítmények (pl. Pairing Bear, Bidding Fox, Pricing Fox) a Heureka riportjaival dolgoznak – leggyakrabban a **szortiment riporttal**. Ezeket a riportokat a Heureka generálja, a **Mergado Keychain** letölti, az egyes Bővítmények pedig adatelemzésre használják. Ez a cikk bemutatja, hogyan működik a folyamat, milyen gyakran generálódnak és töltődnek le a riportok, és mit tegyél, ha a Keychainben megjelenik a „**Problémák a kapcsolattal**" üzenet, vagy ha az adatok késéssel jelennek meg a Bővítményekben. ## **Működés** * **Hajnali 1:00 és 4:00 között** a Mergado a Heurekán rákattint a **„Szortiment riport generálása"** gombra. * **Körülbelül két órán belül** a Mergado megpróbálja **letölteni és feldolgozni** a riportot. * Ha a letöltés nem sikerül, a Mergado **rendszeres időközönként újrapróbálja**. * Ha többszöri próbálkozás után sem sikerül, a Keychainben **narancssárga „Problémák a kapcsolattal"** üzenet jelenik meg (a szortiment riportnál **nem specifikált hiba** szerepelhet). * Előfordulhat, hogy a **Heureka kapcsolat rendben van**, de a **Heureka nem generálja a riportot** – ilyenkor nincs mit letölteni. * Egyes Bővítményekben (pl. beállított kampány vagy Szabály) a változások csak a **következő napon** jelenhetnek meg. ## **Hibaelhárítás** ### **1. Ellenőrizd a kapcsolat állapotát a Keychainben** 1. Nyisd meg a Heureka kapcsolatot a Keychainben, és ellenőrizd, hogy látható-e a narancssárga **„Problémák a kapcsolattal"** üzenet. 2. Kattints a **Szerkesztés** gombra. 3. Győződj meg róla, hogy a **Heureka kapcsolat rendben van**. * Ha igen, de az üzenet mégis megjelenik, lépj tovább – lehetséges, hogy a **Heureka nem generálja a riportot**. ### **2. Ellenőrizd a riport generálását a Heureka adminisztrációjában** 1. A Heureka adminisztrációjában nyisd meg bal oldalt a **Statisztikák és riportok** menüt. 2. Ellenőrizd, hogy elérhető-e a **„Szortiment riport"** fül. * **Látnod kell a szortiment riporthoz tartozó képernyőt.** 3. **Nem látod a fület?** Ellenőrizd, hogy teljesíted-e a generálás feltételeit: * „**Vásárlók által ellenőrzött**" minősítéssel rendelkezel, **vagy** * **van egyenleged**. Részletek a Heureka súgójában: [https://sluzby.heureka.cz/napoveda/sortiment-report/](https://sluzby.heureka.cz/napoveda/sortiment-report/) ### **3. Ellenőrizd az egyenleget** * Még ha rendelkezel is a „**Vásárlók által ellenőrzött**" minősítéssel, **negatív egyenleg esetén a szortiment riport nem biztos, hogy generálódik**. ### **4. Adj időt a riportnak** * Ha a Keychain kapcsolat **rendben van** és a Heureka **generálja a riportot**, de a riport adatai elavultnak tűnnek, várj **kb. 1 napot** – a Heureka lehet, hogy **még nem generálta az új riportot**, így a Mergadónak nincs mit letöltenie. ### **5. Mikor írj nekünk?** * Ha a **„Problémák a kapcsolattal"** üzenet **1 nap után sem tűnik el**, írj nekünk a **mergado@mergado.hu** címre – megvizsgáljuk a kapcsolati problémát. ## **Tippek** * A **„Problémák a kapcsolattal"** üzenetnél **először** ellenőrizd a Heureka adminisztrációjában, hogy a szortiment riport valóban generálódik-e. * **Ellenőrizd az egyenleget** – a **negatív egyenleg** még a „**Vásárlók által ellenőrzött**" minősítés esetén is **blokkolhatja a generálást**. * Ha a Keychain problémát jelez, de a **Szerkesztés** gombra kattintva a kapcsolat **rendben van**, adj a riportnak **kb. egy napot** – az új riportok még nem biztos, hogy elérhetők a Heurekáról. * A Bővítményekben végrehajtott változtatások (kampányok, Szabályok) csak a **következő napon** jelenhetnek meg. ## **GYIK** ### **Miért látom a Keychainben a „Problémák a kapcsolattal" üzenetet a szortiment riportnál?** A Mergado többször próbálta letölteni a riportot, de nem sikerült. Az ok az is lehet, hogy a **Heureka épp nem generálja a riportot** – ilyenkor **nincs mit letölteni**. ### **A Heureka kapcsolat a „Szerkesztés" gombra kattintva rendben van. Minden oké?** Igen, a kapcsolat lehet rendben, de a **Heureka riportja még nem biztos, hogy létezik**. Ilyenkor várj **kb. 1 napot** az új generálásra. ### **Milyen gyakran indítja el és tölti le a Mergado a szortiment riportot?** **Hajnali 1:00 és 4:00 között** a Mergado rákattint a **„Szortiment riport generálása"** gombra, **kb. 2 órán belül** megpróbálja **letölteni és feldolgozni**. Hiba esetén **újrapróbálja**. ### **Hol találom a Heurekán a szortiment riportot?** A Heureka adminisztrációjában a **Statisztikák és riportok** szekcióban, a **„Szortiment riport"** fülön. ### **Nem látom a „Szortiment riport" fület. Mit tegyek?** Ellenőrizd, hogy teljesíted-e a Heureka feltételeit: „**Vásárlók által ellenőrzött**" minősítés **vagy** **pozitív egyenleg**. Részletek: [https://sluzby.heureka.cz/napoveda/sortiment-report/](https://sluzby.heureka.cz/napoveda/sortiment-report/) ### **Van „Vásárlók által ellenőrzött" minősítésem, de a riport nem generálódik. Miért?** Ellenőrizd az **egyenleget**. Ha **mínuszban van**, a **riport nem biztos, hogy generálódik**. ### **Beállítottam egy kampányt vagy Szabályt a Bővítményben, de a változásokat nem látom azonnal. Ez normális?** Igen, a **változások csak a következő napon** jelenhetnek meg. ### **Mikor írjak nekünk?** Ha a kapcsolat és a Heureka feltételek ellenőrzése után **1 nap elteltével** sem tűnik el az üzenet, írj nekünk a **mergado@mergado.hu** címre – megvizsgáljuk a kapcsolatot. --- ## [Terméktársítás a Heurekán a Mergado segítségével](https://help.mergado.com/hu/mergado-editor/hirdetesi-csatornak/heureka/heureka-termekparositas/) # **Terméktársítás a Heurekán a Mergado segítségével** Ha cseh vagy szlovák piacon is értékesítesz, a terméktársítás az egyik legfontosabb lépés a sikeres Heureka hirdetéshez. Ez a folyamat összeköti a webáruházad kínálatát a Heureka katalógusának konkrét termékkártyájával. Ha a termékeid nincsenek társítva, csak a teljes szöveges keresésben jelennek meg, ami jelentősen csökkenti a láthatóságukat és a rendelési esélyeket. ## **A helyes terméktársítás előnyei** * **Közös megjelenés a versenytársakkal** – A társított termékek közvetlenül a „fő" termékkártyánál jelennek meg a többi webáruház ajánlataival együtt, így a vásárló egy helyen látja a termékedet összehasonlítva a többiekkel – nem önálló, elszigetelt ajánlatként. * **Magasabb pozíció a keresésben:** A termékkártyák a keresési eredményekben magasabban jelennek meg, mint a nem társított ajánlatok. * **Bidding lehetőség:** Csak a társított termékeknél lehet teljes értékűen biddelni (kattintásonkénti árat beállítani) és versenyezni a felső pozíciókért. * **Hitelesség és értékelések:** A társított termékek lehetővé teszik, hogy a vásárlók értékeléseket, véleményeket lássanak és más termékekkel hasonlítsanak össze. * **Heureka Marketplace:** A helyes társítás az egyik feltétele a narancssárga „Megvásárlás a Heurekán" gomb aktiválásának. ## **A sikeres társítás kulcselemei** Ahhoz, hogy a Heureka helyesen tudja azonosítani és besorolni a termékedet, erre a három Elemre kell figyelned: * CATEGORYTEXT * PRODUCTNAME * EAN ## **CATEGORYTEXT** A CATEGORYTEXT egy olyan Elem, amelynek tartalmaznia kell a Heureka katalógusa szerinti helyes termékkategória teljes útvonalát (pl. Heureka.cz | Elektronika | Mobiltelefonok). Az egyes kategóriák és alkategóriák szintjeit a „|" függőleges vonal választja el. Ha a Heureka a helytelenül kitöltött CATEGORYTEXT miatt nem tudja társítani a kategóriákat, nem lép tovább a termékek termékkártyákba sorolásához – a termék így nem jelenik meg a Heurekán. Az Elemben a teljes útvonalat kell megadni, lehetőleg a [Heureka kategóriafa](https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml) szerint. Ebben az esetben a Heureka automatikusan társítja a kategóriákat és továbblép a termékek besorolásához. Saját kategórianeveket is használhatsz, de ez megnöveli a társítási folyamat idejét, és fennáll a kockázat, hogy a kategóriák – és így a termékek sem – lesznek társítva. * Helyesen kitöltött CATEGORYTEXT Elem példája (pl. mosógéphez): Heureka.cz | Velké spotřebiče | Pračky a sušičky | Pračky * Helytelenül kitöltött CATEGORYTEXT Elem példája (pl. mosógéphez): Heureka.cz | Velké spotřebiče | Pračky a sušičky ### **A CATEGORYTEXT kitöltése a Mergadóban** A Mergado naponta betölti és frissíti a Heureka kategóriafa adatait, és megkönnyíti a helyes kategóriák hozzárendelését. A helyes kategóriákat egyszerűen és tömegesen beállíthatod a Kategóriák tömeges átnevezése Szabály segítségével. Ez a Szabály akkor működik megbízhatóan, ha a bemeneti feedben a kategóriák a helyes Elemben vannak kitöltve. Ezért a kategóriák beállítása előtt mindig ellenőrizd, hol és milyen formában szerepelnek a kategóriák a bemeneti feedben (egyedi formátumnál pl. az Elemek helyes leképezését). A **Kategóriák tömeges átnevezése** Szabály a meglévő bemeneti kategóriákkal dolgozik és a Heureka kategóriafához rendeli őket. Előfordulhat azonban, hogy a bemeneti feedben a kategóriák hiányoznak vagy más Elemben vannak, mint amit a Mergado az adott formátumhoz elvár. Például Google feednél a Mergado alapértelmezetten a `g:google_product_category` Elemet nézi. Ha egyes webáruházaknál a kategória csak a `g:product_type` Elemben van kitöltve, a `g:google_product_category` pedig üres, más megközelítést kell választani – például az Értékek szerinti tömeges felülírás Szabályt, amely lehetővé teszi a rossz bemeneti Elemben lévő kategóriák közvetlen beírását a CATEGORYTEXT Elembe (a Mergado közben javaslatokat tesz a Heureka kategóriafából). A **Kategóriák tömeges átnevezése** Szabály használata a CATEGORYTEXT kitöltéséhez: 1. A kiválasztott Heureka Projektnél lépj a **Szabályok** oldalra, és kattints az **Új Szabály** gombra. 2. Szabály típusként válaszd a **Kategóriák tömeges átnevezése** lehetőséget. 3. Ha az összes terméknél szeretnéd hozzárendelni a kategóriákat, a **Lekérdezéseknél** válaszd az **Összes termék** lehetőséget. Szükség esetén hozz létre új Lekérdezést a megcélzott termékekhez. 4. Rendeld hozzá a webáruházad kategóriáihoz a Heureka kategóriafa szerinti megfelelő kategóriákat. 1. A legegyszerűbb módszer a **Kategóriák javaslása** funkció: a Mergado a bal oldalon kitölti a webáruházad kategóriáit, a jobb oldalon pedig hozzárendeli a Heureka kategóriafából a megfelelőket. Ellenőrizd és szükség esetén módosítsd a javaslatokat. 2. A **Bal oldal előtöltése** funkcióval a Mergado szintén kitölti a bal oldalt, de a jobb oldalt magad töltöd ki – a Mergado a beírt kulcsszó alapján kínál javaslatokat a Heureka kategóriafából. 3. A kategóriákat teljesen manuálisan is kitöltheted – a Mergado itt is javaslatokat tesz, így nem kell keresgélned. > **Tipp!** A kategóriák sorrendje ebben a Szabályban fontos. A Szabály felülről lefelé haladva alkalmazza a sorokat, ezért az általánosabb kategóriákat érdemes feljebb, a konkrétabbakat lejjebb rendezni. 5. Ha nem szeretnéd az összes kategóriát átnézni, a **Megjelenítés** szűrővel kiszűrheted a hibás sorokat (Ütköző sorok, Érvénytelen kimeneti kategóriák vagy Hiányzó bemeneti értékek). 6. Töltsd ki a Szabály nevét, és kattints a **Létrehozás** gombra. ## **PRODUCTNAME** A PRODUCTNAME egy olyan Elem, amelynek a termék pontos nevét kell tartalmaznia – a helyes társításhoz az értéknek meg kell egyeznie a Heureka termékkártya nevével. Ez az Elem kulcsfontosságú a termékek megfelelő Heureka termékkártyákba sorolásához, és szükséges a helyes megjelenítéshez. A helyes társításhoz a PRODUCTNAME-nek tartalmaznia kell az adott kategória összes kötelező információját (pl. ruházatnál közvetlenül a névben kell szerepelnie a méretnek). [A kötelező adatokat az egyes kategóriákhoz és a helyes nevek példáit a Heureka weboldalán találod.](https://sluzby.heureka.cz/napoveda/povinne-nazvy/) Az Elem nem tartalmazhat a terméknévvel nem összefüggő felesleges információkat (ajándék a termékhez, garancia, ingyenes szállítás stb.). A szöveg maximális hossza 200 karakter, amit automatikusan biztosíthatsz az Érték rövidítése Szabály beállításával. A PRODUCTNAME Elem módosításait különböző Szabálytípusokkal végezheted a Mergadóban: Felülírás, Értékek szerinti tömeges felülírás, Adatfájl importálása vagy manuális módosítással. Ha a termékeid már társítva vannak a Heurekán, és utána módosítod a PRODUCTNAME Elemet, a termékek szétkapcsolódnak és újra át kell menniük a társítási folyamaton. ### **A PRODUCTNAME kitöltése a Mergadóban** A PRODUCTNAME Elem egyik leggyakoribb problémája a hiányzó gyártónév (márka) vagy hiányzó paraméter (pl. méret). #### **Gyártónév kiegészítése a PRODUCTNAME-ben** A legegyszerűbb módja a gyártónév kiegészítésének a Mergado **Gyártó kiegészítése a névben** Automatizálása. 1. A kiválasztott Projektnél kattints az **Automatizálás** fülre. 2. Kattints a **Gyártó kiegészítése a névben** Automatizálásra. 3. Töltsd ki a **Gyártó Elemének nevét** – a bemeneti feed azon Elemét, amely a gyártó nevét tartalmazza (pl. MANUFACTURER). 4. Töltsd ki a **Terméknév Elemének nevét** – a bemeneti feed azon Elemét, amely a terméknevet tartalmazza (pl. PRODUCTNAME). 5. **Kimeneti terméknév Elemnek** írd be: PRODUCTNAME. 6. Kattints az **Automatizálás futtatása** gombra. Az Automatizálás létrehoz egy „Gyártó kiegészítése a névben" nevű Szabályt, amely az összes olyan terméknél, amelyeknél hiányzik a névből a gyártó, a PRODUCTNAME Elembe beírja a gyártó nevét. A Szabályt a **Szabályok** oldalon láthatod és szerkesztheted. #### **Méret és egyéb paraméterek kiegészítése** Ha a PRODUCTNAME Elembe további kötelező paramétert szeretnél beilleszteni (pl. méret, anyag, vagy hogy női/férfi/gyerek termékről van-e szó), Szabályt kell létrehoznod a Mergadóban. 1. A kiválasztott Projektnél a **Termékek** oldalon hozz létre egy **Lekérdezést** azokhoz a termékekhez, amelyeknél paramétert szeretnél a PRODUCTNAME Elembe illeszteni (pl. a Ruházat kategória összes termékéhez). [A Lekérdezésekkel való munkáról ebben az útmutatóban olvashatsz.](https://youtu.be/pDjUNyKac88?si=RPYlX8yRtydfrT6f) 2. Lépj a **Szabályok** oldalra, és kattints az **Új Szabály** gombra. 3. Szabály típusként válaszd a **Felülírás** lehetőséget. 4. Válaszd ki azt a Lekérdezést, amelyre alkalmazni szeretnéd a Szabályt. 5. Az **Elem** mezőbe írd be: PRODUCTNAME. 6. Az **Új érték** mezőbe írd be az összes Elemet, amelynek a PRODUCTNAME-ben szerepelnie kell (beleértve az eredeti PRODUCTNAME-et is, ha meg szeretnéd tartani). Mivel minden terméknél más lesz az Elem értéke (minden terméknek más a neve/mérete/színe), ezeket az Elemeket ún. Változóként kell megjelölnöd. Ezt úgy teszed, hogy az Elemet az elején és a végén „%" jellel határolod. 7. Töltsd ki a Szabály nevét, és kattints a **Létrehozás** gombra. **Példa:** Jelenleg a PRODUCTNAME Elem értéke: „Nike póló zöld". Te azt szeretnéd, hogy a PRODUCTNAME értéke „Nike póló zöld XL" legyen. A méretinformáció a PARAM Elemben található, amely további beágyazott Elemeket tartalmaz: PARAM_NAME (paraméter neve, pl. méret) és VAL (paraméter értéke, pl. XL). Az új Szabály **Új érték** mezőjébe ezt írd be: `%PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL%` Így a Mergado tudni fogja, hogy a PRODUCTNAME új értékének tartalmaznia kell az eredeti értéket (%PRODUCTNAME%, pl. „Nike póló zöld") és a PARAM → PARAM_NAME="VELIKOST" → VAL Elemben lévő információt (pl. „XL"). Hasonlóan egészítheted ki a PRODUCTNAME-et más paraméterekkel is, pl. anyaggal: `%PARAM{PARAM_NAME="MATERIÁL"} | VAL%` hozzáadásával a Mergado pl. a „pamut" szót illesztené be. Fontos, hogy a feed a kiválasztott paramétereknél valóban tartalmazzon értékeket, különben a Mergadónak nincs honnan vennie az információt. Ellenőrizd azt is, hogy a paraméter értékéhez vezető útvonalat (ún. Element-Path) helyesen töltöd ki. A „%" jel beírásakor a Mergado automatikusan javaslatokat tesz a Változókra. ## **EAN** Az EAN egy numerikus kódot tartalmaz, amely az egyes termékeket azonosítja. Vonalkódokról van szó; a Heureka az EAN-13 formátumot támogatja, amely 13 számjegyből áll. Megadása kötelező a Könyvek, Tankönyvek, Térképek és útikönyvek, Filmek, Zene és Képregények kategóriákban. Más kategóriákban nem kötelező, de ajánlott minden terméknél megadni, mert felgyorsítja a társítást, segíti az automatikus folyamatokat, és nélkülözhetetlen a Nem társított termékek riportjának generálásához. A Heureka ugyan nem társítja a termékeket az EAN kódok alapján, de a [Nem társított termékek riportjában](https://heureka.group/cz-cs/datove-sluzby/report-nesparovanych-produktu/) – amelyet a Heureka generál és amelyben a nem társított termékekről találsz információt – az EAN kódokkal dolgozik. Ha EAN-okat küldesz a Heurekának, a nem társított termékeket az EAN-ok alapján megtalálja, és a riportban javasol helyes nevet és kategóriát a társításhoz. A [Nem társított termékek riportja](https://sluzby.heureka.cz/obchody/nesparovane-produkty/) a Heurekán a bolt adminisztrációjában található. Csak PPC módban lévő webáruházak számára érhető el; a Heureka naponta egyszer generálja. ### **Az EAN ellenőrzése a Mergadóban** #### **Hibás EAN-nal rendelkező termékek keresése** A hibás EAN-nal rendelkező termékeket könnyen megtalálhatod az **Érvénytelen EAN-nal rendelkező termékek keresése** Automatizálással. 1. A kiválasztott Projektnél kattints az **Automatizálás** fülre. 2. Kattints az **Érvénytelen EAN-nal rendelkező termékek keresése** Automatizálásra. 3. Az Automatizálás alapértelmezetten az EAN Elemet állítja be – hagyd így. 4. Kattints az **Automatizálás futtatása** gombra. Az Automatizálás a hibás EAN-nal rendelkező termékeket „Érvénytelen EAN-nal rendelkező termékek" nevű Lekérdezésbe menti. Ezután javíthatod a kódokat, vagy ideiglenesen elrejtheted az érintett termékeket (Termék elrejtése Szabály), amíg az EAN-okat kijavítod. #### **Hiányzó EAN-nal rendelkező termékek keresése** A hiányzó EAN-nal rendelkező termékeket Lekérdezéssel keresheted meg. 1. A **Termékek** oldalon a táblázatban válaszd az **Egyszerű felület** lehetőséget. 2. A **Termékek keresése** lehetőségnél válaszd a **bemeneten** opciót. 3. A keresőmezőbe írd be: **EAN**, majd válaszd az **üres** lehetőséget. 4. Kattints a **Keresés** gombra. 5. Megjelennek az összes hiányzó EAN-nal rendelkező termékek. 6. Töltsd ki a Lekérdezés nevét (pl. „Hiányzó EAN-nal rendelkező termékek"). 7. Kattints a **Mentés** gombra. A **Mentett Lekérdezések** fülön megtalálod a mentett Lekérdezést. Próbáld meg minél előbb kiegészíteni ezeknek a termékeknek az EAN-ját – például az Adatfájl importálása Szabállyal. ## **Automatizálás a Pairing Bear Bővítménnyel** Ha a feedben helyesen vannak kitöltve az EAN kódok, és nem szeretnél időt tölteni a manuális terméktársítással és a [Nem társított termékek riportjának](https://sluzby.heureka.cz/obchody/nesparovane-produkty/) átnézésével, használhatod a [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about) Bővítményt. A Bővítmény automatikusan az EAN-ok alapján társítja a termékeket a Heureka termékkártyáihoz, a nem társítható tételeknél pedig intelligens javaslatokat kínál a név vagy kategória módosítására. ## **Rendszeres ellenőrzés a Mergado Audit segítségével** A [Mergado Audit](https://audit.mergado.com/) rendszeres futtatásával feltárhatod azokat a hibákat, amelyek közvetlen hatással vannak a Heureka termékkártyákba való besorolásra. Az Audit lehetővé teszi a feed változásainak folyamatos nyomon követését, és segít szisztematikusan növelni a társított termékek arányát. Részletes útmutató a Mergado Auditról a Termékfeedek technikai ellenőrzése a Mergado Audittal cikkben található. ### **Mit ellenőriz a Mergado Audit?** #### **CATEGORYTEXT** * Hiányzik-e vagy üres-e a CATEGORYTEXT Elem a termékeknél. * Szerepel-e több CATEGORYTEXT Elem egy terméknél (a Heureka csak az első előfordulást dolgozza fel). * Érvénytelen kategóriaszint-elválasztót vagy felesleges elválasztókat tartalmaz-e. * Csak egy értéket (egy szintet) tartalmaz-e, vagy érvénytelen értéket. * Hivatkozásokat (URL-eket) tartalmaz-e, amelyek nem ide valók. #### **PRODUCTNAME** * Hiányzik-e vagy üres-e a PRODUCTNAME Elem a termékeknél. * Ismétlődik-e – egyedi-e minden terméknél a feedben. * Megfelelő hosszúságú-e (legfeljebb 200 karakter). * Nem engedélyezett szavakat, hivatkozásokat vagy karaktereket tartalmaz-e. #### **EAN** * Hiányzik-e vagy üres-e az EAN a termékeknél. * Egyediek-e az EAN kódok, nincsenek-e ismétlődések a feedben. * Nem engedélyezett értéket tartalmaz-e (pl. betűk, szóközök, kötőjelek). * Megfelelő hosszúságú-e. ## **Összefoglalás** A helyesen kitöltött CATEGORYTEXT, PRODUCTNAME és EAN Elemek alkotják a sikeres Heureka terméktársítás alapját. Ha ezek az adatok pontosak, teljesek és megfelelnek a Heureka követelményeinek, jelentősen nő a helyes társítás, a jobb láthatóság és a hatékony bidding esélye. A társítás önmagában azonban csak egy része a sikeres hirdetésnek. A Heurekának további követelményei is vannak a feed struktúrájára és minőségére vonatkozóan, amelyek teljesítése kulcsfontosságú ahhoz, hogy a termékek ne legyenek elutasítva. Erről bővebben az Adatoptimalizálás a Heurekához – hibák javítása cikkben olvashatsz. ## **GYIK** ### **Mi az a terméktársítás a Heurekán és miért olyan fontos?** A terméktársítás az a folyamat, amelynek során a webáruházad kínálata összekapcsolódik a Heureka katalógusának konkrét termékkártyájával. A társított termékek magasabban jelennek meg a keresésben, értékeléseket és árösszehasonlítást jeleníthetnek meg, és lehetővé teszik a teljes értékű biddinget. Társítás nélkül a termék csak a teljes szöveges keresésben jelenik meg, ami csökkenti a láthatóságát és értékesítési potenciálját. ### **Milyen előnyökkel jár a helyes terméktársítás?** A helyesen társított termékek jobb pozíciót kapnak a keresési eredményekben, és kattintásonkénti ár állítható be rájuk. A vásárlók értékeléseket, véleményeket és a versenytársakkal való összehasonlítást is látnak, ami növeli az ajánlat hitelességét. A társítás a Heureka Marketplace és a „Megvásárlás a Heurekán" gomb aktiválásának egyik feltétele is. ### **Mely Elemek kulcsfontosságúak a sikeres terméktársításhoz?** Három feed Elem játszik alapvető szerepet: CATEGORYTEXT, PRODUCTNAME és EAN. A CATEGORYTEXT határozza meg a kategóriát, a PRODUCTNAME azonosítja a konkrét terméket. Az EAN nem minden kategóriánál kötelező, de segít a nem társított tételek megtalálásában. Ha bármelyik Elem hiányzik vagy helytelenül van kitöltve, a társítás sikertelen lehet. ### **Hogyan kell helyesen kitölteni a CATEGORYTEXT Elemet?** A CATEGORYTEXT-nek a Heureka kategóriafa szerinti teljes kategória-útvonalat kell tartalmaznia; az egyes szinteket a „|" függőleges vonalnak kell elválasztania. Fontos a kategória összes szintjének megadása – a hiányos vagy helytelen CATEGORYTEXT megállíthatja az egész társítási folyamatot. ### **Hogyan állíthatók be a helyes Heureka kategóriák a Mergadóban?** Használd a **Kategóriák tömeges átnevezése** Szabályt, amely lehetővé teszi a webáruház kategóriáinak hozzárendelését a Heureka kategóriafához. A **Kategóriák javaslása** és a **Bal oldal előtöltése** funkciók jelentősen felgyorsítják a folyamatot. Fontos a Szabályok helyes sorrendje is – az általánostól haladj a konkrét felé. ### **Mit kell tartalmaznia a PRODUCTNAME Elemnek a helyes társításhoz?** A PRODUCTNAME-nek meg kell egyeznie a Heureka termékkártya nevével, és tartalmaznia kell az adott kategória összes kötelező adatát (pl. márka, szín, méret). Nem tartalmazhat marketing információkat (ingyenes ajándék, garancia, ingyenes szállítás stb.). A maximális hossz 200 karakter. ### **Hogyan egészíthetem ki a hiányzó márkát a PRODUCTNAME-ben?** Használd a **Gyártó kiegészítése a névben** Automatizálást, amely hozzáadja a gyártó nevét a megfelelő Elemből (pl. MANUFACTURER) a PRODUCTNAME-hez. Az Automatizálás létrehoz egy Szabályt, amely biztosítja a módosítást az összes érintett terméknél. ### **Hogyan adjak méretet vagy más paramétert a terméknévhez?** Hozz létre **Felülírás** típusú Szabályt, és használj `%` jellel jelölt Változókat. A PRODUCTNAME új értékébe illeszd be az eredeti nevet, és egészítsd ki a kívánt paraméterhez vezető útvonallal (pl. méret a PARAM Elemből). Ellenőrizd, hogy a feed valóban tartalmazza a szükséges értékeket. ### **Mikor kötelező az EAN Elem?** Kötelező a Könyvek, Tankönyvek, Térképek és útikönyvek, Filmek, Zene és Képregények kategóriákban. Más kategóriákban nem kötelező, de ajánlott megadni, mert segít a nem társított termékek azonosításában és a társítás felgyorsításában. ### **Hogyan tárhatom fel a hibás vagy hiányzó EAN kódokat a Mergadóban?** Az érvénytelen EAN-hoz használd az **Érvénytelen EAN-nal rendelkező termékek keresése** Automatizálást, amely Lekérdezést hoz létre a problémás tételekről. A hiányzó EAN-nal rendelkező termékeket egyszerű kereséssel és mentett Lekérdezéssel találhatod meg. Ezután egészítsd ki az EAN-t, vagy rejtsd el ideiglenesen az érintett termékeket. ### **Mi az a Pairing Bear és hogyan segít a társításban?** A [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about) egy Bővítmény, amely automatikusan társítja a termékeket az EAN kódok alapján. A nem társítható tételeknél intelligens javaslatokat kínál a név vagy kategória módosítására, ezzel csökkentve a Nem társított termékek riportjának manuális ellenőrzését. ### **Hogyan segít a Mergado Audit a terméktársítás ellenőrzésében?** A Mergado Audit ellenőrzi a CATEGORYTEXT, PRODUCTNAME és EAN Elemek helyességét, és feltárja a hibákat, ismétlődéseket vagy érvénytelen értékeket. Figyelmeztet pl. az üres nevekre, érvénytelen kategória-elválasztókra vagy helytelen szöveghosszra. ### **Miért nem elég csak a terméktársítással foglalkozni?** A társítás csak egy része a sikeres Heureka hirdetésnek. A feednek további technikai és tartalmi követelményeket is teljesítenie kell, különben a termékek elutasításra kerülnek vagy a kampányok korlátozódhatnak. Ezért fontos a feed rendszeres, átfogó ellenőrzése. --- ## [A Mergado és a Heureka integrációja](https://help.mergado.com/hu/mergado-editor/hirdetesi-csatornak/heureka/mergado-heureka-integracio/) # **A Mergado és a Heureka integrációja** Terjeszkedni szeretnél a cseh vagy a szlovák piacra? A Heureka Csehország és Szlovákia legismertebb termék-összehasonlítója, egyszerre árösszehasonlítóként és piactérként működik. Ahhoz, hogy a termékeid megfelelően jelenjenek meg a Heurekán, a termékadatokat [helyes XML formátumban](https://sluzby.heureka.cz/napoveda/xml-feed/) kell megadni. A Mergado segítségével pontosan a Heureka követelményei szerint készítheted elő az adatokat, fejlesztői ismeretek nélkül. Ez a cikk bemutatja, hogyan segít a Mergado a Heurekán való hirdetésben, milyen formátumokat támogat, és hogyan végezd el az integrációt. ## **Miben segít a Mergado** A Mergado egy eszköz, amellyel: * egyszerűen átalakíthatod a feededet a Heureka formátumába (Heureka.cz és Heureka.sk), akár közvetlenül a webáruház-platformodból (pl. Shoptet, WooCommerce, Upgates stb.) vagy más feed formátumból (pl. Google Shopping), fejlesztő nélkül, * bármikor ingyenesen futtathatod a [Feed Auditot](https://audit.mergado.com/), amely feltárja a hibákat és rögtön javaslatot tesz a megoldásra, * automatikusan társíthatod a termékeidet a Heureka megfelelő kategóriáihoz, * a saját igényeid szerint szerkesztheted a feedet – csak azt hirdesd, ami nyereséget hoz (pl. elrejtheted a kifogyott vagy szezonális termékeket), * javíthatod a feed hibáit, * automatikusan kezelheted a biddinget (kattintásonkénti árak), az árazást vagy a termékképeket, * elemezheted és folyamatosan javíthatod a hirdetéseidet. ## **Milyen Heureka formátumokat támogat a Mergado** A Mergado támogatja a Heureka összes meghatározott formátumát: * Heureka – termékes * Heureka – elérhetőségi * Heureka – konverziós * Heureka – boltértékelések * Heureka – termékértékelések ### **Heureka termékes XML feed** A legfontosabb formátum a **Heureka.cz – termékes [CZ]**, ill. **Heureka.sk – termékes [SK]**. Ebben a formátumban kell a termékadatokat küldened a Heurekának – más formátumot nem fogad el. A Projekt létrehozásakor válaszd bemeneti formátumnak a te feed formátumodat (a Mergado az esetek túlnyomó többségében automatikusan felismeri), kimeneti formátumnak pedig a megfelelő Heureka termékes formátumot. A Mergado automatikusan gondoskodik a Heureka által elvárt kimeneti adatstruktúráról. Olvasd el, hogyan hozz létre új Projektet az Új projekt létrehozása cikkben. ### **Heureka elérhetőségi XML feed** Az elérhetőségi feed aktuális információkat tartalmaz a termékeid készletéről és elérhetőségéről. Nem kötelező küldeni a Heurekának, de biztosításával garantálod a helyes elérhetőségi megjelenítést. Az elérhetőségi feedet általában a webáruház-platformod generálja. Ha módosítani szeretnéd (pl. mert nem felel meg pontosan a [Heureka követelményeinek](https://sluzby.heureka.cz/napoveda/dostupnostni-feed/)), vagy a rendszered nem generálja, a Mergadóban is létrehozhatod. Ilyenkor kimeneti formátumnak válaszd a **Heureka.cz – elérhetőségi [CZ]**, ill. **Heureka.sk – elérhetőségi [SK]** formátumot. ### **Heureka konverziós / boltértékelések / termékértékelések XML feed** Ezt a három feed formátumot a Heureka generálja az adataidból. Elsősorban akkor használod, ha a Heurekáról származó értékeléseidet szeretnéd átvinni a Google Merchant Centerbe, hogy közvetlenül a Google hirdetésekben jelenjenek meg. ## **A kimeneti feed csatlakoztatása a Heurekához** Ha már van Projekted, az adatok módosítva vannak és a Mergado elkészítette a kimeneti feedet Heureka formátumban, a feed URL-jét be kell illesztened a Heureka fiókod adminisztrációjába. 1. A kiválasztott Projektben lépj az **Áttekintés** oldalra a Mergadóban, és másold ki a kimeneti feed URL-jét (az oldal jobb felső részén). 2. Jelentkezz be a Heureka.cz vagy Heureka.sk fiókodba, és kattints a **Bolt adminisztráció** lehetőségre. 3. Lépj az **Áttekintés** oldalra, és kattints a **Bolt szerkesztése** gombra. 4. A **Bolt információk** részben illeszd be az **URL XML import** mezőbe a kimásolt URL-t, és mentsd a módosításokat. ## **Heureka összekapcsolása a Mergado Keychain-nel** A sikeres hirdetéshez folyamatosan elemezned kell a teljesítményt. A Mergadóban minden Projektnél az **Analitika** oldalon grafikonokon és táblázatokon követheted a hirdetésed eredményeit. Az elemzésekhez szükséges adatok (pl. rendelési információk) nincsenek a termékfeedben – ezeket a Heureka fiókodból kell a Mergadóba áramoltatni. Ezt a **Mergado Keychain** Bővítményen keresztül éred el. A Keychain biztonságos tárolóként működik: megadod a Heureka bejelentkezési adataidat, és a Mergado automatikusan letölti az elemzésekhez szükséges adatokat. Nem kell minden alkalommal újra megadni az adatokat. Olvass többet a Mergado Keychain Bővítményről a Mergado Keychain beállítása cikkben. A Heurekából származó adatok késéssel töltődnek be – mindig reggel az előző napra vonatkozóan –, és a Mergado 70 napos időablakkal dolgozik. A Keychain-kapcsolat akkor is szükséges, ha olyan Bővítményeket használsz, amelyek Heureka adatokkal dolgoznak (pl. [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about), [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about)). ### **Heureka kapcsolat létrehozása a Keychainben** A Mergado Keychain ingyenes és automatikusan aktiválódik a Projekt létrehozásakor. 1. A Mergado Editor [főoldalán](https://app.mergado.com/) kattints arra a webáruházra, amelyhez be szeretnéd állítani a Heureka kapcsolatot. 2. A bal oldali sávban kattints a **Mergado Keychain** elemre. 3. A **Kapcsolatok** részben válaszd a Heureka lehetőséget, és kattints a **Létrehozás** gombra. 4. Töltsd ki a bejelentkezési adatokat, és válaszd ki, hogy Heureka.cz vagy Heureka.sk kapcsolatot szeretnél. 5. Erősítsd meg a **Bejelentkezés** gombra kattintva. > **Tipp!** Ha a Heureka fiókodban megváltoztatod a bejelentkezési adataidat (pl. jelszó), frissítsd a Mergado Keychainben is – különben kapcsolati hibát fogsz kapni. Töröld a kapcsolatot, és hozd létre újra az aktuális adatokkal. A Keychainben Google Analytics 4 kapcsolatot is létrehozhatsz: ugyanígy járj el, de a kapcsolat létrehozásakor válaszd a **Google Analytics 4** lehetőséget. Számítani kell arra, hogy az Analitikában eltérések lesznek a számokban, amit a különböző forrásokból érkező adatok kombinálása okoz. Részletesebb analitikához a Keychainben a **Források** szekcióban beillesztheted a Mergado Analitikai XML URL-jét is – így egyszerűen követheted a beszerzési költségeket és kiszámíthatod a nyereséget. Az analitikai XML fájl létrehozásáról [itt](https://www.mergado.cz/sites/default/files/users/documents/shopsystems/mergado-xml-analytic-1-1.pdf) olvashatsz. > **Tipp!** Ha véded az érzékeny adataidat (pl. beszerzési árak), korlátozd a fájl elérését IP-cím alapján. A Mergado erről az IP-címről fér hozzá az Analitikai XML-hez: **81.31.39.112**. További Mergado IP-címeket a Mergado és bővítményei IP-címei cikkben találsz. ## **GYIK** ### **Mi az a Heureka és miért érdemes rajta hirdetni?** A Heureka Csehország és Szlovákia legismertebb hirdetési platformja, árösszehasonlítóként és piactérként is működik. Nagy elérést biztosít azoknak a webáruházaknak, amelyek cseh vagy szlovák vásárlókat céloznak meg. ### **Hogyan segít a Mergado a Heurekán való hirdetésben?** Egyszerűen elkészítheted a termékadatokat pontosan a Heureka követelményei szerint, programozás nélkül. Segít az adatok módosításában, a kategóriák és termékek társításában, a biddingben és a teljesítmény elemzésében. ### **Milyen fő előnyöket kapok a Mergado használatával?** * **Adatkonverzió** Heureka formátumba (Heureka.cz és Heureka.sk) * **Ingyenes Feed Audit** – feltárja a hibákat és javaslatot ad a javításra * **Terméktársítás** – könnyen módosíthatod az adatokat, hogy a termékeid láthatóak legyenek * **Tömeges és automatikus módosítások** – Szabályokkal automatikusan javíthatsz ezernyi terméknél * **Feed hibák javítása** programozási ismeretek nélkül * Bidding (CPC), árazás és képek automatikus kezelése * Teljesítmény analitika és folyamatos hirdetés-javítás ### **Milyen Heureka formátumokat támogat a Mergado?** Termékes feed (a megjelenítéshez elengedhetetlen), elérhetőségi feed (készlet- és elérhetőségi adatok), valamint a Heureka által generált formátumok (konverziós, boltértékelések, termékértékelések – pl. a Google Merchant Centerbe való átvitelhez). ### **Mi az a Heureka termékes feed és hogyan hozom létre a Mergadóban?** Projektet hozol létre a Mergadóban: bemeneti feedként a termékfeed URL-jét adod meg, kimeneti feednek a **Heureka.cz – termékes [CZ]** vagy **Heureka.sk – termékes [SK]** formátumot választod. A Mergado gondoskodik a helyes adatstruktúráról. ### **Mire szolgál a Heureka elérhetőségi feed?** A termékeid aktuális készlet- és elérhetőségi adatait tartalmazza. Nem kötelező, de biztosítja a helyes megjelenítést. A Heureka 10 percenként tölti le, így az elérhetőség gyorsan frissül. ### **Mire szolgálnak a Heureka konverziós / boltértékelések / termékértékelések feed formátumok?** Ezeket a Heureka generálja az adataidból. Pl. a Heurekáról származó értékelések Google Merchant Centerbe való átvitelére használhatod. ### **Hogyan juttatom el az adatokat a Mergadóból a Heurekába?** 1. A Projektben lépj az **Áttekintés** oldalra a Mergadóban, és másold ki a kimeneti feed URL-jét. 2. Jelentkezz be a Heureka fiókodba, lépj a **Bolt adminisztrációba**. 3. Az **Áttekintés** oldalon kattints a **Bolt szerkesztése** gombra. 4. A **Bolt információk** szekcióban illeszd be az URL-t az **URL XML import** mezőbe, és mentsd. ### **Miért érdemes összekapcsolni a Heurekát a Mergadóval a Keychain-en keresztül?** Ha az **Analitika** oldalon szeretnéd követni a hirdetésed teljesítményét, a Mergadónak hozzáférést kell biztosítanod a Heureka fiókod adataihoz – ezt a Mergado Keychain Bővítményen keresztül teszed meg. Ingyenes és automatikusan aktiválódik. ### **Hogyan elemezhetem a Heureka hirdetéseimet?** A Mergadóban minden Projektnél az **Analitika** oldalon grafikonokat és táblázatokat találsz. Előbb létre kell hoznod a Heureka kapcsolatot a Mergado Keychain-ben. Az adatok késéssel töltődnek be (másnap reggel az előző napra vonatkozóan), 70 napos időablakban. ### **Hogyan csatlakoztathatom a Heurekát a Mergado Keychain-en keresztül?** 1. A Mergado Editor [főoldalán](https://app.mergado.com/) kattints a kívánt webáruházra. 2. A bal oldali sávban kattints a **Mergado Keychain** elemre. 3. A **Kapcsolatok** részben válaszd a Heureka lehetőséget, és kattints a **Létrehozás** gombra. 4. Töltsd ki a bejelentkezési adatokat, és válaszd ki a Heureka.cz vagy Heureka.sk lehetőséget. 5. Erősítsd meg a **Bejelentkezés** gombra kattintva. ### **Mi a teendő, ha a Keychain kapcsolati hibát jelez?** Valószínűleg megváltoztak a bejelentkezési adatok. Töröld a meglévő kapcsolatot, és hozd létre újra az aktuális adatokkal. ### **Miért nem látok adatokat a Heurekából az Analitika oldalon?** A Mergado Keychain Bővítményben létre kell hoznod a kapcsolatot a Heureka fiókoddal. ### **Küldhetek Google Analytics adatokat is a Mergado Analitikába?** Igen. A Mergado Keychain Bővítményen keresztül hozz létre **Google Analytics 4** kapcsolatot. ### **Követhetem a költségeket és a nyereséget az Analitikában?** Igen, a Mergado Keychain Bővítményen keresztül beillesztheted a Mergado Analitikai XML-t a **Források** szekcióban. ### **Biztonságossá tehetem a Mergado Analitikai XML-t?** Igen. IP-cím alapú védelemnél add hozzá a Mergado IP-címét: **81.31.39.112**. ### **Elrejthetem a kifogyott vagy szezonális termékeket?** Igen. A **Termék elrejtése** Szabállyal beállíthatod, hogy a kiválasztott termékek ne jelenjenek meg a Heurekán. ### **Segít a Mergado a Heureka kategóriák és termékkártyák társításában?** Igen. A Feed Audit feltárja a hibákat, amelyek miatt a Heureka nem tudja besorolni a termékeidet – ezeket a Mergadóban egyszerűen és automatizáltan javíthatod. --- ## [Adatújragenerálás és frissítés a Mergadóban](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/adatujrageneralas-frissites/) # **Adatújragenerálás és frissítés a Mergadóban** ## **Miért fontos az adatok újragenerálása?** Amikor a Mergadóban módosítod a szabályokat, szűrőket vagy lekérdezéseket, vagy amikor megváltoznak a webáruházad bemeneti adatai, fontos, hogy ezek a változások valóban eljussanak a kimeneti feedbe, amelyet a hirdetési csatornákra küldesz. Az adatok újragenerálása az a mechanizmus, amely biztosítja, hogy az adatforrásban történt változások bekerüljenek a Mergado Editorba, és az editorban végzett módosítások megjelenjenek a kimeneti adatokban, amelyek a célplatformokra áramlanak. Ennek a mechanizmusnak köszönhetően teljes kontrollt kapsz afelett, hogy mi jelenik meg ténylegesen a hirdetéseidben. Ez a cikk bemutatja, milyen típusú frissítéseket és újragenerálásokat kínál a Mergado, mikor és hogyan használd őket, hogyan indíts kézi újragenerálást, hogyan szüneteltesd az automatikus folyamatot, vagy hogyan ütemezd konkrét időpontokra. ## **Milyen típusú adatfrissítések vannak a Mergadóban?** ### **1. Szabályok alkalmazása** Miután a projektben módosításokat végeztél (kézi változtatások kiválasztott termékeknél, új szabályok létrehozása, meglévő szabályok módosítása), ezeket a változtatásokat a **Szabályok alkalmazása** gombra kattintva kell megerősítened. Ebben a pillanatban a módosítások csak a Mergadón belül hajtódnak végre, és a Termékek oldalon ellenőrizheted őket. A szabályok alkalmazásakor nem töltődnek be új adatok a bemeneti feedből, és a változtatások nem jelennek meg a kimeneti feedben. A változtatások kimeneti feedbe való átírása (és ezáltal a cél hirdetési platformokra való elküldése) csak az adatok újragenerálásakor történik meg (legyen az automatikus vagy kézi újragenerálás). * Mikor használd: Ha ellenőrizni szeretnéd a szabály hatását a termékekre, és meg akarod vizsgálni, hogy a szabály helyesen van-e beállítva, anélkül, hogy a kimeneti adatok megváltoznának és a változások megjelennének a célplatformon (pl. a Heurekán vagy a Google-ön). * Hogyan indítsd: A konkrét projekten belül a Szabályok oldalon kattints a **Folyamatok kézi indítása** gombra, majd válaszd a **Szabályok alkalmazása** lehetőséget. ### **2. Szabályok alkalmazása csak a figyelt termékekre** Egy kicsit gyorsabb és specifikusabb módja a változások ellenőrzésének, ha a szabályokat csak a figyelt termékekre alkalmazod. A Mergado ebben a módban szintén csak a Mergadón belül alkalmazza a szabályokat (bemeneti adatok betöltése és kimeneti feedbe exportálás nélkül), de ezúttal csak azokra a kiválasztott termékekre, amelyeknél figyelni szeretnéd a változásokat. * Mikor használd: Ha konkrét változással foglalkozol (pl. csak egy bizonyos kategóriánál), és gyorsan akarod látni a hatást, az egész feed feldolgozása nélkül. Ideális diagnosztikai eszköz annak kiderítéséhez, hogyan változtatják meg konkrétan az egyes szabályok az elemek értékeit az egyes termékeknél. Ez a lehetőség ideális akkor is, ha a feedben több ezer termék van, de a szabályok csak néhányat érintenek, és az összes elemre történő tömeges alkalmazás feleslegesen sokáig tartana. A figyelt termékekre történő szabályalkalmazással rengeteg időt takaríthatsz meg. * Hogyan indítsd: A konkrét projekten belül először válaszd ki a figyelni kívánt termékeket. A Termékek oldalon a kiválasztott terméknél kattints a **Szabálykövetés** fülre. Itt jelöld be a **Termék figyelése a szabályok áthaladásánál** jelölőnégyzetet. Ezt ismételd meg minden figyelni kívánt terméknél. A Szabályok áthaladása fülön közvetlenül is elindíthatod a szabályok alkalmazását a figyelt termékekre a **Szabályok alkalmazásának indítása** gombra kattintva. A Szabályok áthaladása oldalon látni fogod az összes szabályt, amely módosítja az adott termék adatait, beleértve az eredeti és az eredményül kapott állapotot. A **Különbségek kiemelése** jelölőnégyzet bejelölésével színesen kiemeli a konkrét változásokat. A figyelt termékekre történő szabályalkalmazást a Szabályok oldalon is elindíthatod. Itt kattints a **Folyamatok kézi indítása** gombra, majd válaszd az **Alkalmazás csak a figyeltekre** lehetőséget. Ugyanígy elindíthatod a folyamatot a Beállítások oldalon, az Újragenerálás fülön, ahol a **Szabályok alkalmazása csak a figyelt elemekre** részben kattints az **Alkalmazás csak a figyeltekre** gombra. A figyelt termékekre történő szabályalkalmazás befejezése után az oldal alján megjelenik az összes figyelt termék listája. Az egyes elemekre kattintva a Figyelt termékek oldalra jutsz, ahol rögtön ellenőrizheted a megtörtént változásokat. ### **3. Módosítottak újragenerálása** Abban a pillanatban, amikor úgy döntesz, hogy a végrehajtott változtatásokat ki akarod engedni a hirdetési platformra, szinkronizálni kell az adatokat. Ez azt jelenti, hogy a Mergado betölti az új adatokat a bemeneti feedből, majd csak az utolsó újragenerálás óta módosult termékekre alkalmazza a szabályokat, és ezeket a módosított adatokat elküldi a kimeneti feedbe (és ezáltal a célplatformra). * Mikor használd: Ha azt akarod, hogy a végrehajtott változtatások „élesben" és minél gyorsabban megjelenjenek a kimeneti feedben. Ugyanakkor nem akarod néhány kisebb változtatás miatt az egész feedet teljesen újragenerálni. Ezt különösen akkor értékeled, ha a feedben több ezer termék van, amelyek teljes újragenerálása sokáig tartana. Ez a leggyorsabb és leghatékonyabb újragenerálási módszer. * Hogyan indítsd: A konkrét projekten belül a Szabályok oldalon kattints a **Folyamatok kézi indítása** gombra, majd válaszd a **Módosítottak újragenerálása** lehetőséget. Ezt a folyamatot a Beállítások oldalon is elindíthatod. Itt kattints az Újragenerálás fülre, és a Projekt újragenerálása részben kattints a **Módosítottak újragenerálása** gombra. ### **4. Minden újragenerálása** Ez ugyanaz a folyamat, mint az előző pontban, de ebben az esetben a szinkronizáció az összes adatra vonatkozik. A Mergado ismét betölti az új adatokat a bemeneti feedből, majd alkalmazza a szabályokat, és elküldi a módosított adatokat a kimeneti feedbe. A Mergado ebben a folyamatban az összes elemet feldolgozza és frissíti, beleértve azokat is, amelyeknél a feldolgozás befejezése után a kimeneti értékek semmiben nem változnak. Ez az újragenerálási mód természetesen lényegesen tovább tart, különösen nagy feed esetén. * Mikor használd: Ha olyan termékeket is frissíteni akarsz, amelyek az utolsó újragenerálás óta nem változtak. Erre például akkor lehet szükséged, ha az utolsó újragenerálás során hibák történtek, egyes adatok nem frissültek, vagy más valami nem úgy működött, ahogy kellett volna. A feed teljes újragenerálása segíthet ezeknek a problémáknak a megoldásában. * Hogyan indítsd: A konkrét projekten belül navigálj a Beállítások oldalra. Itt kattints az Újragenerálás fülre, és a Projekt újragenerálása részben kattints a **Minden újragenerálása** gombra. ### **5. Bemeneti adatok importálása** A Mergado letölti a legfrissebb forrásadatokat a bemeneti feedből, és frissíti a belső adatokat a Mergadóban. Ebben a folyamatban nem történik szabályalkalmazás, és a kimeneti feed semmilyen hatást nem szenved. * Mikor használd: Ha a bemeneti adataidban változások történtek (pl. új termékeket adtál hozzá, változtak az árak), és ezeken az új adatokon szeretnél módosításokat végezni a Mergadóban. Ugyanakkor nem akarod, hogy a bemeneti feed új adatai rögtön a kimeneti feedbe is átíródjanak. * Hogyan indítsd: A kiválasztott projekten belül navigálj a Beállítások oldalra. Menj az Újragenerálás fülre, és a Projekt újragenerálása részben kattints a **Bemeneti adatok importálása** gombra. ### **6. Kimeneti adatok exportálása** A Mergado exportálja az aktuális adatokat a kimeneti feedbe. Ebben a folyamatban nem töltődnek le aktuális adatok a bemeneti feedből, és nem alkalmazódnak szabályok sem. Ha tehát azt akarod, hogy az exportba bekerüljenek a korábban végzett szabályok és módosítások, előbb a **Szabályok alkalmazása** gombra kattintva kell megerősítened a változtatásokat. * Mikor használd: Ha azt akarod, hogy a hirdetési platformon azonnal megjelenjenek a Mergadóban végzett módosítások (pl. kampányindítás előtt), ugyanakkor nem akarod újra betölteni a bemeneti feedet (pl. a webáruház-platform korlátozott letöltési száma miatt). * Hogyan indítsd: A kiválasztott projekten belül navigálj a Beállítások oldalra. Menj az Újragenerálás fülre, és a Projekt újragenerálása részben kattints az **Export indítása** gombra. ### **7. Automatikus újragenerálás a Mergado által** A Mergado naponta többször automatikusan végrehajtja az újragenerálást, hogy a kimeneti feedjeidben az adatok mindig naprakészek legyenek. Ez az automatikus szinkronizáció a módosítottak újragenerálása folyamatnak felel meg. Automatikusan tehát mindig csak az generálódik újra, ami az utolsó újragenerálás óta változott (nem a teljes feed). #### **Az automatikus újragenerálás időzítése** A projekt létrehozása után elindul az automatikus újragenerálás funkciója, és nem kell kézzel bekapcsolnod. Az újragenerálás naponta többször történik, és elsősorban a bemeneti feed változásaitól függ, vagyis minél gyakrabban változnak a bemeneti feed adatai, annál gyakrabban generál újra a Mergado, hogy a kimeneti feedet a lehető legnaprakészebbé tegye. #### **Az automatikus újragenerálás szüneteltetése és újraindítása** Ha éppen nagyobb léptékű változtatásokat végzel a feedben, és nem akarod kockáztatni, hogy munka közben automatikusan elinduljon az újragenerálás, és így a kimeneti feedbe nem teljes vagy nem tesztelt változtatások kerüljenek, egyszerűen szüneteltetheted az automatikus újragenerálást, és a megfelelő pillanatban újra elindíthatod. A projekten belül, ahol a változtatásokat végzed, navigálj a Beállítások szekcióba. Itt kattints az Újragenerálás fülre, és a Beállított újragenerálások részben az **Újragenerálás szüneteltetése** gombra kattintva ideiglenesen leállítod az automatikus adatszinkronizálást. Ha befejeztél a szükséges feed-módosításokkal, az automatikus újragenerálást ugyanazon a helyen egyszerűen elindíthatod az **Újragenerálás engedélyezése** gombra kattintva. #### **Az automatikus újragenerálás ütemezése** Ha nem akarod, hogy a Mergado maga ütemezze az újragenerálást, és te akarod kézben tartani ezt a folyamatot, egyszerűen beállíthatod az újragenerálást a kiválasztott időpontokra. 1. A kiválasztott projekten belül navigálj a Beállítások oldalra. Itt kattints az Újragenerálás fülre, és menj az Újragenerálás beállításai részhez. 2. Kattints a **Szerkesztés** gombra. Itt a Kézi szekcióban legfeljebb 6 időablakot állíthatsz be, amelyekben a projekt újragenerálódik. Az időablakok között legalább 2 óra különbség legyen. 3. Ezután válaszd ki az időzónát, és kattints a **Mentés** gombra. Ha a kézzel beállított újragenerálást vissza szeretnéd állítani automatikusra, menj ismét az Újragenerálás beállításai részhez, kattints a **Szerkesztés** gombra, majd az **Automatikus** opcióra, és erősítsd meg a **Mentés** gombra kattintva. #### **Az újragenerálás előzményei** Hogy milyen gyakran generálódik újra egy konkrét projekt, könnyen megtudhatod az Előzmények fülön. Itt nyomon követheted az egyes folyamatokat, és az Eseménytípusok oszlopban kiválaszthatod és szűrheted a figyelni kívánt konkrét újragenerálási típust, pl. Termékek importálása, Szabályok alkalmazása vagy Termékek exportálása. Az Előzmények megkülönbözteti a tervezett újragenerálást (kézi vagy automatikus beállításon belül), pl. Tervezett termékimport, és az egyszeri kézzel indított újragenerálást, pl. Termékek importálása. ## **GYIK** ### **Mit jelent az „újragenerálás" a Mergadóban?** Az újragenerálás az a folyamat, amelynek során a Mergado betölti az aktuális adatokat a bemeneti feedből, alkalmazza rájuk a szabályaidat és módosításaidat, és az így frissített adatokat elküldi a kimeneti feedbe. Ezáltal biztosítja, hogy a hirdetési csatornáidban (pl. Heureka, Google vagy Facebook) helyesen módosított és naprakész információk jelenjenek meg. ### **Mi a különbség a „szabályok alkalmazása" és az „újragenerálás" között?** * A szabályok alkalmazása csak a Mergadóban történik. A Mergado módosítja az adatokat a szabályaid szerint, de a változtatások nem íródnak át a kimeneti feedbe. * Az újragenerálás már „élesben" átviszi ezeket a módosításokat a kimeneti feedbe, amelyet a hirdetési platformok letöltenek. A **Szabályok alkalmazása** tehát egy tesztelési lépés – az **Újragenerálás** publikálja a változtatásokat a kimeneti feedbe. ### **Mikor használjam a „Szabályok alkalmazása" funkciót?** Ha ellenőrizni akarod, hogyan hatnak a szabályok a termékekre, anélkül, hogy ezeket a változtatásokat azonnal közzétennéd a kimeneti feedben. Például amikor új feltételeket tesztelsz, vagy ellenőrzöd, hogy a szabály helyesen működik-e. ### **Mikor használjam a „Szabályok alkalmazása csak a figyelt termékekre" funkciót?** Ezt a funkciót akkor használd, ha csak konkrét termékekre vagy kategóriákra kell tesztelned a szabályok hatását, az egész feed feldolgozása nélkül. Ideális módszer annak gyors kiderítésére, hogy a szabályok az elvárásoknak megfelelően működnek-e. ### **Mit jelent a „Módosítottak újragenerálása"?** Ebben a folyamatban a Mergado: 1. Betölti az aktuális bemeneti adatokat. 2. Alkalmazza a szabályokat. 3. Csak az utolsó újragenerálás óta módosult termékeket frissíti, és az így frissített adatokat elküldi a kimeneti feedbe. Ez a leggyorsabb és leggyakoribb adatfrissítési módszer, pl. napi adatszinkronizáláshoz ideális. ### **Mit jelent a „Minden újragenerálása"?** Ebben a folyamatban a Mergado: 1. Betölti az aktuális bemeneti adatokat. 2. Alkalmazza a szabályokat. 3. A feed összes termékét frissíti, nem csak azokat, amelyeket változások érintettek. Ez az újragenerálási módszer tovább tart, de alkalmas például nagyobb szabálymódosítások után, ha gyanítod, hogy a korábbi újragenerálás során hibák történtek, vagy ha biztos akarsz lenni abban, hogy az összes adat elölről lett feldolgozva. ### **Mire való a „Bemeneti adatok importálása"?** Ebben a folyamatban a bemeneti feed aktuális verziója letöltődik a Mergadóba, de nem alkalmazódnak szabályok, és az adatok nem exportálódnak a kimeneti feedbe. Ezt a lépést akkor használd, ha először az editorban akarsz dolgozni az új adatokkal (pl. szabályokat tesztelni), de még nem akarod, hogy a változtatások megjelenjenek a hirdetésben. ### **Mire való a „Kimeneti adatok exportálása"?** Ebben a folyamatban a Mergado aktuális adatai exportálódnak a kimeneti feedbe, amelyet aztán a hirdetési rendszerek letöltenek. Az önálló export során már nem történik új bemeneti adatok importálása, sem új szabályalkalmazás. Az adatok úgy dolgozódnak fel, ahogy aktuálisan a Mergadóban vannak. Ezt a lépést például akkor használd, ha kampányindítás előtt kézzel szeretnéd frissíteni a kimeneti feedet, de nem akarod újra betölteni a teljes bemeneti feedet. ### **Milyen gyakran történik az automatikus újragenerálás?** Az automatikus újragenerálás naponta többször megtörténik, a bemeneti feeded aktivitásának megfelelően. Ha a feed adatai gyakran változnak, a Mergado gyakrabban generálja újra. Ha teljes kontrollt akarsz az időzítés felett, kézzel is beállíthatod, és naponta legfeljebb 6 időablakot választhatsz. ### **Ütemezhetem az újragenerálást konkrét időpontra?** Igen. A kiválasztott projektnél a Beállítások → Újragenerálás → Újragenerálás beállításai részben kattints a **Szerkesztés** gombra. Válaszd a **Kézi** opciót, és itt naponta legfeljebb 6 időablakot választhatsz (minimum 2 óra távolsággal). Erősítsd meg a **Mentés** gombbal. Ezzel meghatározod, mikor generálódjon újra automatikusan a projekted. ### **Hogyan szüneteltethetem és indíthatom újra az automatikus újragenerálást?** A Beállítások oldalon navigálj az Újragenerálásra. Itt az Újragenerálás beállításai részben kattints az **Újragenerálás szüneteltetése** gombra, amellyel ideiglenesen kikapcsol az automatikus adatfrissítés. Amikor újra el akarod indítani a folyamatot, ugyanazon a helyen kattints az **Újragenerálás engedélyezése** gombra. Ezt a funkciót például nagyobb adatmódosítások során használhatod, amikor nem akarod, hogy a félkész változtatások a kimeneti adatokba kerüljenek. ### **Hogyan tudom meg, mikor volt utoljára újragenerálás?** A kiválasztott projektnél navigálj az Áttekintés oldalra. Itt láthatod, mikor volt az utolsó import, szabályalkalmazás, export és a kimeneti feed legutóbbi letöltése. Ha mélyebbre akarsz visszamenni az időben, a kiválasztott projektnél navigálj az Előzmények oldalra. Itt megtalálod a projekt összes eseményét, beleértve a folyamatok típusát, dátumát és idejét. ### **Dolgozhatok más projekteken az újragenerálás közben?** Igen. Az újragenerálás a Mergado szerverén a háttérben fut, tehát váltogathatsz projektek, fülek között, vagy akár be is zárhatod a böngészőt. A folyamat ettől nem szakad meg, és az állapotát később ellenőrizheted az Előzmények oldalon. ### **Felgyorsítható az újragenerálás valahogy?** Részben igen. Az újragenerálás gyorsabb lesz, ha a Módosítottak újragenerálása lehetőséget választod, amelynél csak a módosult termékek dolgozódnak fel, a Minden újragenerálása helyett, amelynél a teljes feed feldolgozásra kerül. Gyorsítást érhetsz el a szabályok hatékony beállításával is, ami azt jelenti, hogy ha lehetséges, egy szabályt használsz a kívánt módosításhoz kettő vagy több helyett. A teljes újragenerálás időtartamát azonban leginkább a feed mérete befolyásolja. ### **Lehet csak a termékek egy részét vagy egy konkrét terméket újragenerálni?** Elméletileg igen, de a folyamat során figyelni kell. Ha egyes termékeket figyelésre jelölsz meg, majd beállítasz egy szabályt, azt csak ezekre a figyelt termékekre alkalmazod, és utána a Módosítottak újragenerálása lehetőséget használod, akkor a változtatások valóban csak a figyelt termékekre vonatkoznak. A folyamat során azonban nem szabad más termékeken is változtatásokat végezned, mert abban a pillanatban, amikor a Módosítottak újragenerálása lehetőséget indítanád, ezek a további változtatások is átíródnának a kimeneti feedbe. ### **Megszakítható az újragenerálás folyamata?** Igen. Ha elindítottad az újragenerálást, de menet közben meg akarod szakítani, egyszerűen kattints a **Megszakítás** gombra. A folyamat azonnal leáll, és ha az újragenerálás nem futott le teljesen, a kimeneti feed nem frissül. ### **Mennyi idő után jelennek meg a változtatások a kimeneti feedben az újragenerálás után?** A változtatások az újragenerálás befejezése után azonnal megjelennek a kimeneti feedben. A platformok, mint a Heureka vagy a Google Merchant Center, ezután a saját ütemezésük szerint töltik le az adatokat ebből a feedből. ### **Hogyan tudom meg, hogy az újragenerálás befejeződött?** A projekt Előzmények oldalán látod az összes lefutott folyamatot, beleértve a dátumot, időt, típust és eredményt. Itt tehát ellenőrizheted, hogy az újragenerálás valóban megtörtént. --- ## [Elemek a Mergadóban](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/elemek-a-mergadoban/) # **Elemek a Mergadóban** ## **1\. Mik azok az elemek** ### **Definíció** Az **elem** a feed alapvető építőköve, amely adatot hordoz. Minden elem konkrét információt jelöl – például terméknevet, árat, kódot vagy képet. Az XML és CSV formátumban egyaránt az elem **annak a helynek a jelölése, ahol az adott érték található**. Leegyszerűsítve: * elem = „az információ neve", * érték = „az információ tartalma". **Példa:** \Bid long and prosper – bögre\ \364.21 CZK\ \47\ Ebben a példában: * a `` az elem, * a „Bid long and prosper – bögre" az értéke. ### **Elemek különböző formátumokban** #### **Elem XML feedben** XML fájlokban az elem mindaz, ami a **nyitó és záró tag között** található. Az elem tartalmazhat szöveget, attribútumokat vagy további elemeket (ún. beágyazás). Az XML hierarchikus formátum – ezáltal bonyolultabb adatkapcsolatokat is képes leírni. **Példa:** \1499\ A `PRICE_VAT` elem egyetlen értéket tartalmaz – az ÁFÁ-s árat. #### **Elem CSV feedben** CSV fájlokban az elem **egy oszlopnak** felel meg a táblázatban. Az oszlop neve az elem, az oszlop cellái az értékei. **Példa:** | PRODUCTNAME | PRICE\_VAT | EAN | | :---- | :---- | :---- | | Mergado bögre | 1499 | 8592384021932 | A CSV nem tud beágyazással dolgozni (szülő-gyerek), ezért a Mergado ezt a struktúrát **a `szülő | gyerek` írásmóddal szimulálja**. #### **Elem a Mergado Editorban** A Mergado Editorban minden elem **egy sornak felel meg az *Elemek* oldalon**. Az Editor a feed struktúráját faként jeleníti meg – hierarchikusan, ahol a beágyazott elemek behúzással láthatók. Minden elem a Mergadóban lehet: * **egyszerű**, ha egyetlen értéke van, * **többszörös**, ha többször ismétlődik (pl. több kép, több paraméter), * **beágyazott**, ha egy másik elem része, * vagy **attribútumos**, ha kiegészítő információt ad az értékhez (pl. `@id` vagy `@description`). ### **Mire szolgálnak az elemek** Az elemek képezik az **adatok átvitelének, feldolgozásának és módosításának** alapját a Mergadóban. Segítenek az adatok szervezésében, hogy lehetőség legyen: * olvasásra, módosításra és exportálásra, * formátumok közötti átalakításra (pl. Heureka → Google Merchant), * rendezésre, szűrésre és kiértékelésre. A gyakorlatban a következőknél használod: * **terméklekérdezések** létrehozása, * **szabályok** beállítása, * **változókkal és automatizálással** való munka, * adatok **rendezése** és ellenőrzése a *Termékek* és *Elemek* oldalakon. ### **Összefoglaló** Az elem a feed alapvető adategysége. A Mergado egységesen kezeli, függetlenül a formátumtól – akár XML-ből, CSV-ből vagy más forrásból származik. Az elemek működésének megértése kulcsfontosságú a hatékony munkához a szabályokkal, lekérdezésekkel és exportokkal. ## **GYIK** ### **Mi az az elem?** Az elem a feed alapvető építőköve, amely konkrét információt hordoz – például nevet, árat vagy termékkódot. Az XML és CSV formátumban egyaránt annak a helynek a jelölése, ahol az adott érték található. ### **Mi a különbség az elem és az érték között?** Az elem az információ neve (pl. `PRICE_VAT`), míg az érték a tartalma (pl. `1499`). Együtt egy párt alkotnak – név és adattartalom. ### **Hogyan néz ki egy elem XML feedben?** Az XML-ben az elemet nyitó és záró tag határozza meg. Példa: * `1499` Itt a `PRICE_VAT` az elem, az `1499` az értéke. ### **Hogyan működik az elem CSV feedben?** A CSV fájlban az elem az oszlop nevének felel meg. Az oszlop minden cellája az elem egy-egy értékét jelöli. Példa: * `PRICE_VAT` → oszlop 1499, 1599, 1799 stb. értékekkel. ### **Hogyan jelöli a CSV a beágyazást, ha nem támogatja a hierarchiát?** A Mergado a CSV-ben a `szülő | gyerek` írásmóddal szimulálja a beágyazást. Például a `PARAM | VAL` útvonal a `PARAM` elem alá beágyazott `VAL` elemet jelöli. ### **Hogyan jeleníti meg a Mergado Editor az elemeket?** A Mergado Editorban minden elem külön sorként jelenik meg az Elemek oldalon. A beágyazott elemek vizuálisan behúzva láthatók, fastruktúrát alkotva, amely megfelel az XML feed struktúrájának. Ez vonatkozik a Termékek oldalra is az Elemek nézetben. ### **Milyen elemtípusokat különböztet meg a Mergado?** A Mergado négy alaptípussal dolgozik: * Egyszerű elemek – egyetlen értékük van. * Többszörös elemek – több értékük lehet. * Beágyazott elemek – egy másik elem részei. * Attribútumos elemek – kiegészítő információt adnak az elemhez (pl. `@id`). ### **Mire szolgálnak az elemek a Mergadóban?** Az elemek az adatokkal való munka alapjai – adatok olvasására, módosítására, szűrésére, exportálására és átalakítására használjuk őket. Kulcsfontosságúak a szabályoknál, lekérdezéseknél, változóknál és automatizálásnál. ### **Azonosak az elemek minden formátumban?** Igen. A Mergado egységesen kezeli őket – függetlenül attól, hogy XML-ből, CSV-ből vagy más formátumból származnak. ### **Miért fontos megérteni az elemeket?** Mert a Mergadóban szinte minden munka (lekérdezések, szabályok, számítások, exportok) elemeken alapul. Az elemek megértése a kulcs az adatok módosításának és feldolgozásának pontos irányításához. --- ## **2\. Az elemek alapjai** ### **Elemtípusok** A Mergado négy alapvető elemtípust különböztet meg. Mindegyiknek sajátos viselkedése és felhasználási lehetőségei vannak. #### **1. Egyszerű elemek** * **Egyetlen értékük** van. * Pozíciójuk (`@@POSITION`) mindig **1-gyel egyenlő**. * Használatukkor nem szükséges pozíciót megadni. **Példa:** \47\ Az `ITEM_ID` útvonal ugyanarra az értékre mutat, mint az `ITEM_ID { @@POSITION = 1 }`. #### **2. Többszörös elemek** * **Több azonos típusú értéket** tartalmaznak. * Minden értéknek saját **pozíciója** van (1, 2, 3 ...). * Konkrét érték célzásához **feltételeket** vagy a `@@POSITION` és `@@VALUE` attribútumokat használjuk. **Példa:** \url1.jpg\ \url2.jpg\ Az `IMAGE` elem két értékkel rendelkezik – az 1. és 2. pozíción. A többszörösség leggyakrabban képeknél, szállítási módoknál, paramétereknél vagy kategóriáknál fordul elő. #### **3. Beágyazott elemek** * **Egy másik elem (ún. szülő) belsejében** találhatók. * Hierarchikus adatstruktúrát alkotnak. * A Mergadóban a beágyazás behúzással jelenik meg, az elem útvonalában pedig függőleges vonallal `|`. **Példa:** \ \Szín\ \Fekete\ \ Az értékhez vezető útvonal: * PARAM | VAL Ez az írásmód jelzi, hogy a `VAL` érték a `PARAM` elemen belül található. #### **4. Attribútumos elemek** * Az attribútum kiegészítő információ, amely az elem jelentését bővíti. * Az XML-ben a nyitó tagben szerepel, és a `@` jellel jelöljük. * A Mergadóban az attribútumok szokásos módon használhatók, a `@` jelű útvonallal. **Példa:** \kep.jpg\ Az attribútumhoz vezető útvonal: * IMAGE | @description ### **Az elemek megjelenítése a Mergado Editorban** #### **Az *Elemek* oldal** Az *Elemek* oldalon megtalálod a projekt összes elemének teljes áttekintését. Itt az elemeket: * megjelenítheted és elrejtheted (a kimeneti feed számára), * hozzáadhatod, törölheted vagy átnevezheted (felhasználói elemeknél), * rendezheted név vagy struktúra szerint, * megtekintheted a **bemeneti és kimeneti értékeiket**. Az elem nevére kattintva megnyílik az összes értékének részletes áttekintése. #### **A *Termékek* oldal** A *Termékek* oldalon az elemek két módon jeleníthetők meg: * **„Elemek" nézet** – egy adott termék összes elemét és értékeit jeleníti meg. * **„Táblázat" nézet** – lehetővé teszi konkrét elemek kiválasztását és áttekinthető táblázatban való megjelenítését. #### **Az *Elem útvonal* (Element-Path) eszköz** Az *Elemek* oldalon és a szabályokban elérhető az **Elem útvonal** eszköz, amely segít a helyes útvonal megírásában és érvényességének ellenőrzésében. Megmutatja, hova vezet pontosan az útvonal, és megkönnyíti a munkát a szabályokkal és lekérdezésekkel. ### **Összefoglaló** Az elemek az alapvető egységek, amelyekkel a Mergado dolgozik. Funkciójuk szerint különböztetjük meg őket (egyszerű, többszörös, beágyazott, attribútumos), és megértésük a kulcs a hatékony munkához a szabályokkal, lekérdezésekkel és a feed struktúrájával. ## **GYIK** ### **Milyen elemtípusok léteznek a Mergadóban?** Négy alaptípus létezik: * Egyszerű – egyetlen értékük van. * Többszörös – több értéket tartalmaznak. * Beágyazott – egy másik elemen belül találhatók. * Attribútumos – kiegészítő információt adnak az értékhez. ### **Mit jelent az elem pozíciója?** Minden elemérték rendelkezik pozícióval (pl. első, második, harmadik érték). Egyszerű elemeknél a pozíció mindig 1, többszörös elemeknél magasabb is lehet. ### **Hogyan dolgozzunk a többszörös elemekkel?** A többszörös elemek (pl. IMAGE) több értékkel rendelkezhetnek. Velük feltételek vagy speciális attribútumok segítségével dolgozunk: `@@POSITION` (pozíció szerinti célzás) és `@@VALUE` (tartalom szerinti célzás). ### **Hogyan ismerjük fel a beágyazott elemet?** A beágyazott elem egy másik elem (ún. szülő) belsejében található. Az elem útvonalában függőleges vonallal jelöljük, pl. `PARAM | VAL`. ### **Hogyan írjuk le az elemek attribútumait?** Az attribútumokat a `@` jellel jelöljük. Példa: * \kep.jpg\ A Mergadóban ennek az attribútumnak az útvonala `IMAGE | @description`. Egyes feedformátumoknál (pl. ceneo) az attribútumok a burkoló elemnél is megtalálhatók. * \ \Terméknév\ … \ Ebben az esetben a Mergadóban az attribútum útvonala `@id`, `@price`, `@avail`. Ha új attribútumot akarsz létrehozni a burkoló elemhez, azt az **Elemek** oldalon új sorban add hozzá – ne a meglévő elem **+** ikonjával. ### **Hol találom meg az elemeket a Mergadóban?** Az **Elemek** oldalon, a projekt bal oldali menüjében. Itt az elemeket megjelenítheted, elrejtheted, hozzáadhatod vagy rendezheted struktúra szerint. ### **Hogyan jelenítsem meg egy elem értékeit?** Az elem nevére kattintva az **Elemek** oldalon megnyílik az összes értékének áttekintése – bemeneti és kimeneti egyaránt. ### **Hogyan jelennek meg az elemek a Termékek oldalon?** A **Termékek** oldalon választhatsz: * Elemek nézet – egy adott termék összes eleme és értéke, * Táblázat nézet – áttekinthető kilistázás a kiválasztott elemekről táblázatban. ### **Mi az Elem útvonal (Element-Path) eszköz?** Az **Element-Path**, azaz az Elem útvonal a Mergado által fejlesztett nyelv, amely az **elemekhez és értékeikhez vezető útvonalak leírására** szolgál. Az Element-Path segítségével meghatározod, **a feed mely értékeit akarod célozni** – olvasni vagy írni. A Mergado Editor az elemekkel ugyanúgy dolgozik, mint az XML feed – fastruktúrában. Ahhoz, hogy ebben a struktúrában pontosan meghatározhasd, milyen adatokkal akarsz dolgozni, ismerned kell az **útvonalat**. Éppen ezt teszi lehetővé az Element-Path. ### **Mi a különbség az egyszerű és a többszörös elem között?** Az egyszerű elem minden terméknél egyetlen értékkel rendelkezik (pl. `ITEM_ID`). A többszörös elemnek egy terméknél több értéke is lehet (pl. több `IMAGE` tag) – ezekkel az Element-Path segítségével egyenként is dolgozhatsz. ## **3\. Elemek beágyazása** ### **Mi az a beágyazás** A **beágyazás (vagy befészkelés)** az elem olyan tulajdonsága, amely meghatározza az XML feed hierarchiájában elfoglalt helyét. Egy elem beágyazottnak minősül, ha az XML-ben **egy másik elem nyitó és záró tagja között** található. A beágyazás struktúrát teremt, amely segíti az áttekinthetőséget és az adatok logikai kapcsolatait. Ennek az elvnek gyakorlati jelentősége van – az egymásba ágyazott elemek általában **összefüggenek és egy egészet alkotnak**. Ilyen struktúrával találkozol például a termékparamétereknél, kategóriáknál vagy szállítási opcióknál. **Példa:** \ \Szín\ \Fekete\ \ Ebben az esetben: * a `PARAM_NAME` a paraméter neve, * a `VAL` az értéke, * a `PARAM` a fölérendelt elem, amely mindkettőt összefogja. Ennek a struktúrának köszönhetően a Mergado felismeri, hogy a „Fekete" érték a „Szín" paraméterhez tartozik. ### **Szülők, gyerekek és testvérek** A beágyazott elemek között az XML fastruktúrájának megfelelő kapcsolatok jönnek létre: | Kapcsolattípus | Leírás | | ----- | ----- | | **Szülő (Parent)** | Az az elem, amelybe egy másik elem beágyazódik. | | **Gyerek (Child)** | Az elem, amely egy másik elemen belül van. | | **Testvérek (Siblings)** | Azonos szülővel rendelkező elemek. | **Példa a kapcsolatokra:** PARAM | PARAM\_NAME PARAM | VAL * A `PARAM` a szülő. * A `PARAM_NAME` és `VAL` a gyerekei. * A `PARAM_NAME` és `VAL` egymás testvérei. A Mergado Editorban ez a kapcsolat vizuálisan behúzásként jelenik meg – a gyerekek az *Elemek* és *Termékek* oldalakon mindig jobbra tolva láthatók a szülőhöz képest. ### **A Mergado és a beágyazott struktúra** A Mergado Editor **átveszi és megjeleníti az XML feed struktúráját a természetes fastruktúrában**. Minden elem megőrzi a szülőjéről és gyerekeiről szóló információt, ami lehetővé teszi: * pontos megkülönböztetést, mely értékek tartoznak össze, * konkrét érték pontos célzását (pl. `PARAM | VAL`), * új beágyazott elemek létrehozását és kezelését közvetlenül az Editor felületén. Az **Elemek** oldalon új beágyazott elemet a szülő elem **+** ikonjára kattintva adhatsz hozzá. Az így létrehozott elem üres, és szabállyal (pl. *Átírás*) töltheted fel értékkel. A jobb orientáció érdekében a struktúrát mappákhoz és fájlokhoz hasonlíthatod: * a **szülő elem** a mappa, * a **gyerek** a fájl vagy almappa benne. Például a `PARAM | VAL` útvonal azt jelenti, hogy a `VAL` érték a `PARAM` elemen belül található. ### **CSV és beágyazás** A beágyazás az **XML** és **JSON** formátumok természetes tulajdonsága, de a **CSV** formátum nem tudja natívan kifejezni. Ezért a Mergado a CSV-ben a beágyazást **a `szülő | gyerek` írásmóddal szimulálja**, hogy az adatokkal ugyanúgy lehessen dolgozni, mint XML-ben. A gyakorlatban ez azt jelenti, hogy a CSV fájlban minden oszlop egy elem útvonalat jelöl. Például: PARAM | PARAM\_NAME PARAM | VAL Ez az írásmód kifejezi, hogy a `VAL` elem a `PARAM` elem alá van beágyazva. Így a Mergado képes fenntartani az adatok logikai kapcsolatait még olyan formátumoknál is, amelyek önmagukban nem támogatják a beágyazást. ### **Munka a beágyazással a Mergado Editorban** #### **1. Beágyazott elem útvonalának leírása** Amikor egy szabályban vagy lekérdezésben beágyazott elemmel akarsz dolgozni, az útvonalat a függőleges vonal `|` segítségével írod le. **Példa:** * PARAM | VAL Ez az írásmód azt jelenti: „Keresd meg a `PARAM` elemet, és benne a `VAL` gyereket." A szóközöket a függőleges vonal előtt és után be kell tartani. * Helyes: `PARAM | VAL` * Helytelen: `PARAM|VAL` #### **2. Pontos célzás feltétellel** Ha a `PARAM` elemnek több értéke van (pl. több paraméter), érdemes **feltételt** megadni a pontosabb célzáshoz. A feltételeket kapcsos zárójelekben `{ }` írjuk, és az adott kritérium szerint szűrik az értékeket. **Példa:** * PARAM { PARAM\_NAME \= "Kijelzőtípus" } | VAL Ez az írásmód azt jelenti: „Keresd meg a `PARAM` elemet, amelynek `PARAM_NAME` gyerekének értéke *Kijelzőtípus*, és módosítsd a `VAL` értékét." Így pontosan a kívánt paramétert célzod, függetlenül a feedbeli pozíciójától. ### **Különbség az XML és CSV beágyazás-kezelése között** | Tulajdonság | XML feed | CSV feed | Megjelenítés a Mergadóban | | ----- | ----- | ----- | ----- | | **Beágyazás kezelése** | Igen, natívan. | Nem, a Mergado szimulálja. | Igen, fastruktúrán keresztül. | | **Kapcsolatok megjelenítése** | Tagekkel és behúzással. | Oszlopnevekkel. | Behúzással az *Elemek* és *Termékek* oldalakon. | | **Útvonal leírása** | Tagekkel. | `Szülő | Gyerek`. | | Míg az XML a beágyazást jelölőkkel és egymásba ágyazott tagekkel fejezi ki, a CSV az elválasztójeles `|` útvonal-írásmódot használja. A Mergado mindkét struktúrát egységesíti, és lehetővé teszi az azonos módon történő munkát. ### **Összefoglaló** A beágyazás a Mergado Editorban való adatfeldolgozás alapelve. Lehetővé teszi annak felismerését, hogyan függenek össze az egyes elemek értékei, és ezáltal pontosan célozhatók a szabályok és lekérdezések. A beágyazás helyes megértése a kulcs a hatékony munkához a paraméterekkel, szállítási opciókkal, variánsokkal és más többszörös struktúrákkal. Akár XML, akár CSV feedel dolgozol, a Mergado képes megjeleníteni, fenntartani és felhasználni a beágyazást minden típusú módosításnál. ## **GYIK** ### **Mi az elem beágyazása?** A beágyazás az elem olyan tulajdonsága, amely meghatározza, hogy **egy másik elemen belül található**. Ez a kapcsolat adathierarchiát hoz létre – például a `PARAM` elem (szülő) tartalmazhatja a paraméterek neveit és értékeit (`PARAM_NAME` és `VAL`), amelyek a gyerekei. A *beágyazott* és *befészkelődött* kifejezések ugyanazt jelentik. ### **Mire szolgál a beágyazás?** A beágyazás segít fenntartani az **adatok logikus és áttekinthető struktúráját**. Lehetővé teszi az értékek egyértelmű hozzárendelését a kontextusukhoz – például hogy a „Szín" paraméternek a „Fekete" az értéke. Így az összefüggő információk egyetlen struktúrába szervezhetők. ### **Milyen kapcsolatok léteznek a beágyazott struktúrában?** A beágyazott elemek háromféle kapcsolatot alkotnak: * **Szülő (Parent)** – az elem, amely más elemeket tartalmaz. * **Gyerek (Child)** – az elem, amely egy másik elemen belül van. * **Testvérek (Siblings)** – azonos szülővel rendelkező elemek. Példa: a `PARAM | VAL` útvonalban a `PARAM` a szülő, a `VAL` a gyereke. ### **Hogyan néz ki egy beágyazott elem XML-ben?** Az XML-ben a beágyazást egymásba ágyazott tagek fejezik ki. Példa: \ \Szín\ \Fekete\ \ A `PARAM` elem a szülő, a `PARAM_NAME` és `VAL` a gyerekei. ### **Hogyan jeleníti meg a Mergado a beágyazott elemeket?** A Mergado Editor az elemeket **fastruktúrában** jeleníti meg, amely megfelel az XML feed struktúrájának. A beágyazott elemek balról behúzva láthatók a szülőjükhöz képest. A beágyazás a *Termékek* és *Elemek* oldalakon egyaránt látható. Új beágyazott elem a szülő elem **+** ikonjára kattintva hozható létre. ### **Hogyan írjuk le a beágyazást az Element-Path-ban?** A beágyazást **függőleges vonallal `|`** jelöljük az elemnevek között. Példa: PARAM | VAL Ez az írásmód azt jelenti, hogy a `VAL` a `PARAM` elem gyereke. A szóközöket a függőleges vonal előtt és után be kell tartani. * Helyes: `PARAM | VAL` * Helytelen: `PARAM|VAL` ### **Hogyan fejezi ki a CSV formátum a beágyazást?** A CSV formátum nem tudja natívan kifejezni a hierarchiát, ezért a Mergado a beágyazást a `szülő | gyerek` írásmóddal **szimulálja**. Például a `PARAM | PARAM_NAME` és `PARAM | VAL` ugyanazt a kapcsolatot fejezi ki, mint az XML struktúrában. ### **Mely fájltípusok tudnak beágyazással dolgozni?** A beágyazással természetesen az **XML** és **JSON** formátumok dolgoznak. A CSV formátum natívan nem támogatja, de a Mergado Editor éppen a `szülő | gyerek` írásmóddal segíti ebben. ### **Mi a beágyazási szintek maximális száma?** Nincs elméleti korlátja a beágyazás mélységének. A gyakorlatban a Mergado akár kilenc beágyazási szinttel is találkozott, például Upgates formátumú feedeknél. ### **Hogyan célozzunk pontosan egy beágyazott elem értékére?** A pontos célzáshoz **feltételt használunk az útvonalban**. Példa: `PARAM { PARAM_NAME = "Kijelzőtípus" } | VAL` Ez az írásmód azt jelenti: „Keresd meg a `PARAM` elemet, amelynek `PARAM_NAME` gyerekének értéke *Kijelzőtípus*, és dolgozz a `VAL` elemével." Ez a legmegbízhatóbb módszer, mert a feed struktúrájában elfoglalt pozíciótól független. ### **Hogyan célozzunk, ha az elem egyszerre többszörös és beágyazott?** Ha az elem többszörös (pl. a `PARAM` többször ismétlődik), feltételt kell használni. A `PARAM | VAL` útvonal feltétel nélkül minden értéket céloz, de a pontos célzást a következő írásmód biztosítja: `PARAM { PARAM_NAME = "Szín" } | VAL` ### **Miért biztonságosabb a gyerek szerinti célzás, mint a @@POSITION?** A gyerek szerinti célzás (pl. `PARAM_NAME = "Szín"`) biztonságosabb, mert a helyes értéket választja ki, függetlenül a listabeli pozíciójától. A `@@POSITION` attribútum csak a sorrendre hivatkozik, így ha a paraméterek sorrendje termékenként eltér, hibás eredményre vezethet. ### **Miért fontos a beágyazással való munka?** Az összetett adatok többsége – mint a paraméterek, szállítás vagy variánsok – beágyazott. A beágyazás helyes megértése lehetővé teszi a pontos adatkezelést, megbízható szabályok létrehozását és a feed logikus struktúrájának fenntartását. ## **4\. Elemek többszörössége** ### **Mit jelent a többszörös elem** A többszörös elem olyan elem, amelynek **több azonos nevű értéke** létezik. A feed struktúrájának szempontjából ez azt jelenti, hogy egy terméken belül az adott elem ismétlődik – például képeknél, paramétereknél vagy variánsoknál. A többszörösség lehetővé teszi, hogy **több rokon értéket egyetlen elemnév alá** vonjunk össze, és ne kelljen minden értékhez új elemet létrehozni. A többszörös elemekkel leggyakrabban a következőknél találkozol: * kép URL-ek (pl. `IMGURL_ALTERNATIVE`), * termékparaméterek (`PARAM`), * szállítás (`DELIVERY`), * kategóriák, * termékvariánsok. **Példa XML struktúrában:** \url1.jpg\ \url2.jpg\ Ebben az esetben az `IMGURL_ALTERNATIVE` elem többszörös, mert több értéke van. ### **Különbség az egyszerű és a többszörös elem között** | Tulajdonság | Egyszerű elem | Többszörös elem | | ----- | ----- | ----- | | **Értékek száma** | Csak egyetlen érték. | Több azonos nevű érték. | | **Érték pozíciója** | Mindig 1. | Minden értéknek saját pozíciója van (2, 3 …). | | **Útvonal leírása** | Nem szükséges pozíciót megadni. | Konkrét érték célzásához feltétel vagy `@@POSITION` attribútum szükséges. | | **Példák** | `ITEM_ID`, `DESCRIPTION`, `PRICE_VAT` | `IMAGE`, `PARAM`, `DELIVERY`, `IMGURL_ALTERNATIVE` | Beágyazott struktúráknál (pl. `PARAM`) a többszörösség a szülő elemre vonatkozik. A gyerekek (tipikusan `PARAM_NAME` és `VAL`) egyszerűek maradnak, mert egy szülőn belül mindig csak egyetlen értékük van. ### **Pozíciók a Mergadóban** Minden elemérték rendelkezik sorszámmal, azaz **pozícióval** (1, 2, 3 …). A pozíció felhasználható egy konkrét érték pontos célzásához az elemen belül. A pozíciókkal való munkához a Mergadóban a `@@POSITION` speciális attribútumot használjuk. Ez az **Element-Path** nyelv része, és meghatározza, melyik pozíciót akarod célozni. **Példa:** \url1.jpg\ @@POSITION \= 1 \url2.jpg\ @@POSITION \= 2 \url3.jpg\ @@POSITION \= 3 Ha a harmadik képpel akarsz dolgozni, a következő útvonalat használd: * IMAGES | IMAGE { @@POSITION \= 3 } Ez az írásmód azt jelenti: „A 3. pozíción lévő `IMAGE` elemmel dolgozom." #### **A `@@POSITION` attribútum korlátai** A `@@POSITION` attribútum csak a sorrendre hivatkozik, nem a tartalomra. Ha az értékek sorrendje termékenként eltér, ugyanaz a pozíció különböző információkra mutathat. Példa: * Az első terméknél a paraméterek: 1. Anyag, 2. Térfogat. * A második terméknél: 1. Anyag, 2. Dekor. A `PARAM { @@POSITION = 2 } | VAL` útvonal a második terméknél a *Dekor*-ra mutat, nem a *Térfogat*-ra. Biztonságosabb ezért név szerint célozni: * PARAM { PARAM\_NAME \= "Térfogat" } | VAL ### **Munka a többszörösséggel a Mergado Editorban** #### **Pozíció felderítése és használata** 1. Az **Elemek** oldalon nyisd meg az adott elemet, és megjelenik az összes értéke a pozíciókkal együtt. 2. A szabályokban és lekérdezésekben célozhatsz: * pozíció szerint, pl. `IMGURL_ALTERNATIVE { @@POSITION > 1 }`, * vagy pozíciótartomány szerint, pl. `IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }`. 3. Ha inkább érték szerint akarsz dolgozni, használd a `@@VALUE` attribútumot, például: * `CATEGORY { @@VALUE != "Játékok" }` 4. Ez az írásmód a `CATEGORY` elem minden értékét kiválasztja, kivéve a „Játékok"-at. #### **Mikor nem szükséges pozíciót megadni** Az útvonalban a pozíció megadása nem szükséges a következő esetekben: 1. **Egyszerű elemek** 1. Mindig egyetlen értékük van, tehát pozíció = 1. Az `ITEM_ID` útvonal ekvivalens az `ITEM_ID { @@POSITION = 1 }` írásmóddal. 2. **Olvasás többszörös elemből feltétel nélkül** 1. Ha szabályban olvasol egy többszörös elemből feltétel nélkül, a Mergado automatikusan az első értéket használja. 2. Például: a `%PARAM | VAL%` használatakor a Mergado az első értéket veszi. 3. **Minden érték célzása** 1. Ha az elem összes előfordulását fel akarod dolgozni, használd az elem nevét feltétel nélkül. 2. Pl. az `IMAGES | IMAGE` útvonal minden képpel dolgozik. 3. Íráskor tartsd szem előtt, hogy a változás az adott útvonalnak megfelelő összes értéknél végrehajtódik. ### **Összefoglaló** A többszörösség lehetővé teszi több azonos típusú érték tárolását és feldolgozását egyetlen elemen belül. A pontos munkához feltételekkel vagy speciális attribútumokkal célozd a konkrét értékeket. Így biztosítod, hogy a módosítások helyesen történjenek, és ne érintsék a többi adatot. ## **GYIK** ### **Mi az a többszörös elem?** A többszörös elem olyan elem, amelynek több azonos nevű értéke van. A gyakorlatban ez azt jelenti, hogy egy terméken belül ismétlődik – például képeknél, paramétereknél, szállításnál vagy kategóriáknál. Tipikus többszörös elemek: `IMAGE`, `PARAM`, `DELIVERY` vagy `CATEGORY`. ### **Mi a különbség az egyszerű és a többszörös elem között?** * Az **egyszerű elem** egyetlen értéket tartalmaz, pozíciója mindig 1. * A **többszörös elem** több értékkel rendelkezhet, amelyek mindegyikének saját pozíciója van (2, 3, 4 …). Példa: `url1.jpg` `url2.jpg` Az `IMAGE` elem többszörös, mert többször fordul elő és több értéket tartalmaz. ### **Mire szolgál a többszörösség?** A többszörösség lehetővé teszi, hogy több rokon értéket egyetlen elemnév alá vonjunk össze. Nem szükséges tehát minden értékhez új elemet létrehozni. Például egy termék összes alternatív képe `IMGURL_ALTERNATIVE` ismétlődő elemekként írható le. ### **Mely elemek tipikusan többszörösek?** A többszörösség leggyakrabban a termékek ismétlődő tulajdonságait leíró elemeknél fordul elő, például: * kép URL-ek (`IMGURL_ALTERNATIVE`), * termékparaméterek (`PARAM`), * szállítás (`DELIVERY`), * kategóriák, * termékvariánsok. ### **Hogyan dolgozik a Mergado az értékek pozíciójával?** Minden elemértéknek van **pozíciója**, azaz sorszáma (1, 2, 3 …). A pozíció felhasználható egy konkrét érték pontos célzásához az elemen belül. Ehhez a `@@POSITION` speciális attribútumot használjuk. Példa: `IMAGES | IMAGE { @@POSITION = 3 }` Ez az írásmód azt jelenti: „A 3. pozíción lévő `IMAGE` elemmel dolgozom." ### **Mit jelent a @@POSITION attribútum és hogyan használjuk?** A `@@POSITION` meghatározza az érték sorrendjét a többszörös elemen belül. Feltételekben használható konkrét pozíció vagy pozíciótartomány célzásához. Példa: `IMGURL_ALTERNATIVE { @@POSITION > 1 }` Ez az írásmód az első kivételével minden alternatív képet céloz. Fontos azonban tudni, hogy a `@@POSITION` csak a sorrenddel dolgozik, nem a tartalommal. Ha a sorrend termékenként eltér, hibás értéket célozhat. ### **Mi az a @@VALUE attribútum és mikor használjuk?** A `@@VALUE` az **elem értékének tartalmát** jelöli, és lehetővé teszi az érték szerinti célzást a pozíció helyett. Elsősorban gyerek nélküli elemeknél használjuk, például `CATEGORY` vagy `IMGURL_ALTERNATIVE`. Példa: `CATEGORY { @@VALUE != "Játékok" }` Ez az írásmód a „Játékok" kivételével minden kategóriát kiválaszt. ### **Hogyan célozzunk többszörös elemek értékeire az Element-Path-ban?** A célzás kapcsos zárójelbe `{ }` írt feltételekkel történik. Bennük a `@@POSITION`, `@@VALUE` attribútumokat vagy MQL nyelvi kifejezéseket használhatunk. **Minden érték célzása:** `IMAGES | IMAGE` * Az összes értéket feldolgozza (`url1`, `url2`, `url3` …). **Konkrét értékek vagy pozíciótartomány célzása:** `IMAGES | IMAGE { @@POSITION IN (3;4) }` * A harmadik és negyedik képet célozza. ### **Hogyan derítem ki az értékek pozícióit a Mergado Editorban?** Az **Elemek** oldalon minden elemnél megjelenítheted az összes értéket a pozíciójukkal együtt. Ez az áttekintés segít jobban megérteni a többszörös adatok struktúráját, és megkönnyíti a szabályokban való célzást. ### **Mikor nem szükséges pozíciót megadni az útvonalban?** A pozíció megadása nem szükséges a következő esetekben: * **Egyszerű elemek** – mindig egyetlen értékük van (pozíció = 1). Az `ITEM_ID` ekvivalens az `ITEM_ID { @@POSITION = 1 }` írásmóddal. * **Olvasás többszörös elemből feltétel nélkül** – a Mergado automatikusan az első értéket használja. Pl. a `%PARAM | VAL%` az első értéket veszi. * **Minden érték célzása** – elég az elem nevét feltétel nélkül megadni, pl. `IMAGES | IMAGE`. ### **Mi a különbség a pozíció és az érték szerinti célzás között?** * A `@@POSITION` az érték sorrendjével dolgozik. * A `@@VALUE` az érték tartalmával dolgozik. Ha az értékek sorrendje termékenként eltér, biztonságosabb a `@@VALUE` használata, mert közvetlenül a tartalmat célozza. ### **Mi a @@POSITION szerinti célzás problémája?** A `@@POSITION` csak a sorrendre hivatkozik. Ha a termékek paraméterei eltérő sorrendben vannak, az útvonal hibás értéket célozhat. Biztonságosabb a gyerek neve szerinti célzás, például: `PARAM { PARAM_NAME = "Térfogat" } | VAL` ### **Hogyan dolgozzunk többszörös elemekkel szabályokban és lekérdezésekben?** A többszörös elemekkel való munka attól függ, hogy a szabály az elemből **olvas** vagy belé **ír**. **Olvasás:** * Ha az útvonal több értékhez vezet, a Mergado az elsőt használja. * Ha más értéket akarsz olvasni, az útvonalat feltétellel kell pontosítani. **Írás:** * Ha a szabály többszörös elembe ír, a változás az adott útvonalnak megfelelő összes értéknél végrehajtódik. * Ha csak egy konkrét értékbe akarsz írni, az útvonalat feltétellel kell szűkíteni. * Ha a feltétel `=` operátort vagy `AND` kötőszót tartalmaz, a Mergado automatikusan létrehozza a hiányzó struktúrát. ### **Miért fontos megkülönböztetni a többszörösséget?** A többszörösség meghatározza, hogy az elem több azonos típusú értéket tartalmazhat. Ennek megértése alapvető a szabályok, lekérdezések helyes beállításához és a feedbeli adatok pontos célzásához. --- ## **5\. Munka többszörös elemekkel a Mergado szabályokban** A többszörös elemek a Mergado Editorban eltérően viselkednek, mint az egyszerű elemek. Minden termék több azonos elemértéket tartalmazhat, ezért tudni kell, hogyan dolgoznak velük a szabályok – hogyan olvassák, írják és hogyan célozzuk pontosan az értékeket. ### **Olvasás és írás a szabályokban** A többszörös elem olyan, amelynek egy terméknél **több mint egy értéke** van. A Mergado szabályai (például *Átírás*, *Tömeges értékmásolás*, *Számítás*) ilyen esetben meghatározott alapértelmezett viselkedéssel rendelkeznek. #### **Olvasás elemekből és változókból** Ha a szabály egy többszörös elem értékét olvassa, amelynek útvonala több értékhez vezet, a **Mergado automatikusan csak az első értéket használja**. Ez a viselkedés a százalékjeles `%` írásmóddal történő olvasásnál érvényes (pl. `%PARAM | VAL%`). Példa: \Fekete\ \XL\ Ha a szabály a `PARAM | VAL` útvonalról olvas, a Mergado csak az első, „Fekete" értéket veszi. Egyszerű elemeknél (pl. `ITEM_ID`) ez a logika nem érvényesül, mert mindig csak egyetlen érték létezik. #### **Írás elemekbe** Ha a szabály további pontosítás nélkül többszörös elembe ír, a **Mergado az adott elem minden előfordulásába** beírja az értéket. Példa: * Ha az *Átírás* szabályban az `IMGURL_ALTERNATIVE` útvonalat használod és új értékként `uj_kep.jpg`-t adsz meg, a Mergado az elem összes meglévő értékét átírja. Ha csak egy konkrét értékbe akarsz írni, az útvonalat **feltételekkel kell pontosítani**. Például a * PARAM { PARAM\_NAME \= "Szín" } | VAL útvonal csak a „Szín" paraméterekbe ír. Ha egy terméken belül a „Szín" paraméter többször fordul elő, a módosítás ezek mindegyikénél végrehajtódik. ### **Feltételek és speciális attribútumok használata** Egy többszörös elem konkrét értékének pontos célzásához **feltételt** kell megadni. A feltételek szűrőként működnek – meghatározzák, mely értékekre vagy pozíciókra vonatkozik a szabály. Kapcsos zárójelekbe `{ }` írjuk őket, és tartalmazhatnak **beágyazott elemet** vagy **speciális attribútumot**. #### **1. Beágyazott elem használata feltételben** Ez a módszer a **legmegbízhatóbb**, mert az érték tartalma alapján céloz, nem a sorrend alapján. Példa: A `VAL` elem értékét akarjuk átírni, amely a „Szín" paraméterhez tartozik: * PARAM { PARAM\_NAME \= "Szín" } | VAL Ez az írásmód azt jelenti: „Keresd meg az összes `PARAM` elemet, amelynek `PARAM_NAME` gyerekének értéke *Szín*, és módosítsd a `VAL` elem értékét." Ez a módszer független az elemek feedbeli sorrendjétől, ezért a legtöbb esetben ezt érdemes használni. #### **2. A @@POSITION speciális attribútum használata** A `@@POSITION` attribútum az érték sorrendje szerinti célzásra szolgál. Minden elemérték rendelkezik pozícióval – első = 1, második = 2 stb. Példa: IMGURL\_ALTERNATIVE { @@POSITION \> 1 } Ez az írásmód az első kivételével minden képet céloz. **Mikor érdemes használni:** Olyan elemeknél, ahol az értékek sorrendje megfelel a jelentésüknek (pl. alternatív képek). **Gyengesége:** A `@@POSITION` célzás csak a pozícióra hivatkozik, nem a tartalomra. Ha az értékek sorrendje termékenként eltér, az eredmény nem biztos, hogy konzisztens. #### **3. A @@VALUE speciális attribútum használata** A `@@VALUE` attribútum az elem **tényleges értékére** hivatkozik, nem a sorrendjére. Ott érdemes használni, ahol a sorrend változik vagy nem lényeges. Példa: * CATEGORY { @@VALUE \!= "Játékok" } Ez az írásmód a `CATEGORY` elem „Játékok" kivételével minden értékét célozza. A `@@VALUE`-t elsősorban gyerek nélküli elemeknél használjuk (pl. `CATEGORY`, `IMGURL_ALTERNATIVE`). Szülő elemeknél, amelyek maguk nem hordoznak értéket (pl. `PARAM`), nincs értelme a használata. ### **Gyakorlati útvonalpéldák** A Mergado szabályai az elemekkel való munka során (olvasás/írás) az **Element-Path** nyelvet használják, amely lehetővé teszi az olvasni vagy írni kívánt értékek pontos célzását. #### **Konkrét paraméter értékének célzása** * PARAM { PARAM\_NAME \= "Szín" } | VAL Ez az írásmód a *Szín* nevű paraméter `VAL` értékét olvassa vagy írja. A Mergado a következőképpen értelmezi: „Keresd meg a `PARAM` elemet, amelynek `PARAM_NAME` gyerekének értéke *Szín*, és módosítsd a `VAL` gyerek értékét." #### **Variánsok értékének célzása** Az útvonal több beágyazási szintet és többszörösséget is kombinálhat. Példa a második variánssal való munkára, amely „Méret" paramétert tartalmaz: * VARIANTS | VARIANT { @@POSITION \= 2 } | PARAMETERS | PARAMETER { NAME \= "Méret" } | VALUE Ez az írásmód azt jelenti: „Keresd meg a termék második variánsát, amelyben a *Méret* paraméter egy adott értéket hordoz, és dolgozz ezzel az értékkel." ### **Új értékek hozzáadása szabályokkal** Többszörös vagy beágyazott elemekbe való írásnál egy fontos szabály érvényes: **Ha a célzott elem még nem létezik, a Mergado automatikusan létrehozza.** Ez azt jelenti, hogy minden, ami a feltételben szerepel (pl. `PARAM_NAME = "Szín"`) és az `=` operátorral vagy `AND` kötőszóval írt útvonalban, automatikusan létrejön. Példa új strukturált érték – ún. „flag" – hozzáadására: Elem: FLAGS | FLAG { CODE \= "action" } | ACTIVE Új érték: 0 Ha a „action" kódú flag nem létezik, a Mergado létrehoz egy új `FLAG`-et (új pozíciót) a `CODE = "action"` elemmel, és hozzáadja az `ACTIVE` elemet 0 értékkel. Ez a mechanizmus új variánsok, szállítási opciók, paraméterek és egyéb strukturált adatok hozzáadásakor használatos. --- ### **A többszörösséggel érintett szabályok áttekintése** A többszörös értékek olvasási és írási viselkedése a következő szabályokra vonatkozik: | Szabály | Tud olvasni | Ír | | :---- | :---- | :---- | | Átírás | ✅ | ✅ | | Keresés és csere | ✅ | ✅ | | Tömeges átírás lekérdezések alapján | ✅ | ✅ | | Tömeges átírás értékek alapján | ✅ | ✅ | | Tömeges értékmásolás | ✅ (Forráselem) | ✅ | | Termékparaméterek beállítása | ✅ | ❌ | | Szállítási ár beállítása | ✅ | ❌ | | UTM paraméterek beállítása | ✅ | ❌ | | Számítás | ✅ | ✅ | | Adatfájl importálása | ❌ | ✅ | ### **Összefoglaló** A többszörös elemekkel való munkánál a Mergado Editor szabályaiban a legfontosabb **tudni, melyik értékkel dolgozol**. Pontosítás nélkül a szabály mindig az első értéket olvassa, és az összes megfelelő értékbe ír. Feltételekkel, a `@@POSITION` és `@@VALUE` speciális attribútumokkal vagy több beágyazási szint kombinálásával pontosan meghatározhatod, mit módosít a szabály. A helyesen megírt elem útvonal biztosítja, hogy a módosítások pontosan ott történjenek, ahol kell – és biztonságosak maradjanak akkor is, ha a feed struktúrája idővel változik. ## **GYIK** ### **Mi a szabályok alapelve a többszörös elemek kezelésénél?** A Mergado Editor szabályai a többszörös elemeket két elv alapján kezelik – **értékek olvasása** és **értékek írása**. Az egyszerű elemeknek mindig egyetlen értékük van, így a szabály közvetlenül dolgozik velük. A többszörös elemeknek azonban egy terméknél több értékük is lehet, ezért meg kell határozni, melyikkel dolgozzon a szabály. Pontosítás nélkül a szabályok **az első értéket olvassák** és **az összes értékbe írnak**. ### **Hogyan olvassa a Mergado a többszörös elemek értékeit?** Ha az útvonal több értékhez vezet, a Mergado automatikusan **csak az első értéket** használja. Ez a viselkedés minden szabálynál érvényes, amely a `%` jelöléssel olvassa az elem értékét – pl. `%PARAM | VAL%`. ### **Hogyan ír a Mergado a többszörös elemekbe?** Ha a szabály további pontosítás nélkül többszörös elembe ír, a Mergado az új értéket **az összes előfordulásba (pozícióba)** beírja. Ha csak egy konkrét értéket akarsz célozni, az útvonalat feltétellel kell pontosítani. ### **Miért szükséges feltételeket használni a többszörös elemeknél?** A feltételek **szűrőként** működnek, meghatározzák, mely értékekre vonatkozik a szabály. Feltétel nélkül a szabály az elem összes értékét érintené. ### **Hogyan használjunk beágyazott elemet feltételben?** A beágyazott elem szerinti célzás a legmegbízhatóbb, mert a tartalomra támaszkodik, nem a sorrendre. Példa: `PARAM { PARAM_NAME = "Szín" } | VAL` ### **Mikor használjuk a @@POSITION attribútumot?** A `@@POSITION` az **érték sorrendje** szerinti célzásra szolgál. Példa: `IMGURL_ALTERNATIVE { @@POSITION > 1 }` Ott használd, ahol az értékek sorrendje megfelel a jelentésüknek. Gyengesége: csak a sorrendre hivatkozik, nem a tartalomra. ### **Mikor használjuk a @@VALUE attribútumot?** A `@@VALUE` az **elem tényleges értékére** hivatkozik. Elsősorban gyerek nélküli elemeknél használjuk (pl. `CATEGORY`, `IMGURL_ALTERNATIVE`). Példa: `CATEGORY { @@VALUE != "Játékok" }` ### **Hogyan kombináljuk a feltételeket és speciális attribútumokat?** Egyetlen útvonalban több feltétel és attribútum is kombinálható. A feltételek tartalmazhatnak logikai operátorokat (`AND`, `OR`) vagy MQL nyelvi lekérdezéseket. ### **Hogyan hoz létre a Mergado új értékeket írásnál?** Ha a célzott elem nem létezik, a Mergado írásnál **automatikusan létrehozza**. Ez minden `=` operátort vagy `AND` kötőszót tartalmazó feltételnél érvényes. ### **Hogyan előzzük meg a hibákat a többszörös értékekkel való munkánál?** * Ellenőrizd, hogy az elem, amellyel dolgozol, valóban több értéket tartalmaz-e. * Használj `{ }` feltételeket a pontos célzáshoz. * Kerüld a `@@POSITION`-ra való támaszkodást, ha az értékek sorrendje termékenként eltér. * Írás előtt ellenőrizd, hogy az útvonal nem érint-e több értéket a kívántnál. * Használd az **Elem útvonal** eszközt annak ellenőrzésére, hova céloz a szabály. ## **6\. Attribútumok az elemekben** ### **Mik azok az attribútumok** Az attribútum az **elem része**, amely **pontosítja annak jelentését vagy tulajdonságát**. Míg az elem hordozza az adatokat, az attribútum kiegészítő információt nyújt ezekről az adatokról. Az attribútumok tehát az elemértékek *bővítményeiként* működnek, és gyakran segítenek olyan részleteket leírni, amelyek egyébként nem férnének bele a struktúrába. ### **Attribútumok XML-ben** Az XML-ben az attribútum mindig az **elem nyitó tagjében** szerepel, és saját neve és értéke van. Az attribútum értékét **idézőjelbe vagy aposztrófba** kell zárni. **XML írásmód példa:** \ \Katalin\ \Nagy\ \ Ebben a példában * a `person` az elem, * a `gender` az attribútum, * a `female` az attribútum értéke. A `gender` attribútum tehát pontosítja a személyről szóló információt – hogy nőről van szó. ### **Mire szolgálnak az attribútumok** A termékfeedekben az attribútumoknak gyakorlati jelentőségük van – lehetővé teszik a **termék vagy tulajdonságai pontosabb leírását**. Egyes hirdetési portálok vagy webáruház-platformok kifejezetten megkövetelik, hogy bizonyos adatok attribútumként legyenek megadva. ### **Attribútumok kezelése a Mergado Editorban** A Mergado Editor teljes értékűen tud dolgozni az attribútumokkal. Az attribútumok az elemek egyik alaptípusai, és az Editor teljes környezetében használhatók – szabályokban, lekérdezésekben, változókban és MQL lekérdezésekben. #### **Attribútumok azonosítása** A Mergadóban az attribútumokat **a név elején álló `@` jelről** ismered fel. * `@id` – azonosító attribútum, * `@description` – a képet leíró attribútum, * `@availability` – állapotot vagy elérhetőséget leíró attribútum. A szokásos attribútumokon kívül léteznek **speciális attribútumok** is, amelyek két @-tel `@@` kezdődnek. Ezek az *Element-Path* nyelvben használatosak, és pontos célzásra szolgálnak – tipikusan `@@POSITION` (érték pozíciója) és `@@VALUE` (elem értéke). #### **Attribútumok célzása Element-Path-szal** Az attribútumokkal való munkához az **Element-Path** nyelvet használjuk. Az attribútumhoz vezető útvonalat a `@` jellel írjuk az attribútum neve elé. #### **Attribútum létrehozása** Az attribútumot közvetlenül az **Elemek** oldalon hozhatod létre. 1. Nyisd meg az *Elemek* oldalt, és válaszd az **Új elem** lehetőséget. 2. Add meg a nevet, és válaszd az **attribútum** típust. 3. Ha a névbe `@` jelet írsz, az Editor automatikusan felismeri, hogy attribútumot akarsz létrehozni. 4. Ha beágyazott attribútumot akarsz létrehozni, használd a szülő elem **+** ikonját, és válaszd az *attribútum* típust. Létrehozás után az attribútum üres (nincsenek értékei). Az *Átírás* szabállyal töltheted fel értékkel. #### **Attribútum értékének átírása** Az attribútumokat ugyanúgy módosíthatod, mint a szokásos elemeket – pl. az *Átírás* szabállyal. #### **Attribútum törlése** Az attribútumokat kétféleképpen törölheted: 1. **Manuálisan** – az *Elemek* oldalon a kézzel létrehozott attribútumok a kuka ikonnal törölhetők. 2. **Szabályokkal** – a bemeneti vagy kimeneti formátumból származó attribútumoknál csak az értékek törölhetők, szabállyal (pl. *Átírás* üres értékkel). A célformátum által definiált (ún. rendszer-) attribútumokat nem lehet átnevezni vagy törölni, mert a kimeneti feed specifikációjának részei. ### **Összefoglaló** Az attribútumok kiegészítik az elemek jelentését, és lehetővé teszik a feed adatainak részletesebb leírását. A Mergado Editorban ugyanúgy dolgozhatsz velük, mint a szokásos elemekkel – létrehozhatod, módosíthatod és célozhatod őket szabályokban. Az attribútumokkal való helyes munka különösen fontos a pontos adatstruktúrát megkövetelő portálokra irányuló feedeknél, mint a Google, Heureka, Ceneo vagy Shoptet. ## **7\. Az Element-Path nyelv** ### **Mi az Element-Path** Az **Element-Path** a Mergado által fejlesztett nyelv, amely az **elemekhez és értékeikhez vezető útvonalak leírására** szolgál. Az Element-Path segítségével meghatározod, **a feed mely értékeit akarod célozni** – olvasni vagy írni. A Mergado Editor az elemekkel ugyanúgy dolgozik, mint az XML feed – fastruktúrában. Ahhoz, hogy ebben a struktúrában pontosan meghatározhasd, milyen adatokkal akarsz dolgozni, ismerned kell az **útvonalat**. Éppen ezt teszi lehetővé az Element-Path. ### **Mit jelent az „elem útvonal"** Az *elem útvonal* olyan leírás, amely kifejezi, **hol található az adatstruktúrában az az érték (vagy értékek)**, amellyel dolgozni akarsz. Ezzel az útvonallal közlöd a Mergadóval, hogy: 1. az **értéket olvasni** akarod – tehát bemenetként használni (pl. szabályban vagy lekérdezésben), vagy 2. az **értéket módosítani** akarod – tehát új adatokat írni belé. Az Element-Path szintaxisa tartalmazza az elemneveket, a függőleges vonalat `|` a beágyazás jelölésére, a `{ }` feltételeket, a `@@` speciális attribútumokat és az MQL nyelv lehetőségeit. ### **Segítség az útvonalak írásakor** A Mergado Editorban az Element-Path-szal való munka több funkcióval is megkönnyített: * **Automatikus kiegészítés:** az Editor felajánlja az elérhető elemeket, operátorokat és értékeket. * **Validáció:** Ha a beírt elem nem létezik a projektben, pirosra színeződik; érvényes útvonal zölddel jelenik meg. * **Szállítók és paraméterek kiegészítése:** Bizonyos feedtípusoknál az Editor konkrét neveket ajánl (pl. szállítók, paraméterek), és automatikusan kiegészíti a teljes útvonalat. ### **Hol használjuk az Element-Path-ot** Az elem útvonalakat a Mergado Editor szinte minden részében használjuk – mindenhol, ahol meg kell határozni, milyen adatokkal dolgozunk. * **Szabályokban** – pl. *Átírás*, *Keresés és csere*, *Tömeges értékmásolás*, *Számítás*. * **Lekérdezésekben** – terméklekérdezések létrehozásakor vagy saját MQL lekérdezés írásakor. * **Változókban** – konkrét elemek értékeinek olvasásához és beírásához. * **Importoknál** – az importfájlok elemeiben, amelyeket az *Adatfájl importálása* szabály dolgoz fel. * **A Termékek oldalon** – rendezéshez, szűréshez és az elemértékek áttekintéséhez. * **Automatizálásban** – szabályok és feltételek beállításánál automatikus akciókhoz. ### **Összefoglaló** Az Element-Path az alapvető nyelv a Mergado Editorban való adatkezeléshez. Segítségével pontosan meghatározhatod, honnan származnak az értékek, hova kell beírni őket, és milyen kontextusban találhatók. Az Element-Path struktúrájának és szintaxisának helyes megértése lehetővé teszi, hogy biztonságos szabályokat, hatékony lekérdezéseket és automatizálásokat hozz létre, amelyek megbízhatóan működnek összetett XML és CSV feedekkel is. ## **8\. Feltételek az elem útvonalában** ### **Mik azok a feltételek** Az elem útvonalban a feltételek **szűrőként** működnek, amelyek lehetővé teszik, hogy **csak a kiválasztott értékeket célozd**, és ezáltal pontosítsd az adatokkal való munkát. Az **Element-Path** nyelv szerves részei, és elsősorban többszörös és beágyazott elemeknél használatosak. A feltételek **mindig a tőlük balra álló elemhez** kötődnek, és csak annak **beágyazott gyerekeit** szűrhetik. ### **Feltételek szintaxisa** A feltételeket **kapcsos zárójelekbe `{ }`** írjuk, amelyek a megfelelő elemhez kötődnek. **Alap írásmód sablon:** Elem { Gyerek Operátor Érték } | Következő\_gyerek **Példa:** * PARAM { PARAM\_NAME \= "Szín" } | VAL Ez az útvonal azt jelenti: „Keresd meg a `PARAM` elemet, amelynek `PARAM_NAME` gyerekének értéke *Szín*, és benne célozd a beágyazott `VAL` elemet." #### **Írási szabályok** * **A szóközök fontosak** – nem hagyhatók el. Ez érvényes a feltételen belül és a feltétel előtt és után is. * A feltételek tartalmazhatnak **tetszőlegesen összetett kifejezéseket**, beleértve az `AND`, `OR`, `NOT` operátorokat vagy több beágyazási szintet. ### **MQL használata feltételekben** Az Element-Path feltételei támogatják a **Mergado Query Language (MQL) teljes szintaxisát**. Ez azt jelenti, hogy ugyanazokat a kifejezéseket írhatod beléjük, mint az egyéni lekérdezések űrlapjába. ### **Mire szolgálnak a feltételek** A feltételek pontosítják az elem útvonalát, és lehetővé teszik az **értékek konkrét alcsoportjainak** célzását. Elsősorban a következőkre használjuk: 1. **Többszörös elemek konkrét értékeinek célzása.** Például paramétereknél, szállítási opcióknál vagy képeknél, ahol a feltétel nélküli útvonal több értékhez vezetne. 2. **Strukturális értékek hozzáadása** – írásnál érvényes, hogy minden, ami a feltételben `=` operátorral vagy `AND` kötőszóval szerepel, **a Mergado automatikusan létrehozza, ha még nem létezik**. 3. **Speciális attribútumok használata** – a feltételek a `@@POSITION` és `@@VALUE` speciális attribútumokkal való munkára is szolgálnak. ### **Összefoglaló** Az Element-Path nyelv feltételei kulcsfontosságú eszközök a konkrét értékek pontos és biztonságos célzásához. Lehetővé teszik az adatok szűrését, új struktúrák létrehozását és a többszörös és beágyazott elemekkel való munkát a hibás átírás kockázata nélkül. A feltételek helyes használata segít megelőzni a hibákat, rendet tartani a szabályokban, és biztosítani, hogy a Mergado mindig csak azokat az adatokat módosítsa, amelyeket valóban módosítani akarsz. --- ## [Fordított lekérdezések a Mergadóban](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/forditott-lekerdezesek-a-mergadoban/) # **Fordított lekérdezések a Mergadóban** Ez a cikk bemutatja, mik azok a fordított lekérdezések, és hogyan dolgozz velük hatékonyan a Mergadóban. Megtudod a különbséget az egyszerű fordított lekérdezés (ahol elég megváltoztatni az operátort, pl. `=`-ről `!=`-ra) és az összetettebb, MQL-t és `NOT` operátort igénylő megoldás között. A cikk végén tudni fogod: * mikor érdemes fordított lekérdezést használni, * hogyan hozz létre egyszerű fordított lekérdezést MQL ismeret nélkül, * hogyan írj összetett lekérdezést MQL-be, és érd el a fordított eredményt `NOT(...)` negációval. ## **Kontextus** Általában a lekérdezésekkel azokat a termékeket határozod meg, amelyeket módosítani szeretnél – pl. árat emelni, nevet módosítani vagy elrejteni. Néha azonban egyszerűbb fordított lekérdezést készíteni: olyat, amely mindent kiválaszt egy bizonyos csoporton kívül. Ahelyett, hogy meghatározod, „mit akarsz módosítani", azt definiálod, „mit nem akarsz módosítani". Ez a megközelítés főleg akkor hasznos, ha: * pontosan tudod, mely termékeknek kell változatlanul maradniuk, vagy * van egy kis termékcsoportod, amelyet meg kell tartani a kimenetben, és az összes többit el kell rejteni. ## **Gyakorlati példák** **Tipikus példa** 65 000 termékes feedet kezelsz. A kimenetben csak 5 000 konkrét terméket szeretnél megtartani, és az összes többit elrejteni. Kétféleképpen oldhatod meg: * lekérdezést készítesz mind a 60 000 nem kívánt termékre (nagyon nem praktikus), vagy * fordított lekérdezést készítesz: „Minden, kivéve ezeket a termékeket." Pontosan erre valók a fordított lekérdezések. **Mikor hasznos a fordított lekérdezés?** * Nem akarsz egy bizonyos termékcsoportot szabállyal érinteni (pl. nem akarod megváltoztatni a nevüket vagy az árukat). * Mindent el akarsz rejteni egy bizonyos termékcsoporton kívül. * Áttekinthetően akarod kezelni a kivételeket hosszú feltétellisták helyett. ## **Egyszerű fordított lekérdezések (MQL nélkül)** Ha egyszerű fordított lekérdezést kell létrehoznod, nem kell rögtön MQL-t használnod. Elég az ellentétes operátorokkal dolgoznod közvetlenül a lekérdezések alapfelületén. Az elv egyszerű: a „tartalmazza / listában van / =" típusú feltétel helyett annak negációját használod. | Szokásos operátor | Ellentétes operátor | Mit csinál | | -------------- | ----------------- | ------------------------------------------------ | | `=` (egyenlő) | `!=` (nem egyenlő) | Más értékkel rendelkező termékeket választ ki | | tartalmazza | nem tartalmazza | Azokat a termékeket választja ki, amelyek nem tartalmazzák a szöveget | | listában van | nincs a listában | Azokat a termékeket választja ki, amelyek nincsenek a megadott listában | **1. példa – a „tartalmazza" megfordítása** Eredeti lekérdezés: ``` CATEGORY ~OBSAHUJE "Zahrada" ``` Megtalálja az összes terméket, amelynek a `` elemében a „Zahrada" érték szerepel. Fordított lekérdezés (csak azokat tartja meg, amelyek **nem** tartalmazzák ezt az értéket): ``` CATEGORY !~ NEOBSAHUJE "Zahrada" ``` **2. példa – „listában van" vs. „nincs a listában"** Eredeti lekérdezés (termékek, amelyeket meg akarsz tartani a kimenetben): ``` ITEM_ID Je ve výčtu (101, 102, 103) ``` Fordított lekérdezés (termékek, amelyeket el akarsz rejteni – tehát minden a felsoroltak kivételével): ``` ITEM_ID Není ve výčtu (101, 102, 103) ``` Ez a lekérdezés kiválaszt minden terméket e három kivételével. ## **Haladó fordított lekérdezések MQL-lel (NOT)** Ha a lekérdezés összetettebb (több feltétel, `AND/OR` logika), érdemes az MQL-t és a `NOT` operátort használni. Ez a megközelítés teljes kontrollt ad a lekérdezés megfordítása felett. ### **A NOT operátor működése** Az MQL-ben a `NOT`-ot egy feltétel vagy egy teljes lekérdezés negálására használhatod. Ekvivalencia példák: ``` ITEM_ID != 43 ``` ugyanaz, mint ``` NOT(ITEM_ID = 43) ``` * `ITEM_ID = 43` → kiválasztja a 43-as ID-jű terméket * `NOT(ITEM_ID = 43)` → kiválaszt mindent **kivéve** a 43-as ID-jű terméket **A negáció lényege:** A `NOT` megfordítja a halmazt – mindent kiválaszt, ami **nem felel meg** az eredeti lekérdezésnek. ## **Megoldás lépései** ### **1) Navigálás a lekérdezések kezeléséhez** * Jelentkezz be a Mergado fiókodba. * Navigálj a **Termékek** menüpontra a főmenüben. ### **2) Lekérdezés létrehozása** * A `NOT` operátort mindig az **Egyéni MQL lekérdezés** szekcióban kell hozzáadni. * Először összeállíthatod a lekérdezést az egyszerű felületen, majd átválthatsz az MQL szekcióra, vagy közvetlenül MQL-ben is írhatsz. * Hozd létre azoknak a termékeknek a lekérdezését, amelyeket **meg akarsz tartani**. * Az egész létrehozott lekérdezést zárd kerek zárójelekbe `()`, és eléje írd a `NOT` negációt. ### **3) Elnevezés és mentés** * Adj a lekérdezésnek megfelelő nevet és mentsd el. * Ezután felhasználhatod szabályokban (pl. elrejtő szabályban). ## **Gyakorlati példa** A kimenetben csak azokat a termékeket akarod megtartani, amelyek: * a nevükben tartalmazzák a „kalhoty" szót, * a **barva = fialová** paraméterrel rendelkeznek, * és **1100 CZK-nál drágábbak ÁFÁ-val**. Minden mást el akarsz rejteni. Az összes termék száma kb. 65 000, ez a lekérdezés mindössze 2-t talál. Lépések: * A lekérdezés felületén válts az **Egyéni MQL lekérdezés** módra. * Az eredeti lekérdezést (ami meghatározza, *mit kell megtartani*) zárd `()`-be és írd elé a `NOT`-ot. Ezzel fordított lekérdezést hozol létre: kiválaszt minden terméket **kivéve** azokat, amelyek megfelelnek az eredeti feltételeknek. Felhasználhatod elrejtő szabályban – így a kimeneti feedben csak az eredeti lekérdezésnek megfelelő termékek maradnak. ## **Tippek és gyakori hibák** * **Ne feledkezz meg a zárójelekről.** Ha több feltételt kombinálsz, mindig zárd az egész eredeti lekérdezést zárójelekbe: ``` NOT(PRODUCTNAME CONTAINS "boty" OR CATEGORY = "Doplňky") ``` * **A `NOT` az egész logikát megfordítja, nem csak az egyes részeket.** Ha több kifejezést kombinálsz `AND`-dal és `OR`-ral, az eredmény más lehet, mint amire számítasz. Mindig teszteld a lekérdezést. ### **Gyors összefoglaló** | Lekérdezés típusa | Hogyan hozd létre | Példa | | ------------------------------- | ----------------------- | ---------------------------------------------------------- | | Egyszerű fordított lekérdezés | Ellentétes operátor használata | `CATEGORY != "Zahrada"` | | Fordított lekérdezés értéklistával | „nincs a listában" használata | `ITEM_ID NOT IN (101,102,103)` | | Összetett fordított lekérdezés | MQL és `NOT(...)` használata | `NOT(PRODUCTNAME CONTAINS "kalhoty" AND PRICE_VAT > 1100)` | --- ## **GYIK** ### **Mikor érdemes fordított lekérdezést használni?** Ha nem akarsz egy bizonyos termékcsoportot szabállyal érinteni, mindent el akarsz rejteni egy bizonyos csoporton kívül, vagy áttekinthetően akarod kezelni a kivételeket hosszú feltétellisták nélkül. ### **Hogyan hozok létre egyszerű fordított lekérdezést MQL nélkül?** A lekérdezések alapfelületén az ellentétes operátort használod (pl. `!=` az `=` helyett; „nem tartalmazza" a „tartalmazza" helyett; „nincs a listában" a „listában van" helyett). ### **Hogyan néz ki a „tartalmazza" vs. „nem tartalmazza" példa?** Eredeti: `CATEGORY ~OBSAHUJE "Zahrada"` Fordított: `CATEGORY !~ NEOBSAHUJE "Zahrada"` ### **Hogyan hozok létre fordított lekérdezést ID-listához?** Eredeti: `ITEM_ID Je ve výčtu (101, 102, 103)` Fordított: `ITEM_ID Není ve výčtu (101, 102, 103)` – mindent kiválaszt e három kivételével. ### **Mikor érdemes MQL-t és `NOT`-ot használni?** Ha a lekérdezés összetettebb (több feltétel, `AND/OR` kombináció), és pontosan kell irányítanod az egész lekérdezés negálását. ### **Hogyan működik a `NOT` az MQL-ben egy egyszerű példán?** `ITEM_ID != 43` ugyanaz, mint `NOT(ITEM_ID = 43)`. A `NOT` kiválaszt minden elemet, amely **nem** felel meg a feltételnek. ### **Hova írd a `NOT`-ot?** Az **Egyéni MQL lekérdezés** szekcióba. Az eredeti lekérdezést tedd zárójelekbe `()`, és eléje írd a `NOT`-ot. ### **Miért fontosak a zárójelek?** Biztosítják, hogy a `NOT` pontosan azt a részt negálja, amelyiket szeretnéd. `AND/OR` kombinációknál zárójelek nélkül más eredményt kaphatsz, mint amire számítasz. ### **Használhatom a fordított lekérdezést mindennek az elrejtésére a kivételeken kívül?** Igen. A fordított lekérdezést felhasználhatod elrejtő szabályban, így a kimeneti feedben csak az eredeti (nem negált) lekérdezésnek megfelelő elemek maradnak. ### **Megy MQL tudás nélkül is?** Igen – egyszerű esetekben elég a lekérdezések felületén az ellentétes operátorokat használni. MQL-t `NOT`-tal akkor használj, ha összetettebb feltételkombinációkat kell negálnod. --- ## [Operátorok a Mergado Query Language-hez](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/mql-operatorok/) # **Operátorok a Mergado Query Language-hez** ## **MQL operátorok listája** Ez az áttekintés bemutatja az összes operátort, amelyet a **Mergado Query Language (MQL)** nyelvben használhatsz – a terméklekérdezések feltételeinek létrehozásához. Az operátorok helyes használatával pontos, hatékony és áttekinthető lekérdezéseket tudsz írni. --- ## **Operátorok áttekintése** | **Operátor** | **Jelentés** | | -------------- | -------------------------- | | `CONTAINS` | tartalmazza a szöveget | | `NOT CONTAINS` | nem tartalmazza a szöveget | | `=` | egyenlő | | `!=` | nem egyenlő | | `~` | tartalmazza a reguláris kifejezést | | `!~` | nem tartalmazza a reguláris kifejezést | | `<=` | kisebb vagy egyenlő* | | `>=` | nagyobb vagy egyenlő* | | `<` | kisebb mint* | | `>` | nagyobb mint* | | `IN` | benne van a listában | | `NOT IN` | nincs benne a listában | | `OR` | logikai „vagy" | | `AND` | logikai „és" | | `SORT BY` | rendezés elem neve szerint | *Csak numerikus értékeknél használható. --- ## **Módosítók a `SORT BY`-hoz** | **Módosító** | **Jelentés** | | --------------- | ----------------------------- | | `DESC` | csökkenő sorrendbe rendez | | `ASC` | növekvő sorrendbe rendez | | `AS NATURAL` | természetes sorrend szerint rendez | > Ezek a módosítók a `SORT BY` operátorral együtt használhatók, és meghatározzák az eredmények rendezési módját. --- ## **A feltételek helyes írása** Az MQL feltételek formája mindig: ``` [] <érték> ``` **Példa:** ``` [PRICE] >= 100 ``` ### **Írási szabályok** * Az **értéket** nem kell idézőjelbe tenni, ha csak egy alfanumerikus szót vagy számot tartalmaz. Pl. `[CATEGORY] = Electronics` * Az **elem nevét** szögletes zárójelbe kell tenni, ha nem alfanumerikus karaktereket tartalmaz: `[PARAM | color] = "blue"` * **Szöveges értékeket és reguláris kifejezéseket** egyenes idézőjelbe `" "` írj, ne tipográfiai „ "-be. * **Javaslat:** mindig használj szögletes zárójeleket. Ennek köszönhetően a Mergado felajánlja az elérhető elemek listáját a lekérdezés írásakor. --- ## **Tippek a hatékony munkához** * Kombinálj `AND` és `OR` operátorokat összetett lekérdezések létrehozásához. * Használd a `SORT BY`-t az eredmények áttekinthető rendezéséhez – például ár vagy név szerint. * Ha nem tudod, melyik operátort válaszd, kezdd a `CONTAINS`-szel – egyszerűen ellenőrizheted, hogy az elem tartalmazza-e a keresett szöveget. * Pontos mintakereséshez használj reguláris kifejezéseket (`~` és `!~`). --- ## **GYIK** ### **Mi az MQL feltétel alapformátuma?** A feltétel formája: `[] <érték>`. ### **Mikor kell idézőjel az érték köré?** Akkor használd, ha az érték szóközöket vagy speciális karaktereket tartalmaz. Egyszavas alfanumerikus értékeknél és számoknál nem szükséges. ### **Mi a különbség a `CONTAINS` és a `~` között?** A `CONTAINS` pontos szöveget keres, míg a `~` reguláris kifejezés (minta) alapján keres. ### **Kombinálható több feltétel?** Igen, az `AND` és `OR` segítségével több kifejezést is összekapcsolhatsz egyetlen lekérdezéssé. ### **Mire való a `SORT BY` és a módosítói?** A `SORT BY` meghatározza, melyik elem szerint legyenek rendezve az eredmények. Az `ASC`, `DESC` és `AS NATURAL` módosítók határozzák meg a rendezési irányt. --- Ez az áttekintés segít abban, hogy MQL lekérdezéseidet helyesen és hatékonyan írd meg. --- ## [Termékek és terméklekérdezések a Mergadóban](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/termekek-lekerdezesek/) # **Termékek és terméklekérdezések a Mergadóban** ## **1. Termékek a Mergadóban** ### **Mi az a termék a Mergadóban** A Mergadóban a termék az **alapvető adategység**, amely egy webáruházbeli árucikket jelöl. Minden termék különböző **elemeket** tartalmaz, amelyek leírják a tulajdonságait – például nevet, árat vagy EAN-t. A Mergado ezekkel a termékekkel dolgozik, módosítja és optimalizálja őket a hirdetési csatornákra való exportálás előtt. * A termékek **elemekből** állnak, amelyek meghatározzák a tulajdonságaikat (pl. `PRODUCTNAME`, `PRICE`, `EAN`). * A **feed** az a fájl, amely tartalmazza az összes terméket és azok elemeit. ### **Bemeneti és kimeneti adatok** A termékekkel való munka teljes folyamata a Mergadóban két alapvető adatkészlet – a **bemeneti** és a **kimeneti feed** – közötti átalakításra épül. * **Bemeneti feed (bemeneti adatok)** – az eredeti adatokat tartalmazza, amelyeket a Mergado letölt a webáruházból és tovább dolgoz fel. Termékkereséskor érdemes a bemeneti adatokban keresni, mert a bemeneti feed értékeit a szabályok alkalmazása nem módosítja (hacsak a feed szolgáltatója nem módosítja). * **Kimeneti feed (módosított adatok)** – a Mergado Editorban elvégzett módosítások utáni adatokat tartalmazza. Ezek az adatok exportálódnak a cél marketingcsatornákra (pl. Heureka, Google Ads). A Mergado az adatok ellenőrzésekor lehetővé teszi, hogy csak a **bemeneti feed**, csak a **kimeneti feed**, vagy **mindkettő egyidejű** értékeit jelenítsd meg. ### **Termékadatok betöltése és feldolgozása** A Mergado a **ciklikus adatfeldolgozás** elvén működik, amely négy lépésben zajlik: 1. **Adatimport** – a Mergadóba letöltődnek a bemeneti feed adatai. 2. **Szabályok alkalmazása** – a legtöbb változtatás és módosítás szabályokon keresztül, tömegesen történik. 3. **Export** – az adatfeldolgozás után létrejön az aktuális kimeneti feed. 4. **Kimeneti feed letöltése** – a Mergado rögzíti, mikor töltötte le a hirdetési csatorna (pl. Heureka) a módosított feedet. Ha egy adott terméknél hiba jelentkezik (pl. az elem az elvárt értéktől eltérőt tartalmaz), használható a **„Termék követése a szabályok áthaladásánál"** funkció. Ez megmutatja, melyik szabály módosította a terméket és milyen változásokat hajtott végre. ### **Különbség a webáruházbeli és a Mergadóbeli termék között** A webáruház kezeli az **elsődleges termékadatokat**, míg a Mergado ezek **módosítására és optimalizálására** szolgáló eszköz a marketingcsatornák számára. A webáruház eredeti adatai változatlanok maradnak – a Mergado egy **módosított verziót** hoz létre, amely megfelel az egyes platformok követelményeinek. ### **Gyakorlati funkciók a termékek kezeléséhez** A *Termékek* oldalon a Mergado többféle módot kínál az adatokkal való munkához – a **manuális módosításoktól** a **szabályokon alapuló tömeges feldolgozásig**. ### **Egyszeri módosítások** **Manuális módosítások** * Lehetővé teszik az egyes elemek értékeinek módosítását közvetlenül a Mergado felületén. Elsősorban **kisebb vagy egyszeri változtatásokra** alkalmasak. **WYSIWYG szerkesztő** * Szöveges elemekhez (pl. `DESCRIPTION`) elérhető a **„What You See Is What You Get"** típusú szerkesztő, amely lehetővé teszi a leírások formázását **HTML elemekkel**. Így áttekinthetően szerkesztheted a termékleírásokat anélkül, hogy HTML-t kellene kézzel írnod. **Termékek manuális elrejtése** * Hasznos kisebb számú, **hirdetésre nem alkalmas** termék esetén (pl. EAN nélküli vagy hosszú szállítási idejű termékek). ### **Tömeges módosítások** * Nagyobb változtatásokhoz (értékmódosítások, adatátírás vagy nagyobb mennyiségű termék elrejtése) **szabályok** szolgálnak, amelyeket kiválasztott termékcsoportokra alkalmazol. * A szabályokon alapuló tömeges módosítások sokkal hatékonyabbak, mint az egyes termékek kézi szerkesztése, ezért a legtöbb esetben **ez az ajánlott munkamódszer**. ## **GYIK** ### **Mi az a termék a Mergadóban?** A Mergadóban a termék az alapvető adategység, amely egy webáruházbeli árucikket jelöl. Minden termék elemekből áll (pl. `PRODUCTNAME`, `PRICE`, `EAN`), amelyek leírják a tulajdonságait. A Mergado ezekkel a termékekkel dolgozik, módosítja és előkészíti őket a hirdetési csatornákra való exportáláshoz. ### **Mi az a feed?** A feed az a fájl, amely tartalmazza az összes terméket és azok elemeit. A Mergadóban megkülönböztetjük a bemeneti feedet (a webáruház adatai) és a kimeneti feedet (a módosított, exportra kész adatok). ### **Mi a különbség a bemeneti és a kimeneti feed között?** A bemeneti feed a webáruházból letöltött eredeti adatokat tartalmazza. A kimeneti feed a Mergadóban elvégzett módosítások utáni adatokat tartalmazza. A kimeneti feed exportálódik a marketingcsatornákra, mint a Heureka vagy a Google Ads. ### **Megjeleníthetem egyszerre a bemeneti és kimeneti feed értékeit?** Igen. A Mergado lehetővé teszi, hogy csak a bemeneti értékeket, csak a kimeneti értékeket, vagy mindkettőt egyszerre jelenítsd meg. Ez segít könnyen összehasonlítani, milyen adatok változtak a feldolgozás során. ### **Hogyan dolgozza fel a Mergado a termékadatokat?** A Mergado ciklikusan négy lépésben dolgozik: 1. Importálja a bemeneti feed adatait. 2. Alkalmazza a szabályokat és módosításokat. 3. Létrehozza a kimeneti feedet. 4. Rögzíti, mikor töltötte le a hirdetési csatorna (pl. Heureka) a módosított feedet. ### **Mit tegyek, ha a termék másképp viselkedik, mint vártam?** Ha a terméknél váratlan elemérték jelenik meg, vagy például a kimenetben látható, pedig rejtettnek kellene lennie, használd a **„Termék követése a szabályok áthaladásánál"** funkciót. Ez megmutatja, mely szabályok módosították a terméket és milyen változásokat hajtottak végre. ### **Mi a különbség a webáruházbeli és a Mergadóbeli termék között?** A webáruház az eredeti termékadatokat kezeli, míg a Mergado ezeket az adatokat módosítja és optimalizálja a marketingcsatornák számára. Az eredeti adatok változatlanok maradnak, a Mergado csak a módosított verzióját hozza létre. ### **Milyen lehetőségek vannak a termékadatok módosítására?** A Mergado két alapvető módot kínál: * **Manuális módosítások** – az egyes termékek értékeinek közvetlen szerkesztése (kisebb változtatásokra alkalmas). * **Tömeges módosítások** – szabályokkal, teljes terméklekérdezésekre alkalmazva (ajánlott módszer). ### **Mikor érdemes kézi szerkesztést és mikor szabályokat használni?** A kézi szerkesztés kisebb számú termékhez vagy egyszeri változtatásokhoz alkalmas. A szabályok hatékonyabbak nagyobb adatmennyiségnél vagy ismétlődő módosításoknál, mert lehetővé teszik az automatizálást. ### **Mire szolgál a WYSIWYG szerkesztő?** A WYSIWYG szerkesztő (What You See Is What You Get) szöveges elemek, például termékleírások szerkesztésére szolgál. Lehetővé teszi a szöveg áttekinthető formázását (pl. félkövér, dőlt) HTML jelölésekkel, kézi kódolás nélkül. ### **Hogyan rejthetek el terméket a kimeneti feedből?** Kisebb számú termékhez használhatod a **manuális elrejtést** közvetlenül a *Termékek* oldalon. Nagyobb mennyiséghez a **„Termék elrejtése"** szabályt, amely egy mentett lekérdezésre alkalmazódik (pl. EAN nélküli, alacsony árrésű termékek stb.). ### **Megtudhatom, mikor töltötte le a csatorna (pl. Heureka) a kimeneti feedet?** Igen. A Mergado rögzíti, mikor történt a kimeneti feed letöltése. Az **utolsó letöltés** információját az **Áttekintés** oldalon találod. Részletesebb letöltési előzményeket az **Előzmények** oldalon látsz a Letöltés eseménytípus kiválasztásával. --- ## **2. A Termékek oldal** A **Termékek** oldal az a központi hely, ahol **ellenőrizheted, megjelenítheted és szerkesztheted a termékadatokat**. Itt megtalálod a feed összes tételét, dolgozhatsz velük egyenként vagy csoportosan, és ellenőrizheted a szabályok működését. ### **Az oldal célja és funkciói** A *Termékek* oldal fő célja az **adatok és változások ellenőrzése** a projektben. Itt találod a feedtételek legfontosabb információit, közvetlenül szerkesztheted az értékeiket, vagy lekérdezéseket hozhatsz létre a további munkához. **Fő funkciók:** * **Adatok megjelenítése** – a termékek és értékeik vizuális ellenőrzése. * **Szerkesztés** – egy adott elem kézi módosítása. * **Lekérdezések létrehozása** – termékcsoportok alkotása, amelyekre aztán szabályok alkalmazódnak. * **Hibakeresés** – annak ellenőrzése, miért viselkedik egy termék másképp, mint vártad. ### **A felület áttekintése és elérhető nézetek** A *Termékek* oldal több nézetet kínál, amelyek segítik az adatokban való tájékozódást. #### **Nézettípusok** | Nézet | Leírás | | ----- | ----- | | **Előnézetek** | A termékeket a hirdetési csatornákhoz hasonlóan jeleníti meg (pl. Heureka, Zboží.cz). Csak a kulcsfontosságú adatokat mutatja, gyors áttekintésre alkalmas. | | **Elemek** | Az egyes elemekre és értékeikre lebontva jeleníti meg a terméket. Könnyű összehasonlítani az eredeti és módosított értékeket. A legrészletesebb nézet – ideális az adatokkal való munkához. | | **Képek** | A termékek fő- és kiegészítő képeit jeleníti meg. Lehetővé teszi a bemeneti és kimeneti feed képeinek összehasonlítását. | | **Táblázat** | Hatékony adatkezelő eszköz áttekinthető táblázatban, az Excelhez vagy Google Sheetshez hasonlóan. Lehetővé teszi a megjelenített oszlopok, sorrendjük és a termékek szűrésének beállítását. | #### **A táblázatos nézet funkciói** * Az **eszköztár** speciális oszlopok ikonjait tartalmazza (pl. kép, ID, terméknév, rögzítés). * Elérhetők **előre beállított fülek** (pl. párosítás, bidding) és egy fül az egyedi elemlistához. * Minden oszlop fejlécében elérhető az **X ikon az ideiglenes elrejtéshez** vagy az **értékek rendezése** (a speciális oszlopoknál nem érvényes). * Az oszlopok sorrendjét **drag & drop módszerrel** változtathatod. * A táblázat **teljes képernyőre** bővíthető, ami megkönnyíti a nagyobb adatmennyiséggel való munkát. * A megjelenített adatok **az aktuálisan beállított termékszűrőt követik**. * A létrehozott táblázat **CSV-be exportálható**, pontosan úgy, ahogyan látod. Ez a fájl tovább elemezhető táblázatkezelőben, vagy visszaimportálható egy másik projektbe az *Adatfájl importálása* szabállyal. ### **Adatellenőrzés és bemenet-kimenet összehasonlítás** A *Termékek* oldalon nem csak az aktuális adatokat látod, hanem a különbségeket is aközött, amit a Mergado betöltött (**bemeneti feed**) és amit tovább küld (**kimeneti feed**). Így könnyen ellenőrizheted, hogy a szabályok módosításai helyesen alkalmazódtak-e. #### **Értékmegjelenítés beállítása** Ikonokkal váltogathatsz, mely értékek jelenjenek meg: * csak **bemeneti értékek**, * csak **kimeneti értékek**, * vagy **bemenet és kimenet egyszerre**. Ha mindkét értéket egyszerre jeleníted meg, a Mergado kiemeli a különbségeket: * **pirossal** – eltávolított értékek, * **zölddel** – újonnan hozzáadott értékek. #### **Rejtett elemek** Az oldal a **rejtett elemeket** is megjeleníti – ezek nem részei a kimeneti feednek, de léteznek a bemeneti adatokban. A felületen **szürke színnel** jelennek meg. Ha nem akarod látni őket, kikapcsolhatod a *„Rejtett megjelenítése"* opciót. #### **Termékkeresés – bemenet vs. kimenet** Termékek szűrésekor és lekérdezések létrehozásakor választhatsz, hogy a **bemeneti** vagy a **kimeneti** feed értékei alapján keress. * Általában a **bemeneti adatokban** érdemes keresni, mert ezeket a szabályok nem módosítják. * Ha azonban olyan elemmel dolgozol, amely csak a módosítás után keletkezik (pl. `g:id`), a keresést **kimenetre** kell átkapcsolnod. ### **Kézi és tömeges szerkesztés** A változtatások többsége a Mergadóban szabályokkal tömegesen történik, de bizonyos esetekben érdemes néhány terméket kézzel szerkeszteni. A *Termékek* oldalon **gyors manuális változtatásokat** végezhetsz az egyes termékeknél és elemeknél. #### **Manuális szerkesztés** * Az elemek értékei közvetlenül a *Termékek* oldal felületén módosíthatók. * A Mergado mindig megjeleníti az **eredeti** és az **új értéket**, ami megkönnyíti a változtatások ellenőrzését. #### **Leírások szerkesztése (WYSIWYG szerkesztő)** Szöveges elemekhez, mint a `DESCRIPTION` vagy `SHORT_DESCRIPTION`, elérhető a **WYSIWYG szerkesztő**. Írhatsz egyszerű szövegben vagy formázott módban (félkövér, dőlt stb.). Mentés után a szöveg HTML-lé alakul, amelyet a hirdetési rendszerek támogatnak. ### **Kapcsolat a Szabályok és Elemek oldalakkal** A *Termékek* oldal szorosan együttműködik a Mergado más részeivel – elsősorban a **Szabályok** és **Elemek** oldalakkal. #### **Kapcsolat a Szabályokkal** * A *Termékek* oldalon létrehozott lekérdezésekből könnyen létrehozhatsz szabályokat. * Az egyes szabályok termékekre gyakorolt hatásának ellenőrzéséhez használhatod a **„Termék követése a szabályok áthaladásánál"** funkciót. #### **Kapcsolat az Elemekkel** * Az *Elemek* oldalon **hozzáadhatsz, elrejthetsz vagy módosíthatsz** (kézzel létrehozott) elemeket, amelyek aztán a *Termékek* oldalon is megjelennek. * Az *Elemek* oldal segítségével **duplikátumokat is kereshetsz**. ## **GYIK** **1. Mi a Termékek oldal és mire szolgál?** A Termékek oldal a központi hely a termékadatok ellenőrzéséhez, megjelenítéséhez és szerkesztéséhez a Mergadóban. A felső részen található a **keresőmező**, amely a **terméklekérdezések létrehozására** szolgál. **2. Milyen nézettípusokat kínál az oldal?** Négy alapvető nézet érhető el: Előnézetek, Elemek, Képek és Táblázat. **3. Hogyan derítem ki a bemeneti és kimeneti feed közötti különbségeket?** Az oldalon átkapcsolhatsz a bemeneti feed, a kimeneti feed vagy mindkettő egyidejű megjelenítésére. A különbségek színekkel vannak kiemelve. **4. Exportálhatom a táblázatot?** Igen. A táblázat CSV fájlként exportálható, pontosan úgy, ahogyan látod. **5. Szerkeszthetem az adatokat közvetlenül a Termékek oldalon?** Igen. Az elemek értékeit közvetlenül a felületen módosíthatod. A Mergado mindig megjeleníti az eredeti és az új értéket. --- ## **3. Termékek keresése és lekérdezések** A keresés és a lekérdezések létrehozása a Termékek oldal legfontosabb funkciói közé tartozik. Lehetővé teszik a termékek egyszerű szűrését, csoportosítását és kezelését pontosan meghatározott feltételek alapján. A lekérdezések szolgálnak alapul a szabályok alkalmazásához, a termékek elrejtéséhez vagy a kampányok célzásához a hirdetési csatornákban. ### **Terméklekérdezések** Minden létrehozott szűrő elmenthető terméklekérdezésként. A lekérdezések szabályok alkalmazására, adatelemzésre és automatizálásra szolgálnak. **Lekérdezéstípusok:** * **Ideiglenes lekérdezések** – csak az aktuális kontextusban használhatók, pl. gyors ellenőrzésre. * **Mentett lekérdezések** – elérhetők maradnak ismételt használatra, és a Mentett lekérdezések szekcióban jelennek meg. Mindegyiknél látható a termékek és a lekérdezéssel dolgozó szabályok száma. ### **A keresés működése** A *Termékek* oldalon az egyes elemek értékei alapján kereshetsz termékeket (pl. `PRICE`, `PRODUCTNAME`, `EAN`). Két mód áll rendelkezésre: * **Egyszerű felület** – kattintással működő mód, hétköznapi munkához. * **Saját MQL lekérdezés** – szöveges keresés haladó szintaxissal és több feltétel kombinálásának lehetőségével. ### **Keresés bemeneti és kimeneti adatokban** Szűréskor fontos, hogy a **bemeneti** vagy a **kimeneti** feedben keresel-e. * **Keresés a bemeneten** – alapértelmezett mód; a webáruház eredeti adatai alapján keres, amelyeket a szabályok nem módosítanak. * **Keresés a kimeneten** – akkor használd, ha a Mergado által a kimeneti feed átalakítása során létrehozott elemek szerint kell szűrnöd. ### **Feltételek és operátorok** Minden szűrő vagy lekérdezés feltételek kombinációja a következő formában: ` <érték>` #### **Támogatott operátorok** * `CONTAINS` – tartalmazza a szöveget * `NOT CONTAINS` – nem tartalmazza a szöveget * `=` – egyenlő * `!=` – nem egyenlő * `~` – tartalmaz reguláris kifejezést * `!~` – nem tartalmaz reguláris kifejezést * `<, >, <=, >=` – számok összehasonlítása * `IN` – szerepel a listában * `NOT IN` – nem szerepel a listában * `IS EMPTY` – üres * `IS NOT EMPTY` – nem üres * `AND, OR` – feltételek logikai összekapcsolása Ha az elem neve nem alfanumerikus karaktereket tartalmaz, szögletes zárójelbe írd: `[Elem neve] = "kék"` ### **Alap keresés** Az egyszerű felületen elég kiválasztani az elemet, beállítani a feltételt és megadni az értéket. További sorokat a **+** ikonra kattintva adhatsz hozzá. **Példák**: * `PRICE > 1000` → az 1000-nél drágább termékeket jeleníti meg. * `PRODUCTNAME CONTAINS "póló"` → megtalálja az összes terméket, amelynek nevében ez a kifejezés szerepel. ### **Haladó keresés MQL-lel** Összetettebb lekérdezésekhez az MQL (Mergado Query Language) szolgál – szöveges felület, amely teljes kontrollt biztosít a feltételek felett. Az MQL-t az egyszerű keresésből a **„Saját MQL lekérdezés"** lehetőséggel aktiválod. MQL lekérdezés példa: * `PRICE > 1000 AND BRAND = "Nike"` → Nike márkájú, 1000-nél drágább termékek. * `(PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport"` → Nike márkájú, 500-nál drágább termékek, vagy olyan termékek, amelyek kategóriájában a „Sport" kifejezés szerepel. ### **Reguláris kifejezések (RegEx) használata** A reguláris kifejezéseket pontos szövegszűrésre használhatod, pl. a név mintája vagy az EAN-kódok hossza alapján. Példák: * A „kék" szó variánsait tartalmazó nevű termékek: `PRODUCTNAME ~ "kék."` * EAN hossz ellenőrzése: * pontosan 8 számjegy → `^\d{8}$` * 8 vagy 12–14 számjegy → `^(\d{8}|\d{12,14})$` ### **Lekérdezések ellenőrzése és használata** Lekérdezés létrehozása után: * **azonnal használhatod** szabályokban (pl. Termék elrejtése), * **elmentheted későbbi használatra**, * vagy **újra betöltheted** és módosíthatod a feltételeit. **Ha ellenőrizni akarod, hogy egy termék valóban a lekérdezésbe tartozik-e:** 1. A *Termékek* oldalon töltsd be a lekérdezést. 2. Válts MQL felületre, és add hozzá az `AND ITEM_ID = "123"` feltételt. → Ha a termék megjelenik, a lekérdezés tartalmazza. ### **Lekérdezés létrehozása szabály űrlapjából** A Mergado lehetővé teszi lekérdezés létrehozását vagy szerkesztését közvetlenül az új szabály űrlapjából vagy egy meglévő szabály szerkesztésekor. **Lépések:** 1. A Szabályok oldalon hozz létre új szabályt vagy szerkessz meglévőt. 2. A szabály űrlapjában a Lekérdezés mezőben válaszd az **„Új lekérdezés létrehozása"** lehetőséget. 3. Jobbról előjön egy oldalsáv, ahol megadhatod a feltételt és a lekérdezés nevét. 4. Mentés után a lekérdezés automatikusan bekerül a szabály űrlapjának Lekérdezés mezőjébe. ### **Összefoglaló** Az operátorok és feltételek lehetővé teszik, hogy nagyon pontosan célozz konkrét termékcsoportokra. A feltételek, reguláris kifejezések és listák helyes kombinálásával olyan lekérdezéseket hozhatsz létre, amelyekre biztonságosan és hatékonyan alkalmazhatsz szabályokat és automatizálásokat. ## **GYIK** **1. Mi a különbség a keresés és a terméklekérdezés között?** A keresés lehetővé teszi a termékek szűrését feltételek alapján. A lekérdezés egy elmentett szűrő, amelyet újra felhasználhatsz vagy szabályokat alkalmazhatsz rá. **2. Mikor keressek bemeneti és mikor kimeneti adatokban?** Az esetek többségében a bemeneti adatokban érdemes keresni, mert azokat a szabályok nem módosítják. A kimeneti adatokat akkor használd, ha a Mergado által a kimeneti feed átalakítása során létrehozott értékekkel dolgozol. **3. Milyen operátorokat használhatok lekérdezések létrehozásakor?** Szöveges, numerikus, reguláris kifejezéses, listaértékes és üresérték-operátorok érhetők el. Ezek közé tartozik például a `CONTAINS`, `=`, `!=`, `<`, `>`, `~`, `IN`, `IS EMPTY` vagy azok negáltja. Az operátorok `AND`, `OR` és zárójelekkel kombinálhatók. **4. Hogyan derítem ki, hogy egy termék valóban egy lekérdezésbe tartozik-e?** A Termékek oldalon töltsd be a lekérdezést, válts MQL módra, és add hozzá az `AND ITEM_ID = "termék ID"` feltételt. Ha a termék megjelenik, a lekérdezésbe tartozik. Alternatívaként keressd meg a terméket, és nyisd meg a Lekérdezések fülét, ahol látod az összes lekérdezést, amelybe jelenleg tartozik. **5. Létrehozható lekérdezés közvetlenül szabály létrehozásakor?** Igen. A szabály űrlapjában választhatod az új lekérdezés létrehozását. Megnyílik egy oldalsáv, ahol megadod a feltételeket és a nevet. Mentés után a lekérdezés automatikusan bekerül a szabály űrlapjába. --- ## **4. Termékadatok módosítása** A Mergadóban a termékadatokat **kézzel** vagy **tömegesen szabályokon keresztül** módosíthatod. A manuális módosítások egyes termékekhez vagy kisebb csoportokhoz alkalmasak, míg a szabályok a feed egészére kiterjedő, nagyobb és ismétlődő változtatásokra szolgálnak. ### **Manuális szerkesztés** A manuális változtatások **kisebb számú termékhez** ideálisak, ahol nem lenne hatékony külön szabályt létrehozni. Az értékeket közvetlenül a *Termékek* oldalon, az **Elemek** nézetben módosíthatod. #### **Értékek gyors módosítása** * Az elem értékét a **ceruza ikonra** kattintva módosíthatod. Módosítsd az értéket, majd kattints a **Mentés** gombra. * A Mergado mindig megjeleníti az **eredeti** és az **új értéket**. * Ha a módosított értékeket a kimeneti feedbe akarod juttatni, újra kell generálnod a feedet. A szabályok alkalmazása ebben az esetben nem szükséges. ### **Leírások szerkesztése WYSIWYG szerkesztővel** Szöveges elemekhez, mint a termékleírások (`DESCRIPTION`, `SHORT_DESCRIPTION`), a Mergado **WYSIWYG** típusú szerkesztőt kínál. Lehetővé teszi a kényelmes szövegszerkesztést HTML-ismeret nélkül. ### **Tömeges módosítások szabályokkal** A változtatások többsége a Mergadóban **tömegesen, szabályokon keresztül** történik. A szabályok lehetővé teszik a módosítások automatizálását több száz vagy több ezer terméken, és a feed optimalizálásának alapvető eszközei. #### **Tipikus szabálypéldák** ##### **1. Termék elrejtése** A **„Termék elrejtése"** szabály teljesen eltávolítja az árut a kimeneti feedből (de a Mergadóban a termékek rejtettként megmaradnak a katalógusban, és bármikor újra megjeleníthetők). Például: * **hosszú szállítási idejű** termékekhez (pl. `DELIVERY_DATE > 10`), * **alacsony árrésű** termékekhez, * vagy **hirdetésre nem alkalmas** termékekhez (pl. fegyverek a Google Adsben). ##### **2. Új értékek kiszámítása** A **„Számítás"** típusú szabály értékek létrehozására vagy átszámítására szolgál, például árrés kiszámítására. ##### **3. Adatfájl importálása** Ha a bemeneti feedből hiányoznak fontos információk (pl. árrés, készletállapot, paraméterek), az **„Adatfájl importálása"** szabállyal pótolhatók. Így a termékekhez külső forrásból – tipikusan CSV vagy XML formátumban – csatolhatsz adatokat. ### **Termék követése a szabályok áthaladásánál** Ha egy termék másképp viselkedik, mint vártad (pl. a kimeneti feedben jelenik meg, pedig rejtettnek kellene lennie), használd a **„Termék követése a szabályok áthaladásánál"** funkciót. * A funkciót egy adott termékre alkalmazod (egyszerre több termékre is kiválaszthatod). * A szabályok alkalmazása után megjelenik egy link az összes terméket érintő szabály áttekintéséhez, beleértve a változások leírását. * Így könnyen kiderítheted, melyik szabály okozta a váratlan változást. ## **GYIK** **1. Mikor használjak manuális módosítást szabályok helyett?** A manuális módosítások kisebb számú termékhez vagy egyszeri változtatásokhoz alkalmasak, ahol nem lenne célszerű külön szabályt létrehozni. Gyors teszteléshez is hasznosak. **2. Hogyan tudhatom meg, melyik szabály módosított egy konkrét terméket?** Erre a **Termék követése a szabályok áthaladásánál** funkció szolgál. Áttekintést ad az összes szabályról, amely módosította a terméket, és a végrehajtott változások pontos leírásáról. **3. Felülírhatják a szabályok a kézzel módosított értékeket?** Igen. Ha egy szabály ugyanarra az elemre céloz, felülírhatja a manuálisan módosított értéket. Ilyen esetben a szabályok helyes struktúrájával vagy a lekérdezések módosításával ajánlott megelőzni a felülírást. --- ## **5. Termékek jóváhagyása** A termékek jóváhagyása olyan funkció, amely pontosabb kontrollt biztosít afelett, mely termékek exportálódnak a kimeneti feedbe. Az elrejtő szabályok alternatívájaként működik. Ha a jóváhagyás be van kapcsolva, az újonnan importált termékek betöltődnek a projektbe, de **nem exportálódnak**, amíg a felhasználó kézzel jóvá nem hagyja őket. A funkció mindig egy adott projektre vonatkozik. ### **A Termékek jóváhagyása funkció bekapcsolása** **A termékek jóváhagyása kétféleképpen kapcsolható be:** * Új projekt létrehozásakor: * A varázsló utolsó lépésében, az Összefoglaló szekcióban megtalálod a *Termékek jóváhagyásának bekapcsolása* opciót. Elég bejelölni a jelölőnégyzetet. * Meglévő projektben: * Menj a bal oldali menüben a *Beállítások → Általános projektbeállítások* részhez. * Az Alapinformációk szekcióban megtalálod a *Termékek jóváhagyásának bekapcsolása* jelölőnégyzetet. * A funkció ugyanígy kikapcsolható is. Kikapcsolás után újra kell generálni a projektet. ### **A projekt viselkedése bekapcsolt jóváhagyás mellett** **Újonnan létrehozott projekt** * A funkció bekapcsolása után az összes termék **Jóváhagyásra vár** állapotot kap. * A kimeneti feed addig üres lesz, amíg egyes termékeket jóvá nem hagysz. **Meglévő projekt** Ha a jóváhagyást utólag kapcsolod be: * az összes meglévő termék **Jóváhagyott** állapotot kap, * az összes újonnan importált termék **Jóváhagyásra vár** állapotban lesz, és nem exportálódik, amíg kézzel jóvá nem hagyod. ### **Termékek jóváhagyása vagy elutasítása** A termékeket kézzel hagyhatod jóvá vagy utasíthatod el: 1. Válassz termékeket jelölőnégyzetekkel (egyet vagy többet). 2. Aktiválódnak a **Jóváhagyás** és **Elutasítás** gombok. 3. Kattints a kívánt műveletre. 4. A változások a projekt újragenerálása után lépnek életbe. #### **Termékek jóváhagyása vs. Elrejtő szabályok** A termékek jóváhagyása és az elrejtő szabályok hasonló problémát oldanak meg – eldöntik, mi exportálódik a kimeneti feedbe. Működésük azonban alapvetően eltér: **Termékek jóváhagyása** * csak az **újonnan importált termékeket** blokkolja, * a jóváhagyást vagy elutasítást **mindig a felhasználó végzi kézzel**, * nem függ a termék elemeitől vagy értékeitől. **Elrejtő szabály** * a termékeket **feltételek alapján** rejti el (pl. ár, árrés, elérhetőség), * a lekérdezés minden újrageneráláskor kiértékelődik, * a termékek automatikusan megjelenhetnek, ha már nem teljesítik a feltételt. A termék **nem exportálódik**, ha: * *Jóváhagyásra vár* vagy *Elutasított* állapotban van, * *Jóváhagyott* állapotban van, de elrejtő szabály rejti el. A termék **exportálódik**, ha: * *Jóváhagyott* állapotban van, és **nem** rejti el semmilyen szabály. ### **Összefoglaló** A termékek jóváhagyása biztosítja, hogy az új termékek csak kézi jóváhagyás után kerüljenek a kimeneti feedbe. Így teljes kontrolod van afelett, mely tételek kezdhetnek hirdetni. A funkció új és meglévő projektben is bekapcsolható, és könnyen kombinálható elrejtő szabályokkal. ## **GYIK** **1. Mi a termékek jóváhagyásának célja?** A jóváhagyás a kimeneti feedbe exportálódó termékek kézi irányítására szolgál. Az új termékek csak a felhasználó jóváhagyása után exportálódnak. **2. Hol kapcsolhatom be a termékek jóváhagyását?** Új projekt létrehozásakor az Összefoglaló lépésnél, vagy meglévő projektben a Beállítások → Általános projektbeállítások részben. **3. Később kikapcsolhatom a termékek jóváhagyását?** Igen. A projekt beállításaiban kikapcsolható. Kikapcsolás után újra kell generálni a projektet, hogy a változás érvényre jusson. --- ## **6. Export és adatok külső feldolgozása** Ez a szekció bemutatja, hogyan **exportálhatsz termékadatokat** a Mergadóból külső fájlokba. Az exportot használhatod **egyszeri** gyors adatellenőrzésre, vagy létrehozhatsz egy **új állandó kimeneti feedet** URL-címen elérhető formában. ### **CSV-be exportálás (egyszeri fájl)** Ha a Mergadón kívül kell ellenőrizned az adatokat, vagy egyszerű riportot kell készítened, a termékeket **CSV fájlként** töltheted le közvetlenül a *Termékek* oldalról. #### **Adatok exportálása a táblázatból** Az egyszeri export a **Táblázat** nézetből történik. 1. A Termékek oldalon szűrővel állítsd be, mely termékeket akarod exportálni. 2. A Táblázat nézetben válaszd ki az exportálandó oszlopokat (elemeket). 3. Kattints a **CSV letöltése** gombra, és válaszd az export típusát: 1. Bemeneti elemek 2. Kimeneti elemek 3. Kimeneti elemek rejtettekkel együtt 4. **Táblázat oszlopai (ajánlott – pontosan azt exportálja, amit látsz)** 4. A CSV fájl letöltődik a számítógépedre, és megnyithatod táblázatkezelőben. ### **Export új projektbe (CSV URL-en)** Ha azt szeretnéd, hogy a CSV **állandóan elérhető legyen URL-címen**, létrehozhatsz egy **új projektet**, amely CSV formátumú kimeneti feedet generál. #### **Kimeneti projekt létrehozása** 1. Hozz létre **új projektet** a Mergadóban. 2. Forrásadatként add meg a termékfeededet, és válaszd ki a helyes bemeneti formátumot. 3. Kimeneti formátumként állítsd be a **Plain CSV**-t. Így létrejön egy projekt, amely rendszeresen generál aktuális CSV feedet URL-en elérhető formában – ideális pl. automatikus adatfeldolgozáshoz vagy partnerekkel való megosztáshoz. --- ## [Változók a Mergadóban](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/valtozok-a-mergadoban/) # **Változók a Mergadóban** ## **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: ``Termékleírás, méretek: 150x50`` 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`. 6. 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%` 4. A szabályt mentsd el, alkalmazd, majd generáld újra a projektet. #### **3\. Eredmény a kimeneti feedben** ``Termékleírás, méretek: 150x50`` `` ``Szélesség`` ``150`` `` `` ``Hosszúság`` ``50`` `` #### **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. --- ## [Termékadatok kezelése Master Feed segítségével](https://help.mergado.com/hu/mergado-editor/munka-az-adatokkal/halado-munkafolyamatok-es-feedkezeles/termekadatok-kezelese-master-feed/) # **Termékadatok kezelése Master Feed segítségével** Ugyanazokat a termékeket hirdeted több hirdetési platformon, és azon gondolkodsz, hogyan kerüld el, hogy minden projektnél újra és újra ugyanazokat a módosításokat végezd és ugyanazokat a szabályokat állítsd be? Hozz létre egy Master Feedet adatforrásként az egyes projektekhez – így az összes projektre vonatkozó közös módosításokat csak egyszer kell elvégezned. Rengeteg időt és energiát takaríthatsz meg, és utána már csak az egyes projekteket kell finomhangolnod az adott hirdetési platformok sajátosságai szerint. A **Master Feed** a termékadataid központi forrása. Ez az a hely, ahol megtisztítod, egységesíted és felkészíted az adatokat, hogy ideális alapot nyújtsanak az összes hirdetési platformhoz, amelyeken hirdetsz. ## **Miért és mikor érdemes Master Feedet használni?** A Master Feed akkor könnyíti meg a munkádat, amikor egy termékfeedet több hirdetési platformra akarsz küldeni. A Mergadóban ez azt jelenti, hogy egy webáruház alatt több projektet hoztál létre az egyes hirdetési platformokhoz (pl. Google, Facebook, Heureka, Zboží, Glami és mások), és mindegyikhez ugyanazt az adatforrást használod. Ez a közös adatforrás lehet maga a Master Feed – egyszer beállítod benne a szabályokat és elvégzed a módosításokat, amelyek az összes hirdetési platformra vonatkoznak, és nem kell minden projektnél ugyanezt ismételni. Hozz létre egy új projektet ugyanazon webáruház alatt, és ez lesz a Master Feed. A bemeneten add meg a termékadataidat (pl. a webáruházad által generált feedet), a kimeneti feedet pedig bemeneti feedként használd az összes többi, hirdetési platformhoz létrehozott projekthez. ## **A Master Feed felhasználási példái** ### **1. Nem egységes vagy hiányos adatok a termékfeedben** Sok hirdetési platform hasonló követelményeket támaszt az elemek tartalmával szemben. Például a Heureka, a Zboží.cz és a Glami is megköveteli, hogy a terméknevek tartalmazzák a gyártó nevét. Ha tehát a termékfeedben a termék nevéből hiányzik ez az információ, elég a Master Feedben egyszer beállítanod egy szabályt, amellyel megoldod ezt a problémát, és nem kell külön szabályt beállítanod a Heurekához, a Zboží-hoz és a Glamihoz tartozó projektekben. Hasonlóképpen, szinte az összes hirdetési platform megköveteli vagy ajánlja a helyes EAN kódok kitöltését. Az EAN-okat tehát csak egyszer egészíted ki vagy javítod a Master Feedben, és a kódok automatikusan átíródnak az összes platformhoz tartozó projektbe. A Master Feedben tömegesen kiegészítheted például a termékek hiányzó paramétereit (méretek, színek stb.) is, amelyeket bizonyos szortiment esetén gyakran megkövetelnek. Tipikusan ilyen a Heureka, a Zboží, a GLAMI, a FAVI, a Biano vagy a Google Shopping. ### **2. A termékfeed olyan termékeket tartalmaz, amelyeket nem akarsz hirdetni** Tartalmaz a termékfeed olyan árut, amelyet a hirdetési platformokon nem akarsz hirdetni (pl. nagyon olcsó termékek, alacsony árrésű áruk, elfogyott termékek, kiegészítők stb.)? Rejtsd el őket egyszer és tömegesen a Master Feedben, és a termékek az összes kapcsolódó projektben is elrejtődnek. ### **3. Szállítási költség beállítása az összes hirdetési platformra egyszerre** Állítsd be a szállítókat és a szállítási árakat csak egyszer a Master Feedben, és a beállítás az összes kapcsolódó projektben érvényesül. A jövőben is, ha például szállítókat akarsz hozzáadni vagy eltávolítani, vagy módosítani az árakat, elég a módosítást a Master Feedben elvégezni. ## **Hogyan hozz létre Master Feedet?** 1. A Master Feedet a Mergadóban ugyanúgy hozod létre, mint bármely más projektet. Az Új projekt létrehozása útmutató alapján haladhatsz. 2. Bemeneti feedként olyan termékfeedet használj, amely a lehető legtöbb információt tartalmazza a termékeidről (név, ár, kép, fontos paraméterek). Ez lehet például a webáruházad által generált termékfeed. 3. Kimeneti formátumként ugyanazt a formátumot válaszd, mint ami a bemeneten van. (Például ha bemeneti feedként a Heureka formátumú feedet választottad, kimeneti formátumként is a Heureka formátumot válaszd.) 4. Adj megfelelő nevet a projektnek, hogy azonnal felismerd, hogy Master Feedről van szó (pl. *webáruház-neve.hu – Master Feed*). 5. A Master Feedben állítsd be a szabályokat és végezd el az általános, alapvető termékadatmódosításokat, amelyeknek az összes hirdetési rendszerre vonatkozniuk kell (pl. gyártók hozzáadása a terméknevekhez vagy szállítás beállítása). 6. Ezután ugyanazon webáruház alatt hozd létre az egyes projekteket a kiválasztott hirdetési platformokhoz – mindegyiknél bemeneti feedként a Master Feed kimeneti feedjét add meg. A kimeneti formátumot az adott platform szerint válaszd ki. Az egyes projektekben már csak a platformspecifikus módosításokat kell elvégezned. ## **Hogyan juttasd el azonnal a Master Feedben végzett változtatásokat a kapcsolódó projektekbe?** A Mergado maga értékeli ki, milyen gyakran szükséges az adatok frissítése, és automatikusan [újragenerálja](/hu/mergado-editor/munka-az-adatokkal/alapveto-elemek/adatujrageneralas-es-frissites-a-mergadoban/) (azaz frissíti) naponta többször (általában egy-három óránként). Ezzel tehát nem kell foglalkoznod. Ha azonban azonnal látni akarod a végrehajtott változtatásokat a feedben, kézzel is újragenerálhatod az adatokat. A Master Feedben végzett módosítások után navigálj a *Szabályok* oldalra, kattints a **Folyamatok kézi indítása** gombra, majd válaszd a **Módosítottak újragenerálása** lehetőséget. Ugyanezt a lépést ismételd meg a kapcsolódó projekteknél is. ## **Hogyan derítsd ki, mely projekteknél használod a Master Feedet?** A Mergadóban egyszerűen ellenőrizheted, mely projekteknél használod bemeneti feedként a Master Feed adatait. 1. A Master Feed projektben navigálj a **Beállítások** oldalra. 2. Az *Általános projektbeállítások – Alapinformációk* szekcióban kattints a **Kimeneti feed** melletti lefelé mutató nyílra. 3. Megjelenik azon projektek listája, amelyeknél a Master Feed van bemeneti feedként beállítva. Innen közvetlenül átkattinthatsz a kiválasztott projektekbe. Hasonlóképpen ellenőrizheted egy kiválasztott projektnél, hogy Master Feed van-e bemeneti feedként használva. 1. A kiválasztott projektnél navigálj a **Beállítások** oldalra. 2. Az *Általános projektbeállítások – Alapinformációk* szekcióban kattints a **Bemeneti feed** melletti lefelé mutató nyílra. 3. Megjelenik az a projekt, amelynek kimeneti feedjét itt a bemeneten használtad. Innen közvetlenül átkattinthatsz ebbe a projektbe (a Master Feedbe). ## **Hogyan befolyásolja a Master Feed a Mergado használatának árát?** A Master Feed egy további projekt, ami azt jelenti, hogy megnöveli az adott webáruház kimeneti termékeinek összesített számát. Így előfordulhat, hogy befolyásolja a Mergado használatának árát. Ha például a termékfeedben több mint 3 000 elem van, és három különböző hirdetési platformon hirdetsz (tehát három különböző projekted van), összesen kb. 9 000 elem van a kimeneten. Így a Basic tarifába tartozol. A Master Feed létrehozásával a kimeneti elemek száma 12 000-re nő, ami a magasabb Standard tarifába való átlépést jelenti. A Master Feed bevezetése előtt tehát gondolj arra, hogy befolyásolhatja a Mergado használatának árát. Bár a Mergado költségei ezzel kissé emelkedhetnek, a hatalmas időmegtakarítás és a hatékonyabb feed-kezelés megéri. A Mergado [áraival](https://www.mergado.hu/cenik) kapcsolatos további információkat az Automatikus tarifaszámítás cikkben találod. ## **Összefoglalás** A Master Feed a termékadataid módosításának központja. Ahelyett, hogy minden hirdetési csatornához külön-külön ugyanazokat a módosításokat végeznéd, egyszer elvégzed őket a Master Feedben, ahonnan automatikusan eljutnak az összes kapcsolódó projektbe. Így az egyes hirdetési platformok finomhangolására koncentrálhatsz, anélkül, hogy az ismétlésre pazarolnád az idődet. Az eredmény: időmegtakarítás, tisztább adatok, kevesebb hiba, gyorsabb munka – és ami a legfontosabb, több idő a stratégiára a rutin helyett. > **Tipp:** A Master Feedet érdemes már a legelején bevezetni, még az egyes kapcsolódó projektek létrehozása előtt. Így biztosítod az adatok zökkenőmentes áramlását, és csökkented a hibák és projektek közötti zavarok kockázatát. ## **GYIK** ### **Mi az a Master Feed és mire való?** A Master Feed egy központi adatforrás, amelyet alapként használsz olyan projektekhez, ahol ugyanazokat a termékadatokat akarod felhasználni. Ez lehetővé teszi, hogy a közös adatokat csak egyszer módosítsd, és a módosított kimenetet aztán bemenetként használd az egyes hirdetési platformokhoz tartozó projektekhez (pl. Heureka, Zboží.cz, GLAMI, Facebook). Ezáltal elkerülheted ugyanazoknak a módosításoknak az ismétlését minden projektben. ### **Mikor érdemes Master Feedet használni?** A Master Feed akkor hasznos, amikor ugyanazokat a termékadatokat küldöd több hirdetési platformra. Például ha egy webáruház alatt több projektet hoztál létre (pl. Heureka, Zboží.cz, GLAMI, FAVI, Google Shopping), és mindegyik ugyanazt a bemeneti feedet használja. A Master Feed alkalmas arra, hogy egyetlen közös alapként szolgáljon, amelyben a közös módosításokat csak egyszer végzed el. ### **Hogyan takarít meg a Master Feed időt és munkát?** Minden általános és alapvető módosítást egyetlen projektben – a Master Feedben – végzel el. Nem kell tehát egyenként módosítanod a neveket, paramétereket, EAN kódokat vagy szállítási beállításokat az egyes platformokhoz tartozó projektekben. A változtatások a Master Feedből automatikusan átíródnak az összes kapcsolódó projektbe, amelyeknél bemeneti feedként a Master Feed kimeneti feedjét használod. ### **Milyen típusú módosításokat érdemes a Master Feedben végezni?** A Master Feedben olyan szabályokat állítasz be és olyan módosításokat végzel, amelyeknek az összes hirdetési platformra vonatkozniuk kell. Ide tartozik például: * gyártók hozzáadása a terméknevekhez, * EAN kódok javítása vagy kiegészítése, * hiányzó paraméterek kiegészítése (méretek, színek stb.), * nem hirdetendő termékek elrejtése, * szállítók és szállítási árak beállítása. ### **Miért előnyös egyes módosítások Master Feedben végzése?** Sok hirdetési platform hasonló követelményeket támaszt a termékfeedekkel szemben. Például a Heureka, a Zboží.cz és a GLAMI megkövetelik a gyártót a termék nevében, és a legtöbb platform ajánlja vagy megköveteli a helyes EAN kódok kitöltését. A Master Feednek köszönhetően ezeket az információkat csak egyszer egészíted ki vagy javítod, és a változtatások automatikusan eljutnak az összes kapcsolódó projektbe. ### **Elrejthetem a Master Feedben a nem hirdetendő termékeket?** Igen. Ha a termékfeeded olyan elemeket tartalmaz, amelyeket nem akarsz hirdetni (pl. túl olcsó termékek, kiegészítők, nagyon alacsony árrésű áruk vagy elfogyott termékek), tömegesen elrejtheted őket a Master Feedben. Az elrejtés az összes kapcsolódó projektben érvényesül. ### **Beállíthatom a Master Feedben a szállítási árakat az összes platformra egyszerre?** Igen. A szállítókat és szállítási árakat csak egyszer állítod be a Master Feedben. A beállítás az összes kapcsolódó projektben érvényesül. Ha a jövőben változnak a szállítási árak, elég a módosítást a Master Feedben elvégezni. ### **Hogyan hozok létre Master Feedet a Mergadóban?** A Master Feedet ugyanúgy hozod létre, mint bármely más projektet: 1. A Mergadóban új projektet hozol létre. 2. Bemeneti feedként a lehető legtöbb termékinformációt tartalmazó feedet használod (pl. közvetlenül a webáruházad által generált termékfeedet). 3. Kimeneti formátumként ugyanazt a formátumot választod, mint ami a bemeneten van. 4. Megfelelően elnevezed a projektet, hogy könnyen megkülönböztesd az egyes hirdetési platformokhoz tartozó projektektől (pl. „webáruház-neve.hu – Master Feed"). 5. Beállítod a szabályokat és elvégzed az általános módosításokat, amelyek az összes hirdetési platformra vonatkoznak. 6. Ezután létrehozod az egyes projekteket a konkrét hirdetési platformokhoz, és bemeneti feedként mindegyiknél a Master Feed kimeneti feedjét használod. ### **Kell még valamit beállítanom az egyes platformokhoz tartozó projektekben?** Igen. Ezekben a projektekben csak az adott platformra specifikus módosításokat végzed, például kategória-leképezést vagy az elemek módosítását a konkrét rendszer követelményei szerint. Az általános módosításokat már a Master Feedben elvégezted. ### **Milyen gyorsan jelennek meg a Master Feedben végzett változtatások a többi projektben?** A Mergado automatikusan, naponta többször újragenerálja (frissíti) az adatokat. Ha azonban azt akarod, hogy a változtatások azonnal megjelenjenek, kézzel is újragenerálhatod az adatokat: 1. A Master Feedben navigálj a *Szabályok* oldalra. 2. Kattints a **Folyamatok kézi indítása** gombra. 3. Válaszd a **Módosítottak újragenerálása** lehetőséget. 4. Ugyanezt a lépést ismételd meg a kapcsolódó projektekben. ### **Hogyan derítsd ki, mely projektek használják a Master Feedet bemeneti feedként?** A Master Feed projektben: 1. Navigálj a **Beállítások** oldalra. 2. Az *Általános projektbeállítások – Alapinformációk* szekcióban kattints a **Kimeneti feed** melletti lefelé mutató nyílra. 3. Megjelenik az összes olyan projekt listája, amelyeknél a Master Feedet állítottad be bemeneti feedként. Ebből a listából közvetlenül átkattinthatsz az egyes projektekbe. ### **Hogyan ellenőrizhetem, hogy egy konkrét projekt a Master Feed adatait használja-e bemenetként?** A konkrét projektben: 1. Navigálj a **Beállítások** oldalra. 2. Az *Általános projektbeállítások – Alapinformációk* szekcióban kattints a **Bemeneti feed** melletti lefelé mutató nyílra. 3. Megjelenik az a projekt, amelynek kimeneti feedje itt bemeneti feedként van használva. ### **Befolyásolja a Master Feed a Mergado használatának árát?** Igen, befolyásolhatja a végső árat. A Master Feed ugyanis egy további projektet jelent, amely megnöveli egy webáruház kimeneti elemeinek összesített számát. A kimeneti elemek számának összege határozza meg a Mergado használatának árát. Példa: * Ha a termékfeedben kb. 3 000 elem van, és a Mergadóban három projekted van (három különböző hirdetési platformra), összesen kb. 9 000 elem van a kimeneten (Basic tarifa). * A Master Feed hozzáadásával a szám további 3 000 elemmel nő, tehát összesen kb. 12 000 elem lesz a kimeneten, ami a magasabb Standard tarifába való átlépést jelenti. A Master Feed bevezetése előtt ezért ellenőrizd a kimeneti elemek összesített számát. ### **Mikor a legjobb létrehozni a Master Feedet?** Ideális esetben már a termékadatok kezelésének legelején – tehát még azelőtt, hogy elkezdenéd létrehozni az egyes hirdetési platformokhoz tartozó projekteket. Ezzel biztosítod az adatok zökkenőmentes áramlását és csökkented a hibák kockázatát. ### **Mi a Master Feed fő előnye?** A Master Feed lehetővé teszi, hogy a rutinszerű adatmódosításokat csak egyszer, központilag végezd el. Rengeteg időt spórolsz, amit egyébként ugyanazok ismételgetésére fordítanál a különböző projektekben. Ezzel csökkented a hibák kockázatát is, amelyek gyakran éppen a kézi és ismétlődő munkából adódnak. A kevesebb hiba hirdetési megtakarítást is jelent – megelőzöd azokat a hibákat, amelyek ronthatják a kampányok teljesítményét. A Master Feednek köszönhetően a stratégiára és az egyes platformok finomhangolására koncentrálhatsz a technikai rutin helyett. --- ## [Szabályok](https://help.mergado.com/hu/mergado-editor/szabalyok/mik-a-szabalyok-a-mergadoban/szabalyok/) # **Szabályok** A szabályok a Mergado Editor legfontosabb eszközei: segítségükkel tömegesen módosíthatod, szűrheted és optimalizálhatod a termékadatokat a különböző hirdetési csatornák számára. Ebben a cikkben megtudod: * Mik azok a szabályok? * Mit látsz a Szabályok oldalon? * Hogyan hozz létre új szabályt * Szabályok listája és leggyakoribb használatuk * Amit érdemes tudni * Összefoglalás ## **Mik azok a szabályok?** A szabályok **a Mergado Editor egyik legfontosabb eszközei**. Konkrét szabályok, lekérdezések és elemek segítségével az igényeid szerint módosíthatod az adatokat – legyen szó árösszehasonlítókról, marketplace-ekről, weboldalakról, bővítményekről vagy más platformokról. A szabályok négy csoportba sorolhatók: * Az Editor által létrehozott szabályok (pl. MERGADO XML [CZ] -> Heureka.cz – termékalapú [CZ] konverzió) * Bővítmények szabályai (pl. Bidding Fox - INPUT) * Felhasználói szabályok (pl. Szín paraméter módosítása) * Manuális módosítások szabálya *A példák az alábbi képről származnak.* A különböző típusú szabályok eltérően módosíthatók. Például a Mergado által létrehozott szabályokat nem másolhatod, csak törölheted. A felhasználói szabályokat viszont kikapcsolhatod, duplikálhatod vagy törölheted. ## **Mit látsz a Szabályok oldalon?** A **Szabályok** oldal több szekcióra tagolódik: 1. **Keresés** Szabályokat kereshetsz név, konkrét típus vagy az elem szerint, amellyel dolgoznak. Esetleg csak az aktív szabályokat szűrheted ki. 2. **Szabályok listája** Azok a szabályok láthatók itt, amelyek folyamatosan alkalmazódnak a projektedben. Egyes szabályokat a Mergado vagy egy bővítmény hoz létre automatikusan. 3. **Szabályok alkalmazása** Ez a gomb csak az Editorban módosítja az adatokat. Nem generálja újra az adatokat a kimeneti feedbe. 4. **Új szabály** Ezen a gombon keresztül hozhatsz létre új szabályt. Ha már van egy másik projektben létrehozott szabályod, importálhatod az **Importálás** opcióval. 5. **Szabályok szerkesztési lehetőségei** **Rendezés** – A szabályok sorrendjét módosíthatod. Figyelem, a sorrend számít! Lásd lentebb. **Kikapcsolás** – Kikapcsolja az adott szabályt. **Szerkesztés** – A szabály szerkesztéséhez jutsz. **Duplikálás** – Lemásolja a szabályt. A másolat az eredeti alatt jelenik meg. **Törlés** – Törli a szabályt. **Ütemezés** – A szabályt adott időpontra ütemezi. ## **Hogyan hozz létre új szabályt?** 1. Add meg a nevet. 2. Válaszd ki a szabály típusát. 3. Válassz lekérdezés(eke)t. 4. Válaszd ki a módosítandó elemet. 5. Add meg az új tartalmat. Megjegyzés: A szabály űrlapja a típustól függően változik. Például a **Felülírás** szabály másként néz ki, mint az **Adatfájl importálása** vagy a **Szállítási díj beállítása** szabály. ## **Szabályok listája** **A Mergado számos szabálytípust kínál.** A nevek arra utalnak, mit kell tenned az adott elemmel vagy lekérdezéssel. Például: el kell rejtened egy terméket, mert a beszállító már nem szállítja – használd a **Termék elrejtése** szabályt. Be kell állítanod a szállítást – használd a **Szállítási díj beállítása** szabályt. TIPP: Folyamatosan bővülnek az elérhető szabálytípusok. Szabályok listája: * Felülírás * Keresés és csere * Termék elrejtése * Tömeges felülírás lekérdezések szerint * Tömeges felülírás értékek szerint * Tömeges értékmásolás * Tömeges kategória-átnevezés * Termékparaméterek beállítása * Szállítási díj beállítása * Érték rövidítése * Betűméret módosítása * Szám kerekítése * Ékezetek eltávolítása * Kattintási árak beállítása * UTM paraméterek beállítása * HTML címkék eltávolítása * Számítás * Adatfájl importálása * Többszörös paraméter értékének hozzáadása TIPP: Az egyes szabályok használatáról külön cikkekben olvashatsz. ## **Amit érdemes tudni** ### **Sorrend** **A szabályok sorrendje számít.** A szabályok fentről lefelé alkalmazódnak. Minden szabálynál egy szám jelzi, hányadik az alkalmazási sorrendben. Így már a módosított adatokkal is dolgozhatsz. ### **Bővítmények** **A Mergado Store bővítményei szabályokat hoznak létre.** Ezeket a szabályokat nem kapcsolhatod ki, nem szerkesztheted és nem duplikálhatod – csak törölheted őket. Ha először a bővítményben kell feldolgoznod az adatokat, és utána az Editorban, módosíthatod a bővítmény szabályának sorrendjét. ### **Új szabályt importálhatsz** Szabályt más projektből is importálhatsz. Az **Importálás** gombbal egy egyszerű űrlapon kiválasztod, melyik webáruházból és projektből szeretnéd az importot végrehajtani. Hasznos, ha egy másik webáruházban már van egy kidolgozott szabályod, és nem akarod újrakezdeni. ### **Szabályok alkalmazása** **A szabályok alkalmazása csak a teljes újragenerálás egy részét jelenti.** Az alkalmazás csak a Mergadóban módosítja az adatokat. A kimeneti feedbe az adatok csak a teljes újragenerálás után kerülnek. A szabályok alkalmazása akkor hasznos, ha ellenőrizni vagy tesztelni szeretnéd a módosításaidat, mielőtt a kimeneti feedbe generálnád őket. ### **Szabályok alkalmazása csak a megfigyelt termékekre** A Mergado lehetővé teszi a szabályok alkalmazását csak a megfigyelt termékekre. A termék megfigyelését a termék részleteiben a *Szabályok áthaladása* fülön állíthatod be. Ha ezt megteszed, az *Alkalmaz* – *Csak a megfigyeltekre alkalmazás* opcióval csak a megfigyelt termékekre alkalmazhatod a szabályokat. **Ezzel felgyorsítod az ellenőrzés vagy tesztelés folyamatát** egy konkrét terméknél, ha a feeded sok terméket tartalmaz. ### **Szabály ütemezése** Szabályt ütemezhetsz is. A szabály ütemezőt a **Terv** szekcióban találod – minden szabálynál van lehetőség ütemezésre. **A szabály ütemező lehetővé teszi, hogy beállítsd, mikor legyen aktív az adott szabály, és mikor legyen kihagyva.** Így beállíthatod például, hogy egy időkorlátos akciós szabály csak adott dátumtartományban legyen aktív (pl. Black Friday, karácsony előtt), vagy akár csak hétvégén. ## **Összefoglalás** * **Mik azok a szabályok?** A szabály egy adatmódosító eszköz. * **Hány szabályt kínál az Editor?** Sokat. Mindegyiknek megvan a maga konkrét célja. Egyszerű az elv: felül akarod írni – használd a **Felülírás** szabályt; nagyobb mennyiségben vagy több értékhez kell módosítanod – válassz tömeges szabályt. * **Mit csinál a szabályok alkalmazása?** A szabályok alkalmazása csak az Editorban módosítja az adatokat. Az adatok exportálásához teljes újragenerálás szükséges. * **Milyen sorrendben alkalmazódnak a szabályok?** Fentről lefelé. A Mergado szabályai lehetővé teszik, hogy **tömeges módosításokat** alkalmazz a termékekre. Az egyes szabályok alkalmazhatók a feeded összes termékére, de sokkal hatékonyabbak [lekérdezésekkel](/hu/napoveda/produkty-a-vybery-produktu) kombinálva – így meghatározhatod, melyik termékekre melyik szabály vonatkozzon. Tipp: Szabályt a **Szabályok** oldalon a **SZABÁLY LÉTREHOZÁSA** gombbal hozhatsz létre. Tipp 2: Nézd meg a **videó útmutatót** a szabályok használatáról: https://youtu.be/CQ6y5v7UdE8 ## **GYIK** ### **Mi a különbség a szabályok alkalmazása és az újragenerálás között?** A szabályok alkalmazása csak a Mergado Editorban módosítja az adatokat – tesztelésre és ellenőrzésre való. A kimeneti feedbe az adatok csak a teljes újragenerálás után kerülnek. ### **Számít a szabályok sorrendje?** Igen, a szabályok fentről lefelé alkalmazódnak, tehát az egyik szabály által módosított adatokkal már a következő szabály dolgozik. A sorrendet a **Rendezés** funkcióval módosíthatod. ### **Hogyan importálhatok szabályt egy másik projektből?** Az **Importálás** gombbal kiválaszthatod, melyik webáruházból és projektből szeretnéd az importot végrehajtani. Ez hasznos, ha egy másik projektben már van egy kidolgozott szabályod. ### **Melyik szabályt használjam, ha egy elem értékét szeretném módosítani?** Ha egyszerűen felül akarod írni, használd a **Felülírás** szabályt. Ha szövegrészt cserélnél, a **Keresés és csere** szabályt. Nagyobb mennyiségű vagy többféle értéknél válassz tömeges szabályt (pl. **Tömeges felülírás lekérdezések** vagy **értékek szerint**). ### **Ütemezhetek szabályokat időpontra?** Igen, a szabály ütemezővel beállíthatod, mikor legyen aktív vagy inaktív egy szabály. Így például szezonális akciókhoz (Black Friday, karácsony) időzítheted az árváltozásokat. --- ## [Szabály: Adatfájl import (CSV / XML)](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-adatfajl-import-csv-xml/) # **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. --- ## [Szabály: Betűméret módosítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-betumeret-modositasa/) # **Szabály: Betűméret módosítása** Ez a szabály lehetővé teszi a betűméretek módosítását a feed elemeiben. Például átírhatod a terméknevet nagybetűkről normálra, vagy egységesítheted a betűformátumot a paraméterekben. ## **Extra funkciók** **6 betűméret-változat** közül választhatsz: * mind kisbetűvel * MIND NAGYBETŰVEL * Nagybetű a mondatok elején * Nagy Kezdőbetű Minden Szónál * Nagy első betű, a többi marad * Csak az első betű nagy a kettőnél több karakteres szavaknál ## **Konkrét példák** ### **1. példa: Nagybetűs terméknevek átírása** Ez a példa bemutatja, hogyan módosítsd a betűméretet a terméknevekben. * **Ú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ály típusa** mezőben válaszd a **Betűméret módosítása** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki a módosítandó elemet. * Ebben a példában ez a `g:title` elem lesz. * **Betűméret kiválasztása** * A **Betűméret** mezőben válaszd ki a kívánt változatot. * Ebben a példában a **Nagybetű a mondatok elején** opciót válaszd. * **Szabály elnevezése**: * Az utolsó lépésben add meg a **szabály nevét**, például „Betűméret módosítása a névben". ### **2. példa: Betűméret módosítása paramétereknél további felhasználáshoz (például: terméknevekhez adás)** Ez a példa bemutatja, hogyan módosítsd a betűméretet a paraméterértékekben, hogy azokat utána hozzáadd a terméknevekhez. * **Ú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ály típusa** mezőben válaszd a **Betűméret módosítása** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki a módosítandó elemet. * Ebben a példában ez a `PARAM | PARAM_VALUE` elem lesz. * **Betűméret kiválasztása** * A **Betűméret** mezőben válaszd ki a kívánt változatot. * Ebben a példában a **mind kisbetűvel** opciót válaszd. * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például „Betűméret módosítása a paramétereknél". * **Tipp:** A módosított paramétereket utána felhasználhatod a terméknevek bővítéséhez a **Felülírás** szabály segítségével. ### **A szabály további felhasználása** * Termékleírások szövegeinek átírása **mind kisbetűsre**. * Betűk egységesítése a paraméterekben vagy nevekben a **konzisztens exporthoz különböző feedekbe**. ## **GYIK** ### **Mire szolgál a Betűméret módosítása szabály?** A szabály lehetővé teszi a **szövegformátum egységesítését** a feed bármely elemében. Használható például: * NAGYBETŰVEL írt terméknevek módosítása, * leírások szövegeinek kisbetűsre konvertálása, * paraméterek vagy márkák formátumának egységesítése, * szövegek előkészítése további felhasználásra (pl. a **Felülírás** szabályban). ### **Milyen betűméret-változatok közül választhatok?** A **Betűméret** mezőben 6 lehetőség közül választhatsz: 1. **mind kisbetűvel** – pl. *nike air zoom*, 2. **MIND NAGYBETŰVEL** – pl. *NIKE AIR ZOOM*, 3. **Nagybetű a mondatok elején** – pl. *Nike air zoom egy népszerű modell.*, 4. **Nagy Kezdőbetű Minden Szónál** – pl. *Nike Air Zoom Pegasus*, 5. **Nagy első betű, a többi marad** – megőrzi az eredeti formátumot az első betű után, 6. **Csak az első betű nagy a kettőnél több karakteres szavaknál** – hasznos a túlzott nagybetűsítéssel írt szövegek javításához. ### **Javíthatom ezzel a szabállyal a csupa nagybetűvel írt neveket?** Igen. A **Betűméret** mezőben válaszd a **Nagybetű a mondatok elején** vagy a **Nagy Kezdőbetű Minden Szónál** opciót. A Mergado automatikusan átalakítja a szöveget olvasható formátumra (pl. *ADIDAS CIPŐ FEHÉR* → *Adidas cipő fehér*). ### **Alkalmazható a szabály termékparaméterekre is?** Igen. Az **Elem** mezőben válaszd ki például a `PARAM | PARAM_VALUE` elemet. Így tömegesen módosíthatod a paraméternevek formátumát, amelyeket utána könnyen hozzáadhatsz a terméknevekhez a **Felülírás** szabállyal. ### **Befolyásolja a betűméret módosítása az EAN vagy termékazonosító értékeket is?** Nem. A szabály **nem módosítja a számértékeket** vagy kódokat, csak szöveges tartalmakat. Azonosítókat tartalmazó mezőkre (pl. EAN, SKU, ID) nem érdemes alkalmazni. ### **Alkalmazhatom a szabályt csak a szöveg egy részére (pl. az első szóra)?** Közvetlenül nem. A szabály az elem teljes tartalmának betűméretét módosítja. Ha csak a szöveg egy részének méretét szeretnéd változtatni, oszd el az adatokat több elembe, vagy használd a **Keresés és helyettesítés** szabályt reguláris kifejezésekkel. ### **Mi van, ha különböző betűformátumokra van szükségem különböző terméklekérdezéseknél?** Hozz létre több **Betűméret módosítása** szabályt, és mindegyiket más **Terméklekérdezésre** alkalmazd. Pl.: * márkáknál: *Nagy Kezdőbetű Minden Szónál*, * leírásoknál: *mind kisbetűvel*. ### **Használható a szabály SEO optimalizálásra is (pl. márkák egységesítése)?** Igen. Ezzel a szabállyal egységesítheted a márkák, nevek vagy kategóriák formátumát, ami hozzájárul az adatok konzisztenciájához az exportokban és a termékek jobb indexeléséhez a keresőkben. ### **Honnan tudom, hogy a szabály helyesen lett alkalmazva?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után ellenőrizd az eredményt: * a termék előnézetében, vagy * a **Szabályok áthaladása** funkcióval, ahol pontosan láthatod, hogyan változott a szöveg. ### **Kombinálható a szabály más szabályokkal?** Igen, nagyon gyakran használják a következőkkel együtt: * **Felülírás** – átalakított paraméterek hozzáadása a nevekhez, * **Keresés és helyettesítés** – felesleges részek eltávolítása a módosítás előtt, * **Érték rövidítése** – szöveg utólagos rövidítése a kívánt hosszra. --- ## [Szabály: Ékezetek eltávolítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-ekezetek-eltavolitasa/) # **Szabály: Ékezetek eltávolítása** Ez a szabály lehetővé teszi az **ékezetes karakterek eltávolítását** (pl. á, é, ö, ü, ő) a feed elemeinek szövegéből, és **latin megfelelőikre** cseréli őket az **ASCII** tábla alapján. Olyan exportoknál használatos, amelyek nem támogatják az ékezetes karaktereket, vagy a terméknevek egységesítéséhez. ## **Extra funkciók** * Nincsenek további funkciók ## **Konkrét példák** ### **1. példa: Ékezetek eltávolítása a terméknévből vagy leírásból** 1. **Új szabály létrehozása**: 1. Nyisd meg a **Szabályok** oldalt. 2. Kattints az **Új szabály** gombra. 2. **Szabálytípus kiválasztása**: 1. A **Szabály típusa** mezőben válaszd az **Ékezetek eltávolítása** lehetőséget. 3. **Termékek kiválasztása**: 1. A **Lekérdezés** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját **Terméklekérdezést** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. 4. **Elem kiválasztása a módosításhoz**: 1. Az **Elem** mezőben válaszd ki azt az elemet, amelyet módosítani szeretnél. 1. Ebben a példában ez a névelem (például: `g:title`, `Productname`, `name_Exact`) vagy a termékleírás (`description`). 5. **Szabály elnevezése**: 1. Az utolsó lépésben add meg a szabály nevét, például *Ékezetek eltávolítása a terméknévből*. ## **GYIK** ### **Mire szolgál az Ékezetek eltávolítása szabály?** Ez a szabály az összes ékezetes karaktert (pl. *á, é, ö, ü, ő, ű*) **ASCII megfelelőikre** alakítja (*a, e, o, u, o, u*). Leggyakrabban a következőkhöz használatos: * feed exportok olyan rendszerekbe, amelyek nem támogatják az ékezetes karaktereket, * terméknevek vagy URL-ek egységesítése, * adatok előkészítése összehasonlításhoz, szűréshez vagy párosításhoz. ### **Mi az eredmény a szabály alkalmazása után?** Például: * *Piros póló felirattal* → *Piros polo felirattal* * *Női táska Zsófi* → *Noi taska Zsofi* ### **Milyen elemekre alkalmazhatom a szabályt?** Bármely szöveges elemre a projektben, például: * terméknevek (`g:title`, `product_name`, `name_Exact`), * leírások (`description`), * márkák (`brand`), * kategóriák (`product_type`). Tipp: A leggyakoribb felhasználás a terméknevek és leírások esetén külföldi piacokra történő exportnál. ### **Alkalmazható a szabály termékparaméterekre is?** Igen. Az **Elem** mezőben válaszd ki a `PARAM | PARAM_VALUE` elemet. A szabály ekkor a paraméternevekből vagy értékekből is eltávolítja az ékezeteket. ### **Befolyásolja az ékezetek eltávolítása a HTML kód szerkezetét vagy a speciális karaktereket (pl. &)?** Nem. A szabály csak a **szokásos ábécé betűivel** és az **ékezetekkel** dolgozik. A HTML jelölők, entitások (`

`, `&`, ` ` stb.) és a számok érintetlenek maradnak. ### **Használhatom a szabályt URL-ekre is?** Igen, de óvatosan. Az ékezetek eltávolításakor a karakterek alap latin betűkre alakulnak, de a **szóközök és speciális karakterek megmaradnak**. Érdemes ezt a szabályt a **Keresés és csere** szabállyal kombinálni (pl. szóközök kötőjelekre cseréléséhez vagy tiltott karakterek eltávolításához). ### **Alkalmazható a szabály csak kiválasztott termékekre?** Igen. Létrehozhatsz **saját Terméklekérdezést** (pl. nyelv vagy kategória szerint), és a szabályt csak arra alkalmazhatod. Például: ékezetek eltávolítása csak a külföldre exportált termékeknél. ### **Használható a szabály többször is?** Igen. A szabály a feedszerkesztés bármely szakaszában alkalmazható – akár többször is, például új adatok hozzáadása vagy külső fájl importálása után. Csak állítsd be megfelelően a szabályok sorrendjét. Ha a szöveg már nem tartalmaz ékezetet, a szabály nem végez módosítást. ### **Ellenőrizhetem az eredményt az export előtt?** Igen. A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után ellenőrizd az eredményt: * a termék előnézetében, vagy * a **Szabályok áthaladása** funkcióval, ahol pontosan láthatod, hogyan változott a szöveg az ékezetek eltávolítása után. ### **Kombinálható a szabály más szabályokkal?** Igen. Leggyakrabban a következőkkel kombinálható: * **Keresés és csere** – szóközök vagy speciális karakterek utólagos eltávolításához, * **Felülírás** – a módosított szöveg másik elembe való másolásához. --- ## [Szabály: Érték hozzáadása több elemhez](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-ertek-hozzaadasa-tobb-elemhez/) # **Szabály: Érték hozzáadása több elemhez** A szabály alapelve, hogy a kiválasztott meglévő elemhez egy további értéket ad hozzá. ## **Extra funkciók** A szabály viselkedése különböző helyzetekben: * az elem még nem rendelkezik értékkel – hozzáadja az új értéket az első pozícióra, így nem jön létre többszörös elem: * `` `->` `új érték` * az elem egy értékkel rendelkezik – hozzáadja az új értéket a következő, tehát második pozícióra, így többszörös elem jön létre: * `eredeti értékA` `->` `eredeti értékA` `új érték` * az elem már több értékkel rendelkezik (már többszörös) – hozzáadja az új értéket a következő szabad pozícióra: * `eredeti értékA` `eredeti értékB` `->` `eredeti értékA` `eredeti értékB` `új érték` ## **Konkrét példák** ### **1. példa: További alternatív kép URL hozzáadása** * **Ú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ály típusa** mezőben válaszd az **Érték hozzáadása több elemhez** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz:** * Az **Elem** mezőben válaszd ki a módosítandó elemet. * Ebben a példában ez a `g:additional_image_link` lesz. * **Új érték megadása:** * Az **Új érték** mezőbe írd be: * szöveges értéket, például: konkrét url (https://www...) * változót, amelyben az érték tárolva van, például: `%url%` * változó és szöveg kombinációját, például: `https://www.my-shop.com/%image_handle%` * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Alternatív képek hozzáadása. ### **A szabály további felhasználása** * További alternatív kategóriák hozzáadása ## **GYIK** ### **Mire szolgál az Érték hozzáadása több elemhez szabály?** Ez a szabály lehetővé teszi **további érték hozzáadását** egy már meglévő elemhez az eredeti tartalom felülírása nélkül. Használható például további **kép URL-ek**, **alternatív kategóriák** vagy más többszörös adatok kiegészítéséhez. ### **Honnan tudom, hogy az elem többszörös?** Az elem többszörös, ha a feedben **többször is előfordulhat ugyanazzal a névvel**. Például: `url1.jpg` `url2.jpg` Az **Elemek** oldalon a többszörös elemeknél zárójelben megjelenik az értékek maximális száma, pl. `(6x)`. Bővebb leírást a Többszörös elemek a Mergadóban dokumentációban találsz. ### **Mi történik, ha az elem még nem tartalmaz semmit?** Ha az elem nem tartalmaz értéket, a Mergado **létrehozza az első értéket**, és az elem egyelőre **nem számít többszörösnek**. `` `->` `új érték` ### **Mi van, ha az elem már tartalmaz egy értéket?** Az új érték a **következő pozícióra** kerül, és az elem többszörössé válik. `eredeti` `->` `eredeti` `új érték` ### **És ha az elem már több értéket tartalmaz?** A szabály hozzáadja az új értéket **a következő szabad pozícióra**. Az eredeti értékek megmaradnak: `értékA` `értékB` `új érték` ### **Milyen típusú értékeket adhatok hozzá?** Az **Új érték** mezőbe beillesztheted: * **szöveget** (pl. `https://.../image.jpg`), * **változót** (pl. `%image_url%`), * vagy **szöveg és változó kombinációját** (pl. `https://shop.hu/%image_handle%`). ### **Hozzáadható egyszerre több érték?** Közvetlenül nem. Minden szabály **egy értéket ad hozzá egyszerre**. Ha több értéket szeretnél hozzáadni (pl. több kép URL-t), hozz létre több ilyen típusú szabályt. ### **Hozzáadható dinamikus érték egy másik elemből?** Igen. Ha egy másik elem értékét szeretnéd hozzáadni, használd a **változóját** (pl. `%g:image_link%`). A Mergado az újrageneráláskor automatikusan kitölti minden termék értékét a változó alapján. ### **Használható a szabály más célra is, nem csak képekhez?** Igen. A szabály bármely többszörös elemre használható – például **alternatív kategóriákhoz**, **további linkekhez**, **több paraméterhez** vagy **variáns információkhoz**. ### **Korlátozható a hozzáadandó érték csak bizonyos termékekre?** Igen. A **Lekérdezés** mezőben választhatsz az **Összes termék** vagy saját **Terméklekérdezés** létrehozása között, például csak egy adott márka, kategória vagy hiányzó képpel rendelkező termékekhez. ### **Mi van, ha az elem hiányzik a feedből?** A szabály **nem hozza létre automatikusan** – először manuálisan kell hozzáadnod: 1. Nyisd meg az **Elemek** oldalt, 2. kattints az **Új elem** gombra, 3. add meg az elem nevét (pl. `g:additional_image_link`), 4. és erősítsd meg a létrehozást. ### **Mi van, ha olyan értéket adok hozzá, amely már létezik az elemben?** A Mergado jelenleg **nem távolítja el automatikusan a duplikációt**. Ha olyan értéket adsz hozzá, amely már létezik az elemben, az a kimenetben kétszer fog szerepelni. ### **Hogyan viselkedik a szabály, ha üres változót adok hozzá?** Ha a változó üres, a Mergado **nem hoz létre új bejegyzést**. Ezzel elkerülhető az üres, értéktelen elemek keletkezése. ### **Ütemezhetek értékhozzáadást (pl. csak egy bizonyos időszakra)?** Igen. Az **Időzítő** segítségével meghatározhatod a konkrét napokat, órákat vagy dátumtartományt, amikor a szabálynak aktívnak kell lennie. Ez hasznos például **szezonális kategóriák kiegészítéséhez** vagy **ideiglenes promóciós tartalom hozzáadásához**. ### **Hogyan ellenőrizhetem, hogy az érték hozzáadása sikeresen megtörtént?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után: * nyisd meg az **Elemek** vagy a **Termékek** oldalt, * ellenőrizd, hogy az új értéksor megjelent, * vagy futtasd a **Szabályok áthaladása** funkciót egy konkrét terméknél – valós időben mutatja a szabály eredményét. ### **Lecserélhető ezzel a szabállyal meglévő érték?** Nem. A szabály csak **új értékeket ad hozzá**, soha nem írja felül a meglévőket. Ha értékeket szeretnél módosítani vagy lecserélni, használd a **Felülírás** vagy a **Keresés és helyettesítés** szabályt. ### **Mire kell figyelni a szabály használatakor?** * A szabály hozzáadása után mindig végezd el a **feed újragenerálását**. * Ha az értékek nem jelennek meg, ellenőrizd a terméklekérdezést és hogy az elem tényleg létezik-e. ### **Hozzáadható érték olyan elemhez, amely nem engedélyezett a kimeneti formátumban?** Ha a célelem nem támogatott a formátumban, a Mergado **nem illeszti be a kimenetbe**. Ebben az esetben először módosítsd a **projekt kimeneti formátumát**, vagy hozd létre manuálisan az elemet az **Elemek** oldalon. ### **Kiegészíthetek ezzel a szabállyal képeket külső táblázatból (pl. Google Sheetsből)?** Igen. Ha van táblázatod képlinkekkel, importálhatod a Mergadóba az **Adatfájl importálása (CSV / XML)** segítségével, majd ezzel a szabállyal kiegészítheted. Így kombinálhatod a **külső adatokat** a feed **többszörös elemeivel**. --- ## [Szabály: Érték rövidítése](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-ertek-roviditese/) # **Szabály: Érték rövidítése** Ez a szabály lehetővé teszi az elem tartalmának megadott hosszra történő rövidítését. Hasznos, ha korlátozni kell a szöveg hosszát olyan mezőknél, mint a description, title, vagy különböző platformokon való megjelenítés optimalizálásához. ## **Extra funkciók** * Értékek rövidítése a választott karakterszámra * Rövidítéskor saját szöveg hozzáadható (például: "... bővebben a webáruházban") * Törekvés a szavak és zárójelek szétválasztásának elkerülésére * Egybetűs elöljárószavak és kötőszavak eltávolítása a végéről ## **Konkrét példák** ### **1. példa: A leírás (description) elem hosszának rövidítése 5000 karakterre** Ez a példa bemutatja, hogyan rövidítsd le a szöveget egy elemben (pl. description, title, url) a megadott karakterszámra, hogy megfeleljen az exportok vagy platformokon való megjelenítés követelményeinek. * **Ú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ály típusa** mezőben válaszd az **Érték rövidítése** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki azt az elemet, amelybe a rövidítés eredményét be szeretnéd írni. * Ebben a példában ez a `description` elem lesz. * **Maximális hossz megadása** * A **Maximális hossz** mezőben add meg a kívánt maximális szöveghosszt, például: 5000 karakter. * **Szöveg megadása rövidítéskor** * A „Rövidítéskor kiegészítés..." mezőben add meg a szöveget, amely a rövidített szöveg végére kerül, például: „... további információk a weboldalon". * Ez a szöveg hozzáfűződik, de soha nem lépi túl a maximális hosszt. * **További beállítások** * **Lehetőleg ne válassza szét a szavakat és zárójeleket:** Ez az opció alapértelmezetten be van kapcsolva, ami azt jelenti, hogy a szabály megpróbálja nem félbevágni a szöveget egy szó közepén vagy rossz helyen. * **Megmaradt egybetűs elöljárószavak és kötőszavak eltávolítása**: Ez az opció alapértelmezetten be van kapcsolva, és biztosítja, hogy a szövegből eltűnjenek az egybetűs elöljárószavak, ha a szöveg végén maradnának. * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például: "*Leírás rövidítése 5000 karakterre".* ### **A szabály további felhasználása** * Terméknevek hosszának rövidítése 150 karakterre. * URL rövidítése az Árukereső számára maximum 300 karakterre. ## **GYIK** ### **Mire szolgál az Érték rövidítése szabály?** Ez a szabály lehetővé teszi a **szöveghossz rövidítését** bármely elemben a választott karakterszámra. Használható például: * túl hosszú termékleírások módosítása, * nevek (title) rövidítése árösszehasonlító portálokhoz, * URL-ek vagy meta leírások rövidítése, hogy megfeleljenek az adott platform korlátainak (pl. Árukereső, Google stb.). ### **Hozzáadhatok szöveget a rövidítéskor, például „... bővebben a weboldalon"?** Igen. A **„Rövidítéskor kiegészítés..."** mezőben bármilyen szöveget megadhatsz (pl. `... bővebben a webáruházban`). Ez a szöveg automatikusan hozzáfűződik a rövidített szöveg végéhez, **anélkül, hogy túllépné a maximális hosszt**, amit beállítottál. ### **Hogyan működik a „Lehetőleg ne válassza szét a szavakat és zárójeleket" opció?** Ez az opció **alapértelmezetten be van kapcsolva**. Rövidítéskor a Mergado automatikusan ellenőrzi, hogy ne vágja félbe a szöveget egy szó közepén, és ne vágja el a zárójeleket. Az eredmény olvashatóbb szöveg lesz még a hosszkorlátozás mellett is. ### **Mit csinál a „Megmaradt egybetűs elöljárószavak és kötőszavak eltávolítása" opció?** Ez a funkció eltávolítja az **egybetűs elöljárószavakat** és **kötőszavakat** (pl. *a, s*), ha a rövidítés után a szöveg végén maradnának. Az eredmény természetesebb és vizuálisan tisztább lesz. ### **Hogyan határozhatom meg a szöveg maximális hosszát?** A **„Maximális hossz"** mezőbe írd be a karakterszámot, amelyet a szöveg nem léphet túl — pl. `5000`. A szóközök és a kiegészítő szöveg (pl. `... bővebben a weboldalon`) is beleszámítanak. ### **Mi történik, ha a szöveg rövidebb a beállított korlátnál?** Ha a szöveg nem lépi túl a megadott karakterszámot, **a szabály nem hajtódik végre**, és az elem értéke változatlan marad. ### **Rövidíthetők ezzel a szabállyal URL-ek vagy HTML kód is?** Igen, de óvatosan. A rövidítés tisztán a szöveg hossza alapján történik, nem a HTML vagy URL szerkezete szerint. Ha a HTML-t vagy linket rossz helyen vágod el (pl. egy tag vagy URL közepén), az nem működő linkhez vezethet. Ilyen esetekben javasolt az **Érték rövidítése** szabályt a **Keresés és csere** szabállyal kombinálni, amely biztonságosabban távolít el teljes szövegrészeket. ### **Rövidíthetem ezzel a szabállyal a termékneveket bizonyos lekérdezésekhez?** Igen. Elég létrehozni egy **Terméklekérdezést** (pl. hosszú nevű termékek), és a szabályt csak erre a lekérdezésre alkalmazni. Így például csak egy adott márka vagy kategória termékeinél korlátozhatod a neveket. ### **Használható a szabály szavak szerinti rövidítésre is a karakterek helyett?** Nem, jelenleg csak **karakterszám** alapján lehet rövidíteni. Ha a szöveget szerkezet szerint kell módosítani (pl. mondat vagy blokk eltávolítása), használd a **Keresés és csere** vagy **Reguláris kifejezések** szabállyal való kombinációt. ### **Mi van, ha azt szeretném, hogy a szöveg csak bizonyos időszakban rövidüljön automatikusan (pl. kampány idején)?** Használd az **Időzítő** funkciót a szabály oldalának alsó részén. Beállíthatsz konkrét **napokat és órákat**, amikor a szabály alkalmazásra kerül, vagy korlátozhatod az érvényességét egy adott **dátumtartományra**. ### **Hogyan ellenőrizhetem, hogy a szöveg helyesen lett-e rövidítve?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után ellenőrizheted az eredményt a **termék vizualizációjában** vagy a **Szabályok áthaladása** funkcióval. Látni fogod, hogyan rövidült pontosan a szöveg, és hozzá lett-e fűzve a megadott szöveg („... bővebben a weboldalon"). ### **Kombinálható a szabály más szabályokkal?** Igen, nagyon gyakran kombinálják a következőkkel: * **Keresés és csere** – felesleges szövegrészek eltávolítása még a rövidítés előtt, * **Felülírás** – szöveg utólagos kiegészítése vagy formázása. --- ## [Értékek szerinti tömeges felülírás](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-ertekek-szerinti-tomeges-feluliras/) # **Értékek szerinti tömeges felülírás** Ezzel a szabállyal egy elem értékeit módosíthatod vagy felülírhatod egy másik elem értékei alapján. Hasznos automatikus frissítésekhez vagy értékek hozzárendeléséhez – például Google kategóriák beállításához a webáruház kategóriái szerint. ## **Extra funkciók** * Reguláris kifejezések támogatása * Értékek tömeges másolása például Google Sheetsből * Az új értékekhez használható: * egyszerű szöveg * változó * üres érték ## **Konkrét példák** ### **1. példa: Google kategóriák beállítása a webáruház kategóriái szerint** Ez a példa bemutatja, hogyan rendelhetsz Google kategóriákat a webáruház kategóriáit tartalmazó elem értékei alapján. * **Ú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 **Értékek szerinti tömeges felülírás** 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. * **Keresési elem kiválasztása**: * A bal oszlopban az **Elem, amelyben keres** legördülőből válaszd ki az elemet, amely alapján keresel – a mi példánkban ez a `product_type`. * **Módosítandó elem kiválasztása**: * A jobb oszlopban az **Elem, amelybe ír** legördülőből válaszd ki a célelemet – a mi példánkban ez a `g:google_product_category`. * **Add meg a keresési értéket**: * A bal oszlop **Ha az elem értéke tartalmazza** mezőjébe írd be minden sorhoz a keresett szöveget: pontos értéket (`Ajándékok | Ajándékok nőknek`) vagy kulcsszót (`Ajándékok`). * Alternatíva: kattints a **Bal oldal előkitöltése** gombra, és a Mergado automatikusan betölti az összes meglévő értéket. * *Tipp: változót vagy változó+szöveg kombinációját is megadhatod, de ebben a példában erre nincs szükség.* * **Add meg az új értéket**: * A jobb oszlop **Ez az érték lesz beírva az elembe** mezőjébe írd be a megfelelő Google kategóriát, pl. `Művészet és szórakozás > Partik és ünnepségek > Ajándékok`. * *Tipp: a Mergado a kiválasztott formátumoknál be tudja tölteni a hivatalos kategóriafa értékeit, így egyszerűsítve a leképezést.* * **Szabály elnevezése**: * Az utolsó lépésben add meg a **szabály nevét**, például „Google kategóriák beállítása". ### **További felhasználás** * Kimeneti kategóriák felülírása a webáruház kategóriái szerint * **custom\_label** elemek kitöltése különböző paraméterek alapján ## **GYIK** ### **Mire szolgál ez a szabály?** Ezzel a szabállyal **egy elem értékeit módosíthatod vagy felülírhatod egy másik elem értékei alapján**. A logika: ha az A elem tartalmazza az X értéket, akkor a B elembe írd be a Z értéket. Például beállíthatod a **Google kategóriákat a webáruház kategóriái szerint**, vagy kitöltheted a **custom\_label** elemeket paraméterértékek alapján. ### **Mi a különbség a lekérdezések és az értékek szerinti felülírás között?** * **Lekérdezések szerint**: te határozod meg, mely termékeket módosíts, a **saját mentett terméklekérdezéseid** segítségével. * **Értékek szerint**: azt határozod meg, mit kell módosítani, **egy másik elem konkrét értékei** alapján (pl. kategória szövege, márka, paraméterek). A szabály így automatikusan azonosítja a termékeket a kiválasztott elem tartalma alapján. ### **Hogyan választom ki, melyik elem alapján keressen?** A bal oszlopban válaszd ki azt az elemet, amelynek **értékei alapján az egyezés keresődik** – például `product_type`, `category_text` vagy `PARAM|PARAM_NAME`. A Mergado ezek alapján dönti el, mely termékekbe kell az új értéket beírni. ### **Hogyan választom ki az elemet, amelybe az új értékek íródnak?** A jobb oszlopban válaszd ki a célelemet. Kategória-leképezésnél például a `g:google_product_category` elemet. ### **Használhatok részleges szövegegyezést?** Igen. A **Ha az elem értéke tartalmazza** mezőbe írd be csak a szöveg egy részét (pl. „Ajándékok"). A Mergado megtalálja az összes terméket, ahol ez az érték **bárhol szerepel** az elem szövegében. Pontos egyezéshez írd be a teljes szöveget (pl. `Ajándékok | Ajándékok nőknek`). ### **Hogyan töltöm be az összes meglévő értéket az elemből?** Kattints a **Bal oldal előkitöltése** gombra – a Mergado automatikusan betölti a kiválasztott elem összes meglévő értékét a bemeneti feedből. A listát ezután kézzel szerkesztheted: törölhetsz felesleges sorokat, vagy újakat adhatsz hozzá. ### **Használhatok reguláris kifejezéseket?** Igen. A **Reguláris kifejezések** opció bekapcsolásával haladó mintákat (regex) is megadhatsz. Például: * `^Ajándékok.*` → megtalálja az „Ajándékok" szóval kezdődő összes értéket * `.*Gyerek.*` → megtalálja az összes értéket, amely tartalmazza a „Gyerek", „Gyerekek" stb. szavakat ### **Mit adhatok meg az „Ez az érték lesz beírva az elembe" mezőbe?** A jobb oszlopba beilleszthetsz: * **szöveget** – pl. `Művészet és szórakozás > Ajándékok > Nőknek`, * **változót** – pl. `%category%`, * **mindkettő kombinációját** – pl. `%category% – Bővített készlet`. Ha az értéket törölni szeretnéd, hagyd a mezőt üresen. ### **Mi történik, ha a termék egy feltételnek sem felel meg?** A termék **változatlan marad** – a Mergado nem talál hozzá megfelelő értéket, és nem hajt végre módosítást. ### **Hogyan értékelődik ki a sorok sorrendje?** A Mergado **fentről lefelé** alkalmazza a szabályt. Ha egy termék több feltételnek is megfelel, az **utolsó megfelelő sor értéke** kerül alkalmazásra. A sorok sorrendje tehát befolyásolja az elem végső értékét. ### **Hogyan használom a szabályt Google kategóriák leképezéséhez?** * A bal oszlopban válaszd a `product_type` vagy `CATEGORYTEXT` elemet. * A jobb oszlopba add meg a megfelelő `g:google_product_category` értéket. A Mergadóban betöltheted a **hivatalos Google kategóriafát**, így gépelés közben javaslatokból választhatod ki a helyes kategóriát. ### **Más értékek kitöltésére is használható?** Igen, a szabály **tetszőleges értékpárosításra** alkalmas – pl.: * `custom_label` hozzárendelése árrés alapján, * `shipping_label` kitöltése ország szerint, * `condition` kitöltése a terméknév szövege alapján. ### **Törölhetek értékeket ezzel a szabállyal?** Igen. Ha a jobb oszlopban **üresen hagyod a mezőt**, a Mergado az érintett elem megfelelő értékeit **törli**. Hasznos hibás vagy duplikált adatok tisztításakor. ### **Hogyan ellenőrzöm, hogy helyesen alkalmazódott a szabály?** A szabály mentése és alkalmazása után nyisd meg a **termékek előnézetét**, vagy használd a **Szabályok áthaladása** funkciót. Ez megmutatja, hogyan változnak az értékek a szabály alkalmazása után, és ellenőrizheted, hogy a hozzárendelés helyes-e. ### **Ütemezhető a szabály bizonyos napokra?** Igen. Az **Időzítő** funkcióval meghatározhatsz konkrét napokat, órákat vagy dátumtartományt, amikor a szabály aktív legyen. Példa: aktiváld csak a szezonális kiárusítás idején – pl. december 1-től 15-ig. ### **Mi történik, ha hibás elemnevet vagy nem létező változót adok meg?** Ha a Mergado nem ismeri fel a változót, **nem ír be értéket**, és a sor kimarad. A hibás változók a felületen **piros háttérrel** jelennek meg. Érdemes a szabályt kisebb termékmintán tesztelni a **Szabályok áthaladása** funkció segítségével. ### **Hogyan kezeli a szabály a duplikált értékeket a bal oszlopban?** Ha ugyanaz az érték többször szerepel, az **első, fentről számított előfordulás** kerül alkalmazásra. A Mergado az első sortól halad lefelé – a további egyező sorok figyelmen kívül maradnak. ### **Használható paraméterek leképezésére is?** Igen. A bal oszlopban válaszd a `PARAM|PARAM_NAME` elemet, a jobb oszlopban pedig szintén `PARAM|PARAM_NAME`-t vagy más célelemet. Így egységesítheted a paraméterneveket, pl. „Méret" → „Size", „Szín" → „Color". ### **Importálhatok értékeket tömegesen táblázatból?** Igen. A szabály támogatja az **intelligens beillesztés módot** – a bal és jobb oszlop értékpárjait közvetlenül Google Sheetsből másolhatod be. A Mergado automatikusan, helyesen osztja szét az értékeket sorok és oszlopok szerint. ### **Hogyan használjuk a pontos egyezést?** A pontos egyezéshez a Szabályban a keresési feltételt a megfelelő szintaktikával kell megadni. Részletesebb útmutatóért keresd az ügyfélszolgálatot. --- ## [Szabály: Értékek tömeges másolása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-ertekek-tomeges-masolasa/) # **Szabály: Értékek tömeges másolása** Ez a szabály lehetővé teszi **értékek másolását** egyik elemből a másikba a Mergadóban. Az értékek a **forráselemből** a **célelembe** kerülnek. A szabály tömegesen is használható – egyetlen szabályon belül több elemet is másolhatsz. ## **Extra funkciók** * Értékek tömeges másolása például: Google Sheetsből * Struktúra tömeges másolása * Bal oldal előkitöltése * Több sor hozzáadásának lehetősége * A sorok sorrendje számít – fentről lefelé alkalmazódnak ## **Konkrét példák** ### **1. példa: Két elem értékeinek felcserélése** Ez a példa bemutatja, hogyan cseréld fel két elem értékeit (pl. image és image\_alternative között) tömeges értékmásolással. * **Segédelem létrehozása**: * Az **Elemek** oldalon a jobb felső sarokban kattints az **Új elem** gombra. * Hozz létre egy segédelemet, például `seged_elem`. * **Rejtsd el ezt az elemet** a sor végén lévő kapcsolóval. * **Ú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 **Értékek tömeges másolása** 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**. * **Forráselem kiválasztása:** * A bal oszlopban a **Forráselem** mezőben válaszd ki az elemet, **amelyből másolni** szeretnél. * Az elemet az elemnév egy részének beírásával keresheted a **Forráselem** mezőben. Például: `image` vagy `image_alternative`. * **Célelem kiválasztása** * A jobb oszlopban a **Célelem** mezőben válaszd ki az elemet, **amelybe az értékeket be** szeretnéd illeszteni. * **További sor hozzáadása** * Ha egyszerre több elemet kell másolnod, további sorokat adhatsz hozzá. * **A sorok sorrendje számít** – a szabály **fentről lefelé** alkalmazódik. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Két elem értékeinek felcserélése. ### **2. példa: Több elem másolása különböző célelemekbe** Ez a példa bemutatja, hogyan használd az értékek tömeges másolását több elem (pl. title, description, price) különböző célelemekbe (pl. g:title, g:description, g:price) másolásához. * **Ú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 **Értékek tömeges másolása** 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**. * **Forráselem kiválasztása:** * A **Forráselem** mezőben válaszd ki az elemet, **amelyből másolni** szeretnéd az értékeket. * Például: `title`, `description`, `price`. * **Célelem kiválasztása:** * A **Célelem** mezőben válaszd ki az elemet, **amelybe másolni** szeretnéd az értékeket. * Például: `g:title`, `g:description`, `g:price`. * **További sor hozzáadása** * Ha egyszerre több elemet kell másolnod, **adj hozzá további sorokat** minden forrás-cél elempárhoz. * **A sorok sorrendje számít**, mert **fentről lefelé** alkalmazódnak. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Elemek másolása. ### **3. példa: Kiválasztott paraméterek másolása más elemekbe** Ez a példa bemutatja, hogyan vigyél át **paramétereket** egyik elemből a másikba tömeges értékmásolással. * **Ú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 **Értékek tömeges másolása** 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**. * **Forráselem kiválasztása:** * A **Forráselem** mezőben válaszd ki a paramétert, amelynek értékeit másolni szeretnéd. * **Célelem kiválasztása:** * A **Célelem** mezőben válaszd ki az elemet (vagy add meg az elem elérési útját), amelybe a paraméter értékeit másolni szeretnéd. * **További sor hozzáadása** * Ha egyszerre több paramétert kell másolnod, további sorokat adhatsz hozzá – így egyetlen szabállyal több paraméter tömeges másolását is beállíthatod. * A sorok sorrendje számít – fentről lefelé alkalmazódnak. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Paraméterek másolása. ### **4. példa: Összes paraméter másolása más elemekbe a név-érték struktúra megőrzésével** Ez a példa bemutatja, hogyan másolhatsz minden paramétert a célelemekbe a struktúra, azaz a paraméter név-érték megőrzésével. * **Ú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 **Értékek tömeges másolása** 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**. * **A szabály speciális viselkedésének használata struktúra másolásához** * Az összes paraméter különböző elemekbe másolásához a szabály speciális viselkedését használjuk, amelyet „tömeges struktúramásolásnak" nevezünk. Nem kell név szerint felsorolnod az összes paramétert, elegendő a szabály 3 sorába a következőket beírni: * 1\. sor: A paraméterek burkoló (szülő) elemének neve. * 2\. sor: A paraméterneveket tartalmazó elem neve * 3\. sor: A paraméterértékeket tartalmazó elem neve * **Forráselem kiválasztása az első sorban:** * A **Forráselem** mezőben válaszd ki a másolandó paraméterek burkoló (szülő) elemét, pl. `PARAM` * **Célelem kiválasztása az első sorban:** * A **Célelem** mezőben válaszd ki a cél burkoló (szülő) elemét, pl. `g:attribute_detail` * **Forráselem kiválasztása a második sorban:** * A **Forráselem** mezőben válaszd ki a másolandó paraméterneveket tartalmazó elemet, pl. `PARAM | PARAM_NAME` * **Célelem kiválasztása a második sorban:** * A **Célelem** mezőben válaszd ki az elemet, amelybe a paraméterneveket másolni szeretnéd, pl. `g:attribute_detail | g:attribute_name` * **Forráselem kiválasztása a harmadik sorban:** * A **Forráselem** mezőben válaszd ki a másolandó paraméterértékeket tartalmazó elemet, pl. `PARAM | PARAM_VALUE` * **Célelem kiválasztása a harmadik sorban:** * A **Célelem** mezőben válaszd ki az elemet, amelybe a paraméterértékeket másolni szeretnéd, pl. `g:attribute_detail | g:attribute_value` * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Összes paraméter másolása. ### **További felhasználás** * Az Átalakító által nem sikerült elemek utólagos leképezése ## **GYIK** ### **Mire szolgál az Értékek tömeges másolása szabály?** Ez a szabály lehetővé teszi **értékek másolását egyik elemből a másikba**. Egyetlen szabályon belül több másolást is beállíthatsz egyszerre. Használhatod például: * értékek átvitelére elemek között (pl. `title` -> `g:title`), * több elem tartalmának duplikálására, * paraméterek másolására az adott árösszehasonlító által megkövetelt struktúrába, * vagy adatok tömeges átvitelére feedek között. ### **Másolhatok egyszerre több elemet?** Igen. Egyetlen szabályba több sort adhatsz, ahol minden sor **egy forrás -> cél elempárt** jelent. A sorok sorrendje fontos – a Mergado **fentről lefelé** alkalmazza őket. ### **Mit jelent a „forráselem" és a „célelem"?** * **Forráselem** – ebből másolódik az érték (pl. `title`) * **Célelem** – ebbe kerül az érték (pl. `g:title`) Ha a célelem még nem létezik, **létre kell hoznod az Elemek oldalon** az **Új elem** gombbal. ### **Fel lehet cserélni értékeket ezzel a szabállyal?** Igen. A **két elem értékeinek felcseréléséhez** (pl. `image` <-> `image_alternative`) így járj el: 1. Az **Elemek** oldalon hozz létre egy segédelemet (pl. `seged_elem`) és rejtsd el. 2. Másold: `image` -> `seged_elem`, 3. `image_alternative` -> `image`, 4. végül `seged_elem` -> `image_alternative`. A feed újragenerálása után az értékek helyet cserélnek. ### **Képes ez a szabály teljes struktúra másolására is?** Igen. A szabály lehetővé teszi **teljes elemkészletek másolását a hierarchia megőrzésével** (pl. paraméternevek és értékek). Elegendő három sort megadni: 1. burkoló elem (`PARAM` -> `g:product_detail`), 2. neveket tartalmazó elem (`PARAM | PARAM_NAME` -> `g:product_detail | g:attribute_name`), 3. értékeket tartalmazó elem (`PARAM | PARAM_VALUE` -> `g:product_detail | g:attribute_value`). A Mergado automatikusan létrehozza a megfelelő célformátum-struktúrát. ### **Mikor érdemes a struktúramásolást használni?** Például ha a feedet olyan platformra exportálod, amely eltérő elemformátumot használ (pl. Google vs. Heureka), és a Mergado ezt nem hozta létre automatikusan. A struktúramásolásnak köszönhetően nem kell kézzel leképezned tucatnyi paramétert – a rendszer automatikusan elvégzi. ### **Másolhatók ezzel a szabállyal termékparaméterek is?** Igen. A szabály paraméterek között is át tud vinni értékeket, például: `PARAM | PARAM_NAME` -> `g:product_detail | g:attribute_name`. Ez hasznos a feed másik formátumba konvertálásakor vagy a cél XML-ben hiányzó paraméterek pótlásakor. ### **Mi történik, ha a célelem már tartalmaz értéket?** Az alapértelmezett viselkedés az, hogy **a meglévő érték felülíródik** a forráselem értékével. Ha az értékeket meg szeretnéd őrizni és csak kiegészíteni, használj más szabályt, pl. **Érték hozzáadása több elemhez**. ### **Használhatok változókat vagy szövegmódosításokat másoláskor?** Nem közvetlenül ebben a szabályban. A szabály **változtatás nélkül** másolja az értékeket. Ha módosítani szeretnéd az értékeket (pl. szöveg hozzáadása, karakterek eltávolítása), kombináld a **Felülírás** vagy **Keresés és helyettesítés** szabállyal. ### **Alkalmazható a szabály csak bizonyos termékekre?** Igen. A **Lekérdezés** mezőben használhatsz mentett lekérdezéseket vagy újakat hozhatsz létre, pl. csak bizonyos márkákhoz, árkategóriákhoz vagy kategóriákhoz. Így szelektíven, a feed csak egy részére másolhatsz értékeket. ### **Mi van, ha csak az elem bizonyos sorait akarom másolni (pl. konkrét paramétert)?** Ilyen esetben használhatod az **elem elérési útját** feltétellel, pl.: `PARAM {PARAM_NAME="Szín"} | VAL` Így a Mergado csak a „Szín" paraméternek megfelelő értékeket másolja. ### **Hogyan ellenőrizhetem, hogy a másolás helyesen történt?** A **szabályok mentése és alkalmazása** után: * lépj a **Termékek** oldalra és ellenőrizd azt a terméket, amely a másolási szabály lekérdezésének részét képezi, * vagy futtasd a **Szabályok áthaladása** funkciót az adott terméknél – látni fogod, hogyan másolódott az érték. A **feed újragenerálása** után nyisd meg a kimeneti feedet és ellenőrizd a célelemet. ### **Javíthatom ezzel a szabállyal az Átalakító után hiányosan leképezett elemeket?** Igen, ez az egyik leggyakoribb felhasználás. Ha az Átalakító nem hozta létre az összes elemet az elvárásoknak megfelelően, ezzel a szabállyal **kiegészítheted a hiányzókat vagy újra leképezheted** azokat, amelyek nem konvertálódtak helyesen. ### **Ütemezhető a szabály (időzítő)?** Igen, aktiválhatod az **időzítőt** és a szabályt csak bizonyos napokon vagy órákban futtathatod. ### **Melyek a leggyakoribb hibák ennél a szabálynál?** * A másolás irányának felcserélése (forrás <-> célelem). * Nem létező elem használata. * A feed újragenerálásának elmulasztása a szabályok alkalmazása után – a módosítások addig nem látszanak a feedben. * A sorok sorrendje – a másolás **fentről lefelé** értékelődik ki. Érdemes a szabályt először kis termékmintán tesztelni a **Szabályok áthaladása** funkcióval. ### **Mi van, ha az attribútumok vagy paraméternevek struktúráját is át kell vinnem?** Használd a **teljes struktúra másolását** (lásd 4. példa). A Mergado képes a beágyazott elemeket a nevükkel és értékeikkel együtt átvinni, így megőrzi az eredeti név–érték kapcsolatot. --- ## [Szabály: Felülírás](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-feluliras/) # **Szabály: Felülírás** A szabály bármely elem értékének módosítására szolgál, például: terméknevek, kategóriák, leírások és sok más. A Felülírás szabállyal az értékek teljesen felülírhatók, gazdagíthatók vagy részeik eltávolíthatók. ## **Extra funkciók** * Intelligens beillesztés mód \- értékek tömeges másolása és beillesztése például Google Sheetsből * Az **Új érték** mezőbe beírható: * szöveg * változó, például: `%g:brand%` * szöveg \+ változó kombináció, például: `%g:price%` HUF * üres érték * Több sor hozzáadásának lehetősége * A sorok sorrendje számít \- felülről lefelé hajtódik végre ## **Hogyan használd** ### **1. példa: Terméknevek bővítése további információkkal (márka, paraméterek)** * **Ú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ály típusa** mezőben válaszd a **Felülírás** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz:** * Az **Elem** mezőben válaszd ki a módosítandó elemet. * **Új érték megadása:** * Az **Új érték** mezőbe írd be a szóközzel elválasztott változók kombinációját. Például `%brand% %title% %size% %material% %color%` * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például: "*Terméknevek bővítése".* ### **2. példa: Üres kötelező elem kitöltése értékkel: A: szöveg beillesztése (például: konkrét gyártó), B: változó beillesztése (például: gyártó), C: szöveg és változó kombinációja (eladási ár pénznemmel)** * **Ú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ály típusa** mezőben válaszd a **Felülírás** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz:** * Az **Elem** mezőben válaszd ki a módosítandó elemet. * **Új érték megadása:** * Az **Új érték** mezőbe írd be: * szöveges értéket, például: konkrét gyártó (Nike) * változót, például: `%manufacturer%` * változó és szöveg kombinációját, például: `%g:price%` HUF * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például: "*Üres elemek kitöltése".* ### **3. példa: Elem értékének eltávolítása (elemérték törlése)** * **Ú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ály típusa** mezőben válaszd a **Felülírás** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz:** * Az **Elem** mezőben válaszd ki a módosítandó elemet. * **Új érték megadása:** * Az **Új érték** mezőt hagyd üresen. Ezzel a kiválasztott elem bármely értéke törlődik. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például "*Elem törlése*". ## **GYIK** ### **Pontosan mire szolgál a Felülírás szabály?** A szabály a feed **bármely elemét** módosítani tudja. Lehetővé teszi az érték **teljes felülírását**, **új információkkal való gazdagítását** (pl. márka, paraméterek, szöveg hozzáadása), vagy **törlését**. ### **Hozzáadhatok a Felülírás szabállyal információkat a terméknévhez, például márkát és színt?** Igen. Az **Új érték** mezőbe írd be a változók kombinációját, pl.: `%brand% %title% %color%`. A Mergado automatikusan beilleszti a megfelelő értékeket minden termék elemeiből. ### **Mi történik, ha valamelyik használt változónak nincs kitöltött értéke?** Ha az elem üres, a Mergado a felülírásnál **kihagyja**. **Megjegyzés**: Ha az üres változó a szöveg közepén található, a szomszédos változók között két szóköz maradhat. Ezt könnyen javíthatod a Keresés és csere szabállyal – a „Keresés" mezőbe írj két szóközt ( \_ \_ ), a „Csere" mezőben hagyj egy szóközt ( \_ ). ### **Mi a különbség a szöveg és a változó között az Új érték mezőben?** * **Szöveg** egy rögzített tartalom, amely pontosan úgy kerül beírásra, ahogy megadod (pl. „Nike" vagy „Akciós ajánlat"). * **Változó** egy hivatkozás egy másik elem értékére, pl. `%manufacturer%` vagy `%g:price%`. ### **Hogyan állítsam be a szabályt, ha teljesen törölni akarom egy elem értékét?** Hozz létre egy új **Felülírás** típusú szabályt, válaszd ki a megfelelő elemet, és **hagyd üresen az Új érték mezőt**. Ezzel az érték törlődik a szabály által érintett összes termékből. ### **Felülírhatom az értéket csak kiválasztott termékeknél?** Igen. A **Lekérdezés** mezőben válaszd ki, hogy a szabály **minden termékre** vagy csak egy **kiválasztott Terméklekérdezésre** vonatkozzon. A lekérdezés lehet például márka, kategória vagy ár szerinti. ### **Mit jelent az intelligens beillesztés mód?** Az **intelligens beillesztés** mód lehetővé teszi több érték **tömeges másolását és beillesztését** (pl. oszlopok Google Sheetsből vagy Excelből) közvetlenül a szabály táblázatába. A Mergado automatikusan helyesen osztja el a beillesztett értékeket sorok és oszlopok szerint. ### **Hogyan működik a sorok sorrendje a Felülírás szabályban?** A sorrend fontos – a Mergado a sorokat **felülről lefelé** dolgozza fel. Ha két sor ugyanazt az elemet módosítja, az **utolsó (legalsó) sor eredménye** érvényesül. ### **Hogyan ellenőrizhetem, hogy a szabály helyesen lett-e alkalmazva?** A szabályok mentése és alkalmazása vagy a feed újragenerálása után nyisd meg a termékek előnézetét, és ellenőrizd, hogy az értékek az elvárásoknak megfelelően változtak-e. Egy konkrét termék részletes ellenőrzéséhez használd a **Szabályok áthaladása** funkciót, amely megmutatja, hogyan módosítják az egyes szabályok fokozatosan az adott termék adatait. ### **Kombinálható a Felülírás szabály más szabályokkal, például a Keresés és csere szabállyal?** Igen. Figyelj arra, hogy a szabályok felülről lefelé hajtódnak végre, és a sorrendjük számít. A Felülírás szabály teljesen vagy részlegesen felülírhatja egy elem értékét, ezért érdemes átgondolni az elhelyezését a többi szabály között. ### **Használható ugyanez a szabály kategóriákra vagy termékleírásokra is?** Igen. A **Felülírás** szabály **bármely elemre** használható – pl. `g:description`, `g:product_type`, `g:brand` stb. Az elv ugyanaz: kiválasztod az elemet, megadod az új értéket, és a Mergado beírja. ### **Kiegészíthetem a Felülírás szabállyal a hiányzó gyártót (manufacturer)?** Igen. Az **Új érték** mezőbe írj rögzített szöveget (pl. „Nike"), vagy a `%manufacturer%` változót, ha ez az információ már egy másik elemben megtalálható. A szabály ezután minden kitöltetlen gyártójú termékhez hozzáadja az értéket. ### **Mi van, ha csak az üres elemekben szeretném felülírni az értékeket, de nem akarom megváltoztatni a már kitöltötteket?** Ebben az esetben hozz létre egy terméklekérdezést, ahol az adott elem üres, és arra alkalmazd a **Felülírás** szabályt. ### **Hogyan viselkedik a Felülírás szabály, ha ékezetes vagy speciális karakteres szöveget illesztek be?** A Mergado megőrzi az ékezeteket és speciális karaktereket, nem szükséges eltávolítani őket. Ha a rendszer formátumhibát jelezne, használhatod az **Ékezetek eltávolítása** szabályt a felülírás előtt. ### **Lehetséges egy szabályon belül több elemet egyszerre felülírni?** Igen. Minden elemet **külön sorban** adj meg a szabályon belül. Például: első sor a `g:title`-hoz, második a `g:description`-höz, harmadik a `g:brand`-hez. ### **Beállíthatok ezzel a szabállyal értéket egy másik projektből vagy feedből?** Közvetlenül nem. A Felülírás szabály csak **egy projekten belüli adatokkal** dolgozik. Külső forrásból történő értékimporthoz használd az **Adatfájl importálása (CSV / XML)** szabályt. ### **Ütemezhetem a Felülírás szabályt, hogy csak bizonyos napokon vagy időpontokban fusson?** Igen. A szabály beállításaiban használd az **Időzítő** funkciót. Választhatsz **konkrét hétnapokat**, **időszakokat** (pl. 08:00–12:00), vagy beállíthatsz **egyszeri érvényességet kezdő-záró dátummal**. **Példa:** A Felülírás szabályt aktiválhatod csak egy hétvégi kampány idejére – pl. péntektől 18:00-tól vasárnap 23:59-ig. ### **Hozzáadhatok saját megjegyzést a Felülírás szabályhoz?** Igen. A **Megjegyzés** mezőbe bármilyen szöveget beírhatsz 2000 karakter hosszúságig. Érdemes **belső megjegyzésekhez** használni – pl. miért lett létrehozva a szabály, vagy pontosan mit módosít. A megjegyzés nem jelenik meg a feedben, csak a projekt áttekinthetőségét szolgálja. --- ## [Szabály: HTML címkék eltávolítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-html-cimkek-eltavolitasa/) # **Szabály: HTML címkék eltávolítása** Ez a szabály eltávolítja a HTML címkéket az elem tartalmából. ## **Extra funkciók** * Nincsenek ## **Konkrét példák** ### **1. példa: HTML címkék eltávolítása a termékleírásokból (például: ``, `
`, `

`)** * **Ú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ály típusa** mezőben válaszd a **HTML címkék eltávolítása** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki azt az elemet, amelyet módosítani szeretnél. * Ebben a példában ez a termékleírás (`description`) lesz. * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például *„HTML címkék eltávolítása a description elemből"*. ## **GYIK** ### **Mire szolgál a HTML címkék eltávolítása szabály?** Ez a szabály eltávolítja az összes **HTML jelölőt** (taget) a kiválasztott elem tartalmából, például `

`, `
`, ``, `` stb. Leggyakrabban a következőkhöz használatos: * termékleírások tisztítása export előtt, * szövegek előkészítése olyan platformokhoz, amelyek nem támogatják a HTML-t (pl. Google Merchant Center), * tartalom egységesítése egyszerű CSV vagy XML feedekbe formázás nélkül. ### **Pontosan mi kerül eltávolításra a szövegből?** Az összes **HTML jelölő** eltávolításra kerül az attribútumaikkal együtt, pl.: `

Új kollekció – ingyenes szállítás!

` Eredmény: `Új kollekció – ingyenes szállítás!` A szabály nem távolítja el a szöveges tartalmat, csak a címkéket. ### **Eltávolításra kerülnek a HTML entitások is, mint a** ` ` **vagy &?** Nem. A szabály csak **HTML tageket** (címkéket) távolít el. Az entitások, mint az ` ` (nem törhető szóköz), `&` (és jel) vagy `€` (€ szimbólum) megmaradnak. Ha ezeket is el szeretnéd távolítani vagy lecserélni, használd utána a **Keresés és csere** szabályt. ### **Alkalmazható a szabály más elemekre is, nem csak a termékleírásra?** Igen. Bármely szöveges elemre alkalmazhatod, például: * `g:title` – ha a nevekbe HTML címkék kerültek, * `custom_label_0` – ha formázott szöveget tartalmaz, * vagy akár `g:product_type`, ha HTML forrásból lett importálva. ### **Befolyásolja a HTML címkék eltávolítása az XML feed szerkezetét?** Nem. A szabály **csak az elemek tartalmával** dolgozik, nem a szerkezetükkel. Az XML érvényes marad — a Mergado soha nem távolítja el magukat az XML elemeket, csak a szövegükben tárolt HTML kódot. ### **Alkalmazható a szabály csak a termékek egy részére?** Igen. A **Lekérdezés** mezőben kiválaszthatod az **Összes termék** opciót, vagy csak egy konkrét **Terméklekérdezést** (például csak egy adott kategória vagy beszállító termékeit). ### **Megsértheti a szabály a szöveget (pl. eltávolíthat valamit, ami nem HTML)?** Nem. A szabály a valódi HTML címkéket a szintaxis alapján (`...`) ismeri fel. Nem törli azt a szöveget, amely csak `<` vagy `>` karaktereket tartalmaz zárt HTML pár nélkül. ### **Kombinálható a szabály más szövegtisztító szabályokkal?** Igen – ez ajánlott megoldás. A HTML tagek eltávolítása után használhatod: * **Keresés és csere** – entitások eltávolításához, mint az ` `, * **Ékezetek eltávolítása** – adatok előkészítéséhez ékezetek nélkül, * **Érték rövidítése** – ha korlátozni kell a szöveg hosszát a tisztítás után. ### **Hogyan tudom megállapítani, hogy a szabály helyesen működött?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után ellenőrizd az eredményt: * a termék előnézetében, vagy * a **Szabályok áthaladása** funkcióval, ahol pontosan láthatod, hogyan lettek eltávolítva a HTML címkék az adott elemből. --- ## [Kategóriák tömeges átnevezése](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-kategoriak-tomeges-atnevezese/) # **Kategóriák tömeges átnevezése** Ezzel a szabállyal a webáruház kategóriáit **tömegesen felülírhatod vagy párosíthatod** az adott árösszehasonlító megfelelő kategóriáihoz. ## **Extra funkciók** * Tömeges kategóriamásolás például Google Sheetsből * Teljes kategóriastruktúra tömeges másolása * **Bal oldal előtöltése** – a webáruház kategóriáinak automatikus betöltése * **Javasoljon kategóriákat** – a Mergado kulcsszó-hasonlóság alapján 3 kategóriát javasol minden bemeneti kategóriához * **Kategóriák rendezése** – a sorok sorrendjének módosítása, ami befolyásolja az alkalmazás sorrendjét * **Gépelés közbeni javaslatok** az adott árösszehasonlító kategóriafájából ## **Konkrét példák** ### **1. példa: Webáruház kategóriáinak párosítása Google kategóriákhoz** * **Ú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 a **Kategóriák tömeges átnevezése** opciót. * **Termékek kiválasztása**: * A **Szűrő** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját terméklekérdezést. * **Töltsd ki a bemeneti kategóriákat**: * A bal oszlop **Ha az aktuális kategória tartalmazza** mezőjébe add meg a webáruház párosítandó kategóriáit. * Tipp: kattints a **Javasoljon kategóriákat** melletti nyílra, majd a **Bal oldal előtöltése** opcióra – a Mergado automatikusan betölti az összes meglévő kategóriát. * **A sorok sorrendje fontos** – a szabály fentről lefelé alkalmazza őket. * **Töltsd ki a célkategóriákat**: * A jobb oszlop **Írja felül ezzel a kategóriával** mezőjébe add meg a platformnak megfelelő kategóriát. * Az értékeket szövegként beírhatod, vagy használhatod a gépelés közbeni javaslatokat. * Google formátumnál a **Javasoljon kategóriákat** funkció kulcsszó-hasonlóság alapján 3 lehetséges kategóriát ajánl fel minden bemeneti kategóriához. * **Szabály elnevezése**: * Add meg a **szabály nevét**, például „Kategóriák párosítása Google kategóriákhoz". ### **2. példa: Webáruház kategóriáinak felülírása egy elemben (pl. `CATEGORY`)** * **Ú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 a **Kategóriák tömeges átnevezése** opciót. * **Termékek kiválasztása**: * A **Szűrő** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját terméklekérdezést. * **Töltsd ki a bemeneti kategóriákat**: * A bal oszlop **Ha az aktuális kategória tartalmazza** mezőjébe add meg a párosítandó kategóriákat. * Tipp: kattints a **Bal oldal előtöltése** gombra – a Mergado automatikusan betölti az összes meglévő kategóriát. * **A sorok sorrendje fontos** – a sorok fentről lefelé alkalmazódnak. * **Töltsd ki a célkategóriákat**: * A jobb oszlop **Írja felül ezzel a kategóriával** mezőjébe add meg a platform kategóriáit. * Az értékeket szövegként beírhatod, vagy használhatod a gépelés közbeni javaslatokat. * **Szabály elnevezése**: * Add meg a **szabály nevét**, például „Kategóriák átnevezése". ### **3. példa: Beszállítói kategóriák felülírása saját kategóriákkal** Ez a példa bemutatja, hogyan állíts be a termékekhez **a webáruházad kategóriáit** a beszállítói kategóriák helyett. * **Ú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 a **Kategóriák tömeges átnevezése** opciót. * **Termékek kiválasztása**: * A **Szűrő** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját terméklekérdezést. * **Töltsd ki a bemeneti kategóriákat**: * A bal oszlop **Ha az aktuális kategória tartalmazza** mezőjébe add meg a beszállító összes kategóriáját. * Tipp: kattints a **Bal oldal előtöltése** gombra – automatikusan betölti az összes bemeneti kategóriát. * A sorok sorrendje számít – fentről lefelé alkalmazódnak. * **Töltsd ki a célkategóriákat**: * A jobb oszlop **Írja felül ezzel a kategóriával** mezőjébe add meg a saját célkategóriáidat. * Az értékeket kézzel beírhatod, táblázatból másolhatod (aktiváld az **Intelligens beillesztés mód** jelölőnégyzetet), vagy használhatod a **gépelés közbeni javaslatokat**, ha importáltad a saját kategóriafádat. * **Szabály elnevezése**: * Add meg a **szabály nevét**, például „Beszállítói kategóriák átnevezése webáruházi kategóriákra". ## **GYIK** ### **Mire szolgál ez a szabály?** Ezzel a szabállyal a bemeneti feed (pl. webáruház vagy beszállító) kategóriáit **tömegesen módosíthatod vagy párosíthatod** az adott platform elvárásaihoz – tipikusan Google, Heureka, Zboží.cz vagy Glami kategóriáihoz. Segít egységesíteni a kategóriastruktúrát, ami egyszerűsíti az exportokat és javítja az adatminőséget. ### **Mi a különbség az átnevezés és a párosítás között?** Ebben a szabályban a két kifejezés ugyanazt jelenti. A szabály a bemeneti kategóriákat a kimeneti formátum kategóriáihoz rendeli hozzá, és a leképezett értéket a megfelelő elembe írja. ### **Kézzel kell megadnom a bemeneti kategóriákat?** Nem. A **Bal oldal előtöltése** funkcióval a Mergado automatikusan betölti az összes bemeneti kategóriát a forrásfeedből. ### **Hogyan működik a Javasoljon kategóriákat funkció?** A Mergado a **bemeneti kategóriák neveiben szereplő kulcsszavak** alapján automatikusan felajánl három lehetséges kategóriát a kiválasztott árösszehasonlító kategóriafájából (pl. Google vagy Heureka). A javaslatokból kiválaszthatod a megfelelőt, vagy kézzel kereshetsz jobb alternatívát. ### **Miért fontos a sorok sorrendje?** A Mergado **fentről lefelé alkalmazza a sorokat**, és az egyezés logikája: „ha a bemeneti kategória **tartalmazza**" a megadott értéket (nem pontos egyezés). Ezért az általánosabb kategóriákat érdemes felülre, a pontosabbakat alulra helyezni. ### **Beilleszthetők a leképezett kategóriák tömegesen táblázatból?** Igen. Aktiváld az **Intelligens beillesztés mód** jelölőnégyzetet, és illeszd be a kategóriapárokat közvetlenül Google Sheetsből. A Mergado automatikusan szétosztja az értékeket a megfelelő mezőkbe. ### **Használható több beszállító kategóriáinak egyidejű átnevezésére?** Igen. A szabályt különböző beszállítói feedek termékeire is alkalmazhatod, és egységesítheted őket egyetlen webáruházi kategóriába. Nagyobb számú beszállítónál érdemes több szabályt használni az áttekinthetőség érdekében. ### **Mi történik, ha egy terméknek nincs kategóriája a bemeneti feedben?** Ha a terméknek nincs kategóriája, **a szabály nem alkalmazódik rá**. Ilyen esetekre hozz létre egy külön **Felülírás** típusú szabályt, amellyel az üres kategóriákat alapértelmezett értékkel töltheted ki (pl. „Besorolatlan"). ### **Kombinálható szöveges kategóriaírás változókkal?** Igen. Az **Írja felül ezzel a kategóriával** mezőbe **szöveg és változók kombinációját** is beírhatod, pl. `%CATEGORY% | %brand%`. ### **törölve** ### **Ütemezhető a szabály szezonális kategória-átrendezéshez?** Igen. Az **Időzítő** funkcióval meghatározhatod, mikor alkalmazódjon a szabály – pl. szezonális szortimentváltáskor. A megadott időtartam lejárta után a szabály automatikusan leáll. ### **Hogyan ellenőrzöm, hogy a kategória-átrendezés helyesen történt?** A szabály mentése és alkalmazása után: * nyisd meg a termék részleteit és ellenőrizd a kategóriát, * vagy használd a **Szabályok áthaladása** funkciót, amely megmutatja, hogyan változott az elem értéke. ### **Mi történik, ha ugyanaz a bemeneti kategória többször szerepel?** A Mergado az **utolsó előfordulást** alkalmazza (a sorok sorrendje szerint). ### **Exportálható a létrehozott kategória-leképezés más projektekbe?** Igen. A projekt bővített funkcióiban a szabály adatai exportálhatók **CSV** vagy **Google Sheets** formátumba. Ez hasznos a leképezés átviteléhez más projektek vagy a webáruház nyelvi verziói között. ### **törölve** ### **Mit tegyek, ha a kategóriák nem párosulnak helyesen?** Ellenőrizd, hogy: * a bemeneti kategóriák szövege pontosan egyezik a keresett értékkel, * nincsenek felesleges szóközök vagy extra karakterek, * a sorok sorrendje megfelel az átrendezés logikájának. Összetettebb struktúráknál tesztelj előbb néhány sorral. ### **Eltávolíthatók a kategóriák ezzel a szabállyal?** Nem. Kategória eltávolításához használd a **Felülírás** szabályt, és adj meg **üres értéket** az adott elemhez. A Kategóriák tömeges átnevezése szabály kizárólag értékek cseréjére vagy leképezésére szolgál. --- ## [Szabály: Kattintási árak beállítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-kattintasi-arak-beallitasa/) # **Szabály: Kattintási árak beállítása** Ez a szabály lehetővé teszi az **egyedi kattintási árak (CPC) beállítását** az egyes termékekhez. A szabály az árösszehasonlítókon belüli **kattintási ajánlatok** kezelésére és optimalizálására szolgál, mint a **Heureka** és a **Zboží.cz**. A kattintási ár kétféleképpen számítható ki: * **fix összeggel**, amely a minimális CPC értékhez adódik hozzá, * vagy a **nettó ár százalékával**. ## **Extra funkciók** * A szabály elérhető a következő formátumokhoz: * Heureka * Zboží.cz ## **Konkrét példák** ### **1. példa: Kattintási árak beállítása fix összeggel** Ez a példa bemutatja, hogyan állíts be kattintási ajánlatokat **fix összeg** alapján, amely hozzáadódik az árösszehasonlító által meghatározott minimális CPC-hez. * **Ú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 a **Kattintási árak beállítása** 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**. * **Kattintási ajánlat meghatározása:** * A **legördülő listából** *Kattintási ajánlat meghatározása* válaszd a **Minimális kattintási ár** opciót. * Az árösszehasonlító határozza meg az egyes kategóriák **minimális kattintási árát**. * A kattintási ajánlat úgy számítódik, hogy ez a minimális ár a következő lépésben megadott összeggel növekszik. * **Hozzáadás a minimális CPC-hez** * A **Hozzáadás a minimális CPC-hez** mezőbe írd be az összeget, amely hozzáadódik a minimális kattintási árhoz, például `10` * Tipp: Így egyszerűen növelheted egy adott kategória összes termékének ajánlatát azonos összeggel. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például "CPC beállítása". ### **2. példa: Kattintási árak beállítása a termékár százalékaként** Ez a példa bemutatja, hogyan állíts be kattintási ajánlatokat a **termék nettó árának százaléka** alapján. A számítás automatikusan figyelembe veszi az árösszehasonlító által meghatározott minimális és maximális CPC korlátokat. * **Ú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 a **Kattintási árak beállítása** 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**. * **Kattintási ajánlat meghatározása:** * A **legördülő listából** válaszd a **Termékár százaléka** opciót. * A kattintási ajánlat a **termék nettó árának százaléka** lesz. * Ha a termék **nem tartalmaz ÁFA-információt**, az **alap ÁFA-kulcs** kerül alkalmazásra. * A számítás figyelembe veszi az árösszehasonlító által meghatározott **minimális és maximális korlátokat**. * **A termékár százaléka** * A **Termékár százaléka** mezőbe írj be egy számot (0-100), amely a kattintási ár kiszámításához használódik, például `10` * A 10-es érték azt jelenti, hogy CPC \= a termék nettó árának 10%-a. * Tipp: Ez a beállítás különböző árkategóriájú termékeknél ideális – magasabb termékár -> magasabb CPC, alacsonyabb ár -> alacsonyabb CPC. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például "CPC beállítása". ### **További felhasználás** * Kattintási árak tömeges beállítása különböző terméklekérdezések szerint. * Kombinálás az **Adatfájl importálása** szabállyal (pl. korábbi CPC értékek importálásához más rendszerekből). * CPC automatikus módosítása árrés vagy termékteljesítmény alapján (a Pricing Fox bővítménnyel vagy számítási szabályokkal kombinálva). ## **GYIK** ### **Mire szolgál a Kattintási árak beállítása szabály?** Ez a szabály lehetővé teszi az **egyedi CPC (Cost Per Click) ajánlatok beállítását** a termékekhez az árösszehasonlítókon, mint a **Heureka** vagy a **Zboží.cz**. A szabállyal meghatározhatod, hogy a CPC fix összegként a minimális CPC-hez adódjon, vagy a **termék nettó árának százalékaként** számítódjon. ### **Mely formátumokhoz érhető el ez a szabály?** A szabály csak a következő formátumokhoz használható: * **Heureka.cz** * **Zboží.cz** Ha más árösszehasonlítóknál is szükséged van CPC-re, használhatod a **Számítás** vagy **Adatfájl importálása** szabályokat, amelyekben egyedileg dolgozhatsz a CPC értékekkel. ### **Mi a különbség a Minimális kattintási ár és a Termékár százaléka között?** * **Minimális kattintási ár** – A CPC az árösszehasonlító által meghatározott *minimális értékként* számítódik **\+ az általad megadott fix összeg**. Pl. minimális CPC 3 Ft \+ hozzáadás 2 Ft \= végső ajánlat 5 Ft. * **Termékár százaléka** – A CPC a **termék nettó árának meghatározott százalékaként** számítódik, pl. 1000 Ft 10%-a \= 100 Ft CPC (figyelembe véve a Heureka/Zboží.cz korlátait). ### **Mit jelent a Hozzáadás a minimális CPC-hez mező?** Ebbe a mezőbe az **árösszehasonlító által meghatározott minimális CPC értékhez hozzáadandó összeget** írod be. Pl. ha 10 Ft-ot adsz meg, és a kategória minimális CPC-je 5 Ft -> a végső ajánlat 15 Ft lesz. ### **Hogyan működik a Termékár százaléka beállítás?** A mezőbe egy **0–100 közötti** számértéket írsz, amely meghatározza a termék nettó árának százalékát. Pl.: * A termék ára 2000 Ft nettó * Megadott százalék \= 5 -> eredő CPC \= 100 Ft Ha a terméknek nincs kitöltött ÁFA értéke, a Mergado az **alap ÁFA-kulcsot** használja a számításhoz. ### **Hogyan viselkedik a szabály, ha a termék CPC-korlátozott kategóriába tartozik?** A Mergado tiszteletben tartja az árösszehasonlító által meghatározott **minimális és maximális CPC korlátokat** (pl. a Heureka minden kategóriához korlátokat állít be). Ha a számítás meghaladná a megengedett határt, a rendszer automatikusan **a maximálisan megengedett értékre korlátozza a CPC-t**. ### **Használható a szabály csak egy bizonyos termékcsoportra?** Igen. A **Lekérdezés** mezőben használhatsz meglévő terméklekérdezést vagy létrehozhatsz újat – pl. * magasabb árrésű termékek, * bizonyos árkategória feletti termékek, * adott kategóriába tartozó termékek. Így a CPC-t stratégiailag a teljesítmény vagy szortiment szegmensenként irányíthatod. ### **Mi történik, ha a terméknek nincs nettó ára?** Ha a nettó árat tartalmazó elemben (`price_vat` vagy `price_excl_vat`) nincs érték, a Mergado az alap ÁFA-kulcsot (pl. 27%) használja alapértelmezettként. Érdemes ellenőrizni, hogy a feed konzisztens áradatokat tartalmaz. ### **Használható a szabály tömeges CPC módosításhoz különböző lekérdezések szerint?** Egy szabállyal csak egy számítási módszer adható meg. Ha különböző lekérdezésekhez különböző logikát szeretnél (pl. 5% az árból az egyiknél, \+10 Ft a minimumhoz a másiknál), hozz létre minden lekérdezéshez külön szabályt – így **automatizált árstratégiát** építhetsz különböző termékszegmensekhez. ### **Hogyan tudom meg, hogy az új CPC érték helyesen alkalmazódott?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után: * nyisd meg a kimeneti feedet és ellenőrizd a CPC elemet (`HEUREKA_CPC`, `ZBOZI_CPC`), * vagy használd a **Szabályok áthaladása** funkciót, amely megmutatja, hogyan számítódott át a CPC érték az adott terméknél. ### **Kombinálható a szabály számítási szabályokkal vagy adatimporttal?** Igen. Kombinálhatod például: * **Számítás** szabállyal – a CPC dinamikus meghatározásához árrés vagy teljesítmény alapján, * **Adatfájl importálása** szabállyal – korábbi CPC vagy teljesítményadatok betöltéséhez Google Sheetsből. Ajánlott sorrend: először importáld vagy számítsd ki az értékeket, majd hozd létre a szegmenseket az eredmények alapján, végül alkalmazd a **Kattintási árak beállítása** szabályt. ### **Mi van, ha a CPC-t dinamikusan a termékteljesítmény alapján akarom módosítani?** Érdemes a Mergado **Bidding Fox** bővítménnyel kombinálni, amely lehetővé teszi a CPC dinamikus igazítását árrések, konverziók vagy verseny alapján. ### **Csökkenthető a CPC ezzel a szabállyal?** Nem. A szabály kizárólag a minimális CPC-hez adott összeget vagy a termékár százalékát tudja beállítani; a CPC csökkentésére nem alkalmas. ### **Mi történik, ha a termék nem tartozik minimális CPC-vel rendelkező kategóriába?** A Mergado ilyenkor az **alapértelmezett minimális CPC értéket** használja (amelyet az árösszehasonlító határoz meg), vagy megtartja az eredeti értéket, ha nincs elérhető referenciaadat. ### **Ütemezhető a szabály?** Igen. Az **Időzítővel** meghatározhatod, mikor frissüljön a CPC – pl. hetente egyszer vagy adott napon. Ez hasznos szezonalitás vagy hirdetési naptár szerint változó kampányoknál. ### **Melyek a leggyakoribb hibák a CPC beállításánál a Mergadóban?** * Rossz számítási típus használata (pl. ár százaléka, de más feed formátumban). * Hiányzó nettó ár elem. * Az árösszehasonlító által megengedett maximális CPC érték túllépése. * Helytelen szabálysorrend (pl. alkalmazás az árszámítás vagy felülírás előtt). Tipp: a beállítás után mindig teszteld a szabályt kisebb számú terméken a **Szabályok áthaladása** funkcióval. --- ## [Szabály: Keresés és helyettesítés](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-kereses-es-helyettesites/) # **Szabály: Keresés és helyettesítés** Ez a szabály szöveget keres az elem tartalmában és kicseréli egy másikra. ## **Extra funkciók** * Kis- és nagybetűk megkülönböztetése * Reguláris kifejezések támogatása * A mezőkben használható szöveg, változók és üres érték * Több sor hozzáadásának lehetősége * A sorok sorrendje számít \- fentről lefelé alkalmazódik ## **Konkrét példák** ### **1. példa: Információk eltávolítása elemből promó szövegek vagy méretek a terméknevekből, linkek a termékleírásokból, nemkívánatos szövegek vagy HTML jelek a leírásból** * **Ú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 a **Keresés és helyettesítés** 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**. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki a módosítandó elemet. * Ebben a példában választhatod pl. a `termékleírás` vagy `terméknév` elemet. * **További beállítások** * Ha szükséges a kis- és nagybetűk megkülönböztetése, **jelöld be** a **Kis- és nagybetűk megkülönböztetése** opciót. * Ha **reguláris kifejezéseket** szeretnél használni a kereséshez, **jelöld be** a **Reguláris kifejezések** opciót. * **Add meg a keresett szöveget** * A **Keresés** mezőbe írd be a keresett szöveget, reguláris kifejezést vagy más elem értékét változóval (pl. `%size%`). * Ebben a példában például: * `akció` * `XXL` * `www.webshopom.hu/kiegeszitok` * `

` * Tipp: A szabály lehetővé teszi több sor (és ezzel több keresés-csere feltétel) hozzáadását. A sorok sorrendje számít, mert a Mergado alkalmazáskor fentről lefelé értékeli ki a sorokat. * **Add meg a helyettesítendő szöveget** * A **Helyettesítés** mezőt hagyd üresen. * Ezzel a Mergado eltávolítja az összes talált szövegelőfordulást – üres értékkel helyettesíti őket. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például *"Promó szövegek eltávolítása a nevekből"* vagy *"Termékleírások tisztítása"*. ### **2. példa: Szövegek szerkesztése elemekben – csere, kiegészítés vagy formátumváltás** * **Ú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 a **Keresés és helyettesítés** 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**. * Tipp: Ez a szabály abban speciális, hogy az Összes termék lekérdezésnél sem dob hibát, ha egy konkrét termékben nem találta meg a keresett kifejezést. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki a módosítandó elemet. * **További beállítások** * Ha szükséges a kis- és nagybetűk megkülönböztetése, jelöld be az opciót. * Ha reguláris kifejezéseket szeretnél használni, jelöld be a **Reguláris kifejezések** opciót. * **Add meg a keresett szöveget** * A **Keresés** mezőbe írd be a cserélendő szöveget, reguláris kifejezést vagy más elem értékét változóval (pl. `%size%`). * Ebben a példában használhatod: * `kanapé` * `HUF` * `Nyári kampány` * `/` * **Add meg a helyettesítendő szöveget** * A **Helyettesítés** mezőbe írd be az új szöveget, reguláris kifejezést vagy más elem értékét változóval (pl. `%size%`). * Ebben a példában lehet: * `ülőgarnitúra` * `EUR` * `Vissza a suliba` * `>` Tipp: Kombinálhatsz több **Keresés és helyettesítés** szabályt különböző célokra – pl. egyet a pénznemhez, másikat a kampánynevekhez. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például *"Terméknevek szerkesztése"* vagy *"Pénznem formátum módosítása"*. ### **3. példa: Információk felcserélése egyetlen elemen belül – az első bekezdés a második mögé helyezése a termékleírásban** * **Ú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 a **Keresés és helyettesítés** 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**. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki a módosítandó elemet. * **További beállítások** * Ha szükséges a kis- és nagybetűk megkülönböztetése, jelöld be az opciót. * Jelöld be a **Reguláris kifejezések** opciót. * **Add meg a keresett szöveget** * A **Keresés** mezőbe írd be a következő reguláris kifejezést: `^(.*?)\n\n(.*)$` * Ez a reguláris kifejezés az első és második bekezdésre osztja a szöveget, amelyeket egy üres sor (`\n\n`) választ el. * **Add meg a helyettesítendő szöveget** * A **Helyettesítés** mezőbe írd be: * `\2` `\1` * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például *"Információk felcserélése egyetlen elemen belül"*. ## **GYIK** ### **Mire szolgál a Keresés és helyettesítés szabály?** Ez a szabály lehetővé teszi, hogy **konkrét szöveget keress egy elem tartalmában és kicseréld másik szövegre**, változóra vagy üres értékre. Használhatod **szövegek szerkesztésére, kiegészítésére vagy eltávolítására** nevekben, leírásokban, kategóriákban és más elemekben. ### **Eltávolíthatok szöveget, linkeket vagy HTML címkéket a termékleírásból?** Igen. A **Keresés** mezőbe illeszd be az eltávolítandó szöveget vagy HTML elemet (pl. `

` vagy `www.webshorom.hu`). A **Helyettesítés** mezőt hagyd üresen. A Mergado ezután az összes talált előfordulást **eltávolítja** az elemből. ### **Mit jelent a Kis- és nagybetűk megkülönböztetése opció?** Ha bejelölöd, a Mergado különbséget tesz kis- és nagybetűk között. Például az `AKCIÓ` keresése nem fogja megtalálni az `akció` szót. Ha nincs bejelölve, a keresés betűmérettől függetlenül történik. ### **Mire szolgál a Reguláris kifejezések opció?** Bekapcsolás után **reguláris kifejezéseket (regex)** használhatsz – tehát mintákat haladó szövegkereséshez és -szerkesztéshez. Például bekezdések felcseréléséhez, számok cseréjéhez, többszörös szóközök eltávolításához vagy adatformátumok módosításához. Példa: a `^(.*?)\n\n(.*)$` kifejezés az első és második bekezdésre osztja a szöveget. ### **Mi van, ha egyszerre több különböző szöveget akarok cserélni?** A szabályban **több sort** adhatsz hozzá – mindegyiket más **Keresés** és **Helyettesítés** kombinációval. A Mergado **fentről lefelé** dolgozza fel, tehát ha egyes kifejezések átfedik egymást, a sorrendjük dönt. Tipp: Az egyszerűbb kifejezéseket válaszd az első sorokba, az összetettebbeket (pl. reguláris) a végére. ### **Hogyan cserélhetek le egy szót egy másikra?** A **Keresés** mezőbe írd be az eredeti szöveget (pl. `kanapé`) és a **Helyettesítés** mezőbe az új szöveget (pl. `ülőgarnitúra`). A szabály ezután a kiválasztott elemben az összes talált szót kicseréli. ### **Használhatok változót a Keresés és helyettesítés szabályban?** Igen. A **Keresés** vagy **Helyettesítés** mezőkbe **változókat** illeszthetsz be – például `%size%` vagy `%brand%`. A Mergado ezután minden terméknél behelyettesíti a megfelelő elem értékét. ### **Mi történik, ha a keresett kifejezés egyes termékekben nem létezik?** Semmi – a szabály hiba nélkül kimarad. A termék változatlan marad. Ez hasznos, ha az **Összes termék** lekérdezéssel használod a szabályt, de a keresett kifejezés csak a termékek egy részénél fordul elő. ### **Hogyan távolíthatok el többszörös szóközöket, amelyek szövegszerkesztés után keletkeztek?** Használd a **Keresés és helyettesítés** szabályt reguláris kifejezéssel: * **Keresés:** `\s{2,}` (két vagy több szóköz) * **Helyettesítés:** (egy szóköz) Ezzel egységesíted a felesleges szóközöket szövegek vagy üres változók eltávolítása után. ### **Felcserélhetem a bekezdések sorrendjét a szövegben?** Igen. Használj reguláris kifejezést: * **Keresés:** `^(.*?)\n\n(.*)$` * **Helyettesítés:** `\2` `\1` Ezzel az első és második bekezdés felcserélődik. Tipp: A szabály akkor működik a legjobban, ha a bekezdések között üres sor van (dupla `\n\n`). ### **Mi a különbség a szöveges keresés és a reguláris kifejezés között?** A szöveges keresés pontos egyezésekkel dolgozik (pl. pontos szót vagy mondatot keres). A reguláris kifejezések lehetővé teszik **minták keresését** – pl. összes szám, e-mail cím, tag vagy bármi két karakter között. Összetettebb szerkesztésekhez a regex célszerűbb. ### **Mit jelent, hogy a szabály fentről lefelé alkalmazódik?** A Mergado a szabály összes sorát a megadott sorrendben dolgozza fel – **fentről lefelé**. Ha az első sor módosítja a szöveget, a második sor már a módosított verzióval dolgozik. Ez lehetővé teszi több szerkesztés láncolását, de gondos sorrendtervezést igényel. ### **Hogyan cserélhetek le például pénznemet, vagy hogyan távolíthatok el perjeleket?** A **Keresés** mezőbe írd be a `HUF` szöveget (vagy `/`) és a **Helyettesítés** mezőbe a `Ft` szöveget (vagy hagyd üresen, ha a karaktert el akarod távolítani). Több sort is létrehozhatsz – egyet a pénznemhez, másikat más szerkesztésekhez (pl. kampányok vagy szövegformátum). ### **Kombinálható a Keresés és helyettesítés szabály más szabályokkal, mint a Felülírás vagy Ékezetek eltávolítása?** Igen. Figyelj arra, hogy a szabályok fentről lefelé alkalmazódnak és a sorrendjük számít. A Keresés és helyettesítés szabály teljesen vagy részlegesen felülírhatja az elem értékét, ezért érdemes átgondolni az elhelyezését a többi szabály között. ### **Hogyan ellenőrizhetem, hogy a szerkesztések helyesen alkalmazódtak?** A szabályok mentése és alkalmazása, vagy a **feed újragenerálása** után ellenőrizd az eredményt közvetlenül a kimeneti feedben vagy a **termékek előnézetében** a Termékek oldalon. Konkrét termék részletes ellenőrzéséhez használd a **Szabályok áthaladása** funkciót, amely megmutatja, hogyan változnak az értékek az egyes szabályok alkalmazása után. ### **Eltávolíthatok csak egy szövegrészt egyetlen elemen belül?** Igen. A **Keresés** mezőbe illeszd be az eltávolítandó konkrét szót vagy kifejezést, és a **Helyettesítés** mezőt hagyd üresen. A Mergado csak ezt a szöveget távolítja el, az elem többi része változatlan marad. ### **Mit tegyek, ha nagyobb mennyiségű HTML taget (pl. `

`, `
`, ``) kell eltávolítanom a leírásokból?** Használj reguláris kifejezést, amely az összes HTML taget elkapja: * **Keresés:** `<[^>]*>` *(regex példa, egyedi esetekben szükség lehet a regex módosítására)* * **Helyettesítés:** *(hagyd üresen)* Ezzel az összes HTML címke eltávolítódik és csak a tiszta szöveg marad. ### **Használható a szabály számokra, árakra vagy paraméterekre is?** Igen. A szabály bármely szöveget tartalmazó elemre alkalmazható – beleértve a **számértékeket**, **árakat** vagy **PARAM | PARAM\_VALUE** elemeket. Például módosíthatod a tizedesjel elválasztót, eltávolíthatsz mértékegységeket vagy kiegészítő szöveget adhatsz hozzá. ### **Mit tegyek, ha a reguláris kifejezés másként viselkedik, mint amire számítottam?** Ellenőrizd, hogy be van-e kapcsolva a **Reguláris kifejezések** opció. Ha igen, ellenőrizd a szintaxis helyességét – például a [regex101.com](https://regex101.com) online eszközzel. Tipp: Összetettebb kifejezéseknél először kisebb termékmintán tesztelj, mielőtt a szabályt globálisan alkalmaznád. Írj nekünk a mergado@mergado.hu címre, ha elakadtál. ### **Használható a szabály többsoros szöveg cseréjéhez?** Igen. A reguláris kifejezések képesek bekezdésekkel vagy sortörésekkel (`\n`, `\r\n`) is dolgozni. --- ## [Szabály: Napok hozzáadása dátumhoz](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-napok-hozzaadasa-datumhoz/) # **Szabály: Napok hozzáadása dátumhoz** Ez a szabály a kiválasztott elembe **a mai dátum plusz a megadott napok számának megfelelő dátumot** ír be. Így mindig **aktuális szállítási dátumot** tarthatsz fenn. A szabály **leggyakrabban Google formátumoknál** használatos, konkrétan a **termékek elérhetőségénél**, amikor az **`availability`** elemben **`preorder`** vagy **`backorder`** érték szerepel. Ezekben az esetekben szükséges egy **konkrét dátum** megadása az elérhetőséghez. ## **Extra funkciók** * A szabály több lekérdezésnél is felülírhatja az értéket * Kimeneti érték előnézete \- ellenőrzésre szolgál * Az elem eredményértéke a szabály alkalmazása után dátum: 2025-10-16T16:13:19 * Használható formátumok: * **YYYY-MM-DD** \- Év-Hónap-Nap (ISO 8601 szabvány) * **YYYY-MM-DDTHH:MM:SS** \- Dátum és idő "T" elválasztóval (pl. 2025-06-24T12:46:12) * **YYYY/MM/DD** \- Év/Hónap/Nap perjellel * **DD/MM/YYYY** \- Nap/Hónap/Év (európai formátum) * **MM/DD/YYYY** \- Hónap/Nap/Év (amerikai formátum) * **YYYYMMDD** \- Kompakt formátum elválasztók nélkül * **DD.MM.YYYY** \- Nap.Hónap.Év * Unix timestamp \- Másodpercek száma 1970. 01. 01. óta (rendszerekhez és API-khoz) ## **Konkrét példák** ### **1. példa: Az expiration\_date és availability\_date elemek beállítása Google feedekhez** Ez a példa bemutatja, hogyan állítsd be egyszerűen a **lejárati dátumot** (`expiration_date`) és az **elérhetőséget** (`availability_date`), ha a termék feedjében `preorder` vagy `backorder` érték szerepel. Ezekben az esetekben meg kell adni egy **konkrét dátumot** is, különben a Google feed nem lesz teljes. * **Ú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ály típusa** mezőben válaszd a **Napok hozzáadása dátumhoz** lehetőséget. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki azt az elemet, **amelybe az eredmény dátumot be kell írni**. * Ebben a példában ez lehet például [`[expiration_date]`](https://support.google.com/merchants/answer/12471622) vagy `[availability_date]` * **Írási formátum kiválasztása** * A listából válaszd ki a Google számára megfelelő formátumot: **YYYY-MM-DDTHH:MM:SS** * **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**, ha csak bizonyos termékekre szeretnéd alkalmazni (pl. g:availability \= `preorder`) * **A hozzáadandó napok számának megadása** * A **Hány nappal növekedjen** mezőben add meg a számértéket, amennyivel a mai dátumot el szeretnéd tolni. * Például: `5` azt jelenti, hogy az eredmény dátum a mai nap \+ 5 nap. * **Eredmény ellenőrzése** * A **Kimeneti érték előnézete** oszlopban megjelenik az eredmény, amely a kimeneti feedbe íródik. * Például: `2025-10-21T16:13:19`. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például "Elérhetőségi dátum beállítása preorder termékekhez". ## **GYIK** ### **Mire szolgál a Napok hozzáadása dátumhoz szabály?** A szabály automatikusan beírja a kiválasztott elembe az **aktuális dátumot a megadott napszámmal eltolva**. Leggyakrabban az `availability_date` vagy `expiration_date` értékek beállítására használatos Google feedekben – jellemzően *preorder* vagy *backorder* értékű termékeknél. ### **Milyen helyzetekben szükséges leggyakrabban ez a szabály?** Főként a következőkhöz használatos: * kötelező dátumok kitöltése Google feedekben, * az elérhetőségi dátum folyamatos frissítése, * dátumok automatikus meghosszabbítása (pl. `expiration_date` \+ 30 nap). ### **Milyen dátumformátumot használjak Google Merchant feedekhez?** A Google formátumokhoz a javasolt formátum: **`YYYY-MM-DDTHH:MM:SS`** Példa: `2025-06-24T12:46:12` Ez a formátum tartalmazza a dátumot és az időt is, és megfelel az ISO 8601 szabványnak, amelyet a Google megkövetel. ### **Választhatok más dátumformátumot?** Igen. A Mergado különböző formátumokat támogat, például: * `YYYY-MM-DD` (pl. 2025-10-16) * `DD.MM.YYYY` (pl. 16.10.2025) * `YYYY/MM/DD` * `YYYYMMDD` * vagy akár `Unix timestamp` (pl. 1739625600) Ez hasznos olyan rendszerekbe történő exportnál, amelyek saját dátumformátumot használnak. ### **Mit jelent a Hány nappal növekedjen mező?** Ebbe a mezőbe írd be a **napok számát, amennyivel a mai dátumot el kell tolni**. Pl.: * `+5` érték → mai dátum \+ 5 nap * `0` érték → mai dátum Az eredmény azonnal megjelenik a **Kimeneti érték előnézete** oszlopban. ### **Használható a szabály egyszerre több lekérdezésre?** Igen. A szabály támogatja az **alkalmazást egyszerre több terméklekérdezésre**, így különböző termékcsoportoknak különböző időeltolásokat állíthatsz be (pl. preorder \+5 nap, backorder \+14 nap). ### **Felülírhatom ezzel a szabállyal egy elem meglévő dátumát?** Igen. Ha az elem (pl. `availability_date`) már tartalmaz értéket, a szabály **az újonnan kiszámított dátummal helyettesíti**. ### **Kombinálható a napok hozzáadása más szabályokkal, például Számítás vagy Felülírás?** Igen. Általában a **Felülírás** szabállyal kombinálva használatos, ha előbb ki kell tölteni üres elemeket, vagy a **Számítás** szabállyal, ha dinamikusan szeretnéd módosítani az értéket egy másik elem alapján. Ajánlott sorrend: először egészítsd ki / módosítsd az adatokat, utána alkalmazd a **Napok hozzáadása dátumhoz** szabályt. ### **Hogyan állapíthatom meg, hogy a dátum tényleg helyesen került-e a feedbe?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után: * jelenítsd meg a kimeneti feedet és ellenőrizd az `availability_date` vagy `expiration_date` elemet, * vagy futtasd a **Szabályok áthaladása** funkciót egy konkrét terméknél – láthatod az eredeti és az új dátumértéket. ### **Használhatok időkomponenst (óra, perc, másodperc)?** Igen. A `YYYY-MM-DDTHH:MM:SS` formátumban konkrét időt is beállíthatsz. Például a `2025-10-21T08:00:00` biztosítja, hogy a termék pontosan 8:00-tól legyen elérhetőként jelölve. ### **Mi történik, ha negatív értéket adok meg (pl. \-2)?** Hibaüzenet jelenik meg. A szabály nem tud negatív számokkal dolgozni, csak pozitív egész számot fogad el (0, 1, 2, ...). ### **Melyek a leggyakoribb hibák a szabály használatakor?** * Helytelen dátumformátum (pl. hiányzó időkomponens Google feednél). * Rossz elembe írás (`availability` az `availability_date` helyett). * Túl magas szám megadása (pl. \+999), ami a dátumot valós tartományon kívülre tolhatja. Érdemes a szabályt kisebb termékmintán tesztelni. ### **Hozzáadhatok napokat egy másik elem értéke alapján (pl. raktári elérhetőség szerint)?** Nem. ### **Használható ez a szabály a Google feedeken kívül is?** Igen. Bár leggyakrabban Google Merchant feedekhez használják, **bármely formátumban** használhatod, ahol dátumokkal dolgozol — például ERP rendszerekbe vagy saját XML struktúrákba történő exportoknál. --- ## [Szabály: Szállítási díj beállítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-szallitasi-dij-beallitasa/) # **Szabály: Szállítási díj beállítása** Ez a szabály a szállítók és szállítási díjak egyszerű beállítására szolgál a termékeidhez. Lehetővé teszi a szállítók és szállítási díj tömeges hozzáadását, akár számértékkel, akár változóval. ## **Extra funkciók** * Értékek tömeges másolása például: Google Sheetsből * Ár nélküli sorok eltávolítása * Előre definiált szállítólista \+ új hozzáadás lehetősége * Az árhoz számérték vagy változó adható meg * Több sor hozzáadásának lehetősége ## **Konkrét példák** ### **1. példa: Szállítási díj hozzáadása az összes vagy csak kiválasztott termékekhez** * **Ú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 a **Szállítási díj beállítása** 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**. * **Szállítók kitöltése:** * A **Szállító** mezőben add meg a cég nevét (például *GLS*, *DPD*, *Magyar Posta*). * Használhatod az **előre definiált szállítólistát** vagy adhatsz hozzá **új szállítókat** igény szerint. * A sorok száma nem korlátozott – annyi szállítót adj hozzá, amennyire szükséged van. * **Szállítási díj beállítása** * Az **Előre fizetésnél** mezőbe írd be a szállítási díj értékét. * Megadható: * **konkrét számérték** (például `890`), vagy * **változó**, amely a feedből tartalmazza az árat (például `%delivery_price%`). * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például *"Szállítási díj beállítása".* ### **2. példa: Meglévő ár felülírása adott szállítónál** * **Ú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 a **Szállítási díj beállítása** 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**. * **Szállítók kitöltése:** * A **Szállító** mezőben add meg annak a cégnek a nevét, amelynél felül akarod írni az értéket (például *GLS*, *DPD*, *Magyar Posta*). * **Szállítási díj beállítása** * Az **Előre fizetésnél** mezőbe írd be az új szállítási díj értékét. * Megadható: * **konkrét számérték** (például `890`), vagy * **változó**, amely a feedből tartalmazza az árat (például `%delivery_price%`). * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például *"DPD – új szállítási díj"*. ### **3. példa: Ingyenes szállítás beállítása az összes vagy csak kiválasztott termékekhez** * **Ú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 a **Szállítási díj beállítása** 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**. * **Szállítók kitöltése:** * A **Szállító** mezőben add meg a cég nevét (például *GLS*, *DPD*, *Magyar Posta*). * Használhatod az **előre definiált szállítólistát** vagy adhatsz hozzá **új szállítókat**. * A sorok száma nem korlátozott. * **Szállítási díj beállítása** * Az **Előre fizetésnél** mezőbe írd be az új számértéket. * Ebben a példában adj meg **0**-t, mert a szállítás ingyenes lesz. * Tipp: Ha több szállítód van, nulla értéket adhatsz meg mindegyikhez vagy csak a kiválasztottakhoz. * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például: *"Ingyenes szállítás".* ### **4. példa: Ingyenes szállítás beállítása csak hétvégén** * **Ú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 a **Szállítási díj beállítása** 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**. * **Szállítók kitöltése:** * A **Szállító** mezőben add meg a cég nevét. * Használhatod az **előre definiált szállítólistát** vagy adhatsz hozzá **új szállítókat**. * A sorok száma nem korlátozott. * **Szállítási díj beállítása** * Az **Előre fizetésnél** mezőbe írd be az új számértéket. * Ebben a példában adj meg **0**-t, mert a szállítás ingyenes lesz. * Tipp: Ha több szállítód van, nulla értéket adhatsz meg mindegyikhez vagy csak a kiválasztottakhoz. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például *"Ingyenes szállítás – hétvége"*. * **Időzítő beállítása a szabályhoz** * Lépj az **oldal aljára** és kattints a **További lehetőségek** gombra. * A szekció kinyitása után kattints az **Időzítő bekapcsolása** opcióra. * Megnyílik egy táblázat, amelyben meghatározhatod a **napokat és órákat**, amikor a szabály aktív legyen. * Az aktív időszakok **pipával (✓)** vannak jelölve. * Ebben a példában válaszd ki a **pénteket, szombatot és vasárnapot**. * A többi napot (hétfő–csütörtök) **hagyd inaktívan**. * Az időzítő felső részében opcionálisan beállíthatod az **érvényességi dátumot** (mikortól meddig legyen a szabály aktív). * Ha ezeket az értékeket nem állítod be, a szabály **a mentés pillanatától** érvényes, amíg **az időzítőt ki nem kapcsolod**. ## **GYIK** ### **Mire szolgál a szabály?** Ezzel a szabállyal **tömegesen adhatsz hozzá szállítókat és szállítási díjakat** az összes vagy csak kiválasztott termékhez. Az értéket megadhatod **konkrét számként** vagy a feedből származó árat tartalmazó **változóként**. ### **Beállíthatok különböző árakat különböző szállítókhoz?** Igen. Minden sorhoz más szállítót (pl. GLS, DPD, Magyar Posta) és más szállítási díjat adhatsz meg. A sorok száma nem korlátozott. ### **Megadható az ár változóként?** Igen. Fix összeg helyett használhatsz változót, például `%delivery_price%`. Így az ár automatikusan a feedből töltődik be. ### **Hogyan állítsak be ingyenes szállítást az összes termékhez?** Az **Előre fizetésnél** mezőbe adj meg **0** értéket. Ezzel ingyenes szállítást állítasz be az összes termékhez, amelyek a kiválasztott lekérdezésbe tartoznak. ### **Beállítható az ingyenes szállítás csak kiválasztott termékekhez?** Igen. A **Lekérdezés** mezőben válassz mentett terméklekérdezést – például 1000 Ft feletti árú termékeket – és adj meg **0** szállítási díjat. A szabály csak erre a lekérdezésre alkalmazódik. ### **Felülírható a meglévő szállítási díj?** Igen. Ha ugyanahhoz a szállítóhoz a feedben már létezik ár, a szabály az új értékkel felülírja. A többi szállító értékei változatlanok maradnak. ### **Hogyan adjak hozzá új szállítót, amely nincs a listában?** Egyszerűen írd be a nevét a **Szállító** mezőbe – például "GLS" vagy "Express futár". ### **Beállíthatok egyszerre több szállítót?** Igen. A szabályba adj hozzá további sorokat – minden szállítóhoz egyet – és mindegyikhez állíts be más árat. A szabály a feed újragenerálása során létrehozza a megfelelő bejegyzéseket. ### **Időben korlátozható a szabály (pl. ingyenes szállítás hétvégén)?** Igen. A **További lehetőségek** szekcióban kapcsold be az **Időzítőt** és válaszd ki a napokat vagy időszakokat, amikor a szabály aktív legyen. Így például beállíthatod, hogy az ingyenes szállítás csak péntektől vasárnapig érvényes legyen. ### **Mi történik, ha a szállító nem szerepel a projektben?** A Mergado automatikusan új bejegyzésként hozza létre a szállítót. Ezért nem kell előre kézzel létrehoznod a szállítókat. ### **Hogyan ellenőrizhetem, hogy a szabály helyesen működik?** A mentés és a feed újragenerálása után nyisd meg az **Elemek** oldalt → `shipping` (vagy a formátumnak megfelelő elem). Ellenőrizd, hogy az új szállítók és áraik helyesen jelennek meg. Emellett az eredményt ellenőrizheted: * a Termékek oldalon, ahol az újonnan beállított értékek megjelennek a termékek áttekintésében, vagy * közvetlenül a kimeneti feedben, amelyet megnyitsz a böngészőben és megkeresed az adott elemet. Egyes termékek részletes ellenőrzéséhez használd a **Szabályok áthaladása** funkciót, amely megmutatja, hogyan alkalmazódott a szabály az adott termékre. --- ## [Szabály: Szám kerekítése](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-szam-kerekitese/) # **Szabály: Szám kerekítése** Ez a szabály a **Számítás** szabály része is. Ez a szabály lehetővé teszi **számértékek kerekítését** (például árak) egy adott elemben a kívánt tizedesre — például egységekre, tizedekre vagy századokra. ## **Extra funkciók** * Kerekítés különböző szintekre: **egységek, tizedek, századok, százasok** * **Kerekítés típusának** kiválasztása: felfelé, lefelé, matematikailag, nullára * **Tizedes jel** kiválasztása (pont vagy vessző) * **Ezres elválasztó** kiválasztása (szóköz, pont, vessző, nincs) ## **Konkrét példák** Példa: Összegek kerekítése egységekre, tizedekre vagy századokra: 1. **Új szabály létrehozása**: 1. Nyisd meg a **Szabályok** oldalt. 2. Kattints az **Új szabály** gombra. 2. **Szabálytípus kiválasztása**: 1. A **Szabály típusa** mezőben válaszd a **Szám kerekítése** lehetőséget. 3. **Termékek kiválasztása**: 1. A **Lekérdezés** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját **Terméklekérdezést** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. 4. **Elem kiválasztása a módosításhoz**: 1. Az **Elem** mezőben válaszd ki azt az elemet, amelyet módosítani szeretnél. 5. **Kerekítés típusának beállítása**: 1. A **Kerekítés típusa** mezőben válaszd ki a kívánt módszert, például: **felfelé**, **lefelé**, **matematikailag**, **0** vagy **0,5**. 6. **Kerekítés kiválasztása**: 1. A **Kerekítés értéke** mezőben válaszd ki az egységeket, tizedeket, századokat stb., a szükséges kerekítés típusa szerint. 7. **Tizedes jel beállítása**: 1. Válaszd ki, hogy **vesszőt** vagy **pontot** szeretnél-e tizedes jelként használni. 8. **Ezres elválasztó beállítása**: 1. Az **Ezres elválasztó** mezőben válaszd ki a kívánt elválasztót (szóköz, pont, vessző vagy nincs elválasztó). 9. **Szabály elnevezése**: 1. Az utolsó lépésben add meg a szabály nevét, például: *"Ár kerekítése egységekre".* ## **GYIK** ### **Mire szolgál a Szám kerekítése szabály?** Ez a szabály lehetővé teszi **számértékek kerekítését** (pl. árak, kedvezmények vagy árrések) bármely elemben a kívánt számú tizedesre — például egységekre, tizedekre vagy századokra. Használható a számformátum módosítására is (tizedes pont/vessző, ezres elválasztók stb.). ### **Milyen értékekre kerekíthetek?** A **Kerekítés értéke** mezőben választhatsz: * egységek (pl. 123,45 → 123), * tizedek (pl. 123,45 → 123,5), * századok (pl. 123,456 → 123,46), * százasok (pl. 1234 → 1200). ### **Milyen kerekítési típusokat használhatok?** A **Kerekítés típusa** mezőben a következő lehetőségek állnak rendelkezésre: * **felfelé** – mindig felfelé kerekít, * **lefelé** – mindig lefelé kerekít, * **matematikailag** – szokásos kerekítés a tizedes jegy értéke szerint, * **0-ra vagy 0,5-re** – a legközelebbi fél egységre vagy 0-ra, * **0,9-re** – a legközelebbi ,9 végződésű értékre kerekít, * **0,99-re** – a legközelebbi ,99 végződésű értékre kerekít. ### **Használható ez a szabály más elemekre is, nem csak árakra?** Igen. A szabály **bármely számértékű elemre** alkalmazható, pl. súly, árrés, százalékos értékek vagy darabszám. Fontos, hogy az elem **érvényes számértékeket** tartalmazzon. ### **Mi történik, ha az elemben nem számérték van (pl. szöveg vagy üres érték)?** A Mergado ezt a bejegyzést **kihagyja** és nem végez módosítást. A szabály csak olyan értékekre alkalmazódik, amelyek egyértelműen számmá alakíthatók. ### **Kiválaszthatom, hogy vesszőt vagy pontot használjak tizedes jelként?** Igen. A **Tizedes jel** mezőben válaszd ki, hogy **vesszőt (,) vagy pontot (.)** szeretnél-e használni. Például magyar feedekhez a vessző szokásosabb, míg nemzetközi projektekhez a pont. ### **Hogyan állítsam be az ezres elválasztót?** Az **Ezres elválasztó** mezőben válassz a lehetőségek közül: * szóköz (pl. 1 000), * pont (pl. 1.000), * vessző (pl. 1,000), * nincs elválasztó (pl. 1000). ### **Alkalmazhatom a szabályt csak kiválasztott termékekre?** Igen. A **Lekérdezés** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját **Terméklekérdezést**, például típus, márka vagy ár szerint. Így csak egy adott termékcsoportnál kerekíthetsz. ### **Eltávolítható ezzel a szabállyal teljesen az ár tizedes része?** Igen. Válaszd a **matematikailag** kerekítési típust, majd állítsd a kerekítést **egységekre**. A Mergado automatikusan eltávolít mindent a tizedes vessző után (pl. 123,99 → 123). ### **Átkonvertálhatok a szabállyal árakat pl. 123,4567-ről 123,46-ra?** Igen. Válaszd a **matematikailag** kerekítési típust, és a **Kerekítés értéke** mezőben válaszd a **századokat**. A Mergado automatikusan két tizedesre módosítja az eredményt. ### **Formázhatok ezzel a szabállyal pénznemet is (pl. Ft hozzáadása)?** Nem. A **Szám kerekítése** szabály csak számértékekkel dolgozik. Ha pénznemet szeretnél hozzáadni, használd utána a **Felülírás** vagy **Keresés és helyettesítés** szabályt. ### **Használhatom ezt a szabályt más számítás részeként?** Igen. A **Szám kerekítése** szabály a **Számítás** szabály része is. Ez azt jelenti, hogy először elvégezheted a számítást (pl. ÁFA nélküli ár), majd az eredményt ugyanazzal a szabállyal azonnal kerekítheted. ### **Hogyan ellenőrizhetem, hogy a kerekítés helyesen lett-e alkalmazva?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után nyisd meg a **termékek előnézetét** vagy használd a **Szabályok áthaladása** funkciót. Így ellenőrizheted, hogy az érték tényleg megváltozott-e a választott kerekítési típus és szint szerint. --- ## [Szabály: Számítás](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-szamitas/) # **Szabály: Számítás** Ez a szabály lehetővé teszi számítások végzését változókkal a feed elemeiben. Kiszámíthatod például az ÁFA nélküli árakat, módosíthatod az értékeket az ÁFA-kulcs szerint, vagy bonyolultabb aritmetikai műveleteket végezhetsz. ## **Extra funkciók** * A *számítás* mezőbe beírható műveletek: összeadás, kivonás, szorzás, osztás, zárójelek és változók használata * Eredményértékek kerekítése (tizedekre, százasokra stb.) ## **Konkrét példák** ### **1. példa: ÁFA nélküli ár kiszámítása** Ez a példa bemutatja, hogyan használd a számítást az ÁFA eltávolítására az árból, például a magyar Árukereső számára, ahol ez kötelező elem. * **Ú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ály típusa** mezőben válaszd a **Számítás** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki azt az elemet, amelybe a számítás eredményét be szeretnéd írni. * Ebben a példában ez a `netprice` elem lesz. * **Számítási érték megadása:** * A **Számítás** mezőben add meg az ÁFA nélküli ár képletét: `%g:price%/1,27` * Ez a számítás az ÁFA-s árat **elosztja 1,27-tel** (feltételezett 27%-os ÁFA-kulcs). * **Kerekítés típusának beállítása**: * A **Kerekítés típusa** mezőben válaszd ki a kívánt módszert, például: **felfelé**, **lefelé**, **matematikailag**, **0** vagy **0,5**. * **Kerekítés kiválasztása**: * A **Kerekítés értéke** mezőben válaszd ki az egységeket, tizedeket, századokat stb., a szükséges kerekítés típusa szerint. * **Tizedes jel beállítása**: * Válaszd ki, hogy **vesszőt** vagy **pontot** szeretnél-e tizedes jelként használni. * **Ezres elválasztó beállítása**: * Az **Ezres elválasztó** mezőben válaszd ki a kívánt elválasztót (szóköz, pont, vessző vagy nincs elválasztó). * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például: *"ÁFA nélküli ár kiszámítása".* ### **2. példa: Ár növelése X %-kal** Ez a példa bemutatja, hogyan használd a számítást az ár 15%-os növeléséhez (például akcióhoz vagy árrés növeléséhez). * **Ú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ály típusa** mezőben válaszd a **Számítás** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki azt az elemet, amelybe a számítás eredményét be szeretnéd írni. * Ebben a példában ez a `g:price` elem lesz. * **Számítási érték megadása:** * A **Számítás** mezőben add meg az árnövelés képletét: `%g:price%*1,15` * Ez a számítás **az árat 1,15-tel szorozza**, ezzel 15%-kal növeli az árat. * **Kerekítés típusának beállítása**: * A **Kerekítés típusa** mezőben válaszd ki a kívánt módszert, például: **felfelé**, **lefelé**, **matematikailag**, **0** vagy **0,5**. * **Kerekítés kiválasztása**: * A **Kerekítés értéke** mezőben válaszd ki az egységeket, tizedeket, századokat stb., a szükséges kerekítés típusa szerint. * **Tizedes jel beállítása**: * Válaszd ki, hogy **vesszőt** vagy **pontot** szeretnél-e tizedes jelként használni. * **Ezres elválasztó beállítása**: * Az **Ezres elválasztó** mezőben válaszd ki a kívánt elválasztót (szóköz, pont, vessző vagy nincs elválasztó). * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például: *"Ár növelése az Allegro számára".* ### **3. példa: Kedvezmény mértékének kiszámítása százalékban** Ez a példa bemutatja, hogyan használd a számítást a termékre vonatkozó százalékos kedvezmény mértékének meghatározásához. * **Segédelem létrehozása**: * Az **Elemek** oldalon a jobb felső sarokban kattints az **Új elem** gombra. * Hozz létre egy segédelemet, például `kedvezmeny_merteke`. * Opcionális: **Rejtsd el ezt az elemet** a sor végén lévő kapcsolóval. * **Ú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ály típusa** mezőben válaszd a **Számítás** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Elem kiválasztása a módosításhoz**: * Az **Elem** mezőben válaszd ki azt az elemet, amelybe a számítás eredményét be szeretnéd írni. * Ebben a példában ez a `kedvezmeny_merteke` elem lesz. * **Számítási érték megadása:** * A **Számítás** mezőben add meg a kedvezmény mértékének képletét: `((%g:price%-%g:sale_price%)/%g:price%)*100` * Ez a képlet kiszámítja az **eredeti és az akciós ár közötti százalékos különbséget**. * **Tipp:** Ha a számítás eredménye után szöveget szeretnél elhelyezni, pl. **%** (százalék) jelet vagy pénznemet (Ft), akkor létre kell hozni egy segéd **Felülírás** szabályt. * **Kerekítés típusának beállítása**: * A **Kerekítés típusa** mezőben válaszd ki a kívánt módszert, például: **felfelé**, **lefelé**, **matematikailag**, **0** vagy **0,5**. * **Kerekítés kiválasztása**: * A **Kerekítés értéke** mezőben válaszd ki az egységeket, tizedeket, századokat stb., a szükséges kerekítés típusa szerint. * Ebben a példában ez egységek lesz. * **Szabály elnevezése**: * Az utolsó lépésben add meg a szabály nevét, például: *"Kedvezmény mértékének kiszámítása".* ### **A szabály további felhasználása** * Ár növelése partneri jutalékkal * ÁFA-kulcs kiszámítása * Eladási ár kiszámítása beszerzési árból * Árak átszámítása más pénznembe dinamikus vagy fix árfolyammal * [https://www.bidding-fox.cz/elements-sparovanost](https://www.bidding-fox.cz/elements-sparovanost) * Akciós ár kiszámítása (gyakran a g:sale price-ba) ## **GYIK** ### **Mire szolgál a Számítás szabály?** Ez a szabály lehetővé teszi **számítások** végzését a feed elemeinek értékeivel. Használhatod például: * ÁFA nélküli ár kiszámításához, * ár növeléséhez százalékkal vagy fix összeggel, * pénznem átszámításához, * kedvezmény százalékban történő kiszámításához, * jutalékok vagy árrések kiszámításához, * akciós ár kiszámításához. ### **Milyen matematikai műveleteket használhatok?** A **Számítás** mezőbe beírhatod a szokásos matematikai műveleteket: * `összeadás (+)` – pl. `%price%+50`, * `kivonás (–)` – pl. `%price%-100`, * `szorzás (*)` – pl. `%price%*1.15`, * `osztás (/)` – pl. `%price%/1.21`, * zárójelek a műveletek sorrendjének meghatározásához, pl. `(%price%-100)*1.15`. ### **Milyen kerekítési típusokat használhatok?** A **Kerekítés típusa** mezőben választhatsz: * **felfelé** – mindig felfelé kerekít, * **lefelé** – mindig lefelé kerekít, * **matematikailag** – szokásos kerekítés a tizedes jegy értéke szerint, * **0-ra vagy 0,5-re** – a legközelebbi fél egységre vagy 0-ra, * **0,9-re** – a legközelebbi ,9 végződésű értékre kerekít, * **0,99-re** – a legközelebbi ,99 végződésű értékre kerekít. ### **Hogyan válasszam ki a kerekítés szintjét?** A **Kerekítés értéke** mezőben beállíthatod, hány helyre kerekítsen az érték: * egységek, * tizedek, * századok, * százasok, a kimeneti feed formátumának igénye szerint. ### **Milyen számformátumot állíthatok be?** A **Tizedes jel** mezőben válaszd ki, vesszőt vagy pontot használj (,) / (.). Az **Ezres elválasztó** mezőben válassz szóközt, pontot, vesszőt vagy nincs elválasztó. Például: 1 000,50 vagy 1.000,50 a célformátum igényei szerint. ### **Mi történik, ha nem létező vagy nem numerikus értékű változót használok?** A Mergado az ilyen változót nem értékeli ki és kihagyja a sort. A szerkesztőben az ismeretlen változó **piros háttérrel** jelenik meg. Érdemes a számítást kisebb termékmintán tesztelni a **Szabályok áthaladása** segítségével. ### **Használhatok a számításban szöveges elemeket is (pl. pénznemet)?** Nem. A számítás csak numerikus értékekkel működik. Ha szöveget vagy pénznemet szeretnél hozzáadni az eredményhez (pl. „Ft", „%"), hozz létre egy következő **Felülírás** szabályt, amely ezeket a jeleket kiegészíti. ### **Hogyan számítsam ki az ÁFA nélküli árat?** A **Számítás** mezőbe írd be a képletet: `%g:price%/1,27` (vagy 1,21 az ÁFA-kulcs szerint). Az eredményt mentsd pl. a `netprice` elembe. A szabály így kiszámítja az ÁFA nélküli árat az eredeti bruttó árból. ### **Hogyan számítsam ki a kedvezmény mértékét százalékban?** Írd be a képletet: `((%g:price%-%g:sale_price%)/%g:price%)*100`. Az eredmény az eredeti és az akciós ár közötti százalékos különbség lesz. Ha a „%" jelet is hozzá szeretnéd adni, használj egy következő **Felülírás** szabályt. ### **Hogyan növelhetem az árat százalékkal vagy fix összeggel?** A **Számítás** mezőbe írd be pl.: * 15%-os növeléshez → `%g:price%*1,15`, * 20 Ft-os növeléshez → `%g:price%+20`. A Mergado automatikusan átszámítja az új értéket és beírja a kiválasztott elembe. ### **Használhatom a szabályt pénznem átszámításhoz?** Igen. A számításba bevonhatsz fix vagy dinamikus árfolyamot. Például HUF-ról EUR-ra történő átszámításhoz (1 EUR \= 400 Ft): `%g:price%/400`. Ha **dinamikus árfolyamokat** használsz, érdemes az adatokat külső fájlból betölteni az **Adatfájl importálása** vagy a **Bidding Fox Elements** bővítmény segítségével. ### **Kombinálhatok több műveletet egy szabályban?** Igen. A számításba több műveletet is beírhatsz, és zárójelekkel határozhatod meg a sorrendet, pl.: `((%g:price%+50)*1.2)/1.27`. A Mergado betartja a szabványos matematikai műveleti sorrendet. ### **Hogyan kerekítsem a számítás eredményét?** A számítási szabályon belül használd a **Kerekítés típusa** és **Kerekítés értéke** beállításokat, ugyanúgy, mint a **Szám kerekítése** szabályban. Például: `felfelé` \+ `századokra` → 123,456 → 123,46. Így egy lépésben számolhatsz és formázhatsz is. ### **Mi történik, ha a számítás hibát tartalmaz (pl. nullával osztás)?** A Mergado kihagyja a bejegyzést és megtartja az eredeti értéket. A szabályok alkalmazásakor a Mergado figyelmeztet a problémára az adott terméknél. Érdemes a számításokat termékmintán tesztelni a **Szabályok áthaladása** segítségével. ### **Hogyan állapíthatom meg, hogy az eredmény helyesen lett-e kiszámítva?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után nyisd meg a **termékek előnézetét** vagy használd a **Szabályok áthaladása** funkciót. Látni fogod, hogyan változott az elem eredményértéke, és megfelel-e az elvárt számításnak. ### **Ütemezhetek szabályt, hogy csak bizonyos időben fusson (pl. éjszakai ár átszámításnál)?** Igen. Az **Időzítő** segítségével meghatározhatod a konkrét időszakokat vagy dátumokat, amikor a szabálynak aktívnak kell lennie. --- ## [Szűrők szerinti tömeges felülírás](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-szurok-szerinti-tomeges-feluliras/) # **Szűrők szerinti tömeges felülírás** Ezzel a szabállyal egy elem értékeit automatikusan felülírhatod különböző terméklekérdezések alapján. Hasznos értékek beállításához különböző termékszegmensekhez – pl. ár, gyártó vagy címkék esetén. ## **Extra funkciók** * A bal oldal automatikus kitöltése – betölti a bemeneti feed értékeit a kiválasztott elemhez * Érték nélküli sorok eltávolítása * Az új értékekhez használható: * egyszerű szöveg * változó * üres érték ## **Konkrét példák** ### **1. példa: CPC érték beállítása terméklekérdezés szerint** Ez a példa bemutatja, hogyan állíthatsz be különböző CPC értékeket különböző termékszegmensekhez lekérdezések alapján. * **Ú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 a **Szűrők szerinti tömeges felülírás** opciót. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki az elemet, amelyet módosítani szeretnél – a mi példánkban ez a `HEUREKA_CPC`. * **Terméklekérdezések**: * A bal oszlop **Szűrő** legördülőjéből válassz mentett lekérdezéseket, mindegyiket külön sorba, vagy * kattints a **A bal oldal automatikus kitöltése** gombra – a Mergado betölti a projekt összes meglévő lekérdezését, majd törölheted a felesleges sorokat. * Ha még nincs megfelelő lekérdezésed, válaszd az **Új szűrő létrehozása** opciót. * **Add meg az új értéket**: * A jobb oszlop **Új érték** mezőjébe írd be minden sorhoz a kívánt értéket, pl. `15`. * *Tipp: változót vagy változó+szöveg kombinációját is megadhatod, de ebben a példában erre nincs szükség.* * **Szabály elnevezése**: * Az utolsó lépésben add meg a **szabály nevét**, például „CPC beállítása". ### **2. példa: Gyártó beállítása lekérdezések szerint** Ez a példa bemutatja, hogyan rendelhetsz gyártót különböző termékszegmensekhez lekérdezések alapján. * **Ú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 a **Szűrők szerinti tömeges felülírás** opciót. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki a módosítandó elemet – a mi példánkban ez a `g:brand`. * **Terméklekérdezések**: * A bal oszlop **Szűrő** legördülőjéből válassz mentett lekérdezéseket, vagy * kattints a **A bal oldal automatikus kitöltése** gombra, majd törölheted a felesleges sorokat. * Szükség esetén válaszd az **Új szűrő létrehozása** opciót. * **Add meg az új értéket**: * A jobb oszlop **Új érték** mezőjébe írd be a gyártó nevét, pl. `Nike`. * *Tipp: változót vagy változó+szöveg kombinációját is megadhatod, de ebben a példában erre nincs szükség.* * **Szabály elnevezése**: * Az utolsó lépésben add meg a **szabály nevét**, például „Gyártó beállítása". ### **3. példa: custom\_label elem beállítása árkategóriák szerint** Ez a példa bemutatja, hogyan rendelhetsz custom\_label címkéket különböző árkategóriákhoz lekérdezések alapján. * **Ú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 a **Szűrők szerinti tömeges felülírás** opciót. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki a módosítandó elemet – a mi példánkban ez a `g:custom_label_0`. * **Terméklekérdezések**: * A bal oszlop **Szűrő** legördülőjéből válassz mentett lekérdezéseket, vagy * kattints a **A bal oldal automatikus kitöltése** gombra, majd törölheted a felesleges sorokat. * Szükség esetén válaszd az **Új szűrő létrehozása** opciót. * **Add meg az új értéket**: * A jobb oszlop **Új érték** mezőjébe írd be az adott lekérdezéshez tartozó címke értékét, pl. `Heroes`. * *Tipp: változót vagy változó+szöveg kombinációját is megadhatod, de ebben a példában erre nincs szükség.* * **Szabály elnevezése**: * Az utolsó lépésben add meg a **szabály nevét**, például „g:custom\_label\_0 beállítása". ### **További felhasználás** * **custom\_label** beállítása árrés mértéke szerint * GPSR adatok kitöltése a feedben (az EU piacra bevezetésért felelős személy) * Kategóriák beállítása lekérdezések szerint ## **GYIK** ### **Mire szolgál ez a szabály?** Ezzel a szabállyal **egy elem értékét automatikusan felülírhatod különböző értékekkel különböző terméklekérdezéseknél**. Például **kattintási árak (CPC)**, **gyártó (brand)** vagy **címkék (custom\_label)** beállítására különböző termékcsoportoknál. ### **Mi a különbség ez és az egyszerű Felülírás szabály között?** A **Felülírás** szabály különböző elemek értékeit módosítja **egyetlen** terméklekérdezéshez. A **Szűrők szerinti tömeges felülírás** ezzel szemben **különböző értékeket** állít be **különböző lekérdezésekhez** egyetlen elem esetén – mindezt egyetlen szabályon belül. ### **Hogyan töltöm be gyorsan az összes meglévő lekérdezést?** Kattints a **A bal oldal automatikus kitöltése** gombra. A Mergado automatikusan betölti a projekt összes **mentett terméklekérdezését** a bal oszlopba. Ezután **törölheted a felesleges sorokat**. ### **Mit tegyek, ha a szükséges lekérdezés még nem létezik?** Válaszd az **Új szűrő létrehozása** opciót a **Szűrő** mezőben. Így új terméklekérdezést hozhatsz létre anélkül, hogy elhagynád a szabályszerkesztőt. ### **Kombinálhatok szöveget és változókat az Új érték mezőben?** Igen. Az **Új érték** mezőben megadhatsz: * **szöveget** (pl. `Nike`), * **változót** (pl. `%brand%`), * **mindkettő kombinációját** (pl. `%brand% – új kollekció`). A legtöbb esetben ennél a szabálynál egyszerű szöveget használnak, de a változók is támogatottak. ### **Mire való az Érték nélküli sorok eltávolítása funkció?** Ez automatikusan **törli az üres sorokat** a szabályban, ahol hiányzik az érték az **Új érték** mezőből. A szabály így áttekinthetőbb marad. ### **Mi történik, ha egy termék egyszerre több lekérdezésbe is tartozik?** A Mergado **fentről lefelé** dolgozza fel a sorokat. Ha egy termék több lekérdezésnek is megfelel, az **utolsó egyező sor értéke** kerül alkalmazásra. A sorok sorrendje tehát befolyásolja az eredményt. ### **Beállíthatok CPC-t különböző termékkategóriákhoz?** Igen. Hozz létre minden kategóriához külön lekérdezést (pl. „Konyhai készülékek", „Mobiltelefonok"), és az **Új érték** mezőbe írd be a megfelelő CPC-t (pl. `15`, `25`, `30`). Így **különböző CPC értékeket** állíthatsz be különböző termékszegmensekhez. ### **Hogyan állíthatok be különböző gyártókat különböző termékekhez?** Hozz létre terméklekérdezéseket igény szerint (pl. név, kategória vagy termékszám alapján). Az **Elem** mezőben válaszd a `g:brand` elemet, az **Új érték** mezőbe pedig írd be a gyártóneveket: * „Cipők" lekérdezés → érték: `Nike` * „Hátizsákok" lekérdezés → érték: `Osprey` * „Pólók" lekérdezés → érték: `Adidas` ### **Hogyan állíthatok be custom\_label értékeket árkategória szerint?** A bal oszlopban hozz létre lekérdezéseket ár alapján (pl. `Ár < 500`, `Ár 500–1000`, `Ár > 1000`). Az **Új érték** mezőbe írd be a címkéket: * 1. lekérdezés → `label_low` * 2. lekérdezés → `label_medium` * 3. lekérdezés → `label_high` Így dinamikus címkéket rendelhetsz a termékekhez az áruk alapján. ### **Törölhetek értéket a kiválasztott termékeknél?** Igen. Ha az **Új érték** mezőt üresen hagyod, a Mergado az adott elemet **törli** az összes terméknél, amelyek az adott lekérdezésbe tartoznak. ### **Ütemezhető a szabály bizonyos napokra?** Igen. Az **Időzítő** funkcióval meghatározhatod, mikor legyen a szabály aktív – például **csak hétvégén**, vagy **konkrét dátumtartományban** (pl. július 1–15.). Hasznos ideiglenes módosításokhoz, mint **szezonális címkék, akciós CPC** vagy **promóciós márkák**. ### **Honnan tudom, mely lekérdezéseket használja a szabály?** A bal oszlopban láthatod az összes aktív lekérdezést. Ha a **A bal oldal automatikus kitöltése** funkciót használtad, itt a projekt összes lekérdezése jelenik meg. Kézzel törölheted vagy módosíthatod a feleslegeseket. ### **Mi történik, ha az Új érték mezőben hibás változót adok meg?** Ha a Mergado nem ismeri fel a változót, az elem **változatlan marad**, a hibás változó pedig **piros háttérrel** jelenik meg. Az üres érték viszont az elem **törlését** okozza. Érdemes a szabályt kisebb termékmintán tesztelni a **Szabályok áthaladása** funkció segítségével. ### **Módosíthatok több elemet egyszerre?** Nem. Egy Szűrők szerinti tömeges felülírás szabályban csak **egyetlen elemet** adhatsz meg (pl. `g:brand` vagy `HEUREKA_CPC`). ### **Hogyan ellenőrzöm, hogy helyesen alkalmazódott a szabály?** A szabály mentése és alkalmazása után nyisd meg a **termékek előnézetét**, vagy használd a **Szabályok áthaladása** funkciót. Látni fogod, hogyan változott az elem értéke a lekérdezések szerint. ### **Használható GPSR adatok vagy más jogszabályi információk kitöltésére?** Igen. Lekérdezésekkel meghatározhatod, mely termékek tartoznak adott jogszabály alá (pl. kozmetikumok, élelmiszerek). Az **Elem** mezőben válaszd ki a megfelelő elemet (pl. `g:responsible_person`), az **Új érték** mezőbe pedig írd be a felelős személyt vagy szervezetet. --- ## [Szabály: Termékek elrejtése](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-termek-elrejtese/) # **Szabály: Termékek elrejtése** Ez a szabály teljesen elrejti a terméket a Mergado kimenetén. ## **Extra funkciók** * Ez a szabály abban tér el a többitől, hogy nem igényli a szabályok alkalmazását – a termékek mentés után azonnal elrejtettként jelölődnek meg a Mergadóban. A kimeneti feedre azonban ez nincs hatással – ahhoz a feedet újra kell generálni. * Az elrejtő szabályok mindig a szabálylista végére kerülnek, tehát minden más szabály után hajtódnak végre. ## **Konkrét példák** ### **1. példa: Összes termék elrejtése a kimeneten (például: szezonális áru)** Ez a példa bemutatja, hogyan rejts el ideiglenesen minden terméket a kimeneti feedből. * **Ú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ály típusa** mezőben válaszd a **Termékek elrejtése** lehetőséget. * **Elrejtendő termékek kiválasztása**: * A **Lekérdezés** mezőben válaszd az **Összes termék** lekérdezést. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Termékek elrejtése. ### **2. példa: Alacsony árrésű, elfogyott, túl olcsó stb. termékek elrejtése** Ez a példa bemutatja, hogyan rejts el olcsó termékeket a kimeneti feedből. * **Ú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ály típusa** mezőben válaszd a **Termékek elrejtése** lehetőséget. * **Termékek kiválasztása**: * A **Lekérdezés** mezőben hozz létre saját **Terméklekérdezést** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt, pl. 500 Ft-nál olcsóbb termékek (`g:price < 500`) * **Tipp**: A lekérdezés mezőben egyszerre több lekérdezést is hozzáadhatsz. Az elrejtő szabály az összes kiválasztott lekérdezésre vonatkozik. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Olcsó termékek elrejtése. ### **3. példa: Kép nélküli termékek elrejtése** Ez a példa bemutatja, hogyan rejts el a kimeneti feedből olyan termékeket, amelyeknek hiányzik a kép URL-je. * **Ú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ály típusa** mezőben válaszd a **Termékek elrejtése** lehetőséget. * **Termékek kiválasztása**: * A **Lekérdezés** mezőben hozz létre saját **Terméklekérdezést** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt, pl. hiányzó kép URL-lel rendelkező termékek (`g:image_link = ""`) * **Tipp**: A lekérdezés mezőben egyszerre több lekérdezést is hozzáadhatsz. Az elrejtő szabály az összes kiválasztott lekérdezésre vonatkozik. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Kép nélküli termékek elrejtése. ### **A szabály további felhasználása** * Nem elérhető vagy rossz minőségű képekkel rendelkező termékek elrejtése (ehhez a Feed Image Editor bővítmény szükséges a nem elérhető/rossz minőségű képek felderítéséhez) ## **GYIK** ### **Mire szolgál a Termékek elrejtése szabály?** A szabály lehetővé teszi a termékek **ideiglenes vagy végleges elrejtését** a kimeneti feedből. Az elrejtett termék: * **nem tűnik el a Mergado felületéről**, csak elrejtettként lesz megjelölve, * **nem kerül be a kimeneti feedbe** (a feed újragenerálása után). Szezonális áruk, nem elérhető termékek, tesztelt tételek vagy hiányos adatú termékek szűrésére használatos. ### **Milyen gyorsan érvényesül a szabály?** Azonnal. A többi szabálytól eltérően **nem igényli a szabályok alkalmazását** – a termékek a Mergadóban mentés után azonnal elrejtettként jelennek meg. Ahhoz, hogy a változás a **kimeneti feedben** is megjelenjen, a projektet **újra kell generálni**. ### **Milyen sorrendben hajtódnak végre az elrejtő szabályok?** Az elrejtő szabályok mindig **automatikusan a szabálylista végére** kerülnek. Ezzel biztosított, hogy **az összes többi szabály után** hajtódnak végre (pl. nevek, árak módosítása után). A már elrejtett termékekre nem alkalmazódnak új változtatások. ### **Alkalmazható a szabály csak egy adott termékcsoportra?** Igen. A **Lekérdezés** mezőben: * kiválaszthatsz egy meglévő lekérdezést, vagy * létrehozhatsz saját **Terméklekérdezést**, például: * 200 Ft alatti árú termékek (`g:price < 200`), * kép nélküli termékek (`g:image_link = ""`), * `out_of_stock` elérhetőségű termékek. Egyszerre több lekérdezést is hozzáadhatsz – a szabály mindegyikre vonatkozik. ### **Honnan tudom, hogy egy termék el van rejtve?** Az elrejtett termék a Mergadóban ikonnal és „a termék szabállyal van elrejtve" üzenettel van jelölve, de nem tűnik el a terméklistáról. Az oldal tetején lévő szűrővel könnyen szűrhetsz: válaszd a **Megjelenítés – látható** opciót (csak a nem rejtett termékek jelennek meg), vagy a **Megjelenítés – rejtett** opciót (csak a rejtett termékek látszanak). ### **Visszavonható az elrejtés?** Igen. Lehetőséged van: * **ideiglenesen szüneteltetni** magát az elrejtő szabályt, vagy * **véglegesen törölni** – ezzel az összes elrejtett termék újra megjelenik a feedben. Ha csak kiválasztott termékeket szeretnél felfedni, kövesd az alábbi lépéseket: 1. Nyisd meg a **Termékek** oldalt. 2. Kapcsold be a **Rejtett termékek megjelenítése** szűrőt, vagy keresd meg a terméket manuálisan. 3. A termék mellett jobbra kattints a szem ikonra. A termék azonnal újra megjelenik a Mergadóban, és a feed újragenerálása után a kimeneti fájlban is. ### **Befolyásolja a termék elrejtése a többi szabályt?** Nem. Az elrejtő szabályok az összes többi módosítás után hajtódnak végre, tehát semmilyen más szabály (pl. Felülírás, Számítás, Szám kerekítése) már nincs hatással az elrejtett termékre. ### **Használható a szabály automatikus elrejtéshez adatok alapján (pl. elérhetőség)?** Igen. Elég létrehozni egy **feltételes Terméklekérdezést** – pl.: `availability = out_of_stock` és ezt a lekérdezést használni a **Termékek elrejtése** szabályban. Minden feed újrageneráláskor a Mergado automatikusan elrejti az adott feltételnek megfelelő termékeket. ### **Ütemezhető a szabály időzítővel (pl. termékek elrejtése csak hétvégén)?** Igen. Az oldal alsó részén aktiválhatod az **időzítőt** és beállíthatod, mikor legyen a szabály aktív. Például: * Péntek–Vasárnap → termékek elrejtése (akció vége), * Hétfő–Csütörtök → termékek újra megjelenítése. ### **Hogyan állapíthatom meg, hogy a termékek a kimeneti feedben is elrejtésre kerültek?** A **feed újragenerálása** után ellenőrizheted az eredményt: * a kimeneti XML/CSV fájl megnyitásával, vagy * a Mergado előnézetével – az elrejtett termékek itt nem jelennek meg. ### **Kombinálható az elrejtő szabály másokkal (pl. Felülírás, Számítás)?** Igen, de csak fordított sorrendben. Az elrejtő szabályok **mindig utolsóként** hajtódnak végre – az összes módosítás, számítás és felülírás után. Ezzel biztosított, hogy a termék elrejtését más szabályok nem befolyásolják. ### **Honnan tudom, melyik szabály rejti el a termékemet?** A **Termékek** oldalon keresd meg az adott terméket id vagy terméknév alapján. Válts a **Lekérdezések** fülre – a listában látod az összes mentett lekérdezést, amelyekben a termék szerepel. Minden lekérdezésnél megjelenik, hogy van-e hozzá rendelve elrejtő szabály, és ha igen, melyik – rá is kattinthatsz közvetlenül. ### **Hogyan fedhetek fel egyszerűen egy konkrét elrejtett terméket?** Felfedő szabály a Mergadóban nincs. Az egyetlen lehetőség, ha kizárod a terméket az elrejtő szabályban használt lekérdezésből – a lekérdezés feltételének módosításával. Alternatívaként a projekt **Termékengedélyezés** nevű funkciója is segíthet. --- ## [Szabály: Termékparaméterek beállítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-termekparameterek-beallitasa/) # **Szabály: Termékparaméterek beállítása** Ez a szabály a **termékparaméterek és értékeik beállítására** szolgál. Egyetlen szabállyal **különböző paramétereket állíthatsz be különböző termékcsoportokhoz** (terméklekérdezések alapján). A szabály ideális **paraméterek automatikus kiegészítésére**, mint például térfogat, szín, anyag vagy tömeg. ## **Extra funkciók** * Paraméternevek gépelés közbeni javaslata * Értékek tömeges másolása például: Google Sheetsből * Paramétertípus kiválasztásának lehetősége (szöveges, számértékű, boolean...) * Több sor hozzáadásának lehetősége ## **Konkrét példák** ### **1. példa: Új paraméterek beállítása az összes vagy kiválasztott termékekhez** Ez a példa bemutatja, hogyan állíts be **tömegesen és automatizáltan új termékparamétereket** különböző termékszegmensekhez. * **Ú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 a **Termékparaméterek beállítása** opciót. * **Módosítandó elem kiválasztása:** * Az elemeket, amelyekbe az új paraméterek kerülnek, nem kell kiválasztanod – a Mergado automatikusan kiválasztja a projekt kimeneti formátuma alapján, például: `g:product_detail` Google projektnél. * **Sorok hozzáadása**: * A **Termékparaméterek beállítása** szabály minden sorának 3 oszlopa van: * **Lekérdezések** – egy vagy több lekérdezés kiválasztását teszi lehetővé * **Paraméter** – meghatározza a beállítandó paraméter nevét * **Érték** – meghatározza a paraméterhez rendelt értéket * A sorok így lehetővé teszik paraméterek beállítását különböző termékszegmensekhez. * **Terméklekérdezések**: * A bal oszlopban a **Lekérdezések** mezőben * a legördülő listából válassz meglévő mentett terméklekérdezéseket a projektből (mindegyiket külön sorba). * **Tipp:** egy vagy több lekérdezést is kiválaszthatsz. * vagy a legördülő listából válaszd az **Új lekérdezés létrehozása** opciót. * **Paraméterek beállítása a kiválasztott lekérdezéshez:** * A jobb oldali **Paraméter** oszlopban add meg az egyes mezőkbe egymás alá a paraméterneveket szöveges értékként, pl. `Térfogat` * Ha meglévő paramétert választasz, az értéke módosul. * Ha új nevet adsz meg, **új paraméter jön létre**. * A jobb oldali **Érték** oszlopban add meg az egyes mezőkbe egymás alá a paraméterértékeket: * szöveges értéket, például: `250 ml` * változót, például: `%terfogat%` * változó és szöveg kombinációját, például: `%terfogat% ml` * **Paraméterek beállítása további lekérdezésekhez:** * Ismételd meg az előző **Terméklekérdezések** és **Paraméterek beállítása a kiválasztott lekérdezéshez** lépéseket a következő üres sorban. * **Tipp:** a következő sor kitöltésekor automatikusan hozzáadódik egy újabb üres sor. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Paraméterek beállítása. ### **2. példa: Meglévő termékparaméterek felülírása** Ez a példa bemutatja, hogyan írd felül tömegesen és automatizáltan a meglévő termékparamétereket különböző termékszegmenseknél. * **Ú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 a **Termékparaméterek beállítása** opciót. * **Módosítandó elem kiválasztása:** * Az elemeket, amelyekben a meglévő paraméterek vannak, nem kell kiválasztanod – a Mergado a projekt kimeneti formátuma alapján automatikusan kiválasztja, pl. `g:product_detail` Google projektnél. * **Sorok hozzáadása**: * Minden sor 3 oszloppal rendelkezik: * **Lekérdezések** – egy vagy több lekérdezés kiválasztása * **Paraméter** – egy vagy több paraméter beállítása az adott sorhoz * **Érték** – a paraméter értékének beállítása * **Terméklekérdezések**: * A bal oszlopban a **Lekérdezések** mezőben * a legördülő listából válassz mentett lekérdezéseket, * **Tipp:** egy vagy több lekérdezést is kiválaszthatsz. * vagy válaszd az **Új lekérdezés létrehozása** opciót. * **Paraméterek beállítása a kiválasztott lekérdezéshez:** * A jobb oldali **Paraméter** oszlopban a legördülő listából válaszd ki a projektben meglévő felülírandó paramétereket, pl. `Térfogat` * több paramétert is választhatsz, mindig egyet egy sorba * A jobb oldali **Érték** oszlopban add meg az új paraméterértékeket: * szöveges értéket, például: `250 ml` * változót, például: `%terfogat%` * változó és szöveg kombinációját, például: `%terfogat% ml` * **Paraméterek beállítása további lekérdezésekhez:** * Ismételd meg az előző lépéseket a következő üres sorban. * **Tipp:** a következő sor kitöltésekor automatikusan hozzáadódik egy újabb üres sor. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Paraméterek beállítása. ### **3. példa: Paraméterek összes értékének törlése a termékeknél** Ez a példa bemutatja, hogyan töröld különböző termékszegmenseknél egy paraméter összes értékét, miközben megőrzöd a paraméterneveket. **Tipp:** ha **csak konkrét paraméterértékeket** szeretnél törölni, vagy **a teljes paramétert a névvel és értékekkel együtt** törölnéd, használd a **Termékparaméterek eltávolítása** szabályt. * **Ú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 a **Termékparaméterek beállítása** opciót. * **Módosítandó elem kiválasztása:** * Az elemeket nem kell kiválasztanod, a Mergado automatikusan kiválasztja. * **Sorok hozzáadása**: * Minden sor 3 oszloppal rendelkezik: * **Lekérdezések** – egy vagy több lekérdezés kiválasztása * **Paraméter** – egy vagy több paraméter beállítása * **Érték** – a paraméter értéke * **Terméklekérdezések**: * A bal oszlopban a **Lekérdezések** mezőben * válassz mentett lekérdezéseket, * **Tipp:** egy vagy több lekérdezést is kiválaszthatsz. * vagy válaszd az **Új lekérdezés létrehozása** opciót. * **Paraméterek beállítása a kiválasztott lekérdezéshez:** * A jobb oldali **Paraméter** oszlopban a legördülő listából válaszd ki a paramétereket, amelyek értékeit törölni szeretnéd, pl. `Térfogat` * több paramétert is választhatsz, mindig egyet egy sorba * A jobb oldali **Érték** oszlopban hagyd üresen a mezőt minden paraméternél, amelynek értékét törölni szeretnéd. * **Paraméterek beállítása további lekérdezésekhez:** * Ismételd meg az előző lépéseket a következő üres sorban. * **Tipp:** a következő sor kitöltésekor automatikusan hozzáadódik egy újabb üres sor. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Paraméterértékek törlése. ## **GYIK** ### **Mire szolgál a Termékparaméterek beállítása szabály?** A szabály lehetővé teszi a termékek **paramétereinek beállítását, módosítását vagy értékeinek törlését**. Minden paraméternek van neve és értéke (pl. *Szín = Piros*). Használható: * hiányzó paraméterek kiegészítésére (pl. *Térfogat*, *Anyag*), * meglévő paraméterek felülírására lekérdezés szerint, * paraméterértékek törlésére a név megtartásával, * értékek automatikus kiegészítésére különböző termékszegmensekhez. ### **Mi a különbség e szabály és a Termékparaméterek eltávolítása szabály között?** * **Termékparaméterek beállítása** – képes hozzáadni, felülírni és törölni **paraméterértékeket** (a név megmarad). * **Termékparaméterek eltávolítása** – eltávolítja a teljes paramétert a névvel és értékekkel együtt, illetve lehetővé teszi egy adott paraméter **kiválasztott értékeinek** eltávolítását. Ha csak az értéket szeretnéd törölni, de a nevet megtartani (pl. üres paraméter), használd a **Termékparaméterek beállítása** szabályt üres **Érték** mezővel. ### **Létrehozhatok új paramétereket a szabállyal?** Igen. Ha a **Paraméter** oszlopba olyan nevet írsz, amely a projektben még nem létezik, a Mergado automatikusan létrehozza az új paramétert. Ha meglévő nevet választasz a legördülő listából, az értéke felülíródik. ### **Milyen formátumot használhatok a paraméterértékekhez?** Az **Érték** mezőben használhatsz: * **szöveges értéket** – pl. `250 ml`, * **változót** – pl. `%volume%`, * **változó és szöveg kombinációját** – pl. `%volume% ml`. Így kombinálhatsz értékeket különböző elemekből, vagy automatikusan egészítheted ki a mértékegységeket. ### **Hogyan működnek a terméklekérdezések ebben a szabályban?** A szabály minden sora három részt tartalmaz: * **Lekérdezés** – meghatározza, mely termékekre vonatkozik a szabály, * **Paraméter** – meghatározza, melyik paramétert kell hozzáadni vagy módosítani, * **Érték** – meghatározza, milyen értéket kell a paraméterhez rendelni. Így egyetlen szabályon belül **különböző paramétereket állíthatsz be különböző termékcsoportokhoz**. ### **Adhatok több paramétert egy lekérdezéshez?** Igen. Ugyanahhoz a lekérdezéshez több sort hozhatsz létre – mindegyiket más paraméternévvel és értékkel. Az utolsó sor kitöltése után automatikusan hozzáadódik egy új üres sor. ### **Törölhető paraméterérték ezzel a szabállyal?** Igen. Ha az **Érték** mezőt üresen hagyod, a Mergado eltávolítja a paraméter tartalmát (értékét), de megtartja a paraméter nevét. Ha a teljes paramétert el szeretnéd távolítani, használd helyette a **Termékparaméterek eltávolítása** szabályt. ### **Használhatok változókat a paraméter nevében is?** Nem. A paraméter nevében csak **szöveget** adhatsz meg – változók itt nem támogatottak. Változókat csak az **Érték** mezőben használhatsz. ### **Milyen típusú paramétereket állíthatok be?** Több típusból választhatsz: * szöveges (pl. *Szín = Kék*), * számértékű (pl. *Tömeg = 250*), * boolean (pl. *Elérhető = true*). A paramétertípust a projekt kimeneti formátuma szerint válaszd – pl. a Google Merchant Center konkrét értékformátumot követel meg. ### **Használható a szabály paraméterek tömeges szerkesztéséhez?** Igen. Az **Intelligens beillesztés mód** jelölőnégyzettel az értékeket például Google Sheetsben készítheted elő, majd tömegesen beillesztheted a szabályba. A Mergado automatikusan a megfelelő mezőkbe osztja szét az értékeket a táblázat struktúrája szerint. ### **Mi van, ha csak egy adott kategóriához vagy márkához akarok paramétert beállítani?** Hozz létre egy **Terméklekérdezést**, amely csak ezeket a termékeket tartalmazza (pl. `CATEGORYTEXT CONTAINS "Táskák"`). Ezután a szabályt csak erre a lekérdezésre alkalmazd – a többi termék változatlan marad. ### **Kombinálható a szabály más szabályokkal?** Igen. Leggyakoribb kombinációk: * **Termékparaméterek eltávolítása** – paraméterek megtisztítása az új beállítás előtt, * **Felülírás** – paraméterértékek beillesztése a terméknevekbe, * **Betűméret módosítása** – szöveges paraméterek formátumának módosítása. ### **Hogyan ellenőrizhetem, hogy a paraméterek helyesen beállítódtak?** A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után ellenőrizd az eredményt: * a termékek előnézetében, vagy * a **Szabályok áthaladása** funkcióval, ahol látod, milyen paraméterek lettek hozzáadva vagy módosítva. --- ## [Szabály: Termékparaméterek eltávolítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-termekparameterek-eltavolitasa/) # **Szabály: Termékparaméterek eltávolítása** Ez a szabály a termékparaméterek konkrét értékeinek eltávolítására szolgál a feedből, vagy a teljes paraméter törlésére a nevével és összes értékével együtt. Hasznos az adatok tisztításához, amikor nem kívánt vagy elavult információkat kell eltávolítani. ## **Extra funkciók** * Paraméternevek automatikus javaslatai * Értékek tömeges másolása például Google Sheetsből * Paramétertípus kiválasztásának lehetősége * Több sor hozzáadásának lehetősége ## **Konkrét példák** ### **1. példa: Konkrét paraméter eltávolítása a feedből** Ez a példa bemutatja, hogyan távolítsd el egy paraméter értékét a feedből, például a **Fekete** és **Fehér** értékeket a **Szín** paraméterből. * **Ú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ály típusa** mezőben válaszd a **Paraméterértékek eltávolítása** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Paraméter kiválasztása:** * A **Paraméter** mezőben írd be vagy válaszd ki a listából azt az elemet, amelynek paraméterét el szeretnéd távolítani. * Ebben a példában ez a Szín érték lesz. * **Tipp**: A **Bal oldal előkitöltése** segítségével betöltheted az adott projekt összes paraméterét. Ez a lépés ebben a példában nem szükséges, mert csak konkrét értéket választunk ki. * **Eltávolítandó értékek kiválasztása:** * Az **Alábbi értékek eltávolítása** mezőben add meg az eltávolítandó értéket. * Például: **Fekete** és **Fehér**. * **Tipp:** Használhatsz változót vagy változó és szöveg kombinációját is. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Szín paraméter értékeinek eltávolítása. ### **2. példa: A paraméter (Szín) összes értékének eltávolítása a feedből** Ez a példa bemutatja, hogyan távolítsd el a **Szín paraméter összes értékét** a feedből, beleértve a paraméter nevét is. * **Ú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ály típusa** mezőben válaszd a **Paraméterértékek eltávolítása** lehetőséget. * **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** azokhoz a termékekhez, amelyekre alkalmazni szeretnéd a szabályt. * **Paraméter kiválasztása:** * A **Paraméter** mezőben add meg vagy válaszd ki a legördülő listából azt a paramétert, amelynek összes értékét el szeretnéd távolítani. * Ebben a példában ez a **Szín** paraméter lesz. * **Eltávolítandó értékek kiválasztása:** * Az **Alábbi értékek eltávolítása** mezőben nem kell konkrét értékeket megadni. * Elég bejelölni az **Összes érték eltávolítása** jelölőnégyzetet, amivel eltávolítod a paraméter összes értékét. * **Szabály elnevezése** * Az utolsó lépésben add meg a **szabály nevét**, például Szín paraméter eltávolítása. ### **A szabály további felhasználása** * Fizetési módok eltávolítása * Szállítók eltávolítása * Beszállítóra vagy más nem kívánt értékekre hivatkozó összes paraméter eltávolítása. ## **GYIK** ### **Mire szolgál a Termékparaméterek eltávolítása szabály?** Ez a szabály lehetővé teszi **konkrét paraméterértékek** vagy **teljes paraméterek nevükkel és értékeikkel együtt** történő eltávolítását. Például a következőkhöz használatos: * elavult információk eltávolítása (pl. régi színek, elavult méretek), * feed megtisztítása felesleges vagy duplikált paraméterektől, * beszállítói paraméterek eltávolítása, amelyeket nem szeretnél exportálni a kimeneti feedekbe. ### **Mi a különbség e szabály és a Termékparaméterek beállítása szabály között?** * **Termékparaméterek eltávolítása** → törli a teljes paramétert vagy egy konkrét paraméterértéket. * **Termékparaméterek beállítása** → lehetővé teszi az **érték** kiegészítését, módosítását vagy törlését (a név megmarad). Ha csak az értéket szeretnéd „kiüríteni", de a paramétert megtartani, használd a **Termékparaméterek beállítása** szabályt üres **Érték** mezővel. ### **Eltávolíthatók csak kiválasztott értékek egy paraméteren belül?** Igen. Az **Alábbi értékek eltávolítása** mezőben add meg a törlendő értékeket (pl. *Fekete*, *Fehér*). Több értéket is megadhatsz, illetve használhatsz **változót** vagy **szöveg és változó kombinációját**. ### **Hogyan távolíthatom el egy paraméter összes értékét?** Ha a teljes paramétert szeretnéd eltávolítani az összes értékével, jelöld be az **Összes érték eltávolítása** jelölőnégyzetet. Ezzel a Mergado eltávolítja a feedből a teljes paramétert, például a teljes blokkot: `` `Szín` `Fekete` `` A szabály alkalmazása után a *Szín* paraméter a termékben már egyáltalán nem szerepel. ### **Eltávolíthatok ezzel a szabállyal egyszerre több paramétert?** Igen. Csak adj hozzá több sort a szabályhoz – mindegyiket egy paraméterhez. A **Bal oldal előkitöltése** gombbal betöltheted a projekt összes paraméterét, majd kiválaszthatod a törlendőket. ### **Eltávolíthatók ezzel a módszerrel például szállítók vagy fizetési módok?** Igen. Ha a szállítók vagy fizetési módok paraméterekként vannak tárolva (pl. *Szállítás = Magyar Posta*), ugyanúgy eltávolíthatod őket. A **Paraméter** mezőben válaszd ki a megfelelő nevet (pl. *Szállítás*, *Fizetés*). ### **Eltávolíthatja a szabály az összes paramétert a teljes feedből?** Igen, de óvatosan kell eljárni. Ha betöltöd az összes paramétert a **Bal oldal előkitöltése** funkcióval, és minden sornál bejelölöd az **Összes érték eltávolítása** opciót, a Mergado eltávolítja az összes paramétert az összes termékből. ### **Befolyásolja a paraméterek eltávolítása az XML feed szerkezetét?** Nem. A szabály csak az elemek tartalmával dolgozik – az XML szerkezet érvényes és sértetlen marad. Csak a konkrét `` blokkok kerülnek eltávolításra (a névvel és értékekkel együtt). ### **Alkalmazható a szabály csak egy adott termékcsoportra?** Igen. Létrehozhatsz **Terméklekérdezést** (pl. beszállító, márka vagy kategória szerint), és a szabályt csak ezekre a termékekre alkalmazhatod. A többi termék változatlan marad. ### **Ellenőrizhetem, mi lett eltávolítva?** Igen. A **szabályok mentése és alkalmazása** vagy a **feed újragenerálása** után ellenőrizd a változásokat a **Termékek** oldalon, illetve használd a **Szabályok áthaladása** funkciót. Ez a funkció lehetővé teszi az eredeti és az eredmény verzió összehasonlítását, és pontosan láthatod, mely paraméterek lettek eltávolítva. --- ## [UTM paraméterek beállítása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-utm-parameterek-beallitasa/) # **UTM paraméterek beállítása** Ez a szabály azon webáruházaknak ideális, amelyek a kampányok teljesítményét szeretnék mérni a Google Analyticsben vagy más elemző eszközökben. ## **Extra funkciók** * Ékezetek engedélyezése az értékekben * Minden mezőbe szöveg és változó is beilleszthető ## **Konkrét példák** ### **1. példa: UTM paraméterek hozzáadása a termékek URL-jéhez a forgalom méréséhez** * **Ú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 **UTM paraméterek beállítása** opciót. * **Termékek kiválasztása**: * A **Szűrők** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját terméklekérdezést. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki az URL-t tartalmazó elemet (pl. `g:link`, `URL`). * **Töltsd ki a kampányparamétereket** (egyik mező sem kötelező): * Minden mezőbe fix szöveget vagy változót is beírhatsz – a változók dinamikusan veszik fel az értékeket termékenként. * **utm\_id** – egyedi kampányazonosító, pl. `123` * **utm\_source** – forgalom forrása, pl. `Google` * **utm\_medium** – marketing médium, pl. `cpc`, `email` * **utm\_campaign** – kampány neve, pl. `nyari_kirusitas_2025` * **utm\_source\_platform** – multiplatformos hirdetési hálózat, pl. `instagram_ads` * **utm\_content** – linkek megkülönböztetéséhez, pl. `gomb_kedvezmeny` * **utm\_term** – hirdetésben használt kulcsszó, pl. `termek-xyz` * **Ékezetek engedélyezése**: * Jelöld be, ha a paraméterekben ékezeteket szeretnél megtartani. Ha kikapcsolva hagyod, a Mergado automatikusan ékezet nélküli karakterekre alakítja át. * **Szabály elnevezése**: * Add meg a szabály nevét. ### **2. példa: Más elemek értékeinek beillesztése az UTM paraméterekbe (pl. `custom_label` értéke)** * **Ú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 **UTM paraméterek beállítása** opciót. * **Termékek kiválasztása**: * A **Szűrők** mezőben válaszd az **Összes termék** opciót, vagy hozz létre saját terméklekérdezést. * **Módosítandó elem kiválasztása**: * Az **Elem** mezőben válaszd ki az URL-t tartalmazó elemet (pl. `g:link`, `URL`). * **Töltsd ki a kampányparamétereket** (egyik mező sem kötelező): * Változók segítségével más elemek értékeit is beillesztheted: * **utm\_id** – pl. `%id%` * **utm\_source** – pl. `%source%` * **utm\_medium** – pl. `%medium%` * **utm\_campaign** – pl. `%campaign%` * **utm\_source\_platform** – pl. `%source_platform%` * **utm\_content** – pl. `%content%` * **utm\_term** – pl. `%term%` * **Ékezetek engedélyezése**: * Jelöld be, ha a paraméterekben ékezeteket szeretnél megtartani. Ha kikapcsolva hagyod, a Mergado automatikusan ékezet nélküli karakterekre alakítja át. * **Szabály elnevezése**: * Add meg a szabály nevét. ## **GYIK** ### **Mire szolgál ez a szabály?** A szabály **automatikusan UTM paramétereket ad a termékek URL-jéhez**. Segít a kampányok teljesítményének követésében **Google Analytics, GA4, Sklik, Meta Ads** és más eszközökben. Alkalmazható az összes termékre vagy csak kiválasztott terméklekérdezésekre. ### **Milyen UTM paramétereket állíthatok be?** A szabály az összes szokásos paramétert támogatja: * `utm_id` – egyedi kampányazonosító, pl. `123` * `utm_source` – forgalomforrás, pl. `Google`, `Facebook` * `utm_medium` – marketing médium, pl. `cpc`, `email` * `utm_campaign` – kampány neve, pl. `nyari_kirusitas_2025` * `utm_source_platform` – platform, pl. `instagram_ads` * `utm_content` – link megkülönböztetése, pl. `gomb_kedvezmeny`, `banner` * `utm_term` – kulcsszó a kampányban, pl. `termek-xyz` ### **Használhatok változókat az UTM paraméterekben?** Igen. Minden mezőbe **változót** is megadhatsz – pl. `%id%`, `%source%`, `%medium%`, `%campaign%`, `%content%`. A paraméterek így dinamikusan más elemek értékeivel egészülnek ki. Például: `utm_campaign = %custom_label_0%` → a Mergado behelyettesíti a `custom_label_0` elem értékét. ### **Mi történik, ha a változó üres?** Ha a változó üres, a Mergado az adott UTM paramétert **nem adja hozzá** az URL-hez. Ha az üres változó két másik érték között van, az eredményben **dupla szóközök** maradhatnak. Ilyen esetben ajánlott utána a **Keresés és csere** szabályt alkalmazni a `\s{2,}` kifejezéssel, és egyetlen szóközre cserélni. ### **Hogyan adódnak hozzá az UTM paraméterek az URL-ekhez?** A Mergado automatikusan felismeri, hogy az URL tartalmaz-e már kérdőjelet (`?`): * ha **nem tartalmaz**, a paramétereket `?utm_source=...` formában adja hozzá, * ha **tartalmaz**, az új paramétereket `&utm_medium=...` formában fűzi hozzá. Ezzel az eredmény URL mindig érvényes marad. ### **Engedélyezhetem az ékezetek használatát a paraméterekben?** Igen. Az **Ékezetek engedélyezése** opció bejelölésével megtarthatod az ékezeteket a paraméterek értékeiben. Ha kikapcsolva hagyod (ajánlott), a Mergado automatikusan **ékezet nélküli ASCII** karakterekre konvertálja – pl. `paprikás` → `paprikas`. ### **Hogyan alkalmazom a szabályt csak bizonyos termékekre?** A **Szűrők** mezőben válaszd ki a megfelelő terméklekérdezést (pl. `Nyari_akcio`) – az UTM paraméterek csak az abba tartozó termékekre alkalmazódnak. A többi termék változatlan marad. ### **Mi van, ha az URL már tartalmaz UTM paramétereket?** Ha az URL már tartalmaz UTM paramétereket, a Mergado az új értékeket **nem adja hozzá újra**, hanem **felülírja a meglévőket**. Ezzel elkerüli a duplikációkat és megőrzi a tiszta URL-struktúrát. ### **Használható más elemző rendszerekhez is?** Igen. Az UTM paraméterek minden rendszerben szabványosak. Használhatod őket **GA4, Meta Ads, Sklik, TikTok Ads, Heureka konverziómérés** és más platformokhoz is. ### **Hogyan ellenőrzöm, hogy a szabály helyesen alkalmazódott?** A szabály mentése és alkalmazása után ellenőrizd az eredményt: * a **termék előnézetében** (URL elem), vagy * a **Szabályok áthaladása** funkcióval, ahol látod, hogyan adódtak hozzá a paraméterek. Érdemes a helyes szintaxist a **Google Campaign URL Builder** segítségével is ellenőrizni. ### **Kombinálható más szabályokkal?** Igen, gyakran használják együtt: * **Felülírás** – az URL módosítása az UTM paraméterek hozzáadása előtt, * **Keresés és csere** – az URL megtisztítása nemkívánatos karakterektől, * **Ékezetek eltávolítása** – ha az exportplatform nem engedélyezi az ékezeteket a linkekben. ### **Ütemezhető a szabály rövid távú kampányokhoz?** Igen. Az **Időzítő** funkcióval meghatározhatod az időszakot, amikor a szabály aktív legyen – pl. egy marketing kampány időtartama alatt. Az időszak lejártával a paraméterek hozzáadása automatikusan leáll. --- ## [Variánsok összevonása](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szabaly-variansok-osszevonasa/) # **Variánsok összevonása** Ez a szabály **termékvariánsok egyesítésére** szolgál – a bemeneti feedben önálló termékekként megjelenő variánsokat (pl. különböző színek, méretek) egyetlen fő termék (ún. *Master termék*) alá csoportosítja. A variánsokat leggyakrabban az **`ITEMGROUP_ID`** elem azonosítja. Az összevonás egyszerűsíti a feedet és biztosítja a termékek helyes megjelenítését a célplatformokon. ## **Extra funkciók** * Közös elemek kiválasztása (csak kiválasztott formátumokhoz) * Bal oldal előkitöltése * Több sor hozzáadásának lehetősége * A szabály csak kiválasztott formátumokhoz érhető el: * Shoptet Komplett és Beszállítói * Upgates Termékek * Woocommerce CSV * Shopify CSV * Samba.ai ## **Konkrét példák** ### **1. példa: Variáns termékek összevonása Heureka feedből Shoptet számára** * **Ú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ály típusa** mezőben válaszd a **Variánsok összevonása** lehetőséget. * **Elem a Master tétel kiválasztásához**: * Ez a mező határozza meg, melyik elemet használja a rendszer a fő (*Master*) tétel azonosításához. * A Master tétel az, amely alá a többi variáns csoportosítva lesz. * Az **`ITEM_ID`** esetén pl. a **legalacsonyabb ID-val** rendelkező tétel kerül fő tételként kiválasztásra. * **Esetünkben:** `ITEM_ID` * *Tipp: a Master tétel az összevonás után fő termékként jelenik meg – a többi variáns csatolva marad, de önállóan nem jelenik meg.* * **Elem a csoportosító kóddal**: * Ez az elem határozza meg, **mely termékek tartoznak egy variánscsoportba**. * Minden variánsnak **azonos értékkel** kell rendelkeznie ebben az elemben. * Leggyakrabban az **`ITEMGROUP_ID`** elemet használják. * **Esetünkben:** `ITEMGROUP_ID` * *Tipp: pl. egy póló S, M, L méretváltozatai mind ugyanazzal az `ITEMGROUP_ID`-vel rendelkeznek.* * **Variánst alkotó paraméterek**: * A **Variánst alkotó paraméterek** legördülőből válaszd ki az összes paramétert, amelyek a variánsokat alkotják – pl. Szín, Méret. * *Tipp: a mező többszörös kiválasztást támogat.* * **Variánst alkotó paraméterek maximális száma**: * A **Variánst alkotó paraméterek maximális száma** legördülőből válaszd ki, hány paraméter alkotja a variánst – pl. 2. * **Közös elemek kiválasztása**: * A **Haladó beállítások** részben válaszd ki azokat az elemeket, amelyek **közösek az adott termék összes variánsánál**. * Ezek az elemek az összevonás után **csak a Master tételnél** kerülnek rögzítésre, a variánsoknál nem ismétlődnek. * Például: `CATEGORYTEXT, DESCRIPTION, IMGURL` * Az **Elem** mezőben (bal oszlop) válaszd ki a legördülőből a közös elemet. * Több elem hozzáadásához adj hozzá új sorokat. * A **Művelet típusa** mezőben (jobb oszlop) határozd meg, hogyan viselkedjen a Mergado különböző értékek esetén: * **Átvétel a master tételből** – csak a fő tétel értékét veszi át, a többit elveti. * Pl. `CATEGORYTEXT` vagy `DESCRIPTION`, ha az érték azonos az összes variánsnál. * **Értékek összevonása és duplikátumok eltávolítása** – az összes egyedi értéket átveszi és listává egyesíti. * Pl. `IMGURL`, ha a variánsoknak különböző képeik vannak és mindet meg szeretnéd tartani. * *Tipp: ez a szekció csak XML feedek variánsainak összevonásánál érhető el (Shoptet, Upgates, Samba AI).* * *Tipp: a Mergado automatikusan kiválasztja az elemeket, elég csak ellenőrizni a beállítást.* * **Szabály elnevezése**: * Add meg a **szabály nevét**, például „Variánsok összevonása". ## **GYIK** ### **Mire szolgál ez a szabály?** A szabály lehetővé teszi **több termékvariáns egyesítését egyetlen fő termékké (Master termékké)**. Elsősorban akkor hasznos, amikor a feedben a variánsok (pl. különböző színek, méretek) önálló termékekként jelennek meg, és egy termék alá kell csoportosítani őket. ### **Milyen formátumokhoz érhető el a szabály?** A szabály csak variánsokkal dolgozó formátumokhoz érhető el: * **Shoptet** (Komplett és Beszállítói feed) * **Upgates Termékek** * **WooCommerce CSV** * **Shopify CSV** * **Samba.ai** Ha más formátumhoz van szükséged erre a funkcióra, írj nekünk a mergado@mergado.hu címre. ### **Mit jelent a Master tétel és hogyan határozódik meg?** A Master tétel a **fő termék**, amely alá az összes variáns csoportosítva lesz. A *Master tétel kiválasztásához használt elem* mezőben adod meg, melyik elem alapján határozódik meg a fő tétel – leggyakrabban a **legalacsonyabb ID-val** rendelkező vagy a feedben elsőként szereplő variáns lesz az. ### **Mire szolgál a csoportosító kóddal rendelkező elem?** Ez az elem (leggyakrabban `ITEMGROUP_ID`) határozza meg, **mely termékek tartoznak egy variánscsoportba**. Minden variánsnak azonos kóddal kell rendelkeznie – pl. egy póló S, M, L méretei ugyanazzal az `ITEMGROUP_ID`-vel rendelkeznek. ### **Mi történik, ha egyes termékeknél hiányzik az `ITEMGROUP_ID`?** Az ilyen termékek **nem kerülnek összevonásra**, mert a Mergado nem tudja felismerni az összetartozásukat. Érdemes előre ellenőrizni, hogy az `ITEMGROUP_ID` minden variánsnál ki van töltve. ### **Hogyan állítsam be a variánst alkotó paramétereket?** A **Variánst alkotó paraméterek** mezőben válaszd ki az összes attribútumot, amelyek szerint a variánsok különböznek – pl. *Szín*, *Méret*, *Anyag*. A mező **többszörös kiválasztást** támogat, egyszerre több paramétert is megadhatsz. ### **Mire való a Variánst alkotó paraméterek maximális száma?** Meghatározza, hány paramétert vesz figyelembe a variánsok csoportosításánál. Ha a variánsoknak két tulajdonságuk van (pl. szín és méret), állítsd **2**-re. ### **Mit csinál a Közös elemek kiválasztása szekció?** Azon elemeket határozza meg, amelyek **azonosak az összes variánsnál** és csak a Master terméknél kell megőrizni – pl. `CATEGORYTEXT`, `DESCRIPTION`, `BRAND`. Ezek az értékek csak a fő termékbe kerülnek, hogy ne ismétlődjenek feleslegesen minden variánsnál. ### **Mi a különbség az Átvétel a master tételből és az Értékek összevonása és duplikátumok eltávolítása műveletek között?** * **Átvétel a master tételből:** csak a fő termék értékét veszi át, a többi variánsét figyelmen kívül hagyja. Szövegekhez és kategóriákhoz ajánlott. * **Értékek összevonása és duplikátumok eltávolítása:** az összes variáns egyedi értékeit egyesíti – pl. képek (`IMGURL`). ### **Használható a szabály variánsok nélküli termékekre is?** Igen, de nincs hatása – a csoportosító kód nélküli termékek változatlanok maradnak. A szabály csak azokra a tételekre alkalmazódik, amelyek megfelelnek a közös kód feltételének. ### **Mi történik, ha a variánsoknak különböző értékeik vannak egy közösnek jelölt elemben?** A beállított művelettől függ: * **Átvétel a master tételből** esetén a Mergado csak a Master termék értékét őrzi meg. * **Értékek összevonása és duplikátumok eltávolítása** esetén a Mergado az összes értéket egy listába egyesíti és eltávolítja a duplikátumokat. ### **Hogyan ellenőrzöm, hogy az összevonás helyesen történt?** A szabály mentése és alkalmazása után nyisd meg a kimeneti feedet, és ellenőrizd, hogy a termékek helyesen csoportosultak-e a Master termék alá. ### **Használható a szabály variáns képek összevonására is?** Igen. Az **Értékek összevonása és duplikátumok eltávolítása** beállítással az összes variáns kép URL-jét egy `IMGURL` elembe egyesítheted. Ezzel a fő termék az összes releváns képpel rendelkezni fog. ### **Mit tegyek, ha a variánsok nem párosulnak helyesen?** Ellenőrizd, hogy: * minden variánsnak azonos `ITEMGROUP_ID`-je van, * a variánsparaméterek ki vannak töltve és megfelelnek a feed értékeinek, * a szabályban helyesen van beállítva a Master tétel eleme. Ha a probléma fennáll, tesztelj kevesebb termékkel egy külön projektben. ### **Eltávolíthatók az összevonás után az eredeti variánsok a feedből?** Igen. A Mergado **automatikusan elrejti** őket – a kimeneten csak a Master termék marad. A variánsok a projektben referencia céljából megmaradnak, de a kimeneti feedbe már nem kerülnek be. ### **Exportálható az összevonás eredménye ellenőrzésre?** Igen. Nyisd meg a kimeneti feedet, és ellenőrizd, hogy a termékek helyesen csoportosultak-e a Master termék alá. ### **Kombinálható ez a szabály a Számítás vagy Felülírás szabállyal?** Igen. A **Variánsok összevonása** szabály a szabályok sorrendjében mindig az utolsó – először módosulnak az elemek értékei, és csak utána történik az összevonás. --- ## [Százalékos kedvezmény számítása és szűrése](https://help.mergado.com/hu/mergado-editor/szabalyok/szabalykonyvtar/szazalekos-kedvezmeny-szamitasa-szurese/) # **Százalékos kedvezmény számítása és szűrése** Ez az útmutató végigvezet a százalékos kedvezmény kiszámításán az eredeti és az akciós ár között, és megmutatja, hogyan szűrj termékeket a kedvezmény alapján. A feedben szükséged van egy elempárra – például Google formátumban: * eredeti ár: `g:price` * akciós ár: `g:sale_price` Ezekből az értékekből könnyen kiszámíthatod a kedvezmény mértékét százalékban, és felhasználhatod feed módosításokhoz, exportokhoz vagy szűréshez (pl. csak a > 10%-os kedvezményű termékek megjelenítése). **Kedvezmény képlete:** `((eredeti ár - akciós ár) / eredeti ár) * 100` --- ## **1. lépés: Kedvezmény mentése új elembe** Szeretnéd a kedvezményt közvetlenül a feedben saját elemként tárolni? Kövesd ezeket a lépéseket: 1. **Hozz létre új elemet** Lépj az **Elemek → Új elem hozzáadása** menüpontra (a gomb az elemlista alatt található). **Elem neve:** `KEDVEZMENY` (vagy pl. `DISCOUNT_PERCENTAGE`). 2. **Hozz létre „Számítás" szabályt** Nyisd meg: **Szabályok → Új szabály → Számítás**. * **Szabály neve:** „Kedvezmény számítása". * **Célelem:** `KEDVEZMENY`. * **Számítási képlet:** `((%g:price% - %g:sale_price%) / %g:price%) * 100` * **Javaslat:** állítsd be a kerekítést egész számra. 3. **Mentsd el és alkalmazd a szabályokat.** 4. **Ellenőrizd az eredményt (példa)** * `g:price = 1000` * `g:sale_price = 750` → a `KEDVEZMENY` elem értéke **25** lesz. --- ## **2. lépés: Termékek szűrése kedvezmény alapján új elem nélkül** Csak gyorsan szeretnél kedvezmény alapján szűrni? Használd a számítást közvetlenül a **lekérdezésben (MQL)** – új elem nem szükséges. **Példa lekérdezés > 10%-os kedvezményhez:** `([g:price] - [g:sale_price]) / [g:price] * 100 > 10` Ez a lekérdezés megtalálja az összes terméket, amelynek kedvezménye nagyobb, mint 10%. --- ## **Tippek** * **A Mergado lekérdezései tudnak számolni.** Matematikai műveleteket közvetlenül használhatsz a feltételekben – nem csak statikus értékeket. Ez hasznos kedvezmények vagy ár-érték arányok ellenőrzéséhez további elemek létrehozása nélkül. * **Árrés számítása hasonlóan a kedvezményhez.** Ha a feedben van beszerzési és eladási ár, kiszámíthatod a százalékos árrést: `((%g:price% - %PURCHASE_PRICE%) / %g:price%) * 100` Hozz létre új **Számítás** szabályt (pl. a `MARGIN_PERCENTAGE` elembe), vagy használd közvetlenül a **lekérdezésekben** a megadott százaléknál magasabb árrésű termékek szűréséhez. --- ## **GYIK** ### **Mi a helyes képlet a kedvezmény kiszámításához?** `((eredeti ár - akciós ár) / eredeti ár) * 100` ### **Létre kell hoznom új elemet a kedvezmény szerinti szűréshez?** Nem szükséges. Használd a számítást közvetlenül az MQL lekérdezésben, pl.: `([g:price] - [g:sale_price]) / [g:price] * 100 > 10` ### **Hol hozok létre új elemet a kedvezményhez?** Az **Elemek → Új elem hozzáadása** menüpontban. Javasolt név: `KEDVEZMENY` (vagy `DISCOUNT_PERCENTAGE`). ### **Hogyan állítsam be a szabályt a kedvezmény elembe történő kiszámításához?** **Szabályok → Új szabály → Számítás**, név „Kedvezmény számítása", célelem `KEDVEZMENY`, képlet: `((%g:price% - %g:sale_price%) / %g:price%) * 100`. Javasoljuk egész számra kerekíteni. ### **Kiszámíthatom a százalékos árrést is?** Igen. Használd: `((%g:price% - %PURCHASE_PRICE%) / %g:price%) * 100` Akár új szabályként egy elembe (pl. `MARGIN_PERCENTAGE`), akár közvetlenül a lekérdezésekben. --- ## [Google feed validátorok – hibák és megoldások (1. rész)](https://help.mergado.com/hu/termekadatok-auditja/google-validatorok/google-validatorok-1/) # **Google feed validátorok – hibák és megoldások (1. rész)** Az alábbi táblázat a **Mergado Audit** Google feed validátorainak első részét tartalmazza. Minden sor egy konkrét feedhibát ír le a jelentésével és a javasolt javítással. | Hiba | Leírás és javítás | |:------|:------------| | A BARCODE Elem érvénytelen értéket tartalmaz | A BARCODE Elem érvénytelen értéket tartalmaz. | | Az EAN Elem érvénytelen értéket tartalmaz | Az EAN az áru egyedi numerikus kódja (vonalkód). A Heureka az EAN-13 formátumot támogatja (13 számjegy). Kis számú termék esetén kézi szerkesztéssel javíthatod. Nagyobb mennyiségnél használd a Keresés és csere, Felülírás vagy Adatfájl importálása típusú Szabályt. | | Az ean Elem érvénytelen értéket tartalmaz | Az EAN az áru egyedi numerikus kódja. 8 vagy 12–14 számjegyből áll. | | Az EANCODE Elem érvénytelen értéket tartalmaz | Az Árukereső az EAN-13 formátumot támogatja (13 számjegy). Kis számú termék esetén kézi szerkesztéssel javíthatod. Nagyobb mennyiségnél használd a Keresés és csere, Felülírás vagy Adatfájl importálása típusú Szabályt. | | Az ean Elem érvénytelen értéket tartalmaz | Az ean Elem az áru egyedi numerikus kódját tartalmazza. 8 vagy 13 számjegyből áll. | | A G:GTIN Elem értékének helytelen a formátuma | A g:gtin a termékek egyedi azonosítója. A Google Shopping feedben 0, 8, 12, 13 vagy 14 karaktert tartalmazhat. Kis számú termék esetén kézi szerkesztéssel javíthatod. Nagyobb mennyiségnél használd a Keresés és csere, Felülírás vagy Adatfájl importálása típusú Szabályt. | | A gtin Elem értékének helytelen a formátuma | A gtin a terméked egyedi azonosítója. 0, 8, 12, 13 vagy 14 karaktert tartalmazhat. | | A GTIN Elem értékének helytelen a formátuma | A GTIN a terméked egyedi azonosítója. 0, 8, 12, 13 vagy 14 karaktert tartalmazhat. | | A G:GTIN Elem értékének helytelen a formátuma | A G:GTIN a terméked egyedi azonosítója. 0, 8, 12, 13 vagy 14 karaktert tartalmazhat. | | Az ISBN Elem érvénytelen értéket tartalmaz | Az ISBN a könyvek egyedi azonosítója. A Heureka az ISBN-10 és ISBN-13 formátumokat támogatja. Kis számú termék esetén kézi szerkesztéssel javíthatod. Nagyobb mennyiségnél használd a Keresés és csere vagy Adatfájl importálása típusú Szabályt. | | A StructuredId Elem értékének helytelen a formátuma | A StructuredId a terméked egyedi azonosítója. 0, 8, 12, 13 vagy 14 karaktert tartalmazhat. | | A PRODUCTNO Elem érvénytelen értéket tartalmaz | A PRODUCTNO Elem érvénytelen értéket tartalmaz. | | A gtin Elem értékének helytelen a formátuma | 0, 8, 12, 13 vagy 14 karaktert tartalmazhat. | | A PRODUCTNAME Elem nem megengedett értéket tartalmaz | A PRODUCTNAME Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A CATEGORY Elem nem megengedett értéket tartalmaz | A CATEGORY Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A DESCRIPTION Elem nem megengedett értéket tartalmaz | A DESCRIPTION Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | Az EAN Elem nem megengedett értéket tartalmaz | Az EAN Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | Az ITEMGROUP_ID Elem nem megengedett értéket tartalmaz | Az ITEMGROUP_ID Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | Az ITEM_ID Elem nem megengedett értéket tartalmaz | Az ITEM_ID Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A MANUFACTURER Elem nem megengedett értéket tartalmaz | A MANUFACTURER Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A PRODUCTNAME Elem nem megengedett értéket tartalmaz | A PRODUCTNAME Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A PRODUCTNO Elem nem megengedett értéket tartalmaz | A PRODUCTNO Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A SEO_PREFIX Elem nem megengedett értéket tartalmaz | A SEO_PREFIX Elemben nem lehetnek nem törhető szóközök (&nbsp;). | | A DELIVERY_DATE Elem értéke a 8 napos határértéken van | A Heureka a szállítási időt kerekíti. Érdemes megvizsgálni, hogy korábban feladható-e az áru. Használd a Tömeges felülírás értékek szerint vagy Keresés és csere Szabályt. | | A DELIVERY_DATE Elem értéke a 4 napos határértéken van | A Heureka a szállítási időt kerekíti. Érdemes megvizsgálni, hogy korábban feladható-e az áru. | | A DELIVERY_DATE Elem értéke határértéken van | A Zboží.cz a szállítási időt kerekíti. Érdemes megvizsgálni, hogy korábban feladható-e az áru. | | Az Elem nem megengedett értéket tartalmaz | Ne adj meg linkeket más oldalakra. Nem tartalmazhat: akció, szállítás, garancia stb. | | Az áru valószínűleg elfogyott | A DESCRIPTION Elemben olyan kulcsszavak találhatók, amelyek arra utalnak, hogy a termék elfogyott. Ha tényleg elfogyott, a Termék elrejtése Szabállyal távolítsd el. | | A G:TITLE Elem nem megengedett értéket tartalmaz | A g:title nem tartalmazhat promóciós üzeneteket (ingyenes szállítás, kedvezmény, akciós ár stb.). A Keresés és csere Szabállyal távolíthatod el. | | A TITLE Elem nem megengedett értéket tartalmaz | A G:TITLE Elemben nem szerepelhetnek promóciós információk. | | A G:TITLE Elem nem megengedett értéket tartalmaz | A g:title nem tartalmazhat URL linkeket. A Keresés és csere Szabállyal távolíthatod el. | | A GIFT Elem nem megengedett értéket tartalmaz | A GIFT Elem nem tartalmazhatja a „kedvezmény" szót. A Heureka szerint az ajándék nem lehet kedvezmény vagy szolgáltatás. | | Az ITEM_TYPE Elem „bazar" értéket tartalmaz | A „Bazar" érték használt áru értékesítését jelöli. Fontold meg elrejtésüket: 1. Hozz létre Lekérdezést (ITEM_TYPE = „Bazar"), 2. Adj hozzá Termék elrejtése Szabályt. | | A NAME Elem nem megengedett értéket tartalmaz | Nem tartalmazhat: „kedvezmény", „akció", „ingyen", „ingyenes", „árengedmény", „kiárusítás", „árleszállítás". A Keresés és csere Szabállyal távolíthatod el. | | Az áru disztribúcióját ismeretlenként adod meg | A Disztribúció paraméter jelzi a célpiacot. Ellenőrizd, hogy szándékos-e. A Felülírás vagy Keresés és csere Szabállyal módosíthatod. Útvonal: PARAM { PARAM_NAME = "Distribuce" } | VAL | | A PARAM_NAME Elem nem megengedett értéket tartalmaz | A paraméternevek nem tartalmazhatnak linkeket. A Keresés és csere Szabállyal távolíthatod el. Útvonal: PARAM | PARAM_NAME | | A PARAM paraméter nem megengedett értéket tartalmaz | A paraméterértékek nem tartalmazhatnak idegen weboldalak címeit. Útvonal: PARAM | VAL | | A PRODUCTNAME Elem nem megengedett szavakat vagy karaktereket tartalmaz | Nem tartalmazhat „ajándék", „szállítás", „©", „™" jeleket. A Keresés és csere Szabállyal távolíthatod el. | | A PRODUCT Elem nem megengedett értéket tartalmaz | Nem tartalmazhat „részlet", „akciós ár", „kedvezmény", „bónusz", „ingyenes szállítás" stb. A Keresés és csere Szabállyal távolíthatod el. | | A TITLE Elem nem megengedett értéket tartalmaz | Nem tartalmazhat promóciós üzeneteket. Ellenőrizd és távolítsd el. | | A PRODUCTNAME Elem nem megengedett értéket tartalmaz | A terméknév nem tartalmazhat: akció, kedvezmény stb. | | A Termeknev Elem nem megengedett értéket tartalmaz | Nem tartalmazhat promóciós kifejezéseket: „áron alul", „legjobbár", „bónusz", „ingyenes", „kedvezmény", „garancia" stb. | | A CATEGORYTEXT Elem linket tartalmaz | A kategorizációs útvonal nem tartalmazhat linkeket. A Keresés és csere Szabállyal távolíthatod el. | | A PRODUCT Elem linket tartalmaz | A PRODUCT Elem értéke nem tartalmazhat linkeket. A Keresés és csere Szabállyal távolíthatod el. | | A PRODUCTNAME Elem linket tartalmaz | A PRODUCTNAME Elem az áru azonosítására szolgál, nem tartalmazhat URL linket. | | A TITLE Elem URL linket tartalmaz | A TITLE Elem az áru azonosítására szolgál, nem tartalmazhat URL linket. | | A VISIBILITY Elem 0 értéket tartalmaz | A 0 érték azt jelenti, hogy a termék nem jelenik meg a hirdetésben. | | A CATEGORYTEXT Elem érvénytelen elválasztót tartalmaz | A CATEGORYTEXT Elem érvénytelen elválasztót tartalmaz. | | A CATEGORYTEXT Elem többször fordul elő | A CATEGORYTEXT Elem többször fordul elő. | | A CATEGORYTEXT Elem felesleges elválasztókat tartalmaz | A CATEGORYTEXT Elem felesleges elválasztókat tartalmaz. | | A CATEGORYTEXT Elem csak egy értéket tartalmaz | A teljes kategória-útvonalat kell tartalmaznia az alkategóriákkal együtt. | | A CATEGORYTEXT Elem érvénytelen értékkel rendelkezik | Az Elemnek az áru kategóriáját kell jelölnie az alkategóriákkal együtt. | | A CATEGORY Elem érvénytelen elválasztót tartalmaz | A CATEGORY Elem érvénytelen elválasztót tartalmaz. | | A CATEGORY Elem többször fordul elő a feedben | Csak egyszer fordulhat elő. | | A CATEGORY Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A CATEGORY Elem csak egy kategóriát tartalmaz | Adj hozzá további kategóriákat. | | A CATEGORY Elem érvénytelen értéket tartalmaz | A Zboží.cz kategóriafájából a teljes útvonalat kell megadni. | | Az fb_product_category Elem érvénytelen elválasztót tartalmaz | Az fb_product_category Elem érvénytelen elválasztót tartalmaz. | | Az fb_product_category Elem többször fordul elő a feedben | Csak egyszer fordulhat elő. | | Az fb_product_category Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | Az fb_product_category Elem csak egy kategóriát tartalmaz | Adj hozzá további kategóriákat. | | Az fb_product_category Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A product_type Elem érvénytelen elválasztót tartalmaz | A product_type Elem érvénytelen elválasztót tartalmaz. | | A product_type Elem többször fordul elő a feedben | Csak egyszer fordulhat elő. | | A product_type Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A product_type Elem csak egy kategóriát tartalmaz | Adj hozzá további kategóriákat. | | A product_type Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A G:GOOGLE_PRODUCT_CATEGORY Elem érvénytelen elválasztót tartalmaz | A G:GOOGLE_PRODUCT_CATEGORY Elem érvénytelen elválasztót tartalmaz. | ## **GYIK** ### **Mi az a Mergado Audit, és mire szolgálnak a validátorok?** A Mergado Audit automatikusan ellenőrzi a termékfeeded adatait, és figyelmeztet a hibákra. A validátorok konkrét feedhibákat írnak le, megmagyarázzák a jelentésüket, és javaslatot adnak a javításra. ### **Hogyan javítsam a hibás EAN/GTIN kódokat?** Kis számú termék esetén kézi szerkesztéssel javíthatod az Editorban. Nagyobb mennyiségnél használd a Keresés és csere, Felülírás vagy Adatfájl importálása típusú Szabályt. ### **Mit jelent a „nem megengedett értéket tartalmaz" figyelmeztetés?** Az adott Elemben tiltott tartalom található – például promóciós üzenet a termék nevében, nem törhető szóközök, URL linkek vagy a „kedvezmény" szó az ajándék mezőben. A Keresés és csere Szabállyal eltávolíthatod. ### **Hogyan oldjam meg a kategória-elválasztó hibákat?** A kategóriaszintek elválasztójaként a megfelelő jelet kell használni (pl. „|" a Heurekánál). Ha más jelet használsz, a Keresés és csere Szabállyal cserélheted le, vagy a Tömeges kategória-átnevezés Szabályt alkalmazhatod. --- ## [Google feed validátorok – hibák és megoldások (2. rész)](https://help.mergado.com/hu/termekadatok-auditja/google-validatorok/google-validatorok-2/) # **Google feed validátorok – hibák és megoldások (2. rész)** Az alábbi táblázat a **Mergado Audit** Google feed validátorainak második részét tartalmazza. Minden sor egy konkrét feedhibát ír le a jelentésével és a javasolt javítással. | Hiba | Leírás és javítás | |:------|:------------| | A G:GOOGLE_PRODUCT_CATEGORY Elem többször fordul elő a feedben | Csak egyszer fordulhat elő. | | A G:GOOGLE_PRODUCT_CATEGORY Elem felesleges elválasztókat tartalmaz | Felesleges kategória-elválasztók találhatók, valószínűleg a végén. Távolítsd el. | | A G:GOOGLE_PRODUCT_CATEGORY Elem csak egy kategóriát tartalmaz | Csak egy kategóriát tartalmaz, amit a kereső nem engedélyez. Adj hozzá további kategóriákat. | | A G:GOOGLE_PRODUCT_CATEGORY Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd, hogy érvényes taxonómiát használ-e, és elegendő számú kategóriát tartalmaz-e. | | A GOOGLE_PRODUCT_CATEGORY Elem érvénytelen elválasztót tartalmaz | A GOOGLE_PRODUCT_CATEGORY Elem érvénytelen elválasztót tartalmaz. | | A GOOGLE_PRODUCT_CATEGORY Elem többször fordul elő a feedben | Csak egyszer fordulhat elő. | | A GOOGLE_PRODUCT_CATEGORY Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A GOOGLE_PRODUCT_CATEGORY Elem csak egy kategóriát tartalmaz | Adj hozzá további kategóriákat. | | A GOOGLE_PRODUCT_CATEGORY Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A CATEGORYTEXT Elem érvénytelen elválasztót tartalmaz | A kategóriaszintek elválasztójaként a függőleges vonalat (\|) kell használni. Ha más jelet használsz, a Keresés és csere Szabállyal cserélheted le. | | A CATEGORYTEXT Elem többször fordul elő | A Heureka csak az első CATEGORYTEXT Elemet dolgozza fel termékenként. A második és további előfordulásokat a Felülírás Szabállyal törölheted. Elem útvonal: CATEGORYTEXT { @@POSITION > 1 } | | A CATEGORYTEXT Elem felesleges elválasztókat tartalmaz | A kategória-elválasztó (\|) csak a kategóriák között szerepelhet. Javítsd a Keresés és csere Szabállyal (pl. \|\| cseréje \|-ra), vagy használd a Tömeges kategória-átnevezés Szabályt. | | A CATEGORYTEXT Elem csak egy értéket tartalmaz | A CATEGORYTEXT Elemnek a legmélyebb alkategóriáig vezető teljes kategória-útvonalat kell tartalmaznia, \| jellel elválasztva. Használd a Tömeges kategória-átnevezés Szabályt. | | A CATEGORYTEXT Elem érvénytelen értékkel rendelkezik | A CATEGORYTEXT Elemnek a legmélyebb alkategóriáig vezető teljes útvonalat kell tartalmaznia. Használd a Tömeges kategória-átnevezés Szabályt. | | A Kategoria Elem érvénytelen elválasztót tartalmaz | A Kategoria Elem érvénytelen elválasztót tartalmaz. | | A Kategoria Elem többször fordul elő a feedben | Csak egyszer fordulhat elő. | | A Kategoria Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A Kategoria Elem csak egy kategóriát tartalmaz | Adj hozzá további kategóriákat. | | A Kategoria Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A PRODUCT_TYPE Elem érvénytelen elválasztót tartalmaz | A PRODUCT_TYPE Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a PRODUCT_TYPE Elemet | Csak egyszer fordulhat elő. | | A PRODUCT_TYPE Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A PRODUCT_TYPE Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A PRODUCT_TYPE Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A G:PRODUCT_TYPE Elem érvénytelen elválasztót tartalmaz | A G:PRODUCT_TYPE Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a G:PRODUCT_TYPE Elemet | Csak egyszer fordulhat elő. | | A G:PRODUCT_TYPE Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A G:PRODUCT_TYPE Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A G:PRODUCT_TYPE Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A G:PRODUCT_TYPE Elem érvénytelen elválasztót tartalmaz | A G:PRODUCT_TYPE Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a G:PRODUCT_TYPE Elemet | Csak egyszer fordulhat elő. | | A G:PRODUCT_TYPE Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A G:PRODUCT_TYPE Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A G:PRODUCT_TYPE Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A google_product_category Elem érvénytelen elválasztót tartalmaz | A google_product_category Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a google_product_category Elemet | Csak egyszer fordulhat elő. | | A google_product_category Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A google_product_category Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A google_product_category Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A product_type Elem érvénytelen elválasztót tartalmaz | A product_type Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a product_type Elemet | Csak egyszer fordulhat elő. | | A product_type Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A product_type Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A product_type Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A google_product_category Elem érvénytelen elválasztót tartalmaz | A google_product_category Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a google_product_category Elemet | Csak egyszer fordulhat elő. | | A google_product_category Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A google_product_category Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A google_product_category Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A product_type Elem érvénytelen elválasztót tartalmaz | A product_type Elem érvénytelen elválasztót tartalmaz. | | A feed többször tartalmazza a product_type Elemet | Csak egyszer fordulhat elő. | | A product_type Elem felesleges elválasztókat tartalmaz | Távolítsd el a felesleges elválasztókat. | | A product_type Elem csak egy értéket tartalmaz | Adj hozzá további kategóriákat. | | A product_type Elem érvénytelen értéket tartalmaz vagy túl rövid | Ellenőrizd a taxonómiát és a kategóriák számát. | | A CATEGORYTEXT Elem érvénytelen elválasztót tartalmaz | A CATEGORYTEXT Elem érvénytelen elválasztót tartalmaz. | | A CATEGORYTEXT Elem többször fordul elő | A CATEGORYTEXT Elem többször fordul elő. | | A CATEGORYTEXT Elem felesleges elválasztókat tartalmaz | A CATEGORYTEXT Elem felesleges elválasztókat tartalmaz. | | A CATEGORYTEXT Elem csak egy értéket tartalmaz | A CATEGORYTEXT Elem csak egy értéket tartalmaz. | | A CATEGORYTEXT Elem érvénytelen értéket tartalmaz vagy túl rövid | A CATEGORYTEXT Elem érvénytelen értéket tartalmaz vagy túl rövid. | | A PRODUCT Elem nem tartalmazza a PRODUCTNAME Elem értékét | A PRODUCT Elemnek tartalmaznia kellene az áru nevét a jelzőkkel együtt, például „ajándék mellé", „+ tok" stb. A Heurekán az árak összehasonlításánál jelenik meg. | | A G:TITLE Elem nem tartalmaz szöveget | A g:title az áru pontos neve. A névnek tartalmaznia kell legalább néhány betűt. Kis számú termék esetén kézi szerkesztéssel javíthatod. Nagyobb mennyiségnél használd a Tömeges értékmásolás vagy Adatfájl importálása Szabályt. | | A PRODUCT Elem nem tartalmaz betűt | A PRODUCT az áru bővített neve. A névnek tartalmaznia kell legalább néhány betűt. Használd a Tömeges értékmásolás vagy Felülírás Szabályt. | | A PRODUCTNAME Elem nem tartalmaz betűt | A PRODUCTNAME az áru pontos neve. A névnek tartalmaznia kell legalább néhány betűt. Használd a Tömeges értékmásolás, Adatfájl importálása Szabályt, vagy a Pairing Bear, Heureka Watchdog bővítményeket. | | A TITLE Elem nem tartalmaz szöveget | A TITLE Elemnek az áru nevének és gyártójának szöveges leírását kell tartalmaznia. | | Az actionFlagActive Elem nem megengedett értéket tartalmaz | Az actionFlagActive Elemnek 0 vagy 1 értéket kell tartalmaznia. | | Az ACTIVE Elem nem megengedett értéket tartalmaz | Az ACTIVE Elemnek true vagy false értéket kell tartalmaznia. | | Az ADULT Elem nem megengedett értéket tartalmaz | Az ADULT Elemnek 0 vagy 1 értéket kell tartalmaznia. | | Az adult Elem nem megengedett értéket tartalmaz | Az adult Elemnek 0 vagy 1 értéket kell tartalmaznia. | | Az ALLOWS_IPLATBA Elem nem megengedett értéket tartalmaz | Az ALLOWS_IPLATBA Elemnek 0 vagy 1 értéket kell tartalmaznia. | ## **GYIK** ### **Mit tegyek, ha egy Elem „többször fordul elő a feedben"?** Az adott Elem csak egyszer fordulhat elő termékenként. A második és további előfordulásokat a Felülírás Szabállyal törölheted, az Elem útvonalban a pozíciót megadva (pl. CATEGORYTEXT { @@POSITION > 1 }). ### **Hogyan javítsam a felesleges elválasztókat a kategória Elemekben?** A Keresés és csere Szabállyal cseréld le a felesleges elválasztókat (pl. „||" cseréje „|"-ra), vagy használd a Tömeges kategória-átnevezés Szabályt. ### **Mit jelent, ha egy Elem „csak egy értéket tartalmaz"?** A kategória Elemnek a legmélyebb alkategóriáig vezető teljes útvonalat kell tartalmaznia, elválasztójelekkel tagolva. Adj hozzá további kategóriákat a Tömeges kategória-átnevezés Szabállyal. ### **Mit jelent a „nem megengedett értéket tartalmaz" boolean típusú Elemeknél?** Az olyan Elemek, mint az ACTIVE, ADULT vagy ALLOWS_IPLATBA, csak meghatározott értékeket fogadnak el (pl. 0/1 vagy true/false). Használd a Felülírás vagy Keresés és csere Szabályt a javításhoz. --- ## [256 MB feletti feedek kezelése az Auditban](https://help.mergado.com/hu/termekadatok-auditja/mergado-audit/feed-audit-meretkorlat/) # **256 MB feletti feedek kezelése az Auditban** A Mergado Audit jelenleg csak **256 MB**-nál kisebb fájlokat tud feldolgozni. Ha a feed túllépi ezt a limitet, az Audit nem indul el, és a **„Megengedett maximális fájlméret túllépve"** hibaüzenet jelenik meg. Az alábbiakban bemutatjuk, hogyan kicsinyítheted vagy oszthatod fel a feedet, hogy az Auditot el tudd indítani. ## **Lépésről lépésre** ### **1) Feed felosztása kisebb részekre** Ha az infrastruktúrád lehetővé teszi, oszd fel az eredeti feedet két kisebb részre, és mindegyiket külön ellenőrizd az Auditban. **Fontos:** * Minden feed-résznek **teljes szerkezettel** kell rendelkeznie (fejléc és lezárás), hogy az Audit helyesen lefusson. ### **2) Feed ideiglenes kicsinyítése termékek elrejtésével** Ha a felosztás nem lehetséges, kicsinyítsd az adatokat közvetlenül a Mergadóban. **Lépések:** **1. Hozz létre egy Lekérdezést a termékekhez** * Menj a **Termékek** oldalra, és hozz létre egy Lekérdezést nagyjából a termékek feléhez. * A feltételeket a feed szerkezete alapján válaszd ki – pl. **kategória**, **ártartomány** vagy **szám az `ITEM_ID`-ban**. **2. Alkalmazz egy Szabályt az elrejtéshez** * Nyisd meg a **Szabályok** → **Új szabály** menüt. * Szabálytípusként válaszd a **Termék elrejtése** lehetőséget, és alkalmazd a létrehozott Lekérdezésre. **3. Generáld újra a feedet** * **Beállítások** → **Újragenerálás** → **Módosítottak újragenerálása**. **4. Indítsd el az Auditot** * Az Auditot ezen a kicsinyített **kimeneti feeden** végezd el. ### **3) További módszerek a méret csökkentésére** Ha a kimeneti feed még mindig meghaladja a 256 MB-ot: * **Rejts el több terméket** – bővítsd a Lekérdezést további kategóriákkal vagy márkákkal. * **Rejts el nagy Elemeket ideiglenesen**, jellemzően a **`DESCRIPTION`**-t. Ezt az **Elemek** oldalon a jobb oldali **kapcsolóval** teheted meg. > **Tipp:** Az Elemeket csak ideiglenesen rejtsd el az Audit céljából. Az ellenőrzés befejezése után **kapcsold vissza** őket, hogy a feed teljes maradjon az exporthoz. ## **Mikor írj nekünk?** Ha biztos vagy benne, hogy a feed kisebb 256 MB-nál, de az Audit mégis hibát jelez, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre – utánajárunk a problémának. ## **GYIK** ### **Miért nem dolgozza fel az Audit a 256 MB-nál nagyobb feedet?** Az Audit jelenlegi verziója **256 MB**-os limittel dolgozik. Az ennél nagyobb fájloknál a „Megengedett maximális fájlméret túllépve" hibaüzenet jelenik meg. ### **Mit tegyek, ha a feed meghaladja a limitet?** Vagy **oszd fel** a feedet kisebb részekre (mindegyik teljes szerkezettel), vagy a Mergadóban **ideiglenesen kicsinyítsd** termékek vagy kiválasztott Elemek elrejtésével. ### **Hogyan rejtek el ideiglenesen termékeket?** A **Termékek** oldalon hozz létre egy Lekérdezést (pl. kategóriák, árak vagy `ITEM_ID` alapján). A **Szabályok** menüben hozz létre **Új szabályt** → **Termék elrejtése**, és alkalmazd a Lekérdezésre. ### **Hogyan rejtek el konkrét Elemeket (pl. DESCRIPTION)?** Az **Elemek** oldalon használd az adott Elem melletti **kapcsolót**. Az Audit után ne felejtsd el **visszakapcsolni** őket. ### **Újra kell generálnom a feedet a módosítások után?** Igen. Menj a **Beállítások** → **Újragenerálás** → **Módosítottak újragenerálása** menübe, és csak ezután indítsd el az Auditot a kimeneti feeden. ### **Mikor írjak nektek?** Ha a feed **kisebb 256 MB-nál**, de az Audit mégis limittúllépést vagy más hibát jelez, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. --- ## [Termékfeedek technikai ellenőrzése a Mergado Audittal](https://help.mergado.com/hu/termekadatok-auditja/mergado-audit/termekfeed-ellenorzes/) # **Termékfeedek technikai ellenőrzése a Mergado Audittal** A hirdetési rendszerekben (pl. Google, Heureka) való sikeres megjelenéshez a termékadataidnak **pontosnak, teljesnek és érvényesnek** kell lenniük. A feed technikai állapota közvetlenül **befolyásolja a termékek jóváhagyását, párosítását és a kampányok teljesítményét**. **[Mergado Audit](https://audit.mergado.com/) egy ingyenes online eszköz**, amely néhány percen belül megmutatja, milyen állapotban van az XML vagy CSV feeded – és **konkrét javítási javaslatokat ad**. ## **1. Mi az a Mergado Audit?** A Mergado Audit automatikusan elvégzi a termék XML vagy CSV feed technikai ellenőrzését, és feltárja a javítandó hibákat. **A Mergado Audit:** * egyszeri alkalommal betölti az adatfájlodat egy nyilvános URL-ről, * lefuttat rajta egy validátorokon alapuló tesztsorozatot, * kiértékeli a talált hibákat, figyelmeztetéseket és javaslatokat, * konkrét javítási javaslatokat jelenít meg. Az Audit **diagnosztikai eszközként** működik – **nem módosítja az adatokat**, csak elemzi a minőségüket és megfelelőségüket a kiválasztott hirdetési csatorna követelményeinek. Az Audit **nem tár fel minden lehetséges problémát**. A meghatározott validációs szabályok szerinti technikai és formai helyességre fókuszál. Nem értékeli például az üzleti stratégiát, az árak versenyképességét, a termékszövegek minőségét vagy a kampányok teljesítményét. ## **2. Mire szolgál?** Az audit fő célja feltárni azokat a hiányosságokat, amelyek: * a termékek elutasítását okozhatják, * korlátozzák a megjelenésüket a szűrőkben, * rontják a párosítást a konkurens ajánlatokkal, * negatívan befolyásolják a hirdetések teljesítményét. **Gyakorlati előnyök:** * **Kritikus hibák feltárása** – Megtudod, miért utasíthatják el a hirdetési rendszerek (pl. Google, Heureka) a termékeidet. * **Kötelező paraméterek ellenőrzése** – Az Audit vizsgálja a kötelező Elemek meglétét és helyességét (pl. ár, elérhetőség, EAN, URL). * **Adatminőség elemzése** – Nem csak a kötelező Elemek meglétét, hanem az adatok érvényességét is ellenőrzi (pl. ár formátuma, EAN kódok helyessége, URL-ek egyedisége). * **Szűrés és párosítás javítása** – Ellenőrzi, hogy a termékmegjelenést és szűrőkben való láthatóságot befolyásoló paraméterek helyesen vannak-e kitöltve. * **Konkrét javítási javaslatok** – Az eredmények tartalmazzák a probléma leírását és a javasolt megoldást, gyakran dokumentációra vagy videós útmutatókra mutató linkekkel. ## **3. Hogyan működik a Mergado Audit?** **Hol indíthatod az auditot:** * az [audit.mergado.com](https://audit.mergado.com) önálló oldalon, * vagy közvetlenül a Mergado Editor felületéről. **Mi kell az indításhoz:** * Az XML vagy CSV feeded URL-je (**nyilvánosan elérhető**). * **E-mail cím** az eredmények küldéséhez. **Lépések:** 1. Add meg a feed URL-jét. 2. Válaszd ki a célformátumot (pl. Google, Heureka), vagy hagyd, hogy a rendszer automatikusan felismerje. A célformátum kiválasztása fontos, mert minden hirdetési csatornának saját feed-struktúrája, kötelező Elemei és validációs szabályai vannak. Az Auditnak tudnia kell, mely szabályok szerint ellenőrizze az adatokat – a Google feed ellenőrzése más, mint a Heureka feedé. 3. Add meg az e-mail címet, amelyre az eredményeket szeretnéd megkapni. 4. Kattints az *Audit indítása* gombra. A feldolgozás általában **néhány percet** vesz igénybe. Nagyobb feedeknél akár néhány óráig is tarthat (a fájl méretétől és a rendszer terheltségétől függ). ## **4. Eredmények kiértékelése** Az eredmények három súlyossági szintre vannak osztva: 🔴 **Hibák (piros szín)** Súlyos problémák, amelyek a termékek elutasításához vagy helytelen feldolgozáshoz vezethetnek. 🟡 **Figyelmeztetések (sárga szín)** Hiányosságok, amelyek közvetlenül nem akadályozzák a hirdetést, de csökkenthetik a teljesítményt vagy az adatminőséget. 🟢 **Javaslatok (zöld szín)** Tippek a feed további optimalizálásához és a versenyképesség növeléséhez. ## **5. Ár, korlátok és elérhetőség** * **Ár:** **Ingyenes.** * **Regisztráció:** Nem szükséges Mergado-fiók. * **Ismételt használat:** Korlátlanul futtatható. * **Ajánlott gyakoriság:** Legalább havonta egyszer, ideálisan minden nagyobb feed-módosítás után. * **Maximális feedméret:** 256 MB. Ha ennél nagyobb feedet kell ellenőrizned, a teendőket a Mi a teendő, ha a feed nagyobb 256 MB-nál az Audithoz cikkben találod. * **Eredmények elérhetősége:** 10 napig elérhető online. ## **6. Kinek ajánljuk?** * Webáruházaknak, amelyek gyorsan szeretnék ellenőrizni a feed minőségét. * PPC szakembereknek új fiók átvételekor. * Ügynökségeknek, mint belépő diagnosztika egy új projektnél. * Cégeknek, amelyek programozó nélkül szeretnék feltárni a technikai problémákat. ## **7. Speciális auditok** Az alap termékfeed auditon kívül a Mergado speciális eszközöket is kínál, amelyek az e-kereskedelem egyes területeire fókuszálnak. Minden speciális audit **ingyenes**. * **Képaudit ([audit-obrazku.cz](http://audit-obrazku.cz)):** A termékfotók technikai paramétereit ellenőrzi (felbontás, háttér, formátum, URL elérhetőség). Segít megelőzni a képek elutasítását a hirdetési rendszerekben. * **Bidding audit ([bidding-audit.cz](http://bidding-audit.cz)):** A Heurekán futó bidding kampányok kínálatának állapotát vizsgálja. Értékeli a versenyképességet, a párosítást és a stratégia hatékonyságát. * **Árképzési audit ([pricing-audit.cz](http://pricing-audit.cz)):** A Heurekán való árazás hiányosságait tárja fel – összehasonlítja az áraidat a versenytársakkal, és azonosítja a nem párosított termékeket vagy a szélsőséges árú ajánlatokat. ## **Összefoglaló** A Mergado Audit egy ingyenes eszköz az XML és CSV feedek technikai ellenőrzésére. Feltárja a termékek jóváhagyását, párosítását és hirdetési rendszerekben való láthatóságát befolyásoló hibákat, és konkrét javítási javaslatokat ad. Az Audit diagnosztikai eszköz, amely az adatminőségre fókuszál – nem átfogó marketing- vagy stratégiai elemzés. A legnagyobb hasznot akkor hozza, ha az eredményeire további munka épül a kampányokkal, árképzéssel vagy kínálattal kapcsolatban. Ha azt szeretnéd, hogy a hirdetéseid stabil adatokon álljanak, a feed **rendszeres ellenőrzése** legyen az e-kereskedelmi rutinod része. ## **GYIK** ### **Mi az a Mergado Audit?** Egy ingyenes online eszköz a termék XML és CSV feedek technikai ellenőrzésére. Automatikusan elemzi az adatminőséget a kiválasztott hirdetési csatorna (pl. Google, Heureka) szabályai szerint, és konkrét javítási javaslatokat ad. ### **Ingyenes a Mergado Audit?** Igen, teljesen ingyenes. ### **Kell Mergado-fiókom az Audit indításához?** Nem. Az [audit.mergado.com](https://audit.mergado.com) oldalon regisztráció nélkül elindíthatod. ### **Módosítja az Audit a feedem adatait?** Nem. Az Audit csak elemzi és kiértékeli az adatokat – semmilyen változtatást nem végez a feeden. ### **Miért érdemes feed auditot végezni?** A feed állapota befolyásolja a termékek jóváhagyását, szűrőkben való megjelenését, a párosítást és a hirdetések teljesítményét. Az Audit feltárja azokat a problémákat, amelyek fékezhetik vagy blokkolhatják a hirdetést. ### **Milyen hibákat tár fel az Audit?** Az Audit a kiválasztott célplatform (pl. Google, Heureka) szabályai szerint ellenőrzi a feedet. Feltárja például a hiányzó kötelező Elemeket (ár, elérhetőség, EAN, URL), az érvénytelen árformátumot, a hibás EAN kódokat, a duplikált vagy nem működő URL-eket, a feed szerkezeti hibáit és a platform követelményeinek való meg nem felelést. ### **Az Audit az adatminőséget is vizsgálja, vagy csak a meglétüket?** Mindkettőt. Nemcsak azt nézi, hogy az Elem létezik-e, hanem azt is, hogy az értéke érvényes és helyesen formázott-e. ### **Segít az Audit javítani a termékek párosítását?** Igen. A helyesen kitöltött paraméterek ellenőrzése jelentősen javíthatja a párosítást és a szűrőkben való láthatóságot. ### **Hogyan indítom el a Mergado Auditot?** 1. Nyisd meg az [audit.mergado.com](https://audit.mergado.com) oldalt. 2. Add meg a feeded URL-jét. 3. Válaszd ki a célformátumot, vagy hagyd a rendszerre az automatikus felismerést. 4. Add meg az e-mail címet az eredmények küldéséhez. 5. Kattints az *Audit indítása* gombra. ### **Miért kell célformátumot választani?** Minden hirdetési csatornának saját feed-struktúrája és validációs szabályai vannak. Az Auditnak tudnia kell, mely szabályok szerint értékelje az adatokat – a Google feed ellenőrzése más, mint a Heureka feedé. ### **Mi kell az audit indításához?** 1. Nyilvánosan elérhető XML vagy CSV feed URL. 2. E-mail cím az eredmények küldéséhez. ### **Mennyi ideig tart az ellenőrzés?** Általában néhány percig. Nagyobb feedeknél a feldolgozás akár néhány óráig is tarthat, a fájl méretétől és a rendszer terheltségétől függően. ### **Futtathatok auditot ismételten?** Igen, korlátlanul. ### **Milyen gyakran érdemes auditot végezni?** Legalább havonta egyszer, ideálisan minden nagyobb feed- vagy webáruház-módosítás után. ### **Hogyan néznek ki az audit eredményei?** Az eredmények három szintre vannak osztva: 🔴 Hibák – Súlyos problémák, amelyek a termékek elutasítását okozhatják. 🟡 Figyelmeztetések – Hiányosságok, amelyek csökkenthetik a hirdetési teljesítményt. 🟢 Javaslatok – Tippek a további optimalizáláshoz. ### **Meddig érhetők el az eredmények?** 10 napig elérhetők online. ### **Tartalmaznak az eredmények javítási útmutatót?** Igen. Minden talált probléma tartalmazza a leírást és a javasolt megoldást, gyakran dokumentációra vagy videós útmutatókra mutató linkekkel. ### **Mekkora feedet lehet auditálni?** A maximális fájlméret 256 MB. ### **Mi a teendő, ha a feedem nagyobb 256 MB-nál?** A feedet fel kell osztani. A teendőket a Mi a teendő, ha a feed nagyobb 256 MB-nál az Audithoz cikkben találod. ### **Támogatja az Audit az XML és CSV feedeket is?** Igen, mindkét formátumot. ### **Kezdőknek is megfelelő az Audit?** Igen. Az eszközt úgy tervezték, hogy technikai háttér nélkül is könnyen használható legyen. ### **Ügynökségek és PPC szakemberek is hasznát veszik?** Igen. Az Audit ideális belépő diagnosztika egy új projekt átvételekor. ### **Szükségem van programozóra a hibák javításához?** Nem feltétlenül. Sok hiba javítható feed-szerkesztő eszközökkel (pl. a Mergado Editorban). Alapvető szerkezeti problémáknál szükség lehet fejlesztői beavatkozásra. ### **Léteznek más típusú auditok is?** Igen. A Mergado speciális auditokat is kínál: **Képaudit** ([audit-obrazku.cz](http://audit-obrazku.cz)) – a termékfotók technikai paramétereit ellenőrzi (felbontás, formátum, URL elérhetőség, háttér). **Bidding audit** ([bidding-audit.cz](http://bidding-audit.cz)) – a Heurekán futó bidding kampányok állapotát elemzi. **Árképzési audit** ([pricing-audit.cz](http://pricing-audit.cz)) – a Heurekán való árazásra fókuszál, azonosítja a nem párosított termékeket és az árproblémákat. ### **Ingyenesek a speciális auditok?** Igen, minden típusú audit ingyenes. ### **Alkalmas az Audit rendszeres ellenőrzésre?** Igen. A rendszeres futtatás segít a feedet hosszú távon jó állapotban tartani. --- ## [Automatikus tarifaszámítás a Mergadóban](https://help.mergado.com/hu/fiokezeles-es-szamlazas/csomagok-es-szamlazas/automatikus-tarifaszamitas/) # **Automatikus tarifaszámítás a Mergadóban** A webáruházad tarifáját nem tudod kézzel módosítani – ezt a Mergado automatikusan kezeli. A tarifa szintjét a kimeneti feedekben lévő termékek száma határozza meg. A Mergado megvizsgálja, hány Projekted (vagyis Integrációd) van az adott webáruházon belül, és megszámolja az egyes Projektek kimenetén lévő termékeket. Ezeket összeadja, és az eredmény alapján állapítja meg a tarifa típusát. Ha több webáruházad van, a Mergado mindegyikre külön számítja ki a tarifát. A számlán tehát minden webáruház külön tételként jelenik meg. ## **GYIK** ### **Hogyan nézhetem meg az aktuális tarifámat?** Az aktuális tarifát közvetlenül a Mergadóban ellenőrizheted: 1. A Mergado [főoldalán](https://app.mergado.com/) kattints arra a webáruházra, amelynek a tarifáját meg szeretnéd nézni. 2. A **Termékek** oszlop utolsó sorában látod a kimeneten lévő termékek összesített számát – ez alapján határozza meg a Mergado a tarifát. 3. Kattints a fekete sávon az **„i" ikonra**. Itt látod az aktuális tarifát, a termékek limitjét, a számlázási időszakot és az előfizetés lejáratát. Az összes webáruházad tarifáját áttekintheted a **Felhasználói adatok** oldalon is. Ide úgy jutsz el, hogy a jobb felső sarokban a neved melletti nyíl ikonra kattintasz, majd a **Felhasználói adatok** menüpontra. ### **Módosíthatom magam a tarifát?** Nem. A tarifát a Mergado automatikusan határozza meg az adott webáruház kimeneti feedjeiben lévő termékek száma alapján. ### **Hogyan tudom előre megnézni, milyen tarifába kerülök?** Nézd meg az [Árlistát](https://www.mergado.hu/arjegyzek) a weboldalunkon: 1. Válaszd ki, hogy **havi** vagy **éves** számlázásra kéred az árat. 2. Válaszd ki a **pénznemet**. 3. Add meg a webáruházadban lévő **termékek számát**. 4. Add meg az **Integrációk (Projektek) számát**. 5. Máris látod, milyen tarifába fog tartozni a webáruházad. ### **Honnan tudhatom meg, hogy emelkedett a tarifám?** A Mergado e-mailben értesít, amint túlléped az aktuális tarifád limitjét. Ha az értesítés után csökkented a termékszámot vagy törölsz egy Projektet – és így visszakerülsz az alacsonyabb tarifába –, ezt a rövid túllépést nem számlázzuk ki. Ha nem változtatsz, hamarosan számlát küldünk a magasabb tarifáról. ### **Mi történik, ha csökkentem a termékszámot vagy törlök Projekteket?** Ha a termékszám csökkenése miatt alacsonyabb tarifába kerülsz, nem kell semmit tenned. A Mergado automatikusan felismeri a változást, és csökkenti a tarifát. ### **Hogyan számlázódnak a tarifaváltozások?** A Mergado előfizetéses rendszerben számlázódik: * Ha a tarifád **csökken**, az árváltozás a **következő** számlázási időszakban jelenik meg. * Ha a tarifád **nő**, az árváltozás az **aktuális** időszakban érvényes, és a különbözetet külön számlán számlázzuk ki. A különbözeti számlázásról bővebben az ügyfélszolgálat útmutatóiban olvashatsz. ### **Hogyan számítják ki a termékszámot?** A számlázáshoz az adott webáruház összes kimeneti feedjében (Projektjében) lévő termékeket összeadják. **Példa:** Van egy webáruházad három Projekttel: Árukereső (2 000 termék), Árgép.hu (2 000 termék), Google Merchants (1 500 termék). Összesen: 2 000 + 2 000 + 1 500 = 5 500 termék → Basic tarifa (limit: 10 000 termék). ### **Több webáruházam van – összeadódnak a termékek?** Nem. A Mergado minden webáruházra külön számítja a tarifát. Ez az idegen nyelvű változatokra is vonatkozik (pl. .sk / .de / .pl), mivel a Mergado a bemeneti feed domainje alapján határozza meg, mi számít önálló webáruháznak. ### **Hogyan határozódik meg a Mergado bővítmények tarifája?** A Mergado bővítmények fix áron érhetők el – a kimeneti termékszám nem befolyásolja az árat. Az árakat az [Árlistában](https://www.mergado.hu/arjegyzek) vagy a [Mergado Store-ban](https://store.mergado.com/?lang=hu) találod. --- ## [Különbözeti számla a Mergadóban](https://help.mergado.com/hu/fiokezeles-es-szamlazas/csomagok-es-szamlazas/kulonbozeti-szamla/) # **Különbözeti számla a Mergadóban** A Mergado különbözeti számlát állít ki, ha a tarifád az aktuális előfizetési időszakban emelkedik. Ez történhet a termékszám növekedése, új webáruház létrehozása vagy bővítmény aktiválása miatt. ## **Mikor keletkezik különbözeti számla?** A Mergado automatikusan módosítja a tarifát a kimeneti feedek termékszáma alapján: * **Tarifa emelkedése:** Ha a termékszám nő és eléri a következő tarifa küszöbét, a Mergado automatikusan magasabb tarifára vált. A régi és az új tarifa közötti árkülönbséget **különbözeti számlán** számlázzuk ki. * **Tarifa csökkenése:** Ha a termékszám csökken, a Mergado automatikusan alacsonyabb tarifára vált. Az alacsonyabb ár a **következő** számlázási időszaktól érvényes. > **Fontos:** Ha a tarifa csökkent, de a magasabb összegű előlegszámla vagy különbözeti számla már ki lett állítva, a bizonylat módosításához írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ## **Túlfizetés és egyéb különbözetek** * **Túlfizetés:** Ha többet fizettél a szükségesnél, a Mergado automatikusan visszatéríti. Ha inkább a következő időszakra szeretnéd felhasználni, írj a [billing@mergado.com](mailto:billing@mergado.com) címre. * **Számlázási gyakoriság módosítása:** Ha haviról évesre váltasz (20% kedvezmény), a változás az aktuális időszak lejárta után jelenik meg az új számlán. * **Már kiállított számla módosítása:** Előlegszámla (proforma) vagy adóbizonylat módosításához írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ## **GYIK** ### **Mi az a különbözeti számla?** A különbözeti számla a régi és az új tarifa közötti árkülönbséget tartalmazza, amely tarifaváltozás, új webáruház létrehozása vagy bővítmény aktiválása miatt keletkezett. ### **Mikor jelenik meg a tarifaváltozás a számlán?** Ha a tarifa **nő**, az árkülönbség az aktuális időszakban jelenik meg különbözeti számlán. Ha **csökken**, az alacsonyabb ár a következő számlázási időszaktól érvényes. ### **Mi történik, ha emelkedik a tarifám?** Az emelkedés automatikusan érvénybe lép a változás napjától, és különbözeti számlát állítunk ki. ### **Mi történik, ha csökken a tarifám?** A Mergado automatikusan módosítja a tarifát. Ha már ki lett állítva magasabb összegű számla, a módosításhoz írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ### **Mi van, ha túlfizetésem van?** A Mergado automatikusan visszatéríti. Ha a következő időszakra szeretnéd felhasználni, jelezd a [billing@mergado.com](mailto:billing@mergado.com) címen. ### **Módosíthatom a már kiállított számla adatait?** Magad nem – írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ### **Mi történik, ha módosítom a számlázási gyakoriságot?** A változás (pl. haviról éves) az aktuális előfizetési időszak lejárta után jelenik meg az új számlán. --- ## [Számla sztornózása a Mergadóban](https://help.mergado.com/hu/fiokezeles-es-szamlazas/csomagok-es-szamlazas/szamla-sztornozasa/) # **Számla sztornózása a Mergadóban** A Mergadóban a számla sztornózását nem tudod magad elvégezni – ehhez írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ## **Mikor írj nekünk?** ### **Előlegszámla vagy adóbizonylat sztornózása** Ha egy már kiállított előlegszámlát (proforma) vagy adóbizonylatot kell módosítanod vagy sztornóznod (pl. hibás számlázási adatok vagy rossz számlázási időszak miatt), írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. A fiókbeállításokban végrehajtott módosítások csak az **új** számlákon jelennek meg – a már kiállítottakat módosítjuk. ### **Túlfizetés kezelése** Túlfizetés vagy dupla befizetés esetén az összeget automatikusan visszatérítjük. Ha inkább a következő számlázási időszak fedezésére szeretnéd felhasználni, írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ## **Fontos tudnivalók** * A sztornózott bizonylatok **nem jelennek meg** a Számlák szekcióban a fiókodban. * Minden számlázási kérdéssel a [billing@mergado.com](mailto:billing@mergado.com) címen kereshetsz minket. ## **GYIK** ### **Sztornózhatok számlát magam az adminisztrációban?** Nem. Számla sztornózásához vagy módosításához írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ### **Mikor kell nekünk írni?** * Előlegszámla (proforma) vagy adóbizonylat módosítása / sztornózása. * Túlfizetés átvitele a következő számlázási időszakra. ### **Mi történik túlfizetés esetén?** Az összeget automatikusan visszatérítjük. Ha a következő időszakra szeretnéd felhasználni, írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. ### **Hol találom a sztornózott számlát?** A sztornózott bizonylatok nem jelennek meg a fiókod Számlák szekciójában. ### **Hogyan érem el a számlázási támogatást?** Írj a [billing@mergado.com](mailto:billing@mergado.com) címre. --- ## [Számlázási adatok módosítása](https://help.mergado.com/hu/fiokezeles-es-szamlazas/csomagok-es-szamlazas/szamlazasi-adatok-modositasa/) # **Számlázási adatok módosítása** A számlázási adataidat kétféleképpen módosíthatod – attól függően, hogy a jövőbeli vagy a már kiállított számlákat szeretnéd érinteni. ## **Jövőbeli számlák – magad módosíthatod** A [Felhasználói és számlázási adatok](https://accounts.mergado.com/settings/) szekcióban módosíthatod: * Cégnév, cím, adószám * Számlázási e-mail cím * Egyéb kapcsolattartási adatok A [Fizetési beállítások](https://accounts.mergado.com/payment_options/) szekcióban módosíthatod: * Számlázási gyakoriság (havi / éves) > **Fontos:** A módosítások csak az **újonnan kiállított** számlákon jelennek meg. A már kiállított számlákat nem érintik. ## **Már kiállított számlák – támogatás szükséges** Ha egy előlegszámlán (proforma) vagy adóbizonylaton kell módosítanod az adatokat, írj a [billing@mergado.com](mailto:billing@mergado.com) címre. Részletezd, mit szeretnél megváltoztatni és mi intézzük a többit. ## **GYIK** ### **Hogyan módosítom a számlázási adataimat?** A [Felhasználói és számlázási adatok](https://accounts.mergado.com/settings/) szekcióban írd át a megfelelő mezőket, és kattints a **Beállítások mentése** gombra. ### **Hogyan módosítom a számlázási gyakoriságot?** A [Fizetési beállítások](https://accounts.mergado.com/payment_options/) szekcióban válassz havi (1 hónap) vagy éves (12 hónap) számlázást. A változás a következő számlázási időszaktól lép életbe. ### **Mikor jelennek meg a módosítások?** Csak az újonnan kiállított számlákon. A már kiállított számlákat a módosítás nem érinti. ### **Módosíthatom magam a már kiállított számla adatait?** Nem. Ebben az esetben vedd fel velünk a kapcsolatot: [billing@mergado.com](mailto:billing@mergado.com). --- ## [Számlázási gyakoriság módosítása](https://help.mergado.com/hu/fiokezeles-es-szamlazas/csomagok-es-szamlazas/szamlazasi-gyakorisag-modositasa/) # **Számlázási gyakoriság módosítása** A Mergado havi és éves számlázást kínál. Az éves számlázással **20% kedvezményt** kapsz a Mergado tarifára és a bővítményekre is. ## **Számlázás beállítása** 1. A fiókod [Főoldalán](https://accounts.mergado.com/) nyisd meg a [Felhasználói és számlázási adatok](https://accounts.mergado.com/settings/) szekciót – itt add meg a számlázási adataidat. 2. Nyisd meg a [Fizetési beállítások](https://accounts.mergado.com/payment_options/) szekciót, és válaszd ki a **fizetési kaput** (Stripe vagy GoPay) a bankkártyás inkasszóhoz. 3. Ugyanitt válaszd ki a **számlázási időszakot**: * **1 hónap** – havi számlázás * **12 hónap** – éves számlázás (20% kedvezmény) > A módosítások az újonnan kiállított számlákon jelennek meg. ## **Ki módosíthatja a számlázást?** Csak a webáruház **Tulajdonosa** (Owner). A Tulajdonos: * Kezeli a számlázási adatokat és a fizetési gyakoriságot * Hozzáfér a számlákhoz és letöltheti azokat * Beállíthatja vagy törölheti az ismétlődő fizetést (inkasszó) Ha a számlázást másik felhasználóra kell átvinni, add át a Tulajdonos szerepkört – az új Tulajdonos kapja a számlákat az átadás pillanatától. ## **Éves számlázás előnyei** * **20% kedvezmény** a Mergado tarifából * **20% kedvezmény** a Mergado Store bővítményeire A kedvezmény új és meglévő ügyfelekre egyaránt vonatkozik. Ha haviról évesre váltasz, a kedvezmény az aktuális időszak lejárta után jelenik meg. ## **Bővítmények számlázása** A bővítmények számlázása a Mergado tarifával **össze van kapcsolva** – ugyanolyan gyakoriságban számlázódnak. Ha éves számlázást választasz, a bővítmények is évente kerülnek számlázásra. ## **Visszaváltás havi számlázásra** A [Fizetési beállítások](https://accounts.mergado.com/payment_options/) szekcióban módosítsd a számlázási időszakot 1 hónapra. A 20%-os kedvezmény ezzel megszűnik. A változás az aktuális időszak lejárta után lép érvénybe. ## **Mikor írj nekünk?** Bizonyos esetekben a [billing@mergado.com](mailto:billing@mergado.com) címen kell segítséget kérned: * **Már kiállított számla módosítása** – előlegszámla (proforma) adatainak vagy időszakának változtatása. * **Túlfizetés átvitele** – ha nem szeretnéd az automatikus visszatérítést, hanem a következő időszak fedezésére használnád fel. * **Inkasszótól eltérő fizetési mód** – ha a bankkártyás inkasszó nem felel meg. * **Számlázás megszüntetése** – a Mergado fizetett szolgáltatásainak leállítása. ## **GYIK** ### **Hogyan módosítom a számlázási gyakoriságot?** A [Fizetési beállítások](https://accounts.mergado.com/payment_options/) szekcióban válaszd ki az 1 hónapos vagy 12 hónapos időszakot, és kattints a **Beállítások mentése** gombra. ### **Bármikor módosíthatom?** A módosítást az aktuális számlázási időszak végén végezd el – a változás a következő számlázástól érvényes. ### **Ki módosíthatja a számlázást?** Csak a webáruház Tulajdonosa (Owner). ### **Milyen előnye van az éves számlázásnak?** 20% kedvezmény a Mergado tarifára és a bővítményekre egyaránt. ### **Hogyan kapok kedvezményt a bővítményekre?** Állíts be éves számlázást – a kedvezmény automatikusan vonatkozik az összes bővítményre. ### **Mi történik, ha nem fizetem ki a számlát?** A Mergado ideiglenesen kikapcsolja az összes szolgáltatásodat, beleértve a bővítményeket. Fizesd ki a tartozást, majd írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre az újraaktiváláshoz. ### **Módosíthatom a már kiállított számla adatait?** Magad nem – írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre.. ### **Fizethetek inkasszón kívül más módon is?** Igen. Írj a [billing@mergado.com](mailto:billing@mergado.com) címre, és keresünk egy neked megfelelő megoldást. ### **Hogyan szüntethetem meg a Mergado számlázását?** Írj nekünk a [billing@mergado.com](mailto:billing@mergado.com) címre. --- ## [Felhasználói adatok módosítása a Mergado-fiókban](https://help.mergado.com/hu/fiokezeles-es-szamlazas/felhasznaloi-fiok/felhasznaloi-adatok-modositasa/) # **Felhasználói adatok módosítása a Mergado-fiókban** Megváltozott az e-mail címed, telefonszámod, vagy frissítened kell a számlázási adatokat? Ezeket a módosításokat gyorsan elvégezheted közvetlenül a Mergado-fiókodban. Alább megmutatjuk, mit és hol tudsz módosítani. ## **Név, vezetéknév és telefonszám** 1. A Mergado-fiókod [Főoldalán](https://accounts.mergado.com/) nyisd meg a [Felhasználói és számlázási adatok](https://accounts.mergado.com/settings/) szekciót. 2. Módosítsd a nevet, vezetéknevet vagy telefonszámot a megfelelő mezőkben. 3. Kattints az oldal alján a **Beállítások mentése** gombra. ## **E-mail cím** 1. A Mergado-fiókod [Főoldalán](https://accounts.mergado.com/) nyisd meg a [Biztonság](https://accounts.mergado.com/security/) szekciót. 2. Az **E-mail módosítása** részben add meg az új e-mail címet (erre fogod kapni a számlákat és az értesítéseket). 3. Kattints az **E-mail módosítási kérelem küldése** gombra – a változás azonnal érvénybe lép. ## **Jelszó** 1. A Mergado-fiókod [Főoldalán](https://accounts.mergado.com/) nyisd meg a [Biztonság](https://accounts.mergado.com/security/) szekciót. 2. A **Jelszó módosítása** részben töltsd ki az összes mezőt. 3. Kattints a **Jelszó módosítása** gombra – az új jelszó azonnal érvénybe lép. ## **Számlázási adatok** 1. A Mergado-fiókod [Főoldalán](https://accounts.mergado.com/) nyisd meg a [Felhasználói és számlázási adatok](https://accounts.mergado.com/settings/) szekciót. 2. A **Számlázási adatok** részben módosítsd a szükséges mezőket (cégnév, számlázási e-mail, adószám, cím, pénznem, rendelésszám). 3. Kattints az oldal alján a **Beállítások mentése** gombra. > **Tipp:** A **Számlázási e-mail** mezőben több e-mail címet is megadhatsz – így a számlákat közvetlenül a könyvelődnek vagy üzleti partnereidnek is elküldjük. Ha a mezőt üresen hagyod, a számlák a felhasználói e-mail címedre érkeznek. ## **Számlázási időszak** 1. A Mergado-fiókod [Főoldalán](https://accounts.mergado.com/) nyisd meg a [Fizetési beállítások](https://accounts.mergado.com/payment_options/) szekciót. 2. A **Számlázási időszak** részben válassz: **1 hónap** (havi) vagy **12 hónap** (éves, 20% kedvezménnyel). 3. Kattints a **Beállítások mentése** gombra. > **Tipp:** A számlázási időszakot mindig az aktuális időszak végén módosítsd. A változás a következő számlán jelenik meg. Ha egy már kiállított számlán kell adatot módosítanod, írj a [billing@mergado.com](mailto:billing@mergado.com) címre. Ha a Mergado Editorban vagy, a fiókbeállításokhoz a jobb felső sarokban a neved melletti **nyíl ikonra** kattintva jutsz el – válaszd a **Fiókbeállítások** menüpontot. ## **GYIK** ## **Hol módosíthatom a felhasználói adataimat?** A Mergado-fiókod [Főoldalán](https://accounts.mergado.com/) három szekcióban találod a beállításokat: [Felhasználói és számlázási adatok](https://accounts.mergado.com/settings/), [Fizetési beállítások](https://accounts.mergado.com/payment_options/) és [Biztonság](https://accounts.mergado.com/security/). ## **Hogyan módosítom a nevemet vagy telefonszámomat?** A **Felhasználói és számlázási adatok** szekcióban írd át a megfelelő mezőket, majd kattints a **Beállítások mentése** gombra. ## **Hogyan módosítom az e-mail címemet?** A **Biztonság** szekcióban az **E-mail módosítása** részben add meg az új címet, és kattints az **E-mail módosítási kérelem küldése** gombra. A módosítás azonnal érvénybe lép. ## **Hogyan módosítom a jelszavamat?** A **Biztonság** szekcióban a **Jelszó módosítása** részben töltsd ki a mezőket, és kattints a **Jelszó módosítása** gombra. ## **Hogyan jutok el a fiókbeállításokhoz a Mergado Editorból?** Kattints a jobb felső sarokban a neved melletti **nyíl ikonra**, majd válaszd a **Fiókbeállítások** menüpontot. ## **Hogyan módosítom a számlázási adataimat?** A **Felhasználói és számlázási adatok** szekcióban a **Számlázási adatok** részben módosítsd a szükséges mezőket (cégnév, számlázási e-mail, adószám, cím, pénznem, rendelésszám), majd kattints a **Beállítások mentése** gombra. A változás a következő számlán jelenik meg. ## **Küldhetem a számlákat közvetlenül a könyvelőmnek?** Igen. A **Számlázási e-mail** mezőben adj meg annyi e-mail címet, amennyit szeretnél – a számlákat mindegyikre automatikusan elküldjük. ## **Hogyan módosítom a számlázási időszakot?** A **Fizetési beállítások** szekcióban válassz **1 hónapot** (havi) vagy **12 hónapot** (éves, 20% kedvezménnyel), majd kattints a **Beállítások mentése** gombra. A módosítást mindig az aktuális időszak végén végezd el. ## **Mi van, ha egy már kiállított számlán kell módosítanom?** Írj a [billing@mergado.com](mailto:billing@mergado.com) címre. --- ## [Mergado-fiók létrehozása és törlése Google-fiókkal](https://help.mergado.com/hu/fiokezeles-es-szamlazas/felhasznaloi-fiok/mergado-fiok-letrehozasa-torlese-google-fiokkal/) # **Mergado-fiók létrehozása és törlése Google-fiókkal** A **Bejelentkezés Google-fiókkal** gombbal pillanatok alatt létrehozhatsz Mergado-fiókot – nem kell regisztrációs űrlapot kitöltened. Ha később meg szeretnéd szüntetni az összekapcsolást, azt a Google-fiókod beállításaiban teheted meg. ## **Lépésről lépésre** ### **A) Fiók létrehozása / bejelentkezés Google-fiókkal** 1. A Mergado bejelentkezési oldalán kattints a **Bejelentkezés Google-fiókkal** gombra. 2. Add meg a Google-fiókod bejelentkezési adatait (e-mail és jelszó). 3. Sikeres bejelentkezés után a Mergado **Főoldalára** kerülsz. ### **B) Google-összekapcsolás megszüntetése** > **Figyelem:** Az összekapcsolás megszüntetése nem a Mergadóban, hanem a **Google-fiókod beállításaiban** történik. 1. Nyisd meg a **Google-fiókodat**, és menj a **Biztonság** fülre. 2. A jobb oldalon megtalálod a csatlakoztatott alkalmazások és szolgáltatások listáját. Ha nem jelenik meg az összes, kattints az **Összes kapcsolat megjelenítése** lehetőségre. 3. Keresd meg a **Mergado** bejegyzést, és kattints a mellette lévő **nyílra**. 4. Válaszd az **összes kapcsolat törlése** lehetőséget – ezzel megszűnik az összekapcsolás, és **a Mergado-fiókod is törlődik**. ## **Tippek** * A Google-bejelentkezéshez készítsd elő a Google-fiókod **e-mail címét** és **jelszavát**. * Ha nem látod a Mergadót a csatlakoztatott szolgáltatások között, használd az **Összes kapcsolat megjelenítése** gombot. * Az összekapcsolás megszüntetését kizárólag a **Google-fiókban** intézheted – a Mergadóban nem kell semmit tenned. ## **GYIK** ### **Létrehozhatok Mergado-fiókot Google-fiókkal?** Igen. Kattints a **Bejelentkezés Google-fiókkal** gombra, jelentkezz be, és máris a Mergado Főoldalán vagy. ### **Mit kell megadnom a Google-bejelentkezésnél?** A Google-fiókod szokásos adatait: **e-mail cím** és **jelszó**. ### **Hová kerülök bejelentkezés után?** A Mergado **Főoldalára**, ahonnan tovább navigálhatsz. ### **Hogyan szüntetem meg a Google-összekapcsolást?** A **Google-fiókodban** a **Biztonság** fülön nyisd meg a csatlakoztatott alkalmazások listáját, keresd meg a **Mergadót**, és válaszd az **összekapcsolás törlését**. ### **Nem találom a Mergadót a csatlakoztatott alkalmazások között.** Kattints az **Összes kapcsolat megjelenítése** gombra. ### **Mi történik az összekapcsolás törlése után?** Az összekapcsolás megszűnik, és **a Mergado-fiókod is törlődik**. ### **Kell valamit tennem a Mergadóban a fiók törléséhez?** Nem. Mindent a **Google-fiókod beállításaiban** intézhetsz. --- ## [Jogosultságok módosítása a webáruházban](https://help.mergado.com/hu/fiokezeles-es-szamlazas/tulajdonjog-es-jogosultsagok/jogosultsagok-modositasa-webaruhazban/) # **Jogosultságok módosítása a webáruházban** Szeretnéd, hogy valaki más is kezelhesse a webáruházadat a Mergadóban? Vagy csak megtekintési hozzáférést adnál egy partnernek? Ezt a jogosultságok beállításával oldhatod meg. Egyetlen feltétel: a meghívott felhasználónak saját (ingyenes) Mergado-fiókkal kell rendelkeznie. ## **Jogosultsági szintek a Mergadóban** ### **1. Tulajdonos (Owner)** * Neki számlázódnak a webáruház szolgáltatásai. * Teljes hozzáférése van a számlázási adatokhoz, a fizetési beállításokhoz és a számlákhoz. * Jogosultságokat adhat és vehet el (Írás / Olvasás). * Átadhatja a Tulajdonos szerepkört – ezzel automatikusan Írás jogosultságot kap. * Szerkesztheti a webáruház tartalmát. * Egy webáruháznak **csak egy** Tulajdonosa lehet. ### **2. Írás (Write)** * Szerkesztheti a webáruház tartalmát. * Nem fér hozzá a számlázási adatokhoz és a számlákhoz. * Nem adhat jogosultságot másoknak. * Korlátlan számú Írás jogosultságú felhasználó adható egy webáruházhoz. ### **3. Olvasás (Read)** * Megtekintheti a webáruházat, de nem módosíthat semmit. * Korlátlan számú Olvasás jogosultságú felhasználó adható egy webáruházhoz. ## **Írás vagy Olvasás jogosultság kiosztása** Amikor létrehozol egy webáruházat, automatikusan a Tulajdonosa leszel. Ha másoknak is hozzáférést szeretnél adni: 1. Kattints a jobb felső sarokban a neved melletti **nyíl ikonra**, és nyisd meg a **Felhasználói adatok** oldalt. 2. A webáruházak listájában kattints a kiválasztott webáruháznál a **három alak ikonra** – ez a **Felhasználói jogosultságok** szekcióba visz. 3. A **Felhasználó meghívása** részben add meg a felhasználó e-mail címét, válaszd ki a jogosultságot (Írás / Olvasás), és kattints a **Meghívó küldése** gombra. 4. A felhasználó e-mailben kapja meg a meghívót. A jogosultságot akkor kapja meg, amikor elfogadja. Ha nem fogadja el, nem kap hozzáférést. Ezen az oldalon látod az összes felhasználót, akiknek jogosultságot adtál. A **ceruza ikonnal** módosíthatod, a **kuka ikonnal** elveheted a jogosultságukat. ## **Tulajdonos jogosultság átadása** A Tulajdonos szerepkör átadása hasonlóan működik, mint az Írás / Olvasás kiosztása – a különbség az, hogy egy webáruháznak csak egy Tulajdonosa lehet. 1. Győződj meg róla, hogy az új Tulajdonosnak van Mergado-fiókja. 2. A **Felhasználói jogosultságok** szekcióban hívd meg a felhasználót **Tulajdonos** jogosultsággal. 3. Amint elfogadja a meghívót, ő lesz az új Tulajdonos. A te jogosultságod automatikusan **Írásra** változik – szerkesztheted a webáruházat, de a számlázáshoz már nem férsz hozzá. ## **Ki milyen jogosultságot kapjon? – Gyakorlati példák** **Írás jogosultság:** * Munkatárs vagy külső ügynökség kezeli a hirdetéseket – te maradsz a Tulajdonos, neki Írás jogosultságot adsz. * Ügynökség a Tulajdonos (ő számlázza a Mergadót), de te is szerkesztenéd a webáruházat – Írás jogosultságot kapsz. * Alkalmazottként vagy szabadúszóként kezeled valaki feedjeit – Írás jogosultságod van. **Olvasás jogosultság:** * Az ügynökség a Tulajdonos, te csak figyelni szeretnéd a webáruházat módosítás nélkül. * Az üzleti partnered vagy felettesed rálátást szeretne, de nem akar véletlenül sem belenyúlni a beállításokba. **Tulajdonos jogosultság:** * Teljes kontrollt szeretnél: számlázás, jogosultságok, szerkesztés – minden a te kezedben van. * Ügynökségként a teljes kezelést és a Mergado díját is te számlázod az ügyfélnek. ## **Jogosultságok áttekintése** **Kinek adtam jogosultságot?** A **Felhasználói adatok** oldalon a webáruházaid listájából nyisd meg a **Felhasználói jogosultságok** szekciót (három alak ikon). Itt látod az összes jogosultsággal rendelkező felhasználót. **Milyen jogosultságaim vannak?** A **Felhasználói adatok** oldalon látod az összes webáruházat, amelyekhez bármilyen jogosultságod van. ## **GYIK** ### **Milyen jogosultsági szintek vannak a Mergadóban?** Három: **Tulajdonos** (teljes kontroll + számlázás), **Írás** (szerkesztés, számlázás nélkül) és **Olvasás** (csak megtekintés). ### **Kell a meghívottnak Mergado-fiók?** Igen. Minden felhasználónak saját fiókra van szüksége – a regisztráció ingyenes. ### **Hány felhasználó férhet hozzá egy webáruházhoz?** Írás és Olvasás jogosultságból korlátlan számú lehet. Tulajdonos mindig csak egy van. ### **Módosíthatom vagy elvehetem a kiosztott jogosultságot?** Igen, ha a webáruház Tulajdonosa vagy. A **Felhasználói jogosultságok** szekcióban bármikor módosíthatod vagy törölheted a jogosultságokat. ### **Kaphat valaki más hozzáférést az én webáruházamhoz?** Csak a Tulajdonos adhat jogosultságot. Ha te Írás jogosultsággal rendelkezel, nem tudsz másoknak hozzáférést adni. ### **Hogyan fogadom el a meghívót?** E-mailben kapsz egy linket, amelyen keresztül a Mergado-fiókodba jutsz. Ott elfogadod a meghívót, és a jogosultság azonnal aktiválódik. ### **Mi történik a Tulajdonos szerepkör átadása után?** Az új Tulajdonosnak számlázódnak a szolgáltatások. Te automatikusan Írás jogosultságot kapsz – szerkesztheted a webáruházat, de a számlázáshoz és a számlákhoz már nem férsz hozzá. ### **Kezelheti-e egy webáruházat több személy?** Igen. Egy Tulajdonos + korlátlan számú Írás és Olvasás jogosultságú felhasználó. Mindenki a saját Mergado-fiókjából dolgozik. --- ## [Webáruház tulajdonosának módosítása](https://help.mergado.com/hu/fiokezeles-es-szamlazas/tulajdonjog-es-jogosultsagok/webaruhaz-tulajdonos-modositasa/) # **Webáruház tulajdonosának módosítása** Átadnád a webáruházad kezelését egy ügynökségnek? Visszaadod az ügyfélnek? Eladtad a webáruházat? Ezeket a változásokat a Tulajdonos jogosultság átadásával oldhatod meg. ## **Jogosultsági szintek – röviden** A Mergadóban három jogosultsági szint van: **Tulajdonos (Owner)** – Neki számlázódnak a szolgáltatások. Teljes hozzáférése van: számlázás, jogosultságok kezelése, tartalom szerkesztése. Átadhatja a szerepkört – ezzel automatikusan Írás jogosultságot kap. Egy webáruháznak **csak egy** Tulajdonosa lehet. **Írás (Write)** – Szerkesztheti a webáruház tartalmát, de nem fér hozzá a számlázáshoz és nem adhat jogosultságot másoknak. Korlátlan számú felhasználó kaphatja. **Olvasás (Read)** – Csak megtekintheti a webáruházat, módosítani nem tud. Korlátlan számú felhasználó kaphatja. ## **Lépésről lépésre: Tulajdonos jogosultság átadása** Győződj meg róla, hogy az új Tulajdonosnak van Mergado-fiókja. 1. Kattints a jobb felső sarokban a neved melletti **nyíl ikonra**, és nyisd meg a **Felhasználói adatok** oldalt. 2. A webáruházak listájában kattints a kiválasztott webáruháznál a **három alak ikonra** – ez a **Felhasználói jogosultságok** szekcióba visz. 3. A **Felhasználó meghívása** részben add meg az új Tulajdonos e-mail címét, válaszd ki a **Tulajdonos** jogosultságot, és kattints a **Meghívó küldése** gombra. 4. Amint a felhasználó elfogadja a meghívót, ő lesz az új Tulajdonos. A te jogosultságod automatikusan **Írásra** változik – szerkesztheted a webáruházat, de a számlázáshoz már nem férsz hozzá. ## **Lépésről lépésre: Írás vagy Olvasás jogosultság kiosztása** 1. A **Felhasználói jogosultságok** szekcióban add meg a felhasználó e-mail címét. 2. Válaszd ki a jogosultságot (Írás / Olvasás), és kattints a **Meghívó küldése** gombra. 3. A felhasználó e-mailben kapja a meghívót – elfogadás után azonnal megkapja a jogosultságot. A jogosultságokat bármikor módosíthatod vagy elveheted a **ceruza** és **kuka** ikonokkal. ## **GYIK** ### **Milyen jogosultsági szintek vannak a Mergadóban?** Három: **Tulajdonos** (teljes kontroll + számlázás), **Írás** (szerkesztés, számlázás nélkül) és **Olvasás** (csak megtekintés). ### **Hogyan adom át a Tulajdonos szerepkört?** A **Felhasználói jogosultságok** szekcióban hívd meg a felhasználót **Tulajdonos** jogosultsággal. Amint elfogadja a meghívót, ő lesz az új Tulajdonos, te pedig Írás jogosultságot kapsz. ### **Mi történik az átadás után?** Az új Tulajdonosnak számlázódnak a szolgáltatások. Te automatikusan Írás jogosultságot kapsz – szerkesztheted a webáruházat, de a számlázási adatokhoz és a számlákhoz már nem férsz hozzá. ### **Hogyan adhatom át a webáruházat egy ügynökségnek?** Add át a Tulajdonos jogosultságot az ügynökség Mergado-fiókjára. Az ügynökség lesz a Tulajdonos (neki számlázódik a Mergado), te pedig Írás vagy Olvasás jogosultságot kapsz. ### **Mi a teendő, ha eladom a webáruházat?** Add Tulajdonos jogosultságot az új tulajdonosnak. Amint elfogadja, ő veszi át a teljes kontrollt. A te jogosultságodat az új Tulajdonos bármikor módosíthatja vagy eltávolíthatja. ### **Kell a meghívottnak Mergado-fiók?** Igen. Minden felhasználónak saját Mergado-fiókra van szüksége – a regisztráció ingyenes. ### **Visszavonhatom az átadást?** Nem közvetlenül. Miután az új Tulajdonos elfogadta a meghívót, csak ő adhatja vissza neked a Tulajdonos szerepkört. --- ## [Allegro termékkártyák kiegészítése](https://help.mergado.com/hu/mergado-marketplaces/allegro-termekkartyak-kiegeszitese/) # **Allegro termékkártyák kiegészítése** A **Termékkártyák kiegészítése** szekcióban **kötelező paramétereket pótolhatsz az Allegro katalógusában már meglévő termékkártyákon**. Akkor van erre szükség, ha az Allegro rendelkezik termékkártyával az adott termékazonosítóhoz, de a kártya nem teljes – és a hiányzó adatok miatt nem párosítható ajánlat hozzá. Ebbe a szekcióba a Termékkártyák szekcióján keresztül juthatsz el, vagy az alábbi validációs üzenet melletti ikonra kattintva: „**Az Allegro termékkártyán hiányoznak kötelező paraméterek, add hozzá őket a 'Termékkártyák kiegészítése' részen keresztül a 'Termékkártyák' szekcióban**". ## **1. Allegro kategóriák megállapítása** Az első lépés egy folyamat elindítása, amely az érintett termékkártyáknál megállapítja, milyen kategóriában találhatók az Allegrón. Így a Bővítmény a hiányzó paraméterekhez fel tudja kínálni az engedélyezett értékeket: ![image|690x130](upload://qFK9IXlrkTUm1ZWdJqLNAzdev37.png) > Nagyszámú érintett Termék esetén a kategóriák megállapítása eltarthat egy ideig. A kategóriák listája angol nyelven jelenik meg, mivel az Allegro ebben a formában küldi el őket. A paraméterek viszont azon a piacon lesznek pótolva, amelyen értékesítesz. ## **2. Hiányzó paraméterek pótlása** A kategóriára kattintva megjelenik azon Termékek listája, amelyekhez az adott kategóriában pótolni kell a paramétereket. A hiányzó paramétert piros háttér jelzi. A kitöltése után elérhetővé válik a **„Termékkártyák kiegészítésének indítása"** gomb: ![image|690x208](upload://AkIs9iD7QZurd8jvHf83Edihvha.png) ## **3. A paraméter-kiegészítés eredménye** - Ha a paramétert sikeresen pótoltad, a Termék eltűnik a táblázatból, és az ajánlat automatikusan csatlakozik a javított kártyához. - Ha az Allegro hibát ad vissza, a táblázatban megjelenik egy felkiáltójel ikon a hibaüzenettel. Javítsd a paraméter értékét, majd indítsd újra a termékkártya kiegészítését. ## **GYIK** ### **Mikor szükséges a termékkártya kiegészítése?** Akkor szükséges, ha az Allegro katalógusában már létezik termékkártya az adott Termékhez, de hiányoznak róla kötelező paraméterek. Ilyenkor az ajánlat nem párosítható a kártyával, amíg a hiányzó adatokat nem pótolod. ### **Miért jelennek meg angol nyelven az Allegro kategóriák?** Az Allegro ebben a formában küldi el a kategóriákat. A paraméterek viszont azon a piacon lesznek pótolva a termékkártyán, amelyen értékesítesz – ez tehát nem okoz problémát. ### **Mi történik a sikeres kiegészítés után?** Ha a paramétert sikeresen pótoltad, a Termék eltűnik a táblázatból, és az ajánlat automatikusan csatlakozik a javított termékkártyához. ### **Mit tegyek, ha hibát kapok a kiegészítés során?** A táblázatban megjelenő felkiáltójel ikonra kattintva olvashatod a hibaüzenetet. Javítsd a paraméter értékét az üzenet alapján, majd indítsd újra a termékkártya kiegészítését. --- ## [Elérhetőségi Feed](https://help.mergado.com/hu/mergado-marketplaces/elerhetosegi-feed/) # **Elérhetőségi Feed** ## **Mi az elérhetőségi Feed** Az elérhetőségi Feed egy fájl, amely aktuális információkat tartalmaz a Webáruház Termékeinek raktári készletéről és elérhetőségéről. ## **Helyes elérhetőségi Feed felépítése** A helyes elérhetőségi Feednek a következő kulcsinformációkat kell tartalmaznia: - Termékazonosító - Darabszám raktáron > A formátum eltérhet attól függően, melyik platformnak szól a Feed (pl. Heureka vs. Mall). ## **Heureka elérhetőségi Feed** A Heureka elérhetőségi Feednek a következő struktúrával kell rendelkeznie: ```xml 13 2011-09-11 13:00 2 2011-09-11 18:00 ``` ## **Mall elérhetőségi Feed** A Mall elérhetőségi Feed hasonló struktúrával rendelkezik: ```xml 1 5 true ``` A legfontosabb elemek: - **`item id/ID`**: Ez az elem az elérhetőségi Feed egy adott Termékét képviseli, ahol az **`id`** attribútum a Termék egyedi azonosítójaként szolgál. Ennek PONTOSAN MEG KELL EGYEZNIE a Termék ID-jával a Termék Feedben, különben az elérhetőség nem párosítható helyesen. - **`stock_quantity/IN_STOCK`**: Ez az elem tartalmazza az adott Termék aktuális raktárkészletének darabszámát. ## **Az elérhetőségi Feed forrásai** 1. Ellenőrizd, hogy a Webáruház-rendszered automatikusan generálja-e az elérhetőségi Feedet. 2. Ha nem, manuálisan létrehozhatod a Mergado Editor segítségével. > Újdonságként használhatod a `Mergado Marketplaces` Feed Formátumot is, amely Termék és elérhetőségi Feedként is szolgál. Így nem szükséges két külön Feed a Mergado Editorban, elég egyetlen egy. :bulb: További információkat a Mergado Marketplaces Feed Formátum cikkben találsz. ## **Az elérhetőségi Feed a Webáruházban** ## **Shoptet** 1. A Shoptet adminisztrációjában menj az **Összekapcsolások → Heureka** szekcióba. 2. Válaszd az **XML feedek** lehetőséget. 3. Keresd meg az **Elérhetőségi XML feed** szekciót. 4. Másold ki a generált Feed URL-t. 5. Ezt az URL-t használhatod elérhetőségi Feedként a Mergado Marketplaces-ben vagy más szolgáltatásokban. :information_source: **További információkat a Shoptet oldalain [itt](https://podpora.shoptet.cz/heureka-xml-feedy/) találsz.** ![image|690x347](upload://lRHLASD033anVPPwfphqpCOEUpT.jpeg) ## **UPgates** - Az elérhetőségi Feed eléréséhez **aktiválnod** kell a **Heureka** kiegészítőt (ingyenes). - A Webáruházadban nyisd meg a **Kiegészítők** szekciót, és keresd meg a **Heureka** kiegészítőt. - Kattints az **Aktiválás** gombra. - Menj a **Kiegészítők → Heureka** szekcióba. - Ebben a szekcióban megtalálod az **Elérhetőségi feed** részt a generált Feed URL-lel. - Másold ki az URL-t, és használd elérhetőségi Feedként a Mergado Marketplaces-ben vagy más szolgáltatásokban. :information_source: **További információkat az UPgates oldalain [itt](https://www.upgates.cz/a/export-produktu-na-heureku) találsz.** ![image|690x348](upload://7shxo6JQGulZWn58VokszfYV4yq.jpeg) ![image|690x103](upload://6EtBtj1b7eXmBKEmGnlAWvwTTeX.png) > A képernyőképen egy teszt Webáruház látható. A valós Webáruházadban az elérhetőségi export URL-t kínál. ## **Eshop-rychle** - Az elérhetőségi Feed automatikusan generálódik, megtalálod a **Webáruház → Export → Termékexport** menüben. - A **Portál** szekcióban válaszd a **heureka.cz elérhetőség** lehetőséget. - Generáld le a Feedet, majd másold ki az URL-t. - Ezt az URL-t használhatod elérhetőségi Feedként a Mergado Marketplaces-ben vagy más szolgáltatásokban. :information_source: **További információkat az Eshop-rychle oldalain [itt](https://helpdesk.eshop-rychle.cz/docs/export-import/export-do-porovnavacu-zbozi/) találsz.** ![image|690x344](upload://k8IDlrAdqaN30SvSXg9Wx0FekB0.jpeg) ## **WooCommerce** A WooCommerce közvetlenül nem kínál elérhetőségi Feed generálást a Heureka vagy Mall számára, de a [Toret](https://toret.cz/produkt/xml-feedy-pro-porovnavace-zbozi/ref/68/) vagy [WPify Woo Feedy](https://wpify.io/dokumentace/wpify-woo-feedy/#kontakt) pluginok segíthetnek ebben. ## **FASTCentrik** Az elérhetőségi Feedet könnyedén legenerálhatod az **XML feedek** szekcióban. ## **Az elérhetőségi Feed biztonsága** > A Feed Webáruházból történő generálásakor figyelj a hozzáférési beállításokra. Egyes Webáruházak automatikusan zárolhatják a Feedeket – fontos ellenőrizni és nyilvánosan elérhetőre állítani őket. Ha a Mergado Marketplaces Bővítményben az „*Hiba történt az elérhetőségi Feed letöltésekor, győződj meg róla, hogy a fájl elérhető*" hibaüzenettel találkozol, valószínűleg az elérhetőségi Feed védett, és a Bővítmény nem fér hozzá. Ha a Webáruházad a Shopteten fut, **[itt](https://www.mergado.cz/zabezpeceni-shoptet-feedu)** találod az útmutatót, hogyan módosítsd a Shoptet adminisztrációban az elérhetőségi Feed biztonsági beállításait. ## **Elérhetőségi Feed létrehozása a Mergado Editorban** Ha a Webáruház-megoldásod nem kínál elérhetőségi Feedet, két lehetőséged van a Mergado Editor segítségével: * Ha a Termék Feedben az elérhetőség számformátumban szerepel, a Mergado Editorban a Projekt létrehozásakor válaszd kimeneti Formátumként a `Mergado Marketplaces`-t. Így ezt a Feedet a Mergado Marketplaces Bővítményben nemcsak termékadatok szinkronizálására, hanem az elérhetőség szinkronizálására is használhatod. További információkat a Mergado Marketplaces Feed Formátum cikkben találsz. ![image|690x339](upload://vWVvwp1eA9Q1mBHLEmQYzCBz1Lv.png) ![image|690x297](upload://62uX1kdKwfPCCx7Hf8ndkftJuQX.png) * Ha a Termék Feedben nincs benne az elérhetőség, az elérhetőségi Feedet Mall vagy Heureka Formátumban külön Projektként hozhatod létre – a bemeneten az elérhetőségi adatokat tartalmazó Feedet (akár egy Google Sheets táblázat is megfelelő) választva. 1. Készítsd elő a Feedet, amelynek tartalmaznia kell a termékazonosítót és a raktáron lévő darabszámot. > A termékazonosítónak PONTOSAN MEG KELL EGYEZNIE a Termék ID-jával a meglévő Termék Feedben, különben az elérhetőség nem párosítható helyesen. 2. Jelentkezz be a Mergado Editorba, és kattints az **Új Projekt** gombra. ![image|690x167](upload://2jyL8VMxYPvdYwkFkaAhKLyI5AL.jpeg) 3. Add meg a bemeneti Feed URL-jét. A Mergado Editor a következő formátumokat támogatja: XML, JSON, CSV vagy Google Sheets. ![image|690x271](upload://dJnCX2GjoEa9yyY1oYm8qpBvzp7.jpeg) 4. Várd meg a Feed kezdeti elemzésének befejezését, majd válaszd ki a Webáruházat. 5. Az elemzés után az Editor a Feed tartalma alapján előválasztja a megfelelő Formátumot. Nem kötelező a kitöltött Formátumhoz ragaszkodnod. ![image|690x383](upload://fC8Tej7NwtZStgXyaOyS7qfZRIF.jpeg) 7. Ha a Mergado nem tudta felismerni a bemeneti Feed Formátumát, megadhatsz saját Formátumot a bemeneti Formátumok listájából. ![image|690x356](upload://mmGeGRe7spVL6jfbM3SIm3a3pDs.jpeg) 8. A kimeneti Formátum oldalon válaszd a **Heureka elérhetőségi** vagy a **MALL marketplace elérhetőségi** Feedet. ![image|690x365](upload://wLjvpiQuSpjgRuX35e69DemrxfQ.jpeg) 9. Az összefoglalóban ellenőrizd az összes kitöltött adatot. ![image|690x384](upload://AuAFhQ1N2KIa0iX5f61dUnv09Mp.jpeg) 10. Ha a **„Hiba a párosító Elemekben"** üzenetet látod, kattints a **Szerkesztés** gombra (jobb oldalon), és add hozzá a Termék ID-t párosító Elemként. ![image|690x384](upload://2cD0CdkmJ3PnRPDRhfnNjEcNxnD.jpeg) 11. Kattints a **Befejezés** gombra. ## **Az elérhetőségi Feed beállítása a Mergado Marketplaces-ben** 1. A Mergado Marketplaces-ben hozz létre egy új kampányt. 2. A kampány beállítása során eljutsz az elérhetőségi Feed hozzáadásának lépéséhez. 3. Add meg az elérhetőségi Feed URL-jét. A sikeres párosításhoz a Feednek meg kell felelnie a következő feltételeknek: * Heureka vagy Mall elérhetőségi Feed legyen, esetleg Mergado Marketplaces formátumú Feed. * Ugyanazokat a Termék ID-kat tartalmazza, mint a Termék Feed. * A Bővítmény számára nyilvánosan elérhető legyen. 4. Az elérhetőségi Feedet vagy a Webáruházadból kapod meg (ahogy a fenti példákban szerepel), vagy a Mergado Editor segítségével hozod létre. A Mergado Editorban az elérhetőségi Feedet az **Áttekintés** szekcióban találod – ott az **URL cím vágólapra másolása** lehetőséggel másold ki. ![image|690x219](upload://tTJTTGxNoMwjVG5TxmXWJwIV7AV.jpeg) 5. Add meg ezt az URL-t a szövegmezőbe: ![image|690x225](upload://laHPxYXIcAqKYIi5kzt8cis0JSF.png) 5. Ha bármilyen más URL-t használsz (nem XML formátumú, vagy az URL nem teljes – a képen lévő példában hiányzik az XML kiterjesztés), az **„Érvénytelen URL"** vagy **„Hiba történt"** hibaüzenetet látod, és a kampány létrehozása nem engedi továbblépni. Ebben az esetben ellenőrizd, hogy az URL teljes, XML formátumú, és Heureka vagy Mall elérhetőségi Feed, esetleg Mergado Marketplaces formátumú Feed. ![image|690x371](upload://7siTunD9HPz5djUCIhc6alJRRhV.png) 6. Ha egyes Termék ID-k nem egyeznek, vagy hiányoznak az elérhetőségi Feedből, a **Következő lépés** gombra kattintva értesítést kapsz a hiányzó Termék ID-k számáról. Ez a figyelmeztetés nem akadályozza meg a kampány létrehozásának folytatását – az összes többi Termék helyesen lesz párosítva. Ha csak néhány Termékről van szó, valószínűleg elfogyott áruról van szó, nem hibáról. Ha viszont a hiányzó Termékek száma megegyezik a Termék Feed összes Termékének számával, az elérhetőségi Feed egyetlen helyes ID-t sem tartalmaz, és egyetlen Termék sem töltődik fel a marketplace-re. Ellenőrizd, hogy a megfelelő elérhetőségi Feedet töltöd-e fel, és hogy tartalmazza-e a Termék Feedben szereplő helyes ID-kat. ![image|690x245](upload://ye7Hyf5vWutdpkUzAfcIjV0p8UO.png) 7. Ha az elérhetőségi Feed helyes, fejezd be a kampány létrehozását. A sikeres létrehozás és szinkronizálás után látni fogod, mely Termékek töltődtek fel sikeresen. 8. Az elérhetőségi Feed hibája miatt fel nem töltött Termékeket a kampány részleteinél → **Validáció** szekcióban találod, ahol az **„Az ajánlatból hiányzik az elérhetőség, ellenőrizd, hogy az elérhetőségi Feed helyes formátumú-e, és a 'Termék ID' megegyezik-e a Termék és az elérhetőségi Feedben"** listát látod. > Ha csak néhány Termékről van szó, valószínűleg elfogyott Termékekről van szó, nem hibáról. A legközelebbi raktárra kerüléskor az adott ajánlat aktiválódik (feltéve, hogy az adott Termékhez létezik termékkártya a piactéren). ![image|690x275](upload://bxPabRkVaJP7LH8hV0yfPjHtt66.png)

## **GYIK** ### **Miért fontos az elérhetőségi Feed a Mergado Marketplaces-ben?** Az elérhetőségi Feed biztosítja, hogy csak a valóban raktáron lévő Termékeket kínáld a marketplace-en. Nélküle a Termékek nem töltődnek fel, és nem frissül a készletinformáció. ### **Mit tegyek, ha a Webáruházam nem generál elérhetőségi Feedet?** Két lehetőséged van: 1) Ha a Termék Feedben az elérhetőség számformátumban szerepel, használd a Mergado Marketplaces Feed Formátumot. 2) Ha nincs benne, a Mergado Editorban hozz létre egy külön Projektet Heureka vagy Mall elérhetőségi Feed formátumban. ### **Miért nem párosítódnak a Termékeim az elérhetőségi Feedben?** A leggyakoribb ok: a Termék ID-k nem egyeznek pontosan a Termék Feedben és az elérhetőségi Feedben. Ellenőrizd, hogy a két Feed azonos azonosítókat használ-e. ### **Hogyan oldjam meg az „Érvénytelen URL" hibát az elérhetőségi Feed megadásakor?** Ellenőrizd, hogy az URL teljes, XML formátumú, és Heureka vagy Mall elérhetőségi Feed, esetleg Mergado Marketplaces formátumú Feed. Az URL-nek nyilvánosan elérhetőnek kell lennie. --- ## [GPSR az Allegrón és a Kauflandon](https://help.mergado.com/hu/mergado-marketplaces/gpsr-allegro-kaufland/) # **GPSR az Allegrón és a Kauflandon** Ez a cikk bemutatja, hogyan teljesítsd az EU GPSR-rendelet (általános termékbiztonság) követelményeit az Allegro és Kaufland piactereken a Mergado Marketplaces segítségével. > **GPSR röviden** > 2024.12.13-tól hatályba lép az EU általános termékbiztonságról szóló rendelete, amely a legtöbb fogyasztói termékre vonatkozik ([bővebben](https://eur-lex.europa.eu/CS/legal-content/summary/general-product-safety-regulation-2023.html)). Az online piacterek – köztük a Kaufland és az Allegro – ennek alapján további adatokat kérnek az eladóktól, és a hiányzó adatok esetén fenntartják a jogot az ajánlatok elrejtésére. Az Allegrónál ki kell tölteni a biztonsági információkat és a gyártó / az európai piacra hozásért felelős személy adatait. A Kauflandnál a gyártó / EU-s felelős személy neve, CE jelölés és biztonsági utasítások megadása szükséges. ## **A GPSR rendelet** **2024. december 13-tól** hatályba lép az EU általános termékbiztonságról szóló rendelete (GPSR), amely változásokat hoz az online platformokon értékesítő eladók számára. A GPSR a legtöbb fogyasztói terméket lefedi. **Kivételt képeznek:** gyógyszerek, élelmiszerek, takarmányok, élő növények és állatok, növényvédő szerek, régiségek stb. A tájékoztatási kötelezettség teljesítéséhez minden érintett Termékhez legalább a következő adatokat kell megadni: a. a **gyártó** neve, postai és e-mail címe * **az európai piacra hozásért felelős személy adatai** – csak EU-n kívüli gyártó esetén b. **a Termék azonosítását lehetővé tevő adatok** (kép, kategória, EAN kód stb.) c. **figyelmeztetések és biztonsági információk** d. amennyiben szükséges, **CE jelölés és megfelelőségi dokumentumok** :information_source: [További információk az EU rendeletről](https://eur-lex.europa.eu/CS/legal-content/summary/general-product-safety-regulation-2023.html) ## **Allegro**
FONTOS VÁLTOZÁSOK AZ ALLEGRÓN 2025 AUGUSZTUSÁTÓL **Hogyan volt eddig?** Az Allegro korábban lehetővé tette a 'Termékek, amelyeket 2024.12.13. előtt hoztak forgalomba az EU-ban' paraméter kitöltését, és ezzel mentesített a további GPSR adatoktól. Most megváltoztatja ezt a megközelítést. **Mi változik 2025 augusztusától?** 1. A 'Termékek, amelyeket 2024.12.13. előtt hoztak forgalomba az EU-ban' mező 2025.8.12-től csak használt, felújított stb. állapotú Termékeknél lesz beállítható. **Minden új árunál ki kell tölteni a teljes biztonsági információkat és gyártói adatokat.** 2. A 'Figyelmeztetések és biztonsági információk' mező – 2025.8.4-től kötelező lesz biztonsági információkat megadni melléklet vagy szöveg formájában. **Miért foglalkozz vele?** A változások hatályba lépésekor az aktív ajánlatok szerkesztésekor hibaüzenet jelenik meg, és az ajánlat nem lesz aktív az adatok pótlásáig. Érdemes minél előbb elkezdeni.
> :bulb: Ha nem töltöd ki a GPSR információkat, megpróbáljuk az Allegro termékkatalógusából pótolni a **manuális Termék Feed szinkronizáció** és az **ajánlatok létrehozása** során. Ezek az Allegro mesterséges intelligenciája által generált adatok – javasoljuk az alapos ellenőrzést. --- A GPSR keretében az Allegrón ajánlat szinten kitöltendő: * **Termékek, amelyeket 2024.12.13. előtt hoztak forgalomba az EU-ban** * **Gyártó adatok** * **Felelős személyek az európai piacra hozásért** * **Figyelmeztetések és biztonsági információk** ![image|690x426](upload://bYWQ9yYhaLQtqUYF7FYaciTlQ62.png) **1. Gyártó adatok és felelős személy adatai** A gyártó adatait az Allegro Sales Center **[Gyártó adatok](https://salescenter.allegro.com/responsible-producers)** részében adhatod meg. A felelős személy adatait a **[Felelős személyek](https://salescenter.allegro.com/responsible-persons)** részben pótolhatod. Minden gyártóhoz/személyhez „Egyedi nevet" is megadsz – ezzel rendeled hozzá őket az ajánlatokhoz a Mergado Marketplaces-ben. ![Údaje-o-výrobcích-Allegro-Sales-Center-12-04-2024_11_25_AM|690x346](upload://dQze2MLIhfDRogQY9rGH2GQjfRx.png) Az adatokat a kampánybeállításokban pótolhatod: egységesen az egész kampányra, vagy a Feedből származó Elemre párosítva. Feedre párosítás esetén értékként az Allegro adminisztrációban megadott egyedi neveket használd. Mentés után kattints a **Termék Feed szinkronizálása** gombra. ![image|611x500](upload://sFPgHcoVOfK2fwBfAmq2PBgMSyq.png) :information_source: Egyedi neveket 2 módon pótolhatsz a Feedbe:
1. Új Elem létrehozása és érték kitöltése Lekérdezések segítségével Menj az **Elemek** szekcióba, kattints az **Új Elem hozzáadása** gombra. Hozz létre Lekérdezéseket a Termékcsoportokhoz, majd a **Szabályok** szekcióban **Szűrők szerinti tömeges felülírás** típusú Szabályt az egyedi nevekkel. A kampánybeállításokban párosítsd a **Gyártó adatokat** az új Elemre. ![image|690x393](upload://95dkh31GOgQxu4g3BtOj1SWeHhL.png)
2. CSV fájl importálása Az adatokat CSV-vel is importálhatod: első oszlop = termékazonosító, további oszlopok = Elemek és értékeik. Hozz létre **Adatfájl importálása** típusú Szabályt. :link: Bővebben a CSV importról: https://www.mergado.cz/blog/csv-import-mergado-release
> :bulb: Ha az „**Egyedi név**" megegyezik a Feedben lévő MANUFACTURER Elem értékével, nem kell új Elemet létrehoznod. **2. Figyelmeztetések és biztonsági információk** A kampánybeállításokban Feedre párosítással vagy egységes értékkel pótolhatod: * Egységes érték: **HTML nélküli szöveg, max. 2000 karakter** * Feedre párosítva: **URL címek** (PDF, JPEG, JPG, PNG, max 50 MB) vagy **HTML nélküli szövegek** ![image|611x500](upload://33BNhTE3Ql8tR07I5s1oFQRbrYR.png) > Az Allegrón az összes GPSR adat ajánlat szinten van, ezért bármikor módosítható. :link: Bővebben az Allegro oldalain [itt](https://help.allegro.com/sell/cs/a/jake-povinnosti-vam-uklada-gpsr-O3YPWLrz4im#). ## **Kaufland** A Kauflandnál a GPSR adatok termékkártya szinten adandók meg: * **Gyártó / EU-s felelős személy neve** * **CE jelölés** * **Biztonsági utasítások**
Értékesítés a Kauflandon a Mergado Marketplaces-en keresztül (API) Ezek az adatok csak új termékkártyák létrehozásakor vagy hiányos kártyák kiegészítésekor pótolhatók. **Meglévő termékkártyák szerkesztése nem lehetséges.** Meglévő Termékeknél 2 módon pótolhatsz: a) Egyszeri import a Kaufland Seller Portalon (ean, locale + GPSR Elemek) b) Mergado Editoron keresztül (Lekérdezésekkel vagy CSV importtal) Az engedélyezett safety_guidelines értékek listája **[itt](https://docs.google.com/spreadsheets/d/17uu69dyqQ8BkfpWVfeM7CvY9KtnNyC9QUIM0P5dcMRI/edit?gid=2131277475#gid=2131277475)**.
Értékesítés a Kauflandon a Mergado Editoron keresztül (Feed kapcsolat) Ha Feed-en keresztül csatlakoztál, a Feedbe a GPSR Elemeket (product_safety_contact.name, .address, .email_address, .phone_number, safety_guidelines, ce_certificate) adhatod hozzá. Ha beállítottad az **Automatikus termékadatok feltöltése** funkciót, egyszeri import nem szükséges.
:link: Bővebben: https://www.kauflandglobalmarketplace.com/cs/seller-university/pravni-pruvodce/gpsr/ > **Felelősség kizárása:** > Ezek az információk nem jelentenek jogi tanácsadást. Tájékozódj saját felelősségedre.
## **GYIK** ### **Mi az a GPSR és miért fontos?** A GPSR az EU általános termékbiztonságról szóló rendelete, amely 2024. december 13-tól hatályos. Az Allegro és Kaufland ennek alapján további adatokat kér az eladóktól (gyártó, felelős személy, biztonsági utasítások), és az adatok hiánya esetén elrejthetik az ajánlatokat. ### **Hogyan adhatom meg a gyártói adatokat az Allegrón?** A gyártó adatait az Allegro Sales Center **Gyártó adatok** részében adhatod meg, ahol **Egyedi nevet** is megadsz. Ezután a Mergado Marketplaces kampánybeállításaiban párosíthatod az adatokat egységesen az egész kampányra, vagy a Feedből származó Elemre. ### **Szerkeszthetem a GPSR adatokat a meglévő Kaufland termékkártyákon?** API-n keresztül a meglévő Kaufland termékkártyák GPSR adatai nem szerkeszthetők. A meglévő Termékeknél egyszeri importot végezhetsz a Kaufland Seller Portalon, vagy a Mergado Editoron keresztül pótolhatod az adatokat. ### **Mi változik 2025 augusztusától az Allegrón?** 2025.8.12-től az „EU-ban 2024.12.13. előtt forgalomba hozott" mező csak használt/felújított Termékeknél lesz elérhető. Minden új árunál kötelező lesz a teljes biztonsági információ és gyártói adatok megadása. --- ## [Kampány létrehozása és termékfeltöltés az Allegrora](https://help.mergado.com/hu/mergado-marketplaces/kampany-letrehozasa-termekfeltoltes-allegrora/) # **Kampány létrehozása és termékfeltöltés az Allegrora** [![Allegro akce](https://app.mergado.com/upload/bd5e0797366f81b1fa3553e91053a71e.png)](https://allegro.cz/kampan/zacnete-prodavat/partners?affiliation=mergado-cz&affiliation_source=mergado-cz) > Először aktiválnod kell a [Mergado Marketplaces Bővítményt a **Mergado Store**-ban](https://store.mergado.com/detail/ordelogyproducts/#about). Mielőtt elkezded, győződj meg róla, hogy rendelkezel: :white_check_mark: Ellenőrzött céges fiók az Allegrón :white_check_mark: Termék Feed a Mergado Editorban EAN kódokkal :white_check_mark: Heureka/Mall elérhetőségi Feed/Mergado Marketplaces Termék Feed > :bulb: Nem tudod, melyik kimeneti Feed Formátum a legmegfelelőbb? A Mergado Marketplaces Bővítmény a Mergado Editor összes Formátumát elfogadja. Újdonság a **Mergado Marketplaces Feed Formátum**, amellyel mind a termékadatokat, mind az elérhetőséget szinkronizálhatod. Bővebben a Mergado Marketplaces Feed Formátum cikkben. Mielőtt kampányt hozol létre, győződj meg róla, hogy az Allegrón van **ellenőrzött céges fiókod**, és **kitöltötted a szállítási árlistát, reklamációs és visszaküldési feltételeket**. A regisztráció részletes leírása [itt](https://help.allegro.com/sell/cs/c/registrace-uctu-allegro#q0aPBB8B0Cj). :warning: **A regisztrációs piac lesz az alapértelmezett értékesítési csatornád.** Ez nem módosítható, és ezen a piacon mindig aktív ajánlatokkal kell rendelkezned. ## **Kapcsolat létrehozása** Először hozd létre az Allegro kapcsolatot. Menj a **Kapcsolatok** szekcióba, kattints az Allegro logóra, majd a **Csatlakozás** gombra. ![image|690x171](upload://9SnkalUPqRpzGl4wQ2ZPxqk7M03.png) ![image|690x216](upload://usrWBAvFvvQ5Fbw6ez1SyOGyhC5.png) Kövesd az Allegro hitelesítési lépéseket a böngészőben. ## **Kampány létrehozása** Menj a **Kampányok** menübe, és kattints a **Kampány létrehozása** gombra. Az 5 lépéses varázsló végigvezet. ### **1. Általános** Add meg a kampány nevét. ![image|690x178](upload://9sW0ASX0iGHIrJUezCatHfco7rW.png) ### **2. Marketplace** Válaszd az Allegrót. Párosítsd az árat az alapértelmezett értékesítési csatorna pénznemében. Válaszd ki a **[szállítási árlistát](https://salescenter.allegro.com/delivery-settings)**, **[reklamációs feltételeket](https://salescenter.allegro.com/complaints-terms)** és **[visszaküldési feltételeket](https://salescenter.allegro.com/returns-terms)**. ![image|690x419](upload://fIEzmWNHZ5bWcZzz43BsmNZabb3.png) ### **3. Mergado** Válaszd ki a Mergado Projektet és a Szűrőt. > :information_source: Ha nem szeretnéd az összes Terméket feltölteni, **hozz létre egy Szűrőt a Mergado Editorban**. Párosítsd a kötelező Elemeket: **EAN**, **Termék ID**, **Bruttó ár** és **Termék állapot**. ![image|473x500](upload://azAw3GDJYIqcv0T1BbxxnLEluSM.png) > :warning: **GPSR rendelet** – a Mergado szekció végén töltsd ki a GPSR információkat. Bővebben a GPSR az Allegrón és a Kauflandon cikkben. ### **4. Elérhetőségi Feed** Add meg az elérhetőségi Feed URL-jét. Támogatjuk a Mall és Heureka elérhetőségi Feedet, illetve a Mergado Marketplaces Feed Formátumot. ![image|690x240](upload://ke1Hd1vRv5x962JFGPwOOBaRxME.png) :bulb: **Ha nincs Mall/Heureka formátumú elérhetőségi Feed, a Mergado Editorral létrehozhatod. Bővebben az Elérhetőségi Feed cikkben.** ### **5. Befejezés** Ellenőrizd a beállításokat, és kattints a **Mentés** gombra. :white_check_mark: **A kampány létrejött és az ajánlataid feltöltődnek az Allegrora.** A folyamat eltarthat egy ideig. ![image|690x142](upload://sR6lzsOOdFHu9GbZZ4v2g1tHQdZ.png) > **A Termék Feed szinkronizáció befejezése után ellenőrizd a kampány részleteiben a validációs üzeneteket.** A leggyakoribb üzenetek magyarázatát a Mergado Marketplaces validációs üzenetek cikkben találod. :question: **„Az Allegro katalógusban ezen termékazonosító alatt nem található termékkártya"?** Termékkártyát kell létrehozni. Az útmutatót a Termékkártyák szekcióban találod. ## **GYIK** ### **Mi szükséges az Allegro kampány létrehozásához?** Szükséged van egy ellenőrzött Allegro céges fiókra, kitöltött szállítási árlistára, reklamációs és visszaküldési feltételekre, EAN kódokat tartalmazó Termék Feedre a Mergado Editorban, valamint elérhetőségi Feedre. ### **Hogyan hozom létre az Allegro kapcsolatot?** Menj a Mergado Marketplaces **Kapcsolatok** szekciójába, kattints az Allegro logóra, majd a **Csatlakozás** gombra, és kövesd a böngészőben megjelenő Allegro hitelesítési lépéseket. ### **Mit tegyek, ha a Termék Feed szinkronizálása után validációs hibák jelennek meg?** A kampány részleteiben ellenőrizd a validációs üzeneteket. A leggyakoribb ok a hiányzó termékkártya a katalógusban – ezt a **Termékkártyák** szekcióban hozhatod létre. ### **Milyen kimeneti Feed formátumot válasszak?** A Mergado Marketplaces a Mergado Editor összes formátumát elfogadja. Ha szeretnéd a termékadatokat és az elérhetőséget egyetlen Feedben kezelni, válaszd a **Mergado Marketplaces Feed Formátumot**. --- ## [Kampány létrehozása és termékfeltöltés a Kauflandra](https://help.mergado.com/hu/mergado-marketplaces/kampany-letrehozasa-termekfeltoltes-kauflandra/) # **Kampány létrehozása és termékfeltöltés a Kauflandra** > Először aktiválnod kell a [Mergado Marketplaces Bővítményt a Mergado Store-ban](https://store.mergado.com/detail/ordelogyproducts/#about). Mielőtt elkezded, győződj meg róla, hogy rendelkezel: :white_check_mark: Ellenőrzött céges fiók a Kauflandon :white_check_mark: Termék Feed a Mergado Editorban EAN kódokkal :white_check_mark: Heureka/Mall elérhetőségi Feed/Mergado Marketplaces Feed > :bulb: A **Mergado Marketplaces Feed Formátummal** mind a termékadatokat, mind az elérhetőséget szinkronizálhatod. Bővebben a Mergado Marketplaces Feed Formátum cikkben. Mielőtt kampányt hozol létre, győződj meg róla, hogy regisztrálva vagy a **Kaufland Global Marketplace-en**. Regisztrációs információk: [itt](https://www.kaufland.de/i/seller-university/cz/registration/). ## **Kapcsolat létrehozása** A Mergado Marketplaces Bővítményben menj a **Kapcsolatok** fülre, és kattints a Kaufland logóra. Illeszd be az **API kulcsokat** a Kaufland adminisztrációból (**Beállítások → Bolt beállítások → API**). ![image|690x186](upload://ql5N6mUytqXfFKW6fuRDOTsqM2Q.png) ![image|690x294](upload://x0s7JqIidGqfFMTWVKMNjyswDpy.png) ![image|690x418](upload://bRNJXZpXjp8yygSX16aISY03YM8.png) > :information_source: Ha újragenerálod a kulcsokat a Kaufland adminisztrációban, a régiek érvényüket vesztik és a **kapcsolat megszűnik**. ## **Kampány létrehozása** Menj a **Kampányok** menübe, és kattints a **Kampány létrehozása** gombra. ### **1. Általános** Add meg a kampány nevét. ### **2. Marketplace** Válaszd a Kauflandot. Válaszd ki az **értékesítési csatornát** (ország) és a **szállítási csoportot** a [Kaufland adminisztrációból](https://sellerportal.kaufland.de/shipping-groups/). ![image|690x334](upload://7Bar0J1EHUdVhBxxLwvcEMOotuy.png) ### **3. Mergado** Válaszd ki a Projektet és a Szűrőt. Párosítsd a kötelező Elemeket: **EAN**, **Termék ID**, **Bruttó ár**, **Termék állapot** és **Feldolgozási idő**. > :exclamation: **DE, AT, SK, IT és FR értékesítési csatornánál EUR-ban, CZ-nél CZK-ban, PL-nél PLN-ben kell párosítani az árat.** ![image|407x500](upload://baQkHwLBrlodm5FbrL8wnMuf99W.png) ### **4. Elérhetőség** Add meg az elérhetőségi Feed URL-jét. ![image|690x240](upload://ke1Hd1vRv5x962JFGPwOOBaRxME.png) :bulb: **Ha nincs elérhetőségi Feed, a Mergado Editorral létrehozhatod. Bővebben az Elérhetőségi Feed cikkben.** ### **5. Befejezés** Ellenőrizd a beállításokat, és kattints a **Mentés** gombra. A kampány létrejött és az ajánlatok automatikusan feltöltődnek. > :exclamation: **Ellenőrizd a validációs üzeneteket a kampány részleteiben.** Magyarázatokat a Mergado Marketplaces validációs üzenetek cikkben találsz. :question: **„A Kaufland katalógusban ezen EAN kód alatt nem található termékkártya"?** Termékkártyát kell létrehozni. Az útmutatót a Termékkártyák szekcióban találod. ## **GYIK** ### **Milyen pénznemben kell megadni az árat a Kaufland kampányban?** A pénznem az értékesítési csatornától függ: DE, AT, SK, IT és FR esetén EUR-ban, CZ esetén CZK-ban, PL esetén PLN-ben kell párosítani az árat. ### **Hogyan hozom létre a Kaufland kapcsolatot?** A Mergado Marketplaces **Kapcsolatok** szekciójában kattints a Kaufland logóra, és illeszd be az API kulcsokat a Kaufland adminisztrációból (**Beállítások → Bolt beállítások → API**). ### **Mi történik, ha újragenerálom a Kaufland API kulcsokat?** Ha újragenerálod a kulcsokat a Kaufland adminisztrációban, a régiek érvényüket vesztik, és a Mergado Marketplaces-szel való kapcsolat megszűnik. Ilyen esetben újra meg kell adnod az új kulcsokat a Bővítményben. ### **Hogyan válasszam ki a szállítási csoportot?** A szállítási csoportot a [Kaufland Seller Portal](https://sellerportal.kaufland.de/shipping-groups/) **Szállítási beállítások** szekciójában hozhatod létre, majd a kampány létrehozásakor kiválaszthatod a megfelelőt. --- ## [Megrendelések kezelése a Mergado Marketplaces-ben](https://help.mergado.com/hu/mergado-marketplaces/megrendelesek-kezelese/) # **Megrendelések kezelése a Mergado Marketplaces-ben** A Mergado Marketplaces-ben aktiválhatod a megrendelések letöltését, aminek köszönhetően az összes marketplace megrendelésed egy helyen lesz. :tada: A megrendeléseket tovább kapcsolhatod: * Shopify * UNAS * POHODA könyvelési rendszer * WooCommerce * Shoptet Premium > Ha hibába ütközöl vagy ötleteid vannak a funkció továbbfejlesztésére, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ## **Aktiváció** A megrendelések letöltésének elindításához először aktiválnod kell ezt a funkciót az **Aktiváció** szekcióban. Itt kiválasztod a kívánt platformokat, majd mentsd a változtatásokat: ![image|690x222](upload://njfK7zwNLKyGMuGuhmFvOnQLedz.png) > :warning: **A megrendelések aktiválásához aktív kapcsolat szükséges a kívánt platformmal a Kapcsolatok szekcióban.** ## **Előzmények** Az **Előzmények** szekcióban információkat találsz a megrendelések aktiválásáról és deaktiválásáról, valamint a szinkronizáció menetéről: ![image|690x313](upload://v29WDBDGtAo6sMEr8ZwRKcnimqn.png) A részletekben látod az új megrendelések számát, a státuszváltozásokat és a megrendelési adatok módosulásait: ![image|690x81](upload://ukEYRIDEOv1V9gaHFyT5GMVCsQI.png) ## **Megrendelések áttekintése** A megrendelések áttekintésében megtalálod a legfontosabb információkat a megrendeléseidről: * Piactér logója * Vásárlás piaca * Megrendelés ID + átkattintás a megrendelés részleteire az adott piactéren a ![image|29x22](upload://eLhJBmUcEeDeBDWQGYbpaxTV7Z6.png) ikonra kattintva * Megrendelés létrehozásának dátuma * Vásárló neve * Megrendelés tételei * Megrendelés összára * Fulfillment * FBM (Fulfillment by Merchant) * FBK (Fulfillment by Kaufland) * One Fulfillment by Allegro * Megrendelés státusza (nyitva, elküldetlen, elküldött, felfüggesztve, visszaküldve, törölve, ismeretlen) * Szinkronizáció állapota > A megrendeléseket 5 percenként szinkronizáljuk. ![image|690x366](upload://zLu45zK36vSVtKJhfxE0mW1mvzf.png) Az adott megrendelésre kattintva megnyílik a megrendelés részlete: ![image|690x384](upload://dmGfXVKIM4G7TaUTFV7iyZCwoRQ.png) > Ha az Allegrón vagy Kauflandon belső megjegyzést fűztél a megrendeléshez, az a Bővítményben is megjelenik. Ha azonban a Mergado Marketplaces Bővítményen keresztül adsz hozzá megjegyzést vagy szerkeszted azt, a belső megjegyzés már nem szinkronizálódik a piactérrel. ## **Értesítések** Az **Értesítések** szekcióban beállíthatod az új megrendelésekről szóló figyelmeztetéseket. Magad választod ki, mely napokon és órákban szeretnéd megkapni az értesítéseket, és azt is, hogy Mergado üzeneteken vagy e-mailen keresztül kapd: ![image|690x379](upload://olPGNNUsPi3p0AWWDSklrMiKj5r.png) ![image|509x500, 75%](upload://wgbJhUetJpaKviAuW2QJVcdadaA.png) Az e-mail értesítésben a megrendelés ID-jára kattintva közvetlenül a megrendelés részleteire juthatsz az Allegrón/Kauflandon, vagy megtekintheted az új megrendeléseket a Mergado Marketplaces-ben: ![image|647x500](upload://p8oNm9PfNyiIXKCyndD5VdkH5PW.png) ## **Megrendelések exportálása** Az exportálásnál kiválaszthatod, mely megrendeléseket vonod be a CSV-be: ![image|690x206](upload://kzPyTfmIzBXJfZWP5SidDGFdO35.png) Azt is megadhatod, milyen adatokat tartalmazzon a CSV, és saját oszlopneveket is beállíthatsz: ![image|690x366](upload://fIzfkKoUqXqAAjrTXEIHm4B7KW1.png) ## **GYIK** ### **Milyen gyakran szinkronizálódnak a megrendelések?** A megrendelések 5 percenként automatikusan szinkronizálódnak a marketplace és a Mergado Marketplaces között. ### **Hogyan aktiválom a megrendelések letöltését?** Menj a Mergado Marketplaces-ben a **Megrendelések → Aktiváció** szekcióba, válaszd ki a kívánt platformokat, és mentsd a változtatásokat. Az aktiváláshoz aktív kapcsolat szükséges a kívánt platformmal. ### **Visszamenőlegesen is szinkronizálódnak a korábbi megrendelések?** Nem, csak az aktiválás utáni új megrendelések szinkronizálódnak. ### **Hogyan exportálhatom a megrendeléseket CSV-be?** A megrendelések áttekintésében kiválaszthatod, mely megrendeléseket szeretnéd exportálni, és testreszabhatod, milyen adatokat és oszlopneveket tartalmazzon a CSV fájl. --- ## [Megrendelések importálása a POHODA rendszerbe](https://help.mergado.com/hu/mergado-marketplaces/megrendelesek-pohoda/) # **Megrendelések importálása a POHODA rendszerbe** A Mergado Marketplaces generál egy Feedet az új megrendelésekkel, amellyel közvetlenül importálhatod őket a POHODA-ba. > :memo: **Előzetes megjegyzések:** > * Az Allegro megrendelés ID-ból csak az első 30 karakter kerül a Feedbe a POHODA korlátozása miatt > * A POHODA maga figyeli a duplikált importot > * Csak az „Elküldetlen" státuszú megrendelések importálódnak ## **Beállítás a Mergado Marketplaces-ben** 1. A **Kapcsolatok** szekcióban kattints a POHODA logóra, és töltsd ki: * **Cég adószáma**: meg kell egyeznie a POHODA számviteli egységben beállítottal * **Felhasználónév és jelszó** a Feed biztosításához – gondosan mentsd el ![image|690x300](upload://pKRUaZGDZE1pkAtu2pQuZRB2f7t.png) 2. Menj a **Megrendelések → Aktiváció** szekcióba, válaszd a POHODA-t és a kívánt marketplace-eket, majd mentsd. ![image|690x376](upload://3RhgAEKfsKlxogl4mFnYeSbSxc5.png) 3. A **Kapcsolatok** szekcióban megtalálod a megrendelési Feed URL-jét. ![image|690x259](upload://kdeUCPDbXZdzIwokQXFftVKa7tP.png) ### **Fizetések és szállítási módok párosítása** A párosítás a **Név** mező alapján történik – pontosan egyeznie kell a Mergado Marketplaces-ben és a POHODA-ban. ![image|690x378, 75%](upload://fEKmDfPTKoOAgILQiTn8eWEPv3J.png) > :bulb: Javasoljuk, hogy legalább egy hétig hagyd bekapcsolva, és csak utána párosíts. **Rendszeresen ellenőrizd az új értékeket.** :warning: Ismeretlen fizetési mód esetén a megrendelés bekerül a Feedbe, de a szállítási mód nem kerül át, és a fizetés „Átutalással"-ra lesz beállítva. ### **ÁFA kulcsok** Ha kapunk ÁFA kulcsot a marketplace-ből, a Feedben is megjelenítjük (pl. `high`). Ellenőrizd a POHODA ÁFA beállításait. ![image](upload://5uk0dDsOyKDTVwzdqZ4Kjvve2lz) ## **Alapbeállítás a POHODA-ban** Menj a **Beállítások → Internetes boltok → Internetes boltok beállítása** szekcióba: * Válaszd az **Általános internetes bolt** lehetőséget * **Általános** fül: töltsd ki a „Bolt neve" mezőt * **Beállítások** fül: növeld a válaszidőt ~120-ra * **WEB kliens** fül: jelöld be a hitelesítést, add meg a Mergado Marketplaces-ben megadott adatokat * **Import** fül: illeszd be a Feed URL-t > :warning: Külföldi piaci értékesítéshez engedélyezd a külföldi pénznemeket a POHODA-ban. Útmutató [itt](https://www.stormware.cz/prirucka-pohoda-online/nastaveni/cizi_meny/). ## **Egyszeri megrendelésimport** 1. **Fájl → Adatkommunikáció → Internetes kereskedelem** 2. Válaszd ki a boltot, majd kattints a **Letöltés az internetről** gombra 3. Jelöld be **Beérkezett megrendelések → összes** 4. Kattints a **Tovább** gombra – sikeres átvitelnél: „Állapot: OK" > :warning: **Hiba esetén töltsd le a megjelenő fájlt, és küldd el a `responseStatePohoda_XYZ` dokumentumot a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre.** 5. **Számlázás → Beérkezett megrendelések** – itt látod az importált megrendeléseket. ## **Automatikus megrendelésimport** A POHODA E1-nél automatikus feladatként is beállítható. Hozz létre forgatókönyvet és automatikus feladatot a kívánt gyakorisággal (max. 1 év). > :information_source: Ha problémába ütközöl, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ## **GYIK** ### **Milyen megrendelések importálódnak a POHODA-ba?** Csak az „Elküldetlen" státuszú megrendelések. A POHODA maga figyeli a duplikált importot, így nem kell aggódnod az ismételt átvitel miatt. ### **Hogyan állítom be a POHODA-t az importhoz?** Menj a **Beállítások → Internetes boltok → Internetes boltok beállítása** szekcióba, válaszd az **Általános internetes bolt** lehetőséget, és töltsd ki a **WEB kliens** fülön a Mergado Marketplaces-ben megadott hitelesítési adatokat. ### **Miért fontos a fizetési módok párosítása?** A párosítás a **Név** mező alapján történik, és pontosan egyeznie kell a Mergado Marketplaces-ben és a POHODA-ban. Ismeretlen fizetési mód esetén a megrendelés bekerül a Feedbe, de a szállítási mód nem kerül át, és a fizetés „Átutalással"-ra lesz beállítva. ### **Beállítható automatikus megrendelésimport?** Igen, a POHODA E1 verzióban. Hozz létre forgatókönyvet és automatikus feladatot a kívánt gyakorisággal. --- ## [Megrendelések importálása a Shoptet Premiumba](https://help.mergado.com/hu/mergado-marketplaces/megrendelesek-shoptet/) # **Megrendelések importálása a Shoptet Premiumba** A Mergado Marketplaces-en keresztül importálhatod a marketplace megrendeléseket közvetlenül a Shoptet Premiumba. A szinkronizáció 5 percenként fut, és csak az „Elküldetlen" státuszú új megrendelések importálódnak. A Mergado Marketplaces-ből a Shoptet irányába a következő státuszok szinkronizálódnak: * „Elküldetlen" :backhand_index_pointing_right: „Feldolgozatlan" * „Elküldött" :backhand_index_pointing_right: „Megrendelés teljesítve" * „Törölve" :backhand_index_pointing_right: „Törölve" ## **Beállítás** ### **1. Hozd létre az API tokent** A Shoptet Premium adminisztrációjában menj az **Összekapcsolások → Private API** menübe, és adj hozzá egy új privát tokent. ![image|689x291](upload://5UCVzVJZv8VXBpN6iINbLSCvPC1.png) ### **2. Kapcsold össze a Shoptet Premiumot a Mergado Marketplaces-szel** A Mergado Marketplaces-ben menj a **Kapcsolatok** szekcióba, és válaszd a Shoptet Premium kapcsolatot. Elég kitölteni a korábban generált API tokent – a kapcsolat ezzel elindul. ![image|690x212](upload://6Gb1NxOpJBnpF9eSCsnSFVd8hvc.png) ### **3. Aktiváld a szinkronizációt** Menj a **Megrendelések → Aktiváció** szekcióba, aktiváld a szinkronizációt, és mentsd a változtatásokat. A szinkronizációt bármikor szüneteltetheted. ![image|690x336](upload://qfPqaHWPlLOXlzYrI22Zi6lHOxB.png) > :information_source: A rendszer nem szinkronizál visszamenőlegesen – az aktiválás előtti megrendelések nem kerülnek át. ### **Fontos tudnivalók** * A Termékek párosítása a Mergado Marketplaces **Termék ID**-ja és a Shoptet katalógus **Termékkód**-ja egyezése alapján történik. * Párosított Termékeknél az ÁFA kulcs közvetlenül a katalógusból íródik át; nem párosított Termékeknél a Shoptet adminisztrációd alapértelmezett ÁFA kulcsa kerül alkalmazásra. * Idegen pénznemű megrendelések importálásához a Shoptet adminisztrációban engedélyezned kell az idegen pénznemeket: **Beállítások → Alapbeállítások → Pénznemek**. > :information_source: Ha problémába ütközöl vagy fejlesztési ötleted van, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ## **GYIK** ### **Hogyan párosítódnak a Termékek a Shoptet katalógussal?** A párosítás a Mergado Marketplaces **Termék ID**-ja és a Shoptet katalógus **Termékkód**-ja egyezése alapján történik. ### **Milyen megrendelés-státuszok szinkronizálódnak?** Az „Elküldetlen" státusz „Feldolgozatlan"-ként, az „Elküldött" státusz „Megrendelés teljesítve"-ként, a „Törölve" státusz pedig „Törölve"-ként importálódik a Shoptetbe. ### **Hogyan kezeljem az idegen pénznemű megrendeléseket?** A Shoptet adminisztrációban engedélyezned kell az idegen pénznemeket: **Beállítások → Alapbeállítások → Pénznemek**. Enélkül az idegen pénznemű megrendelések nem importálódnak. ### **Visszamenőlegesen szinkronizálódnak a korábbi megrendelések?** Nem, csak az aktiválás utáni új megrendelések importálódnak. --- ## [Megrendelések összekapcsolása az UNAS-szal](https://help.mergado.com/hu/mergado-marketplaces/megrendelesek-unas/) # **Megrendelések összekapcsolása az UNAS-szal** A Mergado Marketplaces Bővítményben beállíthatod a megrendeléskezelést az UNAS-on keresztül. Ha a Webáruházadat UNAS-on üzemelteted és az Allegrón vagy Kauflandon értékesítesz, a megrendeléseidet közvetlenül a Webáruházad adminisztrációjában kezelheted. **1. UNAS kapcsolat létrehozása a Mergado Keychainben** A kapcsolat létrehozásához a Mergado Keychainben ki kell töltened: * API kulcs * Bolt neve (ID) Ezeket az adatokat az UNAS-ban a **Beállítások → Külső kapcsolatok → API kapcsolat** szekcióban találod. Kattints az **API kulcs létrehozása** gombra, és hozd létre az API kulcsot a Mergado számára. A helyes működéshez a Mergado Marketplaces-nek a következő műveletekre van szüksége: * `getOrder` * `setOrder` * `getOrderStatus` * `setOrderStatus` * `getMethod` A mentés után másold ki az API kulcsot, és a bolt nevével együtt illeszd be a Mergado Keychainbe: ![image|690x343](upload://dbLo1xcCLNqxUdzdGgrtH00KlWz.png) **2. Pénznemek beállítása az UNAS-ban** Ha a Mergado Marketplaces-en keresztül több piacon értékesítesz, az UNAS-ban engedélyezned kell a külföldi pénznemeket: **Beállítások → Pénznemek, Árkijelzés → Pénznemek**. Add hozzá az összes pénznemet azokhoz az országokhoz, ahol értékesítesz. ![image|690x130](upload://lF31dwa9O3XhtxoyVLBOQOpQp7l.png) **3. UNAS aktiválása a Mergado Marketplaces-ben** Miután sikeresen létrehoztad a kapcsolatot a Mergado Keychainben és előkészítetted a pénznemeket, aktiválhatod a megrendeléseket a Mergado Marketplaces-ben: **Megrendelések → Aktiváció**. Jelöld be az UNAS-t, és mentsd a változtatásokat. A szinkronizáció helyes működéséhez legalább egy marketplace-hez is aktiválni kell a megrendeléseket. **4. További beállítások a Mergado Marketplaces-ben** **Szállítási és fizetési módok párosítása** A megrendelések aktiválása után a **Kapcsolatok** szekcióban párosíthatod a marketplace-ek szállítási és fizetési módjait az UNAS értékeiddel. Az értékek dinamikusan töltődnek be a beérkező megrendelések alapján – érdemes rendszeresen ellenőrizni és az újonnan megjelent értékeket párosítani. > Ha a szállítási és fizetési módokat nem párosítod, a marketplace-ből kapott formátumban küldjük el az UNAS-ba. ![image|596x499](upload://c3inN289bVcmSZvnustvzxre8Uq.png) **ÁFA kulcsok** Az UNAS-ban a megrendelés létrehozásához kötelező az ÁFA nélküli ár megadása. Az ÁFA kulcsot az egyes kampányok beállításaiban töltheted ki. Ha nincs kitöltve, az adott ország standard ÁFA kulcsa kerül alkalmazásra. **Státuszok párosítása a Mergado Marketplaces és az UNAS között** * Elküldetlen :backhand_index_pointing_right: Waiting for processing (Feldolgozásra vár) * Feldolgozás alatt :backhand_index_pointing_right: Confirmed (Visszaigazolva) * Elküldött :backhand_index_pointing_right: Delivery (Kiszállítás) * Törölve :backhand_index_pointing_right: ha ez a státusz nem érhető el az UNAS-ban, a Bővítmény létrehoz egy saját 'Cancelled' státuszt ## **GYIK** ### **Hol találom az UNAS API kulcsot?** Az UNAS-ban a **Beállítások → Külső kapcsolatok → API kapcsolat** szekcióban. Kattints az **API kulcs létrehozása** gombra, és engedélyezd a `getOrder`, `setOrder`, `getOrderStatus`, `setOrderStatus` és `getMethod` műveleteket. ### **Hol kell létrehozni az UNAS kapcsolatot?** A Mergado Keychainben az API kulcs és a Bolt neve (ID) megadásával. Ezután a Mergado Marketplaces-ben aktiválhatod a megrendelés-szinkronizációt. ### **Hogyan kezeli a rendszer az ÁFA kulcsokat?** Az ÁFA kulcsot az egyes kampányok beállításaiban töltheted ki. Ha nincs kitöltve, az adott ország standard ÁFA kulcsa kerül alkalmazásra. ### **Mit tegyek, ha több piacon értékesítek különböző pénznemekben?** Az UNAS-ban a **Beállítások → Pénznemek, Árkijelzés → Pénznemek** szekcióban engedélyezd az összes szükséges pénznemet. --- ## [Megrendelések összekapcsolása az Upgates-szel](https://help.mergado.com/hu/mergado-marketplaces/megrendelesek-upgates/) # **Megrendelések összekapcsolása az Upgates-szel** A Mergado Marketplaces Bővítményben beállíthatod a megrendeléskezelést az Upgates-en keresztül. Ha a Webáruházadat Upgates-en üzemelteted és az Allegrón vagy Kauflandon értékesítesz, a megrendeléseidet közvetlenül a Webáruházad adminisztrációjában kezelheted. ### **1. A Mergado Marketplaces aktiválása az Upgates-ben** Először aktiválnod kell a Mergado Marketplaces bővítményt az Upgates adminisztrációdban. Navigálj a **Bővítmények → Bővítménylista** részhez, és keresd meg a Mergado Marketplaces-t. Kattints az **Aktiválás** gombra – megjelenik egy értesítés a megrendelés-szinkronizációhoz szükséges engedélyekről. Kattints a **Megerősítés** gombra. Hivatkozás a Mergado Marketplaces bővítményre: https://doplnky.upgates.cz/detail/mergado-marketplaces ### **2. Kapcsolat létrehozása a Mergado Marketplaces-ben** A bővítmény aktiválása után az Upgates-ben közvetlenül megjelennek a további lépések. Másold ki az oldal alján található API tokent, majd a Mergado Marketplaces-ben menj a **Kapcsolatok** szekcióba, nyisd meg az Upgates részletoldalát, és illeszd be a tokent az **API Token** mezőbe. Kattints a **Mentés** gombra. ### **3. Szinkronizáció beállítása** Sikeres kapcsolódás után az Upgates kapcsolat részletoldalán megjelenik egy szekció a nyelvi verziók és a marketplace értékesítési csatornák párosításához. Gondold át, mely piacokon értékesítesz az Allegrón és Kauflandon, és készítsd elő az Upgates adminisztrációdban: * a nyelvi verziókat: **Beállítások → Alapvető → Nyelvek** * a pénznemeket: **Beállítások → Alapvető → Pénznemek** Miután kitöltötted a nyelvi verziókat, minden piachoz párosíthatod: * **Státuszok** a Mergado Marketplaces-ből az Upgates megrendelési státuszaidhoz * Ha nem párosítod a státuszokat, az új megrendelések „Fogadott" státusszal kerülnek az Upgates-be, és a további státuszváltozások nem szinkronizálódnak. * **Fizetési és szállítási módok** az Upgates értékeidhez * Az értékek dinamikusan töltődnek be a beérkező megrendelések alapján – rendszeresen ellenőrizd és párosítsd az újonnan megjelent értékeket. * Ha nem párosítod, a fizetési és szállítási módot a marketplace-től kapott formátumban küldjük az Upgates-be. > :warning: **Fordíts figyelmet legalább a nyelvi verziók és a megrendelési státuszok párosítására – ezek nélkül a megrendelés-szinkronizáció nem fog megfelelően működni.** > :information_source: **ÁFA-kulcs**: Az Upgates-ben a megrendelés létrehozásához kötelező az ÁFA-kulcs megadása. Az ÁFA-kulcsot az egyes kampányok beállításaiban adhatod meg. Ha nincs kitöltve, az adott ország standard ÁFA-kulcsa kerül alkalmazásra. ### **4. Megrendelések aktiválása** Ha minden készen áll, menj a **Megrendelések → Aktiválás** szekcióba, és aktiváld a szinkronizációt az Upgates számára. A szinkronizáció megfelelő működéséhez legalább egy marketplace-en is aktiválni kell a megrendeléseket. > :bulb: Minden marketplace megrendeléshez belső megjegyzésként küldjük a `Mergado Marketplaces import` szöveget az Upgates megrendelés részletoldalán. A **Bővített** szekcióban a marketplace megrendelés azonosítóját a **Külső rendelésszám** alatt találod. ## **GYIK** ### **Mi történik, ha nem párosítom a megrendelési státuszokat?** Az új megrendelések „Fogadott" státusszal kerülnek az Upgates-be, és a marketplace-en történő további státuszváltozások nem szinkronizálódnak. ### **Kötelező megadni az ÁFA-kulcsot?** Igen, az Upgates-ben a megrendelés létrehozásához kötelező. Ha nincs kitöltve, az adott ország standard ÁFA-kulcsa kerül alkalmazásra. ### **Hogyan ismerem fel a marketplace megrendelést az Upgates-ben?** Minden marketplace megrendelés tartalmaz egy `Mergado Marketplaces import` belső megjegyzést, és a megrendelés azonosítója a **Bővített** szekcióban a **Külső rendelésszám** alatt található. ### **Szükséges a megrendeléseket a marketplace-en is aktiválni?** Igen, a szinkronizáció megfelelő működéséhez mind az Upgates, mind legalább egy marketplace (Allegro vagy Kaufland) számára aktiválni kell a megrendeléseket. ### **Mi történik, ha nem párosítom a szállítási és fizetési módokat?** A Mergado Marketplaces a marketplace-től kapott formátumban küldi az Upgates-be. Javasolt rendszeresen ellenőrizni és párosítani az új értékeket. --- További információkért olvasd el a [Megrendelések kezelése a Mergado Marketplaces-ben](/hu/mergado-marketplaces/megrendelesek-kezelese/) című cikket, vagy a kampánylétrehozási útmutatókat az [Allegrora](/hu/mergado-marketplaces/kampany-letrehozasa-termekfeltoltes-allegrora/) és a [Kauflandra](/hu/mergado-marketplaces/kampany-letrehozasa-termekfeltoltes-kauflandra/). --- ## [Megrendelések összekapcsolása a WooCommerce-szel](https://help.mergado.com/hu/mergado-marketplaces/megrendelesek-woocommerce/) # **Megrendelések összekapcsolása a WooCommerce-szel** A Mergado Marketplaces Bővítményben beállíthatod a megrendeléskezelést a WooCommerce-en keresztül. Ha a Webáruházadat WooCommerce-en üzemelteted és az Allegrón vagy Kauflandon értékesítesz, a megrendeléseidet közvetlenül a Webáruházad adminisztrációjában kezelheted. > :circus_tent: **A víziónk** egyszerű: kezeld a marketplace-t úgy, mint a Webáruházadat. Listázd rajtunk keresztül a Termékeket, és a megrendeléskezelést a megszokott platformodon végezd. ## **Működés** Az Allegro vagy Kaufland megrendeléseit 5 percenként automatikusan átküldi a Mergado Marketplaces a WooCommerce-be. Amint a Webáruházban módosítod a megrendelést (pl. elküldöttnek jelölöd), a státusz visszaszinkronizálódik a marketplace-re. Ha a WooCommerce-ből megkapjuk a nyomkövetési számot, azt is továbbítjuk a marketplace-re. **A marketplace adminisztrációt időnként külön is ellenőrizd.** ## **A megrendeléskezelés beállítása** ### **1. Hozd létre az API kulcsokat** A WooCommerce adminisztrációjában menj a **WooCommerce → Beállítások → Haladó → REST API** menübe, és generálj hozzáférési kulcsokat **Olvasás/Írás jogosultsággal** (felhasználói kulcs + titkos kulcs). ![Screenshot 2025-06-17 154931|690x255](upload://gWOR7nyTQTY63nfnLZeJgjr4LTr.png) > :warning: A kulcsokat biztonságosan mentsd el, csak egyszer jelennek meg. ### **2. Kapcsold össze a WooCommerce-t a Mergado Marketplaces-szel** A Mergado Marketplaces-ben menj a **Kapcsolatok** szekcióba, és válaszd a WooCommerce kapcsolatot. Töltsd ki: * A Webáruházad URL-jét (https-sel) * Az előző lépésben kapott API kulcsokat ![image|690x292](upload://sUAr5pjSUM9tSCGyTCPwAaarclI.png) Sikeres kapcsolódás után a részletek így néznek ki. A link segítségével közvetlenül az **Aktiváció** szekcióba ugorhatsz. ![image|690x302](upload://dFhDsyj4uHmrwGaoXEGHgvkrYAK.png) ### **3. Aktiváld a szinkronizációt** Menj a **Megrendelések → Aktiváció** szekcióba, aktiváld a szinkronizációt, és mentsd a változtatásokat. A szinkronizációt bármikor szüneteltetheted. > :information_source: A megrendeléskezelő rendszer nem szinkronizál visszamenőlegesen – az aktiválás előtti megrendelések nem kerülnek át. ![image|690x296](upload://nC5odtioEroD8EPFSBW7K1uCGSI.png) Kész! :tada: Mostantól a megrendelések rendszeresen szinkronizálódnak a marketplace-eid és a WooCommerce között. ## **Metaadatok a megrendelésben** A megrendelés metaadataiban a következőket találod: * Marketplace megrendelésszám * Allegro esetén: átvételi pont kódja és helye (pickup point) ![image|690x375](upload://k3ypzBCGtpUmotTlCyPpnzIU3Zm.png) ## **Jelenlegi korlátozások** * A nyomkövetési szám lekérése egyelőre **kizárólag** a hivatalos [Zásilkovna plugin](https://www.zasilkovna.cz/digitalni-integrace/woocommerce) és a [Toret Zásilkovna](https://toret.cz/produkt/woocommerce-zasilkovna/) plugin használatával lehetséges. * Nyomkövetési szám nélkül a Kauflandon nem lehet a státuszt **Elküldött**-re módosítani. * Nem dolgozunk **egyedi (custom) státuszokkal** a WooCommerce-ben – ezek a Bővítményben „ismeretlen" státuszra változnak. * Kizárólag az API kapcsolatot használjuk, WooCommerce plugint nem fejlesztünk. > :information_source: Ha problémába ütközöl vagy fejlesztési ötleted van, írj nekünk a [mergado@mergado.hu](mailto:mergado@mergado.hu) címre. ## **GYIK** ### **Milyen API jogosultságok szükségesek a WooCommerce kapcsolathoz?** **Olvasás/Írás** jogosultsággal rendelkező API kulcsokat kell generálnod a WooCommerce adminisztrációjában: **WooCommerce → Beállítások → Haladó → REST API**. ### **Hogyan működik a nyomkövetési szám továbbítása?** A nyomkövetési szám lekérése egyelőre kizárólag a hivatalos Zásilkovna plugin és a Toret Zásilkovna plugin használatával lehetséges. Ha megkapjuk a számot, továbbítjuk a marketplace-re. ### **Mi történik, ha egyedi státuszokat használok a WooCommerce-ben?** A Mergado Marketplaces nem dolgozik egyedi (custom) státuszokkal – ezek „ismeretlen" státuszra változnak a Bővítményben. ### **Visszamenőlegesen is átkerülnek a korábbi megrendelések?** Nem, csak az aktiválás utáni új megrendelések szinkronizálódnak. --- ## [Mergado Marketplaces Bővítmény](https://help.mergado.com/hu/mergado-marketplaces/mergado-marketplaces-bovitmeny/) # **Mergado Marketplaces Bővítmény** A Mergado Marketplaces egy Mergado Bővítmény, amellyel Termékek ezreit töltheted fel és kezelheted automatikusan az Allegro és Kaufland Global Marketplace piactereken. A Bővítmény párosítja a Termékeket a piactér katalógusával, listázza az egyedi Termékeket is, és biztosítja, hogy a készletek és árak mindig naprakészek legyenek. A szinkronizációnak köszönhetően csak a valóban raktáron lévő Termékeket kínálod, így elkerülheted a megrendelések sztornózását. A Shopify, WooCommerce, Shoptet Premium és UNAS Webáruház-platformok, valamint a POHODA könyvelési rendszer felhasználói a megrendeléseket közvetlenül a saját rendszerükben kezelhetik. A Bővítmény a GPSR rendelet betartásában is segít – az ajánlatok így mindig láthatóak maradnak. ## **Ár és számlázás** A Bővítmény ára: * 3 900 Ft havonta havi számlázás esetén, * 3 120 Ft havonta éves számlázás esetén. Az ár egy Webáruházra (a Mergadóban) vonatkozik, és fix, a Termékek, megrendelések vagy marketplace kapcsolatok számától függetlenül. A technikai összefüggések miatt a Bővítmény számlázása a Mergado Editorban választott számlázási gyakoriságnak megfelelően történik. Az egyes szolgáltatásokhoz nem választható eltérő számlázási gyakoriság. > A Mergado Marketplaces Bővítménynek 30 napos ingyenes próbaidőszaka van. ## **A Mergado Marketplaces Bővítményhez kapcsolódó alapfogalmak** - **Marketplace** – Internetes platform, amely egy helyen gyűjti össze más boltok és Webáruházak Termékeit (pl. Allegro, Kaufland). - **API kapcsolat** – Az API kapcsolat hatékony kommunikációt tesz lehetővé a Mergado és a marketplace között, azaz rendszeres és gyakori adatszinkronizációt. Az API marketplace kapcsolat fő előnye az elérhetőség frissítésének gyakorisága. - **Webáruház (a Mergadóban)** – Egy vagy több Projekt összefogása, amelyek egy Webáruház domainje alá tartoznak (pl. Az-en-boltom.hu). - **Projekt** – A Bemeneti feed Mergado Editorba történő feltöltése után Projekt jön létre. A Projektben történnek az összes adatmódosítások (pl. Lekérdezések, Szabályok és Automatizálások segítségével). - **Lekérdezés** – Termékek csoportja, amelyek megfelelnek egy megadott feltételnek (pl. az összes Termék közül a 500 CZK feletti árúakat szűrjük). - **Termék Feed** – Strukturált adatfájl, amely Elemeket tartalmaz a Termékek információival (név, kategória, eladási ár stb.). - **Elérhetőségi Feed** – Adatfájl, amely a Termékek raktári elérhetőségéről tartalmaz információkat. A Mergado Marketplaces Bővítmény Heureka vagy Mall Formátumban, illetve Mergado Marketplaces Formátumban fogadja el az elérhetőségi Feedet. - **Kampány** – A Mergado Marketplaces Bővítményben kampányok jönnek létre, amelyek a Termék Feedből olvassák az adatokat és ajánlatokat hoznak létre a marketplace-en. Előnye a kampányok különböző beállításainak lehetősége, pl. ha eltérő szállítási árlista vonatkozik a kis és nagy Termékekre, két kampányt hozhatsz létre különböző árlistákkal. - **Alapértelmezett értékesítési csatorna** – Az az Allegro piac, amelyen regisztráltad a céges fiókodat. Ha később úgy döntesz, hogy más piacokon is értékesítesz, az alapértelmezett értékesítési csatornán az ajánlatoknak aktívnak kell lenniük. Nem lehet az alapértelmezett értékesítési csatornán inaktív ajánlatokkal rendelkezni és egyben más piacon értékesíteni. Ha tehát az allegro.cz-n regisztráltad a céges fiókodat, a cseh az alapértelmezett értékesítési csatornád. - **Elem** – A Feed alapvető adathordozó egysége (pl. PRICE, PARAM stb.). - **Beágyazott Elem** – Az Elem beágyazott, ha az XML Feedben egy másik Elem nyitó és záró tagje között helyezkedik el. A leggyakoribb példa a PARAM Elembe beágyazott PARAM_NAME és PARAM_VAL Elemek. - **Elem értéke** – Az Elem adatokat hordoz, amelyeket az adott Elem értékeként jelölünk (pl. a `99` Elem értéke 99). - **Termék** – A Bemeneti Feedben az adatok egyedi tételekre vannak osztva, amelyek az adott tételről szóló adatokat tartalmazzák. Ezt a tételt nevezzük Terméknek. - **Ajánlat** – A Termék Feed Mergado Marketplaces Bővítménybe történő feltöltése után a Termékekből ajánlatok lesznek a marketplace-en. A marketplace-en minden Termékhez egy termékkártya tartozik, amelyhez különböző eladók ajánlatai kapcsolódnak. Az ajánlatok tehát árban és vásárlási feltételekben különböznek egymástól, de a termékkártyán lévő alapvető termékadatok, mint az EAN kód, gyártó vagy márka, azonosak. - **Ajánlat státusza** – A Mergado Marketplaces Bővítmény 15 percenként kapja meg a marketplace-től az egyes ajánlatok státuszait (pl. aktív, hiányos, hibás). - **Marketplace katalógus** – Termékkatalógus, amelyben minden egyedi Termékhez egy termékkártya tartozik, amelyhez az eladók csatlakozhatnak ajánlataikkal. - **Termékkártya** – Kártya a marketplace katalógusában, amely tartalmazza a termékkel kapcsolatos összes kötelező és rögzített paramétert. A termékkártyához a Termék azonosítója alapján kapcsolódik az ajánlat. - **Termék Feed szinkronizáció** – Az összes adat szinkronizálása a Termék Feed és a marketplace között. A Mergado Editorban történő automatikus Újragenerálás során csak a megváltozott Termékek szinkronizálódnak. - **Újragenerálás** – Az Újragenerálás lehetővé teszi az adatok frissítését a Projektben, beleértve a Kimeneti Feedet. Három folyamatból áll: import, Szabályok alkalmazása és export. - **Validáció** – A validáció szekció hibaüzeneteket tartalmaz, amelyek a Termékadatok marketplace-re történő feltöltése során felmerülő esetleges problémákat magyarázzák. - **Értékesítési dokumentumok** – Visszaküldési feltételek, reklamációs feltételek és szállítási árlista, amelyeket az Allegrón történő értékesítés megkezdése előtt ki kell tölteni az Allegro adminisztrációjában. ## **Mi szükséges a Mergado Marketplaces elindításához** * Ellenőrzött céges fiók a kiválasztott marketplace-en (Allegro vagy Kaufland) * Aktív fiók a Mergado Editorban * Termék Feed a Mergado Editorban EAN kódokkal (GS1 adatbázisból) * Elérhetőségi Feed Heureka/Mall Formátumban vagy Termék Feed Mergado Marketplaces Formátumban ## **Fő funkciók** ### **1. Automatikus listázás és Termékpárosítás** A Mergado Marketplaces lehetővé teszi: * Termékek ezreinek automatikus és valós idejű feltöltését a Kaufland és Allegro piactereire, * tételek párosítását a piactér meglévő katalógusával, * teljesen új termékkártyák létrehozását olyan árukhoz, amelyek még nem szerepelnek a katalógusban, * kötelező paraméterek pótlását a már meglévő, hiányos Allegro termékkártyákon. > A Mergado Marketplaces Bővítmény jelenleg kampányonként legfeljebb 200 ezer, Bővítményenként pedig legfeljebb 800 ezer Termék feltöltését teszi lehetővé. Nagyobb termékszám esetén írj nekünk a mergado@mergado.hu címre. ### **2. Gyors készletszinkronizáció** A Termékek elérhetősége 15 percenként frissül. Az elfogyott tételek automatikusan rejtve lesznek az ajánlatban, és az újra raktárra kerülés után ismét aktiválódnak, így mindig csak azt árusítod, ami valóban raktáron van. > Az elérhetőség szinkronizálásához elengedhetetlen az elérhetőségi Feed Heureka/Mall Formátumban vagy a Termék Feed Mergado Marketplaces Formátumban való csatlakoztatása a Mergado Marketplaces-hez. ### **3. Rendszeres termékadatok frissítése** Az összes termékadatot automatikusan frissíti a Mergado Editorban történő minden Feed Újragenerálás után. ### **4. Megrendelések szinkronizálása a Webáruház-megoldással** A Mergado Marketplaces-ben lehetőség van a megrendelések szinkronizálásának aktiválására. Az Allegro és Kaufland megrendeléseit 5 percenként automatikusan átküldi közvetlenül a Webáruház-megoldásodba, lehetővé téve a marketplace megrendelések kezelését közvetlenül a Webáruházadban. Jelenleg a megrendelések a Shopify, WooCommerce, UNAS és Shoptet Premium Webáruház-platformokhoz csatlakoztathatók. A megrendelések Webáruház-platformokhoz való csatlakoztatása a megfelelő API kulcs beillesztésével történik, vagy a Mergado Keychain Bővítményben (Shopify, UNAS), vagy közvetlenül a Mergado Marketplaces-ben (WooCommerce, Shoptet Premium). ### **5. Megrendelések exportálása CSV fájlban vagy megrendelési XML Feedben** A piacterek megrendeléseit egyszerűen átviheted a POHODA könyvelési rendszerbe az előkészített megrendelési XML Feed segítségével, vagy a megrendeléseket CSV fájlba exportálhatod és tovább dolgozhatsz velük igény szerint. ### **6. A GPSR rendelet betartása** A Mergado Marketplaces Bővítmény megkönnyíti a gyártóról, felelős személyről vagy biztonsági utasításokról szóló kötelező adatok pótlását. Ennek köszönhetően az ajánlatok láthatóak maradnak, és nincs veszélye annak, hogy az Allegro vagy Kaufland elrejtse őket. ## **Értesítések és validációs üzenetek** Közvetlenül a Mergado Marketplaces Bővítményben beállíthatod, milyen típusú értesítéseket szeretnél kapni. A Bővítményben validációs üzenetek is megjelennek, amelyek figyelmeztetnek a megadott adatokban található hibákra vagy eltérésekre. ## **GYIK** ### **Mi szükséges a Mergado Marketplaces használatának megkezdéséhez?** Szükséged van egy ellenőrzött céges fiókra a kiválasztott marketplace-en (Allegro vagy Kaufland), egy aktív Mergado Editor fiókra, EAN kódokat tartalmazó Termék Feedre, valamint egy elérhetőségi Feedre Heureka/Mall formátumban vagy Mergado Marketplaces formátumban. ### **Mennyibe kerül a Mergado Marketplaces Bővítmény?** Az ár 3 900 Ft havonta havi számlázás esetén, vagy 3 120 Ft havonta éves számlázás esetén. Az ár fix, a Termékek, megrendelések vagy marketplace kapcsolatok számától függetlenül. 30 napos ingyenes próbaidőszak is elérhető. ### **Milyen gyakran frissül a készletelérhetőség?** Az elérhetőség 15 percenként szinkronizálódik. Az elfogyott Termékek automatikusan rejtve lesznek, és az újra raktárra kerülés után ismét aktiválódnak. ### **Hány Terméket tölthetek fel egyszerre?** Kampányonként legfeljebb 200 ezer, Bővítményenként pedig legfeljebb 800 ezer Termék feltöltése lehetséges. Nagyobb termékszám esetén írj nekünk a mergado@mergado.hu címre. ### **Mely Webáruház-platformokkal működik a megrendelésszinkronizáció?** Jelenleg a Shopify, WooCommerce, UNAS, Shoptet Premium platformokkal és a POHODA könyvelési rendszerrel működik együtt. A megrendelések 5 percenként szinkronizálódnak. --- ## [Mergado Marketplaces értesítések beállítása](https://help.mergado.com/hu/mergado-marketplaces/mergado-marketplaces-ertesitesek-beallitasa/) # **Mergado Marketplaces értesítések beállítása** Az értesítéseket a Bővítmény főmenüjében az **Értesítések** szekcióban állíthatod be. Itt aktiválhatod a kiválasztott problémákról szóló figyelmeztetéseket e-mailben és Mergado üzeneteken keresztül. Magad döntheted el, milyen problémákról és kampányokról szeretnél tájékoztatást kapni. > :information_source: **Az értesítések küldését ebben a szekcióban bármikor deaktiválhatod.** Az Értesítések szekció 3 részre oszlik: * Általános beállítások * Hibafigyelmeztetések * Megrendeléskezelés ## **1. Általános beállítások** Te döntöd el, milyen módon szeretnél tájékoztatást kapni az esetleges problémákról. Ha a Mergado üzeneteket választod, az értesítések a Mergado jobb felső sarkában jelennek meg: ![image|690x79](upload://yFgCycqqb2pNCflEL1zZkmRQyya.png) Ha e-mailben szeretnéd megkapni az értesítéseket, aktiváld ezt a lehetőséget és add meg az e-mail címet. Az **E-mail hozzáadása** gombbal több e-mail cím mezőt is hozzáadhatsz. ![image|690x247](upload://pHZSJ2ZLoR96DeWr4G3NYwH5FcF.png) A figyelmeztető e-mail például így nézhet ki: ![image|602x500](upload://5uvFZLk9jPNxwFLELLUMNxrRhY.png) ## **2. Hibafigyelmeztetések** Válaszd ki, milyen problémákról szeretnél tájékoztatást kapni. A következő lehetőségek közül választhatsz: * **Kapcsolati hibák** – ha probléma lép fel a Kaufland vagy Allegro kapcsolattal, a választott csatornán értesítést kapsz. * **Megrendelés-szinkronizációs hibák** * **Elérhetőségi Feed hibák** – ha az elérhetőségi Feed valamiért nem érhető el, és nem történik frissítés a marketplace-en. * **Sikertelen Feed szinkronizáció** – figyelmeztetés a Termék Feed szinkronizációja során felmerült hibáról. * **Aktív ajánlatok csökkenése** – figyelmeztetés, ha bármely kampányban jelentősen csökken az aktív ajánlatok száma. Az elérhetőségi Feed hibájáról szóló figyelmeztetés esetén megjelenik egy ablak a kampányaid áttekintésével, ahol kiválaszthatod, mely kampányoknál szeretnél értesítést kapni: ![image|430x499](upload://wMXlWDv79JIkZDbTNfvYfFgLBfS.png) ## **3. Megrendeléskezelés** Az **Értesítések** szekcióban az új megrendelésekről szóló figyelmeztetéseket is beállíthatod. Magad döntöd el, mely napokon és órákban szeretnéd megkapni az értesítéseket, és azt is meghatározhatod, hogy Mergado üzeneteken vagy e-mailen keresztül kapd-e: ![image|590x139](upload://57pwh2S57guN3WPxu3t72To0C8I.png) ![image|507x500, 75%](upload://jUrKlW9ANhqiGdqS89JbD80Eh4Y.png) Az e-mail értesítésben a megrendelés ID-jára kattintva közvetlenül a megrendelés részleteire juthatsz az Allegrón/Kauflandon, vagy megtekintheted az új megrendeléseket a Mergado Marketplaces-ben: ![image](upload://p8oNm9PfNyiIXKCyndD5VdkH5PW) > Ne felejtsd el menteni a módosításokat a jobb felső sarokban lévő **Változások mentése** gombra kattintva. :bulb: ## **GYIK** ### **Hogyan kapok értesítést új megrendelésekről?** A **Megrendeléskezelés** szekcióban állítsd be, mely napokon és órákban szeretnél értesítést kapni, és válaszd ki, hogy Mergado üzeneteken vagy e-mailen keresztül kapd. ### **Milyen típusú hibaértesítések állíthatók be?** Beállíthatsz értesítéseket kapcsolati hibákról, megrendelés-szinkronizációs hibákról, elérhetőségi Feed hibákról, sikertelen Feed szinkronizációról és az aktív ajánlatok jelentős csökkenéséről. ### **Több e-mail címre is küldhetek értesítéseket?** Igen, az **E-mail hozzáadása** gombbal több e-mail cím mezőt is hozzáadhatsz az értesítések beállításainál. ### **Hogyan kapcsolhatom ki az értesítéseket?** Az értesítések küldését az **Értesítések** szekcióban bármikor deaktiválhatod a megfelelő opciók kikapcsolásával, majd a **Változások mentése** gombra kattintva. --- ## [Mergado Marketplaces Feed Formátum](https://help.mergado.com/hu/mergado-marketplaces/mergado-marketplaces-feed-formatum/) # **Mergado Marketplaces Feed Formátum** ## **Mi a Mergado Marketplaces Feed Formátum** A Mergado Marketplaces Feed Formátum a Mergado XML Formátumon alapul. Azoknak készült, akik szeretnék használni a Mergado Marketplaces Bővítményt, de nem biztosak benne, melyik Feed Formátum a legmegfelelőbb. Ez a Formátum megkönnyíti a döntést, gyorsabb kezdeti beállítást tesz lehetővé, és lehetővé teszi az elérhetőség szinkronizálását egyetlen Feeden keresztül. ## **A Feed Formátum célja** A Mergado Marketplaces Bővítmény használatához kétféle adat szükséges: * Termékadatok * Elérhetőségi adatok > Az elérhetőségi Feed a legtöbb eladó számára közvetlenül a Webáruház-megoldásából elérhető. Ha nem tudod, hol találod, az Elérhetőségi Feed cikkben megtalálod a Shoptet, Upgates, Eshop-rychle, WooCommerce és FASTCentrik útmutatókat. :bulb: Ha nincs elérhetőségi Feed a rendelkezésedre, a Mergado Editorral könnyen megoldhatod: 1. Hozz létre a Mergado Editorban egy új Projektet kizárólag az elérhetőséghez. Kimeneti Formátumként válaszd a **Mall vagy Heureka elérhetőségi Feedet**, és azt használd a Mergado Marketplaces-ben. Részletes útmutatót az Elérhetőségi Feed cikkben találsz. 2. Ha az elérhetőség (darabszám számformátumban) és a termékadatok egy Feedben szerepelnek, hozz létre egy Projektet a Mergado Editorban, és kimeneti Formátumként válaszd a **Mergado Marketplaces**-t. Így egyetlen Feed elegendő mind a termékadatok, mind az elérhetőség szinkronizálásához. ![image|690x339](upload://vWVvwp1eA9Q1mBHLEmQYzCBz1Lv.png) ## **A Feed Formátum előnyei és hátrányai** **Előnyök:** - Egyetlen Feed elegendő a Mergado Editorban – tartalmazza a termékadatokat és az elérhetőségi adatokat is. - Gyorsabb kampánylétrehozás a Mergado Marketplaces-ben: a kampányvarázslóban az Elemek automatikusan kitöltődnek, és nem kell külön elérhetőségi Feedet megadnod. ![image|690x297](upload://62uX1kdKwfPCCx7Hf8ndkftJuQX.png) **Hátrányok:** - A Mergado Marketplaces Feed adatai a Mergado Editorban beállított Feed Újragenerálás ütemezése szerint frissülnek – nem azonnal. A lehető legfrissebb elérhetőséghez a legjobb megoldás az elérhetőségi Feed közvetlen beszerzése a Webáruház-megoldásodból. ## **GYIK** ### **Mikor érdemes a Mergado Marketplaces Feed Formátumot választani?** Akkor, ha a Termék Feedben az elérhetőség számformátumban szerepel, és szeretnéd egyetlen Feedben kezelni a termékadatokat és az elérhetőséget. Így gyorsabb a kampánylétrehozás és kevesebb a beállítás. ### **Hogyan különbözik ez a formátum a Heureka/Mall elérhetőségi Feedtől?** A fő különbség: a Mergado Marketplaces formátum egyetlen Feedben tartalmazza a termékadatokat és az elérhetőségi adatokat is, míg a Heureka/Mall formátum esetén két külön Feed szükséges. ### **Milyen gyakran frissülnek az adatok ebben a formátumban?** A Mergado Editorban beállított Feed Újragenerálás ütemezése szerint. Ha a lehető legfrissebb elérhetőségi adatokra van szükséged, érdemes a Webáruházadból közvetlenül származó elérhetőségi Feedet használni. ### **Kötelező ezt a formátumot használni a Mergado Marketplaces-hez?** Nem, a Mergado Marketplaces Bővítmény a Mergado Editor összes formátumát elfogadja. Ez a formátum egy kényelmi lehetőség azok számára, akik egyetlen Feedben szeretnék kezelni a termék- és elérhetőségi adatokat. --- ## [Mergado Marketplaces validációs üzenetek](https://help.mergado.com/hu/mergado-marketplaces/mergado-marketplaces-validacios-uzenetek/) # **Mergado Marketplaces validációs üzenetek** A leggyakoribb validációs üzenetek magyarázata: **Az Allegro katalógusban ezen termékazonosító alatt nem található termékkártya, a létrehozáshoz menj a 'Termékkártyák' szekcióba** Ezek a Termékek még nem szerepelnek az Allegro termékkatalógusában – termékkártyát kell létrehozni számukra a **Termékkártyák** szekcióban. Részletes útmutatót a Termékkártyák szekcióban találsz. **A Kaufland katalógusban ezen EAN kód alatt nem található termékkártya, a létrehozáshoz menj a 'Termékkártyák' szekcióba** Ezek a Termékek még nem szerepelnek a Kaufland termékkatalógusában – termékkártyát kell létrehozni számukra a **Termékkártyák** szekcióban. Részletes útmutatót a Termékkártyák szekcióban találsz. **'...' nevű 'Gyártó adatok' nem létezik** Az Allegrón nincs előkészítve ezzel az egyedi névvel rendelkező gyártó kártyája. A gyártó kártyákat és egyedi neveiket [itt](https://salescenter.allegro.com/responsible-producers) ellenőrizheted. Az egyedi névnek pontosan meg kell egyeznie, hogy a kártya az ajánlathoz párosítható legyen. ![image|690x302](upload://j7i5wywEZnC8hwkXrJNSBGzTXz0.png) ![image|690x303](upload://3hJ8u1gpwf82QYj5oW2MwFv7D41.png) **A "Márka" paraméterhez helytelen érték lett megadva "..." / A "Gyártó" paraméterhez helytelen érték lett megadva "..."** Az Allegro változtatást hajtott végre: a márka/gyártó paraméternél már nem lehet az „egyéb" értéket használni, és saját márkát/gyártót sem lehet megadni, ha az nem szerepel az engedélyezett értékek listáján. Az új érték hozzáadását [itt](https://salescenter.allegro.com/parameter-value-suggestions/create-suggestion) kérvényezheted – az Allegro jóváhagyása után lesz listázható a termékkártya. > Az engedélyezett értékek a márka/gyártó paraméterhez kategóriánként eltérnek. Ha adott márka/gyártó Termékeit több kategóriában szeretnéd listázni, az Allegro oldalán minden kívánt kategóriához ki kell töltened az űrlapot. **A márkavédelmi feltételek hiányzó megerősítése miatt nem adhatsz fel ajánlatokat védett márkák Termékeivel** Az Allegrón először meg kell erősítened a márkavédelmi feltételeket [itt](https://salescenter.allegro.com/brands-to-protect?bi-s=art). Bővebben [ebben a cikkben](https://help.allegro.com/cs/sell/a/jak-se-starame-o-ochranu-znacek-na-allegru-q08bykna8fE) olvashatsz az Allegrótól. **Az ajánlat nem található, valószínűleg törlésre került a szortimentedből az Allegrón** Ez akkor fordulhat elő, ha te magad törölted az ajánlatot az Allegróról, vagy az ajánlat több mint 60 napig befejezett státuszban volt az Allegrón. Ebben az esetben az Allegro automatikusan archiválja az ajánlatot, a Bővítményben viszont még a régi Allegro ajánlat ID van tárolva. * :bulb: Ezt a folyamatot már továbbfejlesztettük: amint ezt az üzenetet megkapjuk az Allegrótól, az ajánlat „nem szinkronizált" címkét kap, és a következő Újrageneráláskor új ajánlatot hozunk létre az Allegrón. * Ha a Mergado Marketplaces-ben még mindig látod ezt az üzenetet, végezz manuális **Termék Feed szinkronizációt** a kampány beállításaiban, majd várd meg a következő automatikus szinkronizációt. **Az ajánlatból hiányzik az elérhetőség, ellenőrizd, hogy az elérhetőségi Feed helyes Formátumú-e, és a 'Termék ID' megegyezik-e a Termék és az elérhetőségi Feedben** Az adott Termék ID alatt az elérhetőségi Feedben nincs érték, vagy a Termék teljesen hiányzik belőle. Ha ez az üzenet az összes Terméknél megjelent, **ellenőrizd az elérhetőségi Feed formátumát ([Heureka](https://sluzby.heureka.cz/napoveda/dostupnostni-feed/) és [Mall](https://knowledgebase.mallgroup.com/marketplace-mall-xml-feed/3/)) és hogy a Termék ID-k pontosan megegyeznek-e a Termék és az elérhetőségi Feedben**. A megoldás lépései: 1. Menj a **Validáció** szekcióba, és kattints erre a validációs üzenetre. 2. Megjelennek az ajánlatok, amelyeknél hiányzik az elérhetőség. Másold ki valamelyik Termék Termék ID-ját. 3. Menj a kampány beállításaihoz, másold ki alul az elérhetőségi Feed linkjét, és nyisd meg. 4. CTRL+F segítségével keresd meg a kimásolt Termék ID-t, és ellenőrizd, hogy az elérhetőség megtalálható-e a Feedben. 5. Ellenőrizd, hogy a kampány beállításaiban a Termék ID-hoz a helyes Elemet párosítottad-e. Ha módosítani kell, nyisd meg az **Elemek** szekciót, változtasd meg a párosítást, mentsd, és kattints a **Termék Feed szinkronizálása** gombra. 6. Ha az adott Termékhez nem található elérhetőség, ellenőrizd, hogy nem elfogyott Termékekről van-e szó – ezeket amúgy sem érdemes a marketplace-en kiállítani. **Az Allegro termékkártyán hiányoznak kötelező paraméterek, add hozzá őket a 'Termékkártyák kiegészítése' részen keresztül a 'Termékkártyák' szekcióban** Az Allegro termékkártyáról hiányoznak kötelező paraméterek. Ez az üzenet nem a te adataidra vonatkozik, hanem annak a felhasználónak az adataira, aki létrehozta a termékkártyát az Allegrón. Ezeket a paramétereket a **Termékkártyák kiegészítése** részben pótolhatod. **Az Allegrónak nem sikerült pontosan megfelelő Terméket találnia** Ezzel az üzenettel már csak kivételes esetekben találkozhatsz. A Bővítmény kiértékeli a termékkártyák állapotát, és az ajánlatot a legjobban kitöltötthez rendeli. **Hiba történt az Allegro oldalán: a termékkártya nem tartalmaz képet, ezért nem történt meg a párosítás** A Bővítmény küld termékképeket az Allegrora, de csak ajánlati képekként. A képeket megpróbálhatod manuálisan pótolni az Allegro feladási űrlapján. **A [shipping_group] paraméter nincs megadva vagy hibás értékkel rendelkezik** Ez azt jelzi, hogy nincsenek helyesen kitöltve a szállítási csoportok a Kaufland Seller Portalban. Menj a **Beállítások → [Szállítási beállítások](https://sellerportal.kaufland.de/shipping-groups)** szekcióba. > :information_source: **Ha a validációs üzeneted nem szerepel a listában, vagy segítségre van szükséged, írj nekünk a mergado@mergado.hu címre.** ## **GYIK** ### **Mit jelent az, hogy "nem található termékkártya" az Allegro vagy Kaufland katalógusban?** Az adott Termékhez még nem létezik termékkártya a marketplace katalógusában. A **Termékkártyák** szekcióban kell létrehoznod egy új kártyát. ### **Miért jelenik meg az "ajánlatból hiányzik az elérhetőség" üzenet?** Az elérhetőségi Feedben nincs érték az adott Termék ID alatt, vagy a Termék teljesen hiányzik belőle. Ellenőrizd, hogy a Termék ID-k pontosan megegyeznek-e a Termék és az elérhetőségi Feedben. ### **Hogyan oldjam meg a "[shipping_group] paraméter hibás" üzenetet?** Menj a Kaufland Seller Portalba a **Beállítások → Szállítási beállítások** szekcióba, és ellenőrizd, hogy a szállítási csoportok helyesen vannak-e kitöltve. ### **Mit tegyek, ha az ajánlat "nem található" vagy "törlésre került"?** Ha az ajánlatot te törölted, vagy az Allegro archiválta (60 nap befejezett státusz után), a rendszer automatikusan „nem szinkronizált" címkét ad neki, és a következő Újrageneráláskor új ajánlatot hoz létre. Ha az üzenet továbbra is megjelenik, végezz manuális **Termék Feed szinkronizációt** a kampány beállításaiban. --- ## [Shopify kapcsolat létrehozása a Mergado Marketplaces-hez](https://help.mergado.com/hu/mergado-marketplaces/shopify-kapcsolat/) # **Shopify kapcsolat létrehozása a Mergado Marketplaces-hez** Ha szeretnéd használni a Shopify megrendelésimportot, először létre kell hoznod a Shopify kapcsolatot a Mergado Keychainben. > Ha már van Mergado Keychain kapcsolatod a Shopify adminisztrációban lévő egyedi alkalmazás segítségével, elég az alkalmazásnál módosítani a jogosultságok listáját (lásd alább). Ez az útmutató a Shopify hivatalos dokumentációján alapul az alkalmazások **Shopify Developer Dashboard** segítségével történő létrehozásához. **Hivatalos forrás:** https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard > Egy **egyedi (custom) API alkalmazást** hozol létre egy konkrét Webáruházhoz. Az alkalmazást **nem szükséges** közzétenni a Shopify App Store-ban. ## **1. Alkalmazás létrehozása a Shopify-ban** Ahhoz, hogy a Mergado Marketplaces API hozzáférjen a Shopify fiókodhoz, létre kell hoznod egy alkalmazást a szükséges jogosultságokkal. ### **a) Nyisd meg a Shopify Developer Dashboardot** A Shopify Developer Dashboardba kétféleképpen juthatsz el: **A variáns: Közvetlen hozzáférés** 1. Nyisd meg a https://dev.shopify.com/ oldalt 2. Jelentkezz be a Shopify fiókoddal 3. A bal oldali menüben nyisd meg az **Apps** szekciót **B variáns: A Shopify adminisztráción keresztül** 1. Nyisd meg a Webáruházad **Shopify adminisztrációját** 2. Menj a **Settings → Apps** menübe 3. Kattints a **Develop apps** gombra 4. Kattints a **Build apps in Dev Dashboard** gombra ![chrome-capture-2026-01-21](upload://yi6GOpgymNKPGNIwieYIEm0BHWX) ### **b) Hozz létre egy új alkalmazást** 1. Győződj meg róla, hogy az **Apps** szekcióban vagy 2. Kattints a **Create app** gombra 3. Válaszd a **Start from Dev Dashboard** lehetőséget 4. Add meg az alkalmazás nevét (pl. `Mergado integration`) 5. Kattints a **Create** gombra ![chrome-capture-2026-01-21 (1)](upload://8FjBEpoi86YFJFvAvjwu3m6pb2U) Az alkalmazás létrehozása után a **Versions** fülre leszel átirányítva. ### **c) Hozd létre az alkalmazás verzióját és állítsd be a jogosultságokat (scopes)** Minden alkalmazásnak rendelkeznie kell legalább egy **verzióval**, hogy telepíthető legyen a Webáruházba. ![chrome-capture-2026-01-21 (3)](upload://n2eN7qTp5uEwW4Vg107cgWPlaEN) ### **d) Hozzáférési jogosultságok beállítása** ![chrome-capture-2026-01-21 (4)](upload://a9N5N5ZyBYPIqLQzjeOHSoDJAvH) 1. Az **Access** szekcióban kattints a **Select scopes** gombra 2. A felugró ablakban keresd meg és jelöld be: > A Mergado Marketplaces-hez szükséges jogosultságok: > * `read_customers` + `write_customers` > * `write_orders` + `read_orders` > * `read_products` > * `read_shipping` + `write_shipping` > * `write_order_edits` + `read_order_edits` > Ha API-n keresztül is szeretnél Termékeket importálni a Mergadóba, add hozzá: > * `write_products` > * `read_products` > * `read_markets` 3. Erősítsd meg a **Done** gombra kattintva ### **e) Verzió kiadása (release)** 1. Görgess lejjebb az oldalon 2. Kattints a **Release** gombra 3. A megerősítő ablakban a verzió nevét üresen hagyhatod 4. Erősítsd meg a **Release** gombra kattintva ![chrome-capture-2026-01-21 (7)](upload://msYm8un3v1sfB2h8SW0wmY5u2iA) Az alkalmazás verziója most már kiadva van és készen áll a telepítésre. ### **f) Telepítsd az alkalmazást a Webáruházba** ![chrome-capture-2026-01-21 (8)](upload://eM5OjIktwKtAtKiUmQ46Lnaaj7j) ![chrome-capture-2026-01-21 (9)](upload://ehh1CVDX6VdLfZqToOLrSzzhU7w) 1. A bal oldali menüben nyisd meg a **Home** részt 2. Jobb felül kattints az **Install app** gombra 3. Válaszd ki a Shopify Webáruházat, amelyet össze szeretnél kapcsolni a Mergadóval 4. Át leszel irányítva a Shopify adminisztrációba 5. A telepítést erősítsd meg az **Install** gombra kattintva Az alkalmazás most már telepítve van a Webáruházban. ### **2. Shopify kapcsolat a Mergado Keychainben** ![image|690x372](upload://luXAz55T8xpFbiVHzA7Ku8acRqQ.png) A Shopify Mergado Keychainben történő csatlakoztatásához a következőkre van szükséged: * **Shopify URL:** * Nyisd meg a csatlakoztatott Webáruházad **Shopify adminisztrációját** * A bal oldali menüben nyisd meg a **Home** részt * A **Domains** szekcióban másold ki a Webáruház URL-jét * Példa: `your-store.myshopify.com` * **Shopify API hozzáférési kulcs:** * Menj vissza a **Shopify Developer Dashboardba** * Nyisd meg az alkalmazásodat * Menj a **Settings** részbe * A **Credentials** szekcióban másold ki a **Secret** értéket, és illeszd be a Mergado Keychainbe ### **3. Megrendelések aktiválása a Mergado Marketplaces-ben** Menj a **Megrendelések → Aktiváció** szekcióba a Mergado Marketplaces-ben, kattints a Shopify ikonra, és mentsd a változtatásokat. A szinkronizációt bármikor szüneteltetheted. A megrendelések 5 percenként szinkronizálódnak. > :information_source: A rendszer nem szinkronizál visszamenőlegesen – az aktiválás előtti megrendelések nem kerülnek át. Kész! :tada: Mostantól a megrendelések rendszeresen szinkronizálódnak a marketplace-eid és a Shopify között. ## **GYIK** ### **Milyen jogosultságok szükségesek a Shopify alkalmazáshoz?** A Mergado Marketplaces-hez a következők szükségesek: `read_customers` + `write_customers`, `write_orders` + `read_orders`, `read_products`, `read_shipping` + `write_shipping`, `write_order_edits` + `read_order_edits`. ### **Hol találom a Shopify API hozzáférési kulcsot?** A **Shopify Developer Dashboardban** nyisd meg az alkalmazásodat, menj a **Settings** részbe, és a **Credentials** szekcióban másold ki a **Secret** értéket. Ezt illeszd be a Mergado Keychainbe. ### **Hogyan aktiválom a megrendelések szinkronizálását?** A Mergado Marketplaces-ben menj a **Megrendelések → Aktiváció** szekcióba, kattints a Shopify ikonra, és mentsd a változtatásokat. A megrendelések 5 percenként szinkronizálódnak. ### **Közzé kell tennem az alkalmazást a Shopify App Store-ban?** Nem, egy egyedi (custom) API alkalmazást hozol létre a konkrét Webáruházadhoz. Közzétételre nincs szükség. --- ## [Termékkártyák létrehozása az Allegro és Kaufland számára](https://help.mergado.com/hu/mergado-marketplaces/termekkartyak-letrehozasa/) # **Termékkártyák létrehozása az Allegro és Kaufland számára** Ha a kampány létrehozása után a **Validáció** szekcióban azt az üzenetet látod, hogy az adott Termékhez nem található termékkártya az Allegro vagy Kaufland katalógusában, újat kell létrehozni. :warning: A Kaufland esetében a termékkártya-létrehozási folyamatba mind a hiányzó kártyás, mind a „Hiányos" státuszú Termékek bekerülnek. **Új Kaufland kampány létrehozása után érdemes megvárni az első státusz-szinkronizációt, és csak utána kezdeni a termékkártyák létrehozását.** > :notebook_with_decorative_cover: **Fogalomtár:** > **Marketplace katalógus** = Termékkatalógus, amelyben minden Termékhez egy termékkártya tartozik. > **Termékkártya** = Kártya a katalógusban az összes kötelező termékparaméterrel. > **Ajánlat** = A Termékek a feltöltés után ajánlatokká válnak a marketplace-en. A **Termékkártyák** szekcióba a kampány menüjéből vagy a validációs üzenet melletti ikonra kattintva juthatsz el: ![image|690x271](upload://imITBRtZQj8SVElwfiyudXYqfIM.png) **1. Kötelező elemek párosítása** A termékkártyák létrehozásához a következő elemeket kell párosítanod: * **Képek** * **Terméknév** – az értékesítési csatorna nyelvén * **Kategória** * **Termékleírás** – csak a Kaufland számára kötelező > :exclamation: Termékazonosítóként EAN kód szükséges. ![image|690x203](upload://x2f38MT8tldnyKXnQr8nSnxjHAr.png) A kampány beállításaiban nyisd meg az **Elemek** szekciót, párosítsd az elemeket, mentsd, majd kattints a **Termék Feed szinkronizálása** gombra. **2. Kategóriák párosítása** A párosítás után elérhető lesz a Termékkártyák szekció: ![image|690x187](upload://bZNhohciPFklKUjterobdJx5Xox.png) **Párosítsd a Feed kategóriáidat az Allegro/Kaufland kategóriáira.** Több lehetőséged van: - **Kategóriák javaslata** – tömeges előpárosítás - Kategóriafa böngészése - Keresés a kategóriafában - **Kategória javaslata** funkció ![image|690x265](upload://yx79xHF6PMT2IYGWL6tycn8Dwr6.png) **3. Paraméterek kitöltése** A párosított kategóriára kattintva megjelenik a Termékek táblázata a szükséges paraméterekkel. * **Kötelező paraméterek** – piros háttérrel, kitöltésük szükséges * **Nem kötelező paraméterek** – fehér háttérrel, tetszőleges számban tölthetők ki Az értékeket kitöltheted Termék szinten vagy az egész oszlopra egyszerre. Választhatsz saját érték és Feedből származó Elem párosítás között. ![image|568x494, 75%](upload://oTpRiT1xMFpw7qSaJA9EGF0XxpJ.png) ![image|568x494, 75%](upload://yfWyKDQNWYODBmoDi0CI9wUsY4x.png) > :information_source: Ha a márkád nincs az Allegro engedélyezett értékei között, válaszd a „nincs márka" lehetőséget, vagy kérvényezd a hozzáadást [itt](https://salescenter.allegro.com/parameter-value-suggestions/create-suggestion). **4. Listázás indítása** Legalább egy Termék összes kötelező paraméterének kitöltése után elérhető lesz a **Termékkártyák listázásának indítása** gomb. ![image|690x227](upload://5aqaxZ6hcsVTpUkbGz0AB3EgGbY.png) > :bulb: Sikeres listázás után a paramétereket a **Listázott kártyák szerkesztése** szekcióban módosíthatod. Az Allegro és Kaufland esetében is **módosítási javaslat** kerül elküldésre a marketplace-nek. A listázás eredményét a táblázatban lévő ikonokból látod: ![image|24x32](upload://u9KnxFemY9dR3SQ10E0tRM5C0yz.png) A termékkártya még nem lett listázva. ![image|25x21](upload://6JpwyeCOVbMHX2WXITpXBB8LFvk.png) Hiba történt a listázáskor. ![image|26x21](upload://gW33tzhQWi0wvY7NGlcCp8KeIq2.png) A termékkártya sikeresen létrejött. ![image|27x27](upload://vTsPN6DeYHhgid199LDsThISpQD.png) **Csak Kauflandnál** – a kártya jóváhagyásra vár (ez akár napokig is tarthat). **5. Termékek ellenőrzése** A termékkártya listázása után ellenőrizd a Terméket közvetlenül a piactér adminisztrációjában is. > A Kaufland jóváhagyási folyamata napokig tarthat. Jóváhagyás után a Termék „Nem szinkronizált" címkét kap, és a következő szinkronizáció során csatlakozik az ajánlat. > :bulb: Az **Összes új Termékre is kitölteni** opcióval és az **Új Termékek automatikus listázásának aktiválása** funkcióval automatizálhatod a folyamatot. ![image](upload://ylE2W7N0z7cGaw415HKN9rpE0y1) Az automatikus listázást bármikor deaktiválhatod. Hiba esetén a validációs üzenet alapján manuálisan kell javítanod és listáznod. ## **GYIK** ### **Mikor kell termékkártyát létrehoznom?** Ha a **Validáció** szekcióban azt az üzenetet látod, hogy az adott Termékhez nem található termékkártya az Allegro vagy Kaufland katalógusában. ### **Milyen adatok szükségesek a termékkártya létrehozásához?** Szükséges a Képek, Terméknév (az értékesítési csatorna nyelvén), Kategória és EAN kód párosítása. A Kaufland esetében a Termékleírás is kötelező. ### **Mennyi ideig tart a Kaufland termékkártya jóváhagyása?** Akár napokig is tarthat. Jóváhagyás után a Termék „Nem szinkronizált" címkét kap, és a következő szinkronizáció során automatikusan csatlakozik az ajánlat. ### **Hogyan automatizálhatom a termékkártyák létrehozását?** Az **Összes új Termékre is kitölteni** opcióval és az **Új Termékek automatikus listázásának aktiválása** funkcióval. Az új Termékek így automatikusan listázódnak. --- ## [Mergado Keychain beállítása](https://help.mergado.com/hu/mergado-keychain/mergado-keychain-beallitasa/) # **Mergado Keychain beállítása** ## **Mi a Mergado Keychain** A [Mergado Keychain](https://store.mergado.com/detail/mergadokeychain/#about) egy olyan Bővítmény, amely összekapcsolja a Mergado fiókodat külső rendszerekkel – például a Heurekával, a Zboží.cz-vel, a Google Analytics-szel, a Shopify-jal és más platformokkal. Úgy működik, mint egy biztonságos kulcstartó: itt tárolhatod a bejelentkezési adataidat, és a Mergado ezek segítségével automatikusan le tudja tölteni a szükséges adatokat más Bővítményekhez (pl. [Bidding Fox](https://store.mergado.com/detail/biddingfox.dev/#about) vagy [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about)), illetve statisztikák és elemzések készítéséhez. Ha egyszer összekapcsoltad a fiókjaidat a külső platformokkal, nem kell újra megadnod a bejelentkezési adatokat. A Mergado automatikusan csatlakozik a platformokhoz és naprakészen tartja a hozzáférést. ## **Miért van szükséged a Mergado Keychainre** A Keychainre akkor van szükséged, ha úgy döntesz, hogy használod a Mergado valamelyik [Bővítményét](https://store.mergado.com/), amely külső platformok adataival dolgozik. Ha például a Heurekán szeretnél biddelni a Bidding Fox Bővítménnyel, a helyes működéséhez be kell állítanod a Heureka kapcsolatot a Keychainben. Ugyanígy szükséges a kapcsolat akkor is, ha a projektjeidnél az *Analitika* fülön szeretnéd követni a Heurekán vagy a Zboží.cz-n történő értékesítések statisztikáit. Ezzel biztosítod, hogy a Mergado Editor és a Bővítményei aktuális adatokkal dolgozhassanak külső forrásokból – kézi bejelentkezés vagy fájlfeltöltés nélkül. A Keychainnek köszönhetően: * minden kapcsolat és hozzáférési adat egy helyen van, * nem kell ismételten megadnod a külső platformokhoz tartozó bejelentkezési adatokat az egyes Bővítményekben, * a Heurekáról, Zboží.cz-ről, Google Analytics-ből és más rendszerekből származó adataid automatikusan szinkronizálódnak, * minden kapcsolat titkosított és biztonságos – a bejelentkezési adataidat még az ügyfélszolgálati munkatársaink sem látják. A Bővítmény minden felhasználó számára ingyenes, és automatikusan aktiválódik a Mergado Projekt létrehozásakor. Az adott platformhoz való csatlakozást a bejelentkezési adatok kitöltésével kell befejezned. Az egyes kapcsolatok céljairól bővebben a Mergado Keychain kapcsolatok céljai cikkben olvashatsz. ## **Hogyan működik a Mergado Keychain** Miután a Keychainben kitöltöd a bejelentkezési adataidat a kiválasztott külső rendszerhez (pl. Heureka), a Keychain elmenti, biztonságosan titkosítja, és csak a Mergado Editor és a kiválasztott Bővítmények számára teszi elérhetővé. Ennek köszönhetően a Mergado például betöltheti a kampányteljesítmény adatokat, követheti a kattintásokat, bevételeket és konverziókat, ellenőrizheti a kreditegyenleget az árösszehasonlítókon, vagy dolgozhat a fiókjaidból származó exportokkal és statisztikákkal. ## **Hogyan aktiválhatod a Mergado Keychaint** A Keychain minden Webáruházadhoz automatikusan aktiválódik a Mergado Projekt létrehozásakor – nem kell kézzel elindítanod. Az egyes platformokhoz való csatlakozást a következőképpen állíthatod be: 1. A Mergado Editor [főoldalán](https://app.mergado.com/) kattints arra a Webáruházra, amelyhez a Keychainben be szeretnéd állítani a kapcsolatot. 2. A bal oldali sávban látod a futó Bővítményeid listáját. Kattints a **Mergado Keychainre**. 3. A **Kapcsolatok** részben válaszd ki a listából a platformot (pl. Heureka, Zboží.cz, Google Analytics vagy Shopify), amelyhez kapcsolatot szeretnél létrehozni, és kattints a **Létrehozás** gombra. 4. Töltsd ki a kért adatokat, és kattints a **Bejelentkezés** gombra. A **Források** részben a Keychainen keresztül statikus XML fájlt is csatlakoztathatsz a Mergadóhoz. Így a Mergado fejlettebb információkat is feldolgozhat, például az árubeszerzési költségeket vagy nyereségszámításokat. ## **A leggyakoribb problémák megoldása** ### **1. A Keychain kapcsolati hibát jelez** Leggyakrabban ez a jelszóváltozás, átmeneti szolgáltatáskimaradás vagy a kapcsolat lejárata miatt történik. Ebben az esetben töröld a Keychainben a meglévő kapcsolatot, majd jelentkezz be újra az aktuális adatokkal. ### **2. A Heureka jelszóváltozása után nem működik a kapcsolat** Minden bejelentkezési adat változása után meg kell újítanod a kapcsolatot a Keychainben: töröld a meglévőt, és hozd létre újra az új adatokkal. ### **3. A kapcsolat nem újítható meg** Ha a csatlakozás ismételten sikertelen, próbáld meg a következőket: 1. Jelentkezz be inkognitó ablakban. 2. Töröld a böngésző gyorsítótárát. 3. Ellenőrizd, hogy a bejelentkezési adatok közvetlenül a platformon működnek-e. ## **GYIK** ### **Mi a Mergado Keychain?** A Mergado Keychain egy Bővítmény, amely összekapcsolja a Mergado fiókodat külső platformokkal – például a Heurekával, a Zboží.cz/Sklikkel, a Google Analytics-szel vagy a Shopify-jal. Biztonságosan tárolja a bejelentkezési adataidat, hogy a Mergado Editor és a Bővítményei (pl. Bidding Fox vagy Pricing Fox) dolgozhassanak a szükséges adatokkal. ### **Szükségem van a Keychainre, ha csak a Mergado Editort használom?** Ha a feedek szerkesztésénél csak a Mergado Editort használod, a Keychain nem mindig szükséges. Ha viszont a Zboží.cz-hez vagy Heurekához tartozó projekteknél az *Áttekintés* vagy *Analitika* fülön szeretnéd követni az értékesítési statisztikákat, be kell állítanod a kapcsolatot a Keychainben. A Keychain kapcsolat szükséges akkor is, ha Shopify vagy UNAS platformon üzemeltetett Webáruház adatait használod termékforrásként, illetve az olyan Bővítmények használatához, mint a Pricing Fox, Bidding Fox vagy Mergado Marketplaces. ### **Fizetős a Mergado Keychain?** Nem. A Mergado Keychain minden Mergado Editor felhasználó számára ingyenes, és automatikusan aktiválódik a Projekt létrehozásakor. ### **Hogyan tudom meg, hogy aktív-e a Keychain?** A Mergadóban a [Felhasználói adatok](https://app.mergado.com/user/details/) oldalon, a **Bővítményekhez való hozzáférés** részben, a **Webáruházakhoz** oszlopban látod a Mergado Keychaint. A Keychainre kattintva megjelenik azoknak a Webáruházaknak a listája, amelyeknél aktív – és innen közvetlenül át tudsz navigálni az adott Webáruházhoz. ### **Hogyan hozok létre Heureka vagy Zboží.cz kapcsolatot?** 1. A Mergado Editor [főoldalán](https://app.mergado.com/) kattints arra a Webáruházra, amelyhez be szeretnéd állítani a kapcsolatot. 2. A bal oldali sávban kattints a **Mergado Keychainre**. 3. A **Kapcsolatok** részben válaszd ki a platformot (pl. Heureka, Sklik API Fénix, Google Analytics vagy Shopify), és kattints a **Létrehozás** gombra. 4. Töltsd ki a kért adatokat, és kattints a **Bejelentkezés** gombra. ### **Csatlakoztathatom a Skliket a Keychainen keresztül?** Igen. Ha a Mergado számára lehetővé szeretnéd tenni a Sklik/Zboží.cz adatokhoz való hozzáférést, állítsd be a **Sklik API Fénix** kapcsolatot a Keychainben. ### **Mit tegyek, ha a Keychain lecsatlakozik vagy kapcsolati hibát jelez?** Leggyakrabban ez a jelszóváltozás, átmeneti szolgáltatáskimaradás vagy a kapcsolat lejárata miatt történik. Töröld a Keychainben a meglévő kapcsolatot, majd jelentkezz be újra az aktuális adatokkal. ### **A Heureka jelszóváltozása után nem működik a kapcsolat. Mit tegyek?** Minden bejelentkezési adat változása után újra be kell állítanod a kapcsolatot a Keychainben: töröld a meglévőt, és hozd létre újra az új adatokkal. Ez nemcsak a Heurekára vonatkozik, hanem minden más külső rendszerre is. ### **A Keychain kapcsolat nem újítható meg, mit próbáljak még?** Próbáld ki a következő lépéseket: * Jelentkezz be a böngésző inkognitó ablakában. * Töröld a gyorsítótárat és a sütiket. * Heureka esetén ellenőrizd, hogy a bejelentkezési adataid közvetlenül a Heureka adminisztrációjában működnek-e. ### **Biztonságban vannak a bejelentkezési adataim?** Igen. Minden adatot, amit a Keychainben megadsz, titkosítva és biztonságosan tárolunk. Még a Mergado ügyfélszolgálati munkatársai sem láthatják őket. --- ## [Mergado Keychain kapcsolatok céljai](https://help.mergado.com/hu/mergado-keychain/mergado-keychain-kapcsolatok-celjai/) # **Mergado Keychain kapcsolatok céljai** ## **1. Sklik API Fénix** A Sklik API Fénix kapcsolatot akkor hozd létre, ha olyan Bővítményeket használsz, amelyeknek a helyes működéséhez szükségük van a Zboží.cz/Sklik adataira, illetve a Seznam Vásárlásokon történő hirdetéshez kapcsolódó adatokra. A kapcsolatot akkor is hozd létre, ha nem használsz semmilyen Bővítményt, de a Projekt *Analitika* oldalán szemléletes grafikonokon szeretnéd követni például a hirdetési ár vagy a kattintások alakulását. A gyűjtött adatok kizárólag analitikai és optimalizálási célokra szolgálnak. A Mergado nem fér hozzá a vásárlók személyes adataihoz, sem az egyes megrendelések részleteihez. ### **Bővítmények, amelyek a Sklik adatokhoz való hozzáféréshez Keychain kapcsolat beállítását igénylik** * [Pricing Fox](https://store.mergado.com/detail/pricingfox) – a versenytársak adatainak (ár, készletelérhetőség, biddelési pozíció, ajándékok, gyártók, kategóriák) és a Termékek teljesítménystatisztikáinak feldolgozásához. * [Bidding Fox](https://store.mergado.com/detail/biddingfox) – a termékkártyás pozíciók, termék- és szállítási árak, versenytársi elérhetőség adatainak és a Termékek teljesítménystatisztikáinak feldolgozásához. * [Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements) – a hirdetés teljesítménystatisztikáinak feldolgozásához. ### **Hogyan hozd létre a kapcsolatot a Keychainben** 1. A Keychainben a Kapcsolatok menüben keresd meg a Sklik API Fénix-et és kattints a Létrehozás gombra. 2. Add meg az Üzlet ID-t és az API Fénix kulcsot, amelyet a Sklik fiókodban találsz. A pontos lépéseket, [hogyan szerezheted meg az API Fénix kulcsot, a Sklik súgójában találod](https://napoveda.sklik.cz/pokrocila-prace-s-daty/sklik-api/#api-fenix-klic). * Az API kulcs generálásához közvetlenül azzal a fiókkal és jelszóval kell bejelentkezned a Sklikbe, amelyhez az API kulcsot generálni szeretnéd. Nem elég csak adminisztrátorként bejelentkezni. 3. Kattints a Mentés gombra, és ezzel létrejön a kapcsolat. ## **2. Heureka** A Heureka kapcsolatot akkor hozd létre, ha olyan Bővítményeket használsz, amelyeknek a helyes működéséhez szükségük van a Heureka adataira. A kapcsolatot akkor is hozd létre, ha nem használsz semmilyen Bővítményt, de a Projekt *Analitika* fülén szeretnéd követni a Heurekán történő hirdetésed teljesítményét. Itt a következő statisztikákat és grafikonokat találod: * bevétel, * hirdetési költség, * kattintások, * konverziók, * nyereség, * statisztikával rendelkező Termékek, * konverziós ráta, * átlagos CPC, * átlagos CPO, * átlagos PNO, * átlagos konverzióérték, * átlagos konverziós nyereség. A Keychain kapcsolat létrehozásával az *Áttekintés* fül is bővül a következő statisztikákkal: * Termékek párosítottsága, * Webáruházak száma a termékkártyán, * kattintások száma, * megrendelések, * bevétel. A Keychain kapcsolat létrehozása után a Mergado hozzáfér a Heureka fiókod kiválasztott statisztikai adataihoz. Konkrétan a következőkről van szó: ### **Teljesítményadatok** * kattintások száma * kattintási költségek (CPC) * megrendelések száma * bevétel * nyereség és költség-forgalom arány (PNO) * statisztikába bekerült Termékek száma * elérhető statisztikai adatok nélküli Termékek száma ### **Fiók állapotadatok** * kredit összege és állapota * aktív PPC módról szóló információ * tanúsításról szóló információ (pl. Vásárlók által ellenőrizve) * információ arról, hogy a bolt válaszol-e a vásárlói kérdésekre * Termék XML Feed elérhetősége * a Heureka adminisztrációjában megadott kapcsolattartási adatok * bolt logója * külföldi fiókmutációk száma ### **Fiók összesített statisztikák** * összes költség * összes kattintás A gyűjtött adatok kizárólag statisztikai célokra, a Termékek teljesítményértékelésére és a kampányok optimalizálására szolgálnak. A Mergado nem fér hozzá a vásárlók személyes adataihoz, sem az egyes megrendelések részleteihez. ### **Bővítmények, amelyek a Heureka adatokhoz való hozzáféréshez Keychain kapcsolat beállítását igénylik** * [Pricing Fox](https://store.mergado.com/detail/pricingfox) – a versenytársak adatainak (ár, készletelérhetőség, biddelési pozíció, ajándékok, gyártók, kategóriák) feldolgozásához. A Heureka API kulcsot közvetlenül a Pricing Fox Bővítménybe is be kell illesztened. * [Bidding Fox](https://store.mergado.com/detail/biddingfox) – a Heureka Szortiment jelentésének adataihoz, a hirdetés teljesítménystatisztikáihoz és a termékkártya aktuális információihoz. A Heureka API-t közvetlenül a Bidding Fox Bővítménybe is be kell illesztened. * [Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements) – a Heureka Szortiment jelentésének adataihoz és a hirdetés teljesítménystatisztikáihoz. A Heureka API-t közvetlenül a Bidding Fox Elements Bővítménybe is be kell illesztened. * [Pricing Rank](https://store.mergado.com/detail/pricingrank) – a Heureka Szortiment jelentésének adatainak feldolgozásához. * [Heureka Watchdog](https://store.mergado.com/detail/heurekawatchdog) – a nem párosított áru, az egyedülálló termékkártyák és más hirdetési hibák felderítéséhez. * [Pricing Monitor](https://store.mergado.com/detail/pricingmonitor) – az áraid versenytársakhoz viszonyított figyeléséhez és elemzéséhez. * [Credito](https://store.mergado.com/detail/credito) – a kreditegyenleged ellenőrzéséhez. ### **Hogyan hozd létre a kapcsolatot a Keychainben** 1. A Keychainben a Kapcsolatok menüben keresd meg a Heureka-t és kattints a Létrehozás gombra. 2. Add meg ugyanazokat a bejelentkezési adatokat (e-mail és jelszó), amelyekkel a Heureka fiókod adminisztrációjába bejelentkezel. * Ha a Heureka fiókodban megváltoztatod a bejelentkezési adatokat, ne feledkezz meg arról, hogy itt is frissítened kell, különben a Keychain kapcsolati hibát fog jelezni. Töröld a kapcsolatot és hozd létre újra az új bejelentkezési adatokkal. 3. Válaszd ki, hogy a cseh vagy a szlovák Heurekához szeretnél kapcsolatot létrehozni. 4. Kattints a Mentés gombra, és ezzel létrejön a kapcsolat. ## **3. Google Analytics 4** Ezt a kapcsolatot akkor hozd létre, ha olyan Bővítményeket használsz, amelyeknek a helyes működéséhez szükségük van a Google Analytics 4 adataira. A kapcsolatot akkor is hozd létre, ha nem használod az alábbi Bővítmények egyikét sem, de a Projektjeidben az Analitika és Áttekintés füleken szeretnéd követni az elemzéseket és a hirdetésed teljesítményét. Konkrétan a Mergado a következő adatokat jeleníti meg: * látogatások/kattintások száma, * megrendelések száma, * megrendelések összes értéke. ### **Bővítmények, amelyek a Google Analytics 4 adatokhoz való hozzáféréshez Keychain kapcsolat beállítását igénylik** * [Pricing Fox](https://store.mergado.com/detail/pricingfox) * [Bidding Fox](https://store.mergado.com/detail/biddingfox) * [Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements) * [Fox Data+](https://store.mergado.com/detail/foxplus) ### **Hogyan hozd létre a kapcsolatot a Keychainben** 1. A Keychainben a Kapcsolatok menüben keresd meg a Google Analytics 4-et és kattints a Létrehozás gombra. 2. Jelentkezz be a Google fiókoddal és hagyd jóvá a Mergado hozzáférését az adataidhoz, ezzel létrejön a kapcsolat. ## **4. Google Táblázatok** Az összekapcsolás lehetővé teszi a Kimeneti feed exportálását a Mergadóból a Google Drive-on lévő Google Táblázatokba. ### **Hogyan hozd létre a kapcsolatot a Keychainben** 1. A Keychainben a Kapcsolatok menüben keresd meg a Google Táblázatok-at és kattints a Létrehozás gombra. 2. Jelentkezz be a Google fiókoddal és hagyd jóvá a Mergado hozzáférését az adataidhoz, ezzel létrejön a kapcsolat. Ha viszont a Google Táblázataidból szeretnél adatokat importálni a Mergadóba, nem kell kapcsolatot létrehoznod a Keychainben, de a kiválasztott táblázatnál [helyesen kell beállítanod a táblázat megosztását CSV-ként](https://support.google.com/docs/answer/183965?hl=hu). ## **5. Shopify** Ezt a kapcsolatot akkor hozd létre, ha a Webáruházadat a Shopify platformon üzemelteted, és a termékadataidat szeretnéd bevinni egy Mergado Editor Projektbe. A kapcsolatra akkor is szükséged lesz, ha úgy döntesz, hogy használod a [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) Bővítményt. A kapcsolatnak köszönhetően a [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) szinkronizálhatja az online piacterek megrendeléseit, és 5 percenként automatikusan átviheti őket közvetlenül a Webáruházadba, ahol kényelmesen kezelheted őket a Webáruházad megrendeléseivel együtt. A Keychain kapcsolat létrehozásához szükséged lesz Client ID-ra és Client Secretre. Hogyan generálhatod ezeket a szükséges Shopify API hitelesítéseket, arról az Új Projekt – Shopify API hitelesítések generálása cikkben olvashatsz. ### **Hogyan hozd létre a kapcsolatot a Keychainben** 1. A Keychainben a Kapcsolatok menüben keresd meg a Shopify-t és kattints a Létrehozás gombra. 2. Töltsd ki a Shopify Store URL-t az Admin API-hoz. * Ez nem a Webáruházad szokásos URL-je. Az API kommunikációhoz használt Shopify store címről van szó. Ennek formátuma: store-name.myshopify.com. * A store-name-et a Shopify adminisztráció URL-jében találod. Példa: admin.shopify.com/store/{store-name}/ 3. Töltsd ki a Client ID-t. 4. Töltsd ki a Client Secretet. 5. Kattints a Bejelentkezés gombra, és ezzel létrejön a kapcsolat. ## **6. UNAS** Ezt a kapcsolatot akkor hozd létre, ha a Webáruházadat az UNAS platformon üzemelteted, és a termékadataidat szeretnéd bevinni egy Mergado Editor Projektbe. A kapcsolatra akkor is szükséged lesz, ha úgy döntesz, hogy használod a [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) Bővítményt. A kapcsolatnak köszönhetően a Mergado Marketplaces szinkronizálhatja az online piacterek megrendeléseit, és 5 percenként automatikusan átviheti őket közvetlenül a Webáruházadba, ahol kényelmesen kezelheted őket a Webáruházad megrendeléseivel együtt. A Keychain kapcsolat létrehozásához szükséged lesz API kulcsra. Hogyan generálhatod az UNAS-ban a szükséges API kulcsot, arról a Hogyan biztosítsd az UNAS Webáruház-platform összekapcsolását a Mergado Editorral cikkben olvashatsz. ### **Hogyan hozd létre a kapcsolatot a Keychainben** 1. A Keychainben a Kapcsolatok menüben keresd meg az UNAS-t és kattints a Létrehozás gombra. 2. Töltsd ki a Bolt nevét (ID). 3. Töltsd ki az API kulcsot. 4. Kattints a Mentés gombra, és ezzel létrejön a kapcsolat. ## **GYIK** ### **Mire szolgál a Mergado Keychain?** A Mergado Keychain egy központi hely, ahol a különböző platformokhoz (Sklik, Heureka, Google Analytics, Shopify, UNAS stb.) szükséges API kapcsolatokat hozhatod létre és kezelheted. Ezek a kapcsolatok biztosítják, hogy a Mergado Bővítmények hozzáférjenek a szükséges adatokhoz. ### **Kötelező minden kapcsolatot létrehozni?** Nem, csak azokat a kapcsolatokat kell létrehoznod, amelyekre szükséged van. Ha például nem használsz Heureka Bővítményeket és nem kell Heureka analitika, nem kell Heureka kapcsolatot létrehoznod. ### **Mi történik, ha megváltoztatom a jelszavamat egy csatlakoztatott platformon?** Ha megváltoztatod a bejelentkezési adataidat (pl. Heureka jelszó), a Keychain kapcsolati hibát fog jelezni. Töröld a kapcsolatot és hozd létre újra az új bejelentkezési adatokkal. ### **Milyen adatokhoz fér hozzá a Mergado a kapcsolatok révén?** A gyűjtött adatok kizárólag analitikai, statisztikai és optimalizálási célokra szolgálnak. A Mergado nem fér hozzá a vásárlók személyes adataihoz, sem az egyes megrendelések részleteihez. --- ## [Kimeneti feed védelme a Mergadóban](https://help.mergado.com/hu/biztonsag-es-technikai-kovetelmeny/kimeneti-feed-vedelem/) # **Kimeneti feed védelme a Mergadóban** ## **Miért érdemes védeni a kimeneti feedet?** A kimeneti feed tartalmazza az összes adatot, amelyet a szerkesztés után továbbítasz a hirdetési platformoknak (pl. Heureka, Google, Facebook). Bár a feedet általában csak az adott platform olvassa, jogos igény, hogy az adataid ne legyenek bárki számára elérhetők. ## **Hogyan védi a Mergado a kimeneti feedeket?** A Mergadóban a kimeneti feedet nem lehet jelszóval védeni (HTTP-hitelesítés), viszont a hozzáférés természetes módon korlátozott az egyedi, nem kereshető URL-nek köszönhetően. ### **1. Hosszú hash az URL-ben** Minden kimeneti feed **egyedi URL-t kap, amely egy hosszú biztonsági kulcsot (hash-t) tartalmaz**. Ez a hash nem kitalálható – a feed nem kereshető nyilvánosan és nem indexelik a keresőmotorok. Egy kimeneti feed URL-je például így néz ki: https://data.mergado.com/12345/export_87f14aab7e9d4c21.xml A kimeneti feed címét tehát **csak azok ismerik, akikkel megosztottad** (pl. a hirdetési platform, amelynek a feed készül). ### **2. Titkosított HTTPS-kapcsolat** A Mergado és a célplatformok közötti kommunikáció **titkosított HTTPS-protokollon** zajlik, így a feed adatait **nem lehet elfogni vagy elolvasni az átvitel során**. ### **3. Hozzáférési napló** A Mergado **naplózza a feedletöltéseket** – a dátumot, időpontot, IP-címet és a szerver válaszát. Így nyomon követheted, hogy csak a várt platformok töltik-e le a feedet, vagy történt-e illetéktelen hozzáférés. A letöltési adatokat a projekt **Előzmények** oldalán találod. Szűrj a **Letöltés** típusra, és megkapod, mikor és ki töltötte le a feedet. > **Tipp:** A szűrt letöltési előzményeket töltsd le CSV-fájlba, majd nyisd meg Excelben – ott könnyedén kereshetsz user-agentekre, csoportosíthatsz vagy tovább szűrheted az adatokat. ### **4. IP-szűrés a Symlink Stork bővítménnyel** Ha teljes kontrollt szeretnél a kimeneti feed hozzáférése felett, használd a **[Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about) bővítményt**. Ezzel beállíthatod, hogy **a feed URL-je csak meghatározott IP-címekről legyen elérhető**. A Symlink Storkról bővebben a bővítmény dokumentációjában olvashatsz. ## **Új kimeneti feed URL generálása** A projekt beállításaiban bármikor **generálhatsz új biztonsági kulcsot (hash-t) a meglévő URL-hez**. Ezzel megváltozik a 32 karakteres véletlenszerű karakterlánc az URL-ben. **Lépések:** 1. A kiválasztott projektben nyisd meg a **Beállítások** oldalt. 2. A **Kimeneti feed** mezőnél kattints a ceruza ikonra. 3. Jelöld be a **Tudom, mit csinálok** jelölőnégyzetet. 4. Erősítsd meg az **Új URL generálása** gombbal. 5. A változás **a következő adatexport után** lép érvénybe. Ha nem akarsz várni az automatikus újragenerálásra, indítsd el az exportot manuálisan: **Beállítások** → **Újragenerálás** → **Export indítása**. Az export befejezése után az **Áttekintés** oldalon láthatod a frissített URL-t. > **Tipp:** A kimeneti feed URL-jének változása hatással van minden kapcsolódó szolgáltatásra. Ne felejtsd el frissíteni az URL-t azokon a platformokon is, ahol használod. Teljesen új URL-t **a projekt duplikálásával** is kaphatsz. A duplikált projekt **átveszi a beállításokat**, de új kimeneti feed URL-t kap. Az eredeti projektet ezután törölheted, és a hirdetési csatornákon az új címre cserélhetsz. A projekt duplikálásáról bővebben az ügyfélszolgálat útmutatóiban olvashatsz. ## **GYIK** ### **Lehet jelszóval védeni a kimeneti feedet?** Nem. A Mergadóban a kimeneti feedeket nem lehet jelszóval védeni (pl. HTTP-hitelesítéssel). A védelmet az egyedi, nem kitalálható és nyilvánosan nem kereshető URL biztosítja. ### **Hogyan van védve a kimeneti feed?** Minden kimeneti feed egyedi URL-t kap, amely egy hosszú biztonsági kulcsot (hash-t) tartalmaz. A feed nem indexelhető, és a linket csak azok ismerik, akikkel megosztottad. Emellett a Mergado az adatokat titkosított HTTPS-protokollon továbbítja, így az átvitel során senki nem olvashatja el azokat. ### **Meg lehet állapítani, ki tölti le a feedet?** Igen. A projekt Előzmények oldalán megtekintheted a letöltési naplókat: mikor történt a letöltés, milyen IP-címről, és milyen szerver-választ adott. Így ellenőrizheted, hogy csak a várt rendszerek (pl. Heureka, Google) töltik-e le a feedet. A letöltési előzményeket szűrheted és CSV-be exportálhatod. ### **Hogyan szerezhetek új URL-t a kimeneti feedhez?** Kétféleképpen: **1. Új biztonsági kulcs (hash) generálásával:** A projektben nyisd meg a **Beállítások** oldalt, és a **Kimeneti feed** mezőnél kattints a ceruza ikonra. Jelöld be a **Tudom, mit csinálok** lehetőséget, majd erősítsd meg az **Új URL generálása** gombbal. A változás a következő adatexport után lép érvénybe – ha nem akarsz várni, indítsd el az exportot manuálisan: **Beállítások** → **Újragenerálás** → **Export indítása**. *Tipp: Az URL változása hatással van minden szolgáltatásra, amely ezt a címet használja – ne felejtsd el frissíteni.* **2. A projekt duplikálásával:** Ha teljesen új URL-re van szükséged, duplikáld a projektet. Az új projekt megtartja a beállításokat, de új kimeneti feed URL-t kap. Az eredetit ezután törölheted, és a hirdetési csatornákon az új címre cserélhetsz. A projekt duplikálásáról bővebben az ügyfélszolgálat útmutatóiban olvashatsz. ### **Miért nincs jelszavas védelem?** A jelszavas védelem megakadályozná a hirdetési rendszerek (pl. Heureka, Google) közvetlen hozzáférését – ezek automatikusan csatlakoznak a feedhez, és nem tudnak bejelentkezési adatokat megadni. Az egyedi, hash-t tartalmazó URL biztonságosabb és univerzálisabb megoldás, amely nem korlátozza a kampányaid működését. ### **Korlátozhatom a hozzáférést adott IP-címekre?** Igen. Használd a [Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about) bővítményt – ezzel beállíthatod, hogy a kimeneti feedhez csak meghatározott IP-címekről lehessen hozzáférni. Minden más kísérlet blokkolva lesz. --- ## [A Mergado és bővítményei IP-címei](https://help.mergado.com/hu/biztonsag-es-technikai-kovetelmeny/mergado-ip-cimek/) # **A Mergado és bővítményei IP-címei** ## **Miért fontos ismerni a Mergado IP-címeit?** Ha a webáruházad vagy a szervered **whitelisttel védett (vagyis csak meghatározott IP-címekről engedélyezett a hozzáférés)**, engedélyezned kell **a Mergado és a bővítményei IP-címeit**. Enélkül a Mergado nem tudja letölteni a feedet, és a bővítmények sem működnek megfelelően. ## **A Mergado IP-címe** A **Mergado Editor** működéséhez az alábbi IP-cím engedélyezése szükséges: > **81.31.39.112** ## **Bővítmények IP-címei** Ha a [Mergado Store](https://store.mergado.com/?lang=hu)-ból **bővítményt** is használsz, **annak IP-címét** is add hozzá a whitelisthez: |Bővítmény|IP-cím| | --- | --- | |[Bidding Fox](https://store.mergado.com/detail/biddingfox/#about)|81.31.39.116| |[Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements/#about)|81.31.39.116| |[Blending Bull](https://store.mergado.com/detail/blendingbull/#about)|178.238.44.169| |[Credito](https://store.mergado.com/detail/credito/#about)|178.238.44.138| |[Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/#about)|81.31.39.116| |[Fox Data+](https://store.mergado.com/detail/foxplus/#about)|81.31.39.116| |[Heureka Watchdog](https://store.mergado.com/detail/heurekawatchdog/#about)|178.238.44.138| |[Kvinono](https://store.mergado.com/detail/kvinono/#about)|81.31.39.114| |[Mergado Agencies](https://store.mergado.com/detail/mergadoagencies/#about)|81.31.39.114| |[Mergado Dashboards](https://store.mergado.com/detail/mergadodashboards/#about)|81.31.39.114| |[Mergado Drive](https://store.mergado.com/detail/mergadodrive/#about)|178.238.44.165| |[Mergado Files](https://store.mergado.com/detail/files/#about)|178.238.44.163| |[Mergado Keychain](https://store.mergado.com/detail/mergadokeychain/#about)|81.31.39.112| |[Mergado Logbook](https://store.mergado.com/detail/logbook/#about)|178.238.44.138| |[Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts/#about)|81.31.39.114| |[Mergado Notifications](https://store.mergado.com/detail/mergadonotifications/#about)|81.31.39.114| |[Mergado Orders](https://store.mergado.com/detail/mergadoorders/#about)|81.31.39.114| |[Mergado Pages](https://store.mergado.com/detail/pages/#about)|178.238.44.138| |[Mergado Sources](https://store.mergado.com/detail/clickinggoat/#about)|81.31.39.114| |[Mergado ToDo List](https://store.mergado.com/detail/todo/#about)|178.238.44.138| |[Mergado Translate](https://store.mergado.com/detail/ordelogytranslate/#about)|81.31.39.114| |[Pairing Bear](https://store.mergado.com/detail/pairingbear/#about)|81.31.39.112| |[PPC Wolf](https://store.mergado.com/detail/ppcwolf/#about)|178.238.44.164| |[Pricing Fox](https://store.mergado.com/detail/pricingfox/#about)|81.31.39.116| |[Pricing Monitor](https://store.mergado.com/detail/pricingmonitor/#about)|178.238.44.138| |[Pricing Rank](https://store.mergado.com/detail/pricingrank/#about)|178.238.44.138| |[Repairman](https://store.mergado.com/detail/xmlrepairman/#about)|178.238.44.138| |[Scraping Camel](https://store.mergado.com/detail/scrapingcamel/#about)|178.238.44.145| |[Seznam Index Checker](https://store.mergado.com/detail/seznamindexchecker/#about)|178.238.44.138| |[Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about)|178.238.44.138| |[URL Checker](https://store.mergado.com/detail/urlchecker/#about)|178.238.44.138| ## **GYIK** ### **Miért kell ismernem a Mergado IP-címét?** Ha a bemeneti feeded IP-whitelisttel védett, az engedélyezett címek közé fel kell venned a Mergado IP-címét is. Ellenkező esetben a Mergado nem fér hozzá az adataidhoz, és a projekt feldolgozása nem lehetséges. ### **Mit tegyek, ha a feedem whitelisttel védett és a Mergado nem tudja letölteni?** Add hozzá a whitelisthez a 81.31.39.112 IP-címet. Ha bővítményeket is használsz, ellenőrizd a fenti táblázatban az adott bővítmény IP-címét, és azt is vedd fel a listára. ### **Elég egyetlen IP-címet engedélyeznem?** Ha csak a Mergado Editort használod (bővítmények nélkül), elegendő a 81.31.39.112 engedélyezése. Ha bővítményeket is használsz (pl. Bidding Fox, Pricing Fox, Feed Image Editor), azok IP-címeit is add hozzá a whitelisthez. ### **Mit tegyek, ha a Mergado jelzi, hogy nem sikerült letölteni a feedet?** Ellenőrizd a következőket: 1. A 81.31.39.112 IP-cím szerepel-e a webáruházad whitelistjén. 2. A szerver nem blokkolja-e a hozzáférést SSL- vagy tanúsítvány-probléma miatt. 3. A feed nincs-e egyszerre többféle védelemmel ellátva (pl. whitelist + hash, ami a Shoptet feedeknél gyakori hiba). ### **Gyakran változnak a Mergado IP-címei?** Nem. A Mergado IP-címei stabilak, és csak kivételes esetben változnak. Változás esetén erről időben tájékoztatunk a [fórumon](https://forum.mergado.hu/). ### **Hogyan ellenőrizhetem, hogy a Mergado letölti-e a feedet?** Nyisd meg a projektet a Mergadóban, és lépj az Előzmények oldalra. Az Eseménytípus szűrőben válaszd a Letöltés lehetőséget – így láthatod a letöltési kísérletek naplóját az időponttal és IP-címmel együtt. --- ## [Védett feedek letöltése a Mergadóban](https://help.mergado.com/hu/biztonsag-es-technikai-kovetelmeny/vedett-feedek-letoltese/) # **Védett feedek letöltése a Mergadóban** **A Mergado képes védett bemeneti feedeket is kezelni** – legyen szó jelszavas védelemről, IP-whitelistről vagy hash-alapú hozzáférésről. Az alábbiakban megmutatjuk, hogyan állítsd be mindegyiket. ## **Milyen védelmi módszereket támogat a Mergado?** ### **1. HTTP-hitelesítés (felhasználónév + jelszó)** Ha a feeded **bejelentkezéssel van védve**, a Mergado csak akkor tudja beolvasni, ha **az URL-ben megadod a bejelentkezési adatokat**: ***https://felhasznalo:jelszo@www.webshopod.hu/feed.xml*** **a. Új projekt létrehozásakor** A bemeneti feed URL-jét a fenti formátumban add meg a projekt létrehozásakor. **b. Meglévő projekt feedjének levédése** Ha egy **már meglévő projekt bemeneti feedjét** utólag védted le jelszóval, **cseréld le az URL-t** a projekt beállításaiban: * Nyisd meg a **projektet** a Mergadóban. * A bal menüben kattints a **Beállítások** menüpontra. * Az **Általános beállítások** fül alatt, a **Bemeneti feed** mezőben cseréld le az URL-t a jelszavas formátumra: *https://felhasznalo:jelszo@www.webshopod.hu/feed.xml* * Kattints a **Mentés** gombra. * Javasoljuk az **újragenerálás indítását**. * Ugyanazon a **Beállítások** oldalon kattints az **Újragenerálás** fülre, majd az **Összes újragenerálása** gombra. Ellenőrizd a kimeneti adatokat. ### **2. IP-whitelist** Ha a feeded csak meghatározott IP-címekről érhető el, add hozzá **a Mergado IP-címét** a whitelisthez: > **81.31.39.112** ### **3. Hash-alapú védelem (titkos kulcs az URL-ben)** Ha a feeded **hash-sel van védve** (egy hosszú karaktersorozat az URL-ben, amely hozzáférési kulcsként működik), egyszerűen add meg a teljes URL-t a Mergadóban: *https://www.webshopod.hu/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a* Ha **egy meglévő projekt feedjét** utólag védted le hash-sel, **cseréld le az URL-t** a projekt beállításaiban: * Nyisd meg a **projektet** a Mergadóban. * A bal menüben kattints a **Beállítások** menüpontra. * Az **Általános beállítások** fül alatt, a **Bemeneti feed** mezőben cseréld le az URL-t a hash-t tartalmazó változatra: *https://www.webshopod.hu/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a* * Kattints a **Mentés** gombra. * Javasoljuk az **újragenerálás indítását**. * Ugyanazon a **Beállítások** oldalon kattints az **Újragenerálás** fülre, majd az **Összes újragenerálása** gombra. Ellenőrizd a kimeneti adatokat. ## **Shoptet feedek védelme** **A Shoptet adminisztrációjában kétféle módon védheted az XML feedeket:** a. IP-whitelist b. Hash-alapú védelem A Mergado mindkettőt kezeli, de **ha egyszerre mindkettő aktív**, a feed letöltése sikertelen lesz. Ezért **csak az egyiket hagyd bekapcsolva**. **Lépések:** 1. Jelentkezz be a **Shoptet fiókodba**. 2. Az adminisztrációban kattints a **Kapcsolatok**, majd az **XML feedek** menüpontra. 3. Kattints a **Biztonság** fülre. 4. A **Hozzáférés-védelem** részben csak az egyik módszert jelöld be. 5. **Mentsd el** a beállítást. A választott módszer alapján vagy add hozzá a Mergado IP-címét (81.31.39.112) a whitelisthez, vagy a hash-t tartalmazó URL-t add meg a Mergadóban. ## **GYIK** ### **Megbirkózik a Mergado a jelszóval védett feedekkel?** Igen. Add meg a bemeneti feed URL-jét ebben a formában: https://felhasznalo:jelszo@www.webshopod.hu/feed.xml Ha a feedet a projekt létrehozása után védted le, cseréld le az URL-t a projekt beállításaiban. ### **Védhetek jelszóval egy meglévő projekt bemeneti feedjét?** Igen. Cseréld le a bemeneti feed URL-jét a projekt beállításaiban olyanra, amely tartalmazza a felhasználónevet és jelszót: 1. Nyisd meg a projektet, és kattints a Beállítások menüpontra. 2. Az Általános beállítások fülön, a Bemeneti feed mezőben cseréld le az URL-t: https://felhasznalo:jelszo@www.webshopod.hu/feed.xml 3. Kattints a Mentés gombra. 4. Az Újragenerálás fülön kattints az Összes újragenerálása gombra, és ellenőrizd az adatokat. ### **Védhetek hash-sel egy meglévő projekt bemeneti feedjét?** Igen. Cseréld le a bemeneti feed URL-jét a projekt beállításaiban olyanra, amely tartalmazza a hash-t: 1. Nyisd meg a projektet, és kattints a Beállítások menüpontra. 2. Az Általános beállítások fülön, a Bemeneti feed mezőben cseréld le az URL-t: https://www.webshopod.hu/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a 3. Kattints a Mentés gombra. 4. Az Újragenerálás fülön kattints az Összes újragenerálása gombra, és ellenőrizd az adatokat. ### **A feedem csak bizonyos IP-címekről érhető el. Mit tegyek?** Add hozzá a Mergado IP-címét az engedélyezett címekhez: 81.31.39.112 ### **A feedem hash-sel van védve. Le tudja tölteni a Mergado?** Igen. Add meg a teljes URL-t a hash-sel együtt (pl.: https://www.webshopod.hu/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a). A Mergado felismeri és gond nélkül beolvassa. ### **A Mergado nem tudja letölteni a Shoptet feedet. Mit tegyek?** Ellenőrizd a Shoptet adminisztrációjában, hogy nem aktív-e egyszerre mindkét védelem (IP-whitelist és hash). Ha igen, csak az egyiket hagyd bekapcsolva: 1. Jelentkezz be a Shoptet adminisztrációba. 2. Kattints a Kapcsolatok → XML feedek → Biztonság fülre. 3. A Hozzáférés-védelem részben csak az egyik módszert jelöld be. 4. Mentsd el a beállítást. --- ## [Hozzáférés a Mergado demókörnyezethez](https://help.mergado.com/hu/fejlesztoknek/hozzaferes-a-demo-kornyezethez/) # **Hozzáférés a Mergado demókörnyezethez** Ez az útmutató végigvezet a saját Mergado Store bővítményed létrehozásán, a Mergado API-hoz való csatlakozáson és a biztonságos tesztelésen közvetlenül a Mergadóban, fizetés nélkül. A Mergado lehetővé teszi a fejlesztők számára, hogy saját integrációkat („bővítményeket") hozzanak létre, amelyek kibővítik az editor funkcióit vagy kommunikálnak az API-val. Hivatalos „demókörnyezet" előre feltöltött adatokkal nem létezik — ehelyett néhány lépésben elkészítheted a saját tesztprojektedet. ## **Lépésről lépésre** ### **1) Hozz létre fiókot a Mergadóban** Ha még nincs fiókod, regisztrálj az **app.mergado.com** oldalon. ### **2) Hozd létre a saját bővítményedet** 1. Nyisd meg: **[https://app.mergado.com/developers/create-app/](https://app.mergado.com/developers/create-app/)** 2. Töltsd ki a bővítmény alapadatait. 3. A létrehozás után megkapod a hozzáférési adatokat (pontosabban hozzáférést azokhoz az entitásokhoz, amelyeknél a bővítmény be van kapcsolva). ### **3) Készítsd elő a tesztprojektet *(ha a bővítményed projektszinten működik)*** 1. A Mergadóban hozz létre egy **új projektet** teszteléshez. 2. Tölts fel egy **teszt feedet** – elég egy **kis feed** néhány termékkel. 3. A **projekt beállításaiban** kapcsold a projektet **tesztüzemmódba**, hogy a tesztelés **ingyenes** legyen. ### **4) Kapcsold be a bővítményt a projektben** A **projekt beállításaiban** engedélyezd (kapcsold be) a bővítményedet. Ezzel hozzáférést kap azokhoz az **entitásokhoz** (feedekhez/projektekhez), amelyeket olvashat és szerkeszthet. ### **5) Autorizáció és API-hívások** * Az autorizáció menete: **[https://mergado.github.io/docs/api/authorization.html](https://mergado.github.io/docs/api/authorization.html)** * API-dokumentáció: **[https://mergado.docs.apiary.io/#](https://mergado.docs.apiary.io/#)** > **Figyelj az API-verzióra:** A használt verzió befolyásolja az endpointok viselkedését. Ha a verzió nem egyezik, a működés eltérhet a dokumentációtól. ## **Tippek a hatékony teszteléshez** * **Nem létezik központi demó webáruház** – minden fejlesztő saját tesztprojektet készít. * A **tesztüzemmód** biztosítja, hogy a tesztelésért **ne kelljen fizetned**. * Ha a bővítményed **projektszintű hozzáférést** igényel, **engedélyezd** az adott projektben. * **Gyors tesztekhez** elegendő egy **kis feed** néhány termékkel – **nem szükséges** éles adatokat feltölteni. * Használj **külön tesztfiókot/projektet** az integrációkhoz, hogy **ne nyúlj hozzá** az éles adatokhoz. ## **GYIK** ### **Létezik hivatalos demókörnyezet adatokkal?** Nem. Központi demóadatok nem állnak rendelkezésre. Hozd létre a saját tesztprojektedet a Mergadóban. ### **Hol regisztrálhatok a Mergadóba?** Az **app.mergado.com** oldalon. ### **Hol hozhatom létre a bővítményemet?** A **[https://app.mergado.com/developers/create-app/](https://app.mergado.com/developers/create-app/)** címen. Az alapadatok kitöltése után hozzáférést kapsz azokhoz az entitásokhoz, amelyeknél a bővítmény be van kapcsolva. ### **Hogyan tesztelhetek díjmentesen?** A **projekt beállításaiban** kapcsold be a **tesztüzemmódot**. ### **Szükségem van projektre, ha a bővítményem projektekkel dolgozik?** Igen. Hozz létre egy **tesztprojektet**, tölts fel egy **kis feedet**, és a bővítményt a projektben **engedélyezd**. ### **Hogyan adhatok a bővítménynek hozzáférést a projekt adataihoz?** A **projekt beállításaiban** **kapcsold be** a bővítményt. Ezzel hozzáférést kap a feedekhez/projektekhez, amelyeket olvashat/szerkeszthet. ### **Hol találom az API-autorizáció leírását?** A dokumentációban: **[https://mergado.github.io/docs/api/authorization.html](https://mergado.github.io/docs/api/authorization.html)**. ### **Hol van a teljes API-dokumentáció?** Az **[https://mergado.docs.apiary.io/#](https://mergado.docs.apiary.io/#)** címen. ### **Az endpoint másképp viselkedik, mint a dokumentációban. Mi a teendő?** Ellenőrizd az **API-verziót**. Az endpointok viselkedése verziókezelve van, és eltérő verzió eltérő működést eredményezhet. ### **Mekkora feedet használjak teszteléshez?** Elég egy **kis feed** néhány termékkel – ideális a gyors iterációhoz. ### **Hogyan védhetem meg az éles adatokat fejlesztés közben?** Használj **külön tesztfiókot/projektet**, hogy a változtatások ne érintsék az éles rendszert. --- ## [How does Mergado work and who sets it up?](https://help.mergado.com/en/mergado-editor/about-mergado/what-is-mergado-and-how-does-it-work/how-does-mergado-work-and-who-sets-it-up/) # **How does Mergado work and who sets it up?** ## **What is Mergado and how will it help me?** Mergado is a **web application for managing and editing product data**, designed primarily for online stores and digital agencies. You can think of it as a smart assistant between your online store and advertising platforms (e.g. Heureka, Zboží.cz, Google, or Facebook). When you send product data from your online store (e.g. from Shoptet, Shopify, or WooCommerce), Mergado lets you bulk-edit, supplement, or customize this data exactly as individual advertising channels require. For example, you can: * segment products, * bulk-add a brand name to product titles, * fill in missing parameters, * map categories, * hide selected products, * bulk-edit product images to match the requirements of individual advertising platforms, * create several different versions of a product feed for different advertising channels. The editing possibilities are nearly endless, and it is up to you how you improve your data. As a result, **your products will be displayed correctly, with complete information and often better targeted** — which in practice translates to higher campaign performance and fewer advertising errors. On top of that, it will save you an enormous amount of time. Imagine how much time you would spend manually repricing products if your online store has thousands of items. And how long it would take to adjust hundreds of product images to Google's exact required dimensions whenever you add new merchandise. ## **Who sets up Mergado?** Mergado makes working with your product data **significantly easier, but it is important to know that it is not a magic tool that does everything on its own**. Every online store owner has their own strategies and wants to achieve different goals — and Mergado cannot figure that out for you. It still needs its conductor. So you need to **set up in Mergado yourself, through so-called rules, what should happen with your data**, and you also need to continue fine-tuning and adjusting the data over time. The advantage, however, is that once you set up the rules, Mergado will **automatically and in bulk apply them to hundreds or thousands of your products** until you change or cancel them. ## **What skills do I need to work with Mergado?** Mergado is a so-called **no-code tool**, meaning it lets you edit your product feeds without any coding knowledge. Working in Mergado is clear and organized — **you don't need to know how to program, and you set everything up simply by clicking** through rules, filters, and straightforward forms. You can set up most rules by following our guides or with the help of our support team. ## **Who works with Mergado most often?** In practice, Mergado is usually used by employees of online store marketing departments. If an online store works with an external marketing agency (or freelancer), the agency often takes over the responsibility for setting up feeds through Mergado. Mergado also collaborates with selected agencies and freelancers, and after completing the required courses, training, and gaining practical experience, they become so-called **certified partners** — specialists who can professionally help you if you want to entrust the management of your product feeds to an external agency. You can find a list of our certified partners [here](https://www.mergado.cz/certifikovani-partneri). ## **How does the connection and setup of Mergado work?** ### **1. Connecting the product data source and choosing the output format** In Mergado, you **create a user account and connect your existing product feed** or use an integration. At the same time, you choose which platform your data edited in Mergado should be sent to (e.g. Heureka, Kaufland Marketplaces, ChatGPT, Facebook). You can find a guide on how to create your first project and connect your product data source here. ### **2. Audit / data quality check** If you choose this option when connecting your data source, Mergado will **perform a free check (audit) of your data**. [Mergado Audit](https://audit.mergado.com/) will flag technical errors or deficiencies and immediately recommend how to resolve them. ### **3. Defining rules, filters, and modifications** You set up **what changes should be made** — e.g. name changes, filling in missing elements, price recalculations, product filtering, category mapping, and more. **This is the key step that Mergado does not do on its own.** Setting up rules and pricing or other strategies must be designed and confirmed by a person. ### **4. Automation / scheduling updates** Mergado lets you **set up regular recalculations, automatic triggering of modifications, data delivery to target platforms, process scheduling, and more**. The mode and frequency of these processes are again set by the user. ### **5. Monitoring, tuning, and maintenance** After launch, you need to **continuously monitor whether the advertising on the target platform meets the expectations and goals** you have set, whether errors or unwanted filtering are occurring, and based on the data, fine-tune existing rules or add new ones. ## **What benefits and simplifications will Mergado bring me?** Even though it may seem like the data flowing directly from your online store platform to advertising channels is working just fine, Mergado lets you go several steps further: * you will better adapt data to the requirements of individual advertising channels, * you will gain control over exactly what is sent to advertising, * you can easily create different product feeds for different markets, * you will have an overview of potential errors and receive recommendations for corrections, * you will be able to manage advertising from one place, * through bulk edits and applying rules to hundreds/thousands of products, you will significantly reduce manual work, * you won't need to involve a developer for routine changes, * practically anyone can work with Mergado, not just developers, * Mergado supports connections to more than 650 formats and channels, so expansion or platform changes are much easier, * free [support](https://www.mergado.cz/kontakt) and many free [training sessions](https://www.mergado.cz/skoleni) are available to help you build your skills, * in the Mergado Forum, you will find information, guides, help articles, and you can ask anything and share experiences with other users. In short, Mergado will help you get the most out of your data. ## **Myths vs. reality when working with Mergado** |Myth|Reality| | --- | --- | |"I just need to connect the product feed and Mergado will take care of the rest."|Connecting the source data is just the first step. The process of editing and setting up rules must be defined by the user. You need to set the strategy and goals yourself.| |"Once it's set up, I don't need to do anything else."|Market conditions change, your product range rotates, advertising channels have new rules. All of this requires regular maintenance and rule adjustments.| |"Mergado support will set up my advertising for me."|Support provides expert assistance and is happy to consult with you on anything and advise you on the approach. However, setting up the advertising rules and managing them is up to you, based on your own strategies and goals. That said, Mergado will significantly simplify your processes and save you a lot of time.| ## **Where to find help when I'm stuck?** ### **1. Technical support** If you need help setting up Mergado, email us at **mergado@mergado.com** or call **+420 530 513 050**. Our [technical support](https://www.mergado.cz/kontakt) is available for **free on working days from 9:00 to 16:00**. We will help you understand how to set up Mergado, explain features, and point you in the right direction. ### **2. Free onboarding** Are you new to Mergado? Schedule a **free one-hour session** with us, during which we will show you how Mergado works and go through the basic setup together. If you already know the basics from our guides, you can also use the onboarding differently — for example, to fine-tune a specific issue or consult on your setup. ### **3. Free webinars** Want to improve your Mergado skills? Sign up for our **free webinars**. We will show you practical procedures you can handle on your own, and you will gain confidence when working with Mergado. Current dates and training sessions can be found [here](https://www.mergado.cz/skoleni). ### **4. Mergado Forum** Have a specific **question or want to consult with other users**? Visit the Mergado Forum, where you will find **practical guides, tips, and discussions** with a community of experienced marketers. We recommend starting in the Help section, where you will find clear articles and step-by-step instructions. ### **5. Certified partners** If you don't want to set up Mergado yourself or **need professional management of your product data**, partner with our **certified partners**. They are specialists who have completed training, have verified experience, and will help you with setup, optimization, and advertising management. You can find the list of certified partners [here](https://www.mergado.cz/certifikovani-partneri). ### **6. Additional resources** Mergado has a long history and a large community, so most questions have already been answered by someone before you. In addition to the forum and help articles, we also recommend visiting the [Mergado blog](https://www.mergado.cz/blog), where you will find dozens of articles, guides, and case studies from practice — from Mergado basics to advanced tips for improving advertising. You can also find help directly in Mergado Editor in the [Mergado Editor Guide](https://app.mergado.com/guide) section or [Video Help](https://app.mergado.com/guide/video). ### **7. AI assistants** If you need quick advice, you can also **use AI tools that are well acquainted with Mergado and can often provide step-by-step guidance**. ## **Responsibility for using Mergado** Using Mergado is at **the user's own responsibility**. We are happy to provide general guides, support, and consultations, but we are not responsible for any damages or losses that may arise from improper feed setup, incorrect use of rules, or erroneous exports. We recommend **making changes carefully, testing outputs, and in case of uncertainty, consulting with our support or an external specialist**. You can read the complete Mergado Terms of Use [here](https://www.mergado.cz/podminky-uzivani). ## **FAQ** ### **What is Mergado and how will it help me?** Mergado is an online tool that helps you edit and manage product data from your online store so it works perfectly in advertising channels such as Heureka, Zboží.cz, Google, Facebook, or ChatGPT Shopping. With Mergado, you can bulk-edit names, descriptions, or prices of products, fill in missing parameters, filter or split products into different campaigns, create multiple feed versions for different advertising platforms, and much more. As a result, your products will be displayed correctly, your advertising will be effectively targeted, improving its performance, and you will save yourself a lot of manual work. Plus, you can do it all without any programming — you set everything up simply by clicking in a clear interface. ### **Why would I need Mergado if I already send feeds to Heureka or Zboží.cz directly from my online store?** Mergado lets you better and more easily customize, extend, and manage your data. With Mergado, you can, for example, bulk-edit various parameters or product images, automatically bid or reprice products, filter your assortment, or create different feed versions for different advertising channels. All of this in bulk and without touching your online store. ### **Who sets up Mergado?** You do. Mergado is a tool that gives you full control over what happens with your data. You need to set up so-called rules and define how data should be edited. Mergado then runs everything automatically and in bulk. If you don't want to handle the setup and management yourself, we recommend working with our [certified partners](https://www.mergado.cz/certifikovani-partneri), who can professionally help you with advertising and Mergado. ### **Can I work with Mergado even if I can't program?** Yes. Mergado is a so-called no-code tool, so it requires no coding or programming knowledge. You set up rules and data edits by clicking in a clear interface using simple forms. Plus, you have access to video guides, a forum with help articles, and free support. All you need is a clear goal and strategy, and you can handle it with Mergado. ### **Can I use Mergado if my advertising is managed by an agency?** Yes, your feed management in Mergado can also be handled by an external agency or specialist who manages your advertising. Just grant them access to your project and they can work with the data the same way you would. If you are still deciding who to entrust the management to, we recommend choosing from our [certified partners](https://www.mergado.cz/certifikovani-partneri). They are verified experts who have completed training, have practical experience, and work with Mergado daily. ### **What do I need to start working with Mergado?** All you need is a product feed from your online store and a Mergado account. You can find a detailed guide on how to create your first project here. Alternatively, you can schedule an introductory session with our support team, where we will walk you through the basics of working with Mergado. ### **What is Mergado Audit and why should I use it?** [Mergado Audit](https://audit.mergado.com/) is a free check of your product feed. It identifies errors and deficiencies in your data and immediately recommends how to fix them in Mergado. The audit can be run right when creating a new project in Mergado, but also at any other time. ### **Do I need to do anything in Mergado regularly?** Yes, Mergado needs your regular attention to keep your advertising current and performing well. Markets, product ranges, and advertising channel requirements change, and minor maintenance helps you maintain high-performing ads that drive higher sales. However, you don't need to spend hours on edits — most things can be handled in a few minutes, for example once a week or when there are major changes in your online store. ### **Where can I find guides and help if I'm stuck?** You have several options: * Free technical support — email mergado@mergado.com or call +420 530 513 050 (Mon-Fri, 9:00-16:00). * Free onboarding — a one-hour session for new Mergado users, where we will show you the basics or help with a specific issue. * Free webinars — [practical training sessions](https://www.mergado.cz/skoleni) that teach you not only how to work effectively with Mergado, but also how to better understand advertising on various platforms. * Mergado Forum — on our forum, you will find practical guides, news, and experiences from other users. * Mergado Blog — on the [blog](https://www.mergado.cz/blog), you will find hundreds of articles and case studies from practice. * Certified partners — if you want to entrust advertising and product data management to an external agency, we recommend choosing from our [certified partners](https://www.mergado.cz/certifikovani-partneri), who have extensive experience with Mergado. ### **Who is responsible for errors in the setup?** We are happy to provide detailed guides, consultations, and support, but we do not intervene in your advertising. You as the user are responsible for the correctness and results of your setup. We therefore recommend checking outputs after making changes (or testing changes in advance) and, if unsure, consulting with our technical support or the agency that helps manage your advertising. --- ## [Is using Mergado worth it for me?](https://help.mergado.com/en/mergado-editor/about-mergado/what-is-mergado-and-how-does-it-work/is-using-mergado-worth-it-for-me/) # **Is using Mergado worth it for me?** The short answer is — yes. If you set up the application properly, you can use it to increase your revenue by tens of percent, easily exceeding the monthly cost of Mergado, which typically runs at a few hundred Czech crowns. On top of that, you will save a lot of time, which, as we all know, is priceless. But let's break down all the benefits. ## **Main benefits of using Mergado** ### **1. Instant changes without developers** Mergado works as a "translator" between your online store and advertising channels. You feed it **your product feed and use the clear interface to make all the necessary edits and set up rules yourself, without needing developers**. Changes that would otherwise require a programmer can be done in just a few minutes by clicking. Fast, clear, and without waiting. You don't have to manually edit hundreds or thousands of products every time something changes. **You set up a rule and Mergado bulk-edits the data for all items that match.** This not only speeds up your work significantly, but also saves you considerable costs that you would otherwise pay for developer work. **Example:** You have 1,000 products whose names need to be adjusted to meet Heureka's requirements. Instead of editing product names one by one in your online store or waiting for a developer to modify the XML feed for Heureka, you open Mergado, set up a rule, and Mergado adjusts the names for all products. The change is instant, with no developer and no changes to your online store. ### **2. Improved ad performance and revenue** The quality of data sent to advertising platforms directly affects how well your products are displayed and whether the ad platform approves them at all. With Mergado, you can easily **identify and fix errors that prevent advertising or reduce its performance**. With higher-quality data, you will appear in higher search rankings, which is a huge advantage at a time when clicks are increasingly expensive. With the right setup, Mergado can help you **increase your click-through rate (CTR) and boost your revenue** by tens of percent. **Example:** If a product is missing its EAN or is assigned to the wrong category, it won't be visible in searches on the ad platform or will be incorrectly classified. Mergado lets you fix these errors quickly with just a few clicks, increasing the probability that your product reaches the right customer. ### **3. Clear overview and tidy data** Mergado offers a tool called [Mergado Audit](https://audit.mergado.com/), which **checks the quality of your product feed for free**. It identifies errors such as missing or incorrect elements, invalid values, or duplicate items, and recommends what and how to fix. This gives you confidence that your product data is complete, correct, and always ready to be sent to advertising channels. **Example:** Mergado Audit reveals that your category names don't match the categories of the target advertising platform. Using the suggestion feature, you can easily set the right categories, ensuring correct product matching to product cards on the ad platform, so your products are displayed correctly. ### **4. Reduced advertising costs** Mergado lets you create queries based on various criteria, such as availability, margin, season, or marketing campaign. This way, you always **promote only the products whose advertising makes sense at any given moment, allowing you to use your ad budget wisely and efficiently**. **Example:** Your product catalog includes both a summer collection and winter goods. In summer, you obviously don't want to advertise sleds or winter jackets. In Mergado, you set up a rule that excludes winter products from summer campaigns. This way, you promote only relevant products, cut unnecessary costs, and improve the efficiency of your campaigns. ### **5. Easy and fast expansion** Mergado supports hundreds of advertising platforms, comparison sites, marketplaces, and analytics systems. It allows you to **easily, quickly, and without complicated technical hurdles reach new customers** not only domestically, but also internationally. **Example:** You advertise on Kaufland and have decided to expand to the Italian or French market? In Mergado, it's a matter of a few clicks, using a ready-made integration. You can handle it yourself and without complex preparations. ### **6. Features that save time and put your business ahead of the competition** Mergado is not just about basic feed edits. Its features and [extensions](https://store.mergado.com/) provide automatic translations for international expansion, enable automatic bidding or pricing, simplify supplier feed management, allow bulk image editing, analytics, multi-source data synchronization, and dozens of other ways to **improve your business, test new markets, and respond quickly to changes**. **Example:** You receive a feed from a supplier in a different format than your online store needs? With Mergado, you can easily convert the supplier feed into a structure that your online store platform can process. ### **7. Low cost, free trial, and support always available** Mergado is designed to be **affordable even for smaller online stores**. [Pricing](https://www.mergado.cz/cenik) is based on the **number of advertised products**. In addition, you can take advantage of a **30-day free trial** to test all features. And when you run into a problem or don't know how to set something up, Mergado offers [support](https://www.mergado.cz/kontakt), guides, and [training](https://www.mergado.cz/skoleni) for free to help you quickly get started with effective feed management. ## **FAQ** ### **What is Mergado and what can I use it for?** Mergado is a tool for editing, managing, and optimizing product feeds. It helps improve data quality, save advertising costs, effectively expand to international markets, and automate a range of marketing and technical processes. With Mergado, all edits can be managed even without deep technical knowledge and without a developer. ### **How will Mergado Audit help me?** [Mergado Audit](https://audit.mergado.com/) is a free tool that checks the quality of your product feed. It identifies errors (e.g. missing elements, invalid values, duplicates, incorrect categories) and recommends how to fix them. This gives you confidence that your data is complete and ready to be sent to advertising channels. ### **Will Mergado save me money on advertising? How?** With the right setup, yes. In Mergado, you can create queries based on criteria like margin, availability, seasonality, or campaign type. This way, you only promote what is profitable, eliminating unnecessary costs and boosting campaign performance. ### **Will Mergado help me expand internationally?** Yes. Mergado supports hundreds of channels, comparison sites, and marketplaces worldwide. Using ready-made integrations, you simply connect your product feed and start advertising abroad. Quickly and without complicated technical hurdles. ### **Will Mergado help me with supplier feeds?** Yes, for example, if a supplier feed is in a format that your online store cannot process, in Mergado you can convert it to a format your online store platform can handle. No programming is needed — you set everything up by clicking through rules. ### **What other features does Mergado offer?** Mergado goes far beyond basic feed editing. The most commonly used features include: * automatic translations for international expansion, * automatic bidding and pricing, * supplier feed management, * bulk image editing, * multi-source data synchronization, * analytics, * and many other features enabled by [Mergado extensions](https://store.mergado.com/). ### **Is Mergado suitable for small online stores?** Yes. Pricing is based on the number of products, so it is affordable even for small businesses with smaller catalogs. ### **Can I try Mergado for free?** Yes, Mergado offers a 30-day free trial where you can fully test all features. ### **Can I contact support if I need help with something?** Yes. Free [technical support](https://www.mergado.cz/kontakt), detailed guides, a forum, and regular free [training sessions](https://www.mergado.cz/skoleni) are available. If you are unsure about any settings, the Mergado team will walk you through the entire process. ### **How quickly can I start using Mergado?** Immediately. Just import your product feed, run the Audit, and start creating rules. You can manage the edits yourself without a developer. --- ## [How to connect the Shopify online store platform to Mergado Editor](https://help.mergado.com/en/mergado-editor/about-mergado/data-connection/how-to-connect-shopify-to-mergado-editor/) # **How to connect the Shopify online store platform to Mergado Editor** ## **How to generate Shopify API credentials for Mergado (from January 1, 2026)** ## **⚠️ IMPORTANT connection instructions** 1. Into the `URLs > App URL` field enter: ```https://app.mergado.com/``` 💡You must enter this URL in the **App URL** field when creating a custom app in Shopify. 2. Minimum permissions (scopes) required by Mergado. ⚠️ Without these permissions, the integration will not work. ```text write_products,read_products,write_markets,read_markets,read_metaobjects ``` 3. Permissions (scopes) if you also want to use Mergado Marketplaces ```text read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits ``` > This guide **strictly follows the official Shopify documentation and current user interface** for creating apps using the **Shopify Developer Dashboard**. > > **Official sources:** > [https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard) ## **Who is this guide for** This article is intended for: - Shopify merchants who want to connect their online store with **Mergado** - agencies and developers setting up the Shopify ↔ Mergado integration for clients - anyone who needs to obtain a **Shopify API access token** > You are creating a **custom, purely API app for one specific online store**. There is **no need** to publish the app to the Shopify App Store. ## **What you will need** - A Shopify account with **admin access** to the online store - Access to the **Shopify Developer Dashboard** ## **Before you begin: Check your Markets settings** > ⚠️ **This step is required for Mergado to be able to import products for individual markets.** Before creating the app, we recommend checking the **Markets** settings in the Shopify admin. ### **What needs to be configured** For **each market** from which you want to import products into Mergado: * a **domain** must be assigned * a **language** must be assigned * both values must be **explicitly added to the** ***Customized*** **section** It is not sufficient for them to only be inherited from the **Inherited** section or set as **Primary**. ### **Steps in the Shopify admin** 1. Open the **Shopify admin** 2. In the main left menu, click **Markets** 3. Open a specific market (e.g. *Czechia*) 4. Scroll to the **Inherited** section 5. For the **Domain / language** item, click the **+** icon 6. In the modal window: * check the desired **domain** * check the desired **language** 7. Confirm by clicking **Done** 8. Verify that **Domain / language** has moved to the **Customized** section 9. Confirm changes by clicking **Save** :warning: > If **Domain / language** remains only in the **Inherited** section, the Shopify API will not provide data for that market and Mergado will not be able to import products. ## **Step 1: Open the Shopify Developer Dashboard** You can access the Shopify Developer Dashboard in two ways: ### **Option A: Direct access** 1. Open https://dev.shopify.com/ 2. Log in with your Shopify account 3. In the left menu, open the **Apps** section ### **Option B: Via the Shopify admin** 1. Open the **Shopify admin** of your online store 2. Go to **Settings** → **Apps** 3. Click **Develop apps** 4. Click **Build apps in Dev Dashboard** ## **Step 2: Create a new app** 1. Make sure you are in the **Apps** section 2. Click **Create app** 3. Choose **Start from Dev Dashboard** 4. Enter an app name (e.g. `Mergado integration`) 5. Click **Create** After creating the app, you will be redirected to the **Versions** tab. ## **Step 3: Create an app version and set permissions (scopes)** Each app must have at least one **version** before it can be installed in an online store. ### **3.1 Setting the app URL and embedding** 1. In the **URLs** section, find the **App URL** field 2. Replace the default value `https://example.com` with: ``` https://app.mergado.com ``` > This step is **required for the integration with Mergado to work correctly**. If the default value remains, authorization will not function properly. 3. Below the **App URL** field, uncheck the **Embed app in Shopify admin** option ### **3.2 Setting access permissions** 1. In the **Access** section, click **Select scopes** 2. In the modal window, search for and check: - `read_products` - `write_products` - `read_markets` - `write_markets` - `read_metaobjects` 3. Confirm by clicking **Done** > These permissions are required for Mergado to be able to load products and market-specific data. ### **3.3 Publishing (Release) the version** 1. Scroll down on the page 2. Click **Release** 3. In the confirmation dialog, you can leave the version name empty 4. Confirm by clicking **Release** The app version is now published and ready for installation. ## **Step 4: Install the app in your online store** 1. In the left menu, open **Home** 2. In the top right, click **Install app** 3. Select the Shopify online store you want to connect with Mergado 4. You will be redirected to the Shopify admin 5. Confirm the installation by clicking **Install** The app is now installed in the online store. ## **Step 5: Obtain the API access credentials (Client ID and token)** After installing the app, you need to obtain **two values** that you will use for the integration with Mergado: 1. **Client ID** 2. **API access token (Secret)** Steps: 1. Go back to the **Shopify Developer Dashboard** 2. Open your app 3. Go to **Settings** 4. In the **Credentials** section: * copy the **Client ID** value (the field is located **above** the Secret value) * copy the **Secret** value > **Client ID** is used to identify the app, **Secret** serves as the API access token. **Both values are required** for the Mergado integration to work correctly. ## **Step 6: Get the online store URL** 1. Open the **Shopify admin** of the connected online store 2. In the left menu, open **Home** 3. In the **Domains** section, copy the online store URL Example: `your-store.myshopify.com` ## **Step 7: Connect Shopify with Mergado** 1. Open **Mergado** 2. Create a new project 3. Select **Shopify** as the data source 4. Fill in: * **Shopify URL** → enter the online store URL * **Client ID** → enter the copied **Client ID** from the Shopify Developer Dashboard * **Client Secret** → enter the copied **Secret** 5. Click **Log in** ## **FAQ** ### **After selecting a Market, the language does not load. Why?** The most common cause is in the **Markets** settings in the Shopify admin. If **Domain / language** is listed only in the **Inherited** section and is not added to the **Customized** section, the Shopify API will not provide data for that market. As a result, the language will not load in Mergado after selecting a Market. Solution: * Open **Shopify admin → Markets** * Open the specific market * For the **Domain / language** item, click **+** * Select the domain and language * Click **Done** and then **Save** * Verify that the item has moved to the **Customized** section * More info in the section: Before you begin: Check your Markets settings ### **Mergado does not load the values of some metafields correctly. Why?** If some metafields display the correct name (key) but the value is shown as an ID (e.g. `["gid://shopify/Metaobject/94942036012"]`) or a **"Missing required scope"** message appears, the app is missing the permission to read metaobjects. You need to add the following scope: ` read_metaobjects ` ### **Steps** 1. Go to the **Shopify Developer Dashboard** 2. Open the app created for the Mergado integration 3. In the left menu, go to **Versions** 4. Click **New version** 5. In the **Scopes** section, add the new scope `read_metaobjects` 6. Confirm the changes and complete the new version by clicking **Release** After releasing the new version, you need to re-authorize the connection. ### **Re-authorization in Mergado** 1. Open the **Mergado Keychain** extension 2. Remove the existing connection 3. Re-enter the authorization credentials: * **Shopify URL** * **Client ID** * **Secret** 4. Log in again (Log in) After adding the scope and re-authorizing, metafield values will load correctly. --- ## [How to connect the UNAS online store platform to Mergado Editor](https://help.mergado.com/en/mergado-editor/about-mergado/data-connection/how-to-connect-unas-to-mergado-editor/) # **How to connect the UNAS online store platform to Mergado Editor** ## **How to connect an online store running on the UNAS platform to Mergado Editor via API?** ### **Step 1** First, you need to **create an access key** within the online store platform. Go to ***Beállítások* -> *Külső kapcsolatok* -> *Piacterek*** Example of the full path: ![full path](/images-mergado-editor/napojeni-unas/1.ukazka_cele_cesty.png) ### **Step 2** On the page, **create a new API key** by clicking the **button *Hozzáad* in the Mergado box**. ![creating API](/images-mergado-editor/napojeni-unas/2.mergadoAPI.png) ### **Step 3** Copy the **API key** and **online store ID**. ![copying API](/images-mergado-editor/napojeni-unas/3.kopirovani_API.png) ### **Step 4** When **creating a new project in Mergado**, choose **UNAS as the data source**. ![connecting to UNAS](/images-mergado-editor/napojeni-unas/4.unas.png) ### **Step 5** Enter the **API key** and **online store ID** in the project creation wizard in Mergado: ![filling in details](/images-mergado-editor/napojeni-unas/5.udaje.png) ### **Step 6** From here, continue with the standard **output format selection and project completion**. ![completing the project](/images-mergado-editor/napojeni-unas/5.udaje.png) > **Tip! Optional connection via Mergado Keychain**: You can also set up the UNAS connection outside the project creation wizard. Directly **in Mergado Keychain**, you can prepare the UNAS connection in advance, and when creating a project, you won't need to enter the credentials again. ![UNAS in Keychain](/images-mergado-editor/napojeni-unas/7.unas_keychain.png) --- ## [Product authorization](https://help.mergado.com/en/mergado-editor/about-mergado/data-connection/product-authorization/) # **Product Authorization** Product authorization lets you decide which items from the input feed to let into Mergado and which to block. It comes in handy when you have a feed from a supplier and don't want to offer the entire catalog, or when you want to control every new product that appears in the feed. Below you will find how to enable authorization, work with approval, and how to disable it again if needed. ## **Step-by-step guide** ### **1. Enabling during project creation** 1. In the wizard (last step), below the **Matching elements** you will find two buttons. 2. The bottom one is **Enable product authorization** — click it to activate. ### **2. What you will see after project creation** * In the **Overview**, the output will show **0 products**. * In the lower-left area, a message **"Products waiting for approval"** will appear. * This means you first need to authorize the products from the input feed. ### **3. Approving products** 1. Go to the **Products** section and open the **Product authorization** tab (at the top). 2. A list of all products from the input feed will appear. 3. Select individual products you want to approve. * To select all, use the **checkbox** on the **first black bar on the far left**. 4. Click **Approve** (or **Reject**). After approval, the approved products will be **rewritten into Mergado**. ### **4. Disabling / re-enabling authorization** * Authorization can be **disabled and re-enabled** even for an already created project. * Go to **Settings**, scroll down, and **below the matching elements** you will find a section with the option to **disable/enable "Product authorization"**. ## **Tips** * **Quick start**: If you want to let the entire feed through, use the bulk selection checkbox on the first black bar and confirm with **Approve**. * **Careful review**: If you want to be sure about new items, check the **Product authorization** tab regularly and approve only what you actually want in the output. ## **FAQ** ### **What is product authorization for?** For controlling which products from the input feed are let into Mergado and which are blocked. Useful when you don't want to offer the entire feed or want to monitor new items. ### **Where do I enable authorization when creating a project?** In the last step of the wizard, below the **Matching elements**, by clicking **Enable product authorization**. ### **Why do I see 0 products and a "Products waiting for approval" message after creating the project?** Because you first need to **approve** the products from the input feed in the **Product authorization** tab. ### **How do I bulk-select all products for approval or rejection?** In the **Product authorization** tab, use the **checkbox** on the **first black bar on the far left**, then click **Approve** or **Reject**. ### **What happens after approval?** Approved products are **rewritten into Mergado** and appear in the output. ### **Can authorization be disabled or re-enabled later?** Yes. In **Settings**, below the **matching elements**, there is a section with the option to **disable/enable "Product authorization"**. --- ## [How to create a new project in Mergado?](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-create-a-new-project-in-mergado/) # **How to create a new project in Mergado?** Have you decided to enter a new advertising platform with your online store (e.g. Heureka, Sklik, Google, Kaufland, or ChatGPT) and chosen Mergado as your helper? We will show you that **creating a new project is something you can easily and quickly do yourself**. ## **What is the difference between an online store and a project?** **An online store** in Mergado groups individual **projects** together. Under one online store, you can have as many projects as you need. Think of an online store in Mergado as your own online store (example: My-eshop.com) and projects as the individual platforms where you want to advertise products from that store (e.g. Heureka, Allegro, ChatGPT, Facebook, etc.) If you have **multiple online stores, create a separate online store in Mergado for each one** and then create the corresponding projects under it. Each online store will be **billed separately**. ℹ️ According to the Mergado [Terms of Use](https://www.mergado.cz/podminky-uzivani), **it is not allowed to have multiple different online stores within a single online store**. So if you have two online stores, each on its own domain, you need to create two online stores in Mergado as well, under which you create the corresponding projects for individual advertising platforms. ## **What is a product feed?** A **product (or data) feed** is a structured data file containing so-called **elements**. These elements **carry information** about the products you sell. They include, for example, product names, descriptions, prices, availability, categories, and much more. To create a project, you need to provide Mergado with this structured information about your products. The feed you put into Mergado is called the **input feed**. In Mergado, we also use the term **output feed**. This is a feed containing all your data plus the modifications you have made in Mergado Editor, and is therefore tailored for the advertising platform you are creating the project for. input feed → Mergado → output feed ## **What is a product feed format?** Just as you can save your notes in a Word document (.docx) or an Excel spreadsheet (.xlsx), a product feed can also be stored in various formats. The most common ones are **XML, CSV, JSON, or Google Sheet**. Mergado supports all of these formats and it is up to you which one you use for your input feed. During project creation, you will also **choose the format for the output feed**. You choose this based on which platform your data in the specific project is intended for (e.g. Heureka, Google, Zboží.cz, Kaufland Marketplaces). If you want to use the project solely for editing existing data (e.g. within your own online store), you choose the same format for input and output. ## **How to get the input feed URL?** To upload the input feed, you need to enter its **URL** in Mergado (in other words, a link to where the feed is stored). This is not the address of your online store, but the direct **address where the data about individual items in your online store is stored**. You can usually get the feed URL **from the admin panel of your online store platform or from your online store administrator**. It might look something like this: `https://eshop.com/feed.xml` If your online store runs on platforms like Prestashop, WooCommerce, or Opencart, you can use our free plugin [Mergado Pack](https://pack.mergado.cz/), which helps you create an XML file with data for uploading to Mergado. If you do not have a feed URL available because your feed is stored on an FTP server, our extension [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about) will help by converting the inaccessible FTP data to a public URL. ℹ️ Mergado will download your input feed from IP address **81.31.39.112**. If you use an IP address whitelist to secure your feeds, you need to add Mergado's IP address to it. ## **How to create a new project?** 1. **After logging into your Mergado account, click the *New project* button**, which will take you to a page where you can create the project in a few steps. → If you are completely new to Mergado, we recommend first going through the [Mergado Editor Guide](https://app.mergado.com/guide), from which you can also get to project creation by clicking the *Create project* button. 2. **In the first step, click the *Online store* field**, where you select the online store under which you want to create the new project. a. If this is your first time in Mergado (you don't have any online store yet) or you want to create the project under a brand new online store, click *Create online store*. Enter the name of your new online store and click *Confirm*. b. If you already have online stores in Mergado and want to create the project under one of them, select the desired online store from the list. 3. **Click *Continue*.** 4. **In the next step, select your input feed source** (the location where your product data is stored). You can choose from the following data source options. **a. Product feed (URL)** — if your product feed is stored at a URL address, click *Use feed URL* **b. Shopify** — if your online store runs on the Shopify platform, click *Connect via Shopify* **c. Malfini supplier feed** — if you want to connect a Malfini supplier feed to your project, click *Connect Malfini* **d. UNAS** — if your online store runs on the UNAS platform, click *Connect via UNAS* 5. The exact steps for connecting your input feed using each method are described in the following section of this article. **After connecting your data using the chosen method, click *Continue*.** 6. **In the next step, select your output feed format** (i.e. the target recipient of your data). Simply put, select the platform where you want to start advertising or for which your data is intended (e.g. Heureka, Google, Facebook, supplier application, website, marketplace, and others) and click *Continue*. → Mergado pre-selects the output format based on an analysis of your input feed (it selects the format most similar to the input). However, you can of course choose any format you want. → If none of the offered output formats matches the format you want for your output, click *Define custom format* and set up the desired output format. 7. **In the final step, review (and if needed, change by clicking the pencil icon)** whether all settings are configured as you want them. → The project name will automatically be filled in based on what you selected as the output format. You can also change the name by clicking the pencil icon. → You will also see the option to change the **Matching elements**. These elements contain unique information and help distinguish individual products from the input feed. Mergado always suggests the most suitable elements automatically, and changing them is an advanced feature that you probably won't need to modify for your first project. 8. **Click *Finish*.** Mergado will begin downloading and importing data. The import speed depends on the feed size (for a small feed it's quick, for a feed with tens of thousands of products it may take a few minutes). After the project is completed, the **output feed URL will be created**. You then **enter this URL in the platform for which you created this project**. You can access all information about the created project at any time via the **[User Details](https://app.mergado.com/user/details/)** page in your Mergado account. Here you will find a list of all your online stores. Clicking on a selected online store will show you a list of all projects in that online store. Clicking on a selected project will display all information about it, including the output feed URL. ℹ️ If you have been working with Mergado for some time and are creating a new project under an existing online store that already has active project(s), it may happen that the new active project **causes you to exceed the limit of your currently prepaid plan**. If you do exceed your current plan and move to a higher tier, you will receive an email notification. If you are creating a new project under a newly created online store, a new billing item with the corresponding plan will be added. More information about plan changes can be found in this article. ## **How to connect various product data sources?** ### **Product feed (URL)** Choose this option if **you have the URL of your product feed**, which you obtained from the **admin panel of your online store platform or from your online store administrator**. Or if you are already using Mergado and want to use, for example, one of the output feeds from your other projects as the input feed. 1. After selecting/creating the online store under which the project will be placed, click ***Use feed URL***. 2. Enter the input feed URL here. a. In the ***Enter the input feed URL*** field, paste the URL of your product feed. b. If you are already using Mergado and want to use an existing feed from one of your other projects as the input feed for this project, select the desired feed in the *Existing URL* field. 3. **Click *Continue*.** 4. In this step, **Mergado automatically recognizes the format of your input feed. Simply click *Continue*.** a. If Mergado **did not recognize the format correctly, click *Select a different format***. In the *Input format* field, select the correct format of your input feed and click *Continue*. b. If **the format of your input feed does not match any of the offered formats** (e.g. you have a very specific supplier feed), click ***Define custom format***, where you set up the format of your source yourself. After setting it up, click *Save and continue*. 5. Then complete the project creation following the instructions in the **How to create a new project** section of this article. ### **Shopify** We recommend this connection method for everyone who runs their **online store on the Shopify platform**. You may have already discovered that this platform does not allow product feed export. It does technically allow it, but you would need to use a paid app from the Shopify Store to generate a product feed. The direct integration between Shopify and Mergado simplifies connecting your online store to Mergado. The connection works via API, so Mergado does not need a feed and takes the information about your products directly from your online store. 1. After selecting/creating the online store under which the project will be placed, click ***Connect via Shopify***. 2. **Enter the *Shopify Store URL for Admin API* in the format *name.myshopify.com*.** You can find it in your online store admin under *Settings*, listed under your online store name (e.g. my-shop.myshopify.com). 3. **Enter the *Client ID* and *Client Secret*.** → How to obtain Shopify API Credentials (Client ID and Client Secret) can be found in this guide. 4. **Click *Continue*.** 5. Then complete the project creation following the instructions in the **How to create a new project** section of this article. ### **Malfini supplier feed** We recommend this connection for **online store owners whose supplier is Malfini** and who want to easily get their products into their online store with just a few clicks. You can import their products in the language of your choice, edit names, prices, or anything else you need, and the data in your online store will always be up to date. An additional benefit is that if your online store runs on a platform like Shoptet, Shopify, or WooCommerce, **Mergado will pre-configure some rules for you** — for example, for calculating the selling price, hiding selected categories, or editing product names. 1. After selecting/creating the online store under which the project will be placed, click ***Connect Malfini***. 2. **Choose the *Malfini source file***, i.e. the language version of the data you want to import. 3. **Click *Continue*.** 4. **Choose the output data format** (your online store platform or another format) and click ***Continue***. 5. Then complete the project creation following the instructions in the **How to create a new project** section of this article. ## **FAQ** ### **What is a "project" in Mergado?** A project in Mergado represents a specific data configuration that you send to a certain platform. For example, when you want to send data from your online store to an advertising platform (Heureka, Google, Facebook, Kaufland, etc.) and edit it in Mergado specifically for that platform's needs in between. You also create a project when you don't want to send data to another platform but want to edit it in Mergado. For example, you have your online store send data to Mergado, edit it to your needs here, and the edited data flows back to your online store. ### **What is an "online store" in Mergado?** An online store in Mergado groups together the individual projects related to one of your online stores. Think of an online store in Mergado as your own online store (example: My-eshop.com) and the projects under it as the individual platforms where you want to advertise products from that store (e.g. Heureka, Allegro, ChatGPT, Facebook, etc.). If you have multiple online stores, create a separate online store in Mergado for each one. ### **Can I have multiple projects under one online store?** Yes, you can have as many projects under one online store as you need. Each project is intended for a different platform — for example, one for Heureka, another for Google Ads, and a third for Facebook. However, according to the Mergado [Terms of Use](https://www.mergado.cz/podminky-uzivani), it is not allowed to have multiple different online stores within a single online store. So if you have two online stores, each on its own domain, you need to create two online stores in Mergado as well, under which you create the corresponding projects for individual advertising platforms. ### **When should I create a new online store and when just a new project?** Create a new online store when it is a completely different online store (with a different domain). Create a new project when you want to advertise products from the same online store, for which you already have an online store in Mergado, on an additional platform. ### **What is a product feed?** A product feed is a structured data file containing all information about your products, e.g. names, prices, descriptions, availability, and other details. ### **What is the difference between an input and output feed?** The input feed is the one you send to Mergado (source data from your online store). The output feed is the one Mergado creates. It contains your source data plus all the modifications made in Mergado. ### **What format can a feed be in?** The most common formats are XML, CSV, JSON, or Google Sheet. Mergado supports all of these formats, and if needed, you can also define a custom format in Mergado. ### **Do the input and output feed formats need to be the same?** No. It depends on which platform you are sending the feed to. However, if you are using the project only for internal data editing (e.g. within your own online store), you can choose the same format for both input and output. ### **What is a feed URL?** It is a link to the location where the file with your product data is stored (i.e. where your product feed is stored). A feed URL might look like this: https://my-eshop.com/feed.xml. It is not the address of your online store, but a specific link to the product data file. ### **Where do I get my feed URL?** You can usually find it in the admin panel of your online store platform, or your online store administrator can provide it. If needed (e.g. if your online store runs on Prestashop, WooCommerce, or Opencart), you can use our free plugin [Mergado Pack](https://pack.mergado.cz/), which helps you create an XML file with data for uploading to Mergado. If your feed is stored on an FTP server and you don't have its URL, our extension [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about) will help. ### **What if my feed is stored on an FTP server and I don't have its URL?** Use the [Mergado Drive](https://app.mergado.com/applications/detail/mergadodrive/#about) extension, which converts inaccessible FTP data to a public URL so Mergado can work with it. ### **What is Mergado Pack?** It is a free plugin for platforms like Prestashop, WooCommerce, or Opencart that helps you easily create a feed in the correct format for Mergado. ### **What if my feed is secured? Can Mergado access it?** If you use an IP address whitelist to secure your feed, add Mergado's address (81.31.39.112) to it so the system can download your feed. ### **How do I create a new project in Mergado?** 1. After logging into your Mergado account, click the New project button, which will take you to a page where you can create the project in a few steps. → If you are completely new to Mergado, we recommend first going through the [Mergado Editor Guide](https://app.mergado.com/guide), from which you can also get to project creation by clicking the Create project button. 2. In the first step, click the Online store field, where you select the online store under which you want to create the new project. a. If this is your first time in Mergado (you don't have any online store yet) or you want to create the project under a brand new online store, click Create online store. Enter the name of your new online store and click Confirm. b. If you already have online stores in Mergado and want to create the project under one of them, select the desired online store from the list. 3. Click Continue. 4. In the next step, select your input feed source (the location where your product data is stored). You can choose from three data source options. a. Product feed (URL) — if your product feed is stored at a URL address, click *Use feed URL* b. Shopify — if your online store runs on the Shopify platform, click *Connect via Shopify* c. Malfini supplier feed — if you want to connect a Malfini supplier feed to your project, click *Connect Malfini* d. UNAS — if your online store runs on the UNAS platform, click *Connect via UNAS* 5. After connecting your data using the chosen method, click Continue. 6. In the next step, select your output feed format (i.e. the target recipient of your data). Simply put, select the platform where you want to start advertising or for which your data is intended (e.g. Heureka, Google, Facebook, supplier application, website, marketplace, and others) and click Continue. → Mergado pre-selects the output format based on an analysis of your input feed (it selects the format most similar to the input). However, you can of course choose any format you want. → If none of the offered output formats matches the format you want for your output, click Define custom format and set up the desired output format. 7. In the final step, review (and if needed, change by clicking the pencil icon) whether all settings are configured as you want them. → The project name will automatically be filled in based on what you selected as the output format. You can also change the name by clicking the pencil icon. → You will also see the option to change the Matching elements. These elements contain unique information and help distinguish individual products from the input feed. Mergado always suggests the most suitable elements automatically, and changing them is an advanced feature that you probably won't need to modify for your first project. 8. Click Finish. ### **What input data source should I choose?** You can choose one of the following options: * Product feed (URL) — if you have the URL of your feed available. * Shopify — if your online store runs on the Shopify platform. * Malfini supplier feed — if your supplier is Malfini and you want to import their data into your online store or advertising platform. * UNAS — if your online store runs on the UNAS platform. ### **How do I choose the input feed format?** Mergado automatically recognizes the format of your input feed. If it recognizes it incorrectly, you can manually change it during project creation by clicking Select a different format (you select the format based on which platform the input feed comes from). If your format is not in the list, click Define custom format and set it up yourself. ### **How do I choose the output feed format?** You choose the output feed format based on the target recipient of your data, i.e. which platform your data in the specific project is intended for (e.g. Heureka, Google, Zboží.cz, Kaufland Marketplaces). If you want to use the project for internal data editing (e.g. within your own online store), you choose the same format for the output as you entered for the input. ### **What are matching elements?** Matching elements are contained in your feed and carry unique data by which Mergado identifies individual products (e.g. product ID). Usually, you don't need to change them — Mergado selects them automatically. ### **How do I know the project was created correctly?** After the input feed import is complete, you will see the output feed URL. You enter this address in the platform for which you created the project. ### **How do I connect a feed using a URL?** In the second step of project creation, click Use feed URL, simply enter the feed address in Mergado, and continue to the final step of project creation. If you are already using Mergado and want to use an existing feed from one of your other projects as the input feed, select the desired feed in the Existing URL field and continue to the final step of project creation. ### **How do I connect my Shopify online store to Mergado?** In the second step of project creation, click Connect via Shopify and enter the Shopify Store URL for Admin API, Client ID, and Client Secret, then continue to the final step of project creation. How to obtain the required Shopify API Credentials (Client ID and Client Secret) can be found in this guide. ### **Where do I find the Shopify Store URL for connecting Shopify to Mergado?** You can find it in the Shopify admin of your online store under the Settings section, listed under your online store name. It will be in the format *name.myshopify.com* (e.g. my-shop.myshopify.com). ### **What is the Malfini connection for?** This connection is ideal for online store owners whose supplier is Malfini and who want to easily get their products into their online store with just a few clicks. You can import Malfini products into Mergado in the language of your choice, easily edit names, prices, or anything else you need, and the data flowing from Malfini through Mergado to your online store will always be up to date. An additional benefit is that if your online store runs on a platform like Shoptet, Shopify, or WooCommerce, Mergado will pre-configure some rules for you — for example, for calculating the selling price, hiding selected categories, or editing product names. ### **How do I set up the Malfini connection?** In the second step of project creation, click Connect Malfini, choose the language version of the feed, click Continue, select the output format (e.g. your online store platform), and continue to the final step of project creation. ### **What if creating a new project causes me to exceed my current prepaid plan?** If you have multiple active projects within an online store and the newly created project causes you to exceed the limit of your currently prepaid plan, Mergado will notify you of the plan upgrade by email. ### **What should I do if Mergado reports an error during feed import?** Check whether your feed URL is publicly accessible. If, for example, your feed is protected by an IP address whitelist, you need to add Mergado's IP address (81.31.39.112) to it. If the problem persists, contact our technical support at mergado@mergado.com. ### **What should I do if I didn't save the output feed URL during project creation?** Don't worry, the output feed URL is not lost. You can find it directly in your Mergado account: 1. Log in to Mergado and go to the *[User Details](https://app.mergado.com/user/details/)* page. 2. In the list of your online stores, select the one under which you created the project. 3. A list of all projects created under the selected online store will appear. Click the project you are interested in. 4. In the project details, you will see the output feed URL, which you can copy and paste into the target platform at any time. --- ## [How to duplicate a project in Mergado?](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-duplicate-a-project-in-mergado/) # **How to duplicate a project in Mergado?** Do you need to **create a new project that is essentially the same as one you already have, and you don't want to recreate all the rules from scratch**? Are you setting up a new **online store in Mergado that is a language variant of another online store on a different domain**, and you want to create projects that are nearly identical to those in the existing online store? Do you need to try out a few new rules and modifications in a project but **don't want to risk breaking a project that is running in production**? Or do you simply want to **back up** a project, just to be safe? All of these situations can be easily solved using the **Project Duplication** feature, which lets you **create a copy of the selected project** with a single click. During duplication, you can also choose whether to create the copy under the same online store or a different online store for which you have Owner or Write permissions. Duplication also **copies all rules**, saving you a lot of time that you would otherwise spend creating them. In the new project, you may only need to swap the input feed, make a few adjustments, and you are done. ## **What information is transferred to the duplicated project?** Duplication creates a **new standalone project with the name you choose, under the selected online store**. Almost all information from the original project is transferred: * Input feed URL and format * Output feed format * All created queries * All created rules (and also some rules created by extensions that were running on the original project) * All created elements and variables (elements created by extensions will only be populated with values once you activate the corresponding extension on the new project) What is **NOT** transferred to the duplicated project: * Extensions that were enabled on the original project are not automatically activated (and some rules created by extensions are not transferred either) * Manual changes to products * Edit and change history from the original project * A new output URL will be generated ℹ️ If you need to **change the input or output feed format** for the duplicated project, contact our **technical support** at mergado@mergado.com. ## **How to duplicate a project?** 1. On the ***User Details* page in your account, click the **online store** containing the project you want to duplicate. 2. For the project you want to duplicate, **click the gear icon, which will take you to the *General Project Settings* page**. 3. In the ***Duplicate* section, enter the name for the new project and select the target online store** under which the new project should be created. 4. Click ***Duplicate***. 5. Once the project is duplicated, you will receive a **notification by email**. ## **FAQ** ### **What is the Project Duplication feature for?** Project Duplication lets you quickly create a copy of an existing project within the same or a different online store (for which you have Owner or Write permissions). It is useful for testing new rules, creating backups, or reusing existing settings without having to recreate everything from scratch. ### **What information is transferred to the duplicated project?** During duplication, almost all information is copied: input feed URL and format, output feed format, queries, all rules (including some created by extensions), and all elements and variables. ### **Is there anything that is NOT transferred to the duplicated project?** Extensions that were enabled on the original project are not activated. Some rules created by extensions, manual changes to products, and the edit and change history of the original project are not transferred either. A new output feed URL will also be generated. ### **How do I create a copy of a project?** On the *User Details* page, click the online store where the project is located, and for the selected project, click the gear icon. This takes you to the *General Project Settings* page, where in the *Duplicate* section, you enter the name for the new project and select the target online store under which the new project should be created. Then click *Duplicate*. You will receive a confirmation email once duplication is complete. ### **What should I do if I need to change the input or output feed format for the duplicated project?** If you want to change the input or output format, contact our technical support at mergado@mergado.com, who will help you with that. ### **Can I use duplication to create a project under an online store I don't own?** Yes, if you have Write permissions for the target online store. If you only have Read permissions or no permissions at all, you cannot duplicate the project under that online store. ### **How do I create a new project that is almost identical to another one without recreating all the rules?** Using the Project Duplication feature, you can quickly create a copy of an existing project, including all rules and settings. Simply select the original project, choose the target online store, and click Duplicate. Then you can, for example, swap the input feed or make other adjustments. If you want to change the input or output feed format for the duplicated project, you need to contact our support at mergado@mergado.com. ### **How can I test new rules or changes without risking my current project?** The easiest way is to create a copy of the existing project using duplication. You can test new rules and changes on the copy. The original project remains untouched and fully functional. ### **How can I back up my current project?** Using duplication, you can create a backup copy of the project that will contain all rules and settings. You can use or modify the new copy at any time if needed. --- ## [How to move a project to a different online store in Mergado?](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-move-a-project-to-a-different-eshop-in-mergado/) # **How to move a project to a different online store in Mergado?** Do you manage multiple online stores in Mergado and accidentally **created a project under the wrong online store**? No problem! If you have **Owner or Write permissions** for both the original and the target online store, you can easily move the project to the correct online store yourself. ℹ️ When moving projects, keep in mind that according to the [Terms of Use](https://www.mergado.cz/podminky-uzivani), **it is not allowed to have multiple different online stores within a single online store**. So if you have two online stores, each on its own domain, you also need to create two online stores in Mergado, under which you create the corresponding projects for individual advertising platforms. ## **How to move a project to a different online store** 1. On the **[*User Details*](https://app.mergado.com/user/details/) page in your account, click the online store** containing the project you want to move. 2. For the project you want to move, **click the gear icon on the right, which will take you to the *General Project Settings* page**. 3. Scroll to the ***Move project to a different online store* section and click *Move project***. 4. In the ***Target online store* field, select the online store** you want to move the project to. 5. Click ***Move***. 6. The project will be **moved to the new online store along with its entire change history and settings**. ## **How to move a project to an online store I don't manage** Do you need to **move a project to an online store for which you only have Read permissions** or no connection to it in Mergado? In that case, contact our **technical support** at mergado@mergado.com and we will move the projects for you. However, we will need **email confirmation from the Owner of the target online store** confirming that your project can indeed be moved under their online store. ## **FAQ** ### **How do I move a project to a different online store?** 1. On the *User Details* page in your account, click the online store where the project is located. 2. For the project you want to move, click the gear icon, which will take you to the *General Project Settings* page. 3. In the *Move project to a different online store* section, click *Move project*. 4. Select the target online store and click *Move*. ### **Can I move a project to an online store I don't manage?** If you need to move a project to an online store for which you only have Read permissions or no connection to it in Mergado, contact our technical support at mergado@mergado.com. We will need email confirmation from the Owner of the target online store agreeing to the project being moved under their online store. ### **What should I do if I have multiple online stores and accidentally created a project under the wrong one?** If you created a project under the wrong online store, you can easily move it: 1. On the *User Details* page in your account, click the online store where the project is located. 2. For the project you want to move, click the gear icon to go to the *General Project Settings* page. 3. In the *Move project to a different online store* section, click *Move project*. 4. Select the target online store where you want to move the project. 5. Click *Move*. This process lets you easily relocate the project to the correct online store without having to delete or recreate it. ### **Can I have multiple different online stores within a single online store in Mergado?** No, according to the [Terms of Use](https://www.mergado.cz/podminky-uzivani), it is not allowed to have multiple different online stores within a single online store. If you have multiple online stores, each must have its own online store in Mergado as well. Under each online store, you then create the corresponding projects for that store. --- ## [How to disable and enable a project in Mergado?](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-disable-and-enable-a-project-in-mergado/) # **How to disable and enable a project in Mergado?** You have created a project in your online store for a specialized advertising platform (such as Favi or Biano), but right now **you don't have time to fully manage it**? The project would just be losing you money at the moment, but you know that **you want to get it going again in the future**? You **sell seasonal products** (such as skis or Christmas trees) that **only make sense to advertise during the season**, and outside of it you want to keep the projects with these products inactive? You want to **optimize your budget and have decided to pause a certain project** for a while to reduce advertising costs? Or you simply **forgot to pay your Mergado invoice on time** and want to **reactivate projects** that were disabled as a result? None of this requires deleting or creating entirely new projects. If you have Owner or Write permissions for the online store the project belongs to, you can simply **disable or enable the selected project**. Whenever you want to temporarily disable or re-enable a certain project, **contact our support** at mergado@mergado.com. ℹ️ If you have paid Mergado extensions enabled for the projects you wish to temporarily disable, these extensions will be automatically disabled along with the project. **However, if you have paid extensions enabled at the online store or user level, we recommend disabling them for the duration of the project's downtime.** Some extensions can work even with an inactive export, which means they could still be billed to you. ## **FAQ** ### **How do I disable a project in Mergado without deleting it?** If you want to temporarily disable or re-enable a project, simply contact our support at mergado@mergado.com. We will disable or enable the selected project for you whenever you need. ### **How do I enable a temporarily deactivated project in Mergado?** To enable a temporarily disabled project, contact our support at mergado@mergado.com. ### **Can I pause a project without deleting it?** Yes, projects can easily be disabled or enabled without needing to delete and recreate them. Contact us at mergado@mergado.com and we will take care of it. ### **What should I do if my project was disabled due to an unpaid invoice?** Contact our support at mergado@mergado.com. ### **What should I do if I have a project with seasonal products that I don't want to advertise right now, but want to keep for the next season?** If you want to keep the project but don't want to advertise the seasonal products at the moment, the project can be disabled without having to delete it. Once the products are ready to be advertised in the next season, you can reactivate the project. To disable or enable a project, contact our support at mergado@mergado.com. --- ## [How to delete a project in Mergado?](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-delete-a-project-in-mergado/) # **How to delete a project in Mergado?** If you have decided to permanently **remove one of your projects** (e.g. you no longer want to advertise on a certain platform, or you want to reduce advertising costs) and you are sure you will **never want to go back to it**, you can simply delete it. > **Tip!** If you **temporarily do not want to use a project** (e.g. you sell seasonal products that are not worth advertising on a specific platform outside of the season), but you know you will want to activate it again later, we recommend **simply disabling the project and re-enabling it at the right time**. You can learn more about disabling and enabling a project in this article. ## **How to delete a project?** 1. On the ***User Details* page in your account, click the **online store** where the project you want to delete is located. 2. For the project you want to delete, **click the gear icon, which will take you to the *General Project Settings* page**. 3. In the ***Delete Project* section, confirm by checking the box** that you really want to delete the selected project. 4. Click ***Delete Project***. 5. Once the project is deleted, you will receive a **notification by email**. ## **How to restore an accidentally deleted project?** If you **accidentally delete a project** and need to restore it, **contact our technical support immediately** after the deletion at mergado@mergado.com or by phone at +420 530 513 050. > **Tip!** Restoration is only possible **shortly after deletion, and we can help you during our working hours**. So if you plan to delete projects and "clean up" your online stores, we recommend scheduling this activity for working days, ideally in the morning, so we have time to respond to your message and help you if needed. ## **FAQ** ### **How do I delete a project in Mergado?** On the *User Details* page in your Mergado account, click the online store where the project is located. For the project you want to delete, click the gear icon to go to the *General Project Settings* page. In the *Delete Project* section, check the confirmation box and click *Delete Project*. After successful deletion, you will receive an email notification. ### **Can I restore an accidentally deleted project?** If you accidentally deleted a project, contact our technical support immediately at mergado@mergado.com or by phone at +420 530 513 050. Restoration is only possible shortly after deletion. ### **What should I do if I don't want the project to be active, but I know I will need it again in the future?** If you don't want the project to be active but know you will want to use it again later, there is no need to delete it and then recreate it. We recommend disabling the project and then re-enabling it when the time comes. You can learn more about disabling and enabling a project in this article. --- ## [How to access project history in Mergado?](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-access-project-history-in-mergado/) # **How to access project history in Mergado?** Something in your project **isn't working the way it should and you don't know where the error occurred**? Are you **analyzing your advertising** and want to understand what caused certain fluctuations? Multiple users manage your online store and you need to **find out who set up certain rules and when**? Do you want to **schedule feed regeneration based on when the advertising platform downloads the project**, so your data is always as up-to-date as possible? All important **information about events and changes in a specific project's feed can be found on the *History* page**. This makes it easy to identify where an error occurred, or you can use the information for analysis and further work on the project. You can **filter** the information you are looking for based on event type (e.g. product import, rule application, download, extension activation, queries, and more), date, or the user who made the change. Each event can be expanded by clicking the arrow on the right to **reveal additional details**. The entire project *History* can be **downloaded as a CSV file**, which you can use for analysis outside of Mergado. ## **What information can I find in the project History?** You will find out **when the project was created, when it was disabled or re-enabled, when rules were applied, who created them, when the feed was regenerated, or when products were imported or exported**. You will see when another person or advertising platform downloaded your data, and you will also find the downloader's IP address or the so-called UserAgent, along with much more. ## **What information is NOT in the project History?** The project History **does not store information about imported values**. You will not be able to find out when and what values were imported into specific elements. ## **How to view project history?** 1. On the ***User Details* page in your account, click the **online store** containing the project whose history you want to view. 2. Click the **selected project**. 3. In the left panel, click the ***History* tab**. 4. Here you can view the **complete history of events and changes** in the project. 5. As needed, you can **filter** the history by event type, date, or the user who made the changes. ## **FAQ** ### **Where can I find details about changes and events in a project?** Information about changes and events in a project can be found on the *History* page. In your account, go to the *User Details* page, click the online store containing the project, and then click the project whose history you want to view. In the left panel of the project page, click the *History* tab to see a complete list of events and changes. ### **What can I find in the project History?** The project *History* displays all important events and changes, such as project creation, disabling/enabling, rule application, product import/export, data downloads, and much more. You can find out who made specific changes and when, and get additional details such as the downloader's IP address or UserAgent. ### **Can I filter the information in the project History?** Yes, in the project *History* you can filter information by event type (e.g. product import, rule application, or download), date, or the user who made the changes. This helps you easily find the information you need. ### **Can I download project change information into a single file?** Yes, the entire project history can be downloaded as a CSV file, which you can use for analysis outside of Mergado. ### **How do I find out when the project was regenerated or when products were imported/exported?** This and much more can be found on the *History* page. You will find the specific date and time of product imports or exports, project regeneration, rule application, who created them, and more. ### **Can I find out when and what values were imported into specific elements?** No, unfortunately this information is not available in the project *History*. --- ## [Elements in Mergado](https://help.mergado.com/en/mergado-editor/working-with-data/basic-components/elements-in-mergado/) # **Elements in Mergado** ## **1\. What are elements** ### **Definition** An **element** is the basic building block of a feed that carries data. Each element represents a specific piece of information – for example, a product name, price, code, or image. In both XML and CSV, an element serves as **a label for where a given value is located**. In simple terms: * element \= “name of the information”, * value \= “content of that information”. **Example:** \Bid long and prosper – hrnek\ \364.21 CZK\ \47\ In this example: * `` is the element, * “Bid long and prosper – hrnek” is its value. ### **Elements in different formats** #### **Element in an XML feed** In XML files, an element is everything located **between an opening and closing tag**. An element can contain text, attributes, or other elements (known as nesting). XML is a hierarchical format – which allows it to describe even complex relationships between data. **Example:** \1499\ The element `PRICE_VAT` contains a single value – the price including VAT. #### **Element in a CSV feed** In CSV files, an element corresponds to **a single column** in a table. The column name represents the element, and the cells in the column represent its values. **Example:** | PRODUCTNAME | PRICE\_VAT | EAN | | :---- | :---- | :---- | | Hrnek Mergado | 1499 | 8592384021932 | CSV cannot handle nesting (parent–child), so Mergado **simulates this structure using the notation `parent | child`**. #### **Element in Mergado Editor** In Mergado Editor, each element corresponds to **a single row on the *Elements* page**. The Editor displays the feed structure as a tree – that is, in a hierarchy where nested elements are shown with indentation. Each element in Mergado can be: * **simple**, if it has only one value, * **multiple**, if it repeats multiple times (e.g., multiple images, multiple parameters), * **nested**, if it is part of another element, * or **attribute-based**, if it supplements the main value with additional information (e.g., `@id` or `@description`). ### **What elements are used for** Elements are the foundation for **transferring, processing, and editing data** in Mergado. They help organize data so that it can be: * read, modified, and exported, * converted between formats (e.g., Heureka → Google Merchant), * sorted, filtered, and evaluated. In practice, you work with them when: * creating **product queries**, * setting up **rules**, * working with **variables and automation**, * **sorting** and reviewing data on the *Products* and *Elements* pages. ### **Summary** An element is the basic unit of data in a feed. Mergado treats it uniformly regardless of format – whether it comes from XML, CSV, or another source. Understanding how elements work and how they relate to each other is key to working effectively with rules, queries, and exports. ## **FAQ** ### **What is an element?** An element is the basic building block of a feed that carries specific information – such as a name, price, or product code. In both XML and CSV formats, it represents the label for where a given value is located. ### **What is the difference between an element and a value?** An element is the name of the information (e.g., `PRICE_VAT`), while the value is its content (e.g., `1499`). Together they form a pair – a name and its data content. ### **What does an element look like in an XML feed?** In XML, an element is defined by an opening and closing tag. Example: * `1499` Here, `PRICE_VAT` is the element and `1499` is its value. ### **How does an element work in a CSV feed?** In a CSV file, an element corresponds to a column name. Each cell in that column represents the element's value. Example: * `PRICE_VAT` → a column with values 1499, 1599, 1799, etc. ### **How is nesting expressed in CSV when CSV does not support hierarchy?** Mergado simulates nesting in CSV using the notation `parent | child`. For example, the path `PARAM | VAL` represents the value of the element `VAL` nested under the element `PARAM`. ### **How does Mergado Editor display elements?** In Mergado Editor, each element is displayed as a separate row on the Elements page. Nested elements are visually indented and form a tree structure that corresponds to the XML feed structure. This also applies to the Products page in the Elements view. ### **What types of elements does Mergado distinguish?** Mergado works with four basic types: * Simple elements – have one value. * Multiple elements – can have multiple values. * Nested elements – are part of another element. * Attribute elements – supplement the element with additional information (e.g., `@id`). ### **What are elements used for in Mergado?** Elements are the foundation for working with data – they are used for reading, editing, filtering, exporting, and converting data. They are essential when working with rules, queries, variables, and automation. ### **Are elements the same across all formats?** Yes. Mergado treats them uniformly – regardless of whether they come from XML, CSV, or another format. ### **Why is it important to understand elements?** Because almost all work in Mergado (queries, rules, calculations, exports) is based on elements. Understanding elements means being able to precisely control data editing and processing. --- ## **2\. Element basics** ### **Types of elements** Mergado distinguishes four basic types of elements. Each has specific behavior and usage options. #### **1. Simple elements** * Have **one value**. * Their position (`@@POSITION`) is always **equal to 1**. * When working with them, there is no need to specify the position. **Example:** \47\ The path `ITEM_ID` targets the same value as `ITEM_ID { @@POSITION = 1 }`. #### **2. Multiple elements** * Contain **multiple values** of the same type. * Each value has its own **position** (1, 2, 3 ...). * To target a specific value, **conditions** or the attributes `@@POSITION` and `@@VALUE` are used. **Example:** \url1.jpg\ \url2.jpg\ The element `IMAGE` has two values – at position 1 and 2\. Multiplicity is commonly found, for example, with images, shipping methods, parameters, or categories. #### **3. Nested elements** * Are **inside another element** (called the parent). * Create a hierarchical data structure. * In Mergado, nesting is displayed with indentation, and in the element path using the pipe character `|`. **Example:** \ \Barva\ \Černá\ \ The path to the value is: * PARAM | VAL This notation specifies that the value `VAL` is located inside the element `PARAM`. #### **4. Attribute elements** * An attribute is supplementary information that extends the meaning of an element. * In XML, it is specified in the opening tag and denoted with the `@` symbol. * In Mergado, attributes are commonly used and written using paths with `@`. **Example:** \obrazek.jpg\ Path to the attribute: * IMAGE | @description ### **How to view elements in Mergado Editor** #### **The *Elements* page** On the *Elements* page, you will find a complete overview of all elements in the project. Here you can: * show and hide elements (for the output feed), * add, delete, or rename elements (for user-created elements), * sort by name or by structure, * view their **input and output values**. Clicking on an element name opens a detailed overview of all its values. #### **The *Products* page** On the *Products* page, elements can be displayed in two ways: * **”Elements” view** – displays all elements and their values for a specific product. * **”Table” view** – allows you to select specific elements and display them in a clear table. #### **The *Element Path* tool (Element-Path)** On the *Elements* page and in rules, you can use the **Element Path** tool, which helps create the correct path and verify its validity. It shows you exactly where the path leads and makes it easier to work with rules or queries. ### **Summary** Elements are the basic unit that Mergado works with. They are distinguished by their function (simple, multiple, nested, attribute-based), and understanding them is key to working effectively with rules, queries, and the feed structure. ## **FAQ** ### **What types of elements exist in Mergado?** There are four basic types: * Simple – have one value. * Multiple – contain multiple values. * Nested – are located inside another element. * Attribute – supplement the value with additional information. ### **What does element position mean?** Each element value has its position (e.g., first, second, third value). For simple elements, the position is always 1; for multiple elements, it can be higher. ### **How do you work with multiple elements?** Multiple elements (e.g., IMAGE) can have multiple values. To work with them, conditions or special attributes @@POSITION (targeting by order) and @@VALUE (targeting by content) are used. ### **How do I recognize a nested element?** A nested element is located inside another element (called the parent). In the element path, it is denoted using the pipe character |, for example PARAM | VAL. ### **How are element attributes written?** Attributes are written using the at sign @. Example: * \obrazek.jpg\ In Mergado, the path to this attribute is IMAGE | @description. In some feed formats (e.g., Ceneo), attributes are also specified on the wrapper element. * \ \Název produktu\ … \ In this case, the path to these attributes in Mergado is @id, @price, @avail. And if you want to create a new attribute on the wrapper element in Mergado, you add it on the Elements page as a new row, not by using the plus icon on an existing element. ### **Where can I find elements in Mergado?** On the Elements page in the project's left menu. Here you can display, hide, add, or sort elements by structure. ### **How do I view the values of a specific element?** By clicking on its name on the Elements page, you open an overview of all its values – both input and output. ### **How are elements displayed on the Products page?** On the Products page, you can choose: * Elements view – all elements and their values for a specific product, * Table view – a clear listing of selected elements in a table. ### **What is the Element Path tool (Element-Path)?** **Element-Path**, or Element Path, is a language developed by Mergado that is used to **write paths to elements and their values**. Using Element-Path, you specify **which values in the feed you want to target** – whether you will read them or write to them. Mergado Editor works with elements just like an XML feed – in a tree structure. To precisely identify which data you want to work with in this structure, you need to know their **path**. This is exactly what the Element-Path language enables. ### **What is the difference between a simple and a multiple element?** A simple element has one value for all products (e.g., ITEM\_ID). A multiple element has several values (e.g., multiple IMAGE tags) for a single product – and these values can be worked with individually using Element-Path. ## **3\. Element nesting** ### **What is nesting** **Nesting** is a property of an element that determines its placement in the hierarchy of an XML feed. An element is considered nested if it is located in the XML **between the opening and closing tags of another element**. Nesting creates a structure that helps maintain clarity and logical relationships between data. This principle has practical significance – elements that are nested within each other usually **are related and form a single unit**. You will encounter such structures, for example, with product parameters, categories, or shipping providers. **Example:** \ \Barva\ \Černá\ \ In this case: * `PARAM_NAME` is the parameter name, * `VAL` is its value, * `PARAM` is the parent element that connects both. Thanks to this structure, Mergado recognizes that the value “Černá” belongs to the parameter “Barva”. ### **Parents, children, and siblings** Nested elements form relationships that correspond to the tree structure of XML: | Relationship type | Description | | ----- | ----- | | **Parent** | The element into which another element is nested. | | **Child** | The element that is inside another element. | | **Siblings** | Elements that share the same parent. | **Example of relationships:** PARAM | PARAM\_NAME PARAM | VAL * `PARAM` is the parent. * `PARAM_NAME` and `VAL` are its children. * `PARAM_NAME` and `VAL` are siblings of each other. In Mergado Editor, this relationship is visually represented by indentation – children are always shifted to the right relative to the parent on the *Elements* and *Products* pages. ### **How Mergado works with nested structures** Mergado Editor works with elements by **adopting and displaying the XML feed structure in its natural tree form**. Each element retains information about its parent and children, which makes it possible to: * precisely distinguish which values belong together, * correctly target a specific value (e.g., `PARAM | VAL`), * create and manage new nested elements directly in the Editor interface. On the **Elements** page, you can add new nested elements by clicking the “+” icon next to the parent element. An element created this way is empty and is only populated using a rule (e.g., *Rewrite*). For better orientation, you can think of the structure as folders and files: * the **parent element** is a folder, * the **child** is a file or subfolder inside it. For example, the path `PARAM | VAL` means that the value `VAL` is located inside the element `PARAM`. ### **CSV and nesting** Nesting is a natural property of formats like **XML** or **JSON**, but **CSV** format cannot express it natively. Therefore, Mergado **simulates nesting in CSV using the notation `parent | child`**, so that data can be worked with in the same way as in XML. In practice, this means that in a CSV file, each column represents a path to an element. For example: PARAM | PARAM\_NAME PARAM | VAL This notation expresses that the element `VAL` is nested under the element `PARAM`. In this way, Mergado can preserve logical relationships between data even in formats that do not natively support nesting. ### **In practice: working with nesting in Mergado Editor** #### **1\. Writing a path to a nested element** When you want to work with a nested element in a rule or query, you write its path using the pipe character `|`. **Example:** * PARAM | VAL This notation means: “Find the element `PARAM` and within it the child `VAL`.” Spaces before and after the pipe character must be maintained. * Correct: `PARAM | VAL` * Incorrect: `PARAM|VAL` #### **2\. Precise targeting using a condition** If the element `PARAM` has multiple values (e.g., multiple parameters), it is advisable to add a **condition** for more precise targeting. Conditions are written in curly braces `{ }` and filter values according to the specified criterion. **Example:** * PARAM { PARAM\_NAME \= “Typ displeje” } | VAL This notation says: “Find the element `PARAM` that has a child `PARAM_NAME` with the value *Typ displeje*, and modify its value `VAL`.” This way you target exactly the desired parameter regardless of its position in the feed. ### **Difference between XML and CSV when processing nesting** | Property | XML feed | CSV feed | Display in Mergado | | ----- | ----- | ----- | ----- | | **Nesting support** | Yes, natively. | No, Mergado simulates it. | Yes, through a tree structure. | | **Displaying relationships** | Using tags and indentation. | Using column names. | Using indentation on the *Elements* and *Products* pages. | | **Path notation** | Using tags. | \`Parent | Child\`. | While XML expresses nesting through markup and nested tags, CSV uses path notation with the `|` delimiter. Mergado unifies both structures and allows you to work with them in the same way. ### **Summary** Nesting is a fundamental principle of working with data in Mergado Editor. It allows you to recognize how values of individual elements relate to each other, and thus precisely target rules and queries. A proper understanding of nesting is key to working effectively with parameters, shipping providers, variants, and other multiple structures. Whether you work with an XML or CSV feed, Mergado can display, preserve, and utilize nesting for all types of edits. ## **FAQ** ### **What is element nesting?** Nesting is a property of an element that indicates it is **located inside another element**. This relationship creates a data hierarchy – for example, the element `PARAM` (parent) can contain parameter names and values (`PARAM_NAME` and `VAL`), which are its children. The terms *nested* and *embedded* mean the same thing. ### **What is nesting used for?** Nesting helps maintain a **logical and clear data structure**. It allows you to unambiguously assign values to their context – for example, that the parameter “Barva” has the value “Černá”. This makes it possible to unify related information into a single structure. ### **What relationships are used in a nested structure?** Nested elements form three types of relationships: * **Parent** – an element that contains other elements. * **Child** – an element that is inside another element. * **Siblings** – elements that share the same parent. Example: in the path `PARAM | VAL`, `PARAM` is the parent and `VAL` is its child. ### **What does a nested element look like in XML?** In XML, nesting is expressed using nested tags. Example: \ \Barva\ \Černá\ \ The element `PARAM` is the parent, `PARAM_NAME` and `VAL` are its children. ### **How does Mergado display nested elements?** Mergado Editor displays elements **in a tree hierarchy** that corresponds to the XML feed structure. Nested elements are indented to the left relative to their parent. You can see nesting, for example, on the *Products* and *Elements* pages. A new nested element can be created by clicking the “+” icon next to the parent element. ### **How is nesting written in Element-Path?** Nesting is written using the **pipe character `|`** between element names. Example: PARAM | VAL This notation means that `VAL` is a child of the element `PARAM`. Spaces before and after the pipe character must be preserved. * Correct: `PARAM | VAL` * Incorrect: `PARAM|VAL`. ### **How is nesting expressed in CSV format?** CSV format cannot express hierarchy natively, so Mergado **simulates** nesting using the notation `parent | child`. For example, `PARAM | PARAM_NAME` and `PARAM | VAL` express the same relationship as in the XML structure. ### **Which file types can handle nesting?** The formats **XML** and **JSON** naturally work with nesting. CSV format does not natively support nesting, but Mergado Editor helps it do so using the `parent | child` notation. ### **What is the maximum number of nesting levels?** There is no theoretical limit on nesting depth. In practice, Mergado has encountered up to nine levels of nesting, for example in feeds in the Upgates format. ### **How to precisely target the value of a nested element?** For precise targeting, a **condition in the path** is used. Example: `PARAM { PARAM_NAME = “Typ displeje” } | VAL` This notation says: “Find the element `PARAM` that has a child `PARAM_NAME` with the value *Typ displeje*, and work with its element `VAL`.” This method is the most reliable because it works regardless of the order of elements in the feed. ### **How to target when an element is both multiple and nested?** If an element is multiple (e.g., `PARAM` repeats multiple times), you need to use a condition. The path `PARAM | VAL` without a condition targets all values, but precise targeting is achieved with: `PARAM { PARAM_NAME = “Barva” } | VAL` ### **Why is targeting through a child more reliable than using @@POSITION?** Targeting through a child (e.g., `PARAM_NAME = “Barva”`) is more reliable because it selects the correct value regardless of its position in the list. The `@@POSITION` attribute only refers to order, so if the order of parameters differs between products, it can lead to incorrect results. ### **Why is working with nesting important?** Most complex data, such as parameters, shipping, or variants, is nested. A proper understanding of nesting allows you to work with data precisely, create reliable rules, and keep the feed logically structured and clear. ## **4\. Element multiplicity** ### **What a multiple element means** A multiple element is an element that has **multiple values with the same name**. From the perspective of feed structure, this means that within a single product, the given element appears repeatedly – for example, with images, parameters, or variants. Multiplicity allows you to **unify multiple related values under a single element name**, so there is no need to create new elements for each value separately. You will most commonly encounter multiple elements with: * image URLs (e.g., `IMGURL_ALTERNATIVE`), * product parameters (`PARAM`), * shipping (`DELIVERY`), * categories, * product variants. **Example in XML structure:** \url1.jpg\ \url2.jpg\ In this case, the element `IMGURL_ALTERNATIVE` is multiple because it has more than one value. ### **Difference between a simple and a multiple element** | Property | Simple element | Multiple element | | ----- | ----- | ----- | | **Number of values** | Only one value. | Multiple values with the same name. | | **Value position** | Always equal to 1\. | Each value has its own position (2, 3 …). | | **Path notation** | No need to specify position. | To target a specific value, a condition or the `@@POSITION` attribute must be used. | | **Examples** | `ITEM_ID`, `DESCRIPTION`, `PRICE_VAT` | `IMAGE`, `PARAM`, `DELIVERY`, `IMGURL_ALTERNATIVE` | In nested structures (e.g., `PARAM`), multiplicity applies to the parent element. Children (typically `PARAM_NAME` and `VAL`) remain simple because within a single parent they always have only one value. ### **How Mergado works with positions** Each element value has its ordinal number, or **position** (1, 2, 3 …). The position can be used for precise targeting of a specific value within an element. For working with positions, Mergado uses the special attribute `@@POSITION`. It is part of the **Element-Path** language and allows you to specify which position within an element you want to target. **Example:** \url1.jpg\ @@POSITION \= 1 \url2.jpg\ @@POSITION \= 2 \url3.jpg\ @@POSITION \= 3 If you want to work with the third image, use the path: * IMAGES | IMAGE { @@POSITION \= 3 } This notation says: “I am working with the element `IMAGE` at the third position.” #### **Limitations of the `@@POSITION` attribute** The `@@POSITION` attribute only refers to order, not content. If the order of values differs across products, the same positions may not correspond to the same information. Example: * The first product has parameters 1\. Material, 2\. Volume. * The second product has 1\. Material, 2\. Decor. The path `PARAM { @@POSITION = 2 } | VAL` would then refer to *Decor* for the second product, not *Volume*. It is therefore safer to target by name: * PARAM { PARAM\_NAME \= “Objem” } | VAL ### **How to work with multiplicity in Mergado Editor** #### **Finding and using position** 1. On the **Elements** page, open the given element and you will see all its values with their positions. 2. In rules or queries, you can target: * by position, e.g., `IMGURL_ALTERNATIVE { @@POSITION > 1 }`, * or by a range of positions, e.g., `IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }`. 3. If you want to work with the value instead of the position, use the `@@VALUE` attribute, for example: * `CATEGORY { @@VALUE != “Hračky” }` 4. This notation selects all values of the element `CATEGORY` that are not equal to “Hračky”. #### **When you do not need to specify position** You do not need to specify position in the path in the following cases: 1. **Simple elements** 1. They always have only one value, so position \= 1\. The path `ITEM_ID` is equivalent to `ITEM_ID { @@POSITION = 1 }`. 2. **Reading from a multiple element without specification** 1. If you read from a multiple element in a rule without a condition, Mergado automatically uses the first value. 2. For example: when using `%PARAM | VAL%`, Mergado takes the first value. 3. **Targeting all values** 1. If you want to process all occurrences of an element, use only the element name without a condition. 2. E.g., `IMAGES | IMAGE` works with all images. 3. When writing, keep in mind that the change will be applied to all values matching the given path. ### **Summary** Multiplicity allows storing and processing multiple values of the same type within a single element. For precise work, it is advisable to target specific values using conditions or special attributes. This ensures that edits are performed correctly and do not affect other data. ## **FAQ** ### **What is a multiple element?** A multiple element is an element that has multiple values with the same name. In practice, this means it appears repeatedly within a single product – for example, with images, parameters, shipping, or categories. Typical multiple elements are `IMAGE`, `PARAM`, `DELIVERY`, or `CATEGORY`. ### **What is the difference between a simple and a multiple element?** * A **simple element** contains one value and always has a position equal to 1\. * A **multiple element** can have multiple values, each with its own position (2, 3, 4 …). Example: `url1.jpg` `url2.jpg` The element `IMAGE` is multiple because it appears more than once and contains multiple values. ### **What is multiplicity used for?** Multiplicity allows you to unify multiple related values under a single element name. There is no need to create new elements for each value separately. For example, all alternative product images can be written as repeating `IMGURL_ALTERNATIVE` elements. ### **Which elements are typically multiple?** Multiplicity most commonly occurs with elements that describe repeating product properties, for example: * Image URLs (`IMGURL_ALTERNATIVE`), * product parameters (`PARAM`), * shipping (`DELIVERY`), * categories, * product variants. ### **How does Mergado work with value positions?** Each element value has its **position**, i.e., an ordinal number (1, 2, 3 …). The position can be used for precise targeting of a specific value within an element. The special attribute `@@POSITION` is used for this. Example: `IMAGES | IMAGE { @@POSITION = 3 }` This notation means: “I am working with the element `IMAGE` at the third position.” ### **What does the @@POSITION attribute mean and how is it used?** `@@POSITION` determines the order of a value inside a multiple element. It is used in conditions for targeting a specific position or range of positions. Example: `IMGURL_ALTERNATIVE { @@POSITION > 1 }` This notation targets all alternative images except the first. However, keep in mind that `@@POSITION` only works with order, not content. If the order differs between products, it may target an incorrect value. ### **What is the @@VALUE attribute and when to use it?** `@@VALUE` represents the **content of the element's value** and allows targeting by value instead of position. It is used especially with elements that have no children, such as `CATEGORY` or `IMGURL_ALTERNATIVE`. Example: `CATEGORY { @@VALUE != “Hračky” }` This notation selects all categories except “Hračky”. ### **How to target values of multiple elements in Element-Path?** Targeting is done using conditions in curly braces `{ }`. These can use the attributes `@@POSITION`, `@@VALUE`, or expressions from the MQL language. **Targeting all values:** `IMAGES | IMAGE` * Processes all values (`url1`, `url2`, `url3` …). **Targeting specific values or a range of positions:** `IMAGES | IMAGE { @@POSITION IN (3;4) }` * Targets the third and fourth image. ### **How to find value positions in Mergado Editor?** On the **Elements** page, you can view all values of each element including their positions. This overview helps you better understand the structure of multiple data and makes targeting in rules easier. ### **When is it not necessary to specify position in the path?** Position does not need to be specified in these cases: * **Simple elements** – always have one value (position \= 1). `ITEM_ID` is equivalent to `ITEM_ID { @@POSITION = 1 }`. * **Reading from a multiple element without a condition** – Mergado automatically uses the first value. E.g., `%PARAM | VAL%` takes the first value. * **Targeting all values** – just specify the element name without a condition, e.g., `IMAGES | IMAGE`. ### **What is the difference between targeting by position and by value?** * `@@POSITION` works with the order of the value. * `@@VALUE` works with the content of the value. If the order of values differs across products, it is safer to use `@@VALUE` because it targets the content directly. ### **What is the problem with targeting using @@POSITION?** `@@POSITION` only refers to order. If products have parameters in a different order, the path may target an incorrect value. It is safer to use targeting by child name, for example: `PARAM { PARAM_NAME = “Objem” } | VAL` ### **How to work with multiple elements in rules and queries?** Working with multiple elements depends on whether the rule **reads** from the element or **writes** to it. **Reading:** * If the path leads to multiple values, Mergado uses the first one. * If you want to read a different value, you need to specify the path with a condition. **Writing:** * If a rule writes to a multiple element, the change is applied to all values matching the given path. * If you want to write only to a specific value, you need to restrict the path using a condition. * If the condition contains the `=` operator or the `AND` conjunction, Mergado creates the missing structure automatically. ### **Why is it important to distinguish multiplicity?** Multiplicity means that an element can contain multiple values of the same type. Understanding this principle is essential for correctly setting up rules, queries, and precise targeting of specific data within a feed. ## **5\. Working with multiple elements in Mergado rules** Multiple elements behave differently in Mergado Editor than simple elements. Each product can contain multiple values of the same element, so it is important to know how rules work with them – how they read values, write values, and how to target them correctly. ### **How rules read and write multiple values** A multiple element is one that has **more than one value** for a single product. Rules in Mergado (for example, *Rewrite*, *Bulk copy values*, *Calculation*) have defined default behavior in such cases. #### **Reading from elements and variables** If a rule reads a value from a multiple element whose path leads to multiple values, **Mergado automatically uses only the first value**. This behavior applies when reading using the percent sign `%` notation (e.g., `%PARAM | VAL%`). Example: \Černá\ \XL\ If the rule reads from the path `PARAM | VAL`, Mergado takes only the first value “Černá”. For simple elements (e.g., `ITEM_ID`), this logic has no effect because there is always only one value. #### **Writing to elements** If a rule writes to a multiple element without further specification, **Mergado writes the value to all occurrences** of the given element. Example: * If you use the path `IMGURL_ALTERNATIVE` in a *Rewrite* rule and enter the new value `novy_obrazek.jpg`, Mergado overwrites all existing values of this element. If you want to write only to a specific value, you need to **specify the path using conditions**. For example, the path * PARAM { PARAM\_NAME \= “Barva” } | VAL writes the value only to the “Barva” parameters. If the “Barva” parameter appears multiple times in one product, the change is applied to all those occurrences. ### **When to use a condition and when a special attribute** For precise targeting of a specific value of a multiple element, you need to add a **condition**. Conditions work as a filter – they determine which values or positions the rule applies to. They are written in curly braces `{ }` and can contain either a **nested element** or a **special attribute**. #### **1\. Using a nested element in a condition** This method is **the most reliable** because it targets a value based on its content, not its order. Example: We want to rewrite the value of the element `VAL` that belongs to the parameter “Barva”: * PARAM { PARAM\_NAME \= “Barva” } | VAL This notation says: “Find all elements `PARAM` that have a child `PARAM_NAME` with the value *Barva*, and modify the value of the element `VAL` within them.” This method works regardless of the order of elements in the feed and is therefore recommended in most cases. #### **2\. Using the special attribute @@POSITION** The `@@POSITION` attribute is used for targeting a value by its order. Each element value has its position – first \= 1, second \= 2, etc. Example: IMGURL\_ALTERNATIVE { @@POSITION \> 1 } This notation targets all images except the first. **Suitable use:** For elements where the order of values corresponds to their meaning (e.g., alternative images). **Weakness:** Targeting with `@@POSITION` only refers to position, not content. If the order of values changes across products, the result may not be consistent. #### **3\. Using the special attribute @@VALUE** The `@@VALUE` attribute refers to the actual **value of the element**, not its order. It is suitable where the order changes or is not important. Example: * CATEGORY { @@VALUE \!= “Hračky” } This notation targets all values of the element `CATEGORY` except “Hračky”. `@@VALUE` is used primarily with elements that have no children (e.g., `CATEGORY`, `IMGURL_ALTERNATIVE`). For parent elements that do not carry a value themselves (e.g., `PARAM`), using it does not make sense. ### **Practical path examples** Rules in Mergado use the **Element-Path** language when working with elements (reading/writing), which allows precise targeting of the values you want to read from or write to. #### **Targeting the value of a specific parameter** * PARAM { PARAM\_NAME \= “Barva” } | VAL This notation reads or writes the value `VAL` for the parameter whose name is *Barva*. Mergado interprets this as follows: “Find the element `PARAM` that has a child `PARAM_NAME` with the value *Barva*, and modify the value of its child `VAL`.” #### **Targeting a value in variants** A path can combine multiple levels of nesting and multiplicity. Example for working with the second variant that contains the parameter “Velikost”: * VARIANTS | VARIANT { @@POSITION \= 2 } | PARAMETERS | PARAMETER { NAME \= “Velikost” } | VALUE This notation says: “Find the second variant of the product, in which the parameter *Velikost* carries a certain value, and work with that value.” ### **Adding new values using rules** When writing to multiple or nested elements, one important rule applies: **If the element you are targeting does not yet exist, Mergado will create it.** This means that everything specified in the condition (e.g., `PARAM_NAME = “Barva”`) and in the path with the `=` operator is created automatically. Example of adding a new structured value – a so-called “flag”: Element: FLAGS | FLAG { CODE \= “action” } | ACTIVE New value: 0 If a flag with the code `action` does not exist, Mergado creates a new `FLAG` (a new position) with the element `CODE = “action”` and adds the element `ACTIVE` with the value 0 to it. This mechanism is used when adding new variants, shipping providers, parameters, or other structured data. --- ### **Overview of rules affected by multiplicity** The described reading and writing behavior for multiple values applies to these rules: | Rule | Can read | Writes | | :---- | :---- | :---- | | Rewrite | ![:white\_check\_mark:][image1] | ![:white\_check\_mark:][image2] | | Find and replace | ![:white\_check\_mark:][image3] | ![:white\_check\_mark:][image4] | | Bulk rewriting by query | ![:white\_check\_mark:][image5] | ![:white\_check\_mark:][image6] | | Bulk rewriting by values | ![:white\_check\_mark:][image7] | ![:white\_check\_mark:][image8] | | Bulk copy values | ![:white\_check\_mark:][image9] (Source element) | ![:white\_check\_mark:][image10] | | Set product parameters | ![:white\_check\_mark:][image11] | ![:x:][image12] | | Set shipping rates | ![:white\_check\_mark:][image13] | ![:x:][image14] | | Set UTM parameters | ![:white\_check\_mark:][image15] | ![:x:][image16] | | Calculation | ![:white\_check\_mark:][image17] | ![:white\_check\_mark:][image18] | | Data file import | ![:x:][image19] | ![:white\_check\_mark:][image20] | ### **Summary** When working with multiple elements in Mergado Editor rules, the most important thing is to **know which value you are working with**. Without specification, a rule always reads the first value and writes to all matching values. Using conditions, special attributes `@@POSITION` and `@@VALUE`, or a combination of multiple nesting levels, you can precisely determine what the rule modifies. A correctly written element path ensures that edits are performed exactly where they should be – and remain safe even if the feed structure changes over time. ## **FAQ** ### **What is the basic principle of how rules work with multiple elements?** Rules in Mergado Editor work with multiple elements based on two principles – **reading values** and **writing values**. Simple elements always have only one value, so the rule works with them directly. However, multiple elements can have several values for a single product, so it is necessary to determine which one the rule should work with. Without specification, rules **read the first value** and **write to all values**. ### **How does Mergado read values from multiple elements?** If the path leads to multiple values, Mergado automatically uses **only the first value**. This behavior applies to all rules that read an element value using the `%` notation – for example, `%PARAM | VAL%`. Example: `Černá` `XL` The path `PARAM | VAL` returns the value “Černá” because it is the first occurrence. ### **How does Mergado write to multiple elements?** If a rule writes to a multiple element without further specification, Mergado writes the new value **to all its occurrences (positions)**. If you want to target only a specific value, you need to specify the path using a condition. Example: `PARAM { PARAM_NAME = “Barva” } | VAL` This notation modifies the value of the element `VAL` only for the “Barva” parameters. If a product has multiple “Barva” parameters, the change is applied to all those occurrences. ### **Why is it necessary to use conditions with multiple elements?** Conditions work as a **filter** that determines which values the rule applies to. Without a condition, the rule would affect all values of the element. Conditions are written in curly braces `{ }` and can contain either a nested element or a special attribute. ### **How to use a nested element in a condition?** Targeting using a nested element is the most reliable because it relies on content, not order. Example: `PARAM { PARAM_NAME = “Barva” } | VAL` This notation means: “Find the element `PARAM` that has a child `PARAM_NAME` with the value Barva, and modify the value of its child `VAL`.” This method works regardless of element order and is recommended in practice. ### **When to use the @@POSITION attribute** The `@@POSITION` attribute is used for targeting by **value order** within an element. Each value has its position – first \= 1, second \= 2, etc. Example: `IMGURL_ALTERNATIVE { @@POSITION > 1 }` Targets all images except the first. Use it where the order of values corresponds to their meaning (e.g., alternative images). Weakness: `@@POSITION` only refers to order, not content. If the order of values differs between products, results may not be consistent. ### **When to use the @@VALUE attribute** The `@@VALUE` attribute refers to the **actual value of the element** and allows targeting by content instead of order. It is mainly used with elements that have no children (e.g., `CATEGORY`, `IMGURL_ALTERNATIVE`). Example: `CATEGORY { @@VALUE != “Hračky” }` This notation selects all values of the element `CATEGORY` except “Hračky”. `@@VALUE` is suitable where the order of values may change or is not important. ### **How to combine conditions and special attributes** Multiple conditions and attributes can be combined in a single path. Conditions can contain logical operators (`AND`, `OR`) or MQL queries. Example: `VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = “Velikost” } | VALUE` Means: “Find the second variant of the product that contains the parameter Velikost, and work with its VALUE value.” ### **How does Mergado create new values when writing** If the element you are targeting does not exist, Mergado **automatically creates it** when writing. This applies to all conditions containing the `=` operator or the `AND` conjunction. Example: `FLAGS | FLAG { CODE = “action” } | ACTIVE` If the flag “action” does not exist, Mergado creates a new `FLAG` element with a child `CODE = “action”` and adds `ACTIVE` with the value 0 to it. This mechanism allows automatically adding new parameters, variants, or structured data. ### **How to prevent errors when working with multiple values** * Verify that the element you are working with actually contains multiple values. * Use conditions `{ }` for precise targeting. * Avoid relying on `@@POSITION` if the order of values differs between products. * Before writing, check that the path does not affect more values than intended. * Use the **Element Path** tool to verify where the rule targets. ## **6\. Attributes in elements** ### **What are attributes** An attribute is a **part of an element** that **specifies its meaning or property**. While the element carries the data itself, an attribute provides supplementary information about that data. Attributes thus function as *extensions of element values* and often help describe details that would otherwise not fit into the structure. #### **How attributes are written in XML** In XML, an attribute is always specified **in the opening tag of the element** and has its own name and value. The attribute value must be **enclosed in quotation marks or apostrophes**. **Example XML notation:** \ \Pavlína\ \Nováková\ \ In this example: * `person` is the element, * `gender` is the attribute, * `female` is the attribute value. The attribute `gender` thus specifies information about the person – that it is a woman. The same information could theoretically be expressed differently, using a separate nested element: \ \female\ \Pavlína\ \Nováková\ \ Both notations are correct – they differ only in data structure. Attributes are typically chosen where they supplement or clarify the meaning of the main element. ### **What attributes are used for** In product feeds, attributes have practical significance – they allow you to **describe a product or its properties more precisely**. Some advertising portals or online store platforms specifically require certain data to be provided in the form of attributes. ### **Examples of attribute usage in various systems** * **Ceneo** * Uses attributes to describe the manufacturer or other properties, for example: * \ \Nike\ \ * **Heureka (Availability feed)** * Requires attributes to add time information: * \2023-04-26 12:00\ * **Shoptet** * Uses attributes, for example, with images: * \https://cdn.myshoptet.com/obrazek.jpg\ * **Google Shopping** * Does not distinguish between elements and attributes but labels everything as *attributes* within its system. Correct use of attributes in Mergado allows you to **meet the requirements of these portals** and ensure that your feed is accepted without errors. ### **How to work with attributes in Mergado Editor** Mergado Editor is designed to fully support working with attributes. Attributes are one of the basic element types and can be used throughout the entire Editor environment – in rules, queries, variables, and MQL queries. #### **Identifying attributes** You can **recognize attributes in Mergado by the at sign `@` at the beginning of the name**. * `@id` – product identifier attribute, * `@description` – attribute describing an image, * `@availability` – attribute describing status or availability. In addition to regular attributes, there are also **special attributes** that begin with two at signs `@@`. These are used in the *Element-Path* language for precise targeting – typically `@@POSITION` (value position) and `@@VALUE` (element value). > **Tip!** Special attributes are only used for targeting element and regular attribute values within Element-Path and are never exported to the feed itself, unlike regular attributes, which you will find in the feed. #### **Targeting attributes using Element-Path** The **Element-Path** language is used for working with attributes. The path to an attribute is written using the at sign `@` before the attribute name. **Example of targeting by attribute:** 1\. In a rule, we target the CODE element of one specific variant that contains the value idvariant3 in the id attribute of the VARIANT element: \ \ \EEQ21\ \unit\ \1\ \1\ \ \ \EEQ22\ \unit2\ \0\ \0\ \ \ The path to the given CODE element will look as follows: VARIANTS | VARIANT { @id \~ “idvariant3” } | CODE. 2\. On the Products page, we are looking for a product with a default category having the attribute @id \= 123: \ \Spotrebice\ \Elektronika\ \ The condition for the query will look as follows: CATEGORIES | DEFAULT\_CATEGORY | @id \= “123”. ### **In practice: creating, rewriting, and deleting an attribute** #### **Creating an attribute** An attribute can be created directly on the **Elements** page. 1. Open the *Elements* page and choose the **New element** option. 2. Enter a name and choose the type **attribute**. 3. If you add the at sign `@` to the name, the Editor automatically recognizes that you want to create an attribute. 4. If you want to create a nested attribute, use the “+” icon next to the parent element and choose the *attribute* type. After creation, the attribute is empty (has no values). You can populate it, for example, using the *Rewrite* rule. #### **Rewriting an attribute value** Attributes can be edited just like regular elements – for example, using the *Rewrite* rule. **Targeting:** In the *Element* field, enter the path to the attribute, e.g.: IMAGE | @description SHOPITEM | @id PARAM { @@VALUE \= “Barva” } | @lang **Procedure:** On the *Rules* page, create a new rule of the *Rewrite* type, select a product query, enter the path to the attribute, and in the *New content* field enter the new value. #### **Deleting an attribute** Attributes can be deleted in two ways: 1. **Manually** – on the *Elements* page, manually created attributes can be deleted using the trash icon. This deletes both the values and the attribute itself. 2. **Using rules** – for attributes that come from the input or output format, only the values can be removed, using a rule (e.g., *Rewrite* with an empty value). Attributes defined by the target format (so-called system attributes) cannot be renamed or deleted because they are part of the output feed specification. ### **Summary** Attributes supplement the meaning of elements and allow you to describe data in the feed in more detail. In Mergado Editor, you can work with them just like regular elements – create them, change their values, and target them in rules. Correct work with attributes is especially important for feeds targeting portals that require a precisely defined structure, such as Google, Heureka, Ceneo, or Shoptet. ## **FAQ** ### **What is an attribute in the context of XML and product feeds** An attribute is a part of an element that **specifies its meaning or property**. While the element carries the data itself, an attribute provides supplementary information about that data – for example, a unit, status, or value type. In XML, an attribute is always specified in the **opening tag** of the element and has its name and value, which must be enclosed in quotation marks or apostrophes. Example: `` `Pavlína` `Nováková` `` Here, `person` is the element, `gender` is the attribute, and its value is `”female”`. ### **What are attributes used for in product feeds** Attributes have practical significance – they allow you to more precisely describe a product or its properties. Some advertising portals and online store platforms **require** certain data to be provided in the form of attributes. Examples of usage: * **Ceneo:** uses attributes to identify the manufacturer (`Nike`). * **Heureka (Availability feed):** attributes add time information (`…`). * **Shoptet:** the `description` attribute describes images (`…`). Using attributes in Mergado ensures that the feed meets the requirements of the target system and is accepted without errors. ### **How are attributes written in XML** An attribute is part of the opening tag of the element: `obsah elementu` The attribute value must be enclosed in **quotation marks** or **apostrophes**. `Example: Zimní bunda` Here, the attribute `available` adds information about the product’s availability. ### **How does Mergado Editor identify attributes** You can recognize attributes in Mergado Editor by the **at sign `@`** at the beginning of the name. * `@id` – element value identifier, * `@description` – element value description, * `@lang` – element value language. In addition to these regular attributes, there are also **special attributes** that begin with two at signs `@@` (e.g., `@@POSITION`, `@@VALUE`). These are used exclusively **in the Element-Path language** and are never exported to the output feed. ### **How to target attributes using the Element-Path language** The **Element-Path** language is used for working with attributes (reading, editing, filtering). The path to an attribute is written using the at sign `@` before its name. Targeting examples: When filtering products: Find products whose main category `id` equals 123: * `CATEGORIES | DEFAULT_CATEGORY | @id = “123”` In a rule when targeting a specific element: Find the CODE of a variant whose `@id` attribute contains the text `idvariant3`: * `VARIANTS | VARIANT { @id ~ “idvariant3” } | CODE` Attributes can also be used in conditions (in braces `{ }`), where they filter specific values. ### **What is the difference between regular and special attributes** In Mergado, we distinguish two types of attributes: | Attribute type | Notation | Usage | | ----- | ----- | ----- | | Standard attributes (XML) | `@id`, `@description`, `@availability` | Are part of the XML structure and define the meaning of the element. | | Special attributes (Element-Path) | `@@POSITION`, `@@VALUE` | Used for targeting in conditions when working with multiple elements. Are not part of the output feed. | ### **What are the special attributes @@POSITION and @@VALUE used for** **`@@POSITION`** – corresponds to the **order of the value** of the element it is bound to. It is mainly used with multiple elements (e.g., images, variants). *Example:* `IMGURL_ALTERNATIVE { @@POSITION > 1 }` * This notation targets all alternative images except the first. **`@@VALUE`** – represents the **content of the value** of the element. It is used with elements where the order of values changes or is not important. *Example:* `CATEGORY { @@VALUE != “Hračky” }` * This notation selects all categories except “Hračky”. ### **How to create a new attribute in Mergado** A new attribute can be created on the **Elements** page. 1. Click on **New element**. 2. Enter an attribute name starting with the `@` character. 3. Mergado automatically recognizes that you are creating an attribute. 4. If you want to create a nested attribute, use the “+” icon next to the parent element. A newly created attribute is empty and can be populated using the **Rewrite** rule. ### **How to edit or rewrite an attribute value** Attributes can be rewritten just like regular elements. In the **Rewrite** rule, simply enter the path to the attribute in the *Element* field. Examples: * IMAGE | @description * SHOPITEM | @id * PARAM { @@VALUE \= “Barva” } | @value Then enter the desired new value in the *New value* field. ### **How to delete an attribute** Attributes can be deleted in two ways: * **Manually:** for manually created attributes on the *Elements* page, click the trash icon next to the attribute. * **Using a rule:** e.g., with the *Rewrite* rule using an empty value. Attributes that are part of the source or target format cannot be deleted, only their values can be cleared. ### **What is the relationship between attributes and elements in Mergado** In Mergado, attributes are considered a special type of element. They can be used in rules, queries, variables, and automation just like regular elements. The difference lies only in the notation (with the `@` character) and their placement within the feed structure. ### **Why is it important to work with attributes correctly** Correct work with attributes is crucial for feeds targeting portals that require a precise data structure – such as Google, Heureka, Ceneo, or Shoptet. Incorrectly specified or missing attributes can cause feed rejection or incomplete product display. With Mergado Editor tools, attributes can be added, changed, and verified with high precision. ## **7\. The Element-Path language** ### **What is Element-Path** **Element-Path** is a language developed by Mergado that is used to **write paths to elements and their values**. Using Element-Path, you specify **which values in the feed you want to target** – whether you will read them or write to them. Mergado Editor works with elements just like an XML feed – in a tree structure. To precisely identify which data you want to work with in this structure, you need to know their **path**. This is exactly what the Element-Path language enables. ### **What “element path” means** An *element path* is a notation that expresses **where in the data structure the value(s) you want to work with are located**. Using this path, you tell Mergado that you want to either: 1. **read the value** – i.e., use it as input (e.g., in a rule or query), or 2. **change the value** – i.e., write new data to it. Example: * If you want to target the value of the element `NAME`, the path is simply: NAME Mergado Editor reads this path and uses the value contained in the element `NAME`. Note: In practice, the term “element path” is commonly used, although more precisely it always refers to the “path to the element's value”. For simple elements, however, both terms are semantically identical. ### **Nested paths** Nesting is written in the Element-Path language using the **pipe character `|`**, which expresses the parent-child relationship. * **Syntax:** To target a nested element, you add the parent's name before it and separate them with a pipe. * **Reading:** The pipe is read as “and nested under it” or “and its child”. **Example:** The path PARAM | VAL * means: “Find the element `PARAM` and nested under it the element `VAL`.” * **Important rule:** The space before and after the pipe **must be preserved** – `PARAM | VAL` is correct, `PARAM|VAL` is not. ### **Vocabulary and syntax of Element-Path** Element-Path has its own “vocabulary” and syntax rules. The basic components of the language are: 1. **Element names** – all names that exist in the project. 2. **Pipe (`|`)** – denotes nesting (parent → child). 3. **Conditions (`{ }`)** – filter values according to specified criteria. 4. **Special attributes (`@@…`)** – allow targeting, e.g., by position (`@@POSITION`), value (`@@VALUE`), or the last value (`@@MAX_POSITION`). 5. **MQL (Mergado Query Language)** – can be used in conditions for advanced filtering (e.g., with operators `AND`, `OR`, etc.). ### **Assistance when writing paths** In Mergado Editor, working with Element-Path is facilitated by several features: * **Autocompletion:** The Editor offers available elements, operators, and values. * **Validation:** If a written element does not exist in the project, it is highlighted in red; a valid path is highlighted in green. * **Autocompletion of shipping providers and parameters:** For some feed types, the Editor offers specific names (e.g., shipping providers, parameters) and automatically completes the entire path. ### **Where Element-Path is used** Element paths are used in almost all parts of Mergado Editor – wherever it is necessary to specify which data to work with. * **In rules** – e.g., *Rewrite*, *Find and replace*, *Bulk copy values*, *Calculation*. The element path determines which values the rule should work with. * **In queries** – when creating queries on the Products page or when writing a custom MQL query. * **In variables** – for reading values from specific elements and writing values to elements. * **In imports** – in the elements of import files processed via the *Import data file* rule. * **On the Products page** – for sorting, filtering, and viewing element values. * **In automation** – when setting up rules and conditions for automatic actions. ### **In practice: working with notation and conditions** Element-Path is especially important for nested and multiple elements. Correctly writing the path determines which values Mergado reads or modifies. #### **1\. Basic path without a condition** If you use a nested path without a condition, Mergado targets **all values** in the given structure. **Example:** * PARAM | VAL This path refers to all `VAL` values across all occurrences of the element `PARAM`. If a product has the parameters Barva, Velikost, and Materiál, the path `PARAM | PARAM_NAME` leads to three values. When reading, Mergado uses the first one; when writing, the change applies to all matching values. #### **2\. Precise targeting using conditions** Conditions are written in curly braces `{ }` and always bind to the element on the left. They serve to restrict targeting to specific values. **Targeting a specific value of a nested element** If you want to work only with the parameter “Barva”, use a condition that filters through the nested element `PARAM_NAME`: PARAM { PARAM\_NAME \= “Barva” } | VAL This notation means: “Find the element `PARAM` that has a child `PARAM_NAME` with the value *Barva*, and within it modify the value of the element `VAL`.” This method is the safest because it works regardless of the order of parameters in the feed. **Targeting the position of a multiple element** Using the special attribute `@@POSITION`, you can target a value by its position. Each value has its own ordinal number (1, 2, 3 …). **Example:** * IMAGES | IMAGE { @@POSITION \= 3 } This path targets the third image. It is suitable where the order of values has a fixed meaning. However, keep in mind that `@@POSITION` does not address content – if the order differs across products, an unintended value may be selected. **Targeting the value of a multiple element** The `@@VALUE` attribute refers to the element's value. It is used with elements that have no children and allows targeting by a specific value regardless of its position. **Example:** CATEGORIES | CATEGORY { @@VALUE \!= “Hračky” } This notation selects all `CATEGORY` entries whose value is not equal to “Hračky”. Conditions can also be combined with MQL operators (AND, OR, NOT, etc.), enabling very precise filtering. ### **Summary** Element-Path is the fundamental language for working with data in Mergado Editor. It allows you to precisely determine where values come from, where they should be written, and in what context they are located. A proper understanding of Element-Path structure and syntax enables you to create safe rules, effective queries, and automation that work reliably even with complex XML and CSV feeds. ## **FAQ** ### **What is the Element-Path language and what is it used for** **Element-Path** is a language developed by **Mergado**. It is used to write **paths to elements** and their values – that is, to specify which data in the feed you want to work with. Using Element-Path, you can: * **read values** from the feed (e.g., for queries, calculations, or conditions), * **write new values** (e.g., using rules like *Rewrite* or *Find and replace*). ### **What does “element path” mean** An *element path* specifies **where a specific value is located in the feed's data structure**. Using the path, you tell Mergado which element the rule or query should target. Example: `NAME` * This notation says that we want to work with the value of the element `NAME`. Note: Technically, it is the “path to the element's value” because the target is always a specific value, not the element tag itself. ### **How is nesting written in Element-Path** Nesting expresses the **parent-child** relationship and is written using the pipe character `|`. Syntax: `PARENT | CHILD` * Reading: “Find the element `PARENT` and nested under it the element `CHILD`.” * Important: **The space before and after the pipe is mandatory.** * Correct: `PARAM | VAL` * Incorrect: `PARAM|VAL` Example: `` `Barva` `Černá` `` The path to the value `VAL` is `PARAM | VAL`. ### **What is the vocabulary and syntax of Element-Path** Element-Path has its own “grammar”. It includes these basic components: | Component | Description | Example | | ----- | ----- | ----- | | **Element name** | Refers to a specific element in the feed. | `ITEM_ID` | | **Pipe ( | )** | Expresses nesting (parent → child). | `PARAM | VAL` | | **Conditions ( { } )** | Serve as a filter for precise targeting. | `PARAM { PARAM_NAME = “Barva” } | VAL` | | **Special attributes ( @@ )** | Target by position (`@@POSITION`) or value (`@@VALUE`). | `IMGURL_ALTERNATIVE { @@POSITION = 2 }` | | **MQL syntax** | Enables logical operations (AND, OR, NOT…) within conditions. | `PARAM { PARAM_NAME = “Barva” AND VAL = “Černá” }` | ### **What tools help when writing paths in Mergado** Mergado Editor offers advanced features for working with Element-Path: * **Autocompletion:** The Editor offers available elements, attributes, and operators. * **Validation:** If an element does not exist, it is highlighted in red; valid paths are highlighted in green. * **Autocompletion of parameters and shipping providers:** The Editor automatically completes specific names and creates complete paths. ### **Where is Element-Path used** Element paths are used **throughout the entire Mergado Editor** – wherever it is necessary to precisely specify which data you are working with. * **In rules:** e.g., *Rewrite*, *Find and replace*, *Calculation*, *Bulk copy values*. * **In queries:** in the Oneliner and in MQL queries. * **In variables:** when reading or writing values. * **In imports:** in the headers of import files. * **On the Products page:** for displaying, sorting, and filtering values. * **In automation:** when setting up rules and conditions for automatic actions. ### **What are conditions and how do they work** Conditions serve as a **filter** that restricts which values the path should target. They are written in curly braces `{ }` and always bind to the element to the left of them. Example: `PARAM { PARAM_NAME = “Barva” } | VAL` This notation selects only the `VAL` values for parameters where `PARAM_NAME` equals “Barva”. Conditions are essential for multiple elements where the same names can repeat (e.g., different parameters for a single product). ### **How can MQL logical operators be used in conditions** Element-Path supports the full vocabulary of the **MQL (Mergado Query Language)** language. Logical operators such as `AND`, `OR`, `NOT`, `IN`, `CONTAINS`, etc., can be used in conditions. Example of a complex condition: `VARIANTS | VARIANT { PARAMETERS | PARAMETER { NAME = “Velikost” } | VALUE = “M” AND PARAMETERS | PARAMETER { NAME = “Materiál” } | VALUE = “Bavlna” } | STOCK | WAREHOUSES | WAREHOUSE | NAME` This notation selects the warehouse name (`NAME`) for variants that have **size “M”** and **material “Bavlna”**. ### **What special attributes does Element-Path use** Special attributes always begin with two at signs `@@` and are used **in conditions**. They make targeting multiple elements easier. | Attribute | Description | Usage example | | ----- | ----- | ----- | | **`@@POSITION`** | Targets by value order (1, 2, 3…). | `VARIANTS | VARIANT { @@POSITION = 2 }` | | **`@@VALUE`** | Targets by value content. | `CATEGORY { @@VALUE != “Hračky” }` | `@@POSITION` is used where the order of values corresponds to their meaning (e.g., images). `@@VALUE` is more reliable where the order may change. ### **How are conditions used with multiple nesting levels** Conditions can also be combined across different element levels. Example of multi-level nesting: `VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = “Velikost” } | VALUE` This notation targets the value of the parameter “Velikost” for the **second product variant**. ### **What are the most common mistakes when writing paths** * Missing spaces around the pipe (`|`). * Incorrect placement of curly braces `{ }`. * Incorrect element names (non-existent in the project). * Using `@@POSITION` for elements where the order differs between products. * Path ending with a parent instead of a child (e.g., `PARAM` instead of `PARAM | VAL`). Mergado Editor automatically detects errors in the path input field – an invalid path is displayed in red. ### **How does Element-Path help with rule precision and safety** Correct use of Element-Path ensures that rules, queries, and automation work **only with relevant data**. Thanks to a precisely defined path, you can: * safely read and modify values, * target only selected conditions, * prevent errors caused by changes in the feed structure. ## **8\. Conditions in element paths** ### **What are conditions** Conditions in element paths function as a **filter** that allows you to **target only selected values** and thereby refine your work with data. They are an integral part of the **Element-Path** language and are used especially when working with multiple and nested elements. Conditions **always bind to the element to the left of them** and can only filter values of its **nested children**. ### **How conditions are written** Conditions are written in **curly braces `{ }`**, which bind to the corresponding element. **Basic notation template:** Element { Child Operator Value } | Next\_child **Example:** * PARAM { PARAM\_NAME \= “Barva” } | VAL This path says: “Find the element `PARAM` that has a child `PARAM_NAME` with the value *Barva*, and within it target the nested element `VAL`.” #### **Notation rules** * **Spaces are important** – they cannot be omitted. This applies both inside the condition and before and after it (e.g., `PARAM { PARAM_NAME = “Barva” } | VAL` is correct, `PARAM{PARAM_NAME=”Barva”}|VAL` is incorrect). * **Braces `{ }`** on a Czech keyboard are typed using the shortcut `Alt + B (option + 9)` (left) and `Alt + N (option + 0)` (right). * Conditions can contain **arbitrarily complex expressions**, including the operators `AND`, `OR`, `NOT`, or even multiple levels of nesting. ### **Using MQL in conditions** Conditions in Element-Path support the **full syntax of Mergado Query Language (MQL)**. This means you can write the same expressions as in the custom query form. For example: * PARAM { PARAM\_NAME \= “Velikost” AND VAL \= “M” } or a more complex variant with multiple levels: * VARIANT { PARAMETERS | PARAM { PARAM\_NAME \= “Materiál” AND VAL \= “Bavlna” } } This approach allows you to combine conditions and target very precisely defined groups of values. ### **What conditions are used for** Conditions refine the element path and allow you to target **specific subsets of values**. They are primarily used for: 1. **Targeting specific values of multiple elements.** 1. For example, when working with parameters, shipping providers, or images, where a path without a condition would lead to multiple values. The condition ensures that the rule is applied only to the correct one. 2. **Structural addition of values** 1. When writing to the feed, everything specified in a condition with the `=` operator or `AND` is **created by Mergado if it does not yet exist**. 2. This allows conditions to also create new nested structures (e.g., a new parameter or flag). 3. **Using special attributes** 1. Conditions also serve for working with **special attributes** such as `@@POSITION` (value order) and `@@VALUE` (element value). ### **When they do and do not make sense** #### **When they make sense** Conditions make sense for **multiple elements**, where one type of information can repeat multiple times. They are most commonly used when working with: * parameters (`PARAM`), * shipping (`DELIVERY`), * variants (`VARIANT`), * images (`IMAGE`), * categories (`CATEGORY`). Example: * PARAM { PARAM\_NAME \= “Barva” } | VAL This notation ensures that the change is made only to the “Barva” parameter, regardless of its position in the feed. In this case, it is safer than using the `@@POSITION` attribute, which can differ across products. #### **When they do not make sense** 1. **Simple elements** 1. For simple elements (e.g., `ITEM_ID`, `PRICE_VAT`), the element always has a single value, so a condition is unnecessary. 2. **Targeting all values** 1. If you want to work with all values of an element, do not use a condition. For example: IMAGES | IMAGE 2. This path targets all images of the given product. ### **In practice: filtering values using a condition** #### **Example path** * PARAM { PARAM\_NAME \= “Barva” } | VAL #### **How Mergado evaluates this path** 1. **`PARAM`** – refers to the parent, multiple element. 2. **`{ PARAM_NAME = “Barva” }`** – is the condition that says: “We are only interested in those `PARAM` elements whose child `PARAM_NAME` has the value *Barva*.” 3. **`| VAL`** – specifies that we are working with the child `VAL`, i.e., the specific parameter value. The result is that Mergado selects only those `VAL` values that belong to the parameter named “Barva”. #### **Comparison with targeting by position** The condition * PARAM { PARAM\_NAME \= “Barva” } | VAL is more reliable than the notation * PARAM { @@POSITION \= 2 } | VAL Because targeting by parameter name works regardless of its order within the product. For parameters with different orders, this prevents incorrect value assignment. ### **Summary** Conditions in the Element-Path language are a key tool for precise and safe targeting of specific values. They allow you to filter data, create new structures, and work with both multiple and nested elements without the risk of incorrect overwrites. Correct use of conditions helps you prevent errors, maintain order in your rules, and ensure that Mergado always modifies only the data you actually want to change. ## **FAQ** ### **What are conditions in the Element-Path language and why are they used** Conditions are a **filter** that refines the element path. Using them, you specify **which specific values Mergado should target** – that is, which to read, modify, or create. They are mainly used with **multiple and nested elements**, where values repeat or share the same name. Conditions help: * precisely target a selected value (e.g., a specific parameter), * prevent errors when overwriting unrelated data, * create new structures directly in rules. ### **How are conditions written (syntax)** Conditions are written in **curly braces `{ }`**, which bind to the element standing **to the left** of them. Basic notation format: * `ELEMENT { CHILD = “Value” } | NEXT_CHILD` Example: * `PARAM { PARAM_NAME = “Barva” } | VAL` This notation says: “Find the element `PARAM` whose nested element `PARAM_NAME` has the value `Barva`, and within it target `VAL`.” **Important writing principles:** * Spaces are mandatory – they cannot be omitted either inside the condition or before and after it. * Braces `{ }` on a Czech keyboard are typed using the combination **Alt \+ B** (left) and **Alt \+ N** (right). * Conditions can contain multiple criteria linked by the logical operators `AND`, `OR`, `NOT`. ### **How does condition binding work in paths** A condition **always relates to the element to the left of it**. Filtering is only possible through the **children (nested elements)** of that element. Example: `VARIANT { PARAMETERS | PARAMETER { NAME = “Velikost” } | VALUE = “M” } | STOCK` This notation means: “Find the variant that has a parameter named *Velikost* with the value *M*, and within it work with the element `STOCK`.” ### **How are conditions used when working with multiple elements** Conditions are essential when working with elements that repeat within a single product (e.g., `PARAM`, `DELIVERY`, `CATEGORY`, `IMAGE`, `VARIANT`). **Without a condition:** * `PARAM | VAL` \- targets all `VAL` values across all parameters. When reading, Mergado uses the first value; when writing, it changes all of them. **With a condition:** * `PARAM { PARAM_NAME = “Barva” } | VAL` \- targets only the `VAL` value belonging to the “Barva” parameter. This notation is **safe and unambiguous** – element order does not matter. ### **What operators can be used in conditions** Conditions support all common operators from the **MQL (Mergado Query Language)** language. This makes it possible to create even very precise and complex filters. | Operator type | Example | Meaning | | ----- | ----- | ----- | | **\=** | `PARAM_NAME = “Barva”` | Value equality | | **\!=** | `@@VALUE != “Hračky”` | Inequality | | **\> / \<** | `@@POSITION > 1` | Numeric comparison | | **\~** | `@id ~ “variant”` | Contains | | **AND** | `PARAM_NAME = “Barva” AND VAL = “Černá”` | And also | | **OR** | `@@VALUE = “XL” OR @@VALUE = “L”` | Or | | **NOT** | `NOT (VAL = “M”)` | Negation | ### **How is MQL syntax used in conditions** **Complete MQL queries** can be written in conditions – the Mergado Query Language is fully integrated into Element-Path. This makes it possible to combine multiple filters, various nesting levels, and complex logic. Example of a complex condition: `VARIANTS | VARIANT { PARAMETERS | PARAMETER { NAME = “Materiál” AND VAL = “Bavlna” } AND PARAMETERS | PARAMETER { NAME = “Velikost” AND VAL = “M” } } | PRICE` This notation selects the price (`PRICE`) for a variant that has the parameters *Materiál \= Bavlna* and *Velikost \= M*. ### **What if the element has no nested children** For elements that **have no nested elements**, **special attributes** are used in conditions: * `@@POSITION` – targets by value order, * `@@VALUE` – targets by value content. Examples: * `IMAGES | IMAGE { @@POSITION = 3 }` – the third image, * `CATEGORY { @@VALUE != “Hračky” }` – all categories except “Hračky”. ### **What is the difference between a condition and targeting by position** Targeting by **position** (`@@POSITION`) only refers to the value's order. Targeting using a **condition** takes content into account. Comparison: * `PARAM { @@POSITION = 2 } | VAL` – targets the second parameter in order. * `PARAM { PARAM_NAME = “Barva” } | VAL` – targets the parameter named “Barva”, regardless of its position. Targeting by content is more reliable because it works even when the order of values differs between products. ### **How do conditions help when writing new data** When **writing** data to the feed, the following rule applies: **If a condition on an element contains only the operators** `=` **and** `AND` **with sub-elements whose values do not exist, Mergado will automatically create these values.** This principle enables so-called **structural addition of values** – for example, adding a new parameter, variant, or flag. Example: `FLAGS | FLAG { CODE = “action” } | ACTIVE` If a flag with the code `action` does not exist, Mergado automatically creates it and sets `ACTIVE` to 0\. ### **When does it make sense to use conditions** Conditions make sense especially with multiple or nested elements, such as: * `PARAM` or `g:attribute_detail` (product parameters), * `DELIVERY` (shipping), * `VARIANT` (variants), * `IMAGE` (images), * `CATEGORY` (categories). For example, the path: `PARAM { PARAM_NAME = “Barva” } | VAL` Ensures that the edit applies only to the “Barva” parameter value, not other parameters. ### **When do conditions not make sense** Conditions do not make sense in these cases: * **Simple elements** – have only one value (`ITEM_ID`, `PRICE_VAT`). * **Targeting all values** – if you want to work with all occurrences of an element (e.g., `IMAGES | IMAGE`), there is no need to add a condition. ### **How to verify the correctness of a path with a condition** In Mergado Editor, the **Element Path** tool is available, which allows you to: * test the path notation (including conditions), * see where the path actually leads, * validate whether the elements in the path exist. In addition, the path input field offers: * autocompletion (elements, attributes, operators, values), * color-coded syntax highlighting, * warnings for invalid or incomplete paths. ### **What are the most common mistakes when writing conditions** * Missing spaces around curly braces `{ }`. * Using a condition on an element that has no children. * Confusing element names (e.g., `PARAM_NAME` vs. `NAME`). * Missing curly braces or incorrect placement of the condition in the path. * Using `@@POSITION` instead of an element name where the order differs. Mergado automatically alerts you to these errors by highlighting the incorrect notation. ## **9\. Special attributes in Element-Path** ### **What are special attributes** Special attributes represent an **advanced tool** in Mergado Editor and the Element-Path language. They are used for **precise targeting** with multiple elements and allow distinguishing between individual values of a given element. Each special attribute: * **begins with two at signs (`@@`)**, * **binds to a specific element**, * is used **inside conditions in element paths** (in curly braces `{ }`), * extends the targeting and filtering capabilities of Element-Path. The following special attributes are currently available in Mergado: 1. `@@POSITION` – value position, 2. `@@VALUE` – value content. 3. `@@MAX_POSITION` – the number indicating the highest position of values for a given element in a specific product. ### **@@POSITION – targeting by position** The `@@POSITION` attribute corresponds to the **order of the element's value** it is bound to. It allows targeting a specific position or range of positions within a multiple element. * Each value has its **position**, expressed as a natural number (1, 2, 3 …). * For simple elements, the value always has position 1\. * Only for multiple elements (`IMAGE`, `PARAM`, `DELIVERY`, etc.) can the position be higher than 1\. **Example:** * IMAGES | IMAGE { @@POSITION \= 3 } Read as: “Find the element `IMAGES` and target its child `IMAGE` with the value at the third position.” **Weakness:** `@@POSITION` only works with order and does not consider the value content. If the order of values differs across products, the targeting may land on a different value than expected. ### **@@VALUE – targeting by value content** The `@@VALUE` attribute represents the **value of the element** it is bound to and allows targeting based on its content. It is used in conditions for elements that have no children (or where you do not need to target a nested structure). **When to use `@@VALUE`** 1. **For elements without children** – e.g., `IMGURL_ALTERNATIVE`, `CATEGORY`. 2. **For multiple elements** – allows targeting a value regardless of its position. 3. **When the order of values changes** – replaces the less reliable targeting via `@@POSITION`. **Example:** * CATEGORIES | CATEGORY { @@VALUE \!= “Hračky” } This notation selects all categories except “Hračky”. Targeting via `@@VALUE` is suitable where the order of values may differ between products. ### **@@MAX\_POSITION – helper special attribute** The helper special attribute `@@MAX_POSITION` represents the **position of the value with the highest order** for a given element in a specific product. In other words – it designates the **last position** at which the given element exists within the product. Example: \www.image1.jpg\ …@@POSITION \= 1 \www.image2.jpg\ …@@POSITION \= 2 \www.image3.jpg\ …@@POSITION \= 3 In this case, `@@MAX_POSITION = 3` because the highest existing position of the `IMAGE` element is 3\. For different products, the same element may have a different `@@MAX_POSITION` value because the number of values can vary. **When to use `@@MAX_POSITION`** **1. Adding new multiple values** If you want to **add a new value** at the end of existing values without overwriting any, use the construction: `ELEMENT {@@POSITION = @@MAX_POSITION + 1}` Example: You want to write a new image URL `www.image4.jpg` to the `IMAGE` element at the next available position. * Use the **Rewrite** rule * In the **Element** field, enter: `IMAGE {@@POSITION = @@MAX_POSITION + 1}` * In the New value field, write the new URL: www.image4.jpg Result: \www.image1.jpg\ \www.image2.jpg\ \www.image3.jpg\ \www.image4.jpg\ **2. Copying values to the end of an existing list** When **copying values between multiple elements**, you can use `@@MAX_POSITION` to copy “to the end” without overwriting original values. Example: In the feed, we have these two multiple elements: \www.image1.jpg\ …@@POSITION \= 1 \www.image2.jpg\ …@@POSITION \= 2 \www.image3.jpg\ …@@POSITION \= 3 \www.context\_image1.jpg\ …@@POSITION \= 1 \www.context\_image2.jpg\ …@@POSITION \= 2 You want to copy all `CONTEXT_IMAGE` values into `IMAGE` without overwriting the original images. * Use the **Bulk copy values** rule * In the **Source element** field, enter: `CONTEXT_IMAGE` * In the **Target element** field, enter: `IMAGE {@@POSITION = @@MAX_POSITION + 1}` Result: \www.image1.jpg\ \www.image2.jpg\ \www.image3.jpg\ \www.context\_image1.jpg\ \www.context\_image2.jpg\ ### **When to use which attribute** | Targeting goal | @@POSITION (by position) | @@VALUE (by value) | Recommended approach | | ----- | ----- | ----- | ----- | | Images or categories (without children) | Suitable if the order is fixed (e.g., 2nd image). | Suitable if the order changes. | Either, depending on the situation | | Parameters (with nesting) | Less safe – targets by order. | Not suitable because the parent `PARAM` has no value. | Safest is to target through a child (`PARAM_NAME = “Barva”`) | **Rules for choosing:** 1. For simple elements, you do not need to specify position – it is always 1\. 2. For multiple elements without children, you can use `@@POSITION` or `@@VALUE`. 3. For nested structures (e.g., parameters), it is safest to use a condition with the nested element name, e.g., `PARAM_NAME = “Barva”`. ### **Indexing (`#`)** In addition to special attributes, Element-Path also supports **indexing**, which is written using the `#` character. Indexing = element occurrence. While @@POSITION works with the order of values inside a multiple element (e.g., the 3rd image in IMAGE), indexing with `#` allows you to select a *specific repeated occurrence of the same element* (e.g., the second “Barva” parameter), even if its order differs across products. Indexing extends targeting capabilities where `@@POSITION` is not sufficient. Indexing should only be used in cases where the element path returns more than one value and the special attribute `@@POSITION` cannot be used because the values are at different positions for individual products. Using indexing as a substitute for `@@POSITION` in situations where it is not necessary is inappropriate and can lead to performance degradation. #### **How to use indexing step by step** 1. **Determine which occurrence you want to target** (1st, 2nd, 3rd, …) and how to identify it (e.g., a parameter named “Barva”). 2. **Open the place where you work with data** – indexing can be used in *queries and rules*, in *Element-Path* fields, and also in *MQL (Mergado Query Language)*. 3. **Add indexing to the path** using `#` in the format: ` #{ order }` 4. **Save and apply** the rule or query. Mergado will then work only with the specified occurrence. * **Syntax:** `PARAM { NAME = “Barva” } #{ 2 } | VALUE` * **Meaning:** Targets the second occurrence of the element `PARAM | VALUE` with the parameter name “Barva”. * **Usage:** Indexing is especially suitable for conditional elements where `@@POSITION` cannot be used. * **Recommendation:** If regular targeting by position works, `@@POSITION` is faster and clearer. Example: In the feed, we have 2 products with the parameter Barva. Both products have the parameter Barva twice with different values, at different positions. Product A Barva Bílá Barva Černá Materiál Keramika Product B Barva Zelená Materiál Keramika Barva Červená If we want to target exactly the second value of the parameter Barva for each product, we cannot use the special attribute @@POSITION because the values are at different positions. This is where Indexing helps. The correct path notation using indexing: * `g:product_detail { g:attribute_name = “Barva” } #{ 2 } | g:attribute_value` #### **Tips for indexing** * **Where to use it:** in queries and rules (Element-Path, and also MQL). * **When to use it:** when you need to target a specific occurrence of the same element (e.g., “second color”) and @@POSITION is not sufficient. * **When merging:** indexing gives you control over which occurrence you are composing the resulting value from. * **When it is not necessary:** if a fixed order of values is sufficient, it is simpler and faster to use @@POSITION. ### **Practical examples of using special attributes** #### **1\. Targeting a range of positions using `@@POSITION`** Path for alternative images from position 3 to 8: * IMGURL\_ALTERNATIVE { @@POSITION \>= 3 AND @@POSITION \<= 8 } #### **2\. Combining position and value for targeting variants** Path for the parameter “Velikost” in the **second variant**: * VARIANTS | VARIANT { @@POSITION \= 2 } | PARAMETERS | PARAMETER { NAME \= “Velikost” } | VALUE #### **3\. Targeting an attribute using the element value `@@VALUE`** Path for the attribute `@value` for parameters with the value “Barva”: * PARAM { @@VALUE \= “Barva” } | @value In this case, `@@VALUE` replaces the element `PARAM_NAME` for targeting the value “Barva”. #### **4\. Targeting all values except one** Path for categories except “Dětská hřiště”: * CATEGORIES | CATEGORY { @@VALUE NOT CONTAINS “Dětská hřiště” } #### **5\. Indexing in queries – condition on a specific occurrence** You want to select products where the parameter “Velikost” has a **second occurrence** and its value is “XL”. Example condition (Element-Path): * PARAM { NAME = “Velikost” } #{ 2 } | VAL = “XL” This notation ensures that you are evaluating exactly the second occurrence of the parameter “Velikost”, not just any “XL” value in the parameters. ### **Summary** Special attributes extend the targeting capabilities of Element-Path and allow working with multiple elements at the level of individual values. `@@POSITION` and `@@MAX_POSITION` target by order, `@@VALUE` by content, and indexing `#` allows addressing specific occurrences. Their correct use ensures that you target precise data in Mergado and perform edits safely and in a controlled manner even in complex feeds. ## **FAQ** ### **What are special attributes and why do they exist** Special attributes are an **extension tool of the Element-Path language** that enables **precise targeting for multiple elements**. They help distinguish individual values by their order or content and are used **inside conditions** (in curly braces `{ }`). Each special attribute: * begins with **two at signs `@@`**, * binds to a specific element, * extends targeting and filtering capabilities, * is **never exported to the feed** (unlike regular XML attributes). Currently, Mergado supports these main special attributes: * `@@POSITION` – targeting by order, * `@@MAX_POSITION` – targeting by the highest existing position, * `@@VALUE` – targeting by value content. ### **What is the difference between special and regular XML attributes** | Attribute type | Notation | Description | | ----- | ----- | ----- | | **Standard attribute (XML)** | `@id`, `@description` | Is part of the XML structure and supplements the meaning of the element. | | **Special attribute (Element-Path)** | `@@POSITION`, `@@VALUE` | Belongs to the Element-Path language and is used for filtering and precise targeting in conditions. | Regular XML attributes are exported to the output feed, while special attributes exist only for Mergado's internal logic when working with rules, queries, or variables. ### **What does the `@@POSITION` attribute do and when to use it** `@@POSITION` targets the **order of the element's value** it relates to. Each value in the feed has its position (1, 2, 3 …), which determines its order within a multiple element. **Usage:** * Suitable for multiple elements with a fixed order (e.g., images, variants). * Not needed for simple elements (with a single value) – their position is always 1\. **Example:** * `IMGURL_ALTERNATIVE { @@POSITION = 3 }` This notation says: “I am working with the third value of the element `IMGURL_ALTERNATIVE`.” ### **What is the weakness of `@@POSITION`** `@@POSITION` **does not work with the value content, only with its order.** If the order of values differs across products, incorrect targeting may occur. Example of the problem: * For one product, position 2 \= “Objem”, * for another product, position 2 \= “Dekor”. The path `PARAM { @@POSITION = 2 } | VAL` would then select the wrong value for the second product. **Solution:** Use targeting by child name instead, e.g., * `PARAM { PARAM_NAME = “Objem” } | VAL` ### **What does the `@@VALUE` attribute do and when to use it** `@@VALUE` represents the **content of the element's value**. It is used for filtering by value instead of order. **Suitable usage:** * for elements that **have no children** (e.g., `CATEGORY`, `IMGURL_ALTERNATIVE`), * for multiple elements with changing value order, * where you want to target by content, not by position. **Example:** * `CATEGORY { @@VALUE != “Hračky” }` This notation selects all values of the element `CATEGORY` except “Hračky”. Compared to `@@POSITION`, this method is more reliable because it works regardless of order changes. 6\. How to choose between `@@POSITION`, `@@VALUE`, and a condition with a child | Targeting goal | `@@POSITION` | `@@VALUE` | Condition with child | | ----- | ----- | ----- | ----- | | Images, categories (without children) | ✅ If the order is fixed | ✅ If the order changes | – | | Parameters (with nesting) | ⚠️ Less reliable | 🚫 Not suitable – PARAM has no value | ✅ Safest (`PARAM_NAME = “Barva”`) | **Recommendations:** * For simple elements, do not specify position. * For multiple elements without children, you can use both approaches (`@@POSITION` and `@@VALUE`). * For nested structures, always prefer targeting through the child name (e.g., `PARAM_NAME`). ### **What is indexing `#` and how does it differ from `@@POSITION`** Indexing is a supplementary tool of the Element-Path language that allows you to precisely identify a specific occurrence of an element **regardless of its order**. It is written using the `#` character. You can use indexing not only in **Element-Path** paths but also in filters and conditions in **queries using MQL (Mergado Query Language)**. The principle remains the same – you select a specific occurrence of a repeating element. **Syntax:** `PARAM { NAME = “Barva” } #{ 2 }` This notation targets the **second occurrence** of the element `PARAM` named “Barva”. **Options:** * a range of positions can be specified: `{ 1 – 4 }`, * suitable for conditional elements where `@@POSITION` cannot be used. **Note:** If regular targeting by position is sufficient, `@@POSITION` is faster and clearer. ### **How to combine `@@POSITION` and `@@VALUE` in a single path** Special attributes can be combined within a single condition or with other filters using logical operators. **Example 1 – targeting a range of positions:** `IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }` * Targets alternative images from 3rd to 8th position. **Example 2 – combination with other elements:** `VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = “Velikost” } | VALUE` * Selects the parameter “Velikost” for the second variant. **Example 3 – targeting by value:** `CATEGORIES | CATEGORY { @@VALUE NOT CONTAINS “Dětská hřiště” }` * Selects all categories except those containing “Dětská hřiště”. ### **Can I use special attributes to target element attributes as well?** Yes. Special attributes can also be used in combination with regular XML attributes. For example: `PARAM { @@VALUE = “Barva” } | @value` This notation targets the `@value` attribute for parameters whose value is “Barva”. Here, `@@VALUE` replaces the need to use the `PARAM_NAME` element. ### **What are the most common mistakes when working with special attributes** * Using `@@POSITION` for elements where the order differs across products. * Trying to use `@@VALUE` for elements that do not carry a value themselves (e.g., `PARAM`). * Confusing a single at sign `@` (regular XML attribute) with two `@@` (special attribute). * Incorrect placement of a special attribute outside a condition. Mergado automatically alerts you to all errors in the editor with color highlighting or error messages during validation. ### **What is the difference between `@@POSITION` and `@@MAX_POSITION`** | Attribute | Description | Usage | | ----- | ----- | ----- | | **`@@POSITION`** | Refers to a specific value position within an element. | Targeting an existing value. | | **`@@MAX_POSITION`** | Indicates the highest position (last value) for a given element. | Suitable for adding new values “to the end”. | ### **When does it make sense to use `@@MAX_POSITION`** * **When adding a new value** to a multiple element so that no existing value is overwritten. * **When copying values** from one multiple element to another (e.g., images, alternative images, context images). [image1]: [image2]: [image3]: [image4]: [image5]: [image6]: [image7]: [image8]: [image9]: [image10]: [image11]: [image12]: [image13]: [image14]: [image15]: [image16]: [image17]: [image18]: [image19]: [image20]: --- ## [Products and Product Queries](https://help.mergado.com/en/mergado-editor/working-with-data/basic-components/products-and-product-selections/) # **Products and Product Queries** ## **1\. Products in Mergado** ### **What Is a Product in Mergado** A product in Mergado is the **basic data unit** representing an item from your online store. Each product contains various **elements** that describe its properties – such as the name, price, or EAN. Mergado works with these products, modifies them, and optimizes them before exporting to advertising channels. * Products are made up of **elements** that define their properties (e.g., `PRODUCTNAME`, `PRICE`, `EAN`). * A **feed** is a file that contains all products and their elements. ### **Input and Output Data** The entire process of working with products in Mergado is based on the transformation between two basic data sets – the **input** and **output feed**. * **Input feed (input data)** – contains the original data that Mergado downloads from your online store and processes further. When searching for products, it is recommended to search in the input, because input feed values are not changed by rules (unless the feed provider modifies them). * **Output feed (modified data)** – contains data after modifications made in Mergado Editor. This data is exported to target marketing channels (e.g., Heureka, Google Ads). Mergado lets you display values from the **input feed** only, the **output feed** only, or from **both input and output simultaneously** when reviewing data. ### **Loading and Processing Product Data** Mergado operates on a principle of **cyclical data processing** that takes place in four steps: 1. **Data import** – data is downloaded from the input feed into Mergado. 2. **Applying rules** – most changes and modifications are made in bulk through rules. 3. **Export** – after processing, the current output feed is generated. 4. **Access to the output feed** – Mergado records when the advertising channel (e.g., Heureka) downloaded the modified feed. If a specific product has an error (e.g., an element contains a different value than expected), you can use the **"Track product through rules"** function. This function shows which rule affected the product and what changes were made. ### **Difference Between a Product in the Online store and in Mergado** The online store manages the **primary product data**, while Mergado is a tool for **modifying and optimizing** that data for marketing channels. The original data from the online store remains unchanged – Mergado creates a **modified version** that meets the requirements of each platform. * **Online store** – manages the source data used within its own system. * **Mergado** – modifies and optimizes data for advertising on comparison engines and marketplaces. ### **Practical Functions for Working with Products** On the *Products* page, Mergado offers several ways to work with data – from **manual edits** to **bulk processing** through rules. ### **One-time Edits** **Manual edits** * Let you modify the values of individual elements directly in the Mergado interface. They are especially suitable for **minor or one-time changes**. **WYSIWYG editor** * For text elements (e.g., `DESCRIPTION`), you can use a **"What You See Is What You Get"** editor that lets you format descriptions using **HTML elements**. This way, you can edit product descriptions clearly without writing HTML manually. **Manual product hiding** * Useful when working with a smaller number of items that are **not suitable for advertising** (e.g., products without an EAN or with long delivery times). ### **Bulk Edits** * For larger-scale changes (modifying values, rewriting data, or hiding a larger number of products), use **rules** that are applied to selected groups of products. * Using bulk edits through rules is much more efficient than manual editing of individual products, and in most cases **this approach is recommended**. ## **FAQ** ### **What is a product in Mergado?** A product in Mergado is the basic data unit representing an item from your online store. Each product is made up of elements (e.g., `PRODUCTNAME`, `PRICE`, `EAN`) that describe its properties. Mergado works with these products, modifies them, and prepares them for export to advertising channels. ### **What is a feed?** A feed is a file that contains all products and their elements. In Mergado, we distinguish between the input feed (data from the online store) and the output feed (modified data ready for export). ### **What is the difference between the input and output feed?** The input feed contains the original data downloaded from the online store. The output feed contains data after modifications in Mergado. The output feed is exported to marketing channels such as Heureka or Google Ads. ### **Can I display input and output feed values simultaneously?** Yes. Mergado lets you display only input values, only output values, or both simultaneously. This option helps you easily compare what data changed during processing. ### **How does Mergado process product data?** Mergado works cyclically in three steps: 1. It imports data from the input feed. 2. It applies rules and modifications. 3. It generates the output feed. It also records when the advertising channel (e.g., Heureka) downloaded the modified feed. ### **What should I do when a product behaves differently than expected?** If a product has an unexpected element value or, for example, appears in the output even though it should have been hidden, use the **"Track product through rules"** function. It shows which rules affected the product and what changes they made. ### **What is the difference between a product in the online store and in Mergado?** The online store manages the original product data, while Mergado modifies and optimizes that data for marketing channels. The original data remains unchanged – Mergado only creates a modified version. ### **What options are there for editing product data?** Mergado offers two basic approaches: * **Manual edits** – direct editing of values for individual products (suitable for minor changes). * **Bulk edits** – using rules applied to entire product queries (recommended approach). ### **When should I use manual editing and when should I use rules?** Manual edits are suited for a smaller number of products or one-time changes. Rules are more efficient when working with larger volumes of data or repeated modifications, as they enable automation. ### **What is the WYSIWYG editor for?** The WYSIWYG editor (What You See Is What You Get) is used for editing text elements such as product descriptions. It lets you format text (e.g., bold, italic) using HTML tags without writing code manually. ### **How can I hide a product from the output feed?** For a smaller number of products, you can use **manual hiding** directly on the *Products* page. For a larger quantity of products, use the **"Hide product"** rule, which is applied to a saved query (e.g., products without an EAN, with low margin, etc.). ### **Is it possible to see when a channel (e.g., Heureka) downloaded the output feed?** Yes. Mergado records when the output feed was downloaded, helping you track data updates for individual advertising channels. Information about the **last download** can be found on the **Overview** page. More detailed download history is available on the **History** page after selecting the event type **Downloads**. --- ## **2\. The Products Page** The **Products** page is the central place where you can **review, display, and edit product data**. Here you find all items from your feed. You can work with them individually or in groups and verify how rules work. In short, this is where you have full control over what happens with products in Mergado. ### **Purpose and Functions of the Page** The main purpose of the *Products* page is to **review data and changes** made in the project. Here you find the most important information about feed items, can directly edit their values, or create queries for further work. **Main functions of the page:** * **Data display** – visual review of products and their values. * **Editing** – ability to manually edit a specific element. * **Creating queries** – building product groups that rules subsequently work with. * **Debugging** – verifying why a product behaves differently than expected (e.g., it appears in the output even though it should be hidden). ### **Interface Overview and Available Views** The *Products* page offers several different views that help you navigate the data and enable quick review of specific information. **View Types** | View | Description | | ----- | ----- | | **Previews** | Displays products similarly to advertising channels (e.g., Heureka, Zbozi.cz). Shows only key data – suitable for a quick catalog overview. | | **Elements** | Shows the product broken down by individual elements and their values. Lets you easily compare original and modified values. The most detailed view – ideal for working with data. | | **Images** | Displays the main and supplementary product images. Lets you compare images from the input and output feeds. | | **Table** | A powerful tool for working with data in a clear table, similar to Excel or Google Sheets. Lets you configure displayed columns, their order, and filter products as needed. | **Table View Functions** * The **toolbar** contains icons for special columns (e.g., image, ID, product name, pinning). * **Preset tabs** are available (e.g., pairing, bidding), along with a tab for a custom list of displayed elements. * In each column header, you can use the **X icon for temporary hiding** or **value sorting** (does not apply to special columns). * Column order can be **changed via drag & drop**. * The table can be **expanded to full screen**, making it easier to work with larger amounts of data. * Displayed data **respects the currently set product filter** – allowing you to compare specific elements and products. * The created table can be **exported to CSV** exactly as you see it. This file can then be analyzed in a spreadsheet editor or used for import back into another project using the *Data file import* rule. > **Tip!** You can change the view mode both for all products and for a specific product. ### **Data Review and Input vs. Output Comparison** On the *Products* page, you see not only the current data but also the differences between what Mergado loaded (**input feed**) and what it sends on (**output feed**). This makes it easy to verify whether rule modifications were applied correctly. ### **Value Display Settings** Using icons, you can toggle which values are displayed: * only **input values** (`->]`), * only **output values** (`[->`), * or **input and output simultaneously** (`->][->`). If you choose to display both values at the same time, Mergado highlights the differences: * **red** – removed values, * **green** – newly added values. ### **Hidden Elements** The page also shows **hidden elements** that are not part of the output feed but exist in the input data. In the interface, they appear in **gray**. If you do not want to see them, you can turn off the *"Show hidden"* option. It is recommended to enable this option especially when the **input and output formats differ** and you need to review the original input data. ### **Product Search – Input vs. Output** When filtering products and creating queries, you can choose whether to search by values from the **input** or **output** feed. * Generally, it is recommended to search **in the input**, because these values are not changed by rules. * However, if you work with an element that is created only after modification (e.g., `g:id`), you need to switch the search to the **output**. ### **Manual and Bulk Editing** Most changes in Mergado are made in bulk using rules, but in some cases it makes sense to edit just a few products manually. On the *Products* page, you can make **quick manual changes** for individual products and their elements. #### **Manual Editing** * Element values can be changed directly in the *Products* page interface. * Mergado always displays the **original** and **new value**, making it easy to review changes. * This function is ideal for minor fixes or testing rules. #### **Description Editing (WYSIWYG Editor)** For text elements like `DESCRIPTION` or `SHORT_DESCRIPTION`, a **WYSIWYG editor** (*What You See Is What You Get*) is available. You can write in plain text or in formatting mode (bold, italic, etc.). After saving, the text is converted to HTML supported by advertising systems. ### **Integration with the *Rules* and *Elements* Pages** The *Products* page works closely with other parts of Mergado – primarily the **Rules** and **Elements** pages. #### **Connection to Rules** * From queries created on the *Products* page, you can easily create rules that act on them. * To review how individual rules affect products, you can use the *Elements* view or the **"Track product through rules"** function. This function displays an overview of all changes that individual rules made to the product. * It is ideal for **debugging** when a product does not behave as expected (e.g., the resulting element value is different from what you assumed). #### **Connection to Elements** * On the *Elements* page, you can **add, hide, or edit** (manually created) elements, which then also appear on the *Products* page. * **Hidden elements** appear in gray on the *Products* interface to make it clear they are not exported. * Using the *Elements* page, you can also **search for duplicates** – select an element (e.g., `PRODUCTNAME`), display its values, and navigate to the *Products* page with an automatically created duplicate query. ## **FAQ** 1. **What is the Products page and what is it for?** The Products page is the central place for reviewing, displaying, and editing product data in Mergado. It lets you work with individual products or groups of products, track how rules affect them, and verify data correctness in the feed. At the top, there is also a **search field** used for **creating product queries**. 2. **What are the main functions of the Products page?** The page lets you display data, make manual element edits, create product queries, and review how values change after rules are applied. It also serves for troubleshooting product issues (debugging). 3. **What types of views does the page offer?** Four basic views are available: * Previews – quick product overview similar to advertising channels. * Elements – detailed view of products by individual elements. * Images – display of main and supplementary images. * Table – clear data display with filtering, sorting, and export options. 4. **How can I adjust which columns are visible in the table view?** Columns can be added or hidden using tabs and the toolbar. The order can be changed via drag & drop. Temporary column hiding is done using the X icon in the header. 5. **Can the table be exported outside of Mergado?** Yes. The table can be exported as a CSV file exactly as you see it. This file can be used, for example, in Excel, Google Sheets, or for import into another project using the Data file import rule. 6. **How do I identify differences between the input and output feed?** On the page, you can toggle between displaying input feed values, output feed values, or both simultaneously. Differences are highlighted in color – red for removed values, green for newly added ones. 7. **What are hidden elements and how do I display them?** Hidden elements are data not exported to the output feed but present in the input data. In the interface, they appear in gray. If you want to see them, enable the "Show hidden" option. 8. **When should I search products in the input and when in the output?** Usually, it is best to search products in the input, since this data is not changed by rules. If you are looking for elements that are created only after modification, switch the search to the output feed. 9. **Can I edit data directly on the Products page?** Yes. Element values can be manually changed directly in the interface. Mergado always displays the original and new values so you can easily review changes. 10. **What is the WYSIWYG editor for?** The editor lets you clearly edit text elements such as product descriptions (`DESCRIPTION`, `SHORT_DESCRIPTION`). It supports text formatting (bold, italic, etc.) and saves the resulting text as HTML recognized by advertising systems. 11. **How does the Products page relate to the Rules page?** From queries created on the Products page, you can create rules that act on those products. To review their effect, you can use the "Track product through rules" function, which shows what changes the rules made. 12. **How does the Products page relate to the Elements page?** On the Elements page, you can add, hide, or edit elements that you can then work with in Rules. 13. **What should I do when a product in the output appears differently than expected?** Use the "Track product through rules" function. It displays an overview of all rules that affected the product and helps identify which rule caused the unwanted change. --- ## **3\. Searching and Product Queries** Searching and creating queries are among the most important functions on the Products page. They let you easily filter, group, and manage products by precisely defined conditions. Queries then serve as the basis for applying rules, hiding products, or targeting campaigns in advertising channels. ### **Product Queries** Every filter you create can be saved as a product query. Queries are used for applying rules, analyzing data, and for automations. **Types of queries:** * **Temporary queries** – used only in the current context, e.g., for a quick review. * **Saved queries** – remain available for repeated use and appear in the Saved Queries section. For each, you can see the number of products and the number of rules that work with the query. ### **How Searching Works** On the *Products* page, you can search for products by values in individual elements (e.g., `PRICE, PRODUCTNAME, EAN`). Two methods are available: * **Simple interface** – a click-based method suitable for everyday work. * **Custom MQL query** – text-based search with advanced syntax and the ability to combine multiple conditions. Searching is clear even when working with hundreds or thousands of products. Every filter you create can be saved as a **product query** and further used in rules. ### **Searching in Input and Output Data** When filtering, it is crucial whether you are searching for products in the **input** or **output** feed. The correct data source choice affects search results and further work with queries. * **Searching in input** – the default mode; searches by original data from the online store, which is not changed by rules. * **Searching in output** – used when you need to filter by elements created only during modifications in Mergado. A **crossed-out circle** marks elements that do not exist in the input data. Mergado creates these elements through the converter, so you cannot search them when input data is displayed. **Example:** Your input is a Heureka feed and you are creating a feed for Google. If you search by ITEM\_ID, stay with searching in the input. If you work with g:id, switch to the output. ### **Working with Conditions (Operators)** Every filter or query is a combination of conditions in the format: ` ` #### **Supported Operators** * `CONTAINS` – contains text * `NOT CONTAINS` – does not contain text * `=` – equals * `!=` – does not equal * `~` – contains regular expression * `!~` – does not contain regular expression * `<, >, <=, >=` – number comparison * `IN` – is included in a list * `NOT IN` – is not included in a list * `IS EMPTY` – is empty * `IS NOT EMPTY` – is not empty * `AND, OR` – logical combination of conditions If the element name contains non-alphanumeric characters, enclose it in square brackets: `[Element name] = "blue"` **Operator Descriptions and Examples:** **a. Operator: Contains / Does Not Contain Text** **Description**: * Searches for the specified value within a string. The value is not case-sensitive. **Examples:** * You are looking for refurbished products in the feed. * Condition: `NAME_EXACT CONTAINS "refurbish"` * In words: the product name contains the value "refurbish" * you only need to write part of the word without the ending – this covers the full spectrum: refurbished, refurbishing, etc. * You are looking for categories that do not contain the value "christmas" or "holiday" * Condition: `CATEGORY NOT CONTAINS "christmas" OR CATEGORY NOT CONTAINS "holiday"` * In words: the category element does not contain the value "christmas" or "holiday" **Watch out for:** Searching for the full value instead of a key term; e.g., "Refurbished notebooks" will not capture other refurbished products. **b. Operator: Equals / Does Not Equal** **Description** * Searches for an exact match in the element. The value is not case-sensitive. **Examples**: * You are looking for all products from manufacturer AB Porzellan. * Condition: `PRODUCER = "AB Porzellan"` * In words: the PRODUCER element equals the value "AB Porzellan". * You are looking for products that are not made of porcelain. * Condition: `PARAM { NAME = "Material" } | VALUE != "Porcelain"` * In words: the parameter named "Material" has a value that does not equal "Porcelain". **Watch out for:** * Searched terms like "red" may have multiple forms in the feed (reddish, etc.). * If you only provide part of a string, the result may differ from expectations – be mindful of whether you want an exact match or only partial text. **c. Operators for Comparing Numeric Values (\<, \>, \<=, \>=)** **Description** * Compare numeric element values (greater, less, greater or equal, less or equal). These only work for elements with numeric values. **Examples**: * You are segmenting products into different price tiers. * Condition: `PRICE_VAT > 200 AND PRICE_VAT <= 1000` * In words: the price is greater than 200 and less than or equal to 1000\. * You want to hide cheap products. * Condition: `PRICE_VAT < 200` * In words: the price is less than 200\. **Watch out for:** * If you create multiple price segments, make sure the boundary prices do not cause the same product to fall into two segments at once. **d. Operators: Contains / Does Not Contain Regular Expressions** **Description** These operators use regular expressions for searching. They allow, for example: * **starts with / does not start with** – the searched expression starts with a specific value, * **ends with / does not end with** – the searched expression ends with a specific value, * **character count equals** – the number of characters in the element equals a given value, * **character count is greater than** – the number of characters is greater than a given value, * character count is less than – the number of characters is less than a given value. **Examples**: * You are looking for products that start with the phrase "Gift vouchers". * Condition: `NAME_EXACT ~ "^Gift vouchers"` * In words: the product name starts with the phrase "Gift vouchers". * You are looking for products where the EAN element has fewer than 13 or more than 13 characters. * Condition: `EAN ~ "(?s)^.{0,12}$" AND EAN ~ "(?s)^.{14,}$"` * Note: This condition can be easily set up using the simple interface. * In words: the number of characters in the EAN element is either fewer than 13 or more than 13\. * The number of characters in the EAN element equals 8\. * Condition: `EAN ~ "(?s)^.{8}$"` * Note: This condition can be easily set up using the simple interface. * In words: the number of characters in the EAN element equals 8\. **Watch out for:** * We recommend trying multiple variants of the searched expression to ensure you cover all variations of the searched value. **e. Operators by List** **Description** * Use these when products have no common feature but you want to select a specific set of items. You can enter or paste multiple values into the field at once, each on a new line – e.g., IDs, EANs, names, manufacturers. Values can be copied directly from another table, e.g., from Excel or Google Sheets. **Examples**: * You need a query of top products that have no common denominator. * Condition: `ITEM_ID IN ("1"; "2"; "6"; "9")` * In words: I am looking for products with ITEM\_ID from the given list. * You are looking for categories except certain specific ones (your feed has over 50 categories). * Condition: `ITEM_ID NOT IN ("Clearance"; "Used goods"; "Open-box items")` * In words: I am looking for all categories except those listed. **Watch out for:** * The simple interface for this condition offers a text field that opens as a modal window. You need to enter each value on a separate line, without any separators. * There can be thousands of unique values to search by. * Empty lines are automatically removed after saving the query. **f. Operator: Is / Is Not Empty** **Description** * Used to find products where the selected element is empty or, conversely, filled. For this condition, simply choose the element you are examining and select whether it should be empty or not. **Example**: * You are looking for products with an empty BRAND element. * Condition: `BRAND = ""` * In words: the BRAND element is empty. * You are looking for products with a filled energy label. * Condition: `ENERGY_CLASS != ""` * In words: the energy label element is not empty. #### **Combining Conditions** Conditions can be freely combined using `AND, OR` and parentheses, e.g.: `(PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport"` ### **Basic Search** In the simple interface, just select an element, set a condition, and enter a value. You can add more rows by clicking the "+" icon. You can also choose whether the next row will be on the same level or as a nested condition. **Examples**: * `PRICE > 1000` -- displays products more expensive than 1000. * `PRODUCTNAME CONTAINS "t-shirt"` -- finds all products with this term in the name. * `[CATEGORYTEXT] CONTAINS "Electronics"` -- finds products from the given category. * `(PRICE > 100 AND BRAND = "Bose") OR CATEGORYTEXT CONTAINS "Speaker"` -- example of a condition with a nested condition. #### **What Values Can Be Entered in the "Value" Field** * a text or numeric value – e.g., `Car`, `1000`, * a regular expression – e.g., `^\d{8}$` for an EAN of exactly 8 digits, * another element – if you want to compare values between two elements (e.g., `PRODUCTNAME` does not contain `BRAND`). #### **Advanced Search with MQL** For more complex queries, use MQL (Mergado Query Language) – a text-based interface that provides full control over conditions. Activate MQL by switching from the simple search using the "Custom MQL query" option. Example MQL queries: * `PRICE > 1000 AND BRAND = "Nike"` -- Products with the Nike brand that are more expensive than 1000\. * `(PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport"` -- Nike products more expensive than 500, or products from categories whose name contains "Sport". * `PRICE_VAT > "500" AND CATEGORYTEXT ~ "hoodie" AND MANUFACTURER = "Adidas"` -- Items more expensive than 500, in a category containing the word "hoodie", made by Adidas. * `NAME_EXACT CONTAINS "children's swing" AND PARAM { NAME = "Shape" } | VALUE = "round" AND PARAM { NAME = "Material" } | VALUE = "solid wood"` -- The name contains "children's swing" and the Shape parameter equals "round" and the Material parameter equals "solid wood". To verify whether a specific product falls into the query, add the condition: `AND ITEM_ID = "123"` Example: `((PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport") AND ITEM_ID = "123"` * Instead of 123, enter the product ID. If the product appears, the query includes it. ### **Using Regular Expressions (RegEx)** You can use regular expressions for precise text filtering, e.g., by pattern in the name or by EAN code length. Examples: * Products whose name contains variations of the word "blue": `PRODUCTNAME ~ "blu."` * Checking EAN length: * exactly 8 digits: `^\d{8}$` * 8 or 12–14 digits: `^(\d{8}|\d{12,14})$` Using the markers `^` (start) and `$` (end) ensures the exact text length is checked, not just a part of it. ### **Verifying and Using Queries** After creating a query, you can: * **use it immediately** in rules (e.g., Hide product), * **save it for later use,** * or **reload** and modify its conditions. **To verify that a product actually falls into a query:** 1. On the *Products* page, load the query. 2. Switch to the MQL interface and add the condition `AND ITEM_ID = "123"`. If the product appears, the query includes it. **To easily and quickly find out which queries a product belongs to and which hiding rule hides it:** 1. On the *Products* page, find the product. 2. Navigate to the Queries tab for the product (from the available tabs: Preview, Elements, Images, Queries, and Track product). 3. A table with existing queries that the product currently belongs to will appear. 4. For each query, on the right side there is either: 1. information that the query is not included in any hiding rule, or 2. the name and link to the hiding rule that contains the query. ### **Creating and Editing a Query from the Rule Form** Mergado lets you create or edit a query directly from a new rule form, or when editing an existing rule. This is useful when you are setting up a rule and realize you do not have a suitable product query yet, or you need to modify an existing query. **Steps to create a new query from the rule form:** 1. On the Rules page, create a new rule or edit an existing one. 2. In the rule form, in the Query field, select the last option "Create new query" from the dropdown. 3. A side panel with a simplified Products page will slide in from the right, where you can enter the condition and query name. 4. After saving the query, the side panel will close and the new query will be automatically selected in the Query field of the rule form. **Steps to edit a query from the rule form:** 1. On the Rules page, create a new rule or edit an existing one. 2. In the rule form, in the Query field, find the existing query you need to modify in the dropdown and click the pencil icon. 3. A side panel with a simplified Products page and the selected query will slide in from the right. 4. Modify the query condition as needed. 5. After saving the changes, the side panel will close and the modified query will remain selected in the Query field. ### **Summary** Operators and conditions let you target specific product groups very precisely. With the right combination of conditions, regular expressions, and lists, you can create queries on which rules and automations can be safely and efficiently applied. ## **FAQ** ### **What is the difference between searching and product queries?** Searching lets you filter products by specified conditions. A query is a saved filter that you can reuse or apply rules to. Queries are permanent and clearly available in the Saved Queries section, while searching serves as temporary data work. ### **When should I search in input data and when in output data?** Most of the time, it is recommended to search in input data, because they are not affected by rules. Use output data when you work with values that Mergado creates only during the transformation for the output feed. ### **What does the red crossed-out circle symbol next to an element mean?** This symbol marks elements that do not exist in the input data and were created by the converter or user for the output element. You cannot search these elements when input feed searching is enabled. When you switch to output searching, this symbol disappears. ### **What operators can I use when creating queries?** Operators for working with text, numbers, regular expressions, value lists, and empty values are available. These include CONTAINS, \=, \!=, \<, \>, \~, IN, IS EMPTY, or their negations. Operators can be combined using AND, OR, and parentheses. ### **What are square brackets for in element names?** Square brackets must be used when the element name contains a space or other non-alphanumeric characters. You can also use them for elements without special characters – it makes autocompletion easier and reduces the risk of incorrect queries. ### **How do I find out whether an element value is empty or filled?** For checking empty or unfilled values, use the IS EMPTY and IS NOT EMPTY conditions. They are suitable, for example, for finding products with a missing manufacturer, category, or other important data. ### **How can I search by multiple values at once?** Use the IN or NOT IN operators. Enter values into the list field, each on a separate line. This method is suitable for queries that do not share a common feature (e.g., selecting top products or manually chosen categories). ### **How do regular expressions work in searching?** Regular expressions enable advanced filtering, for example, by text pattern or string length. For an exact match, you need to use the start and end markers (^ and $). This ensures that only values matching the exact format are returned. ### **When should I use simple search and when MQL?** Simple search is ideal for everyday work and basic filtering. MQL is suited for more complex queries, combining multiple conditions, comparing elements, or detailed use of regular expressions. ### **How do I find out whether a product actually belongs to a query?** On the Products page, load the query, switch to MQL mode, and add the condition `AND ITEM_ID = "product ID"`. If the product appears, it belongs to the query. If not, the query conditions do not match it. Alternatively, you can find the product and open its Queries tab on its card, where you will see all queries it currently belongs to. ### **How do I find out which queries a product belongs to?** On the Products page, open the Queries tab for the product. A list of all queries the product currently belongs to will appear, including information about whether any of these queries is used in a hiding rule. This helps especially when you have multiple hiding rules in the project or hide multiple product queries in a hiding rule, and you do not know which query and hiding rule is hiding a specific product. ### **Is it possible to create a query directly when setting up a rule?** Yes. In the rule form, you can choose the option to create a new query. A side panel will open where you enter conditions and a query name. After saving, the query is automatically inserted into the rule form. ### **Can I edit an existing query directly from a rule?** Yes. By clicking the pencil icon next to the query name in the rule form, you open a side panel with the query's conditions. Edit it and after saving, the changes are immediately reflected in the rule. ### **What are the most common mistakes when working with queries?** Common mistakes include searching in the wrong data source (input vs. output), not using square brackets for elements with spaces, incorrect use of regular expressions without ^ and $, or overlapping multiple conditions leading to unexpected results. ### **What are queries most commonly used for?** Queries form the basis for filtering, hiding products, adjusting prices, adding information, data quality control, and campaign targeting in individual advertising channels. They are one of the most important tools in Mergado. --- ## **4\. Product Data Modifications** In Mergado, you can change product data either **manually** or **in bulk through rules**. Manual edits are suited for individual products or smaller groups of items, while rules are designed for large-scale and repeated changes across the entire feed. ### **Manual Editing** Manual changes are ideal for a **smaller number of products** where creating a separate rule would not be efficient. Values can be edited directly on the *Products* page in the **Elements** view. ### **Quick Value Editing** * Edit an element value by clicking the **pencil icon**. Modify the value, then click **Save.** * Mergado always displays the **original** and **new value**, so you can easily review what changed. * If you want to propagate these manually edited values to the output feed, you need to regenerate the feed. Applying rules is not necessary in this case. * After editing data, a special rule also appears in the rules list on the *Rules* page. The rule cannot be edited, only turned off. * You can, however, filter all manually edited products on the Products page. Below the search field, click *Show \-\> With manual changes* This editing method is suitable, for example, for testing or fixing minor data errors. ### **Description Editing with the WYSIWYG Editor** For text elements like product descriptions (`DESCRIPTION`, `SHORT_DESCRIPTION`), Mergado offers a **WYSIWYG** editor (*What You See Is What You Get*). It lets you work with text conveniently and clearly, without needing to know HTML code. However, edits can only be made for specific products – bulk editing is not available. #### **How the Editor Works** * Open the editor by clicking the **pencil icon** next to a specific element. * You can edit the value in two modes: 1. **Plain view** – shows raw text with HTML tags (e.g., `New arrival`). 2. **Formatted view** – shows the resulting formatted text (e.g., **New arrival**). * After saving, you will see the original and new version. The new version is displayed with HTML tags. To export changes to the output feed, you need to regenerate the feed. After saving, the text is stored with the corresponding HTML tags, which are **supported by most advertising systems**. This allows you, for example, to highlight keywords or structure longer descriptions. ### **Bulk Edits Through Rules** Most changes in Mergado are made **in bulk through rules**. Rules let you automate modifications across hundreds or thousands of products and are the primary tool for feed optimization. #### **How Rules Work** * Rules are applied either to all products or to specific product queries created on the Products page. * After saving a query, go to the Rules page where you choose the rule type (e.g., value rewrite, calculation, product hiding, etc.). #### **Typical Rule Examples** **1\. Hide Product** The **"Hide product"** rule completely removes an item from the output feed (but the products remain in the Mergado catalog marked as hidden and can be unhidden and exported again at any time). It is used, for example, for products: * with **long delivery times** (e.g., `DELIVERY_DATE > 10`), * with **low margins**, * or that are **not suitable for advertising** (e.g., weapons in Google Ads). It can also be used for **time-based hiding** – for example, seasonal products. **2\. Calculating New Values** The **"Calculation"** rule type is used for creating or recalculating values, for example, to calculate margin. **Example:** Formula for calculating margin: ((%Selling\_price% \- %Purchase\_price%) / %Selling\_price%) \* 100 The result is saved to a new element (e.g., `MARGIN`), which you can then use further in rules or queries. **3\. Data File Import** If your input feed is missing important information (e.g., margins, stock levels, parameters), you can add it using the **"Data file import"** rule. This way, you can attach data from an external source to your products – typically in CSV or XML format. ### **Track Product Through Rules** If a product behaves differently than expected (e.g., it appears in the output feed even though it should have been hidden), use the **"Track product through rules"** function. * Apply the function to a specific product (you can also select multiple products at once). * After rules are applied, a link to a page showing all rules that affected the product appears, including a description of the changes. * This helps you easily identify which rule caused the unexpected change. * The link to this page can also be found later in the event history – in the left project menu, select History and search for the specific rule application. Before using this function, we recommend verifying that the product actually belongs to the query the rule is applied to. ### **Summary** Product data editing in Mergado is flexible – it can be done manually or in bulk. Manual editing is suited for minor interventions, corrections, and testing. Rules, on the other hand, ensure consistent and large-scale modifications across the entire feed. Features like the WYSIWYG editor or the track-through-rules function enable efficient data control and management. ## **FAQ** ### **When should I use manual edits instead of rules?** Manual edits are suited for a smaller number of products or one-time changes where creating a separate rule would not make sense. They are also good for quick testing. ### **Does propagating manually edited values require applying rules?** Yes. Even a manual edit of a single element value for one product creates an automatic rule of the Manual Changes type called Direct element editing of products, which must be applied for the changes to reach the output feed. ### **Where do I find information about which products have manual changes?** Manually edited products can be displayed on the Products page using Show --> With manual changes. At the same time, a system rule of the Manual Changes type appears in the rules list, representing the edit record. ### **What should I do if manual edits are not being reflected in the export?** Check whether the output feed has been regenerated. If the feed was not regenerated after editing, the changes will not appear in the export. ### **Can I use the WYSIWYG editor to edit texts in bulk?** No. The WYSIWYG editor is only for editing individual products. Bulk text changes must be made through rules. If you need to edit descriptions in larger quantities, you can use the Mergado Sources extension, which lets you get structured and optimized texts via ChatGPT. ### **What HTML elements does WYSIWYG support?** It supports basic HTML tags accepted by advertising systems (e.g., bold text, italic, paragraphs). ### **What does it mean that a system rule is created after a manual edit?** It is an internal record that logs the manual edits performed. It cannot be edited or have its behavior changed – it can only be temporarily or permanently turned off. ### **Can I find out what rule affected a specific product and how it affected it?** Yes. The Track product through rules function serves this purpose. It displays an overview of all rules that modified the product and a precise description of the changes made. ### **Where do I find the rule tracking history if I want to view it later?** In the left menu, open the History page and search for the specific rule application by date and time. From there, you can click through to the processing detail. ### **How do I know that a rule is not working correctly?** If the resulting values in the output feed do not match expectations, first verify whether the product actually belongs to the query used by the rule. If so, use the track-through-rules function to identify the rule that made the change. ### **Can rules affect values that I edited manually?** Yes. If a rule targets the same element, it can overwrite the manually edited value. In this case, we recommend protecting the value through proper rule structure or adjusting queries so the overwrite does not occur. --- ## **5\. Product Authorization** Product authorization is a feature that provides more precise control over which products are exported to the output feed. It works as an alternative to hiding rules. When authorization is enabled, newly imported products are loaded into the project but **will not be exported** until the user manually approves them. The feature always applies to a specific project. ### **Enabling the Product Authorization Feature** **Product authorization can be enabled in two ways:** * when creating a new project: * In the last step of the wizard, in the Summary section, you will find the *Enable product authorization* option. Simply check the checkbox. * in an existing project: * Go to the left menu *Settings --> General project settings*. * In the Basic information section, you will find the *Enable product authorization* checkbox. * The feature can be turned off the same way. After turning it off, you need to regenerate the project. ### **Project Behavior with Authorization Enabled** **Newly created project** * After enabling the feature for a new project, all products receive the **Pending approval** status. * The output feed will be empty until some products are approved. **Existing project** If you enable authorization later: * all existing products receive the **Approved** status, * all newly imported products will have the **Pending approval** status and will not be exported until the user manually approves them. ### **Working with Product Authorization** After activating the feature, a new **Product Authorization** section appears on the Products page in the project. Here you find a table view of all products and quick filtering by approval status. **The table contains, for example:** * the date of the product's first import, * name, ID, price, category, * the current authorization status. **Each product can have one of three statuses:** * Approved * Rejected * Pending approval **Filtering lets you display:** * all products, * only approved, * only rejected, * or only products pending approval. Using the *Filter* button, you can open the standard form with MQL conditions and combine the authorization status filter with filtering by name, price, category, brand, and other product information. ### **Approving or Rejecting Products** Products can be approved or rejected manually: 1. select products using checkboxes (one or more), 2. the *Approve* and *Reject* buttons become active, 3. click the desired action, 4. changes take effect after the project is regenerated. Rejected products appear on the Products page as "Rejected product." Their values are displayed in gray, and the product has an *Approve* button available for quick export permission. ### **Product Authorization vs. Hiding Rules** Product authorization and hiding rules solve a similar problem – they decide what gets exported to the output feed. However, they work fundamentally differently: **Product authorization** * blocks only **newly imported products,** * approval or rejection is always performed **manually by the user,** * does not depend on product elements or their values. **Hiding rule** * hides products **based on conditions** (e.g., price, margin, availability), * the query is evaluated during each regeneration, * products can automatically become visible again if they stop meeting the condition. In simple terms: * authorization hides **all new products**, * a hiding rule hides **products meeting a condition**. ### **Export Behavior in Relation to Authorization and Rules** A product **will not be exported** if: * it has *Pending approval* or *Rejected* status, and is not hidden by a rule, * it has *Approved* status but is hidden by a rule, * it has *Pending approval* or *Rejected* status and is also hidden by a rule. A product **will be exported** if: * it has *Approved* status and is **not** hidden by any rule. ### **Summary** Product authorization ensures that new products reach the output feed only after manual approval. This gives the user full control over which items can start being advertised. The feature can be enabled in both new and existing projects and is easily combined with hiding rules. Authorization is ideal for cases where you need to prevent automatic publication of new inventory. ## **FAQ** ### **What is the purpose of product authorization?** Authorization is used for manually controlling which products are exported to the output feed. New products are only exported after the user approves them. ### **Where can I enable product authorization?** Either when creating a new project in the Summary step, or in an existing project in Settings --> General project settings. ### **What happens to products if I enable the feature in an existing project?** All existing products are set as approved. Newly imported products will have the Pending approval status. ### **How can I see the authorization status of individual products?** In the special Product Authorization section, you will find an overview with the status Approved, Rejected, or Pending approval. ### **How do I approve or reject multiple products at once?** Select products using checkboxes and then click the Approve or Reject button. Changes take effect after the project is regenerated. ### **What happens to a rejected product?** The product will not be exported and will appear in the product list as rejected. It can be manually approved at any time. ### **Can product authorization and hiding rules be combined?** Yes. Authorization only handles the product's approval status, while hiding rules work with values in product elements. Both features can operate simultaneously. ### **What is the main difference between authorization and the Hide product rule?** Authorization hides all new products regardless of their properties. A hiding rule hides products based on conditions and can automatically unhide them. ### **Can a product be approved and still not be exported?** Yes. If it is approved but also falls under a hiding rule, it will not reach the output feed. ### **How do I find out why a product is not being exported?** Check its authorization status and also verify whether it is hidden by a hiding rule. Both conditions can block export. ### **Is it always necessary to regenerate the project after approving products?** Yes. Approval or rejection takes effect only after the output feed is regenerated. ### **Can I turn off product authorization later?** Yes. It can be turned off in the project settings. After turning it off, the project needs to be regenerated for the change to take effect. --- ## **6\. Export and Working with Data Outside Mergado** This section describes ways to **export product data** from Mergado to external files. You can use export either **as a one-time action** for quick data review, or create a **new permanent output feed** available via a URL address. ### **Export to CSV (One-time File)** If you need to review data outside Mergado or create a simple report, you can download products as a **CSV file** directly from the *Products* page. This export is suitable for manual review, analysis, or import into other tools (e.g., Excel, Google Sheets), and you can fully customize what gets exported to the CSV. #### **How to Export Data from the Table** One-time export is done from the **Table** view. 1. On the Products page, use a filter to set which products you want to export (e.g., all or just a saved query). 2. In the Table view, select which columns (elements) you want to include. 3. Click *Download CSV* and select the export type: 1. Input elements 2. Output elements 3. Output elements including hidden ones 4. **Columns from table (recommended – exports exactly what you see)** 4. The CSV file downloads to your computer and you can open it in a spreadsheet editor. **Note:** If your project or table contains a **large number of products**, the table export may not complete. In that case, we recommend creating the export as a **new project** (see below). #### **Choosing Columns and Order** Before exporting, you can customize which **elements (columns)** will be in the CSV: * You can choose from existing presets, e.g., *Pairing, Bidding*, which have pre-configured elements. * If the presets do not work for you, choose the *Custom* option, where you can select any columns. * Using **drag & drop**, you can change their order. * Click on **"Download CSV"** and then select **"Selected columns"** * The CSV will export exactly the columns visible in the current view. #### **Exporting Only Some Products** If you do not need to export the entire feed, you can choose to download only **products from a specific saved query** to CSV. This gives you an overview of just the part of the inventory you are interested in (e.g., *products without EAN*, *products on sale*, etc.). ### **Export to a New Project (CSV via URL)** If you want the CSV to be **permanently available via a URL address**, you can create a **new project** that generates an output feed in CSV format. #### **How to Create an Output Project** 1. Create a **new project** in Mergado. 2. As the data source, use your product feed and select the correct input format. 3. Set the output format to **Plain CSV**. This creates a project that regularly generates an up-to-date CSV feed available via URL – ideal, for example, for automatic data processing or sharing with partners. #### **Format and Delimiter Settings** When creating a CSV project, you can specify **which delimiter** to use (e.g., comma or semicolon). The new CSV will load **all elements** from the original feed, which you can then modify and customize as needed. #### **Selecting and Hiding Elements** To keep your CSV output clear, you can choose **which elements (columns)** should appear in the resulting feed. Steps: 1. On the **Elements** page, select one or more elements you do not want in the CSV. 2. Check the **"Hide"** option. 3. After regenerating the feed, the selected elements **will not appear** in the CSV. 4. Using the **Sort** function, you can also customize the **column order** and keep the export clear. A CSV feed created this way contains only relevant data and can serve as an input source for other systems (e.g., reporting, warehouse systems, BI tools, etc.). ### **Summary** Mergado offers two main ways to export data: * **One-time export to CSV** – ideal for quick data review, working in Excel, or occasional analysis. * **Export to a new project (CSV via URL)** – suitable for permanent and automated data processing outside Mergado. By customizing columns, hiding elements, and configuring the format, you can easily get exactly the CSV output you need. ## **FAQ** ### **What is the difference between a one-time export and export via a new project?** A one-time export downloads a CSV directly from the table and is for quick review or data analysis. Export via a new project creates a permanent CSV feed available at a URL, suitable for automations and regular data updates. ### **What should I do if the one-time export does not complete?** You are probably working with a large number of products. In this case, we recommend creating a new output project with CSV format, which can handle the export even for very large feeds. ### **How do I control which columns appear in the CSV?** In the Table view, select the displayed columns and set their order. If you use the "Columns from table" export type, the CSV will contain exactly what you see and have set up. ### **Can I export only a specific group of products?** Yes. Simply load a saved query in the top filter or create a new one, and then download the CSV. The exported file will contain only products from that query. ### **How do I hide columns I do not want to export from the CSV?** On the Elements page, check the "Hide" option for the element. After regenerating the project, these elements will not appear in the output CSV feed. ### **Where do I set the delimiter for CSV output?** The delimiter is set when creating a new project if you choose Plain CSV as the output format. You can choose, for example, a comma or semicolon. ### **Is the CSV feed updated automatically?** Yes. The CSV output created through a new project is updated during each data regeneration, just like any other output feed in Mergado. ### **Does the output CSV contain all elements from the feed?** Yes, the output CSV contains all elements from the input feed, unless you hide them yourself on the Elements page. ### **Can I use the CSV output as input for another Mergado project?** Yes. A CSV feed available at a URL can be used as an input data source for other projects or automations. ### **Do products in the export always stay in the same order?** You determine the column order through element order settings. Row order corresponds to the order of products generated in the feed – Mergado does not guarantee it as stable if the input feed itself changes, and the user cannot change it. --- ## [Variables in Mergado](https://help.mergado.com/en/mergado-editor/working-with-data/basic-components/variables-in-mergado/) # **Variables in Mergado** ## **I. Variables in Mergado Editor** ### **1\. What are variables in Mergado** Variables in Mergado Editor represent placeholders for specific values from elements. They are "holders" for data that differs from product to product and that you want to further process or use in rules. * A variable can have a different value for each product. * A typical example is the element `PRICE_VAT`, whose value changes across products. * You can create a variable manually -- for example, if you need to extract part of the text from a name or description. * In addition to user variables, there are also special system variables, such as `@MERGADO_ID`. Mergado works directly with elements as the source of values. Variables are a supplementary tool for situations where you need to extract only a specific part of a text or further process values. ### **2\. How variables work** Variables are used for text extraction and subsequent use, primarily in rules. The basic principle is simple: 1. The user selects an element that contains the desired information. 2. They enter a regular expression that selects a specific part of the text from that element. 3. This part is saved as the variable's value. 4. The variable is then used in a rule -- Mergado inserts the correct value for each product individually. 5. For system variables (e.g. `@MERGADO_ID`), the same approach applies -- in rules, they are used wrapped in percent signs: `%@MERGADO_ID%`. Variables allow you to work even with data that is not well structured in the feed. ### **3\. Why and when to use variables** Variables are suitable wherever you need to work with part of a text, create new values, or fill in missing information. #### **A. Setting values in rules** Variables are often used to add or modify element values. Using regular expressions, you can extract just part of the text and save it as a variable, which you then insert into another element. #### **B. Assembling and modifying data** Variables allow you to combine values from multiple sources into a single result. A typical use case is assembling a product name from a combination of several elements and variables (e.g. manufacturer, type, size). #### **C. Extracting data into PARAM elements** If products do not contain parameters in the `PARAM` element, but properties are listed in the name or description, you can use a regular expression to extract them into variables and then save them as standardized parameters. This approach is universal -- it works regardless of what specific values appear in the text. #### **D. Using the system variable `@MERGADO_ID`** `@MERGADO_ID` is a unique product identifier that Mergado uses for internal identification. Users can leverage it especially in situations where: * `ITEM_ID` or `g:id` values are missing or duplicated, * a unique URL needs to be created by adding `#@MERGADO_ID`, * images cached by comparison shopping engines need to be refreshed. The `@MERGADO_ID` value can be written to any element using an Rewrite rule. ### **Section summary** Variables in Mergado are used for extracting and further processing values from elements. The user selects an element, defines a regular expression to extract the desired part of the text, and saves it as a variable. This variable can then be used in rules, when assembling names, creating parameters, or modifying URLs. Variables are suitable wherever you need to work with variable or unstructured text and convert it into a unified format. --- ## **II. Types of variables in Mergado** ### **1\. User variables** User variables represent values extracted from elements that can differ from product to product. They are most commonly used in situations where you need to extract only a specific part of the text from a name or description. #### **Creating user variables** User variables are managed on the **Variables** page using the **New variable** button. The process is as follows: * you select the element from which the variable should be derived, * you enter a regular expression that specifies the part of the text to capture, * you verify in the test field that the expression works correctly, * you save the captured text under the chosen variable name. * using a single regular expression, you can create multiple variables at once * if you use parentheses in the regular expression, each set of parentheses is evaluated as a separate group, and each group can be saved as a separate variable * typically, for example, when an image URL element contains multiple URLs separated by commas and you need to extract each URL into a separate variable #### **Example** In a Google feed, the product description in the element `g:description` contains product dimensions, for example "150x50", where the first value represents width and the second length: ``Product description, dimensions: 150x50`` The goal is to extract these values and save them into two separate parameters: **Width** and **Length**. #### **A. Creating the variables** 1. On the **Variables** page, click **New variable**. 2. In the **Element** field, select the element `g:description` from the list. 3. In the **Regular expression** field, enter an expression that captures both dimensions: (\\d+)x(\\d+) 4. The **Test text** field will display a random value from the selected element, so you can immediately see whether the expression works. Using the arrow icons, you can load additional samples. 5. If the regular expression captures any part of the text, a section with fields for entering variable names will appear below. If the expression has multiple groups, a separate field is displayed for each one. In our case, the following fields will appear: * **Full match**: "150x50" * You can ignore this field or save it as a variable, for example `dimensions`, if you need the whole string. * **Group 1**: "150" Name it `width`. * **Group 2**: "50" * Name it `length`. 6. Click **Save**. This gives you two new variables: **`width`** and **`length`**. #### **B. Setting parameters using a rule** 1. On the **Rules** page, create a new rule of the **Set product parameters** type. 2. In the first column, select the product query for which you want to set the parameters. 3. Enter: **First parameter:** * Parameter name: `Width` * Parameter value: `%width%` **Second parameter:** * Parameter name: `Length` * Parameter value: `%length%` 4. Save the rule, apply it, and then regenerate the project. #### **C. Result in the output feed** ``Product description, dimensions: 150x50`` `` ``Width`` ``150`` `` `` ``Length`` ``50`` `` #### **Primary purpose** User variables are used primarily for: * extracting a specific part of text from elements with longer or unstructured content, * extracting values such as size, color, volume, technical parameters, or other product properties, * adding or creating parameters in the `PARAM` element, * populating other elements using rules, such as Set product parameters or Overwrite. This approach is universal -- it works for any color variants, sizes, or other values that may appear in the feed. ### **2\. System variables** System variables form a special set of variables that are built into Mergado. Users do not create them manually. #### **Fixed set** On the **Variables** page, you will find a **Special variables** table listing all available system variables. Currently, there is a single system variable: **`@MERGADO_ID`** #### **What `@MERGADO_ID` means and how it works** * `@MERGADO_ID` is an internal unique product ID. * It is a numeric value that is unique for each product. * In rules, it is used wrapped in percent signs: `%@MERGADO_ID%`. #### **Typical uses of `@MERGADO_ID`** * as a replacement for missing or duplicate values in the `ITEM_ID` or `g:id` elements, * for creating unique URLs by adding `#@MERGADO_ID`, * for "refreshing" images -- changing image URLs by appending `#@MERGADO_ID` triggers re-fetching by comparison shopping engines, * for writing into any element using an **Overwrite** rule. ### **3\. Using elements as variables** In Mergado, you can directly use element values in rules without needing to create a custom variable. Simply enter the element name wrapped in percent signs, for example: * `%PRODUCTNAME%` * `%MANUFACTURER%` * `%DESCRIPTION%` This way, you can work with the complete content of an element. This mechanism functionally resembles a variable, but you do not need to create one separately. #### **When an element is sufficient** Using an element in a rule is sufficient when: * you want to use the entire element value, * you are not extracting part of the text, * you are working with clear and well-structured content. #### **When to create a user variable** It is appropriate to create a user variable when: * you need to extract only a specific part of the text (e.g. "XL" from a long name), * you are working with a description that contains various values mixed in a single text, * you do not want to create dozens of queries or rules for each specific color, size, or other variant, * you need a universal solution that will work even when new values are added to the feed. In these cases, a regular expression allows you to create a variable that extracts exactly the information you need. --- ## **III. Working with variables in Mergado** ### **A. Managing variables** Variables are managed on the **Variables** page in the main menu of Mergado Editor. This page serves as a central overview of all variables in the project: * **User variables** -- variables created by the user. * **Special variables** -- system variables listed in the *Special variables* table. * **Creating new variables** -- done by clicking **New variable**. Variable management also includes the ability to edit or delete a variable. ### **B. Creating user variables -- workflow** The process for creating a new user variable: 1. **Click the "New variable" button** on the *Variables* page. 2. **Select the source element** from which the variable should be created. 3. **Enter a regular expression** (mask) that specifies the part of the text to extract. 4. **Test the expression**: * The *Test text* field displays a random value from the selected element. * The test text can be refreshed using the **double arrow icon**. * Click **Test expression**. 5. **Adjust and test** until the correct text selection is found. * For working with regular expressions, you can also use the external tool *regex101.com*. 6. **Save the variable** -- name the captured text parts and confirm by clicking **Save variable**. This process allows you to efficiently extract specific information from any text in an element and then use it in rules. ### **C. Using variables in rules** Variables are used primarily in rules, where they serve as a source of values for writing into other elements. #### **Syntax** * A variable is written in a rule as `%VARIABLE_NAME%`. * The same syntax applies to the system variable: `%@MERGADO_ID%`. * The value of an entire element can be used directly, for example: * `%PRODUCTNAME%`, `%MANUFACTURER%`, `%DESCRIPTION%`. * or as a combination of two: `%URL% %@MERGADO_ID%` #### **Typical usage** **1\. Rewrite rule** Used for assembling new values -- for example, composing a product name from multiple sources: `%MANUFACTURER% %PRODUCTNAME% %PARAM_SIZE%` **2\. Set product parameters rule** Used for populating the `PARAM` element. If the parameter value is stored in a variable, it is entered on the right side of the rule. ### **D. Using variables in queries (selections)** Variables are not used directly in query syntax. However, queries often define the **group of products** to which a rule with a variable is then applied. Example workflow: * you create a product query that contains a certain property in the name, * you apply a rule to this selection that uses a variable created with a regular expression. #### **Example** Some product names contain sizes that you need to extract and save as a new "Size" parameter. Sample product name: **"Adidas t-shirt ABC, color red, size XL"** 1. **Creating a variable \-** Create a variable from the source element (e.g. `g:title`). Using a regular expression, capture the part of the text representing the product size, i.e. **"XL"**. Save the variable under a name, for example **`product_size`**. 2. **Creating a product query \-** Create a selection of products that contain a size in the name. You can use, for example, a condition like: `g:title CONTAINS "size"` (depending on the actual structure of your product names). 3. **Creating a rule -- two possible approaches** **Approach A: Rewrite rule** Use this when you want to manually assemble the parameter structure using elements. * in the **Element** field, enter: `g:attribute_detail { g:attribute_name = "Size" } | g:attribute_value` (if the "Size" parameter does not yet exist, Mergado will create it automatically) * in the **New value** field, enter: `%product_size%` **Approach B: Set product parameters rule** Use this when you want to create the parameter simply using a form. * in the **Parameter name** field, enter: `Size` * in the **Parameter value** field, enter: `%product_size%` This way, the extracted size is saved as a standardized parameter that can be further used in export formats or rules. ### **E. Displaying and exporting variables** #### **Displaying values** * System variable `@MERGADO_ID`: * The values of the system variable `@MERGADO_ID` can be displayed on the **Products** page. * In the table view, you can add a column with `@MERGADO_ID` values using the Mergado icon. * User variables * User variable values can only be displayed after inserting the variable into an element using a rule. * Element values created from a variable can be checked either on the Products page or in the *Elements -> Element values -> List element values* section. #### **Export to CSV** * Just like viewing, exporting variable values is only possible as values of the element into which the variable was inserted using a rule, or if it is the system variable `@MERGADO_ID`: * On the *Products* page, switch to the table view, select the correct element, and click **Download CSV**. * Select the option **Columns from table** -- this will also download the variable values that were displayed in the table. --- ## **IV. Use cases and common mistakes** ### **1\. Typical use cases** #### **a) Adding product parameters** Values listed in the name or description (e.g. size, color, volume, material) can be extracted into a user variable using a regular expression. The values obtained this way are then written into the `PARAM` element using the **Set product parameters** rule. #### **b) Creating a new product name** To modify or unify product names, you can assemble new element content from multiple variables and elements. A typical example of use in an **Overwrite** rule: `%MANUFACTURER% %PRODUCTNAME% %size%` where `MANUFACTURER` and `PRODUCTNAME` are standard elements and `size` is a user variable. The result is a structured and consistent product name. #### **c) Removing extracted data from the name** If parameters were extracted from the name and moved to `PARAM`, you may need to remove them from the original product name. This is done using a **Find & Replace** rule with a regular expression. This approach is common, for example, with formats that require a clean name without sizes or colors. #### **d) Using `@MERGADO_ID` as a unique key** `@MERGADO_ID` is used primarily for: * replacing missing or duplicate identifiers (`ITEM_ID`, `g:id`), * creating unique URLs (e.g. by appending `#@MERGADO_ID` to the end of the address), * forcing images to be re-fetched by comparison shopping engines. This system variable is written into elements using an **Overwrite** rule. ### **2\. Common mistakes and how to fix them** #### **Variable returns empty values** * The regular expression does not match the actual text. * Solution: adjust the expression and test it on multiple cases in Mergado or in regex101.com. #### **Expression captures too much text** * The regular expression is too broad. * Solution: make the pattern more specific, possibly using anchors, groups, or range limitations. #### **Selected element does not contain the required data** * The variable was created from the wrong element. * Solution: verify which element actually contains the information and adjust the variable accordingly. #### **Rule did not affect the data** * The rule may not have been applied, or it was applied to a different query. * Solution: check the rule application and verify the output in the *Elements -> Element values -> List element values* section. #### **Duplicate identifiers** * Some services require a unique identifier. * Solution: use `%@MERGADO_ID%` to overwrite or supplement the target element that contains duplicates. ## **FAQ** ### **What is a variable in Mergado?** A variable is a stored value obtained from an element that you can use in rules and other data modifications. ### **What are variables used for?** They are used for extracting values from elements, adding parameters, creating new values, or standardizing data. ### **What is the difference between an element and a variable?** An element is the original value from the feed. A variable is a part of that value obtained using a regular expression. ### **When should I use a variable and when is an element sufficient?** Use a variable when you need to extract and use part of the text. Use an element when you want to work with its entire value. ### **How is a variable created?** A variable is created on the Variables page using the "New variable" button. You select the element that contains the needed data and enter a regular expression to target the part of the text to extract. You then test the expression on a sample value and adjust it as needed until it matches the desired result. Finally, you name the captured value and save it as a variable. ### **Do I need to create a variable for every element I want to work with?** No. If you need to use the entire content of an element, you do not need to create a variable. ### **Can I create multiple variables at once?** Yes. If the regular expression contains multiple groups (parentheses), each can be saved as a separate variable using a single form. ### **What is the system variable @MERGADO\_ID?** It is an internal unique product identifier that is automatically available. ### **What is @MERGADO\_ID used for?** For filling in missing or duplicate identifiers, creating unique URLs, forcing images to be re-fetched in the target system, etc. ### **How do I use a variable in a rule?** You insert it in the format %VARIABLE\_NAME%. ### **How do I insert @MERGADO\_ID into a rule?** You write it in the format %@MERGADO\_ID%. ### **Can I use a variable in a query (selection)?** No, variable syntax is not used in queries. A query only serves to define the products to which a rule with a variable will be applied. ### **Where do I manage variables?** On the Variables page in the project's main menu. ### **Can I edit or delete a variable later?** Yes, you can make edits and deletions in the variables overview. ### **How do I know my regular expression works?** Use the Test text in the variable creation dialog or test the expression on regex101.com. ### **What should I do if the variable returns empty values?** Adjust the regular expression so that it matches the text structure in the element. You can also contact our technical support. ### **Why did my variable not appear in the result?** Check that the rule was applied and that the variable matches the element content. ### **How do I check the variable's value for a product?** The simplest way is to view the product in the table view on the Products page and add a column with the relevant element or @MERGADO\_ID. Element values created from a variable will only be visible after creating and applying a rule. You can also use the value listing in the Elements -> Element values -> List element values section. This tool shows the exact element content as it was written after rule application. This lets you easily verify whether the variable works as expected. ### **Can I export variable values to CSV?** Yes, just use the Columns from table option when exporting CSV. ### **Why did the regular expression capture too much text?** The expression is too broad. Restrict it with more specific groups or anchors. ### **How do I get extracted values into the product name?** Create a variable, then insert it into an Rewrite rule as a combination of the name and the variable. ### **How do I remove an extracted value from the name?** Use a Find and replace rule with an appropriate regular expression. ### **Can variables be used for working with URLs?** Yes, you can also use variables for modifying URLs. A typical example is appending the value `%@MERGADO_ID%` to the end of a URL, creating a unique address (for example, for variant products or images). This approach is also used when you need to force comparison shopping engines to re-fetch images. In rules, URLs are assembled using the same syntax as other text values. ### **What if a product does not have a parameter in the PARAM element?** Extract the value from the name or description using a variable and add it using the Set product parameters rule. ### **Do I need a separate regular expression for each property?** No. A well-designed expression with groups can extract different properties separately (e.g. all sizes or colors). ### **Can a variable contain multiple values?** No. A variable is a set of values that contains exactly one or no value for each product. ### **What should I do if I have duplicate values in ITEM\_ID?** If the feed is missing a unique identifier, you can replace it with the system variable `@MERGADO_ID`. Using an Rewrite rule, you set `%@MERGADO_ID%` into the ITEM\_ID or g:id element, ensuring that each product gets a unique value. This approach is reliable and recommended for projects where identifiers are repeated, inconsistent, or contain invalid values. Changes take effect after applying the rules and subsequently updating the output feed. ### **Is using variables computationally expensive?** No, variables are evaluated during rule application and have no negative impact on the normal operation of the project. --- ## [Operators for Mergado Query Language](https://help.mergado.com/en/mergado-editor/working-with-data/basic-components/operators-for-mergado-query-language/) # **Operators for Mergado Query Language** ## **List of operators in MQL** This overview explains all operators you can use in **Mergado Query Language (MQL)** – a language for creating conditions in product queries. It will help you better understand how MQL works and how to formulate rules for selecting data precisely. With the correct use of operators, you will be able to create accurate, efficient, and well-organized queries. ## **Operator Overview** | **Operator** | **Meaning** | | -------------- | --------------------------- | | `CONTAINS` | contains text | | `NOT CONTAINS` | does not contain text | | `=` | equals | | `!=` | does not equal | | `~` | contains regular expression | | `!~` | does not contain regular expression | | `<=` | is less than or equal to* | | `>=` | is greater than or equal to*| | `<` | is less than* | | `>` | is greater than* | | `IN` | is included in a list | | `NOT IN` | is not included in a list | | `OR` | logical "or" expression | | `AND` | logical "and" expression | | `SORT BY` | sorts by element name | *Used only for numeric values. ## **Modifiers for `SORT BY`** | **Modifier** | **Meaning** | | --------------- | ------------------------------ | | `DESC` | sorts in descending order | | `ASC` | sorts in ascending order | | `AS NATURAL` | sorts in natural order | > These modifiers are used together with the `SORT BY` operator and determine how results are sorted. ## **How to Write Conditions Correctly** Conditions in MQL always follow this pattern: ``` [] ``` **Example:** ``` [PRICE] >= 100 ``` ### **Writing Rules** * **Values** do not need quotes if they contain only a single alphanumeric word or number. E.g., `[CATEGORY] = Electronics` * **Element names** should be enclosed in square brackets if they contain non-alphanumeric characters: `[PARAM | color] = "blue"` * **Text values and regular expressions** should be written in straight quotes `" "`, not typographic quotes. * **Recommendation:** always use square brackets. This way, Mergado will offer a list of available elements as you type your query. ## **Tips for Efficient Work** * Combine the `AND` and `OR` operators to create complex queries. * Use `SORT BY` for clear result ordering – for example, by price or name. * If you are unsure which operator to use, start with `CONTAINS` – it easily verifies whether an element contains the desired text. * For precise pattern matching, use regular expressions (`~` and `!~`). ## **FAQ** ### **What is the basic format of an MQL condition?** A condition follows the pattern `[] `. ### **When do I need quotes around a value?** Use them when the value contains spaces or special characters. Single-word alphanumeric values and numbers do not need them. ### **What is the difference between `CONTAINS` and `~`?** `CONTAINS` searches for exact text, while `~` allows searching using a regular expression (pattern). ### **Can I combine multiple conditions?** Yes, you can join multiple expressions into one query using `AND` and `OR`. ### **What is `SORT BY` used for, and what about its modifiers?** `SORT BY` determines which element results are sorted by. The modifiers `ASC`, `DESC`, and `AS NATURAL` set the sort order. --- ## [Inverse queries in Mergado](https://help.mergado.com/en/mergado-editor/working-with-data/basic-components/inverse-selections-in-mergado/) # **Inverse queries in Mergado** ## **How to work with inverse queries in Mergado** This article explains what inverse queries are and how to use them effectively in Mergado. We will show the difference between a simple inverse query (where you just change the operator, e.g. from "=" to "!=") and a more advanced query using MQL and the `NOT` operator. By the end of this article, you will be able to: * recognize situations where an inverse query is appropriate, * create a simple inverse query without knowing MQL, * rewrite a complex query into MQL and use `NOT(...)` negation to achieve the opposite result. ## **Context** Normally, when working with queries, you define the products you want to target — e.g. raise the price, edit the name, or hide them. Sometimes, however, it is easier to create an inverse query — one that selects everything else except a certain group. In other words: instead of "what I want to edit," you define "what I don't want to edit." This approach saves time especially when: * you know exactly which products should remain unchanged, or * you have a small group of products to keep in the output, and all others should be hidden. ## **Practical examples** **Typical example** You manage a feed with 65,000 products. You want to keep only 5,000 specific products in the output and hide all the rest. You can approach this in two ways: * create a query for all 60,000 products you don't want (very impractical), or * create an inverse query: "Everything except these products." This is exactly what inverse queries are for. **When an inverse query is useful** * you don't want a certain group of products to be affected by a rule (e.g. you don't want to change their name or price), * you want to hide everything except a certain group of products, * you want to manage exceptions clearly instead of long lists of conditions. ## **Simple inverse queries (without MQL)** If you need to create a simple inverse query, you don't need to use MQL right away. You can work with opposite operators directly in the basic query interface. The principle is simple: instead of a condition like "contains / is in list / =", you use its negation. | Standard operator | Opposite operator | What it does | | ----------------- | ------------------- | ------------------------------------------------ | | `=` (equals) | `!=` (not equals) | Selects products with a different value | | contains | does not contain | Selects products that do not contain the text | | is in list | is not in list | Selects products that are not in the given list | **Example 1 — reversing "contains"** Original query: ``` CATEGORY ~CONTAINS "Zahrada" ``` Finds all products that have "Zahrada" in the `` element. Inverse query (keeps only products that do **not** contain this value): ``` CATEGORY !~ DOES NOT CONTAIN "Zahrada" ``` **Example 2 — "is in list" vs. "is not in list"** Original query (products you want to keep in the output): ``` ITEM_ID Is in list (101, 102, 103) ``` Inverse query (products you want to hide — everything except the listed ones): ``` ITEM_ID Is not in list (101, 102, 103) ``` This query picks all products except these three. ## **Advanced inverse queries using MQL (NOT)** If the query is more complex (multiple conditions, `AND/OR` logic), we recommend using MQL and the `NOT` operator. This approach gives you full control over how the query is inverted. ### **How the NOT operator works** In MQL, you can use `NOT` to negate a condition or an entire query. Equivalence examples: ``` ITEM_ID != 43 ``` is the same as ``` NOT(ITEM_ID = 43) ``` * `ITEM_ID = 43` → selects the product with ID 43 * `NOT(ITEM_ID = 43)` → selects all products **except** the one with ID 43 **How negation works (in words):** `NOT` inverts the set — it selects everything that **does not match** the original query. ## **Steps to follow** ### **1) Log in to Mergado and go to query management** * Log in to your Mergado account. * Go to the **Products** section in the main menu. ### **2) Create the query** * The `NOT` operator is always added in the **Custom MQL query** section. * You can first build the query in the simple interface and then switch to the MQL section, or write the query directly in MQL. * Create a query of the products you want to **keep**. * Wrap the entire query in parentheses `()` and add `NOT` in front. ### **3) Name and save** * Give the query an appropriate name and save it. * You can then use it within rules (e.g. in a hide rule). ## **Practical example** You want to keep in the output only products that: * have "kalhoty" in the name, * have the parameter **color = fialová**, * and cost more than **1100 CZK incl. VAT**. You want to hide everything else. The total number of products is about 65,000; this query finds only 2. Steps: * In the query interface, switch to **Custom MQL query**. * Wrap the original query (the one defining *what to keep*) in `()` and prepend `NOT`. This creates an inverse query: it selects all products **except** those matching the original conditions. You can use it in a hide rule — only the products matching the original query will remain in the output feed. ## **Tips and common mistakes** * **Don't forget the parentheses.** When combining multiple conditions, always wrap the entire original query in parentheses: ``` NOT(PRODUCTNAME CONTAINS "boty" OR CATEGORY = "Doplňky") ``` * **Remember that `NOT` inverts the entire logic, not just individual parts.** When combining multiple expressions with `AND` and `OR`, the result may differ from what you expect. Always test the query. ### **Quick recap (overview)** | Query type | How to create | Example | | ----------------------------------- | ----------------------- | ---------------------------------------------------------- | | Simple inverse query | Use the opposite operator | `CATEGORY != "Zahrada"` | | Inverse query with a value list | Use "is not in list" | `ITEM_ID NOT IN (101,102,103)` | | Complex inverse query | Use MQL and `NOT(...)` | `NOT(PRODUCTNAME CONTAINS "kalhoty" AND PRICE_VAT > 1100)` | ## **FAQ** ### **When does it make sense to use an inverse query?** When you don't want a certain group of products to be affected by a rule, when you want to hide everything except a certain group, or when you need to manage exceptions clearly without long lists of conditions. ### **How do I create a simple inverse query without MQL?** In the basic query interface, use the opposite operator (e.g. `!=` instead of `=`; "does not contain" instead of "contains"; "is not in list" instead of "is in list"). ### **What does an example of "contains" vs. "does not contain" look like?** Original: `CATEGORY ~CONTAINS "Zahrada"` Inverse: `CATEGORY !~ DOES NOT CONTAIN "Zahrada"` ### **How do I create an inverse query for a list of IDs?** Original: `ITEM_ID Is in list (101, 102, 103)` Inverse: `ITEM_ID Is not in list (101, 102, 103)` — selects everything except these three. ### **When should I use MQL and `NOT`?** When the query is more complex (multiple conditions, combinations of `AND/OR`) and you need precise control over the negation of the entire query. ### **How does `NOT` work in MQL with a simple example?** `ITEM_ID != 43` is the same as `NOT(ITEM_ID = 43)`. `NOT` selects all items that **do not** meet the condition. ### **Where do I write `NOT`?** In the **Custom MQL query** section. Put the original query in parentheses `()` and write `NOT` before it. ### **Why are parentheses important?** They ensure that `NOT` negates exactly the part you intend. With `AND/OR` combinations without parentheses, you risk getting a different result than expected. ### **Can I use an inverse query to hide everything except exceptions?** Yes. You can use the inverse query in a hide rule, so only the items matching the original (non-negated) query will remain in the output feed. ### **Can I do this without knowing MQL?** Yes — for simple cases, using opposite operators in the query interface is enough. MQL with `NOT` is useful when you need to negate more complex condition combinations. --- ## [How does data regeneration and updating work in Mergado?](https://help.mergado.com/en/mergado-editor/working-with-data/basic-components/how-does-data-regeneration-and-updating-work-in-mergado/) # **How does data regeneration and updating work in Mergado?** ## **Why it is important to regenerate data** When you modify rules, filters, or queries in Mergado, or when the input data from your online store changes, it is important for these **changes to actually make it into the output feed** that you send to **advertising channels**. **Data regeneration** is the mechanism that ensures **changes from the data source reach Mergado Editor and that edits in the editor are reflected in the output data** flowing to the target platforms. Thanks to this mechanism, you gain control over what actually appears in your advertising. ## **What types of data updates take place in Mergado** ### **1. Applying rules** After you make changes in a project (manual edits to selected products, creation of new rules, modification of existing rules), you need to confirm these changes by clicking the ***Apply rules*** button. At that moment, the changes based on your edits are performed **only within Mergado**, and you can review them on the **Products** page. When applying rules, **no new data is loaded from the input feed, and the rule changes are not reflected in the output feed**. Changes are propagated to the output feed (and thus sent to the target advertising platforms) only during data regeneration (whether automatic or manual). * **When to use:** If you want to verify the impact of a rule on products and check that the rule is set up correctly, without changing the output data and having the changes appear on the target platform (e.g. on Heureka or Google). * **How to trigger:** In the specific project, on the Rules page, click the ***Run processes manually*** button and then select ***Apply rules***. ### **2. Applying rules only to watched products** A somewhat faster and more specific way to verify changes that a new or modified rule makes is **applying rules only to watched products**. In this mode, Mergado again applies rules only within Mergado (without loading new input data and without exporting data to the output feed), but this time only to selected products where you want to monitor changes. * **When to use:** If you are working on a **specific change (e.g. only for a certain category) and want to see the effect quickly without waiting for the entire feed**. It is an ideal **diagnostic tool** for understanding how individual rules change element values for individual products. This option is also ideal when your feed contains thousands of products but the rules only affect some of them, and bulk application to all items in the feed would take unnecessarily long. Applying rules to watched products will save you a lot of time. * **How to trigger:** In the specific project, first select the products you want to watch. On the **Products** page, for the selected product, click the **Rule walkthrough** tab. Here, check the **Watch product during rule walkthrough** checkbox. Repeat this for all products you want to watch. On the **Rule walkthrough** tab, you can also directly trigger the application of rules to watched products by clicking ***Run rule application***. On the Rule walkthrough page, you will then see a **list of all rules that modify data for the given product**, including the original and resulting state. By checking the **Highlight differences** checkbox, specific changes will be color-highlighted. You can also trigger the application of rules to watched products on the **Rules** page. Here, click the ***Run processes manually*** button and then select ***Apply only to watched***. Similarly, you can start the process on the **Settings** page, in the **Regeneration** tab, where in the **Apply rules only to watched items** section, click the ***Apply only to watched*** button. After the rule application to watched products is completed, a list of all watched products is displayed at the bottom of the page. You can click on individual items, which will take you to the Watched products page where you can immediately review the changes that took place. ### **3. Regenerating changed items** When you decide to push the changes through to the advertising platform, you need to synchronize the data. This means Mergado loads new data from the input feed, then applies rules only to products that changed since the last regeneration, and sends this updated data to the output feed (and thus to the target platform). * **When to use:** If you want the **changes to go "live" and be reflected in the output feed as quickly as possible**. At the same time, you may not want to fully regenerate the entire feed because of just a few minor changes. You will appreciate this especially if your feed contains thousands of products, where a complete regeneration could take a longer time. This regeneration method is the fastest and most efficient. * **How to trigger:** In the specific project, on the **Rules** page, click ***Run processes manually*** and then select ***Regenerate changed***. You can also trigger this process on the **Settings** page. Here, click the **Regeneration** tab and in the **Regenerate project** section, click the ***Regenerate changed*** button. ### **4. Regenerating everything** This is the same process as in the previous point, but in this case the synchronization is performed on all data. Mergado again loads new data from the input feed, then applies rules, and sends the updated data to the output feed. During this process, Mergado processes and updates all items completely, including those whose output values do not change after processing. This regeneration method naturally takes significantly longer, especially if you have a large feed. * **When to use:** If you want to update products that have not changed since the last regeneration as well. You might want this, for example, when errors occurred during the last regeneration, some data was not updated, or other non-standard situations occurred. A complete feed regeneration can help resolve these issues. * **How to trigger:** In the specific project, go to the **Settings** page. Click the **Regeneration** tab and in the **Regenerate project** section, click the ***Regenerate all*** button. ### **5. Importing input data** Mergado **downloads the latest source data from the input feed and updates the internal data in Mergado**. During this process, rules are not applied and the output feed is not affected. * **When to use:** If **changes have occurred in your input data** (e.g. you added new products, prices changed) and you want to make edits in Mergado on this new data. At the same time, you do not want the new input feed data to be immediately reflected in the output feed as well. * **How to trigger:** In the selected project, go to the **Settings** page. Navigate to the **Regeneration** tab and in the **Regenerate project** section, click the ***Import input data*** button. ### **6. Exporting output data** Mergado **exports the current data to the output feed**. During this process, current data is not downloaded from the input feed, and rules are not applied. If you want the export to include rules and edits you previously made, you need to first confirm the changes by clicking ***Apply rules***. * **When to use:** If you want changes you made in Mergado to immediately appear on the advertising platform (e.g. before launching a campaign), but at the same time you do not want to reload the input feed (e.g. due to a limited number of downloads on the online store platform side). * **How to trigger:** In the selected project, go to the **Settings** page. Navigate to the **Regeneration** tab and in the **Regenerate project** section, click the ***Run export*** button. ### **7. Automatic regeneration by Mergado** Mergado **automatically performs regeneration several times a day** to keep your output feed data always up to date. This **automatic synchronization** follows the same process as **regenerating changed items**. Only what has changed since the last regeneration is automatically regenerated (not the entire feed). #### **When does automatic regeneration occur?** After creating a project, the automatic data regeneration function starts running and **does not need to be enabled manually**. Regeneration occurs several times a day and primarily depends on changes in the input feed -- the more frequently the input feed data changes, the more frequently Mergado regenerates to keep the output feed as current as possible. #### **How to disable or re-enable automatic regeneration?** If you are **making extensive changes to the feed and do not want to risk automatic regeneration starting during your work** -- which would push incomplete or untested changes into the output feed -- you can easily pause automatic regeneration and re-enable it when the time is right. In the project where you are making changes, go to the Settings section. Click the **Regeneration** tab and in the **Scheduled regenerations** section, click the ***Pause regeneration*** button to temporarily stop automatic data synchronization. Once you have finished the necessary feed adjustments, simply re-enable automatic regeneration in the same place by clicking the ***Allow regeneration*** button. #### **How to schedule automatic data regeneration?** If you do not want Mergado to schedule regeneration on its own and want full control over the process, you can simply set up regeneration for specific times. 1. In the selected project, go to the **Settings** page. Click the **Regeneration** tab and navigate to the **Regeneration settings** section. 2. Click the ***Edit*** button. In the **Manual** section, you can set **up to 6 time slots** for project regeneration. The minimum interval between individual slots must be **at least 2 hours**. 3. Then select the **time zone** and click ***Save***. If you want to switch manually configured regeneration back to automatic, go back to the Regeneration settings section, click ***Edit***, then ***Automatic***, and confirm by clicking ***Save***. #### **How to find out when a project was regenerated?** You can easily check how often a specific project is being regenerated in the History tab. Here you can monitor individual processes, and in the **Event type** column, you can select and **filter the specific type of regeneration you want to track**, e.g. Product import, Rule application, or Product export. History also distinguishes between **scheduled regeneration** (within manual or automatic settings), e.g. Scheduled product import, and **one-time manually triggered regeneration**, e.g. Product import. ## **FAQ** ### **What does "regeneration" mean in Mergado?** Regeneration is a process in which Mergado loads current data from the input feed, applies your rules and edits, and sends the updated data to the output feed. It ensures that your advertising channels (e.g. Heureka, Google, or Facebook) display correctly edited and up-to-date information. ### **What is the difference between "applying rules" and "regeneration"?** * Applying rules takes place only within Mergado. Mergado modifies data according to your rules, but the changes are not pushed to the output feed. * Regeneration transfers these edits "live" to the output feed, which is downloaded by advertising platforms. In other words: "Apply rules" is essentially a testing step, "Regenerate" means publishing changes to the output feed. ### **When should I use "Apply rules"?** When you want to verify how rules affect products without immediately publishing these changes to the output feed. For example, when testing new conditions or checking whether a rule works correctly. ### **When should I use "Apply rules only to watched products"?** Use this feature when you need to test the impact of rules on specific products or categories only, without processing the entire feed. It is an ideal way to quickly find out whether rules work as expected. ### **What does "Regenerate changed" mean?** During this process, Mergado: 1. Loads current input data. 2. Applies rules. 3. Updates only products that have changed since the last regeneration and sends the updated data to the output feed. This is the fastest and most common way to update data, suitable for daily data synchronization, for example. ### **What does "Regenerate all" mean?** During this process, Mergado: 1. Loads current input data. 2. Applies rules. 3. Updates all products in the feed, not just those affected by changes. This regeneration method takes longer but is suitable after extensive rule changes, when you suspect errors occurred in the previous regeneration, or when you need certainty that all data has been reprocessed from scratch. ### **What is "Import input data" for?** During this process, the current version of your input feed is downloaded into Mergado, but rules are not applied and data is not exported to the output feed. Use this step when you want to first work with new data in the editor (e.g. test rules) but do not yet want the changes to appear in your advertising. ### **What is "Export output data" for?** During this process, current data from Mergado is exported to the output feed, which advertising systems then download. During a standalone export, new input data is not imported and rules are not re-applied. The data is processed as it currently exists in Mergado. Use this step, for example, when you want to manually trigger an output feed update before launching a campaign but do not want to reload the entire input feed. ### **How often does automatic regeneration occur?** Automatic regeneration occurs several times a day, depending on the activity in your input feed. If the feed data changes frequently, Mergado regenerates it more often. If you want full control over the timing, you can set it manually and choose up to 6 time slots per day. ### **Can I schedule regeneration for a specific time?** Yes. For the selected project, in Settings -> Regeneration -> Regeneration settings, click the *Edit* button. Choose the *Manual* option and here you can select up to 6 time slots per day (with a minimum interval of 2 hours). Confirm by clicking *Save*. This determines when your project will be automatically regenerated. ### **How do I pause and re-enable automatic regeneration?** On the Settings page, go to Regeneration. In the Regeneration settings section, click the *Pause regeneration* button, which will temporarily disable automatic data updates. When you want to resume the process, simply click *Allow regeneration* in the same place. You will find this feature useful, for example, during major data modifications when you do not want unfinished changes to be pushed to the output data. ### **How do I find out when the last regeneration took place?** For the selected project, go to the Overview page. Here you will see when the last import, rule application, export, and output feed access occurred. If you want to find out when these processes took place further in the past, go to the History page for the selected project. Here you will find all project events, including the type of process, date, and time of their execution. ### **Can I work on other projects during regeneration?** Yes. Regeneration runs in the background on Mergado's server, so you can switch between projects, tabs, or even close the browser. The process will not be interrupted, and you can later check its status on the History page. ### **Can regeneration be sped up?** Partially. Regeneration will be faster, for example, if you choose Regenerate changed, where only products with changes are processed, instead of Regenerate all, where the entire feed is processed. You can also speed things up by setting up rules efficiently -- meaning, if possible, use one rule for the desired modification instead of two or more. However, the overall regeneration duration is most affected by the feed size. ### **Can I regenerate only some products or a specific product?** Technically yes, but you need to be careful during the process. If you mark certain products as watched, then set up a rule, apply it only to these watched products, and then use the Regenerate changed option, the changes will indeed only affect the watched products. However, during this process you must not make any other changes to other products, because when you trigger Regenerate changed, those additional changes would also be pushed to the output feed. ### **Can I cancel or stop a regeneration in progress?** Yes. If you started a regeneration but want to cancel it during the process, simply click the *Cancel* button. The process will terminate immediately, and if the regeneration did not complete fully, the output feed will not be updated. ### **How soon after regeneration do changes appear in the output feed?** Changes appear in the output feed immediately after regeneration is completed. Platforms such as Heureka or Google Merchant Center then fetch data from this feed according to their own schedule. ### **How do I know that regeneration has completed?** On the History page for the project, you can see a list of all completed processes, including the date, time, type, and result. Here you can verify that regeneration has indeed taken place. --- ## [Streamline Product Data with Mergado Master Feed](https://help.mergado.com/en/mergado-editor/working-with-data/advanced-workflows-and-feed-management/how-to-streamline-product-data-management-with-master-feed/) # **Streamline Product Data with Mergado Master Feed** Do you advertise the same products on multiple advertising platforms and want to avoid making the same edits and setting identical rules for each project over and over? Create one Master Feed and use it as **the data source for all your individual projects**. It lets you make **shared changes in bulk, just once**. You will save a lot of time and effort, and then only need to fine-tune each project for the specifics of its target advertising platform. **Master Feed serves as your central product data source.** It is where you clean up, unify, and prepare your data so it becomes an ideal foundation for all the advertising platforms you use. ## **Why and When to Use Master Feed** Master Feed makes your work easier whenever you want to send **one product feed to multiple advertising platforms**. In Mergado, this means you have several projects under one online store for different advertising platforms (e.g., Google, Facebook, Heureka, Zbozi, Glami, and others), and all of them use the same data source. This shared data source can be the Master Feed. In it, you **make adjustments and set rules that apply to all advertising platforms just once**, without repeating the same tasks in each individual project. Simply create a **new project under the same online store to serve as the Master Feed**. Use your product data as the input (e.g., the product feed generated by your online store), and then **use the output feed as the input feed for all other projects** created for individual advertising platforms. ## **Examples of Master Feed Usage** ### **1. Inconsistent or Incomplete Product Feed Data** Many advertising platforms **have similar or identical requirements for what information individual elements should contain**. For example, Heureka, Zbozi.cz, and Glami all require product names to include the manufacturer's name. If your product feed is missing this information in the product name, you only need to **set up one rule in the Master Feed to fix it**, rather than configuring the rule separately in projects for Heureka, Zbozi, and Glami. Similarly, almost all advertising platforms require or recommend having correctly filled-in EAN codes. You add or fix EANs just once in the Master Feed, and the codes automatically propagate to all platform-specific projects. You can also use the Master Feed to bulk-add missing product parameters (sizes, colors, etc.) that are often required for certain product categories. This is typically the case for Heureka, Zbozi, GLAMI, FAVI, Biano, or Google Shopping. ### **2. Product Feed Contains Products You Do Not Want to Advertise** Does your product feed **include items you do not want to advertise on ad platforms** (e.g., very cheap products, low-margin items, out-of-stock products, accessories, etc.)? Hide them once in the Master Feed, and the products will be hidden across all related projects. ### **3. Setting Shipping Rates for All Advertising Platforms at Once** Set up **carriers and shipping rates just once in the Master Feed**, and the settings will apply across all related projects. If you want to add or remove carriers or change their prices in the future, you only need to make the change in the Master Feed. ## **How to Create a Master Feed** 1. You create a Master Feed in Mergado the **same way as any other project**. Follow this guide. 2. As the **input feed**, use a product feed that contains **as much product information as possible** (name, price, image, important parameters). This can be, for example, the product feed generated by your online store. 3. As the **output format, choose the same format as your input**. (For example, if you used a product feed that your online store generates for Heureka as the input, also choose Heureka format as the output.) 4. Give the project **an appropriate name** so you can immediately tell it is a Master Feed (e.g., *your-shop.com – Master Feed*). 5. In the Master Feed, **set up rules** and make the general, foundational product data edits that should **apply to all advertising systems** you want to advertise on (e.g., adding manufacturers to product names or setting up shipping). 6. Then (under the same online store) **create individual projects for your chosen advertising platforms**. For all of them, use **the output feed from the Master Feed as the input feed**. Set the output format based on the advertising platform each project is for. After that, just make platform-specific adjustments in each project as needed. ## **How to Immediately Push Master Feed Changes to Related Projects** Mergado **automatically** evaluates how often data needs to be updated and **regenerates (updates) data several times a day** (usually within one to three hours). You do not need to worry about this process. However, if you want to see your changes in the feed immediately, you can regenerate data manually. After making changes in the Master Feed, go to the **Rules** page, click ***Run processes manually***, and then select ***Regenerate changed***. Repeat the same steps for the related projects. ## **How to Check Which Projects Use Your Master Feed** You can easily check which projects use the Master Feed as their input feed. 1. In the **project that is the Master Feed**, go to the **Settings** page. 2. Under **General project settings – Basic information**, click the down arrow next to the **Output feed** field. 3. A **list of projects** that use the **Master Feed as their input feed** will appear. You can click through directly to any of them. Similarly, you can verify whether a specific project uses a Master Feed as its input. 1. In the **project** you want to check, go to the **Settings** page. 2. Under **General project settings – Basic information**, click the **down arrow** next to the **Input feed** field. 3. The project whose **output feed you used as input here** will appear. You can click through directly to that project (the Master Feed). ## **How Master Feed Affects Mergado Pricing** Master Feed is an additional project, which means it increases the total number of output products for your online store. This may **affect the price of using Mergado**. For example, if your product feed has over 3,000 items and you advertise on three different advertising platforms (meaning you have three different projects), you have around 9,000 output items total. This puts you in the Basic plan. With a Master Feed, the number of output items increases to 12,000, which means moving to the higher Standard plan. Before implementing a Master Feed, keep in mind that it may affect the price of using Mergado. Although Mergado costs may increase slightly, the **investment pays off through enormous time savings and more efficient product feed management**. More information about [pricing](https://www.mergado.cz/cenik) is available in the article Changing the online store plan. ## **Conclusion** Master Feed works as the "central base" for editing your product data. Instead of making the same edits for each advertising channel separately, you make them just once in the Master Feed, from where they automatically distribute to all related projects. This lets you focus on fine-tuning individual advertising platforms without wasting time on duplicate work. The result is time savings, cleaner data, fewer errors, faster workflows, and more room for strategy instead of routine. > **Tip!** We recommend implementing the Master Feed right at the start of your product data management, ideally before you begin creating individual related projects. This ensures a smooth data flow and minimizes the likelihood of errors and confusion between projects.* ## **FAQ** ### **What is Master Feed and what is it for?** Master Feed is a central data source you use as the foundation for projects that share the same product data. It lets you edit shared data just once and then use the modified output as input for projects targeting individual advertising platforms (e.g., Heureka, Zbozi.cz, GLAMI, Facebook). This way, you avoid repeating the same edits in each project separately. ### **When does it make sense to use Master Feed?** Master Feed is useful whenever you send the same product data to multiple advertising platforms. Typically when you have several projects under one online store (e.g., Heureka, Zbozi.cz, GLAMI, FAVI, Google Shopping) and all use the same input feed. Master Feed works well as one shared base where you make common edits just once. ### **How does Master Feed save me time and effort?** All general and foundational edits are done in just one project – the Master Feed. You do not need to individually update names, parameters, EAN codes, or shipping settings in separate projects for each platform. Changes from the Master Feed automatically propagate to all related projects that use the Master Feed's output as their input. ### **What types of edits should I make in the Master Feed?** In the Master Feed, you set up rules and make edits that should be common across all advertising platforms. These include, for example: * adding manufacturers to product names, * fixing or adding EAN codes, * adding missing parameters (sizes, colors, etc.), * hiding products you do not want to advertise, * setting up carriers and shipping rates. ### **Why is it beneficial to make certain edits in the Master Feed?** Because many advertising platforms have similar or identical requirements for product feeds. For example, Heureka, Zbozi.cz, and GLAMI require the manufacturer name in product titles, and most platforms recommend or require correctly filled-in EAN codes. With Master Feed, you add or fix this information just once, and the changes automatically reach all related projects. ### **Can I hide products I do not want to advertise in the Master Feed?** Yes. If your product feed includes items you do not want to advertise (e.g., very cheap products, accessories, very low-margin items, or out-of-stock products), you can hide them in bulk in the Master Feed. The hiding will then apply across all connected projects. ### **Can I set shipping rates for all platforms at once in the Master Feed?** Yes. You set up carriers and shipping rates in the Master Feed just once. The settings apply across all linked projects. If shipping rates change in the future, you only need to update them in the Master Feed. ### **How do I create a Master Feed in Mergado?** You create a Master Feed just like any other project: 1. Create a new project in Mergado. 2. Use a product feed containing as much product information as possible (e.g., a product feed generated directly by your online store) as the input. 3. Choose the same format as your input for the output. 4. Give the project a name that makes it easy to distinguish from other platform-specific projects (e.g., "your-shop.com – Master Feed"). 5. Set up rules and make general edits that are common across all platforms you want to advertise on. 6. Then create individual projects for specific advertising platforms and use the Master Feed's output feed as their input. ### **Do I still need to configure anything in the platform-specific projects?** Yes. In those projects, you only make edits specific to the given platform, such as category mapping or element adjustments according to the particular system's requirements. General edits are already done in the Master Feed. ### **How quickly do Master Feed changes appear in other projects?** Mergado regenerates (updates) data automatically several times a day. However, if you want changes to appear immediately after editing the Master Feed, you can regenerate data manually: 1. In the Master Feed, go to the *Rules* page. 2. Click *Run processes manually*. 3. Select *Regenerate changed*. 4. Repeat the same steps in the connected projects. ### **How do I find out which projects use the Master Feed as their input?** In the Master Feed project: 1. Go to the *Settings* page. 2. Under *General project settings – Basic information*, click the down arrow next to the *Output feed* field. 3. A list of all projects that use the Master Feed as their input will appear. You can click through directly to individual projects. ### **How do I verify that a specific project uses data from the Master Feed as its input?** In the specific project: 1. Go to the *Settings* page. 2. Under *General project settings – Basic information*, click the down arrow next to the *Input feed* field. 3. The project whose output feed is used as the input feed here will appear. ### **Does Master Feed affect the price of using Mergado?** Yes, it may affect the final price. Master Feed represents an additional project that increases the total number of output items for your online store. The total output item count determines the price of using Mergado. Example: * If your product feed has approximately 3,000 items and you have three projects in Mergado (for three different advertising platforms), you have around 9,000 output items total (Basic plan). * Adding a Master Feed increases the count by another 3,000 items, bringing the total to approximately 12,000 output items, which means moving to the higher Standard plan. Before implementing a Master Feed, check your total output item count. ### **When is the best time to create a Master Feed?** Ideally right at the start of your product data management – before you begin creating individual projects for advertising platforms. This ensures a smooth data flow and minimizes the risk of errors. ### **What is the main benefit of Master Feed?** Master Feed lets you make routine data edits just once, centrally and efficiently. This saves you an enormous amount of time that you would otherwise spend repeating the same operations across individual projects. It also significantly reduces the risk of errors that often arise from manual, duplicate work. Fewer errors ultimately mean advertising cost savings as well, because you prevent shortcomings that could negatively affect campaign performance. With Master Feed, you can focus on strategy and fine-tuning details instead of technical routine. --- ## [Rules in Mergado Editor](https://help.mergado.com/en/mergado-editor/rules/what-are-rules-in-mergado/rules/) # **Rules in Mergado Editor** ## **What are rules?** Rules are **one of the most important tools in Mergado Editor**. Using specific rules, queries, and elements, you can modify data according to your needs or the requirements of comparison shopping engines, marketplaces, websites, supplier applications, or other platforms. **Rules are divided into four groups:** * Rules created by the Editor (e.g., Conversion Mergado XML [CZ] -> Heureka.cz – product [CZ]) * Extension rules (e.g., Bidding Fox - INPUT) * User rules (e.g., Change color parameter) * Manual changes rule Different types of rules can be modified in different ways. For example, rules created by MERGADO cannot be copied — you can only delete them. On the other hand, user rules can be disabled, duplicated, or deleted. ## **What do I see on the Rules page?** **!|771x392** The **Rules** page can be divided into several sections: 1. **Search** Here you can search for rules by name, specific type, or the element they work with. You can also filter to show only active rules. 2. **Rule list** Here you can see the rules that are continuously applied in your project. Some rules are created by us or by applications. 3. **Apply rules** A button that allows you to change data only within the Editor. It does not regenerate data into the output feed. 4. **New rule** Use this button to create a new rule. If you already have a rule created in another project, you can import it using the option — import rule. 5. **Rule editing options** * **Reorder** – Allows you to reorder rules. Note that order matters. See below. * **Disable** – Disables a specific rule * **Edit** – Opens the rule editor * **Duplicate** – Copies the rule. The duplicate is placed below the original. * **Delete** – Deletes the rule * **Schedule** – Schedules the rule for a specific time ## **How to create a new rule?** **!|710x363** 1. Enter a name 2. Select the rule type 3. Choose query/queries 4. Select the element to be modified 5. Enter the new content Note: The rule form changes depending on the rule type. For example, the Rewrite rule looks different from the Data file import rule or the Set shipping rates rule. **!|760x389** ## **List of rules** **Mergado offers a wide range of rule types**. The names indicate what you need to do with the given element or query. For example, if you need to hide a product because the supplier no longer provides it, use the **Hide product** rule. If you need to set up shipping, use the **Set shipping rates** rule. **List of rules:** * Rewrite * Bulk copy values * Set shipping rates * Set product parameters * Bulk rewriting by query * Bulk rewriting by values * Add days to date * Calculation * Letter case converter * Rename categories in bulk * Add a value to a multi-value element * Data file import * Hide product * Remove parameter values * Remove accents and diacritics * Find and replace * Round numbers * Strip HTML tags * Truncate value * Set UTM parameters * Merging variants * Cost per click pricing You can find instructions on how to use individual rules in their dedicated articles. ## **Good to know** ### **Order** **The order of rules matters**. Rules are applied **from top to bottom**. Each rule has a number indicating its position in the rule application sequence. This means you can also work with data that has already been modified by previous rules. ### **Extensions** **Extensions from the Mergado Store create rules**. You cannot disable, edit, or duplicate these rules. You can only delete them. If you need to process data in an extension first and then work with it in the Editor, you can change the order of the extension's rule. ### **Rules can be imported** Rules can also be imported from another project. Using the *Import rule* button, a simple form lets you choose which online store and project you want to import from. This is useful when you already have a sophisticated rule created in another online store and don't want to build it from scratch. **!|771x394** ### **Applying rules** Applying rules is only part of the full data regeneration process. Applying rules only **changes the data within Mergado**. The data will only appear in the output feed after a complete regeneration. Applying rules is useful, for example, when you need to check or test your modifications before actually generating the output feed. ### **Applying rules only to watched products** Mergado also allows you to apply rules **only to watched products**. You can set up product watching in the product detail under the **Rule walkthrough** tab. Once you do this, you can use the ***Apply rules*** option — ***Apply only to watched*** to apply rules only to watched products. **This speeds up the review or testing process** for a specific product when your feed contains a large number of products. **!|662x281** ### **Schedule a rule** You can also schedule a rule. The **rule scheduler** can be found in the Schedule section of each rule. **The rule scheduler allows you to set times when a rule should be applied or when it should be skipped.** For example, you can set a rule related to a time-limited discount campaign to be applied only within a specific date range (e.g., Black Friday or before Christmas), or simply over the weekend. **!|781x395** ## **Summary** Rules in Mergado represent a way to apply **bulk modifications** to products. Individual rules can be applied to all products in your feed, but much more often rules are used in combination with [queries](/c/napoveda/produkty-a-vybery-produktu), which allow you to specify which products a particular rule should apply to. Tip: You can create a rule on the ***Rules*** page by clicking the **CREATE RULE** button. Tip 2: Watch the **video tutorial** on working with rules: https://youtu.be/CQ6y5v7UdE8 ## **FAQ** ### **What are rules?** A rule is a tool for modifying data. ### **How many rules does the Editor offer?** Many. Each serves its own specific purpose. Just follow a simple guideline: if you want to rewrite something, use the Rewrite rule; if you need to modify data in bulk or for multiple values, choose a bulk rule. ### **What does applying rules do?** Applying rules only changes data within the Editor. A full regeneration is required to export the data. ### **In what order are rules applied?** From top to bottom. --- ## [Rule: Rewrite](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-rewrite/) # **Rule: Rewrite** The rule is used to modify the values of any element, such as product names, categories, descriptions, and many more. With the Rewrite rule, you can completely replace values, enrich them, or remove parts of them. ## **Extra features** * Smart paste mode \- bulk copy and paste values, for example from Google Sheets * In the **New value** field, you can enter: * text * a variable, for example: `%g:brand%` * a combination of text \+ variable, for example: `%g:price%` CZK * an empty value * Option to add multiple rows * Row order matters \- rules are applied from top to bottom ## **Practical examples** ### **Example 1 – Enriching product names** Enriching product names with additional information (brand, parameters). **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Rewrite** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. **5. Enter the new value:** * In the **New value** field, enter a combination of variables separated by spaces. For example, `%brand% %title% %size% %material% %color%` **6. Naming the rule:** * In the last step, enter the **rule name**, for example: *Enriching product names*. ### **Example 2 – Filling an empty element** Filling an empty required element with a value: * **A:** insert text (for example: a specific manufacturer) * **B:** insert a variable (for example: manufacturer) * **C:** combination of text and variable (sale price with currency) **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Rewrite** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. * **Choosing the element to change:** * In the **Element** field, select the element you want to modify. * **Enter the new value:** * In the **New value** field, enter * a text value, for example: a specific manufacturer (Nike) * a variable, for example: `%manufacturer%` * a combination of variable and text, for example: `%g:price%` CZK * **Naming the rule:** * In the last step, enter the **rule name**, for example: *Filling empty elements*. ### **Example 3 – Removing the value from an element** Removing the value from an element (deleting the element value). **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Rewrite** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. **5. Enter the new value:** * Leave the **New value** field empty. This will delete all values of the selected element. **6. Naming the rule:** * In the last step, enter the **rule name**, for example *Delete element*. ## **FAQ** ### **What exactly is the Rewrite rule for?** The rule is used to **fully modify the content of any element** in the feed. It allows you to either **completely rewrite** the value, **enrich it with new information** (e.g., add a brand, parameters, text), or **delete it**. ### **Can I use the Rewrite rule to add information to the product name, such as the brand and color?** Yes. In the **"New value"** field, enter a combination of variables, e.g.: `%brand% %title% %color%`. Mergado will automatically insert the corresponding values from each product's elements. ### **What happens if one of the variables used has no value?** If the element is empty, Mergado will **skip it** during the rewrite. If an empty variable is in the middle of a string, two spaces may remain between neighboring variables. You can easily fix this with the Find and Replace rule -- enter two spaces ( \_ \_ ) in the "Find" field and leave a single space ( \_ ) in the "Replace" field. ### **What is the difference between text and a variable in the "New value" field?** **Text** is fixed content that is written exactly as you type it (e.g., "Nike" or "Special offer"). **Variable** is a reference to the value of another element, e.g., `%manufacturer%` or `%g:price%`. ### **How do I set up a rule if I want to completely delete an element's value?** Create a new rule of the **Rewrite** type, select the relevant element, and **leave the "New value" field empty**. This will remove the value from this element for all products the rule applies to. ### **Can I rewrite the value only for selected products?** Yes. In the **"Query"** field, choose whether the rule applies to **all products** or only to a **selected product query**. The query can be based on brand, category, or price, for example. ### **What is smart paste mode?** **Smart paste** mode allows you to **bulk copy and paste** multiple values (e.g., columns from Google Sheets or Excel) directly into the rule table. Mergado automatically splits the pasted values correctly by rows and columns. ### **How does row order work in the Rewrite rule?** The order matters -- Mergado processes rows **from top to bottom**. If two rows modify the same element, the **result from the last (lowest) row** is used. ### **How do I check if the rule was applied correctly?** After saving and applying the rules or regenerating the feed, open the product preview and check whether the values changed as expected. For a detailed check of a specific product, you can enable the "Rule walkthrough" feature, which shows how individual rules progressively modify the product's data. ### **Can I combine the Rewrite rule with other rules, such as Find and Replace?** Yes. However, keep in mind that rules are applied from top to bottom and their order matters. Remember that the Rewrite rule can completely or partially rewrite an element's value, so it is important to carefully consider its placement among other rules. ### **Can I use the same rule for categories or product descriptions as well?** Yes. The **Rewrite** rule can be used for **any element** -- e.g., `g:description`, `g:product_type`, `g:brand`, etc. The principle remains the same: select the element, enter the new value, and Mergado will write it. ### **Can I use the Rewrite rule to fill in a missing manufacturer?** Yes. In the **"New value"** field, enter either fixed text (e.g., "Nike") or the variable `%manufacturer%` if you already have this information in another element. The rule will then fill in the value for all products without a manufacturer. ### **What if I want to rewrite values only in empty elements without changing those that already contain data?** In that case, create a product query where the given element is empty and apply the **Rewrite** rule to it. ### **How does the Rewrite rule behave when inserting text with diacritics or special characters?** Mergado preserves diacritics and special characters; there is no need to remove them. If the system reports a format issue, you can use the **Remove diacritics** rule before the rewrite. ### **Is it possible to Rewrite multiple elements at once within a single rule?** Yes. List each element on a **separate row** of the rule. For example: the first row for `g:title`, the second for `g:description`, the third for `g:brand`. ### **Can I use this rule to set a value from another project or feed?** Not directly. The Rewrite rule works only with data **within a single project**. To import values from an external source, use the **Import data file (CSV / XML)** rule. ### **Can I schedule the Rewrite rule to run only on specific days or times?** Yes. In the rule settings, use the **"Timer"** feature. You can select **specific days of the week**, **time slots** (e.g., 08:00--12:00), or set a **one-time validity period from--to**. **Example:** You can activate the Rewrite rule only during a weekend campaign -- e.g., from Friday 18:00 to Sunday 23:59. ### **Can I add a custom note to the Rewrite rule?** Yes. In the **"Note"** field, you can add any text up to 2,000 characters. It is recommended for **internal comments** -- e.g., why the rule was created or what exactly it modifies. The note is not displayed in the feed; it is only for clarity within the project. --- ## [Rule: Bulk Rewriting by Query](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-bulk-rewriting-by-query/) # **Rule: Bulk Rewriting by Query** This rule allows you to completely rewrite element values based on pre-defined product queries. It can be used for automatically setting values for different product segments (e.g., setting prices, manufacturers, or labels). ## **Extra features** * Prefill left side -- loads values from the input feed for the selected element * Remove rows without values * New values can include: * plain text * a variable * an empty value ## **Practical examples** ### **Example 1: Set CPC value based on product queries** This example shows how to use the Bulk Rewriting by Query rule to set different CPC values for different product segments. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Rewriting by Query** option. **3. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be the `HEUREKA_CPC` element. **4. Product queries:** * In the left column in the **Query** field * from the Selectbox, choose prepared saved queries from the project, each on a separate row, or * click the Prefill left side button and Mergado will prefill all existing queries from the project in the left column * Delete the rows containing queries you do not want to use * 💡 **Tip**: This is useful when you want to use most of the existing queries in the project. * from the Selectbox, choose **Create new query** and create new **Product queries** for specific products you want the rule to apply to. **5. Enter the new value:** * In the right column, in the "New value" field, enter for each row: * a text value, for example: the specific CPC amount (`15`) * *You can also use a variable or combination of variable and text, but this is not suitable for our example* **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Set CPC". ### **Example 2: Set manufacturer based on queries** This example shows how to use the Bulk Rewriting by Query rule to automatically set different manufacturers for different product segments. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Rewriting by Query** option. **3. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be the `g:brand` element. **4. Product queries:** * In the left column in the **Query** field * from the Selectbox, choose prepared saved queries from the project, each on a separate row, or * click the **Prefill left side** button and Mergado will prefill all existing queries in the left column * Delete the rows containing queries you do not want to use * This is useful when you want to use most of the existing queries in the project. * from the Selectbox, choose **Create new query** and create new **Product queries** for specific products you want the rule to apply to. **5. Enter the new value:** * In the right column, in the "New value" field, enter for each row: * a text value, for example: the specific manufacturer (`Nike`) * *You can also use a variable or combination of variable and text, but this is not suitable for our example* **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Set manufacturer". ### **Example 3: Set the custom\_label element based on price ranges** This example shows how to use the Bulk Rewriting by Query rule to set custom\_label tags for different price ranges. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Rewriting by Query** option. **3. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be the `g:custom_label_0` element. **4. Product queries:** * In the left column in the **Query** field * from the Selectbox, choose prepared saved queries from the project, each on a separate row, or * click the Prefill left side button and Mergado will prefill all existing queries in the left column * Delete the rows containing queries you do not want to use * This is useful when you want to use most of the existing queries in the project. * from the Selectbox, choose **Create new query** and create new **Product queries** for specific products you want the rule to apply to. **5. Enter the new value:** * In the right column, in the "New value" field, enter for each row: * the text value of the new label for the given query, for example: label\_1 (`Heroes`) * *You can also use a variable or combination of variable and text, but this is not suitable for our example* **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Set g:custom\_label\_0". ### **Additional uses** * Set **custom\_label** based on margin levels * Add GPSR data (responsible person for placing on the EU market) to the feed * Set categories based on queries ## **FAQ** ### **What is the Bulk Rewriting by Query rule for?** This rule allows you to **automatically rewrite a single element with different values** for **different product queries**. You can use it, for example, to set **cost per click (CPC)**, **manufacturer (brand)**, or **labels (custom\_label)** for different product groups. ### **What is the difference between this rule and the standard Rewrite rule?** The **Rewrite** rule changes the value in different elements for **a single** Product query. The **Bulk Rewriting by Query** rule allows you to set **different values for different product queries** for **a single** element -- all within one rule. ### **How can I quickly load all existing queries into the rule?** Click the **"Prefill left side"** button. Mergado will automatically load all **saved product queries** from the project into the left column. You can then **delete the rows you do not want to use**. ### **What should I do if the query I need does not exist yet?** Choose the **"Create new query"** option directly in the **"Query"** field. This allows you to create a new **Product query** without leaving the rule editor. ### **Can I combine text and variables in the "New value" field?** Yes. In the **"New value"** field, you can use: * **text** (e.g., `Nike`), * **a variable** (e.g., `%brand%`), * or **a combination** (e.g., `%brand% -- new collection`). 💡 Most cases with this rule use plain text, but variables are supported. ### **What does the "Remove rows without values" function do?** This function automatically **deletes all empty rows** in the rule where the value in the **"New value"** field is missing. This keeps the rule cleaner and prevents slowdowns during evaluation. ### **What happens if a product falls into multiple queries?** Mergado processes rows **from top to bottom**. If a product matches multiple queries, the **value from the last matching row from the top** is used. Row order therefore affects the result. ### **Can I use the rule to set CPC for different product categories?** Yes. Create a separate query for each category (e.g., "Kitchen Appliances", "Mobile Phones") and in the **"New value"** field for each row, enter the corresponding CPC (e.g., `15`, `25`, `30`). This way, you can set **different CPC values** for different product segments. ### **How can I use this rule to set different manufacturers (brand) for different products?** Create product queries as needed (e.g., by name, category, or supplier). Then in the **"Element"** field, select `g:brand` and in the right column **"New value"**, enter the manufacturer names: * Query "Shoes" → value: `Nike` * Query "Backpacks" → value: `Osprey` * Query "T-shirts" → value: `Adidas`. ### **How do I use the rule to set labels (custom\_label) based on price ranges?** In the left column, create queries by price (e.g., `Price < 500`, `Price 500-1000`, `Price > 1000`). In the right column, in the **"New value"** field, enter the labels: * Query 1 → `label_low` * Query 2 → `label_medium` * Query 3 → `label_high`. This way, you assign dynamic labels to products based on their price. ### **Can I use the rule to remove a value for selected products?** Yes. If you leave the **"New value"** field empty for a row, Mergado will **delete** the given element for all products that belong to that query. ### **Can the rule be scheduled to run only on specific days (e.g., during a seasonal campaign)?** Yes. Using the **Timer**, you can specify when the rule should be active -- for example, **only on weekends** or within a **specific date range** (e.g., July 1--15). This is useful for temporary adjustments like **seasonal labels, promotional CPC**, or **promo brands**. ### **How do I know which queries the rule already uses?** All active queries used in the rule are listed in the left column. If you used the **"Prefill left side"** function, the complete list of all project queries is displayed here. You can manually delete or edit those you do not want to use. ### **What happens if I use an incorrect variable or an empty value in the "New value" field?** If Mergado does not recognize the variable, the element remains **unchanged**. Such a variable will have a **red background** instead of green, indicating an error or a non-existent element. An empty value, on the other hand, causes the element to be **deleted** (replaced with an empty string). It is recommended to test the rule on a smaller sample of products using the **Rule walkthrough**. ### **Can I change multiple elements at once with this rule?** No. Within a single "Bulk Rewriting by Query" rule, you can work with only **one selected element** (e.g., `g:brand` or `HEUREKA_CPC`). ### **How do I check if the changes were applied correctly?** After **saving and applying the rules or after regenerating the feed**, open the **product preview** or use the **"Rule walkthrough"** feature. You will see how the element value changes based on the selected queries and whether the new data was correctly written to the output. ### **Can this rule be used for adding GPSR data or other regulatory information?** Yes. Using queries, you can determine which products fall under specific regulations (e.g., cosmetics, food). In the **"Element"** field, select the relevant element (e.g., `g:responsible_person`) and in the **"New value"** field, enter the responsible person or entity. --- ## [Rule: Bulk Rewriting by Values](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-bulk-rewriting-by-values/) # **Rule: Bulk Rewriting by Values** This rule allows you to modify or completely rewrite element values based on values in another element. It can be used for automatic updating or assignment of values depending on values in other fields -- for example, when assigning Google categories based on online store categories. ## **Extra features** * Regular expression support * Bulk copy values, for example from Google Sheets * New values can include: * plain text * a variable * an empty value ## **Practical examples** ### **Example 1: Set Google categories based on online store categories** This example shows how to use the Bulk Rewriting by Values rule to set different Google categories based on the online store category element. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Rewriting by Values** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to search by:** * In the left column in the **Element to search in** field * from the Selectbox, select the element to search by * in our case, this will be the `product_type` element **5. Choosing the element to change:** * In the right column in the **Element to write to** field * from the Selectbox, select the element you want to write new values to * in our case, this will be the `g:google_product_category` element **6. Enter the search value:** * In the left column, in the "If element value contains:" field, enter for each row: * a text value, for example: the exact search value (`Gifts | Gifts for Women`) or a keyword (`Gifts`), or * click the Prefill left side button and Mergado will prefill all existing values in the left column * 💡 **Tip:** *You can also use a variable or combination of variable and text in the field, but this is not suitable for our example* **7. Enter the new value:** * In the right column, in the "This value will be written to the element" field, enter for each row: * a text value, for example: the selected Google category (`Arts & Entertainment > Party & Celebration > Gifts`) * 💡 **Tip:** For selected Mergado formats, Mergado can load values from the official category tree, simplifying category mapping. * 💡 **Tip:** *You can also use a variable or combination of variable and text in the field, but this is not suitable for our example* **8. Naming the rule:** * In the last step, enter the **rule name**, for example "Set Google categories". ### **Additional uses** * Rewrite output categories based on online store categories * Fill in **custom\_label** elements based on various parameters ## **FAQ** ### **What is the Bulk Rewriting by Values rule for?** This rule allows you to **change or rewrite values of one element** based on **values in another element**. More precisely, the logic works like this: If element A contains value X, then write value Z into element B. For example, you can set **Google categories based on online store categories** or fill in **custom\_label** tags based on parameter values. ### **What is the difference between rewriting by queries and by values?** * **By queries**: You determine which products to change using **your own saved product queries**. * **By values**: You determine what to change based on **specific values of another element** (e.g., text in a category, brand, parameters). The rule thus automatically identifies products by the content of the selected element. ### **How do I select which element to search by?** In the left column, select the element whose **values will be used to find matches** -- for example, `product_type`, `category_text`, or `PARAM|PARAM_NAME`. Mergado uses these values to decide which products should receive the new value. ### **How do I select the element to write new values to?** In the right column, select the element where the values will be written. For example, when mapping categories, select `g:google_product_category`. ### **Can I use partial text matching in the rule?** Yes. In the **"If element value contains"** field, enter just part of the text (e.g., "Gifts"). Mergado will then find all products where this value **appears anywhere in the text** of the element. For an exact match, enter the full text (e.g., `Gifts | Gifts for Women`). ### **How can I load all existing values from the element I want to search by?** Click the **"Prefill left side"** button -- Mergado will automatically load all existing values of the selected element from the input feed. You can then manually edit this list, remove unnecessary rows, or add new ones. ### **Can I use regular expressions for searching values?** Yes. After enabling the **"Regular expressions"** option, you can use advanced patterns (regex) for text searching. For example: * `^Gifts.*` → finds all values starting with the word "Gifts" * `.*Child.*` → finds all values containing the words "Child", "Children", etc. ### **What can I enter in the "This value will be written to the element" field?** In the right column, you can enter: * **text** -- e.g., `Arts & Entertainment > Gifts > For Women`, * **a variable** -- e.g., `%category%`, * or **a combination of both**, e.g., `%category% -- Extended set`. 💡 If you want to remove the value, leave the field empty. ### **What happens if a product does not match any of the conditions listed in the left column?** The product remains **unchanged** -- Mergado does not find a matching value for it and makes no modification. ### **How is row order evaluated in the rule?** Mergado applies the rule **from top to bottom**. If a product matches multiple conditions, the **value from the last matching row** is used. Therefore, row order affects the resulting element value. ### **How can I use the rule for mapping categories to Google categories?** * In the left column, select `product_type` or `CATEGORYTEXT`. * In the right column, enter the corresponding `g:google_product_category`. 💡 Mergado can load the **official Google category tree**, so you can select from the autocomplete the correct categories by keyword. ### **Can this rule be used to fill in values other than categories?** Yes. The rule can be used for **any value pairing** between elements -- e.g.: * assigning `custom_label` based on margin, * filling in `shipping_label` based on country, * filling in `condition` based on text in the product name. ### **Can I use this rule to remove element values?** Yes. If you **leave the field empty** in the right column, Mergado will **delete** the corresponding values from the given element. This is useful, for example, when cleaning incorrect or duplicate data. ### **How can I check if the rule was applied correctly?** After **saving and applying the rules or after regenerating the feed**, open the **product preview** or use the **Rule walkthrough**. This feature shows how individual values change after the rule is applied and allows you to verify the correctness of assignments. ### **Can the rule be scheduled to run only on specific days (e.g., for seasonal categorization)?** Yes. Using the **Timer** feature, you can specify specific days, hours, or date ranges when the rule should be active. 💡 Example: Activate the rule only during a seasonal sale period -- e.g., from December 1 to 15. ### **What happens if I accidentally enter a wrong element name or non-existent variable?** If Mergado does not recognize the variable, it **will not write any value** and the row is skipped. Incorrect variables are highlighted with a **red background** in the interface. It is recommended to test the rule on a smaller sample of products using the **Rule walkthrough**. ### **How do I handle duplicate values in the left column?** If the same value appears multiple times, the **first occurrence from the top** is used. Mergado processes from the first row down -- subsequent matching expressions are ignored. ### **Can the rule be used for mapping parameters (e.g., converting parameter names to standardized ones)?** Yes. In the left column, select `PARAM|PARAM_NAME` and in the right column, again select `PARAM|PARAM_NAME` or another target element. This allows you to unify parameter names, e.g., "Size" → "Size", "Colour" → "Color". ### **Can I import values in bulk from a spreadsheet (e.g., Google Sheets)?** Yes. The rule supports **smart paste mode** -- you can copy value pairs (e.g., left and right columns) directly from Google Sheets. Mergado automatically splits the values correctly by rows and columns. ### **How do I use exact matching in the Bulk Rewriting by Values rule?** You can find instructions on our forum in the article How to use exact matching in the Bulk Rewriting by Values rule. --- ## [Rule: Find and Replace](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-find-and-replace/) # **Rule: Find and Replace** This rule finds text within an element's content and replaces it with another. ## **Extra features** * Case sensitivity * Regular expression support * Text, variables, and empty values can be used in the fields * Option to add multiple rows * Row order matters \- rules are applied from top to bottom ## **Practical examples** ### **Example 1: Remove information from an element** **Remove information from an element** -- promotional texts or dimensions from product names, links from product descriptions, unwanted texts or HTML characters from descriptions **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Find and Replace** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In this case, you can choose the element: `product description` or `product name` **5. Configuring additional options:** * If you need to distinguish between uppercase and lowercase, **check the option** "Case sensitive". * If you want to use **regular expressions** for searching, **check the option** "Regular expressions". **6. Enter the search text:** * In the **Find** field, enter the text to search for, a regular expression, or use the value of another element via a variable (e.g., `%size%`). * In our example, these could be: * `sale` * `XXL` * `www.my_eshop.com/accessories` * `

` * 💡 **Tip:** The rule allows you to add multiple rows (and therefore multiple find and replace conditions). Row order matters because Mergado evaluates the rows from top to bottom sequentially. **7. Enter the replacement text:** * Leave the **Replace** field empty. This way, Mergado will remove all found occurrences of the text -- replacing them with an empty value. **8. Naming the rule:** * In the last step, enter the **rule name**, for example *Remove promo texts from names* or *Clean up product descriptions*. ### **Example 2: Edit texts in elements** Edit texts in elements -- replace, supplement, or change format. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Find and Replace** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. * 💡 **Tip:** This rule is unique in that even when using the All products query, it does not throw an error if the search term is not found in a particular product. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. **5. Configuring additional options:** * If you need to distinguish between uppercase and lowercase, check the option **Case sensitive**. * If you want to use regular expressions for searching or replacing, check the option **Regular expressions**. **6. Enter the search text:** * In the **Find** field, enter the text you want to replace, a regular expression, or use the value of another element via a variable (e.g., %size%). * In our example, you can use: * `couch` * `CZK` * `Summer campaign` * `/` **7. Enter the replacement text:** * In the **"Replace"** field, enter the new text, a regular expression, or use the value of another element via a variable (e.g., `%size%`). * In our example, this could be: * `sofa` * `EUR` * `Back to school` * `>` * 💡 **Tip:** You can combine multiple "Find and Replace" rules for different purposes -- e.g., one for currency, another for campaign names. **8. Naming the rule:** * In the last step, enter the **rule name** of your choice, for example *Edit product names* or *Change currency format*. ### **Example 3: Swap information within a single element** Swap information within a single element -- move the first paragraph after the second in a product description **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Find and Replace** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. **5. Configuring additional options:** * If you need to distinguish between uppercase and lowercase, check the option **Case sensitive**. * Check the option **Regular expressions** so you can use them in the search. **6. Enter the search text:** * In the **Find** field, enter the following regular expression: `^(.*?)\n\n(.*)$` * This regular expression splits the text into the first and second paragraphs, separated by an empty line `(\n\n)` **7. Enter the replacement text:** * In the **Replace** field, enter the following value: * `\2` `\1` **8. Naming the rule:** * In the last step, enter the **rule name** of your choice, for example *Swap information within a single element*. ## **FAQ** ### **What is the Find and Replace rule for?** This rule allows you to **find specific text in an element's content and replace it with another text**, variable, or empty value. You can use it for **editing, supplementing, or removing text** in names, descriptions, categories, and other elements. ### **Can I use this rule to remove text, links, or HTML tags from a product description?** Yes. In the **"Find"** field, paste the text or HTML element you want to remove (e.g., `

` or `www.my_eshop.com`). Leave the **"Replace"** field empty. Mergado will then **remove** all found occurrences of these texts from the element. ### **What does "Case sensitive" mean?** If you check this option, Mergado distinguishes between lowercase and uppercase letters. For example, searching for `SALE` will not find `sale`. If unchecked, the search is case-insensitive. ### **What is the "Regular expressions" option for?** When enabled, you can use **regular expressions (regex)** -- patterns for advanced text searching and editing. For example, for swapping paragraphs, replacing numbers, removing multiple spaces, or reformatting data. **Example:** the expression `^(.*?)\n\n(.*)$` splits text into the first and second paragraphs. ### **What if I want to replace multiple different texts at once?** You can add **multiple rows** to the rule -- each with a different "Find" and "Replace" combination. Mergado processes them **from top to bottom**, so if some expressions overlap, their order determines the result. **Tip:** Place simpler expressions in the first rows and more complex ones (e.g., regular expressions) at the end. ### **How can I replace a certain word with another?** In the **"Find"** field, type the original text (e.g., `couch`) and in the **"Replace"** field, type the new text (e.g., `sofa`). The rule will then replace all found words in the selected element. ### **Can I use a variable in the Find and Replace rule?** Yes. You can enter **variables** in the **"Find"** or **"Replace"** fields -- for example, `%size%` or `%brand%`. Mergado will then substitute the corresponding element value for each product. ### **What happens if the expression I am searching for does not exist in some products?** Nothing happens -- the rule is skipped without an error. The product remains unchanged. This is useful, for example, when you use the rule with the **"All products"** query, but the search term only appears in some of them. ### **How can I remove multiple spaces that appeared after editing text?** Use the **Find and Replace** rule with a regular expression: * **Find:** `\s{2,}` (two or more spaces) * **Replace:** (one space) This will consolidate excess spaces after removing texts or empty variables. ### **Can I use this rule to swap the order of paragraphs in text?** Yes. Use the regular expression: * **Find:** `^(.*?)\n\n(.*)$` * **Replace:** `\2` `\1` This swaps the first and second paragraphs. **Tip:** The rule works best when there is an empty line (double `\n\n`) between paragraphs. ### **What is the difference between using text and a regular expression?** Text search works with exact matches (e.g., searches for an exact word or phrase). Regular expressions allow you to **search for patterns** -- e.g., all numbers, email addresses, tags, or anything between two characters. For more complex edits, regex is more suitable. ### **What does it mean that the rule is applied from top to bottom?** Mergado processes all rows of the rule in the order they are listed -- **from top to bottom**. If the first row modifies the text, the second row already works with the modified version. This allows chaining multiple edits but requires careful planning of the order. ### **How can I replace, for example, the currency "CZK" with "EUR" or remove slashes from a string?** In the **"Find"** field, type `CZK` (or `/`) and in the **"Replace"** field, type `EUR` (or leave it empty if you want to remove the character). You can also create multiple rows -- one for currency, another for other edits (e.g., campaigns or text formatting). ### **Can the Find and Replace rule be combined with other rules, such as Rewrite or Remove diacritics?** Yes. However, keep in mind that rules are applied from top to bottom and their order matters. Remember that the Find and Replace rule can completely or partially rewrite an element's value, so it is important to carefully consider its placement among other rules. ### **How do I check if the edits were applied correctly?** After saving and applying the rules, or **regenerating the feed**, check the result directly in the output feed or in the **product preview** on the Products page. For a detailed check of a specific product, you can use the **"Rule walkthrough"** feature, which shows how values change after each rule is applied. ### **Can I remove only part of the text within a single element?** Yes. In the **"Find"** field, paste the specific word or phrase you want to remove, and leave the **"Replace"** field empty. Mergado will remove only this text, and the rest of the element will remain unchanged. ### **What should I do if I need to remove HTML tags (e.g., `

`, `
`, ``) in large quantities from descriptions?** Use a regular expression that captures all HTML tags: * **Find:** `<[^>]*>` *(example regex; individual cases may require adjustments)* * **Replace:** *(leave empty)* This will remove all HTML tags, leaving only plain text. ### **Can the rule be used on numbers, prices, or parameters?** Yes. The rule can be used on any element that contains text -- including **numeric values**, **prices**, or **PARAM | PARAM\_VALUE**. For example, you can change the decimal separator, remove units, or add supplementary text. ### **What should I do if the regular expression behaves differently than expected?** Check that the **"Regular expressions"** option is enabled. If it is, verify the syntax -- for example, using an online tool like [regex101.com](https://regex101.com). **Tip:** For more complex expressions, test on a smaller sample of products first before applying the rule broadly. You can also contact our support team. ### **Can the rule be used to replace multi-line text?** Yes. Regular expressions can also work with paragraphs or line breaks (`\n`, `\r\n`). --- ## [Rule: Bulk Copy Values](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-bulk-copy-values/) # **Rule: Bulk Copy Values** This rule allows you to **copy values** from one element to another within Mergado Editor. Values are transferred from the **source element** to the **target element**. The rule can be used to copy multiple elements at once within a single rule. ## **Extra features** * Bulk copy values, for example from Google Sheets * Bulk structure copy * Left side prefill * Option to add multiple rows * Row order matters -- they are applied from top to bottom ## **Practical examples** ### **Example 1: Swapping values between two elements** This example shows how to use bulk copy values to swap values between two elements (e.g., between image and image\_alternative). **1. Creating a helper element:** * On the **Elements** page, click the ***"New element"*** button in the top right corner. * Create a helper element, for example *"helper\_element"*. * **Hide this element** using the toggle at the end of the row. **2. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **3. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Copy Values** option. **4. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **5. Choosing the source element:** * In the left column **Source element**, select the element **you want to copy values from**. * You can search for the element by typing part of its name in the **Source element** field. For example: `image` or `image_alternative`. **6. Choosing the target element:** * In the right column **Target element**, select the element **you want to paste values into**. **7. Adding another row:** * If you need to copy multiple elements at once, you can add more rows. * **Row order matters** -- the rule is applied **from top to bottom**. **8. Naming the rule:** * In the last step, enter the **rule name**, for example "Swap values between two elements". ### **Example 2: Copy multiple elements to different target elements** This example shows how to use bulk copy values to copy multiple elements (e.g., title, description, price) to different target elements (e.g., g:title, g:description, g:price). **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Copy Values** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the source element:** * In the **Source element** field, select the element **you want to copy values from**. * For example: `title`, `description`, `price`. **5. Choosing the target element:** * In the **Target element** field, select the element **you want to copy values to**. * For example: `g:title`, `g:description`, `g:price`. **6. Adding another row:** * If you need to copy multiple elements at once, **add more rows** for each source-target element pair. * **Row order matters**, as they are applied **from top to bottom**. **7. Naming the rule:** * In the last step, enter the **rule name**, for example "*Copy elements*". ### **Example 3: Copy selected parameters to other elements** This example shows how to use **bulk copy values** to transfer **parameters** from one element to another. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Copy Values** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the source element:** * In the **Source element** field, select the parameter whose values you want to copy. **5. Choosing the target element:** * In the **Target element** field, select the element (or enter the element path) you want to copy the parameter values to. **6. Adding another row:** * If you need to copy multiple parameters at once, you can add more rows to set up bulk copying of multiple parameters within a single rule. * Row order matters \- they are applied from top to bottom. **7. Naming the rule:** * In the last step, enter the **rule name**, for example "*Copy parameters*". ### **Example 4: Copy all parameters to other elements while preserving the name-value structure** This example shows how to copy all parameters to target elements while preserving the structure, i.e., the parameter name-value pairs. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Bulk Copy Values** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Using the special structure copy behavior:** * To copy all parameters to different elements, we use a special behavior called **"bulk structure copy"**. You do not need to list all parameter names individually -- just fill in three rows: * **Row 1:** Name of the wrapper (parent) element for parameters. * **Row 2:** Name of the element containing parameter names. * **Row 3:** Name of the element containing parameter values. **5. Choosing the source element on the first row:** * In the **Source element** field, select the wrapper (parent) element of the parameters you want to copy, e.g., `PARAM` **6. Choosing the target element on the first row:** * In the **Target element** field, select the wrapper (parent) element of the parameters you want to copy to, e.g., `g:attribute_detail` **7. Choosing the source element on the second row:** * In the **Source element** field, select the element containing parameter names you want to copy, e.g., `PARAM | PARAM_NAME` **8. Choosing the target element on the second row:** * In the **Target element** field, select the element you want to copy parameter names to, e.g., `g:attribute_detail | g:attribute_name` **9. Choosing the source element on the third row:** * In the **Source element** field, select the element containing parameter values you want to copy, e.g., `PARAM | PARAM_VALUE` **10. Choosing the target element on the third row:** * In the **Target element** field, select the element you want to copy parameter values to, e.g., `g:attribute_detail | g:attribute_value` **11: Naming the rule:** * In the last step, enter the **rule name**, for example "*Copy all parameters*". ### **Additional uses** * Remapping elements that the Converter did not handle. ## **FAQ** ### **What is the "Bulk Copy Values" rule for?** This rule allows you to **copy values from one element to another**. You can set up multiple copy operations within a single rule. You can use it for: * transferring values between elements (e.g., `title` → `g:title`), * duplicating content across multiple elements, * copying parameters into the structure required by a specific comparison shopping engine, * or bulk data transfer between feeds. ### **Can I copy multiple elements at once?** Yes. You can add multiple rows to a single rule, where each row represents a **source → target element** pair. 💡 Row order is important -- Mergado **applies them from top to bottom**. ### **What do "source" and "target" element mean?** * **Source element** -- the value is copied from it (e.g., `title`) * **Target element** -- the value is pasted into it (e.g., `g:title`) If the target element does not exist yet, you need to **create it on the Elements page** using the **"New element"** button. ### **Can I use this rule to swap values?** Yes. To **swap values between two elements** (e.g., `image` and `image_alternative`), follow these steps: 1. On the **Elements** page, create a helper element (e.g., `helper_element`) and then hide it. 2. Copy `image` → `helper_element`, 3. `image_alternative` → `image`, 4. and finally `helper_element` → `image_alternative`. 💡 After regenerating the feed, the values will have been "swapped". ### **Can this rule also do bulk structure copy?** The rule allows you to copy **entire sets of elements while preserving their hierarchy** (e.g., parameter names and values). Just enter three rows: 1. wrapper element (`PARAM` → `g:product_detail`), 2. element with names (`PARAM | PARAM_NAME` → `g:product_detail | g:attribute_name`), 3. element with values (`PARAM | PARAM_VALUE` → `g:product_detail | g:attribute_value`). Mergado automatically creates the corresponding structure in the target format. ### **When is structure copy useful?** For example, when exporting a feed to a platform that uses a different element format (e.g., Google vs. Heureka) and Mergado does not create it automatically. With structure copy, you do not have to manually map dozens of parameters -- the system does it automatically. ### **Can I copy product parameters with this rule?** Yes. The rule can transfer values between parameters, for example: `PARAM | PARAM_NAME` → `g:product_detail | g:attribute_name`. This is useful when converting a feed to another format or adding parameters missing in the target XML. ### **What happens if the target element already contains a value?** By default, the **existing value is rewritten** by the value from the source element. If you need to preserve values and only add new ones, use a different rule, such as **Add multi-value element value**. ### **Can I use variables or text edits when copying?** Not directly in this rule. The rule copies values **without modification**. If you need to edit values (e.g., add text, remove characters), use a combination with the **Rewrite** or **Find and Replace** rule. ### **Can the rule be applied only to certain products?** Yes. In the **"Query"** field, you can use saved queries or create new ones, e.g., for specific brands, price ranges, or categories. This allows you to copy values selectively for only part of the feed. ### **What if I want to copy only specific rows of an element (e.g., a specific parameter)?** In that case, you can use the **element path** with a condition, e.g.: `PARAM {PARAM_NAME="Color"} | VAL` This way, Mergado will copy only values that match the "Color" parameter. ### **How do I check if the copy was done correctly?** After **saving and applying the rules**: * go to the **Products** page and check a product that is part of the query in the copy rule, * or run the **"Rule walkthrough"** for a specific product -- you will see how the value was copied. or after **regenerating the feed**: * open the output feed and check the target element. ### **Can I use this rule to fix incompletely mapped elements after the Converter?** Yes, this is one of the most common uses. If the Converter did not create all elements as expected, you can use this rule to **supplement missing elements or remap** those that were not converted correctly. ### **Can the rule be scheduled (timer)?** Yes, you can enable a **timer** and have the rule run only on specific days or at specific times. ### **What are the most common mistakes when using this rule?** * Mixing up the copy direction (source and target element). * Using a non-existent element. * Not regenerating the feed after applying rules -- changes are not yet visible in the feed itself. * Row order -- copying is evaluated **from top to bottom**. 💡 Recommendation: Test the rule on a small sample of products first using the **Rule walkthrough**. ### **What if I need to transfer the structure of attributes or parameter names?** Use **bulk structure copy** (see Example 4). Mergado allows you to transfer even nested elements with their names and values, preserving the original `name -- value` relationship. --- ## [Rule: Hide Product](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-hide-product/) # **Rule: Hide Product** This rule completely hides a product from Mergado's output. ## **Extra features** * Unlike other rules, this rule does not require applying rules -- it hides products within Mergado immediately. However, this does not affect the output feed. To hide products from the output feed as well, you need to regenerate the feed. * Another specificity is that hiding rules are always placed at the end of the rule list, so they are applied last. ## **Practical examples** ### **Example 1: Hide all products from the output** This example shows how to temporarily hide all products from the output feed (for example: seasonal goods). **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Hide Product** option. **3. Selecting products to hide:** * In the **Query** field, choose the **All products** query. **4. Naming the rule:** * In the last step, enter the **rule name**, for example Hide products. ### **Example 2: Hide selected products** This example shows how to hide selected products from the output feed (for example: with low margin, sold out, too cheap, etc.). **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Hide Product** option. **3. Selecting products:** * In the **Query** field, create your own **Product query** for specific products you want the rule to apply to, e.g., products cheaper than 200 CZK (`g:price < 500`) * **💡Tip**: You can add multiple queries at once in the Query field. The hiding rule will then apply to all selected queries. **Naming the rule:** * In the last step, enter the **rule name**, for example Hide cheap products. ### **Example 3: Hide products without images** This example shows how to hide products missing an image URL from the output feed. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Hide Product** option. **3. Selecting products:** * In the **Query** field, create your own **Product queries** for specific products you want the rule to apply to, e.g., products missing an image URL (`g:image_link = ""`) * **💡Tip**: You can add multiple queries at once in the Query field. The hiding rule will then apply to all selected queries. **4. Naming the rule:** * In the last step, enter the **rule name**, for example Hide products missing image URL. ### **Additional uses** * Hide products with unavailable or low-quality images (requires the Feed Image Editor extension for detecting unavailable/low-quality images) ## **FAQ** ### **What is the Hide Product rule for?** The rule allows you to **temporarily or permanently hide products** from the output feed. A hidden product: * **continues to appear in the Mergado interface**, just marked as hidden * **is not exported to the output feed** (after feed regeneration). It is used for filtering seasonal goods, unavailable products, test items, or products with missing data. ### **How quickly does the rule take effect?** Immediately. Unlike other rules, it **does not require applying rules** -- products are hidden in the Mergado interface right after saving. 💡 For the change to also appear in the **output feed**, you need to **regenerate** the project. ### **In what order are hiding rules applied?** Hiding rules are always **automatically placed at the end of the rule list**. This ensures they are applied **after all other rules** (e.g., after name, price modifications, etc.). 💡 New changes are no longer applied to already hidden products. ### **Can the rule be applied only to a specific group of products?** Yes. In the **"Query"** field, you can: * select one of the existing queries, or * create a **custom product query**, for example: * products with a price \< 200 CZK (`g:price < 200`), * products without an image (`g:image_link = ""`), * products with availability `out_of_stock`. 💡 You can also add multiple queries at once -- the rule will apply to all of them. ### **How do I know if a product is hidden?** A hidden product is marked with an icon and a message **"product is hidden by rule"** in Mergado but does not disappear from the product list. When working with the product catalog, we recommend using the filter at the top of the page: **"Show - visible** (the catalog will display **only NON-hidden products)"** or conversely **"Show - hidden** (the catalog will display **only hidden products)"**. ### **Can hiding be undone?** Yes. You can: * **temporarily pause** the hiding rule itself, or * **permanently delete** it -- this will make all hidden products reappear in the feed. If you want to unhide only selected products, follow these steps: 1. Open the "Products" page. 2. Enable the "Show hidden products" filter, or manually search for the product. 3. Click the eye icon 👁️ on the right side of the product. ➡️ The product will immediately reappear in Mergado and, after feed regeneration, also in the output file. ### **Does hiding a product affect other rules?** No. Hiding rules are applied after all other modifications, so no other rules (e.g., Rewrite, Calculation, Round numbers) have any effect on a hidden product. ### **Can the rule be used for automatic hiding based on data (e.g., availability)?** Yes. Simply create a **conditional product query** -- e.g.: `availability = out_of_stock` and use this query in the **Hide Product** rule. With each feed regeneration, Mergado will automatically hide products that match the given condition. ### **Can the rule be scheduled using a timer (e.g., hide products only on weekends)?** Yes. At the bottom of the page, you can enable the **timer** and set when the rule should be active. For example: * Friday--Sunday: hide products (sale ended), * Monday--Thursday: products are shown again. ### **How do I verify that products were also hidden in the output feed?** After **regenerating the feed**, you can verify the result: * by opening the output XML/CSV file, or * using the preview in Mergado -- hidden products will not appear here. ### **Can the hiding rule be combined with others (e.g., Rewrite, Calculation)?** Yes, but only in reverse order. Hiding rules are applied **always last** -- after all modifications, calculations, and rewrites. This ensures that product hiding is not influenced by other rules. ### **How do I find out which rule is hiding my product?** On the Products page, find the specific product in the catalog, e.g., by ID or product name. For the product, switch to the Queries tab. The list shows all saved queries the product belongs to. On the right side, each query indicates whether it is used in any hiding rule, and if so, which one -- and you can click through directly to that rule. ### **How do I simply unhide a specific hidden product?** There is no unhiding rule in Mergado. The only way to unhide a hidden product is to exclude it from the query used in the hiding rule by modifying the query condition. An alternative is the special project feature called Product Approval. --- ## [Rule: Add a Value to a Multi-Value Element](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-add-a-value-to-a-multi-value-element/) # **Rule: Add a Value to a Multi-Value Element** The basic principle of this rule is that it adds another value to an existing element you select. ## **Extra features** How does the rule behave in different situations? If: * the element has no value yet \- a new value is added to the first position, so a multi-value element is not created: * `` `->` `new value` * the element has one value \- a new value is added to the next (second) position, creating a multi-value element: * `original valueA` `->` `original valueA` `new value` * the element already has multiple values (is already multi-value) \- a new value is added to the next available position: * `original valueA` `original valueB` `->` `original valueA` `original valueB` `new value` ## **Practical examples** ### **Example 1: Adding another alternative image URL** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Add a Value to a Multi-Value Element** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be `g:additional_image_link` **5. Enter the new value:** * In the **New value** field, enter * a text value, for example: a specific URL (https://www...) * a variable containing the stored value, for example: `%url%` * a combination of variable and text, for example: `https://www.my-shop.com/%image_handle%` **6. Naming the rule:** * In the last step, enter the **rule name**, for example: "Add alternative images" ### **Additional uses** * Add additional alternative categories. ## **FAQ** ### **What is the "Add a Value to a Multi-Value Element" rule for?** This rule allows you to **add a new value** to an existing element that supports multiple values (e.g., images, categories, or parameters). It is typically used to add additional image URLs (`g:additional_image_link`) or alternative categories. ### **How does the rule behave when the element has no value yet?** If the element has no value, Mergado **creates the first value** and the element is **not yet considered multi-value**. `` `→` `new value` ### **What happens if the element has one or more values?** * If it has **one value**, the new value is added to the **next position** and the element becomes multi-value. * If it has **multiple values**, the new value is added to the **first available slot** (i.e., as the next item in sequence). 💡 **Example:** `originalA` `→` `originalA` `new_value` ### **Can I add multiple values at once with this rule?** Not directly. Each rule adds **one value per row**. If you want to add multiple values (e.g., multiple image URLs), use multiple rules of this type. ### **What types of values can be added to the element?** In the **New value** field, you can enter: * **a text value**, e.g., `https://www.myshop.com/img123.jpg`, * **a variable**, e.g., `%url%`, * **a combination of text and variable**, e.g., `https://cdn.myshop.com/%image_name%`. ### **Can I add a dynamic value from another element with this rule?** Yes. If you want to add a value from another element, use its **variable** (e.g., `%g:image_link%`). Mergado will automatically fill in each product's value based on this variable during regeneration. ### **How do I know if my element is multi-value?** On the Elements page in the project, multi-value elements (e.g., `g:additional_image_link`) display the maximum number of values in parentheses, e.g., `(6x)`. Such elements can appear multiple times for a single product. You can find an overview in the documentation: Multi-value elements in Mergado. ### **Can the rule be used for purposes other than images?** Yes. The rule can be used, for example, for: * adding **additional categories**, * adding **alternative URLs**, * expanding **parameter lists** (e.g., adding a new parameter for products with a specific query). ### **Can the added value be limited to certain products only?** Yes. In the **"Query"** field, you can choose either **All products** or **create your own query**, for example, only for products of a certain brand, category, or with a missing image. ### **What happens if the element I want to add values to is missing from the feed?** The rule will **not create it automatically** -- you need to add it manually first: 1. Open the **Elements** page, 2. click on **New element**, 3. enter the element name (e.g., `g:additional_image_link`), 4. and confirm the creation. ### **Can value addition be scheduled?** Yes. If you want to add links only during a certain period (e.g., seasonal images), you can enable the **rule timer** and set specific days or hours when the rule should run. ### **How do I verify that the value addition was successful?** After **saving and applying the rules** or after **regenerating the feed**: * open the *Elements* page or the *Products* page, * check that the new value row has appeared, * or run the **Rule walkthrough** for a specific product -- it will show the rule's result in real time. ### **Can this rule replace an existing value?** No. The rule only **adds new values**; it does not modify or delete existing ones. If you need to overwrite values, use the **Rewrite** rule or **Bulk rewriting by query**. ### **What should you watch out for when using this rule?** * After adding the rule, always **regenerate the feed**. * If the values do not appear, check the product query and whether the element actually exists. ### **Can I add a value to an element that is not allowed in the output format?** If the target element is not supported in the format, Mergado will **not include it** in the output. In that case, you need to first adjust the **project output format** or create the element manually on the **Elements page**. ### **Can I use this rule to add images from an external spreadsheet (e.g., Google Sheets)?** Yes. If you have a spreadsheet with image links, you can import them into Mergado using the **Import data file (CSV / XML)** rule and then add them using this rule. This allows you to combine **external data** with **multi-value elements** in the feed. --- ## [Rule: Add Days to Date](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-add-days-to-date/) # **Rule: Add Days to Date** This rule writes a **date into the selected element that equals today's date plus the number of days you specify**. This way, you can always have, for example, an **up-to-date expected delivery date**. The rule is most commonly used for **Google formats**, specifically for **product availability** when the **`availability`** element contains the value **`preorder`** or **`backorder`**. In these cases, you also need to provide a **specific availability date**. ## **Extra features** * The rule can rewrite values for multiple queries * Output value preview \- for verification purposes * The resulting element value after applying the rule is a date: 2025-10-16T16:13:19 * Available formats: * **YYYY-MM-DD** \- Year-Month-Day (ISO 8601 standard) * **YYYY-MM-DDTHH:MM:SS** \- Date and time with "T" separator (e.g., 2025-06-24T12:46:12) * **YYYY/MM/DD** \- Year/Month/Day with slashes * **DD/MM/YYYY** \- Day/Month/Year (European format) * **MM/DD/YYYY** \- Month/Day/Year (American format) * **YYYYMMDD** \- Compact format without separators * **DD.MM.YYYY** \- Day.Month.Year * Unix timestamp \- Number of seconds since January 1, 1970 (for systems and APIs) ## **Practical examples** ### **Example 1: Setting expiration\_date and availability\_date elements for Google feeds** This example shows how to easily set the **expiration date** (`expiration_date`) and **availability date** (`availability_date`) when a product has the value `preorder` or `backorder` in the feed. In these cases, you must provide a **specific date**, otherwise the Google feed will be incomplete. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Add Days to Date** option. **3. Choosing the element to change:** * In the **Element** field, select the element **where the resulting date should be written**. * In our case, this could be [`[expiration_date]`](https://support.google.com/merchants/answer/12471622) or `[availability_date]` **4. Choose the date format:** * From the list, select the following format suitable for Google: **YYYY-MM-DDTHH:MM:SS** **5. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** if you want to apply the rule only to certain products (e.g., g:availability \= `preorder`) **6. Enter the number of days to add:** * In the **"How many days to add"** field, enter the number of days you want to add to today's date. * For example: `5` means the resulting date will be today \+ 5 days. **7. Check the result:** * The **"Output value preview"** column shows the resulting value that will be written to the output feed. * For example: `2025-10-21T16:13:19`. **8. Naming the rule:** * In the last step, enter the **rule name**, for example *"Set availability date for preorder products".* ## **FAQ** ### **What is the Add Days to Date rule for?** The rule automatically writes into the selected element a **current date shifted by the specified number of days**. It is most commonly used to set values like `availability_date` or `expiration_date` in Google feeds -- typically for products with the value *preorder* or *backorder*. ### **In what situations is this rule most commonly needed?** It is primarily used for: * filling in required dates in Google feeds, * ensuring the availability date is always current, * automatically extending dates (e.g., `expiration_date` \+ 30 days). ### **What date format should I use for Google Merchant feeds?** The recommended format for Google is: **`YYYY-MM-DDTHH:MM:SS`** Example: `2025-06-24T12:46:12` This format includes both date and time and complies with the ISO 8601 standard required by Google. ### **Can I choose a different date format?** Yes. Mergado supports various formats, for example: * `YYYY-MM-DD` (e.g., 2025-10-16) * `DD.MM.YYYY` (e.g., 16.10.2025) * `YYYY/MM/DD` * `YYYYMMDD` * or `Unix timestamp` (e.g., 1739625600) 💡 This is useful for exports to systems that use their own date formats. ### **What does the "How many days to add" field mean?** In this field, enter the **number of days by which today's date should be shifted**. E.g.: * Value `+5` → today's date \+ 5 days * Value `0` → today's date The result is immediately shown in the *Output value preview* column. ### **Can the rule be used for multiple queries at once?** Yes. The rule supports **application to multiple product queries simultaneously**, so you can set different time shifts for different product groups (e.g., preorder \+5 days, backorder \+14 days). ### **Can I use this rule to overwrite an existing date in an element?** Yes. If the element (e.g., `availability_date`) already contains a value, the rule will **replace it with the newly calculated date**. ### **Can adding days be combined with other rules, such as Calculation or Rewrite?** Yes. It is typically used in combination with the **Rewrite** rule if you need to fill in empty elements first, or with the **Calculation** rule if you want to adjust the value dynamically based on another element. 💡 Recommended order: first fill in / adjust the data, then apply "Add Days to Date". ### **How do I check if the date was actually written to the feed correctly?** After **saving and applying the rules** or after **regenerating the feed**: * view the output feed and check the `availability_date` or `expiration_date` element, * or run the **"Rule walkthrough"** feature for a specific product -- you will see both the original and new date values. ### **Can I use a time component (hours, minutes, seconds)?** Yes. In the `YYYY-MM-DDTHH:MM:SS` format, you can also set a specific time. For example, `2025-10-21T08:00:00` ensures the product is marked as available starting exactly at 8:00 AM. ### **What happens if I enter a negative value (e.g., \-2)?** An error message will appear. The rule cannot work with negative numbers in the days field. You can only enter positive numbers (0, 1, 2, ...). ### **What are the most common mistakes when using this rule?** * Incorrect date format (e.g., missing time component for Google feeds). * Writing to the wrong element (`availability` instead of `availability_date`). * Entering too high a number (e.g., \+999), which can result in a date outside a realistic range. 💡 It is recommended to test the rule on a smaller sample of products. ### **Can I add days based on values from another element (e.g., based on stock availability)?** No. ### **Is it possible to use this rule outside of Google feeds?** Yes. Although it is most commonly used for Google Merchant feeds, you can use it in **any format** that works with dates -- for example, for exports to ERP systems or custom XML structures. --- ## [Rule: Cost Per Click Pricing](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-cost-per-click-pricing/) # **Rule: Cost Per Click Pricing** This rule allows you to **set individual cost-per-click (CPC) prices** for individual products. The rule is designed for managing and optimizing **click bids** within comparison shopping engines such as **Heureka** and **Zbozi.cz**. The click price can be calculated in two ways: * **a fixed amount** added to the minimum CPC value for the given product, * or **a percentage of the selling price excluding VAT**. ## **Extra features** * The rule is available for the following formats: * Heureka * Zbozi.cz ## **Practical examples** ### **Example 1: Set click prices as a fixed amount** This example shows how to set click bids based on a **fixed amount** added to the minimum CPC set by the shopping engine. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Cost Per Click Pricing** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Set click bids based on:** * From the **Selectbox** *Set click bids based on*, select the **"Minimum click price"** option. * The shopping engine sets a **minimum click price** for each category. * The click bid is calculated by adding the amount you enter in the next step to this minimum price. **5. Add to minimum CPC:** * In the **Add to minimum CPC** field, enter the amount to be added to the minimum click price, for example `10` * 💡 Tip: This way, you can easily increase the bid for all products in a certain category by the same amount. **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Set CPC". ### **Example 2: Set click prices as a percentage of the product price** This example shows how to set click bids based on a **percentage of the product price excluding VAT**. The calculation automatically takes into account the minimum and maximum CPC limits set by the shopping engine. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Cost Per Click Pricing** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Set click bids based on:** * From the **Selectbox** *Set click bids based on*, select the **"Percentage of product price"** option. * The click bid will be set as a **percentage of the product price excluding VAT**. * If the product **does not contain VAT information**, the **standard VAT rate** is used for the calculation. * The calculation also takes into account the **minimum and maximum limits** for click prices set by the shopping engine. **5. Percentage of product price:** * In the **Percentage of product price** field, enter a number (0-100) that will be used to calculate the click price, for example `10` * A value of 10 means that CPC = 10% of the product price excluding VAT. * 💡 Tip: This setting is suitable for products with different price levels -- higher product price leads to higher CPC, lower price leads to lower CPC. **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Set CPC". ### **Additional uses** * Bulk setting of click prices based on different product queries. * Combination with the "Import data file" rule (e.g., for importing historical CPC values from other systems). * Automatic CPC adjustments based on margins or product performance (in combination with Pricing Fox extension or calculation rules). ## **FAQ** ### **What is the "Cost Per Click Pricing" rule for?** This rule allows you to **set individual CPC (Cost Per Click) bids** for products in comparison shopping engines such as **Heureka** or **Zbozi.cz**. Using this rule, you can determine whether CPC should be calculated as a fixed amount added to the minimum CPC or as a **percentage of the product price excluding VAT**. ### **Which formats is this rule available for?** The rule can only be used for the following formats: * **Heureka.cz** * **Zbozi.cz** 💡 If you need to work with CPC for other comparison engines, you can use the **Calculation** or **Import data file** rules, where CPC values can be managed individually. ### **What is the difference between "Minimum click price" and "Percentage of product price"?** * **Minimum click price** -- CPC is calculated as the *minimum value* set by the shopping engine **+ your specified fixed amount**. E.g., minimum CPC 3 CZK + add 2 CZK = resulting bid 5 CZK. * **Percentage of product price** -- CPC is calculated as a certain **percentage of the product price excluding VAT**, e.g., 10% of 1,000 CZK = CPC 100 CZK (subject to limits set by Heureka/Zbozi.cz). ### **What does the "Add to minimum CPC" field mean?** In this field, enter the **amount to be added to the minimum CPC value** set by the shopping engine. E.g., if you enter 10 CZK and the category's minimum CPC is 5 CZK, the resulting bid will be 15 CZK. ### **How does the "Percentage of product price" setting work?** Enter a numeric value between **0--100** that determines the percentage of the product price excluding VAT. E.g.: * Product costs 2,000 CZK excluding VAT * Entered percentage = 5 * 👉 The resulting CPC = 100 CZK If the product does not have a VAT value filled in, Mergado uses the **standard VAT rate** for the calculation. ### **How does the rule behave if the product falls into a category with CPC limits?** Mergado respects the **minimum and maximum CPC limits** set by the shopping engine (e.g., Heureka has limits for each category). This means that if the calculation exceeds the allowed limit, the system **automatically caps the CPC at the maximum allowed by the shopping engine**. ### **Can the rule be used only for a specific group of products?** Yes. In the **Query** field, you can use an existing product query or create your own -- e.g., * products with higher margins, * products above a certain price level, * products in a specific category. 💡 This allows you to manage CPC strategically based on performance or product segment. ### **What happens if the product does not have a price excluding VAT?** If there is no value in the price excluding VAT element (`price_vat` or `price_excl_vat`), Mergado uses the default value with the standard VAT rate (e.g., 21%). It is recommended to verify that the feed contains consistent price data. ### **Can the rule be used for bulk CPC changes across different queries?** No. The rule can be applied to multiple product queries -- but it assigns the same calculation method to all of them (e.g., 5% of price for one query and +10 CZK to minimum for another). If you need different logic for different queries, create a separate rule for each query. This creates an **automated pricing strategy** for different product segments. ### **How do I check if the new CPC value was applied correctly?** After **saving and applying the rules** or after **regenerating the feed**: * open the output feed and check the CPC element (`HEUREKA_CPC`, `ZBOZI_CPC`), * or use the **"Rule walkthrough"** feature, which shows how the CPC value was recalculated for a specific product. ### **Can the rule be combined with calculation rules or data imports?** Yes. You can combine it with, for example: * the **Calculation** rule -- for dynamically determining CPC based on margin or performance, * the **Import data file** rule -- for loading historical CPC or performance data from Google Sheets. 💡 Recommended order: first import or calculate the values, then create segments based on the results, and then apply "Cost Per Click Pricing". ### **What if I want to adjust CPC dynamically based on product performance?** In that case, we recommend connecting Mergado with the **Bidding Fox** extension, which allows dynamically adjusting CPC based on margins, conversions, or competition. ### **Can this rule be used to lower CPC?** No. ### **What happens if the product does not belong to any category with a minimum CPC?** Mergado will use the **default minimum CPC value** (defined by the shopping engine) or keep the original value if no reference data is available. ### **Can the rule be scheduled?** Yes. Using the **timer**, you can determine when CPC should be updated -- e.g., once a week or on a specific day. This is useful for campaigns that change based on seasonality or advertising calendars. ### **What are the most common mistakes when setting CPC in Mergado?** * Using the wrong calculation type (e.g., percentage of price but in a different feed format). * Missing price excluding VAT element. * Exceeding the maximum CPC value allowed by the shopping engine. * Incorrect rule order (e.g., applying before a calculation or price overwrite). 💡 Recommendation: Always test the rule on a smaller number of products using the **"Rule walkthrough"** feature after setup. --- ## [Rule: Data File Import (CSV / XML)](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-data-file-import/) # **Rule: Data File Import (CSV / XML)** Using the **Data File Import** rule, you can **import data from an external XML or CSV file** into existing items in your project. The file can be **uploaded directly** to the rule or you can provide a **URL address** from which data is regularly loaded. This way, you can enrich product data with, for example, **availability**, **performance statistics**, **margins**, or other supplementary information. ## **Extra features** * **Matching mode:** * **Key matches exactly** -- the matching element values are **identical** in both the source and Mergado. * The value from the imported file is loaded only when the import value **equals** the matching element value in the project. * Typically used for matching by **unique product ID**. * **Key is contained** -- the matching element values **partially match**. * The value from the imported file is loaded only when the matching value from the import **is contained** within the matching element value in the project. * Typically used for matching by **keyword in the name** or **categories** of a product. * **Supported file types:** * XML * CSV * Google Sheets (by publishing the Sheet as CSV at a public URL address) * **File connection method:** * **Upload file** -- one-time import. * If the data in the file changes, you need to **manually re-upload** the file. * **Enter URL** -- dynamic connection. * If the data in the file changes, **new values are loaded automatically** with each project regeneration. * **Field delimiter:** * Comma, semicolon, pipe -- depending on the format in the source file (comma is the default) ## **Practical examples** ### **Example 1: Import stock availability from a Heureka availability XML feed** This example shows how to use the **Data File Import (CSV / XML)** rule to enrich a standard product feed with **product availability** information from an external XML feed (e.g., Heureka). **1. Preparing the project before import** -- before the actual import, you need to prepare the project so the import works correctly * **Element names** you want to import (or column names in the CSV file) must **match** the element names in the project where you will write the data. * If you want to import an element that **does not exist in the project yet**, you need to **create it manually**: * Open the **Elements** page. * Click the **New element** button. * Enter the element name and confirm the creation. * Elements you will import into can be **hidden** -- their visibility does not affect the import. **2. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **3. Selecting the rule type:** * In the **Rule type** field, select the **Data File Import (CSV / XML)** option. **4. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **5. Data file source:** * Using the toggle (Radio button), select where the file should be loaded from: * **Enter URL** * In the **URL address** field, paste the address to the XML or CSV file (e.g., the Heureka availability feed URL). * Click the **"Import"** button. * Mergado automatically detects whether it is a **CSV** or **XML** and adjusts the rule interface accordingly. * **Upload file from computer** * In the **Data file** field, click the **"Upload file"** button and select the file from your computer (e.g., Heureka availability feed). * Mergado again automatically recognizes the format and adjusts the settings. * 💡 **Tip:** The maximum upload file size is **25 MB**. **6. Element bounding the item** (only for XML import): * In the **Element bounding the item** field, set the element that bounds the item in the XML file (typically this is SHOPITEM or ITEM), including the parent root element. * In our case, we will use: `item_list | item` **7. Matching element in the current project:** * Select the element from the current project in Mergado that you want to use for matching products with data from the imported file, for example, the product ID: `g:id` * 💡 **Tip**: If possible, select the matching element from the project's input feed. This allows faster evaluation and processing of the rule during project regeneration. **8. Matching element in the imported file:** * Select the element from the imported file that contains values corresponding to the selected matching element in the current project, e.g., the product ID attribute in the Heureka availability feed: `@id` **9. Match by input values:** * The **"Match by input values"** checkbox is **enabled by default**. * When active, data is matched by the **original values from the project's input feed** (before any Mergado modifications). * If you disable it, matching will use **values that may have already been modified by other rules**. * ⚠️ **Warning:** Disabling this option can **slow down data processing**. **10. Advanced settings:** * In the **Advanced settings** section, configure: * **Matching mode** using the Selectbox * In our case, we will use the **Key matches exactly** mode. * Whether to **distinguish between uppercase and lowercase** using the Checkbox * In our case, we will leave the checkbox unchecked. **11. Naming the rule:** * In the last step, enter the **rule name**, for example Import availability. ### **Additional uses** * One-time import of EAN codes or other values (for example: GPSR data or missing image URLs) * Connect dynamic values from Google Sheets to Mergado * Performance data from Google Analytics (clicks, impressions, orders) * Product seasonality * Stock levels * Import custom\_label for PPC * Import data for segmentation and setting custom\_label for PPC * Import purchase prices and margins for automatic pricing using the Pricing Fox extension * Import translations (if you have translations in another language in a different feed and need to bring them into Mergado) ## **FAQ** ### **What is the Data File Import rule for?** The rule is used to **import external data from XML or CSV files** into existing products in your Mergado project. This allows you to enrich the feed with information the original source does not contain -- e.g., **stock availability, margins, purchase prices, performance statistics, or dynamic labels for PPC campaigns**. ### **What file formats does Mergado support?** * **XML** (e.g., Heureka availability feed) * **CSV** (e.g., spreadsheet export from an internal system or ERP) * **Google Sheets**, if published as CSV at a public URL address 💡 The maximum upload file size is 25 MB. ### **What is the difference between uploading a file and entering a URL address?** * **Uploading a file** -- one-time import. If the data in the file changes, you need to manually re-upload it. * **Entering a URL address** -- dynamic connection. With each **project regeneration**, the current values from the external file are automatically loaded. 💡 Recommended for data sources that are regularly updated (e.g., availability, prices, performance). ### **What does "Element bounding the item" mean for XML imports?** This setting determines **which XML node represents an individual product**. E.g., in a Heureka feed it is `SHOPITEM`, in other XML feeds it can be `ITEM` or `PRODUCT`. In Mergado, it is written with the root element, e.g.: `item_list | item`. ### **How does product matching between the imported file and the project work?** Using **matching elements**: * In the current project, you select the element to match products by (e.g., `g:id`). * In the imported file, you select the corresponding element or attribute (e.g., `@id`). 💡 Ideally, the values of these elements should be **unique and identical** between the project and the file. ### **What is the difference between "Key matches exactly" and "Key is contained"?** * **Key matches exactly** -- the matching element values must be exactly the same (`123 = 123`). Used, for example, when matching by product IDs. * **Key is contained** -- matching occurs if the matching element value from the import is found **within the matching element value in the project** (e.g., `123` is contained in `SKU_12345`). Suitable for matching by part of text (e.g., name or category). ### **What is the "Match by input values" option for?** This option determines whether Mergado will use for matching: * **input values** from the source feed (default setting), or * **values after rule application** (if you disable the option). 💡 It is recommended to keep it enabled -- matching is more stable and faster. Disabling it can slow down project generation. Be careful, though, whether **the selected matching element from the project has input values**. If it does not, you need to disable this option, otherwise matching will not work. ### **What does the "Case sensitive" option in advanced settings mean?** When enabled, matching considers the difference between lowercase and uppercase letters. E.g., `ABC` does not equal `Abc`. If left unchecked (recommended), Mergado ignores the difference in letter case. ### **What happens if an element from the imported file does not exist in the project?** The import will not work until you **manually create the element** in the project (with the same name). On the **"Elements"** page, click **"New element"**, enter the name (e.g., `availability`), and confirm. The element can also be **hidden** -- visibility does not affect the import. ### **Can I import multiple values at once (e.g., availability, price, and EAN)?** Yes. The "Data File Import" rule allows importing multiple columns (CSV) or elements (XML) simultaneously, as long as they are correctly mapped. ### **How can I use the import for data from Google Sheets?** 1. In Google Sheets, click **File → Share → Publish to the web**. 2. Select the **CSV** format and copy the generated URL. 3. Paste this URL into the **"URL address"** field in the Data File Import rule. 4. With each regeneration, Mergado will load the current data from the Sheet. 💡 This way, you can connect, for example, dynamic labels, performance data, or daily prices. ### **How do I check that the data was imported correctly?** After **saving and applying the rules** or after **regenerating the feed**, you can: * open the **Products** page, find a specific product, and verify that the new data appeared in the relevant elements, * or use the **Rule walkthrough** feature, which shows how the data was matched and loaded. 💡 If values were not imported, check the element names and matching keys. ### **Can the rule be used for a one-time data import?** Yes. For one-time additions (e.g., EAN codes or GPSR data), you just need to upload the file manually. However, the rule must remain in the project; otherwise, the uploaded data will be deleted again. ### **Can the rule be used to import performance data from Google Analytics or other tools?** Yes, if you have the data available in CSV (or XML) format. An alternative solution is to use the Bidding Fox Elements extension, which loads this data into Mergado automatically. For example, you can import click counts, impressions, or orders by product ID. This way, you enrich the feed with performance metrics that can then be used to optimize bidding strategies. ### **What should I do if the import does not work correctly?** Check: 1. that the **file is accessible** (the URL is public, does not require login), 2. that it has the **correct UTF-8 encoding**, 3. that the **element/column names** match the names in the project, 4. and that the **matching** is correctly configured. 💡 For testing, you can upload a file with fewer items and verify that it maps correctly. ### **Can the import be used for automatic pricing (e.g., margins, purchase prices)?** Yes. Using the import, you can add, for example, **purchase prices** or **margins** to the feed, which you can then use in **Calculation or Round Number rules** for dynamic pricing. In combination with the **Pricing Fox** extension, you can even fully automate price adjustments. --- ## [Rule: Letter Case Converter](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-letter-case-converter/) # **Rule: Letter Case Converter** This rule allows you to change the letter case in feed elements. For example, you can convert product names written in all caps to normal formatting or unify the letter case in parameters. ## **Extra features** Choose from **6 letter case options**: * all lowercase * ALL UPPERCASE * Capitalize the first letter of sentences * Capitalize The First Letter Of Each Word * Capitalize first letter, keep the rest * Capitalize only the first letter of words with more than two characters ## **Practical examples** ### **Example 1: Convert product names written in all caps** This example shows how to change the letter case in product names. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Letter Case Converter** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element where you want to apply the change. * In our case, this will be the element: `g:title` **5. Choose the letter case:** * In the **Letter case** field, select the desired option. * In our case, we will choose **"Capitalize the first letter of sentences".** **6. Naming the rule:** * *In the last step, enter the **rule name**, for example "Change letter case in names".* ### **Example 2: Change the letter case for parameters for further use** This example shows how to change the letter case in parameter values so they can be added to product names afterward. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Letter Case Converter** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element where you want to apply the change. * In our case, this will be the element: `PARAM | PARAM_VALUE` **5. Choose the letter case:** * In the **Letter case** field, select the desired option. * In our case, we will choose **"all lowercase".** **6. Naming the rule:** * In the last step, enter the rule name, for example *"Change letter case for parameters"*. * **💡 Tip:** You can then use the modified parameters to enrich product names using the **"Rewrite"** rule. ### **Additional uses** * Convert product description texts to **all lowercase**. * Unify letter case in parameters or names for **consistent export to different feeds**. ## **FAQ** ### **What is the Letter Case Converter rule for?** The rule allows you to **unify text formatting** in any feed element. It can be used, for example, for: * fixing product names written in ALL CAPS, * converting description texts to lowercase, * unifying the format of parameters or brands, * preparing texts for further use (e.g., in the "Overwrite" rule). ### **What letter case options can I choose?** In the **"Letter case"** field, you can select one of these 6 options: 1. **all lowercase** -- e.g., *nike air zoom*, 2. **ALL UPPERCASE** -- e.g., *NIKE AIR ZOOM*, 3. **Capitalize the first letter of sentences** -- e.g., *Nike air zoom is a popular model.*, 4. **Capitalize The First Letter Of Each Word** -- e.g., *Nike Air Zoom Pegasus*, 5. **Capitalize first letter, keep the rest** -- preserves the original format after the first letter, 6. **Capitalize only the first letter of words with more than two characters** -- suitable for correcting texts with excessive capitalization. ### **Can I use this rule to fix names written entirely in uppercase?** Yes. Simply select **"Capitalize the first letter of sentences"** or **"Capitalize The First Letter Of Each Word"** in the **"Letter case"** field. Mergado will automatically convert the texts to a normal readable format (e.g., *ADIDAS WHITE SNEAKERS* → *Adidas white sneakers*). ### **Can the rule be applied to product parameters?** Yes. In the **"Element"** field, select `PARAM | PARAM_VALUE`. This allows you to change the format of parameter names in bulk, which you can then easily add to product names using the **"Rewrite"** rule. ### **Does the letter case change also affect values like EAN or product ID?** No. The rule **does not change numeric values** or codes, only text strings. Using it on fields containing identifiers (e.g., EAN, SKU, ID) is not recommended. ### **Can I apply the rule only to part of the text (e.g., the first word)?** Not directly. The rule changes the letter case across the entire element content. If you need to change the case of only part of the text, split the data into multiple elements or use the **"Find and replace"** rule with regular expressions. ### **What if I need different letter case formats for different product queries?** Create multiple "Letter Case Converter" rules and apply each to a different **Product query**. E.g.: * for brands: *Capitalize The First Letter Of Each Word*, * for descriptions: *all lowercase*. ### **Can the rule be used for SEO optimization (e.g., unifying brands)?** Yes. Using this rule, you can unify the format of brands, names, or categories, which contributes to data consistency in exports and better product indexing in search engines. ### **How do I check if the rule was applied correctly?** After **saving and applying the rules** or after **regenerating the feed**, check the result: * in the product preview, or * using the **Rule walkthrough** feature, where you can see exactly how the text changed. ### **Can the rule be combined with other rules?** Yes, it is very often used together with: * **Rewrite** -- for adding reformatted parameters to names, * **Find and replace** -- for removing unnecessary parts before the modification, * **Truncate value** -- for subsequently trimming text to the required length. --- ## [Rule: Merging Variants](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-merging-variants/) # **Rule: Merging Variants** This rule is designed for **converting multiple standalone products**, typically **product variants**, which form a group of items in the input feed linked (most commonly) by the **`ITEMGROUP_ID`** element. The rule allows you to **consolidate product variants** under a single main item (the so-called *Master product*), simplifying the feed and ensuring correct product presentation on e-commerce platforms or marketing tools. ## **Extra features** * Selection of shared elements (only for selected formats) * Left side prefill * Option to add multiple rows * The rule is available only for selected formats * Shoptet Complete and Supplier * Upgates Products * Woocommerce CSV * Shopify CSV * Samba.ai ## **Practical examples** ### **Example 1: Merging variant products from a Heureka feed for Shoptet** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Merging Variants** option. **3. Element for selecting the Master item:** * This field defines the element used to select the main (so-called *Master*) item. * Master item is the one under which all other variants will be grouped. * The system looks for the item that matches the logic of the chosen element -- e.g., for **`ITEM_ID`**, the item with the **lowest ID** is used as the main one. * **In our case, we will use:** `ITEM_ID`. * 💡 **Tip:** The Master item represents the product that will be visible as the main product after merging. The other variants remain attached but are no longer listed individually. **4. Element with the grouping code:** * This element determines **how variants are identified** as belonging together. * The element must contain the **same value for all variants** of one product. * The most commonly used element is **`ITEMGROUP_ID`**. * **In our case, we will use:** `ITEMGROUP_ID`. * 💡 **Tip:** The code in the grouping element must be **identical** for all variants of one product. For example, all variants of a T-shirt in different sizes (S, M, L) will have the same `ITEMGROUP_ID`. **5. Parameters forming the product variant:** * In the Selectbox field **Parameters forming the product variant**, select all parameters that define the product variants, e.g., Color, Size, etc. * **💡Tip:** The field is multiselect, so you can select multiple parameters. **6. Maximum number of parameters forming the variant:** * In the Selectbox field **Maximum number of parameters forming the variant**, choose how many parameters will define the variant, e.g., 2. **7. Selection of shared elements:** * In the **"Advanced settings"** section, select elements that are **common to all variants** of the given product. * These elements will be written **only to the main (Master) item** after merging, while the variants **will no longer repeat them**. * For example: `CATEGORYTEXT, DESCRIPTION, IMGURL` * In the **"Element"** field (left column), select from the Selectbox the element you want to set as shared for all variants. * To add more elements, add new rows. * In the **"Action type"** field (right column), determine **how Mergado should handle different values during merging**: * **Take from Master item** * Only the value from the main item is used; other values are discarded. * Example: `CATEGORYTEXT` or `DESCRIPTION`, because the values are the same for all variants. * **Merge values and remove duplicates** * Mergado takes all **unique values** of the selected element and merges them into a list. * Example: `IMGURL`, because variants may have different image URLs and you want to keep all of them. * **💡Tip:** This section is available only for merging variants in XML feeds (Shoptet, Upgates, Samba AI). * **💡Tip:** Mergado selects the elements automatically; you only need to review the settings. **8. Naming the rule:** * In the last step, enter the **rule name**, for example *"Merge variants".* ## **FAQ** ### **What is the Merging Variants rule for?** The rule allows you to **consolidate multiple product variants into a single main product (the so-called Master product)**. It is primarily used when variants in the feed (e.g., different colors, sizes, or dimensions) appear as standalone products and need to be grouped under a single product. ### **Which formats is the rule available for?** The rule can only be used for selected formats that support working with variants: * **Shoptet (Complete and Supplier feed)** * **Upgates Products** * **WooCommerce CSV** * **Shopify CSV** * [**Samba.ai**](http://Samba.ai) If you need support for another format, write to us at mergado@mergado.cz ### **What does the "Master item" element mean and how is it determined?** The Master item is the **main product** under which all variants are grouped. In the *Element for selecting the Master item* field, you choose the element (e.g., `ITEM_ID`) used to determine which variant will be the main one. Typically, the item with the **lowest ID** or the first occurrence in the feed is selected. ### **What is the element with the grouping code for?** This element (most commonly `ITEMGROUP_ID`) determines **which products belong to the same variant group**. All variants of one product must have the same code in this element -- e.g., a T-shirt in sizes S, M, L will have the same `ITEMGROUP_ID`. ### **What happens if some products do not have an `ITEMGROUP_ID`?** Such products **will not be merged** because Mergado cannot identify which items belong together. It is recommended to check beforehand that the `ITEMGROUP_ID` element exists and contains values for all variants. ### **How do I set the parameters that form the product variant?** In the **"Parameters forming the product variant"** field, select all attributes by which variants differ -- e.g., *Color*, *Size*, *Material*. The field supports **multiselect**, so you can select multiple parameters at once. ### **What is "Maximum number of parameters forming the variant" for?** It determines how many parameters will be taken into account when grouping variants. E.g., if variants have two properties (color and size), set the value to **2**. This ensures Mergado correctly groups parameter combinations. ### **What does the "Selection of shared elements" section do?** It is used to specify elements that are **the same for all variants** and should be kept only in the Master product. E.g., `CATEGORYTEXT`, `DESCRIPTION`, or `BRAND`. These values are saved only in the main product so they are not unnecessarily repeated for each variant. ### **What is the difference between "Take from Master item" and "Merge values and remove duplicates"?** * **Take from Master item:** only the value from the main product is used (others are ignored). Typically used for texts or categories. * **Merge values and remove duplicates:** combines all unique values from all variants, e.g., images (`IMGURL`). ### **Can the rule be used for products without variants?** Yes, but it has no effect -- products without a grouping code (`ITEMGROUP_ID`) remain unchanged. The rule is applied only to items that meet the shared code condition. ### **What happens if variants have different values in an element that should be shared?** It depends on the selected action: * If **"Take from Master item"** is chosen, Mergado keeps only the Master product's value. * If **"Merge values and remove duplicates"** is chosen, Mergado combines all values into a single list and removes duplicates. ### **How do I check if the variant merging was done correctly?** After **saving and applying the rules** or **regenerating the feed**: * Open the output feed and check that products were correctly grouped under one Master product. ### **Can the rule be used to merge variant images?** Yes. Using the **"Merge values and remove duplicates"** setting, you can combine image URLs from all variants into a single `IMGURL` element. This ensures the main product has all relevant images. ### **What should I do if variants are not matched correctly?** Check that: * all variants have the same `ITEMGROUP_ID`, * variant parameters are filled in and match the feed values, * the Master item element is not incorrectly configured in the rule. 💡 If the problem persists, try creating a test project with a smaller number of products and test the merging logic. ### **Can the original variants be removed from the feed after merging?** Yes, Mergado **hides them automatically** -- only the Master product remains in the output. Variants remain in the project for reference but are no longer written to the output feed. ### **Can the merging result be exported for review or backup?** Yes. Open the output feed and check that products were correctly grouped under one Master product. ### **Can this rule be combined with the "Calculation" or "Rewrite" rule?** Yes, but the **Merging Variants** rule will always be automatically placed last in the rule order. So element values are first modified, and only then are variants merged. --- ## [Rule: Remove Accents and Diacritics](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-remove-accents-and-diacritics/) # **Rule: Remove Accents and Diacritics** This rule allows you to **remove diacritical marks** (e.g., accented characters like e, s, c, t, z) from text in feed elements and replace them with their **Latin equivalents** according to the **ASCII** table. It is used, for example, for exports that do not allow accented characters or for unifying product names. ## **Extra features** * No additional features ## **Practical examples** ### **Example 1: Remove diacritics from product name or description** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Remove diacritics** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be either the name element (for example: g:title, Productname, name\_Exact) or the product description (description) **5. Naming the rule:** * In the last step, enter the rule name, for example *"Remove diacritics from product name"*. ## **FAQ** ### **What is the Remove Accents and Diacritics rule for?** This rule converts all accented characters (e.g., characters with diacritical marks) to their **ASCII equivalents** (plain Latin letters). It is primarily used: * when exporting feeds to systems that do not support accented characters, * for unifying product names or URL addresses, * when preparing data for comparison, filtering, or matching. ### **What is the result after applying the rule?** For example: * *Červené tričko s nápisem* → *Cervene tricko s napisem* * *Dámská kabelka Žofie* → *Damska kabelka Zofie* * *Zboží.cz – Pánská obuv Šimon* → *Zbozi.cz – Panska obuv Simon* ### **Which elements can I apply the rule to?** Any text element in the project, for example: * product names (`g:title`, `product_name`, `name_Exact`), * descriptions (`description`), * brands (`brand`), * categories (`product_type`). 💡 Tip: The most common use is for product names and descriptions when exporting to foreign markets. ### **Can the rule be applied to product parameters as well?** Yes. Simply select the element `PARAM | PARAM_VALUE` in the **"Element"** field. The rule will then remove diacritics from parameter names or values as well. ### **Does removing diacritics affect HTML code structure or special characters (e.g., &)?** No. The rule works only with **regular alphabet letters** and **diacritical marks**. HTML tags, entities (`

`, `&`, ` `, etc.) and digits remain untouched. ### **Can I use the rule on URL addresses?** Yes, but with caution. When removing diacritics, characters are converted to basic Latin, but **spaces and special characters are preserved**. It is recommended to combine this rule with the **Find and replace** rule (e.g., for replacing spaces with hyphens or removing disallowed characters). ### **Can the rule be applied only to selected products?** Yes. You can create a **custom Product query** (e.g., by language or category) and apply the rule only to it. For example: remove diacritics only for products exported to foreign markets. ### **Can the rule be used repeatedly?** Yes. The rule can be applied at any stage of feed editing -- even repeatedly, for example after adding new data or importing an external file. Just adjust the rule order accordingly. If the text no longer contains diacritics, the rule makes no changes. ### **Can I check the result before export?** Yes. After **saving and applying the rules** or after **regenerating the feed**, check the result: * in the product preview, or * using the **Rule walkthrough** feature, where you can see exactly how the text changed after diacritics removal. ### **Can the rule be combined with other rules?** Yes. It is most commonly combined with: * **Find and replace** -- for additionally removing spaces or special characters, * **Rewrite** -- for adding the modified text to another element. --- ## [Rule: Remove Parameter Values](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-remove-parameter-values/) # **Rule: Remove Parameter Values** This rule is used to remove specific product parameter values from the feed, or to remove an entire parameter including its name and all values. It is useful for cleaning up data when you need to remove unwanted or outdated information. ## **Extra features** * Parameter name autocomplete * Bulk copy values, for example from Google Sheets * Parameter type query option * Option to add multiple rows ## **Practical examples** ### **Example 1: Remove a specific parameter from the feed** This example shows how to remove parameter values from the feed, for example the values **Black** and **White** from the **Color** parameter. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Remove Parameter Values** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Selecting the parameter:** * In the **Parameter** field, type or select from the list the element whose parameter you want to remove. * In our case, this will be the Color value. * **💡Tip**: Using **"Prefill left side"**, you can load all parameters of the given project. This step is not suitable for our example since we are selecting only a specific value. **5. Selecting values to remove:** * In the **"Remove the following values"** field, enter the value you want to remove. * For example: **"Black"** and **"White"**. * 💡Tip: You can also use a variable or a combination of variable and text. **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Remove Color parameter values". ### **Example 2: Remove all values of a parameter (Color) from a supplier feed** This example shows how to remove **all values of the Color parameter** from the feed, including the parameter name. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Remove Parameter Values** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Selecting the parameter:** * In the **"Parameter"** field, enter or select from the **Selectbox** the parameter whose values you want to remove entirely. * In our case, this will be the **"Color" parameter**. **5. Selecting values to remove:** * In the **"Remove the following values"** field, you do not need to enter any specific values. * Simply check the **"Remove all values" selectbox**, which will remove all values of this parameter. **6. Naming the rule:** * In the last step, enter the **rule name**, for example "Remove Color parameter". ### **Additional uses** * Remove payment methods * Remove carriers * Remove all parameters that reference suppliers or other unwanted values. ## **FAQ** ### **What is the Remove Parameter Values rule for?** This rule allows you to **remove specific parameter values** or **entire parameters including their names and values**. It is used, for example, for: * removing outdated information (e.g., old colors, obsolete sizes), * cleaning the feed of unnecessary or duplicate parameters, * removing supplier parameters that you do not want to export to output feeds. ### **What is the difference between this rule and the Set Product Parameters rule?** * **Remove Parameter Values** → removes the entire parameter or specific parameter values. * **Set Product Parameters** → allows you to add, modify, or delete **only the value** (the name is preserved). 💡 If you just want to "clear" the value but keep the parameter, use **Set Product Parameters** with an empty **Value** field. ### **Can I remove only selected values within a single parameter?** Yes. In the **"Remove the following values"** field, enter the values you want to delete (e.g., *Black*, *White*). You can enter multiple values, or use a **variable** or **combination of text and variable**. ### **How do I remove all values of a single parameter?** If you want to remove the entire parameter including all values, simply **check the "Remove all values" checkbox**. This removes the entire parameter from the feed, for example the entire block: `` `Color` `Black` `` ➡️ After applying the rule: the *Color* parameter will no longer appear in the product. ### **Can I remove multiple parameters at once with this rule?** Yes. Simply add multiple rows to the rule -- one for each parameter. 💡 Using the **"Prefill left side"** button, you can load all project parameters and then select the ones you want to delete. ### **Can I use this method to remove, for example, carriers or payment methods?** Yes. If carriers or payment methods are stored as parameters (e.g., *Shipping = DHL*), you can remove them the same way. Simply select the appropriate name in the **"Parameter"** field (e.g., *Shipping*, *Payment*). ### **Can the rule remove all parameters from the entire feed?** Yes, but be careful. If you load all parameters using **"Prefill left side"** and check **"Remove all values"** for all rows, Mergado will remove all parameters from all products. ### **Does removing parameters affect the XML feed structure?** No. The rule works only with element content -- the XML structure remains valid and intact. Only specific `` blocks (including names and values) are removed. ### **Can the rule be applied only to a specific group of products?** Yes. You can create a **Product query** (e.g., by supplier, brand, or category) and apply the rule only to those products. Other products remain unchanged. ### **Can I check what was removed?** Yes. After **saving and applying the rules** or after **regenerating the feed**, check the changes on the Products page, or use the **Rule walkthrough**. This feature allows you to compare the original and resulting product versions and see exactly which parameters were removed. --- ## [Rule: Rename Categories in Bulk](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-rename-categories-in-bulk/) # **Rule: Rename Categories in Bulk** This rule allows you to **bulk rewrite or map categories** from your online store to the corresponding categories of a specific comparison shopping engine. ## **Extra features** * Bulk copy categories, for example from Google Sheets * Bulk copy the entire category structure * **Prefill left side** -- automatically load categories from the online store * **Suggest categories** -- Mergado recommends 3 categories based on keyword similarity that each input category can be mapped to * **Category sorting** -- option to adjust the order of category rows and thus influence the application order * **Autocomplete** for categories from the specific comparison engine's category tree ## **Practical examples** ### **Example 1: Map online store categories to Google categories** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Rename Categories in Bulk** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the input categories:** * In the left column **"If the current category contains"**, enter all online store categories you want to map. * 💡 **Tip:** Click the **arrow** next to the **"Suggest categories"** button and click **"Prefill left side"** -- Mergado will automatically load all existing categories. * **Category order is important** -- the rule applies rows sequentially from top to bottom. **5. Fill in the target categories:** * In the right column **"Will be replaced with this category"**, enter the appropriate category for the specific platform. * New values can be: * typed directly as text, * selected using autocomplete (e.g., type a keyword and choose from suggested categories), * for Google formats, use the **"Suggest categories"** feature, which recommends 3 possible categories from Google's category tree based on keyword similarity for each input category. **6. Naming the rule:** * In the last step, enter the **rule name**, for example *"Map categories to Google categories".* ### **Example 2: Rewrite online store categories in an element** For example in the `CATEGORY` element. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Rename Categories in Bulk** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the input categories:** * In the left column **"If the current category contains"**, enter all online store categories you want to map. * 💡 **Tip:** Click **"Prefill left side"** -- Mergado will automatically load all existing categories. * **Category order is important** -- rows are applied sequentially from top to bottom. **5. Fill in the target categories:** * In the right-side field **"Will be replaced with this category"**, fill in the categories for the given platform. * New values can be: * typed directly as text, * selected using autocomplete (for supported formats), where you type a keyword and choose from the suggested categories. **6. Naming the rule:** * In the last step, enter the **rule name**, for example *"Rename categories".* ### **Example 3: Rewrite supplier categories with your own categories** This example shows how to set **your online store's categories** for products instead of the supplier's categories. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Rename Categories in Bulk** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the input categories:** * In the left-side field **"If the current category contains"**, you can list all supplier categories from the input feed. * **💡Tip**: Use the **"Prefill left side"** button, which will automatically extract all input categories. * Category order matters \- rows are applied sequentially from top to bottom. **5. Fill in the target categories:** * In the right column **"Will be replaced with this category"**, enter your own target online store categories. * New values can be: * entered manually as text, * copied and pasted from a spreadsheet (check the **"Smart paste mode"** checkbox), * selected using **autocomplete** if you have imported your own category tree. **6. Naming the rule:** * In the last step, enter the **rule name**, for example *"Rename supplier categories to online store categories".* ## **FAQ** ### **What is the Rename Categories in Bulk rule for?** The rule allows you to **bulk edit or map categories** from the input feed (e.g., from the online store or supplier) to the target categories required by a specific platform -- typically Google, Heureka, Zbozi.cz, or Glami. It helps unify the category structure, simplifying exports and improving data quality. ### **What is the difference between renaming and mapping categories?** Within this rule, both terms mean the same thing. The rule maps input categories to output format categories. The mapped value is written into the correct element. ### **Do I have to enter the online store's input categories manually, or can Mergado load them automatically?** You do not have to type them manually. Using the **"Prefill left side"** function, Mergado automatically loads all input categories from the source feed. This saves you time and minimizes errors. ### **How does the "Suggest categories" function work?** Mergado automatically offers three possible matching categories from the selected comparison engine's category tree (e.g., Google or Heureka) based on **keywords in the input category names**. You can select the correct result from the suggestions or manually search for a better alternative. ### **How important is the row order in the rule?** The order is very important. Mergado **applies rows from top to bottom** and for the left column, the logic is "if the element with input categories **CONTAINS** the value" (not an exact match). It is recommended to place more general categories at the top and the most specific ones at the bottom. ### **Can I paste already mapped categories in bulk from a spreadsheet (e.g., Google Sheets)?** Yes. Enable the **"Smart paste mode"** checkbox and paste the category pairs (input → target) directly from a spreadsheet. Mergado automatically splits the values into the corresponding fields, which is ideal for large-scale mapping. ### **Can the rule be used to rename categories from multiple suppliers at once?** Yes. You can apply the rule to products from different supplier feeds and unify them into a single online store category. For a larger number of suppliers, it is advisable to use multiple rules to keep the structure clearer. ### **How does the rule behave if some categories are missing from the input feed?** If a product does not have the given category, **the rule will not apply to it**. For these cases, you can create a separate **"Rewrite"** rule to fill empty categories with a default value (e.g., "Uncategorized"). ### **Can I combine text category entries with variables?** Yes. In the "Will be replaced with this category" field, you can enter a **combination of text and variables**, e.g.: `%CATEGORY% | %brand%`, which creates a more complex structure for export. ### **Can the rule be scheduled, for example, for seasonal category remapping?** Yes. You can use the **rule timer** and specify when it should apply -- e.g., when transitioning from seasonal assortments (Winter → Summer). After the specified interval expires, the rule will automatically stop applying. ### **How do I know if the category remapping was done correctly?** After **saving and applying the rules** or after **regenerating the feed**: * open the product detail and check that the category matches the output, * or use the **Rule walkthrough** feature, which shows how the element value changed after the rule was applied. ### **What happens if the same input category is listed multiple times?** Mergado uses the **last occurrence** (based on row order). ### **Can I export the created category mapping for backup or other projects?** Yes. In the project's extended functions, you can export the rule data to **CSV** or **Google Sheets** and then use it in another project. This is an ideal way to transfer mappings between projects or language versions of an online store. ### **What should I do if categories are not matched correctly?** Check that: * the input categories match exactly the text or content of the searched value, * you are not using unnecessary spaces or other characters, * and the row order matches the remapping logic. 💡 For more complex structures, use a temporary test rule with only a few rows. ### **Can this rule be used to completely remove categories?** No. If you want to remove a category, use the **"Rewrite"** rule and enter an **empty value** for the given element. The "Rename Categories in Bulk" rule is exclusively for replacing or mapping values, not for deleting them. --- ## [Rule: Round Numbers](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-round-numbers/) # **Rule: Round Numbers** ℹ️ This rule is also part of the **"Calculation"** rule. This rule allows you to **round numeric values** (such as prices) in a specific element to a chosen number of places -- for example, to units, tenths, or hundredths. ## **Extra features** * Rounding to various levels: **units, tenths, hundredths, hundreds** * Choice of **rounding type**: up, down, standard, to zero * Choice of **decimal separator** (period or comma) * Choice of **thousands separator** (space, period, comma, none) ## **Practical examples** ### **Example: Round amounts to units, tenths, or hundredths** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Round Numbers** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. **5. Setting the rounding type:** * In the **Rounding type** field, select the desired method, for example: **up**, **down**, **standard**, **0**, or **0.5**. **6. Selecting the rounding level:** * In the **Round to** field, choose units, tenths, hundredths, etc., depending on the type of rounding you need. **Setting the decimal separator:** * Choose whether you want to use a **comma** or **period** as the decimal separator. **Setting the thousands separator:** * In the **Thousands separator** field, select the desired separator (space, period, comma, or no separator). **Naming the rule:** * In the last step, enter the rule name, for example: *"Round price to units".* ## **FAQ** ### **What is the Round Numbers rule for?** This rule allows you to **round numeric values** (e.g., prices, discounts, or margins) in any element to the desired number of places -- for example, to units, tenths, or hundredths. It can also be used to adjust number formatting (decimal period/comma, thousands separators, etc.). ### **What values can I round to?** In the **"Round to"** field, you can choose: * units (e.g., 123.45 → 123), * tenths (e.g., 123.45 → 123.5), * hundredths (e.g., 123.456 → 123.46), * hundreds (e.g., 1234 → 1200). ### **What rounding types can I use?** In the **"Rounding type"** field, the following options are available: * **up** -- always rounds up, * **down** -- always rounds down, * **standard** -- regular rounding based on the value after the decimal point, * **to 0** **or 0.5** -- rounds to the nearest half unit or 0, * **to 0.9 \-** rounds to the nearest value ending in .9 * **to 0.99 \-** rounds to the nearest value ending in .99 ### **Can this rule be applied to elements other than prices?** Yes. The rule can be used on **any numeric element**, e.g., weight, margin, percentage values, or quantity. It is important that the element contains **valid numeric values**. ### **What happens if the element does not contain a numeric value (e.g., text or an empty value)?** Mergado will **skip** that record and make no changes. The rule is applied only to values that can be unambiguously converted to a number. ### **Can I choose whether to use a comma or period as the decimal separator?** Yes. In the **"Decimal separator"** field, choose whether to use a **comma (,) or period (.)**. 💡 For example, for international projects, a period is usually more appropriate, while for Czech feeds, a comma may be preferred. ### **How do I set the thousands separator?** In the **"Thousands separator"** field, select one of the options: * space (e.g., 1 000), * period (e.g., 1.000), * comma (e.g., 1,000), * no separator (e.g., 1000). ### **Can the rule be applied only to selected products?** Yes. In the **"Query"** field, choose either **"All products"** or create a **custom Product query**, for example by type, brand, or price. This allows you to round only a specific group of products. ### **Can this rule completely remove the decimal part of a price?** Yes. Choose the rounding type **"standard"** and then set the rounding to **units**. Mergado will automatically remove everything after the decimal point, e.g.: 123.99 → 123. ### **Can I use this rule to convert prices, e.g., from 123.4567 to 123.46?** Yes. Choose the rounding type **"standard"** and in the **"Round to"** field select **hundredths**. Mergado will automatically adjust the result to two decimal places. ### **Can this rule also format currency (e.g., add EUR)?** No. The **Round Numbers** rule works only with numeric values. If you want to add currency, use the **Rewrite** or **Find and replace** rule afterward. ### **Can I use this rule as part of another calculation?** Yes. The **Round Numbers** rule is also **part of the Calculation rule**. This means you can first perform a calculation (e.g., price without VAT) and then round the result within the same rule. ### **How do I check if the rounding was applied correctly?** After **saving and applying the rules or after regenerating the feed**, open the **product preview** or use the **"Rule walkthrough"** feature. There you can verify whether the value actually changed according to the chosen rounding type and level. --- ## [Rule: Set Product Parameters](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-set-product-parameters/) # **Rule: Set Product Parameters** This rule is used to **set product parameters and their values**. With a single rule, you can **set different parameters for different product groups** (based on product queries). The rule is ideal for **automatically adding parameters** such as volume, color, material, or weight. ## **Extra features** * Parameter name autocomplete * Bulk copy values, for example from Google Sheets * Parameter type query (text, numeric, boolean...) * Option to add multiple rows ## **Practical examples** ### **Example 1: Set new parameters for all or selected products** This example shows how to **set new product parameters in bulk and automatically** for different product segments. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Product Parameters** option. **3. Choosing the element to change:** * You do not need to select the elements where new parameters will be inserted -- Mergado selects them automatically based on the project's output format, for example: `g:product_detail` in a Google project. **4. Adding rows:** * Each row in the **Set Product Parameters** rule has 3 columns: * Queries -- allows you to select one or more queries * Parameter -- specifies the parameter name to be set * Value -- specifies the value to be assigned to the parameter * Rows allow you to set parameters for different product segments. **5. Product queries:** * In the left column in the **Queries** field * from the Selectbox, choose existing saved product queries from the project (each on a separate row). * **💡 Tip:** You can select one or more queries. * or from the Selectbox, choose "Create new query" and create new **Product queries** for specific products you want the rule to apply to. **6. Setting parameters for the chosen query:** * In the right column **Parameter**, add parameter names one below another as text values, e.g., `Volume` * If you select an existing parameter name, the value will be updated. * If you enter a new name, a **new parameter will be created**. * In the right column **Value**, add parameter values one below another as: * a text value, for example: `250 ml` * a variable, for example: `%volume%` * a combination of variable and text, for example: `%volume% ml` **7. Setting parameters for additional queries:** * Repeat the previous steps **"Product queries"** and **"Setting parameters for the chosen query"** in the next empty row. * **💡 Tip:** Filling in a new row automatically adds another empty row. **8. Naming the rule:** * In the last step, enter the **rule name**, for example "Set parameters". ### **Example 2: Rewrite existing product parameters** This example shows how to rewrite existing product parameters in bulk and automatically for different product segments. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Product Parameters** option. **3. Choosing the element to change:** * You do not need to select the elements where existing parameters are stored -- Mergado selects them automatically based on the project's output format, e.g., `g:product_detail` in a Google project. **4. Adding rows:** * Each row in the **Set Product Parameters** rule has 3 columns: * Queries -- allows you to select one or more queries * Parameter -- allows you to set one or more parameters for the given row * Value -- allows you to set the parameter value for each parameter * Rows allow you to set parameters for different product segments. **5. Product queries:** * In the left column in the **Queries** field * from the Selectbox, choose prepared saved queries from the project, each on a separate row, * **💡 Tip:** You can select one or more queries. * or from the Selectbox, choose "Create new query" and create new **Product queries** for specific products you want the rule to apply to. **6. Setting parameters for the chosen query:** * In the right column Parameter, select from the Selectbox the names of existing parameters in the project that you want to rewrite, e.g., `Volume` * You can select multiple parameters for the chosen query, always one parameter per row. * In the right column Value, add new parameter values one below another as: * a text value, for example: `250 ml` * a variable, for example: `%volume%` * a combination of variable and text, for example: `%volume% ml` **7. Setting parameters for additional queries:** * Repeat the previous steps **"Product queries"** and **"Setting parameters for the chosen query"** in the next empty row. * **💡 Tip:** Filling in a new row automatically adds another empty row. * **Naming the rule:** * In the last step, enter the **rule name**, for example "Set parameters". ### **Example 3: Delete all parameter values for products** This example shows how to delete all parameter values for different product segments while keeping the parameter names. **💡 Tip:** If you want to **delete only specific parameter values** or **delete the entire parameter including the name and values**, use the **Remove Product Parameters** rule. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Product Parameters** option. **3. Choosing the element to change:** * You do not need to select the elements where existing parameters are stored -- Mergado selects them automatically based on the project's output format, e.g., `g:product_detail` in a Google project. **4. Adding rows:** * Each row in the **Set Product Parameters** rule has 3 columns: * Queries -- allows you to select one or more queries * Parameter -- allows you to set one or more parameters for the given row * Value -- allows you to set the parameter value for each parameter * Rows allow you to set parameters for different product segments. **5. Product queries:** * In the left column in the **Queries** field * from the Selectbox, choose prepared saved queries from the project, each on a separate row, * **💡 Tip:** You can select one or more queries. * or from the Selectbox, choose "Create new query" and create new **Product queries** for specific products you want the rule to apply to. **6. Setting parameters for the chosen query:** * In the right column Parameter, select from the Selectbox the names of existing parameters in the project whose values you want to delete, e.g., `Volume` * You can select multiple parameters for the chosen query, always one parameter per row. * In the right column Value, leave the field empty for each parameter whose values you want to delete. **7. Setting parameters for additional queries:** * Repeat the previous steps **"Product queries"** and **"Setting parameters for the chosen query"** in the next empty row. * **💡 Tip:** Filling in a new row automatically adds another empty row. **8. Naming the rule:** * In the last step, enter the **rule name**, for example "Delete parameter values". ## **FAQ** ### **What is the Set Product Parameters rule for?** The rule allows you to **set, modify, or delete parameter values** for products. Each parameter has a name and a value (e.g., *Color = Red*). It can be used for: * adding missing parameters (e.g., *Volume*, *Material*), * rewriting existing parameters by query, * deleting parameter values without removing the parameter name itself, * automatically adding values for different product segments. ### **What is the difference between this rule and the Remove Product Parameters rule?** * **Set Product Parameters** -- can add, rewrite, and delete **parameter values** (the name is preserved). * **Remove Product Parameters** -- removes the entire parameter including the name and values, or allows **removing specific values** for a given parameter. 💡 If you only want to clear the value but keep the name (e.g., an empty parameter), use **Set Product Parameters** with an empty **Value** field. ### **Can I create new parameters using this rule?** Yes. If you type a name in the **Parameter** column that does not yet exist in the project, Mergado automatically creates a new parameter. Conversely, if you choose an existing name from the Selectbox, the value will be rewritten. ### **What format can I use for parameter values?** In the **Value** field, you can use: * **a text value** -- e.g., `250 ml`, * **a variable** -- e.g., `%volume%`, * **a combination of variable and text** -- e.g., `%volume% ml`. 💡 This allows you to combine values from different elements or add units automatically. ### **How do product queries work in this rule?** Each rule row contains three parts: * **Query** -- defines which products the rule applies to, * **Parameter** -- specifies which parameter to add or modify, * **Value** -- specifies what value to assign to the parameter. This allows you to set **different parameters for different product groups** within a single rule. ### **Can I add multiple parameters for a single query?** Yes. Simply create multiple rows for the same query -- each with a different parameter name and value. 💡 After filling in the last row, a new empty row is automatically added. ### **Can I use this rule to delete a parameter value?** Yes. If you leave the **Value** field empty, Mergado will remove the content (value) of the given parameter but keep the parameter name itself. 💡 If you want to remove the entire parameter, use the **Remove Product Parameters** rule instead. ### **Can I use variables in the parameter name?** No. Only **text** can be entered in the parameter name -- variables are not supported there. Variables can only be used in the **Value** field. ### **What types of parameters can I set?** You can choose from multiple types: * text (e.g., *Color = Blue*), * numeric (e.g., *Weight = 250*), * boolean (e.g., *Available = true*). 💡 Adjust the parameter type according to the project's output format -- e.g., Google Merchant Center requires specific value formats. ### **Can the rule be used for bulk parameter edits?** Yes. Using the "Smart paste mode" checkbox, you can prepare values in Google Sheets, for example, and then paste them in bulk into the rule. Mergado automatically splits the individual values into the corresponding fields based on the table structure. ### **What if I want to set a parameter only for a specific category or brand?** Create a **Product query** containing only those products (e.g., `CATEGORYTEXT CONTAINS "Handbags"`). Then apply the rule only to this query -- other products remain unchanged. ### **Can the rule be combined with other rules?** Yes. The most common combinations: * **Remove Product Parameters** -- for cleaning parameters before setting new ones, * **Rewrite** -- for inserting parameter values into product names, * **Letter case converter** -- for adjusting the format of text parameters. ### **How do I verify that the parameters were set correctly?** After **saving and applying the rules** or after **regenerating the feed**, check the result: * in the product preview, or * using the **Rule walkthrough** feature, where you can see which parameters were added or changed. --- ## [Rule: Set Shipping Rates](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-set-shipping-rates/) # **Rule: Set Shipping Rates** This rule is used to easily set carriers and shipping prices for your products. It allows you to bulk add carriers and the shipping cost, either as a numeric value or a variable. ## **Extra features** * Bulk copy values, for example from Google Sheets * Remove rows without a price * Pre-defined list of carriers \+ ability to add new ones * The price field accepts a numeric value or a variable * Option to add multiple rows ## **Practical examples** ### **Example 1: Add a shipping price to all or selected products** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Shipping Rates** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the carriers:** * In the **Carrier** field, enter the carrier name (for example, *DHL*, *DPD*, *FedEx*). * You can use the **pre-defined list of carriers** or add **new carriers** as needed. * The number of rows is unlimited -- add as many carriers as you need. **5. Setting the shipping price:** * In the **Prepaid** field, enter the shipping price value. * You can enter: * a **specific numeric value** (for example, `89`), or * a **variable** containing the price from the feed (for example, `%delivery_price%`). **6. Naming the rule:** * In the last step, enter the rule name, for example *"Set shipping rates".* ### **Example 2: Rewrite the existing price for a specific carrier** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Shipping Rates** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the carriers:** * In the **Carrier** field, enter the carrier name whose value you want to rewrite (for example, *DHL*, *DPD*, *FedEx*). **5. Setting the shipping price:** * In the **Prepaid** field, enter the new shipping price value. * You can enter: * a **specific numeric value** (for example, `89`), or * a **variable** containing the price from the feed (for example, `%delivery_price%`). **6. Naming the rule:** * In the last step, enter the rule name, for example *"DPD -- new shipping price".* ### **Example 3: Set free shipping for all or selected products** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Shipping Rates** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the carriers:** * In the **Carrier** field, enter the carrier name (for example, *DHL*, *DPD*, *FedEx*). * You can use the **pre-defined list of carriers** or add **new carriers** as needed. * The number of rows is unlimited -- add as many carriers as you need. **5. Setting the shipping price:** * In the **Prepaid** field, enter the new numeric value. * In our case, enter **0**, because shipping will be free. * 💡 **Tip:** If you have multiple carriers, you can set a zero value for all or only selected carriers. **6. Naming the rule:** * In the last step, enter the rule name, for example: *"Free shipping".* ### **Example 4: Set free shipping only on weekends** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set Shipping Rates** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Fill in the carriers:** * In the **Carrier** field, enter the carrier name (for example, *DHL*, *DPD*, *FedEx*). * You can use the **pre-defined list of carriers** or add **new carriers** as needed. * The number of rows is unlimited -- add as many carriers as you need. **5. Setting the shipping price:** * In the **Prepaid** field, enter the new numeric value. * In our case, enter **0**, because shipping will be free. * 💡 **Tip:** If you have multiple carriers, you can set a zero value for all or only selected carriers. **6. Naming the rule:** * In the last step, enter the **rule name**, for example *"Free shipping -- weekend".* **7. Setting the rule timer:** * Go to the **bottom of the page** and click the **"Additional options"** button. * After expanding the section, click **"Enable timer"**. * A table will open where you can specify the **days and hours** when the rule should be active. * Active time slots are marked with a **checkmark**. * In our case, select **Friday, Saturday, and Sunday**. * Leave the other days (Monday--Thursday) **inactive**. * At the top of the timer, you can optionally set a **validity date** (from when to when the rule should be active). * If you do not set these values, the rule will be valid **from the moment it is saved** until you **disable the timer**. ### **Additional uses** * Remove a selected carrier from the feed. ## **FAQ** ### **What is this rule for?** With this rule, you can **bulk add carriers and shipping prices** to all or selected products. The value can be entered as a **specific number** or a **variable** containing the price from the feed. ### **Can I set different prices for different carriers?** Yes. For each row, you can enter a different carrier (e.g., DHL, DPD, FedEx) and a different shipping price. The number of rows is unlimited. ### **Can the price be entered as a variable?** Yes. Instead of a fixed amount, you can use a variable, for example `%delivery_price%`. This way, the price is automatically loaded from the feed. ### **How do I set free shipping for all products?** In the **"Prepaid"** field, enter the value **0**. This sets free shipping for all products that fall within the selected query. ### **Can free shipping be set for selected products only?** Yes. In the **"Query"** field, choose a saved product query -- for example, products with a price higher than 1,000 CZK -- and enter a shipping price of **0**. The rule will apply only to this query. ### **Can I overwrite an existing shipping price?** Yes. If the same carrier already has a price in the feed, the rule will rewrite it with the new value. Prices for other carriers remain unchanged. ### **How do I add a new carrier that is not in the list?** Simply type its name manually in the **"Carrier"** field -- for example, "GLS" or "Express Delivery". ### **Can I set multiple carriers at once?** Yes. Add more rows to the rule -- one for each carrier -- and set a different price for each. When the feed is regenerated, the rule will create the corresponding records. ### **Can the rule be time-limited (e.g., free shipping on weekends)?** Yes. In the **"Additional options"** section, enable the **rule timer** and select the days or time slots when the rule should be active. For example, you can set free shipping to apply only from Friday to Sunday. ### **What happens if the carrier does not exist in the project?** Mergado will automatically create the carrier as a new record. You do not need to set up carriers manually in advance. ### **How do I verify that the rule works correctly?** After saving **and regenerating the feed**, open the **Elements** page and find `shipping` (or the corresponding element based on the format). Check that the new carriers and their prices are displayed correctly. You can also verify the result: * on the Products page, where the newly set values will be reflected in the product overview, or * directly in the output feed, which you can open in a browser and search for the specific element. 💡 For a detailed check of individual products, you can use the Rule walkthrough feature, which shows how the rule was applied to a given product. --- ## [Rule: Set UTM Parameters](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-set-utm-parameters/) # **Rule: Set UTM Parameters** This rule is suitable for online stores that want to measure campaign performance in Google Analytics or other analytics tools. ## **Extra features** * Allow diacritics in values * Text and variables can be used in all fields ## **Practical examples** ### **Example 1: Add UTM parameters to product URLs for traffic measurement** **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set UTM Parameters** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be the element with the URL (for example: g:link, URL, etc.) **5. Fill in the campaign specification fields (fields are not required):** * In each parameter, you can use not only fixed values (text) but also variables that allow you to dynamically generate values for each product. * **utm\_id** -- unique campaign ID, for example: `123` * **utm\_source** -- traffic source identification, for example: `Google` * **utm\_medium** -- marketing medium, for example: `cpc`, `email` * **utm\_campaign** -- campaign name, for example: `summer_sale_2025` * **utm\_source\_platform** -- multi-platform ad networks, for example: `instagram_ads` * **utm\_content** -- used to differentiate links, for example: `button_discount` * **utm\_term** -- keyword used in the ad, for example: `product-xyz` **6. "Allow diacritics" checkbox:** * Check this if you want to use diacritics in parameters. Otherwise, Mergado will remove them. **7. Naming the rule:** * In the last step, enter the rule name. ### **Example 2: Add other element values to UTM parameters** For example: a value from `custom_label`. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Set UTM Parameters** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be the element with the URL (for example: g:link, URL, etc.) **5. Fill in the campaign specification fields (fields are not required):** * In each parameter, you can use not only fixed values (text) but also variables that allow you to dynamically generate values for each product. * **utm\_id --** unique campaign ID. Use the value of another element by entering its path, for example: `%id%`. * **utm\_source** -- traffic source identification. Use the value of another element by entering its path, for example: `%source%`. * **utm\_medium** -- marketing medium (e.g., cpc, email). Use the value of another element by entering its path, for example: `%medium%` * **utm\_campaign** -- campaign name. Use the value of another element by entering its path, for example: `%campaign%`. * **utm\_source\_platform** -- multi-platform ad networks. Use the value of another element by entering its path, for example: `%source_platform%`. * **utm\_content --** link differentiation (e.g., button, banner, text). Use the value of another element by entering its path, for example: `%content%`. * **utm\_term --** keyword used in the ad. Use the value of another element by entering its path, for example: `%term%`. **5. "Allow diacritics" checkbox:** * Check this if you want to use diacritics in parameters. Otherwise, Mergado will remove them. **6. Naming the rule:** * In the last step, enter the rule name. ## **FAQ** ### **What is the Set UTM Parameters rule for?** The rule is used to **automatically add UTM parameters to product URL addresses**. It helps e-shops track campaign performance in **Google Analytics, GA4, Sklik, Meta Ads**, and other tools. It can be used for all products or only for selected product queries. ### **Which UTM parameters can I set?** The rule supports all common parameters: * `utm_id` -- unique campaign ID, e.g., `123` * `utm_source` -- traffic source, e.g., `Google`, `Facebook` * `utm_medium` -- marketing medium, e.g., `cpc`, `email` * `utm_campaign` -- campaign name, e.g., `summer_sale_2025` * `utm_source_platform` -- platform, e.g., `instagram_ads` * `utm_content` -- link differentiation, e.g., `button_discount`, `banner` * `utm_term` -- campaign keyword, e.g., `product-xyz` ### **Can I use variables in UTM parameters?** Yes. In each field, you can enter a **variable** instead of text -- e.g.: `%id%`, `%source%`, `%medium%`, `%campaign%`, `%content%`. This dynamically fills the parameters with values from other elements. 💡 **Example:** `utm_campaign = %custom_label_0%` means Mergado will fill in the value from the `custom_label_0` element. ### **What happens if the variable is empty?** If the variable is empty, Mergado **will not add** the corresponding UTM parameter to the URL. 💡 However, if the empty variable is between two other values, **double spaces or empty characters** may remain in the result. In that case, we recommend using the **Find and Replace** rule with the search expression `\s{2,}` (two or more spaces) and replacing it with a single space. ### **How are UTM parameters added to URL addresses?** Mergado automatically detects whether the URL already contains a question mark `?`: * if it **does not**, it adds parameters in the form `?utm_source=...`, * if it **does**, it adds new parameters using `&utm_medium=...`. This ensures the resulting URL remains valid. ### **Can I allow the use of diacritics in parameters?** Yes. By checking the **"Allow diacritics"** option, you can keep diacritics in parameter values. If you leave this option unchecked (recommended), Mergado automatically converts all characters to **ASCII without diacritics**, e.g.: `krenova` → `krenova`. ### **What if I want to add UTM parameters only for some products (e.g., only for the "Summer sale" query)?** Simply select the appropriate product query in the **"Query"** field (e.g., `Summer_sale`) -- UTM parameters will then be applied only to products in this query. Other products remain unchanged. ### **What if the URL already contains other UTM parameters?** If the URL already contains UTM parameters, Mergado **will not add them again** but **overwrites the existing ones**. This prevents duplicates and maintains a clean URL structure. ### **Can the rule be used for analytics systems other than Google Analytics?** Yes. UTM parameters are standard across systems. You can also use them for **GA4, Meta Ads, Sklik, TikTok Ads, Heureka conversion measurement**, etc. Just choose the appropriate values in the parameter fields. ### **How do I check if the rule was applied correctly?** After **saving and applying the rules** or after **regenerating the feed**, check the result: * in the **product preview** (URL element), or * using the **Rule walkthrough** feature, where you can see how the parameters were added to the URL. 💡 It is also recommended to test using a **UTM builder** or **Google Campaign URL Builder** to verify correct syntax. ### **Can the rule be combined with other rules?** Yes, it is often used together with: * **Rewrite** -- for modifying the URL itself before adding UTM parameters, * **Find and Replace** -- for cleaning the URL from unwanted characters, * **Remove diacritics** -- if the export platform does not allow diacritics in links. ### **Can the rule be scheduled (e.g., for short-term campaigns)?** Yes. Using the **timer**, you can specify the period when the rule should be active -- e.g., during the duration of a specific marketing campaign. After the period ends, the parameters will stop being added. --- ## [Rule: Strip HTML Tags](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-strip-html-tags/) # **Rule: Strip HTML Tags** This rule removes HTML tags from the content of an element. ## **Extra features** * None ## **Practical examples** ### **Example 1: Remove HTML tags from product descriptions** For example: ``, `
`, `

` **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Strip HTML Tags** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element you want to modify. * In our case, this will be the product description (description) **5. Naming the rule:** * In the last step, enter the rule name, for example *"Remove HTML tags from description element"*. ## **FAQ** ### **What is the Strip HTML Tags rule for?** This rule removes all **HTML tags** from the content of the selected element, such as `

`, `
`, ``, ``, etc. It is most commonly used for: * cleaning product descriptions before export, * preparing texts for platforms that do not support HTML (e.g., Google Merchant Center), * unifying content for export to simple CSV or XML feeds without formatting. ### **What exactly is removed from the text?** All **HTML tags** including their attributes are removed, e.g.: `

New collection -- free shipping!

` ➡ Result: `New collection -- free shipping!` The rule does not remove text content, only the tags. ### **Are HTML entities like** ` ` **or & also removed?** No. The rule removes only **HTML tags**. Entities like ` ` (non-breaking space), `&` (ampersand), or `€` (euro symbol) are preserved. 💡 If you want to remove or replace them, use the **Find and replace** rule afterward. ### **Can the rule be applied to elements other than product descriptions?** Yes. You can apply it to any text element, for example: * `g:title` -- if HTML tags have crept into product names, * `custom_label_0` -- if it contains formatted text, * or even `g:product_type`, if it was imported from an HTML source. ### **Does removing HTML tags affect the XML feed structure?** No. The rule works **only with element content**, not with its structure. Your XML remains valid -- Mergado never removes the XML elements themselves, only HTML code stored in their text. ### **Can the rule be applied to only some products?** Yes. In the **"Query"** field, you can choose **All products** or only a specific **Product query** (for example, only products from a certain category or supplier). ### **Can the rule damage text (e.g., remove something that is not HTML)?** No. The rule recognizes actual HTML tags by their syntax (`...`). It will not delete text that merely contains the characters `<` or `>` without a closed HTML pair. ### **Can the rule be combined with other text cleaning rules?** Yes -- this is actually the recommended approach. After removing HTML tags, you can use: * **Find and replace** -- for removing entities like ` `, * **Remove diacritics** -- for preparing data without accents, * **Truncate value** -- if you need to limit text length after cleaning. ### **How do I check if the rule worked correctly?** After **saving and applying the rules** or after **regenerating the feed**, check the result: * in the product preview, or * using the **Rule walkthrough** feature, where you can see exactly how HTML tags were removed from the specific element. --- ## [Rule: Truncate Value](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-truncate-value/) # **Rule: Truncate Value** This rule allows you to shorten an element's content to a specified length. It is useful when you need to limit the text length in fields like description, title, or for optimizing display on various platforms. ## **Extra features** * Truncate values to a chosen number of characters * When truncating, you can append custom text (for example: "... more on the online store") * Attempts to avoid splitting words and brackets * Removes single-letter prepositions and conjunctions at the end ## **Practical examples** ### **Example 1: Truncate the description element to 5,000 characters** This example shows how to truncate text in an element (e.g., description, title, url) to a specified number of characters to meet the requirements for exports or display on platforms. **1. Creating a new rule:** * Open the "Rules" page. * Click the **New rule** button. **2. Selecting the rule type:** * In the **Rule type** field, select the **Truncate Value** option. **3. Selecting products:** * In the **Query** field, choose either **All products** or create your own **Product query** for specific products you want the rule to apply to. **4. Choosing the element to change:** * In the **Element** field, select the element where you want to write the truncated result. * In our case, this will be the `description` element. **5. Enter the maximum length:** * In the **Maximum length** field, enter the desired maximum text length, for example: 5,000 characters. **6. Enter text to append when truncated:** * In the "When truncated, append..." field, enter the text to be added at the end of the truncated text, for example: "... more information on the website". * This text will be appended but will never exceed the maximum length. **7. Configuring additional options:** * **Avoid splitting words and brackets if possible:** This option is enabled by default, meaning the rule will try not to truncate text in the middle of a word or at an inappropriate position. * **Remove remaining single-letter prepositions and conjunctions**: This option is enabled by default and ensures that single-letter prepositions like "a", "I", etc. are removed if they end up at the end of the text. **8. Naming the rule:** * In the last step, enter the rule name, for example: *"Truncate description to 5,000 characters".* ### **Additional uses** * Truncate product name length to 150 characters. * Truncate URLs for Heureka to a maximum of 300 characters. ## **FAQ** ### **What is the Truncate Value rule for?** This rule allows you to **shorten the text length** in any element to a chosen number of characters. It is used, for example, for adjusting: * overly long product descriptions, * names (title) for comparison shopping engines, * URL addresses or meta descriptions, to meet the limits of a specific platform (e.g., Heureka, Google, Zbozi.cz, etc.). ### **Can I append text when truncating, such as "... more on the website"?** Yes. In the **"When truncated, append..."** field, you can enter any text (e.g., `... more on the online store`). This text is automatically added at the end of the truncated text, **without exceeding the maximum length** you set. ### **How does the "Avoid splitting words and brackets if possible" option work?** This option is **enabled by default**. When truncating, Mergado automatically checks to avoid splitting a word in the middle or cutting off a bracket. The result is more readable text even with length restrictions. ### **What does the "Remove remaining single-letter prepositions and conjunctions" option do?** This feature removes **single-letter prepositions** and **conjunctions** (e.g., *a, I*) if they would remain at the end of the text after truncation. The result then looks more natural and visually cleaner. ### **How do I specify the maximum text length?** In the **"Maximum length"** field, enter the number of characters the text should not exceed -- e.g., `5000`. Spaces and appended text (e.g., `... more on the website`) are also counted. ### **What happens if the text is shorter than the set limit?** If the text does not exceed the specified number of characters, **the rule is not applied** and the element value remains unchanged. ### **Can this rule be used to truncate URL addresses or HTML code?** Yes, but with caution. Truncation is applied purely based on text length, not HTML or URL structure. If you truncate HTML or a link at a bad position (e.g., in the middle of a tag or URL), it may result in a broken link. 💡 In these cases, we recommend combining the **Truncate Value** rule with the **Find and replace** rule, which removes entire text parts more safely. ### **Can I use this rule to truncate product names for certain queries?** Yes. Simply create a **Product query** (e.g., products with long names) and apply the rule only to this query. You can, for example, limit names only for a certain brand or product category. ### **Can the rule truncate by words instead of characters?** No, currently truncation is only possible by **number of characters**. If you need to edit text by structure (e.g., remove a sentence or block), use a combination with the **Find and replace** rule or **Regular expressions**. ### **What if I want the text to be truncated automatically only during a certain period (e.g., during a campaign)?** Use the **Timer** feature at the bottom of the rule page. You can set specific **days and hours** when the rule should apply, or limit its validity to a specific **date range**. ### **How do I verify that the text was truncated correctly?** After **saving and applying the rules** or after **regenerating the feed**, you can check the result in the **product preview** or using the **Rule walkthrough** feature. You will see exactly how the text was truncated and whether the appended text (e.g., "... more on the website") was added. ### **Can the rule be combined with other rules?** Yes, it is very often combined with: * **Find and replace** -- for removing unnecessary parts of text before truncation, * **Rewrite** -- for subsequently adding text or formatting. --- ## [Calculating and Filtering Percentage Discounts in Mergado](https://help.mergado.com/en/mergado-editor/rules/rule-library/rule-calculation/calculating-and-filtering-percentage-discounts-in-mergado/) # **Calculating and Filtering Percentage Discounts in Mergado** ## **How to Calculate and Filter Percentage Discounts in Mergado?** This guide walks you through calculating the percentage discount between the original price and the sale price and shows how to filter products by discount level. You need a pair of elements in your feed -- for example, in Google format: * original price: `g:price` * sale price: `g:sale_price` From these values, you can easily calculate the discount percentage and use it for feed modifications, exports, or filtering (e.g., show only products with a discount > 10%) and plan campaigns accordingly. **Discount formula:** `((original price - sale price) / original price) * 100` ## **Step 1: Save the Discount to a New Element** Want to have the discount directly in the feed as a custom element? Follow these steps: 1. **Create a new element** Go to **Elements → Add new element** (the button is below the element list). **Element name:** `DISCOUNT` (or e.g., `DISCOUNT_PERCENTAGE`). 2. **Create a "Calculation" rule** Open **Rules → New rule → Calculation**. * **Rule name:** "Calculate discount". * **Target element:** `DISCOUNT`. * **Calculation formula:** `((%g:price% - %g:sale_price%) / %g:price%) * 100` * **Recommendation:** set rounding to whole numbers. 3. **Save and apply the rules.** 4. **Check the result (example)** * `g:price = 1000` * `g:sale_price = 750` → the `DISCOUNT` element will have a value of **25**. ## **Step 2: Filter Products by Discount Without a New Element** Need to quickly filter by discount? Use the calculation directly in a **query (MQL)** -- no new element is needed. **Example query for discount > 10%:** `([g:price] - [g:sale_price]) / [g:price] * 100 > 10` This query finds all products with a discount greater than 10%. ## **Tips** * **Queries in Mergado can calculate.** You can use mathematical operations directly in conditions -- not just static values. This is useful for checking discounts or price-to-value ratios without creating additional elements. * **Calculate margin the same way as discount.** If you have purchase and selling prices in the feed, you can calculate the percentage margin: `((%g:price% - %PURCHASE_PRICE%) / %g:price%) * 100` Either create a new **Calculation** rule (e.g., into an element called `MARGIN_PERCENTAGE`), or use it directly in **queries** to filter products with a margin higher than a chosen percentage. ## **FAQ** ### **What is the correct formula for calculating a discount?** `((original price - sale price) / original price) * 100` ### **Do I have to create a new element to filter by discount?** No. Use the calculation directly in an MQL query, e.g.: `([g:price] - [g:sale_price]) / [g:price] * 100 > 10` ### **Where do I create a new element for the discount?** In **Elements → Add new element**. Recommended name: `DISCOUNT` (or `DISCOUNT_PERCENTAGE`). ### **How do I set up a rule for calculating the discount into an element?** **Rules → New rule → Calculation**, name "Calculate discount", target element `DISCOUNT`, formula: `((%g:price% - %g:sale_price%) / %g:price%) * 100`. We recommend rounding to whole numbers. ### **Can I also calculate the percentage margin?** Yes. Use: `((%g:price% - %PURCHASE_PRICE%) / %g:price%) * 100` Either as a new rule into an element (e.g., `MARGIN_PERCENTAGE`), or directly in queries. --- ## [How and Why to Set Up Price Tiers in Mergado](https://help.mergado.com/en/mergado-editor/automation/how-and-why-to-set-up-price-tiers-in-mergado/) # **How and Why to Set Up Price Tiers in Mergado?** ## **What Are Price Tiers and Why Set Them Up?** Setting up price tiers means **dividing your product range into groups (called queries) based on price ranges** (e.g., products priced at 0–199 CZK, 200–499 CZK, 500–999 CZK, 1000+ CZK). In Mergado, this segmentation helps you better target adjustments (such as margin or shipping), **choose the right cost per click (CPC) for bidding**, and **effectively configure PPC campaigns** based on price level. Each product segment requires a specific strategy, and knowing which price brackets contain the most products, the highest turnover, or the highest costs gives you a strategic advantage. ## **When to Use Price Tier Segmentation?** * Setting different strategies for "budget" and "premium" products, e.g., higher CPC for more expensive products. * Setting shipping rates based on product price, e.g., free shipping above a certain price tier. * Identifying products that generate the highest revenue or costs (see price tier configuration in the segment report of the Pricing Fox extension). ## **How to Set Up Price Tiers in Mergado?** ### **1. Using Automation** The quickest way to set up price tiers is with a **pre-built automation**. With just a few clicks, you can create **up to five price tiers**. 1. In the selected project, go to the **Automation** page. 2. Select the automation called **Dividing products into 5 segments based on price**. 3. In the **Automation parameters** section, enter the **name of the element that contains the product price** in your feed (e.g., PRICE_VAT) in the first row. > **Tip!** Make sure you select the correct element based on whether you want to divide products by price excluding VAT or price including VAT. 4. Enter the **upper price limit for each price tier** in the corresponding rows. 5. Confirm by clicking the ***Run automation*** button. If you want to **edit, delete, or add more** price tiers, you can do so on the **Products** page. Under the **Saved queries** tab, you will find a list of all your product queries, including the created price tiers. You can delete a price tier by clicking the **trash icon**, or click its **name to edit** it. ### **2. Manual Setup** If you choose not to use the automation, you can create and configure product groups (called queries in Mergado) for individual price tiers manually. Follow the same steps if you created five price tiers with the automation but want to add more. 1. In the selected project, go to the **Products** page. 2. At the top of the page, click **Simple interface**. 3. Enter the **name of the element** that contains the product price (e.g., PRICE_VAT). 4. Then set the **condition** for the price tier. For example, if you want to create a query for products priced between 200 and 999 CZK, select the **operator** ≥ is greater than or equal to and enter 200. 5. Click the **"+" icon** and fill in the **upper price limit**. Again, enter the element containing the price (e.g., PRICE_VAT), select the operator ≤ is less than or equal to, and enter 999. > **Tip!** Make sure that when you enter two conditions, the box to the left of the fields reads "and" (meaning both conditions must be met). If the box reads "or" (meaning either condition), click it to change it to "and". 6. Click **Search**. 7. Enter a **name** for this price tier query (e.g., price tier 200 to 999). 8. Click **Save**. You will then see the query listed on the Products page under the Saved queries tab, where you can delete or edit it. ## **Applying Rules to Price Tier Queries** After creating the desired price tiers, go to the **Rules page and create the necessary rules for individual queries**, then apply them. ## **Usage Examples** ### **Setting Different CPC by Price Tier** **Why use this:** If you have products with very low prices and low margins, it makes sense to set a lower CPC for them so their advertising remains profitable. Conversely, for more expensive products, a higher CPC may be worthwhile since margins tend to be larger. **How to do it:** 1. First, create suitable **product queries** by price tier following the instructions above. 2. On the **Rules page**, click **New rule**. 3. As the Rule type, select **Cost per click pricing**. 4. In the **Queries** field, choose the price tier for which you want to set the cost per click. 5. Choose whether you want to calculate the cost per click based on: * **a. Minimum click price** – The rule considers the minimum click prices for products in individual categories (minimum prices are set by the advertising platform), and you can increase this price by any amount you enter in the Add to minimum CPC field. * **b. Percentage of product price** – In the Percentage of product price field, you set the percentage of the product price you want to offer per click. For example, if you set 1% of the price, a product priced at 500 CZK would have a click cost of 5 CZK. 6. Enter a **Rule name**. 7. Click **Create**. 8. Repeat for other price tiers and remember to **apply** the created rules. > **Tip!** Track performance (clicks, conversions) separately for each tier and adjust CPC based on actual profitability. ### **Setting Shipping Rates for Different Price Tiers** **Why use this:** For individually purchased cheaper products, free shipping may not be cost-effective, while for more expensive products, you can offer shipping as a bonus for customers. **How to do it:** 1. First, create suitable **product queries** by price tier following the instructions above. 2. On the Rules page, click **New rule**. 3. As the Rule type, select **Set shipping rates**. 4. In the **Queries** field, choose the price tier(s) for which you want to set the shipping price. 5. Fill in the **Carrier and prices** for prepaid and cash-on-delivery shipping. 6. Enter a **Rule name**. 7. Click **Create**. 8. Repeat for other price tiers and remember to **apply** the created rules. ### **Assortment Analysis Using the Segment Report in Pricing Fox** **Why use this:** By dividing your portfolio into price tiers and then analyzing them, you gain insight into which tiers generate the most revenue, clicks, or costs, and can set more effective strategies accordingly. **How to do it:** Use the [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about) extension, where you configure your own price tiers in the **Segment report**. Then choose the metric you want to track (e.g., Revenue or Product count) to get detailed information about your assortment. Based on these insights, you can easily set a more effective marketing strategy. Learn more about the Segment report in [this article](https://pricing-fox.cz/navody/segmentovy-report?utm_source=chatgpt.com#vykon-top-segmentu) or [video](https://www.youtube.com/watch?v=J3zZEfb9JUg). > **Tip!** For example, if you see that a low price tier generates many clicks but low revenue, consider lowering the CPC or increasing the margin for that segment. ### **Advanced Bidding with the Bidding Fox Extension** **Why use this:** Dividing products into price tiers is an ideal foundation for **advanced bidding management using the [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about)** extension. You can set separate strategies for individual segments (e.g., different CPC or PNO targets for budget vs. premium products). **How to do it:** In Bidding Fox, create a new strategy where you select the desired price tier as the target query (you can use queries set up in Mergado or create them directly in Bidding Fox). Set your goals (e.g., CPC, PNO, or position on the advertising platform) and save the strategy. Learn more about setting up strategies in Bidding Fox in [this article](https://www.bidding-fox.cz/prvni-strategie?utm_source=chatgpt.com). > **Tip!** For the low price tier, try setting conservative bidding. For the mid-range tier, optimize bidding based on performance. For the high price tier, choose aggressive bidding with a higher CPC. ## **FAQ** ### **What are price tiers and why should I set them up in Mergado?** Price tiers are product groups (queries) divided by price (e.g., 0–199 CZK, 200–499 CZK, 500–999 CZK, 1000+ CZK). In Mergado, these queries let you customize rules, CPC, or shipping based on product price to make your campaigns more efficient. They also help with assortment performance analysis and identifying which products bring the most profit or cost. ### **How can I set up price tiers?** You can create product queries based on price tiers using the "Dividing products into 5 segments based on price" automation. This automation lets you easily create up to five product queries in just a few clicks. Simply enter the element containing the price (e.g., PRICE_VAT) and the upper price limits for each tier. You can edit or delete tiers at any time. Price tiers can also be created manually, which is the ideal approach if you need more than 5 tiers. ### **Can I edit price tiers created by automation or add more?** Yes. In the Products section, under the Saved queries tab, you will see all the price tiers the automation created. Click a query name to edit it (change limits, conditions, or name), or click the trash icon to delete it. In the Products section, under the Product listing tab, you can create additional price-tier queries manually at any time. ### **What if I need to segment products by more criteria than just price (e.g., brand + price tier)?** In Mergado, you can combine multiple conditions when creating queries using the logical AND operator. For example: BRAND = Nike *AND* PRICE_VAT >= 1000 *AND* PRICE_VAT <= 2000 This creates a query for Nike products priced between 1000 and 2000 CZK. ### **How do I set different CPC for individual price tiers?** 1. First, create suitable product queries by price tier. 2. On the Rules page, click New rule. 3. As the Rule type, select Cost per click pricing. 4. In the Queries field, choose the price tier for which you want to set the cost per click. 5. Choose whether to calculate the cost per click based on: a. Minimum click price – The rule considers the minimum click prices for products in individual categories (minimum prices are set by the advertising platform), and you can increase this price by any amount entered in the Add to minimum CPC field. b. Percentage of product price – In the Percentage of product price field, you set the percentage of the product price you want to offer per click. For example, if you set 1% of the price, a product priced at 500 CZK would have a click cost of 5 CZK. 6. Enter a Rule name. 7. Click Create. 8. Repeat for other price tiers and remember to apply the created rules. Another option is to use the more advanced CPC settings in the [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about) extension. ### **How do I set up free shipping for more expensive products?** 1. Create a product query based on the desired price tier (e.g., PRICE_VAT >= 1500). 2. On the Rules page, click New rule. 3. As the Rule type, select Set shipping rates. 4. In the Queries field, choose the price tier (e.g., PRICE_VAT >= 1500) for which you want to set free shipping. 5. Enter the Carrier and set the price to 0. 6. Enter a Rule name. 7. Click Create. 8. Remember to apply the created rule. ### **How can I find out which price tiers generate the highest revenue?** The [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about) extension and its Segment report are ideal for analyzing price tiers. In the report, set the price tier boundaries and see how many products, revenue, or costs each tier accounts for. Based on this, you can easily adjust bidding, margin, or CPC according to actual performance. Learn more about the Segment report in [this article](https://pricing-fox.cz/navody/segmentovy-report?utm_source=chatgpt.com#vykon-top-segmentu) or [video](https://www.youtube.com/watch?v=J3zZEfb9JUg). ### **How do I know my price tiers are set up correctly?** On the Products page, under the Saved queries tab, check how many products each query contains. If the total of all products across queries matches the overall product count in your feed, the segmentation is complete. If some products are missing, check whether tier boundaries connect properly and do not overlap. ### **How many price tiers can I create?** You can create as many price tiers as you need. The automation lets you quickly and easily create a maximum of 5, but you can manually add more on the Products page. ### **What should I do if price tier queries contain no products?** Check: * whether you are using the correct price element (e.g., g:price or PRICE_VAT), * whether the lower and upper price boundary conditions are set correctly and combined using the "AND" operator, not "OR". --- ## [Everything You Need to Know About Custom Format](https://help.mergado.com/en/mergado-editor/feed-formats-and-advanced-data-scenarios/custom-format/everything-you-need-to-know-about-custom-format/) # **Everything You Need to Know About Custom Format** ## **1. Introduction to Custom Format** ### **What Is Custom Format** Custom Format is a feature that lets you teach Mergado to **recognize and process virtually any XML or CSV file**. It allows you to **load any feed into Mergado, define its structure, and then work with the data just like with standard integrated formats**. It also lets you create an output feed in Mergado in a format that is not among the official integrations. You define the Custom Format yourself – you describe to Mergado which elements it should import or export and how to handle them. This functionality is intended mainly for less common, modified, or machine-unrecognizable formats that Mergado would not be able to load without your definition. ### **What It Is Used For** Custom Format has several key uses: #### **1. Customizing Input and Output** It allows you to adapt the data structure to your needs – both on the input and output side of the project. #### **2. Greater Control Over Data** It helps you precisely determine how product data should be processed, displayed, and exported in Mergado. #### **3. Importing Unknown Feeds** Suitable when working with formats that Mergado does not recognize: supplier feeds, outdated or heavily modified structures, custom feeds, or supplementary feeds (e.g., inventory, travel offers, reviews). #### **4. Preserving the Original Feed Structure** If the input XML contains individual products directly after the root element, Custom Format lets you preserve the original structure without modifications – useful for unstable supplier sources. #### **5. Exporting to a Custom Format** Also used for creating an output feed in a format that Mergado does not yet officially support. This is typical when expanding to new marketplaces or for smaller comparison engines. You just need a sample feed template containing at least one example item. ### **How Mergado Works with Data (Mergado XML and Converter)** #### **Mergado XML** All data conversions in Mergado go through a unified intermediate format called Mergado XML. It serves as a "universal language" into which input data is converted, and from which output formats are then generated. #### **Converter** The converter is a mechanism that translates data between formats. It is used whenever the input and output formats differ. The converter is also activated in cases where both the input and output are in Google Merchants format. #### **Role of Custom Format** Custom Format lets you **create your own converter**. When defining a Custom Format, you explain to Mergado what each part of your feed means and what Mergado XML equivalent it should map to. The most important step (applies only when working with XML feeds): correctly selecting elements for: * **CHANNEL (element name in Mergado XML)** * the so-called Root, i.e., the root element wrapping all products in the XML feed * there is only one such element in the XML feed, * typically its opening tag is at the very beginning of the feed and its closing tag at the very end * the root element name can differ in each feed, examples by format: * Google: * Heureka * Mergado XML * **ITEM (element name in Mergado XML)** * the element wrapping one item (product) * there are as many of these elements in the XML feed as you have items/products, * each product/item has exactly one wrapping element * the product wrapping element name can differ in each feed, examples by format: * Google: * Heureka * Mergado XML These two elements define the structure in which Mergado processes data. ### **When It Makes Sense to Use Custom Format** #### **On Input** * Mergado does not recognize the feed format. * You are working with an unknown, modified, or custom format. * You need to preserve the original feed structure. * You are connecting supplementary data that is not integrated (inventory, services, reviews). #### **On Output** * You need a feed in an unsupported format. * You want control over the root elements and output XML structure. * You have a sample feed from which a template can be created. ### **Limitations and Things to Watch Out For** #### **1. Ignoring Elements Outside ITEM** Custom Format **cannot process elements located above the item wrapping element**. Everything that is not under ITEM is invisible to the Editor for feeds processed via Custom Format. This means **information placed between CHANNEL and ITEM may be lost**. **Solution for complex structures:** split the feed into two projects and rejoin them using the Blending Bull extension. #### **2. Conversion May Cause Data Loss** The converter is applied even when **converting from the same Custom Format to the same one**. If the mapping is not complete, **information may be lost in the new feed** (it remains in the original feed – Mergado simply does not work with it). #### **3. Root Elements on Output** **Root elements are created automatically by Mergado Editor** based on the chosen output format. **They cannot be manually created** as standard elements in the editor. If you need non-standard root elements in the output feed, the only way to influence them is by **choosing the correct template for the Custom Format** used on the output. #### **4. Need for Updates When Changes Occur** If a new element appears in the input file, the Custom Format has no configured behavior for it. Mergado will automatically **import such an element and will not hide it**, so it automatically enters the output feed unchanged. In this case, you need to **update the Custom Format structure** and add mapping settings for the new element. After saving and regenerating the project, the changes will take effect automatically. Alternatively, if new elements cause the output feed to become invalid, the quickest fix is to manually hide the new elements on the Elements page and run a project Export (without applying rules). ## **FAQ** ### **What is Custom Format in Mergado?** Custom Format is a feature that lets you teach Mergado to process virtually any XML or CSV file, regardless of whether Mergado normally supports it. It lets you define which elements the feed contains and how the system should handle them during import and export. It also serves for creating an output feed in a custom format, for example, for platforms or channels that Mergado does not support by default. ### **What is Custom Format used for?** Custom Format lets you adapt the project's data structure to your needs. It helps you precisely control how Mergado loads, displays, and exports product data. It is especially useful for importing non-standard or modified feeds and for exporting to formats not included among integrated channels. ### **When does it make sense to use Custom Format on input?** Custom Format is suitable when Mergado cannot recognize the feed or when you are working with a custom, modified, or supplementary feed that does not fit existing integrations. It also helps when you need to preserve the original feed structure if the XML contains items directly under the root element. You can also use it for supplementary input data such as inventory, services, or reviews. ### **When does it make sense to use Custom Format on output?** Custom Format on output is useful when you need to create a feed in a form that Mergado does not generate by default. This is often about expanding to new platforms or connecting to internal systems with their own XML structure. You just need a sample feed from which Mergado will create the output template. ### **What is Mergado XML and why is it important?** Mergado XML is an internal intermediate format through which all data conversions pass. It works as a "universal language" into which input data is translated, and from which output formats are generated. This means there does not need to be a separate converter for each format pair. ### **What does the converter do?** The converter translates values between data formats – from any input to Mergado XML and from there to the output format. For selected formats (e.g., Google Merchants), it is activated even when the same format is on both input and output. If the mapping is not complete, the converter may omit some values, which is why paying attention to mapping is recommended. ### **What role does Custom Format play in data conversion?** Custom Format lets you create a custom converter tailored to your feed. You precisely specify what individual elements mean and how they should be converted to Mergado XML. This gives you control over data structuring even across platforms that Mergado does not natively know. ### **What does it mean to correctly select CHANNEL and ITEM?** CHANNEL is the root element of the Mergado XML feed and determines where the entire document begins and ends. ITEM is the wrapping element for one item and appears in Mergado XML as many times as you have products. Correct mapping of these two elements is a fundamental prerequisite for Mergado to process your feed. CSV feeds do not have these elements, so mapping them is not needed. ### **What limitations does Custom Format have?** Custom Format cannot process elements that lie outside ITEM, for example, information placed between CHANNEL and ITEM. Mergado ignores these elements and they cannot be worked with directly in the project. If you need to preserve them, a different approach is required, such as the two-project model and merging via Blending Bull. ### **Why can data loss occur during conversion?** Custom Format ignores elements in XML feeds that are located between CHANNEL and ITEM. If such elements contain information you need, a different approach is required, such as the two-project model and merging via Blending Bull. ### **How does Mergado handle root elements on output?** Root elements are created based on the chosen output format and cannot be directly edited. If you need a different structure, you need to use a Custom Format created from a sample feed, or modification via Blending Bull. This ensures the output feed has exactly the header and wrapper you require. ### **What should I do when a new element appears in the input feed?** The new element is automatically imported into the project, but Mergado does not know what to do with it because it is not part of the original mapping. In this situation, you need to update the Custom Format structure and add mapping for the new element. Then you regenerate the project and the data will be loaded and converted correctly. ### **How do I know when it is better not to use Custom Format?** Custom Format is not needed where an official integration exists. If you have doubts, it is advisable to consult support. ### **What is a sample feed for?** A sample feed serves as a template when creating an output Custom Format. Mergado uses it to determine the root element structure, wrapping tags, and other elements that should be preserved in the output. A minimal example is sufficient – even just one product. The sample feed must be available at a URL address. ### **How do I know the Custom Format is configured correctly?** You can tell the format is correctly defined when the project loads all necessary elements and the output feed has the expected structure. The critical point is correct mapping of CHANNEL and ITEM, as well as the pairing element in the project. If the output data matches the required template and no information is lost, the configuration is fine. ### **What should I do if creating a project with Custom Format results in an error?** Check the Custom Format mapping. A common mistake with XML feeds is incorrectly mapped root element or item wrapping element. Both elements can only be mapped once, to one element in your feed. Another common mistake is a poorly chosen pairing element. The safest choice is an element with product IDs, combined with, e.g., an element with EANs or product/image URLs. If you are unsure how to set up the Custom Format correctly, it is advisable to consult support. --- ## **2. Where Custom Format Can Be Created and Managed** In Mergado, you can define a Custom Format in two ways: **directly when creating a project, or in a dedicated section for working with custom formats**. Both approaches complement each other and allow you to create and later reuse any format definition. ### **Definition During Project Creation** When creating a project, you can specify a **Custom Format for both the input feed and the output feed**. This option appears whenever Mergado cannot assign any integrated format to the input file, or when you need to create a specific output. ### **Custom Format on Input** You access Custom Format creation for the input feed in step 3 of the project creation wizard. If the system recognizes the connected feed's structure, it offers the option to change the detected format using the **Select different format** button, and then you can either choose another official format from the dropdown, or create a Custom Format for the input feed using the **Define custom format** button. If the system does not recognize the connected feed's structure, it offers the option to either manually select an official format from the dropdown, or create a Custom Format for the input feed using the Define custom format button. **When creating a Custom Format for the input feed, the system offers two approaches:** * **Simplified walkthrough** – suitable for quick setup of the basic structure. * **Detailed settings** – allows detailed mapping of all found elements. Both methods lead to the same goal: determine **where the feed starts, which elements represent individual products, and which element contains a unique value across all products**. For correct processing of the input feed, you need to map at least: * **the root element (CHANNEL)**, * **the product wrapping element (ITEM)**, * **the product identifier (ITEM_ID)** – an element with a unique value for each item. Of course, you can also map all elements from the input feed, which can simplify subsequent work (for example, reducing the number of rules needed). However, this is not necessary for data import itself. ### **Custom Format on Output** You access Custom Format creation for the output feed in step 4 of the project creation wizard. Use the **Define custom format** button. In the next step, you need to **enter the URL of a sample feed** – a template based on which the Custom Format will be set up and the output feed will be created. Note: The sample feed cannot be uploaded via Upload – a **URL address is required**. If you have the template as a file, create a URL address using cloud storage, e.g., Dropbox, or you can use the Mergado Files extension. If you already have a Custom Format prepared, you can select it as the project's output format. This determines what the final XML or CSV will look like, regardless of whether Mergado normally supports the format. If the format was created from a sample feed, Mergado preserves the root elements and their arrangement. **When creating a Custom Format for the output feed, the system offers only one approach:** * **Detailed settings** – allows detailed mapping of all found elements. * Simplified walkthrough is not available here For correct output feed creation, you need to map at least: * **the root element (CHANNEL)**, * **the product wrapping element (ITEM)**, In this case, Mergado will prepare the output feed, create all elements from the template into the project, but since it does not know what individual elements mean, the **elements will not be populated and need to be set up manually using rules**. Of course, you can also map all other elements from the sample feed, which can simplify subsequent work (for example, reducing the number of rules needed). ### **"Custom Formats" Section in the Main Menu** Standalone custom format management can be found in the left menu of Mergado Editor in the **Custom formats** tab when you are at the **user level** (the left menu changes depending on whether you are managing a user, an online store, or a project). This section serves as a central place for working with all formats created in the account. **Here you can:** * **create a new format** without connection to a specific project, * enter a **URL of a sample file** (example feed), * perform **element mapping**, * **edit or re-analyze** an existing format. This section serves as a central place where you can maintain, test, and prepare custom formats for use in future projects. ### **Reusing Custom Formats** Once you create a Custom Format – whether in the wizard or in the standalone section – it is **saved in Mergado and you can use it indefinitely**: * **on input**, if you want to process another feed with the same structure, * **on output**, if you need to generate a new feed in the same form. If you already have at least one saved Custom Format, the **Pre-fill from** function is available when creating a new Custom Format. It lets you inherit the structure (configured mapping) of an existing format. This speeds up work when you are dealing with multiple formats that have a similar schema. ## **FAQ** ### **Where can I create a Custom Format in Mergado?** You can create a Custom Format in two ways – directly when creating a project or in the standalone Custom Formats section in the left menu. Both methods complement each other and let you prepare a format either quickly during project work or in advance. After saving, the format is available for repeated use in all projects. ### **How do I create a Custom Format on input when creating a project?** In step 3 of the project creation wizard, Mergado offers Custom Format creation when it does not recognize the feed structure or when you manually select "Select different format." You can then use either the simplified walkthrough or detailed settings. You need to map CHANNEL, ITEM (for XML feeds), and ideally also the product identifier so the project can correctly work with items. ### **What is the minimum that needs to be mapped for Mergado to load the feed?** For minimum functionality, you need to map CHANNEL, ITEM (for XML feeds), and one element with a unique value (most commonly ITEM_ID). This is enough for Mergado to identify the document start, individual products, and their unique key. Other elements can be added later. ### **How do I create a Custom Format on output?** It is created in step 4 of the project creation wizard using the Define custom format option. You need to enter the URL of a sample XML file (example feed), based on which Mergado will build the output structure. Then you map at least the basic elements and save the format for use in the project. ### **Why must the sample feed be available at a URL address?** Mergado creates the output format exclusively from a file available via URL because it needs to import the structure during analysis. File upload is not supported. If you do not have your own hosting, you can use a cloud service (Dropbox, OneDrive) or create the file using Mergado Files. ### **Why is the simplified walkthrough not available for the output format?** Only detailed settings are available for the output format. This is intentional because the target structure comes from a sample feed and full control over the conversion to the template is needed. Simplified mapping might not be precise enough for output. ### **What happens if I map only the minimum when creating the output format?** Mergado will create the output feed with root elements from the template and create empty elements in the project based on the template, but elements without mapping will not be populated with any values. These values then need to be added manually using rules. Therefore, it is advisable to add mapping for as many elements from the sample feed as possible. ### **What is the "Custom Formats" section in the left menu for?** This section is for central management of all custom formats in the account. Here you can create new formats, edit existing ones, and update their structure. It is the most suitable place for preparing formats that you will use repeatedly in the future. ### **Can one Custom Format be used in different projects?** Yes, every saved Custom Format is available for repeated use. You can use it on input and output in any number of projects. This is especially useful when working with multiple feeds that share the same structure. ### **What is the "Pre-fill from" option for when creating a new format?** It lets you inherit the structure (element mapping) from a previously created Custom Format. It is ideal when working with multiple formats with the same or similar schema. This way, you do not have to start from scratch with each new format. --- ## **3. Simplified Walkthrough vs. Detailed Settings When Defining Custom Format** When creating a Custom Format on input as part of the new project creation wizard, you can work in two ways: either use the **simplified walkthrough** or switch to **detailed settings**. Both approaches serve the same goal – **explaining the feed structure to Mergado** – but they differ in the **level of control and number of options** they offer the user. The simplified walkthrough is suitable for quick feed processing. Detailed settings provide full control over element mapping and format configuration. ### **Simplified Walkthrough** The simplified walkthrough appears **only when creating a Custom Format on input within the new project creation wizard**. The wizard offers the user a quick path to define the basic structure. The goal is to simplify Custom Format setup for new users by offering mapping of only the most important elements and hiding advanced settings that can be changed later. #### **When It Is Used** * Within the new project creation wizard when setting up the input feed format. * You want to create functional mapping as quickly as possible. #### **What the Simplified Walkthrough Offers** * Display of basic elements in a clear format. * Highlighting of key elements used by advertising channels. * More understandable element names compared to the technical view. * Smart mapping that attempts to automatically assign elements by name and meaning. #### **How Smart Mapping Works** The system **suggests pairing** – e.g., description --> DESCRIPTION, EAN --> EAN, ID --> ITEM_ID. The user then just **checks the suggestions are correct and optionally adjusts** individual choices. #### **When the Simplified Walkthrough Is Ideal** * When you need to start working with data quickly. * When the feed structure mostly follows common conventions. * When it is a one-time or less complex mapping task. ### **2. Detailed Settings (Complete Custom Format Definition)** Detailed settings is the **full version of the interface for defining a Custom Format**. It contains all options available for element mapping. #### **When It Is Used** * The feed has a complex or atypical structure. * You need to precisely control how each element is processed. * You are preparing a format for repeated use or for an output feed. * You need to define the meaning of sub-elements, variants, or parameters. #### **What Detailed Settings Include** **1. Custom Format Parameters** **General configuration** that determines format behavior: * appropriate format name, * country setting (affects currencies), * option to inherit settings from an existing format, * option to split variants into separate products, * definition of a custom category tree. **2. Data Processing Settings (Element Mapping)** The key part that determines **how Mergado interprets individual feed parts**. **Essential elements:** * root element (e.g., CHANNEL), * product wrapping element (e.g., ITEM), * product identifier (e.g., ITEM_ID) – an element with a unique value for each item. **Additional options:** * direct mapping to Mergado XML, * operations for elements without sub-elements (Pass as is, Hide, Element meaning), * special operations for wrapping elements (e.g., DELIVERY, PARAM, VARIANT), * ability to map any number of elements for easier subsequent work in the project. ### **Comparison: Simplified Walkthrough vs. Detailed Settings** |Criterion|Simplified Walkthrough|Detailed Settings| | --- | --- | --- | |Speed of work|Quick basic setup|Longer but more precise| |Level of control|Limited, suitable for simple structures|Full control over every element| |Suitable for|Unknown feeds with standard logic|Complex, modified, or hierarchical feeds| |Smart mapping|Yes – automatic suggestions|Yes – automatic suggestions| |Format parameter settings|Limited|Full (name, country, variants, custom categories)| |Sub-element manipulation|Basic|Detailed, including special operations| |Result accuracy|Sufficient for most common feeds|Highest possible conversion accuracy| ### **Which Approach to Choose** * Use the **simplified walkthrough** if you need to **quickly create a project and the feed has a relatively straightforward structure**. * Choose **detailed settings** if you are working with a **complex feed, preparing an output template, or need to precisely define the meaning of individual elements**. ## **FAQ** ### **What is the simplified walkthrough when creating a Custom Format?** The simplified walkthrough is a variant of the interface in step 3 of the wizard that offers only the most important elements and a faster path to creating functional mapping. It is designed so it does not overwhelm the user with advanced settings and enables a quick start even with unknown feeds. It offers smart mapping that automatically recommends element assignments by name and meaning. ### **When does the simplified walkthrough appear?** It appears exclusively when creating a Custom Format on input, and only when Mergado does not recognize the feed structure or the user manually chooses to define a Custom Format. In these situations, the goal is to speed up basic setup so the project is ready to work with as soon as possible. Detailed settings can be invoked at any time. ### **How does smart mapping work within the simplified walkthrough?** Smart mapping attempts to automatically assign elements by their name and typical meaning. The user just checks the suggested values and optionally adjusts which element should be linked to which Mergado XML equivalent. This step significantly speeds up work, especially with common or simpler feed structures. ### **When is it appropriate to use the simplified walkthrough?** The simplified walkthrough is ideal when you need to start working with data quickly and the feed has a fairly standard structure. It is also suitable for one-time processing or when you do not want to deal with detailed settings right away. If the feed does not contain complex hierarchy, this variant is often sufficient. ### **What are detailed Custom Format settings?** Detailed settings is the full variant of Custom Format creation that allows mapping individual elements and their sub-elements with maximum precision. It also contains all format parameters such as country, name, or variant splitting, and allows defining behavior of more complex structures. This approach is intended for feeds with multiple levels or for output formats being prepared. ### **When is it appropriate to use detailed settings?** Detailed settings is the best choice when the feed contains a complex, non-standard, or multi-level structure. It is also appropriate when you need completely precise control over how data will be processed and exported in the project. It is also essential when preparing a format that will be used repeatedly or on output. ### **What elements must be mapped in both cases?** Whether you use the simplified walkthrough or detailed settings, you always need to specify the root element (CHANNEL) (applies to XML feeds), the product wrapping element (ITEM) (applies to XML feeds), and at least one product identifier (most commonly ITEM_ID). These elements are key for Mergado to correctly load the data feed and identify individual items. Mapping of other elements depends on what you will need in the project. ### **What does detailed settings offer beyond the simplified walkthrough?** Detailed settings allows defining the meaning of every element and setting special operations for elements with sub-elements, such as parameters, shipping, or variants. It also contains all format parameters and offers the option to inherit structure from an existing Custom Format. It thus provides the highest possible data conversion accuracy. ### **Which approach to choose – simplified or detailed?** Choose the simplified walkthrough when it is about quick project creation and the feed has a simple and readable structure. Use detailed settings if you plan to work with the data long-term, or if the feed is complex and requires precise mapping. The choice depends primarily on data complexity and whether speed or accuracy is more important to you. ### **Can the simplified walkthrough replace detailed settings?** Yes, in many simpler cases it is sufficient. However, if the feed contains variants, parameters, multi-level structure, or you plan further exports, detailed settings will be more precise and stable in the end. It is therefore recommended to start with the simplified approach and switch to detailed mode if you find more control is needed. --- ## 4. **Creating a Custom Format – Detailed Settings** Detailed Custom Format settings is the step where you precisely **tell Mergado how to interpret your feed structure**. Based on this information, a **converter between your data format and Mergado XML is created**. This phase follows the analysis of the source file structure. ### **Feed Structure Analysis** When creating a Custom Format, Mergado first **loads and analyzes the connected file**. From its structure, it determines which elements can be mapped and creates an overview of them. ### **What the Analysis Does** * **loads the XML or CSV structure** from the given URL, * **identifies available elements** and their structure, * prepares a **list of elements that can be mapped** to Mergado XML. ### **Structure Update** If a **new element** appears later in the input file, it **needs to be added to the Custom Format settings**. The **Update structure from file** option loads new elements and lets you specify how they should be propagated into Mergado. ### **Setting Basic Custom Format Parameters** In this section, you set **general format parameters**. These options do not concern individual elements but the **behavior of the format as a whole**. #### **Available Parameters** |Parameter|Description| | --- | --- | |Format name|Lets you name the format so it is easy to find. A well-identifiable name is recommended.| |Country|Affects currency configuration.| |Pre-fill from|Loads settings from an existing Custom Format. This option appears only when you already have a Custom Format created. It is hidden during the first setup.| |Split variants|Each variant (e.g., color, size) is processed as a separate product in Mergado.| |Custom category tree|Activates the option to work with a custom category tree and category suggestions (when using the format on output).| ### **Element Mapping (Data Processing Settings)** This section determines how Mergado will **interpret your feed elements**. Mapping defines the **relationship between a specific element and its equivalent in Mergado XML**. #### **Required Elements (applies only to XML)** For functional feed processing, at least these two elements must be mapped: * **CHANNEL** – the root wrapper of the entire feed, * **ITEM** – the wrapping element for one item. Without these two elements, an XML feed cannot be imported. #### **Recommended Elements** Mergado allows mapping **any number of additional elements**. The more elements you map, the less work you will have later with rules, and the better the feed can be converted to other output formats. #### **Operations for Simple Elements** For elements that do **not have sub-elements**, three types of operations can be used: |Operation|Meaning| | --- | --- | |Pass as is|The element is imported and exported as is, unless the Converter rule or user sets it as hidden.| |Hide|The element is imported and set as hidden. It can be used within rules or optionally unhidden manually.| |Element meaning|Assignment of the element to a Mergado XML equivalent. The element is imported, set as hidden, and the Converter rule converts its values to the equivalent element on output.| #### **Operations for Wrapping Elements** For elements that **contain further structure**, special operations can be chosen that enable settings for their sub-elements. **Examples:** * **DELIVERY** – you set the shipping price, carrier name, or code, * **PARAM** – product parameter definition, * **VARIANT** – working with individual item variants. ### **Mapping Impact** * More extensive mapping makes subsequent export to other formats easier. * Minimal mapping requires more work in rules (copying and adding values). * Elements located outside ITEM cannot be processed – Mergado ignores them. ## **FAQ** ### **What does feed structure analysis mean when creating a Custom Format?** Analysis is the first step in which Mergado loads the file from a URL and identifies all available elements. From their hierarchy, it builds a structure that is then offered for mapping. This process determines what can be worked with in the Custom Format. ### **What should I do when a new element appears in the input feed?** You need to open the saved Custom Format definition and use the "Update structure from file" option. This loads the new element into the list and you can specify how it should be processed in Mergado. After saving and regenerating data, the new element becomes part of the project. ### **What are basic Custom Format settings for?** These parameters determine the behavior of the format as a whole and do not address individual elements. They include the format name, country setting, option for working with variants, or activation of a custom category tree. Correct parameter settings simplify future use in other projects. ### **Why is it important to correctly name the Custom Format?** The format name is displayed in the format list and helps with orientation, especially when you have multiple formats. A well-chosen name lets you quickly identify what type of feed the format was created for. This prevents errors during repeated use. ### **How does the "Pre-fill from" option work?** This option makes existing custom formats available and lets you inherit their structure. It is useful when you need to create a similar format or work with feeds that have the same schema. This way, you do not have to map everything from scratch. ### **What do the "Pass as is," "Hide," and "Element meaning" operations mean?** * "Pass as is" - The element is imported and exported without changes, unless the Converter rule or user sets it as hidden. * "Hide" ensures the element is imported and set as hidden. It can be used within rules, for creating queries, or optionally unhidden manually. * "Element meaning" is used for mapping the element to a Mergado XML equivalent. ### **When is it worth mapping additional elements beyond the required ones?** If you plan to export to other formats or will work with data in rules, detailed mapping is significantly beneficial. Fewer mapped elements means more work when adding values in the project. The more precise the mapping, the simpler the further processing. ### **How do special operations for wrapping elements work?** They are used when an element has its own nested structure, such as parameters, shipping, or variants. By selecting a special operation, you enable settings for their sub-elements. This allows you to define in detail how the values of these structures should be processed. ### **Why does Mergado ignore elements outside ITEM?** Custom Format can only work with the part of XML that consists of individual product items. Elements above ITEM, such as information between CHANNEL and ITEM, are not part of the product data model. Therefore, they are ignored during import and the project has no control over them. ### **How do I know the mapping is sufficient?** If you can load the feed, work with data without needing extensive rules, and the export has no information loss, the mapping is set correctly. The critical point is capturing all elements you will later edit or export. If you frequently need to add values using rules, the mapping is probably too brief. ### **What is the relationship between mapping and the converter?** You define the mapping, and the converter converts data to Mergado XML based on it. If you do not map an element, the converter "does not know" about it and does not work with it. Good mapping therefore determines the quality of the entire converted feed. --- ## **5. Custom Format on Input** Custom Format on input is used for **loading data feeds that Mergado does not recognize** and **converting them to the internal Mergado XML structure**. This allows processing virtually any XML or CSV file in Mergado. ### **When Custom Format on Input Is Used** The need to define a Custom Format arises when the **system cannot determine the input feed structure** and displays information that the format is unknown. In this situation, it **offers to create a Custom Format**. ### **Typical Scenarios** * **Supplier feeds** or otherwise structured XML/CSV, * **Custom feeds made to order.** Typically for larger online stores. * **Outdated or heavily modified** variants of known formats, * **Supplementary feeds**, such as inventory or service feeds, * Feeds providing **other types of services** (reviews, travel offers). * etc. ### **Steps for Creating a Custom Format When Importing a Feed** Custom Format definition takes place in step 3 of the project creation wizard. 1. Create a new project and enter the input feed URL. 2. If Mergado does not recognize the structure, choose **Define custom format**. 3. Map the required elements: * **CHANNEL** * **ITEM** 4. Map **additional elements** you will work with in the project (URL, NAME, ITEM_ID, ...). 5. **Name and save** the format. 6. In step 4, you can * Keep the same Custom Format on output as well, so the feed structure will not change. * Use the dropdown to select another official format, e.g., Google, Meta, etc. * Create a new Custom Format for output. 7. In the last step, **verify that pairing elements are selected**. If not, they need to be configured. ### **Pairing Element Configuration** The **pairing element is a key piece of data** that Mergado uses to uniquely **identify each item** in the project. **What Is Important:** * It must have a **unique value for each product**. * Most commonly, the **element with product IDs** or another unique identifier (URL, EAN, ...) is used. * In the summary step, you need to **verify** the pairing element is correctly selected. The pairing element works like a "national ID number" for each item. It lets Mergado safely track and process individual products regardless of how their values change during work. ### **How Many Elements to Map** #### **Minimum – for Functionality** For import, mapping only the required elements (CHANNEL, ITEM, and optionally ITEM_ID) is sufficient. #### **Maximum – for Efficiency** Mapping more elements means simpler work in subsequent project steps. **Benefits of detailed mapping:** * fewer rules needed for copying values, * faster conversion to other output formats, * better readability and project stability. **Impact example:** If you do not map the product name element, you will have to add it later to the format using a rule. If you map it during the Custom Format definition, Mergado will then correctly convert it to the output feed automatically. ### **Updating structure when the feed changes** If **new elements** appear in the input feed, the **saved Custom Format will not automatically pick them up**. You need to: 1. Open the Custom Format 2. Click **Update structure from file**. 3. **Assign processing methods** to the newly found elements. 4. **Save and regenerate** projects using this Custom Format. This ensures consistent feed processing even after changes. ## **FAQ** ### **When is it necessary to use Custom Format on input?** You use Custom Format when Mergado cannot recognize the input feed structure and displays information that the format is unknown. Typically these are supplier, custom, outdated, or heavily modified feeds. In these situations, you need to explain the data structure to Mergado so it can process them. ### **What types of feeds most commonly require Custom Format on input?** Most commonly these are supplier and custom feeds that have no public specification or differ from standards. This also includes supplementary feeds such as inventory, service, or feeds containing services like reviews or travel offers. Custom Format is also used for modified or outdated versions of otherwise known formats. ### **How does creating a Custom Format during import work?** Creation takes place in step 3 of the project creation wizard, where you choose "Define custom format." Then you map the required elements CHANNEL and ITEM (for XML feeds) and other items you will work with in the project. Finally, you save the format. ### **What is a pairing element and why is it so important?** The pairing element is data that lets Mergado uniquely identify each item. It must have a unique value for each product – most commonly ITEM_ID, URL, or EAN. Without a correctly configured pairing element, the feed cannot be imported correctly or changes properly paired. ### **How many elements should be mapped when defining a Custom Format?** For basic functionality, mapping CHANNEL, ITEM (for XML feeds), and one unique identifier is enough. However, if you want to minimize later work, it is advisable to map additional elements as well, since this simplifies work with rules and makes conversion to other output formats easier. Detailed mapping improves project stability and clarity. ### **What happens if I do not map some important elements?** Unmapped elements will appear in the project, but Mergado will not be able to use them correctly and they will need to be added manually using rules. This leads to higher workload and can cause errors during export. Precise mapping therefore significantly simplifies later work. ### **How should I proceed when new data fields appear in the input feed?** You need to open the Custom Format definition and use the "Update structure from file" option. Mergado will load the new elements and you assign processing methods to them. Then you regenerate the project for the changes to take effect. ### **Can Custom Format be used even when Mergado recognizes the format?** Yes, in some cases it may be advantageous to create a Custom Format even for a recognized feed, for example, if you want to preserve the original structure or need to work with elements that the standard converter does not take into account. In this case, simply choose "Select different format" and then define your own. ### **What should I do if I am not sure the Custom Format is configured correctly?** It is recommended to check the loaded elements, pairing element, and the project's output feed structure. If you see all the values you need to work with and data pairs correctly, the format is fine. If you encounter issues, it is better to go back to mapping or contact support. --- ## **6. Using Custom Format on Output** Custom Format on output is used so that Mergado can **generate a product feed in a structure it does not support by default**. It is suitable anywhere you need the output file to exactly match the specific requirements of a platform, system, or internal processes. ### **When Output Custom Format Is Used** **You will primarily use an output Custom Format in situations where:** * you need a feed for a **platform not integrated in Mergado**, * you are creating a connection to a **new e-commerce channel**, * you work with **smaller comparison engines or internal systems** with their own data structure, * you need to **achieve a specific root element structure** (e.g., ...). Output Custom Format lets you define the output feed appearance so it exactly matches the required format. ### **What Is a Sample Feed and Why Is It Needed** An output Custom Format is **created based on a sample feed** – a sample XML or CSV file containing at least one item. ### **Why the Sample Feed Is Important** * It serves as a **template that Mergado uses to learn** what the final feed should look like. * It defines the **root elements** you want in the target structure. * It can be entirely **fictional** – a single fictional item is sufficient; the actual values do not matter. ### **Sample Feed Requirements** * must be **available at a URL address**, * must contain the **root structure** you want in the output, * can have **minimal content**, for example: `` `` `` `1` `` `` ### **How to Create a Sample Feed** There are two ways: #### **1. Manual File Creation** * prepare the XML in a text editor, or CSV in a spreadsheet editor, * save it on a server, * make it accessible at a URL address. #### **2. Using the Mergado Files Extension** * activate the Mergado Files extension, * create a new file, * paste a sample item, which you can obtain, for example, from comparison engines, * save it as XML or CSV, * you get a URL to use when defining the format. Mergado Files is ideal if you need to quickly edit or test the sample feed. ### **Steps for Creating a Custom Format on Output** An output Custom Format is created either **in advance in the Custom Formats section** in the left menu at the user level, or directly **during new project creation** in step 4 of the wizard. 1. Open **Custom Formats** and click **New custom format**. 2. In the **Source file** field, enter the **sample feed URL**. 3. **Name** the format. 4. **Map elements:** * the minimum is **setting the root wrapping elements** (CHANNEL, ITEM), * it is recommended to **map all elements** you will generate in the output. 5. **Save the format.** After saving, the Custom Format becomes **reusable**. In every project, it can be selected as the output (or input) format. ### **How Mergado Generates the Output Feed from a Custom Template** The output Custom Format **determines the final feed structure**. When generating output, Mergado: * uses root elements exactly as they were in the sample feed, * uses the defined mapping to convert values from your input feed to the resulting format, * preserves the order and structure of elements according to the template. This allows you to quickly create any XML or CSV feed without needing Mergado to develop a new integration. ### **Mapping Efficiency** Although mapping only the minimum is enough for the output feed, it is more beneficial to **define mapping as thoroughly as possible**: * you gain better control over the result, * you reduce the need for rules to fill in values, * you enable easier reuse of the format in other projects. ## **FAQ** ### **When does it make sense to use Custom Format on output?** You use Custom Format on output whenever you need a feed in a structure that Mergado does not offer by default. Typically this involves connecting to a new platform, a smaller comparison engine, or an internal system with its own structure. It lets you precisely control the output XML or CSV format, including root elements. ### **What is a sample (example) feed and what is it for?** A sample feed is a sample XML or CSV file containing at least one item that matches the target structure you want to generate. Mergado uses it to load root elements, internal structure, and element order. It serves as the template for generating the output feed. ### **Does the sample feed need to be real, or can it be fictional?** The sample feed can be entirely fictional – one item with minimal values is enough. What matters is that it has the correct element structure, not specific data. Values like ID, name, or price are just examples in this context. ### **Why must the sample feed be available at a URL address?** Mergado loads the structure directly from a URL so it can use it as a source during analysis. File upload without a URL is not possible. If you do not have your own hosting, you can use cloud services or the Mergado Files extension. ### **How can I create a sample feed?** Either prepare an XML or CSV in a text/spreadsheet editor and save it on a server with a public URL, or use the Mergado Files extension. In Mergado Files, create a new file, paste a sample item, save it in the correct format, and get a URL for use in the Custom Format. The second option is suitable if you need to modify the sample feed on an ongoing basis. ### **How does creating a Custom Format on output work?** In the Custom Formats section, choose "New custom format" and enter the sample feed URL as the source file. After analyzing the file, name the format and map the needed elements, at minimum CHANNEL and ITEM. The saved format can then be selected as the output format in any project. Alternatively, you can create a Custom Format directly during new project creation in step 4 of the wizard by clicking Define custom format and entering the sample feed URL. After saving the Custom Format, you return to the wizard where the created Custom Format will be filled in as the output format. ### **How does Mergado use the Custom Format when generating the output feed?** During export, Mergado starts from the template loaded from the sample feed, preserving its root elements and structure. Using mapping, it converts values from Mergado XML to the correct elements in the output. The result is a feed in the form that matches your requirements without custom programming. ### **What happens if I map only the minimum elements in the output format?** Mergado will create the output feed with the correct structure, but elements will not be populated with data. Values of unmapped elements will need to be added using rules or other project settings. This approach works but is less efficient for long-term use. ### **Why is it worth mapping as many elements as possible on output too?** Detailed mapping gives you better control over how data is written to the output and reduces the number of rules you have to create in the project. It also simplifies reuse of the same format in other projects. It is especially worthwhile when the format serves multiple clients or multiple online stores. ### **Can the output Custom Format also be used as input?** Yes, once a format is created, it is available in the format list for both input and output. This can be useful, for example, for transformations between different internal systems or for data verification. --- ## **7. Working with More Complex XML Structures** This section describes situations where the data feed contains **elements placed outside the usual product structure**, i.e., outside the ITEM element. For these feeds, Custom Format has certain limitations and alternative approaches need to be used. ### **Custom Format Limitations During Import** Custom Format can only **work with elements located inside the chosen item wrapping element** (ITEM). Elements that are **above it in the hierarchy or outside it are ignored by Mergado Editor**. ### **Information Between CHANNEL and ITEM** * Some XML feeds contain additional data levels between CHANNEL and ITEM (e.g., categories, shipping, metadata). * These elements are not part of the item itself and therefore are **not loaded during import**. ### **Typical Examples of Problematic Feeds** * XML feeds with global category information stored outside products, * data sources where shipping information is defined at the CHANNEL level, * complex feeds with multi-level structure between the root element and individual items. ### **Solution: Two-Project Model + Blending Bull** If you need to **preserve the entire XML feed structure**, including elements outside ITEM, you can use a **two-step approach**: 1. **First project** – contains products. 2. **Second project** – contains supplementary information not part of ITEM. 3. **Merging** – output data from both projects is combined using the Blending Bull extension. #### **How the Two-Project Model Works** |Step|Product Project|Specification Project| | --- | --- | --- | |CF Definition|Map CHANNEL and the product wrapping element (ITEM).|Keep CHANNEL the same. For ITEM, choose the wrapper that contains supplementary information.| |Pairing element|Choose an element with a unique value for each product.|Choose an identifier that is unique for items.| |Input|Uses the original feed.|Uses the same input feed.| #### **Merging with Blending Bull** 1. Activate the **Blending Bull** extension. 2. In the **Data Sources** section, select **outputs** from both projects. 3. In the **Files** section, create a **new output file** and then select the **created data sources from the previous step**. 4. Add **modifications using rules** as needed. #### **Why This Approach Works** Each project loads only the part of the structure that Mergado can work with. Blending Bull then lets you rejoin both parts and get the **complete data output**. ### **Editing Root Elements on Output** **Root elements of the output feed cannot be directly edited in Mergado.** If you need a different wrapper element structure, there are two alternatives: **editing via Blending Bull, or creating a custom template**. #### **Editing via Blending Bull** Blending Bull lets you work with the output feed as a text file. This allows editing: * root elements, * header, * footer, * element names. **Find and Replace Rule** Using rules in Blending Bull, you can make bulk element name changes. For example: * SHOP --> PRODUCTS, SHOPITEM --> PRODUCT. This makes it easy to modify the output structure without intervening in the project itself. #### **Alternatives to Blending Bull (for Output Structure Control)** There are two other ways to influence the output structure: **1. Creating a Template Using Custom Format** * Use a fictional or existing feed with the desired root elements. * Use this feed when creating a Custom Format on output. * Mergado will then preserve root elements exactly as they were in the example feed. **2. Requesting a New Integrated Format** * If you have the target format specification, you can contact Mergado support. * The format may be added among officially supported integrations. * It can then be selected as a regular output format. * However, adding a new format must go through a prioritization process and may take longer. ## **FAQ** ### **Why does Mergado ignore certain elements in the input XML feed?** Custom Format can only work with elements located inside the item wrapping element (ITEM). Everything outside it – for example, elements between CHANNEL and ITEM – is not processed during import. This information is not part of product data and therefore the Editor does not see it. ### **How do I know the feed is problematic and requires a special approach?** The simplest approach is to open the output feed and compare it with the input feed. Typical examples are feeds where categories, shipping, or other metadata are placed at the CHANNEL level or in several layers above ITEM. If important data is missing after import, it is a sign that it is located outside the structure Mergado can load. In such situations, an alternative approach is needed. ### **What is the two-project model and when should I use it?** The two-project model is used when you need to preserve or process parts of the XML feed that do not belong under ITEM. One project loads products and the other loads supplementary information. Then both outputs are merged using the Blending Bull extension. ### **How does the two-project model work in practice?** In the product project, you map CHANNEL and ITEM representing individual items. In the specification project, you keep the same CHANNEL but choose the wrapping element of supplementary information as ITEM. Both projects load the same input feed, and Blending Bull then combines them into a single output. ### **Why is Blending Bull essential for merging complex structures?** Mergado itself cannot combine data from two different projects with different objects (products). Blending Bull creates an output file to which you can add both outputs and optionally modify them further using rules. This gives you a complete data structure matching the original feed. ### **What are "Find and replace" rules in Blending Bull for?** These rules let you bulk-change element names, root tags, or parts of the header and footer. This is a solution for cases when you need to modify the output feed to match a specific format. This way, you can, for example, rename SHOP to PRODUCTS or other key elements. ### **Can root elements of the output feed be directly edited in Mergado?** No, root elements cannot be directly edited in the standard interface. They can be influenced either by creating a Custom Format based on a sample feed, or through edits in Blending Bull. Both approaches ensure the correct output structure. ### **When does it make sense to create a custom template using an output Custom Format?** If you have a clearly defined output XML structure, for example, a partner specification or your own system, an output Custom Format is the cleanest solution. By defining the format from a sample feed, you ensure Mergado always generates data in the required form. This approach is the most stable for long-term use. ### **Is it possible to request adding a new official format to Mergado?** Yes, if you have documentation and a clear specification of the target format, you can ask support to add it among official integrations. This process is subject to prioritization and may take longer. If you need results quickly, an output Custom Format or Blending Bull is a faster path. ### **How do I know the two-project model is needed?** If information that is located outside ITEM is missing after import, or if the feed contains multiple levels above products, the two-project model is usually the only way to preserve the complete structure. It is also needed when you need to combine product data with global information stored outside the items themselves. --- ## **8. Terminology Explained** ### **Mergado XML as a Universal Language** **Mergado XML works as a universal intermediate format through which Mergado converts all product data.** There is no need for a separate converter for each input and output format pair – one shared structure into which data is translated is sufficient. ### **Custom Format as a Dictionary and Grammar Rules** Custom Format determines **how individual elements of your feed "translate" into Mergado XML**. It is a set of rules that lets Mergado recognize the structure of virtually any feed. ### **Sample Feed as the Target Language** When creating an output format, the **sample feed serves as the definition of what the resulting structure should look like**. Mergado loads from it: * the root structure, * element names, * item organization. This gives you an output feed precisely matching your own specification. ### **Conversion Examples** * **Import (supplier feed --> online store format)** * Mergado prepares the structure to be compatible with the online store format, including prices, availability, or parameters. * **Export (internal data --> Heureka, Google, custom platforms)** * If the platform does not offer a direct export, Custom Format lets you create an output that meets the required specification. --- ## [CDATA in Mergado](https://help.mergado.com/en/mergado-editor/feed-formats-and-advanced-data-scenarios/technical-format-details/cdata-in-mergado/) # **CDATA in Mergado** ## **What is CDATA and why does it matter?** CDATA (short for *Character Data*) is a way to protect a portion of text in XML from being interpreted as code. In e-commerce feeds, it is mainly useful where elements contain HTML or special characters — typically in `` or ``. Without CDATA, HTML tags (e.g. `

`, ``) could be read as XML elements, which leads to an invalid feed or lost content. ## **What is CDATA?** CDATA marks a section of text that is **not parsed as XML** and remains exactly as written. **Example:** ```xml Stylish shirt made of cotton

]]> ``` Without CDATA, the HTML tags `

` and `` could be interpreted as XML elements and cause an error in the feed. ## **How to add CDATA in Mergado?** ### **A) The easiest way (recommended): via the Elements tab** 1. Go to the **Elements** tab. 2. For the desired element (e.g. `DESCRIPTION`), click the **CDATA** icon. 3. **Regenerate the output feed**: **Settings → Regeneration**, so the change takes effect. 4. Need to remove CDATA? Simply **toggle the wrapping off** again for the same element. ### **B) Manual method: using the Rewrite rule** 1. Create a **Rewrite** rule for the given element. 2. In the **New value** field, enter the CDATA wrapper, e.g.: ``` ``` 3. After regeneration, you will see something like this in the output feed: ```xml ``` ## **Practical tips** * **Use CDATA** for elements with HTML formatting (e.g. `DESCRIPTION`) or special characters. * After every change, **remember to regenerate** the feed (**Settings → Regeneration**). * When CDATA is missing, some HTML tags may **break validation** or **not display** correctly. ## **FAQ** ### **What exactly is CDATA?** It is a section in XML whose content is **not interpreted as code** but is taken literally as text. ### **When should I use CDATA?** When an element contains **HTML** or special characters — most commonly with `DESCRIPTION` or `LONGDESC`. ### **What is the quickest way to wrap an element in CDATA in Mergado?** In the **Elements** tab, click the **CDATA icon** for the element in question, then **regenerate** the feed. ### **How do I add CDATA manually?** Create a **Rewrite** rule and enter the CDATA wrapper as the new value, e.g. ``. ### **Do I need to do anything after making the change for it to take effect?** Yes, you need to **regenerate the output feed**: **Settings → Regeneration**. ### **What happens if I don't use CDATA?** HTML tags may be treated as XML tags, leading to **validation errors** or **loss/corruption of content**. ### **Can I turn off CDATA wrapping again?** Yes, in the **Elements** tab, simply **disable the wrapping** for the element using the same icon. --- ## [JSON in Mergado](https://help.mergado.com/en/mergado-editor/feed-formats-and-advanced-data-scenarios/technical-format-details/json-in-mergado/) # **JSON in Mergado** In Mergado, the most commonly used file formats are **XML** and **CSV**. However, the Editor also accepts **JSON**, **TSV**, and **TXT**. It may happen that a supplier provides a JSON feed and you need to upload it to Mergado. If the JSON does not load or returns an error when creating a project, the most common cause is an **incorrect format or content** of the feed. ## **What is JSON?** JSON is a **lightweight text format for data exchange**. It is human-readable and at the same time easily processed by programs — a universal language for passing structured data between systems. ## **What should a JSON feed look like?** To be able to **upload a JSON feed URL** into Mergado, it needs to be **a list (array) of objects**. Example of a prepared and valid JSON array with two items: ```json [ { "ITEM_ID": "342", "AVAILABILITY": "preorder", "URL": "https://wp533.mergadoshop.com/produkt/woocommerce-simple-product-test/", "NAME_EXACT": "WooCommerce Simple product TEST", "CURRENCY": "EUR", "VAT": "21", "PRICE": "0.068302", "PRICE_VAT": "0.08", "IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2020/06/tricko-nastvany-bily-tygr-white-edition.jpg", "PARAM": [ { "NAME": "Size", "VALUE": "SM | S | M | L" }, { "NAME": "EAN", "VALUE": "ean222" }, { "NAME": "Ear accessories", "VALUE": "Second property, example" } ], "STOCK_QUANTITY": "0", "DESCRIPTION_SHORT": "[WCMC]", "CATEGORY": "Pillows", "CATEGORY_ALTERNATIVE": [ "Uncategorized", "Tea, coffee" ], "PRODUCTNO": "SKU01-6", "VISIBILITY": "public", "CATALOG_VISIBILITY": "visible" }, { "ITEM_ID": "11089", "AVAILABILITY": "in stock", "URL": "https://wp533.mergadoshop.com/produkt/voyage-451-mikina-damska/?attribute_pa_barva=cerna&attribute_pa_varianta=xs", "NAME_EXACT": "Voyage 451 Women's Sweatshirt - black, XS", "CURRENCY": "EUR", "VAT": "21", "PRICE": "650", "PRICE_VAT": "786.5", "IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg", "PARAM": [ { "NAME": "Color", "VALUE": "black" }, { "NAME": "Variant", "VALUE": "XS" } ], "STOCK_QUANTITY": "156", "DESCRIPTION": "slightly fitted cut with side seams\nfull-zip metal zipper\nzipper pull with engraved logo\nlined hood with drawstring\ninner neckline finished with tape\nraglan sleeves with decorative stitching\nkangaroo-style patch pockets\nbottom hem and sleeve cuffs made of 2:2 rib knit with 5% elastane\ncontrast details\ninner side unbrushed slightly fitted cut with side seams\\nfull-zip metal zipper\\nzipper pull with engraved logo\\nlined hood with drawstring\\ninner neckline finished with tape\\nraglan sleeves with decorative stitching\\nkangaroo-style patch pockets\\nbottom hem and sleeve cuffs made of 2:2 rib knit with 5% elastane\\ncontrast details\\ninner side unbrushed", "DESCRIPTION_SHORT": "Fill knit fabric, inner side unbrushed\n100% cotton (color 12 - composition may vary - 85% cotton, 15% viscose)", "CATEGORY": "Uncategorized", "VISIBILITY": "public", "CATALOG_VISIBILITY": "visible", "IMAGE_ALTERNATIVE": [ "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_bw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_cw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_aw600.jpg", "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_bw600.jpg" ], "SHIPPING_WEIGHT": "500 g", "ITEMGROUP_ID": "11088", "VARIANT_DESCRIPTION": "slightly fitted cut with side seams\\nfull-zip metal zipper\\nzipper pull with engraved logo\\nlined hood with drawstring\\ninner neckline finished with tape\\nraglan sleeves with decorative stitching\\nkangaroo-style patch pockets\\nbottom hem and sleeve cuffs made of 2:2 rib knit with 5% elastane\\ncontrast details\\ninner side unbrushed" } ] ``` ## **Practical examples** * You have a JSON from a supplier and Mergado does not load it when creating a project → check whether it is a **list of objects** in the format shown above. * Your project output needs to be **XML**, but your JSON contains element names that are not valid for XML (e.g. they start with a number or contain spaces) → these elements need to be **hidden** in the project if the goal is XML output. ## **Tips** * **Native JSON formats** that Mergado supports (currently **only Shopify**) **do not need** to follow the format described above. * Need to convert a different JSON (or any file in general) into the required list-of-objects format? This can often be done via the **Blending Bull** extension. * **JSON, like CSV, may contain element names that are invalid for XML** — if your target is XML output, **hide them** in the project. ## **FAQ** ### **Can I use a JSON feed in Mergado?** Yes. In addition to XML and CSV, the Editor also supports JSON, TSV, and TXT. ### **What is the most common reason a JSON feed fails to load?** A format or content that does not match the requirements. ### **How must the JSON be structured for it to be uploadable?** As a **list (array) of objects**: `[ { …product_1… }, { …product_2… } ]`. ### **Does this format apply to all "native" JSONs?** No. **Native JSON formats** in Mergado (currently **only Shopify**) **do not need** to follow it. ### **I have a different JSON — how do I convert it to the required format?** This can often be done using the **Blending Bull** extension. ### **What if the JSON contains names that are unsuitable for XML?** If your output is **XML**, **hide** elements in the project that are invalid for XML (e.g. they start with a number or contain spaces). --- ## [How Mergado Helps You Advertise on Heureka](https://help.mergado.com/en/mergado-editor/advertising-channels-and-listings/heureka/how-mergado-helps-you-advertise-on-heureka/) # **How Mergado Helps You Advertise on Heureka** Do you want to expand your sales into the Czech Republic and Slovakia and reach millions of new customers? Then **Heureka is one of the key advertising channels for you**. It is the **most widely used product search engine in the Czech Republic and Slovakia**. It works as the largest price comparison site in the region and also as a marketplace where customers can buy directly. To display your **products on Heureka correctly, you need to provide product data in the [correct XML format](https://sluzby.heureka.cz/napoveda/xml-feed/#utm_source=chatgpt.com)**. Mergado lets you prepare them for Heureka exactly according to their requirements – without any advanced programming. ## **What Mergado Can Help You With** Mergado is a tool that lets you: * easily **convert your feed into Heureka format** (Heureka.cz and Heureka.sk), whether you are converting a feed directly from your online store platform (e.g., Shoptet, WooCommerce, Upgates, etc.) or from another feed format (e.g., Google Shopping) – all **without a developer**, * run a free **[Feed Audit](https://audit.mergado.com/)** at any time, which **detects errors and immediately recommends fixes**, * automatically **pair your products with the correct Heureka categories**, * **edit the feed** according to your needs so you only advertise what brings you profit (e.g., hide sold-out or seasonal products), * **fix feed errors**, * automatically **manage bidding** (click prices), **pricing**, and **product images**, * **analyze** and continuously **improve** your advertising. ## **Heureka Formats Supported by Mergado** Mergado supports the full set of Heureka-specific formats that are essential for your advertising to work properly: * **Heureka – product** * **Heureka – availability** * **Heureka – conversion** * **Heureka – shop reviews** * **Heureka – product reviews** ### **Heureka Product XML Feed** The most important format for you is Heureka.cz - product [CZ] or Heureka.sk - product [SK]. **You must send your product data to Heureka in this format** – Heureka does not accept any other format. To convert your feed format to the Heureka format, simply choose the appropriate input format (your feed format – Mergado will recognize it automatically in the vast majority of cases) and **select Heureka.cz - product [CZ] or Heureka.sk - product [SK] as the output format** when creating a project. Mergado will automatically (through the "Converter" feature) take care of the **correct output data structure** required by Heureka. Read the article on how to create a new project step by step. ### **Heureka Availability XML Feed** The availability feed contains **up-to-date information about your products' stock levels and availability**. It is not mandatory, but providing it ensures that Heureka always displays the correct availability of your products. Your online store platform should **generate the availability feed**, but you may want to edit it before sending it to Heureka (for example, if your availability feed does not exactly match [Heureka's requirements](https://sluzby.heureka.cz/napoveda/dostupnostni-feed/)). If your online store system does not generate this feed, you can **create it in Mergado**. In these cases, set **Heureka.cz – availability [CZ] or Heureka.sk - availability [SK]** as the output format when creating a project. ### **Heureka Conversion / Shop Reviews / Product Reviews XML Feed** These three feed format types are **generated by Heureka itself from your data**. You will use them primarily if you want to transfer your Heureka reviews to Google Merchant Center so they can appear directly in your Google ads. ## **How to Connect the Mergado Output Feed to Heureka** You have created a project, your online store data flows into Mergado, you have edited it according to your needs, and Mergado has created an output feed in Heureka format. To get the data flowing into Heureka, you need to paste the output feed URL into your Heureka account administration. 1. In the selected project in Mergado, go to the **Overview** page and **copy the output feed URL** (the output feed URL is in the field at the top right of the page). 2. Log in to your **Heureka.cz or Heureka.sk account** and click **E-shop administration**. 3. Go to the **Overview** page and click **Edit shop**. 4. In the **E-shop information** section, paste the copied output feed URL from Mergado into the **XML import URL** field and **save** the changes. ## **Why and How to Connect Heureka with Mergado Keychain** For your Heureka advertising to be successful, you need to continuously **analyze its performance and make adjustments based on the results**. The **Analytics** page in each Mergado project gives you the ability to easily track **your advertising performance through clear charts and tables**. To display analytics, you need to ensure that the necessary data not included in the product feed (such as order information) **flows from your Heureka account into Mergado**. You do this by **connecting Heureka with Mergado through the Mergado Keychain extension**. Keychain serves as a **secure storage** where you enter your Heureka login credentials, and Mergado will then **automatically download the data needed for analytics**. You will not need to enter credentials into Mergado every time you want to check analytics. (Read more about the Mergado Keychain extension.) Data from Heureka is loaded into Analytics with a delay – always **in the morning for the previous day** – and Mergado works with a **70-day time window**. This means Analytics in Mergado stores and displays data for the last 70 days, with new data for the previous day added each day. You will also need the Mergado–Heureka connection through Keychain when you decide to use any Mergado [extensions](https://store.mergado.com/) that work with Heureka data (e.g., [Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about), [Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about)). ### **How to Connect Heureka via Mergado Keychain** Mergado Keychain is **free for Mergado Editor users and is activated automatically when creating a project**. You just need to **create the connection** with Heureka. 1. On the [main page](https://app.mergado.com/) of Mergado Editor, **click the online store** for which you want to set up the Heureka connection in Keychain. 2. In the left sidebar, you will see a list of your active extensions. Click **Mergado Keychain**. 3. In the **Connections** section, select **Heureka** and click **Create**. 4. Enter your **login credentials** and choose whether to create a connection for **Heureka.cz or Heureka.sk**. 5. Confirm by clicking **Log in**. > **Tip!** If you **change your login credentials (e.g., password) in your Heureka account, do not forget to update them in Mergado Keychain** as well. Otherwise, Keychain will report a connection error. Simply delete the connection and recreate it with the new credentials. You can create a connection with your **Google Analytics** account in Mergado Keychain the same way, and Mergado Analytics will also work with that data. Follow the same steps as for Heureka, but when creating the connection, select Google Analytics 4, log in with your Google account, and approve Mergado's access to your data. When connecting Google Analytics, keep in mind that Analytics may show discrepancies in numbers due to the combination of different data sources. For even more detailed analytics, you can also **add Mergado Analytical XML through Mergado Keychain**, which lets you easily and clearly track **the cost of goods or calculate profit**. You can find instructions on how to create the XML analytics file [here](https://www.mergado.cz/sites/default/files/users/documents/shopsystems/mergado-xml-analytic-1-1.pdf). Then, in Mergado Keychain, paste the created file URL in the Sources section and click Save. > **Tip!** If you want to make sure no one **accesses sensitive data** like your cost of goods, restrict file access to the Mergado application only. Mergado accesses the Mergado Analytical XML from this **IP address: 81.31.39.112**. Check out what other IP addresses Mergado uses. ## **FAQ** ### **What is Heureka and why advertise on it?** Heureka is the most widely used advertising platform in the Czech Republic and Slovakia. It works as both a price comparison site and a marketplace. It provides high reach and is ideal for online stores that want to reach millions of shoppers. ### **How does Mergado help me with advertising on Heureka?** Mergado lets you easily prepare product data exactly according to Heureka's requirements without any programming. It helps with data editing, category and product pairing, bidding, and performance analysis. ### **What are the main benefits of using Mergado?** * Data conversion to Heureka format (for both Czech and Slovak Heureka) – Mergado converts your product feeds from various sources (Shoptet, WooCommerce, Upgates, Google Shopping, etc.) into a format that exactly matches Heureka's requirements. * Free feed audit – you can run an audit of your product feed at any time to detect errors and get immediate fix recommendations. * Product pairing – with Mergado, you can easily edit data so your products can be paired with the corresponding product cards on Heureka and become visible to customers. * Bulk and automatic feed editing – using easy-to-configure rules, you can automatically and in bulk edit data for thousands of products. For example, segment products, hide sold-out or seasonal items, set CPC, rename categories according to Heureka's category tree, and more. * Feed error fixing – easily fix errors that prevent advertising or reduce its performance, even without programming knowledge. * Automatic bidding (CPC), pricing, and image management. * Performance analytics and continuous advertising improvement. ### **What Heureka formats does Mergado support?** Mergado supports the full set of Heureka-specific formats that are essential for your advertising to work properly. These include the product feed format (essential for displaying your products on Heureka), availability feed (which provides Heureka with stock and availability data), and also feed formats generated by Heureka itself that you can use, for example, when transferring reviews from Heureka to Google Merchant Center (conversion, shop reviews, and product reviews). ### **What is the Heureka product feed and how do I create it in Mergado?** It is a format that exactly matches Heureka's specification and ensures your advertising works. In Mergado, you create a project where you paste your product feed URL as the input. As the output feed, choose Heureka.cz - product [CZ] or Heureka.sk - product [SK]. Mergado will ensure your data in the output feed is structured exactly as Heureka requires. At the same time, Mergado lets you edit your data easily, automatically, and in bulk – even without programming knowledge. ### **What is the Heureka availability feed for?** The availability feed contains data about the current stock levels and availability of your products. It is a supplementary feed to your product feed. It is not mandatory, but it ensures correct availability display on Heureka. Heureka downloads it every 10 minutes, ensuring frequent availability updates and minimizing clicks on products that appear available on Heureka but may already be sold out in your online store. It can usually be generated by your online store platform. If not, you can create or edit it in Mergado by choosing Heureka.cz - availability [CZ] or Heureka.sk - availability [SK] as the output format. ### **What are the Heureka conversion / shop reviews / product reviews feed formats for?** These feed formats are generated by Heureka from your data. You can use them, for example, to transfer reviews from Heureka to Google Merchant Center so they appear directly in your Google ads. ### **How do I get data from Mergado into Heureka?** 1. In the Mergado project, go to the Overview page and copy the output feed URL (top right). 2. Log in to your Heureka account and go to E-shop administration. 3. On the Overview page, click Edit shop. 4. In the E-shop information section, paste the output feed URL from Mergado into the XML import URL field and save. ### **Why connect Heureka with Mergado via Keychain?** If you want to use the Analytics page in Mergado to track your advertising performance, you need to give Mergado access to data from your Heureka account. This includes data not contained in your product feed, such as order information. You grant access through the Mergado Keychain extension, which is free for Mergado Editor users and is activated automatically when creating a project. Simply save your Heureka account login credentials in Keychain, and Mergado will automatically download the data needed for analytics. Your credentials are safe in Keychain – not even Mergado's technical support staff can access them. ### **How can I analyze my Heureka advertising?** On the Analytics page in each Mergado project, you will find clear charts and tables about your Heureka advertising performance. For Mergado to run analytics, you need to create a connection with your Heureka account through the Mergado Keychain extension. Data from Heureka is loaded with a delay – the following morning for the previous day. Analytics works with a 70-day time window. ### **How do I connect Heureka via Mergado Keychain?** The Mergado Keychain extension is free for Mergado Editor users and is activated automatically when a project is created. 1. On the [main page](https://app.mergado.com/) of Mergado Editor, click the online store for which you want to set up the Heureka connection in Keychain. 2. In the left sidebar, you will see a list of your active extensions. Click Mergado Keychain. 3. In the Connections section, select Heureka and click Create. 4. Enter your login credentials and choose whether to create a connection for Heureka.cz or Heureka.sk. 5. Confirm by clicking Log in. ### **What if Keychain reports a connection error?** The most common reason for a Keychain connection error is outdated login credentials. If you changed your password or login email in your Heureka account, you need to update the credentials in Keychain as well. Delete the existing connection in Keychain and create a new one with the current credentials. ### **Why do I see no Heureka data on the Analytics page?** For Mergado to analyze your Heureka data and prepare clear charts and tables, it needs access to that data. You grant access by creating a connection in the Mergado Keychain extension. Save your Heureka account login credentials in Keychain, and Mergado will be able to automatically download the data needed for analytics. ### **Can I also send Google Analytics data to Mergado Analytics?** Yes. However, for your Google Analytics data to flow into Mergado, you need to create a connection through the Mergado Keychain extension. This extension is free for Mergado Editor users and is activated automatically when a project is created. 1. On the [main page](https://app.mergado.com/) of Mergado Editor, click the online store for which you want to set up the Google Analytics connection in Keychain. 2. In the left sidebar, you will see a list of your active extensions. Click Mergado Keychain. 3. In the Connections section, select Google Analytics 4 and click Create. 4. Log in with your Google account and approve Mergado's access to your data. ### **Can I track costs and profit in Analytics?** Yes, through the Mergado Keychain extension, you can add the Mergado Analytical XML to Mergado and track the cost of goods or profit in Analytics. In Keychain, paste the URL of the Mergado Analytical XML file in the Sources section and click Save. ### **Can I secure the Mergado Analytical XML? Will Mergado still be able to access it?** Yes. If you secure your cost XML with an IP address whitelist (meaning only allowed IP addresses can access the file), add Mergado to the whitelist. Mergado accesses the file from IP address 81.31.39.112. ### **Can I hide sold-out or seasonal products in the output feed?** Yes. Using the Hide product rule, you can set up Mergado to hide selected products in the output feed so they will not appear on Heureka. This saves you advertising costs because you will not advertise products that customers cannot buy. ### **Does Mergado help with pairing to Heureka categories and product cards?** Yes. Mergado Audit helps you identify errors and issues that prevent Heureka from assigning your products to the correct product categories and matching them to the right product cards – and therefore rejecting and not displaying your products. You can then easily and automatically fix these errors in Mergado Editor. --- ## [How to Fix Feed Errors and Prevent Heureka from Rejecting Products](https://help.mergado.com/en/mergado-editor/advertising-channels-and-listings/heureka/how-to-fix-feed-errors-and-prevent-heureka-from-rejecting-products/) # **How to Fix Feed Errors and Prevent Heureka from Rejecting Products** For successful advertising on Heureka, your **product XML feed must meet [all of Heureka's requirements](https://sluzby.heureka.cz/napoveda/xml-feed/#utm_source=chatgpt.com)**. This means it must contain **specific elements** that are the fundamental building blocks of the data file (XML feed). Mergado takes care of transforming the element structure from your input feed into the structure Heureka requires. However, you are the one who must tell Mergado what information to fill into each element – and you must provide this information in your input feed. ## **Why You Need to Understand and Work with Heureka Elements** You may have already experienced Heureka repeatedly **rejecting some of your products and refusing to display them**. This is caused by **incorrectly filled elements**, which **prevent Heureka from pairing your products with product cards and therefore not displaying them**. But do not worry – you will not have to manually rewrite all incorrectly filled elements for thousands of products according to Heureka's requirements. That is what Mergado is for. The **complete list of elements Heureka works with** is available on [their website](https://sluzby.heureka.cz/napoveda/xml-feed/#utm_source=chatgpt.com). Some are **mandatory and have a precisely defined structure**; others are **not mandatory**. However, the more thoroughly and completely your feed is filled in, the better Heureka will display your products. ## **Mandatory Elements and Elements Essential for Correct Pairing** **The most important elements for displaying and correctly pairing** your products into Heureka's product cards are: * **PRODUCTNAME** – mandatory, contains the exact product name * **CATEGORYTEXT** – contains the path to the correct product category according to Heureka's catalog * **ITEM_ID** – mandatory, contains a unique and permanent product identifier within the online store * **PRICE_VAT** – mandatory, contains the product price * **URL** – mandatory, contains a unique address linking to the product page in your online store * **DELIVERY** – includes further elements containing the type of shipping offered for individual products and the shipping price * **DELIVERY_DATE** – contains the number of days until the product is dispatched * **IMGURL** – contains a link to the main product image * **ITEMGROUP_ID** – element used to mark (group) a set of products that are variants of one product * **HEUREKA_CPC** – contains the maximum cost per click (i.e., maximum CPC) * **EAN** – contains the barcode of the product Additional elements in the Heureka feed include SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, MANUFACTURER_POSTAL_ADDRESS, MANUFACTURER_ELECTRONIC_ADDRESS, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE, and SALES_VOUCHER. ### **PRODUCTNAME** **PRODUCTNAME contains the exact product name**, is a **mandatory** element of the Heureka feed, and is required for **products to display correctly**. This element is **key for product pairing** – assigning your products to the corresponding product cards on Heureka. For correct pairing, the PRODUCTNAME element must contain **all mandatory information for the selected category** (e.g., for clothing, the size must be included directly in the name). Mandatory data for individual **categories and examples of correct names can be found on [Heureka's website](https://sluzby.heureka.cz/napoveda/povinne-nazvy/)**. For example, for the Men's socks category, the mandatory data are Brand | Line | Color | Size. A correctly filled PRODUCTNAME would look like: VoXX ponozky Setra dark gray 35-38 This element should not contain superfluous information such as a gift with the product, warranty details, and similar items. The maximum text length is **200 characters**, which you can automatically enforce by setting up the Truncate value rule. #### **How to Add the Manufacturer Name to the PRODUCTNAME Element?** The easiest way to add the manufacturer name to PRODUCTNAME is to use the automation Mergado offers. 1. In the selected project, click the **Automation** tab. 2. Click the automation called **Add producer to product title**. 3. Fill in the **Manufacturer element name** – enter the element from your input feed that contains the manufacturer name (e.g., MANUFACTURER). 4. Fill in the **Product name element name** – enter the element from your input feed that contains the product name (e.g., PRODUCTNAME). 5. As the **Output product name element**, enter PRODUCTNAME. 6. Click **Run automation**. #### **How to Add Size or Another Parameter to the PRODUCTNAME Element?** If you want to **add another mandatory parameter for a given category** (e.g., size, material, or whether it is men's/women's/children's) to PRODUCTNAME, you need to create a **rule** in Mergado. 1. In the selected project, first create a **product query** on the **Products** page for the products where you want to add the selected parameter to PRODUCTNAME (e.g., you want to add the Size parameter for the Clothing category, so you create a query containing all Clothing products). See our guide on how to work with [product queries](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=5). 2. Go to the **Rules** page and click **New rule**. 3. Select **Rewrite** as the rule type. 4. Choose the **product query** to apply this rule to. 5. In the **Element** field, enter **PRODUCTNAME** (the element that will be modified by the rule). 6. In the **New value** field, enter **all elements that should be included in PRODUCTNAME**. Since each product has different values (different name/size/color), you need to mark these elements as **variables** by enclosing them with the **"%" character**. **Example:** Currently, PRODUCTNAME for a selected product contains "Nike t-shirt green." You want it to read "Nike t-shirt green XL." The size information is in the PARAM element, which contains PARAM_NAME (parameter name, e.g., size) and VAL (parameter value, e.g., XL). In the **New value** field, enter: **%PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL%** Mergado will understand that the new PRODUCTNAME value should contain the original value (%PRODUCTNAME%, e.g., Nike t-shirt green) plus the information from PARAM -> PARAM_NAME="VELIKOST" -> VAL (e.g., XL). 7. Enter a **rule name** and click **Create**. You can **add other parameters** similarly, such as material. It is important to verify that your feed **actually contains the relevant values** for the selected parameters; otherwise, Mergado will have nothing to draw from. Also make sure the **path to the parameter value is written correctly** so Mergado knows how to reach it. More information and guides related to the PRODUCTNAME element. ### **CATEGORYTEXT** **CATEGORYTEXT is an element containing the full path to the correct product category** according to Heureka's catalog. It is another important element for **correct product pairing**. If Heureka cannot pair categories due to an incorrectly filled CATEGORYTEXT, it will not proceed to pair products into product cards, and your product will not be displayed on Heureka. You need to provide **the complete full path**, ideally following [Heureka's category tree](https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml?_gl=1*dqcpbm*_gcl_aw*R0NMLjE3NjAwNzczMjguQ2p3S0NBand1cDNIQmhBQUVpd0E3ZXVadXE5eUx5VkVNbEdxRkg2NXktTGpKa2FSNXNDdi1TWjFnN0F1cWVYbTNmV3dIc1ZoS3d3b0V4b0NvaXdRQXZEX0J3RQ..*_gcl_au*MTQ3NTUyMjc3OC4xNzU2NzE1MzkzLjg3MDExNjE5LjE3NjE3Mjc2MzEuMTc2MTcyNzY0Mw..). In that case, Heureka will automatically pair the categories and proceed to pair products. You can also use your own category names, but this will extend the pairing process and there is a risk that categories – and therefore products – will not be paired. **Example of a correctly filled CATEGORYTEXT (e.g., for a washing machine):** Heureka.cz | Large Appliances | Washers and Dryers | Washing Machines **Example of an incorrectly filled CATEGORYTEXT (e.g., for a washing machine):** Heureka.cz | Large Appliances | Washers and Dryers #### **How to Set Correct Categories According to Heureka's Category Tree?** Mergado **loads and updates Heureka's category tree data daily** and makes assigning the correct categories much easier. You can easily set the correct categories using the **Rename categories in bulk** rule. 1. In the selected project, go to the **Rules** page and click **New rule**. 2. Select **Rename categories in bulk** as the rule type. 3. If you want to name categories according to Heureka's tree for all products, choose **All products**. Alternatively, select or create a new product query. 4. To save time, click the **Suggest categories** button. Mergado will fill in your input feed categories on the left and assign corresponding Heureka tree categories on the right. Review and adjust Mergado's suggestions as needed. * Another option is to click the **arrow** next to **Suggest categories** and click **Pre-fill left side**, where Mergado fills in only your input feed categories and you manually assign the Heureka categories. * Alternatively, you can **fill in and assign categories on both sides manually.** This is ideal if you only want to rename specific categories. * Regardless of which option you choose, **Mergado will suggest categories on both sides**, so you do not need to look them up elsewhere. 5. If you do not want to review all categories, use the **Show only** filter to display only problematic rows (**Conflicting rows**, **Invalid output categories**, or **Values missing on input**). 6. Enter a **rule name** and click **Create**. More details about the [Rename categories in bulk](https://www.youtube.com/watch?v=Bdm0gnnzz4s) rule. More information and guides related to the CATEGORYTEXT element. ### **ITEM_ID** **ITEM_ID contains a unique product identifier** and is a **mandatory** element of the Heureka feed. Without it, your products will not be displayed on Heureka. It allows Heureka to **identify individual products** for the Verified by Customers service or when you also connect an availability feed. If you change this code, products will be unpaired and a new pairing process will begin. It can contain a maximum of **36 characters**, using lowercase and uppercase letters without diacritics, numbers, hyphens, and underscores. Each product must have its own unique ITEM_ID. This element is not used for product pairing. #### **How to Add ITEM_ID If Your Feed Does Not Have It?** If your feed does not contain the ITEM_ID element, or it exists but does not contain unique identifiers, you can easily create and fill it in Mergado. A. The easiest way is to use the **ITEM_ID from MERGADO_ID automation**. This automation **creates the ITEM_ID element** and fills it with **unique numeric codes**. It can also be used if **ITEM_ID already exists** but needs to be **filled with appropriate values**. 1. In the selected project, go to the **Automation** page. 2. Click the **ITEM_ID from MERGADO_ID** automation. 3. No input is needed – Mergado **automatically detects whether it needs to create the element or just fill it with values**. Simply click **Run automation**. B. Another option is to set up a **Rewrite rule** using the **@MERGADO_ID variable**. Mergado automatically creates this variable when the project is created, and it contains a unique number for each product. 1. In the selected project, go to the **Rules** page and click **New rule**. 2. Select **Rewrite** as the rule type. 3. Choose **All products** as the query. 4. On the left side, enter **ITEM_ID** (the element to fill). 5. On the right side, enter **%@MERGADO_ID%**. Remember that this is a variable (it contains a different value for each product), so it must be enclosed with the **% character**. 6. Enter a **rule name** and click **Create**. Keep in mind that if you use @MERGADO_ID to fill ITEM_ID, the **product IDs in the Heureka feed will not match the IDs sent to Heureka in the conversion measurement code**. This means conversion measurement statistics will not pair correctly. More information and guides related to the ITEM_ID element. ### **PRICE_VAT** **PRICE_VAT contains the final product price including VAT** (and any copyright or recycling fees) and is a **mandatory** element of the Heureka feed. Without it, your products will not be displayed on Heureka. Prices must be in **CZK** (or **EUR** for Slovak Heureka). The decimal separator can be a comma (,) or period (.), and thousands may or may not be separated by a space (both 25000 and 25 000 are valid). A maximum of two decimal places is allowed. Enter only the numeric value in the element, without the currency symbol CZK or EUR. #### **How to Automatically Adjust Prices Based on Competition?** For **automatic pricing** on your online store and Heureka, the **[Pricing Fox](https://store.mergado.com/detail/pricingfox/#about) extension** is ideal. Pricing Fox **monitors competitors and ensures your product prices are attractive to customers while still profitable**. It continuously evaluates the market and regularly reprices products according to your rules to protect margins and boost sales. You also get a complete overview of who your competitors are, how their prices and stock availability change over time, their bidding positions, gifts they offer, their manufacturers, and the categories they sell in. More information and guides related to the PRICE_VAT element. ### **URL** **URL contains the link to the product in your online store** where customers can add it to their cart and purchase it. This element is **mandatory**, and without it, your products will not be displayed on Heureka. Each **product must have a unique URL**, with a maximum length of **300 characters** (enforceable with the Truncate value rule). Changing the URL will unpair the product and start a new category assignment process. #### **How to Differentiate URLs for Variants on the Same Online store Page?** If a product has multiple variants, **each variant must have its own unique URL**. If your online store has product variants on a single page, you need to create a unique URL for each variant. In Mergado, this can be solved by **adding a # character to the end of the URL followed by a unique numeric code from the @MERGADO_ID system variable** for each variant. You do not need to create this variable – Mergado creates it automatically when the project is set up, assigning each product a unique numeric code. This creates a unique link for each variant without affecting the link to the product page on your online store. **To create the rule:** 1. First, create a **product query** on the **Products** page for products whose URL you want to modify – in this case, products with variants. See the guide on how to work with [product queries](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=5). 2. Go to the **Rules** page and click **New rule**. 3. Select **Rewrite** as the rule type. 4. Choose the **product query** to apply this rule to. 5. In the **Element** field, enter **URL**. 6. In the New value field, enter: **%URL%#%@MERGADO_ID%** 7. Enter a **rule name** and click **Create**. This rule ensures each variant has **a different numeric code after the # character and URLs will not be the same**. The original URL functionality should not be affected (though it is good to verify), and Heureka's requirement for unique addresses for each product will be met. #### **How to Add UTM Parameters to Product URLs?** If you want to track **how many customers come from Heureka**, you will probably want to add **UTM parameters** to individual product URLs. In Mergado, this is easily solved with the **Set UTM parameters rule**. 1. In the selected project, go to the **Rules** page and click **New rule**. 2. Select **Set UTM parameters** as the rule type. 3. Choose **All products** (or create a query for specific products). 4. Select **URL** as the **Element**. 5. Fill in the **desired parameters**. 6. Enter a **rule name** and click **Create**. More information and guides related to the URL element. ### **DELIVERY** **DELIVERY is a "wrapper" that contains these elements:** * **DELIVERY_ID** (carrier identifier) * **DELIVERY_PRICE** (shipping price for the carrier including VAT with prepayment) * **DELIVERY_PRICE_COD** (shipping price for the carrier including VAT with cash on delivery) The DELIVERY element **repeats in the feed as many times as there are shipping methods available for your product**. If you offer three shipping methods (e.g., PPL, Zasilkovna, Balikovna), DELIVERY will appear three times. **DELIVERY_ID and DELIVERY_PRICE are mandatory.** DELIVERY_PRICE_COD is not required if the selected carrier does not support cash on delivery. Heureka only allows **specific carriers** in the feed, listed in the specification on their [website](https://sluzby.heureka.cz/napoveda/xml-feed/?_gl=1*ov176c*_gcl_aw*R0NMLjE3NjAwNzczMjguQ2p3S0NBand1cDNIQmhBQUVpd0E3ZXVadXE5eUx5VkVNbEdxRkg2NXktTGpKa2FSNXNDdi1TWjFnN0F1cWVYbTNmV3dIc1ZoS3d3b0V4b0NvaXdRQXZEX0J3RQ..*_gcl_au*MTQ3NTUyMjc3OC4xNzU2NzE1MzkzLjg3MDExNjE5LjE3NjE3Mjc2MzEuMTc2MTcyNzY0Mw..#DELIVERY). #### **How to Add Carriers and Set Shipping Prices?** Use the **Set shipping rates rule** to add carriers and set shipping prices. 1. In the selected project, first create **[product queries]**(https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=6) on the **Products** page for products where you want to set carriers and shipping prices. For example, you may want different shipping prices based on product price or weight. * You can easily create queries based on price tiers using the **Segmentation into 5 price tiers** automation. Similarly, the **Segmentation by product weight** automation creates queries based on product weight. * If you want to set the same shipping price for all products, you do not need to create these queries. 2. Go to the **Rules** page and click **New rule**. 3. Select **Set shipping rates** as the rule type. 4. Choose the **product query** (e.g., a specific price tier or All products). 5. On the left side, **fill in the selected carriers**. Mergado will suggest carriers allowed by Heureka. You can also click **Pre-fill left side** and Mergado will fill in all carriers allowed by Heureka. 6. On the right side, **enter the price for the selected carrier with prepayment** (and optionally with cash on delivery if the carrier supports it). 7. Enter a **rule name** and click **Create**. If you are setting different prices for different price tiers or weight groups, **repeat this process and create a separate rule for each query**. #### **How to Set Free Shipping for Some Products?** 1. In the selected project, first create a **product query** for products with free shipping (e.g., products priced above 2000 CZK). 2. Go to the **Rules** page and click **New rule**. 3. Select **Set shipping rates** as the rule type. 4. Choose the **product query** for free shipping. 5. On the left side, **fill in the selected carriers**. Mergado will suggest carriers allowed by Heureka. You can also click **Pre-fill left side**. 6. On the right side, enter **zero: "0"** in the price fields. 7. Enter a **rule name** and click **Create**. #### **How to Remove Some Carriers from the Feed?** If you decide to remove a carrier, use the Set shipping rates rule. 1. In the selected project, go to the **Rules** page and click **New rule**. 2. Select **Set shipping rates** as the rule type. 3. Choose the **product query** from which you want to remove the carrier. 4. On the left side, **enter the carrier you want to remove**. 5. On the right side, leave the fields **empty**. (Do not enter zero, a hyphen, x, or any other characters. Leave the fields blank.) 6. Enter a **rule name** and click **Create**. This removes the selected carrier from the feed, because Mergado does not include elements without values in the output feed. More information and guides related to the DELIVERY element. ### **DELIVERY_DATE** **DELIVERY_DATE contains information about the product's delivery time** – the period from payment receipt (or order placement for cash on delivery) to product dispatch. Enter a numeric value as a **single number**, not a range. For example, if the product will be dispatched in four days (or within four days), enter the number 4. Heureka then displays these numeric values as text descriptions: |DELIVERY_DATE|Text on Heureka| | --- | --- | |0|in stock| |1 to 3|within 3 days| |4 to 7|within a week| |8 to 14|within 2 weeks| |15 to 30|within a month| |31 and more|more than a month| |no value|info in shop| If the product will be in stock from a specific date and **pre-orders** are accepted, enter the date in DELIVERY_DATE in the format **yyyy-mm-dd** (e.g., 2025-03-25). The easiest way to fill DELIVERY_DATE is with the **Rewrite rule**. For in-stock products, **enter a value of zero: 0**. If the product is not in stock, you can easily hide it using the **Hide product rule**. You can also hide products with **long delivery times**, since customers will likely buy them where they are in stock. Advertising such products would be a waste of your budget. #### **How to Hide Products with Long Delivery Times or Unknown Availability?** 1. In the selected project, first create a **product query** on the **Products** page (e.g., products with DELIVERY_DATE greater than 10, or products with no value in DELIVERY_DATE because you do not know when they will be available). 2. Go to the **Rules** page and click **New rule**. 3. Select **Hide product** as the rule type. 4. Choose the **product query** to apply this rule to. 5. Enter a **rule name** and click **Create**. However, the DELIVERY_DATE value in the product feed may not always be up to date. You can send an additional XML feed to Heureka – **the availability feed** (your online store system should generate it automatically). Heureka downloads this feed **every ten minutes**, and information from it takes priority over the main product feed (i.e., over DELIVERY_DATE). This ensures Heureka always has **current availability information**. You can find what Heureka's availability feed should look like on [their website](https://sluzby.heureka.cz/napoveda/dostupnostni-feed). Read more about the availability feed. More information and guides related to the DELIVERY_DATE element. ### **IMGURL** **IMGURL contains the URL of the main product image.** The URL must not contain spaces or diacritics, and the same URL can be used for multiple products. Basic product image requirements: * **Minimum** image size is 20 x 50 pixels (or 50 x 20) and 30 kB. However, Heureka's recommended size is **at least 175 x 175 pixels**, approximately **30,000 pixels**. * **Maximum** size is **4096 x 4096 pixels and 2000 kB**. * Image URL can be a maximum of **255 characters**. * Supported formats are **webp, jpeg, png, bmp**. * Images **must not contain watermarks**, discount or bonus indicators, or award or product advantage badges. You can easily check whether your product images meet Heureka's requirements by running the **[Image Audit]**(https://audit-obrazku.cz/). #### **How to Bulk-Adjust Image Dimensions According to Heureka's Requirements?** You can quickly, easily, and in bulk adjust image sizes, remove watermarks, and improve quality using the **[Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about) extension**. More information and specific guides are available on [this extension's website](https://www.feed-image-editor.cz/). More information and guides related to the IMGURL element. ### **ITEMGROUP_ID** **ITEMGROUP_ID is an element used to mark a group of products that are variants of one product.** The group code can be up to **36 characters** long, using underscores, hyphens, digits 0-9, and lowercase and uppercase letters without diacritics. This variant marking is necessary because **Heureka requires each product variant to be listed as a separate product in the feed**. **All variants of one product are marked with a single shared code** in the ITEMGROUP_ID element. Products are considered variants when they differ in size, color, pattern, or type. **Example:** Your feed contains Adidas Superstar sneakers in sizes 36, 37, and 38. All three variants are marked with one shared code (e.g., ZD563) in the ITEMGROUP_ID element. #### **How to Add ITEMGROUP_ID Values If They Are Missing?** There are several approaches depending on your feed type. One option is the **Data file import rule**, where you **import the values in a separate file**. If you need help, contact our [technical support](https://www.mergado.cz/kontakt) at mergado@mergado.com and we will work together to find a solution for your specific feed. More information and guides related to the ITEMGROUP_ID element. ### **HEUREKA_CPC** **HEUREKA_CPC contains the maximum price you are willing to pay per click** – bringing a customer from Heureka to your online store. Decimal places use a comma separator. The maximum possible click price is 1000 CZK. If you do not want to [bid](https://www.bidding-fox.cz/jak-funguje-bidding) (set a cost per click), leave the element empty (do not enter zero or any other character). You can set an appropriate click price based on price tiers, dividing your assortment into queries by price. Then set a lower CPC for low-price, low-margin products to avoid losses, and a higher CPC for more expensive, higher-margin products. #### **How to Set Bidding for Heureka Based on Price Tiers?** One way to set bidding in Mergado (and fill the HEUREKA_CPC element) is the **Cost per click pricing** rule. 1. First, create suitable **product queries** by price tiers. 2. On the **Rules** page, click **New rule**. 3. Select **Cost per click pricing** as the **Rule type**. 4. In the **Queries** field, choose the **price tier** for which you want to set the click price. 5. Choose whether to calculate the click price based on: **a. Minimum click price** – The rule considers minimum click prices for products in each category (set by Heureka), and you can increase them by any amount in the **Add to minimum CPC** field. **b. Percentage of product price** – Set the **Percentage of product price** you want to offer per click. For example, 1% of a 500 CZK product equals a 5 CZK click price. 6. Enter a **Rule name**. 7. Click **Create**. 8. Repeat for **other price tiers** and remember to apply the created rules. You can also set CPC using the **Bulk rewriting by queries** rule, which lets you set CPC for multiple price tiers in one rule. 1. First, create suitable **product queries** by price tiers. 2. On the **Rules** page, click **New rule**. 3. Select **Bulk rewriting by queries** as the **Rule type**. 4. As the element to be rewritten, enter **HEUREKA_CPC**. 5. On the left side, fill in the queries – your created **price tiers**. 6. On the right side, enter the corresponding **click price** for each price tier. * This rule does not calculate CPC using a formula like the Cost per click pricing rule. Here you need to enter the **final CPC value** you are willing to pay. 7. Enter a **Rule name**. 8. Click **Create**. 9. Remember to apply the rule. #### **How to Set Bidding Based on Margin, Category, Manufacturer, or Various Parameters?** ##### **By margin** You do not have to set click prices only based on price tiers. You can set CPC by **margin**, dividing the assortment into queries based on margin level. This requires having a **margin element in your feed**. Then use the **Cost per click pricing** or **Bulk rewriting by queries** rule. ##### **By categories, manufacturer, or various parameters** Another option is setting CPC by **categories, manufacturer, or parameters like material**. The easiest approach is the **Bulk rewriting by values** rule. 1. On the **Rules** page, click **New rule**. 2. Select **Bulk rewriting by values** as the **Rule type**. 3. Choose the **product query** or All products. 4. On the left side, in the **Element to search in** field, enter the element you want to base CPC on. * For categories, choose CATEGORYTEXT. * For manufacturer, choose MANUFACTURER. 5. On the right side, in the **Element to write to** field, enter **HEUREKA_CPC**. 6. Then fill in the **values of the chosen element** on the left and the corresponding **CPC value** on the right. * For categories, enter individual categories (e.g., t-shirts, shirts, pants, etc.) with their click prices. * For manufacturers, enter individual manufacturers (e.g., Adidas, Nike, Reebok, etc.) with their click prices. 7. Enter a **Rule name**. 8. Click **Create**. 9. Remember to apply the rule. #### **How to Set Up Automatic Bidding So HEUREKA_CPC Adjusts Itself?** For automatic bidding, the **[Bidding Fox](https://store.mergado.com/detail/biddingfox) extension** is ideal. It analyzes the sales potential of products and dynamically manages their advertising for maximum visibility. For items with low potential, it reduces advertising to save your credit. It **adjusts bidding several times a day based on the latest data** it verifies directly on Heureka. It also lets you monitor your competitors' CPC and adjust advertising based on that information. More information and guides related to the HEUREKA_CPC element can be found here. ### **EAN** **EAN contains a code identifying individual products.** Its entry is **mandatory for the categories Books, Textbooks, Maps and Guides, Movies, Music, and Comics**. For other categories, it is not mandatory but is recommended for all products. Unlike ITEM_ID, these are not arbitrary codes you can assign to your products. They are official, **so-called barcodes**. Heureka supports the **EAN-13** format. Although Heureka does not pair products into product cards based on EAN codes, the **[Unpaired products report](https://sluzby.heureka.cz/napoveda/co-je-report-nesparovanych-produktu/)** works with EAN codes. If you send EANs to Heureka, it will look up unpaired products by EAN and **recommend the correct name and category for pairing**. The [unpaired products report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/) is available in your shop's Heureka administration under the **Product pairing** tab. It is available only for online stores in PPC mode, and Heureka generates it once a day. If you have correctly filled EAN codes and do not want to spend time manually pairing products, use the **[Pairing Bear](https://store.mergado.com/detail/pairingbear/#about)** extension. It **automatically pairs your products with product cards** on Heureka based on EANs and offers intelligent recommendations for items that cannot be paired. #### **How to Find Products with Invalid EAN?** You can easily find products with invalid EAN using the **Find products with invalid EAN** automation. 1. In the selected project, click the **Automation** tab. 2. Click the automation called **Find products with invalid EAN**. 3. The automation has **EAN** pre-set as the EAN code element. Leave it as is. 4. Click **Run automation**. The automation saves products with invalid EAN into a **query called "Products with invalid EAN"**. You can then fix the codes or temporarily hide these products (Hide product rule) until the EANs are corrected. #### **How to Find Products with Missing EAN?** You can find products with missing EAN by creating a query. 1. On the **Products** page, select the **Simple interface** option. 2. For **Search products**, choose **on input**. 3. In the search field, type **EAN** and then choose **is empty**. 4. Click **Search**. 5. All **products with a missing EAN** will be displayed. 6. Enter a **query name** (e.g., Products with missing EAN). 7. Click **Save**. On the same page, click the **Saved queries** tab to find this query. Try to fill in the EAN as soon as possible. More information and guides related to the EAN element. ### **OTHER HEUREKA ELEMENTS** Information about other Heureka feed elements is available on our forum: SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE, and SALES_VOUCHER. ## **FAQ** ### **Why does Heureka not display or reject some products?** Most often, it is because of missing or incorrectly filled elements in your product XML feed. Heureka has specific requirements for what a product feed should look like, and incorrectly filled elements prevent pairing into product cards. Mergado offers a free [Feed Audit](https://audit.mergado.com/) that you can run at any time to detect errors and get immediate fix recommendations. ### **How does Mergado help with product pairing on Heureka?** Mergado converts your input feed structure into Heureka's format and lets you use rules and automations to bulk-fix or add element values to match Heureka's requirements. Mergado handles fixes in bulk and automatically, so you do not need to correct each product manually. ### **Which elements are essential for correct pairing and product display on Heureka?** The most essential elements for correct product pairing are PRODUCTNAME (mandatory, containing the exact product name) and CATEGORYTEXT (containing the full path to the correct product category from Heureka's tree). Additional mandatory elements without which your product will not be displayed are ITEM_ID (unique and permanent product identifier), PRICE_VAT (final product price with VAT), and URL (unique product URL in your online store). Also important are DELIVERY (carriers and shipping prices), DELIVERY_DATE (days until dispatch), IMGURL (main product image URL), ITEMGROUP_ID (variant identifier), HEUREKA_CPC (maximum CPC if bidding), and EAN (product barcode, mandatory for selected categories). ### **What must the PRODUCTNAME element contain?** PRODUCTNAME is a mandatory Heureka feed element. It is essential for correct product pairing and must contain the exact product name. Each product category has a specific format specification. For example, for Men's socks, the mandatory data are Brand | Line | Color | Size. Mandatory data for each category and example names are on [Heureka's website](https://sluzby.heureka.cz/napoveda/povinne-nazvy/). ### **How do I bulk-add manufacturers to product names?** The easiest way is the Add producer to product title automation. 1. In the selected project, click the **Automation** tab. 2. Click the automation called **Add producer to product title**. 3. Fill in the **Manufacturer element name** (e.g., MANUFACTURER). 4. Fill in the **Product name element name** (e.g., PRODUCTNAME). 5. As the **Output product name element**, enter PRODUCTNAME. 6. Click Run automation. ### **How do I bulk-add size, material, or other information to product names?** The easiest way is the Rewrite rule. 1. First, create a product query on the Products page for the products to modify. 2. Go to the Rules page and click New rule. 3. Select Rewrite as the rule type. 4. Choose the product query. 5. In the Element field, enter PRODUCTNAME. 6. In the New value field, enter all elements that should be in PRODUCTNAME. Mark them as variables with the "%" character. Separate individual variables with a space. Example: PRODUCTNAME currently contains "Nike t-shirt green." You want it to read "Nike t-shirt green XL." The size is in the PARAM element with PARAM_NAME and VAL. In the New value field, enter: %PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL% Mergado will combine the original name with the size value (e.g., XL). 7. Enter a rule name and click Create. ### **How do I correctly fill the CATEGORYTEXT element?** CATEGORYTEXT must contain the full path to the correct product category from Heureka's category tree. If filled incorrectly, Heureka will not pair categories and will not proceed to pair products. A correct path looks like: Heureka.cz | Large Appliances | Washers and Dryers | Washing Machines. ### **How do I bulk-set correct categories from Heureka's category tree?** The Rename categories in bulk rule is ideal. 1. Go to the Rules page and click New rule. 2. Select Rename categories in bulk as the rule type. 3. Choose All products or create a new product query. 4. Click Suggest categories. Mergado fills in your input feed categories on the left and assigns Heureka tree categories on the right. Review and adjust. 5. Enter a rule name and click Create. ### **How do I add ITEM_ID if my feed does not have it?** ITEM_ID is a mandatory element. If your feed lacks it, use the ITEM_ID from MERGADO_ID automation. It creates the element and fills it with unique codes. Simply go to the Automation page, click the automation, and click Run automation. ### **How do I automatically change prices on Heureka based on competition?** The [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about) extension is ideal for automatic pricing. It fills the PRICE_VAT element based on your rules and current competitor data, keeping your prices attractive yet profitable. ### **Must each product in the Heureka feed have a unique URL?** Yes. Each product must have a different URL in the feed leading to the product page in your online store. Each variant must also have a unique URL. See the instructions above for setting different URLs for variants. ### **How do I differentiate variant URLs that share one online store page?** If variants share one page, create a unique URL for each by appending # followed by a unique code from the @MERGADO_ID system variable. Use the Rewrite rule with the value: %URL%#%@MERGADO_ID% ### **How do I find out how many customers come from Heureka?** Check Google Analytics for this information. For more detailed tracking, add UTM parameters to product URLs using the Set UTM parameters rule. ### **How do I add carriers and set shipping prices for the Heureka feed?** Use the Set shipping rates rule. Create product queries if needed, add carriers (Mergado suggests Heureka-allowed carriers), and set prices for prepaid and cash-on-delivery shipping. ### **How do I set free shipping for some products?** Create a product query for products eligible for free shipping (e.g., products above 2000 CZK), then use the Set shipping rates rule with a price of zero. ### **How do I remove carriers from the Heureka feed?** Use the Set shipping rates rule, enter the carrier to remove on the left, and leave the right side empty. Mergado does not include empty elements in the output feed. ### **How do I mark in-stock products in the Heureka feed?** For in-stock products, enter a value of zero in the DELIVERY_DATE element. ### **How do I hide products with long delivery times from Heureka advertising?** Create a product query for products with long delivery times (e.g., DELIVERY_DATE > 10), then use the Hide product rule. ### **How do I ensure Heureka always has current availability and stock information?** The most reliable source is the availability feed, which your online store system should generate automatically. Heureka downloads it every ten minutes, and it takes priority over the main product feed. Make sure ITEM_ID values match between the product and availability feeds. Details on Heureka's availability feed format are on [their website](https://sluzby.heureka.cz/napoveda/dostupnostni-feed). ### **What image dimensions does Heureka require?** Minimum recommended: 175 x 175 pixels (approximately 30,000 pixels). Maximum: 4096 x 4096 pixels and 2000 kB. Check your images for free with [Image Audit](https://audit-obrazku.cz/). Adjust dimensions and quality in bulk with [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about). ### **Can product images on Heureka contain watermarks?** No. Images must not contain watermarks, discounts, bonuses, or award badges. Check with [Image Audit](https://audit-obrazku.cz/) and remove them using [Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about). ### **How do I mark all variants of a product in the Heureka feed?** Heureka requires each variant to be listed as a separate product with a shared identifier in the ITEMGROUP_ID element. ### **How do I add ITEMGROUP_ID values if they are missing from my input feed?** There are several approaches depending on your feed type. One option is the Data file import rule. If you need help, contact our technical support at mergado@mergado.com. ### **How do I set CPC (cost per click) for Heureka?** Use the Cost per click pricing rule. Create product queries, choose the rule type, select the price tier, and choose between minimum click price or percentage of product price calculations. The HEUREKA_CPC element is automatically filled by this rule. You can also use Bulk rewriting by queries or Bulk rewriting by values. ### **How do I set up automatic bidding on Heureka?** The [Bidding Fox](https://store.mergado.com/detail/biddingfox) extension is ideal. It analyzes product sales potential and dynamically manages advertising. It requires a Heureka connection through Mergado Keychain. ### **Is EAN (barcode) mandatory for products advertised on Heureka?** It is mandatory for Books, Textbooks, Maps and Guides, Movies, Music, and Comics. For other categories, it is not mandatory but recommended for all products. ### **How do I find products with invalid or missing EANs?** For invalid EANs, use the **Find products with invalid EAN** automation. For missing EANs, create a product query where the EAN element "is empty." ### **How do I simplify product pairing for Heureka in Mergado?** Use the [Pairing Bear](https://store.mergado.com/detail/pairingbear/#about) extension. It automatically pairs products by EAN and suggests adjustments for unpaired items, such as product name (PRODUCTNAME) or category (CATEGORYTEXT) changes. --- ## [Complete Guide to Product Pairing on Heureka with Mergado](https://help.mergado.com/en/mergado-editor/advertising-channels-and-listings/heureka/complete-guide-to-product-pairing-on-heureka-with-mergado/) # **Complete Guide to Product Pairing on Heureka with Mergado** **Product pairing** is one of the most important tasks for successful advertising on the Heureka comparison site. This process **links your online store's offer with a specific product card in Heureka's catalog**. If your products are not paired, they only appear in full-text search, which significantly reduces their visibility and chances of generating orders. ## **Why Is Proper Pairing Essential for Online stores?** * **Joint display with competitors** – Paired products are displayed directly on the "main" product card alongside offers from other online stores, so customers see your products in one place compared with the rest. Not as a standalone, isolated offer. * **Higher search ranking** – Product cards rank higher in search results than standalone unpaired offers. * **Bidding capability** – Only paired products can fully participate in bidding (setting the cost per click) and compete for top positions among sellers. * **Trust and reviews** – Paired products let customers use reviews, ratings, and comparisons with other products. * **Heureka Marketplace** – Correct pairing is one of the conditions for activating the orange "Buy via Heureka" button. ## **What Are the Key Elements for Successful Pairing?** For Heureka to correctly identify and classify your product, you need to focus on these three elements: * **CATEGORYTEXT** * **PRODUCTNAME** * **EAN** ## **CATEGORYTEXT** **CATEGORYTEXT is an element that must contain the full path to the correct product category according to Heureka's catalog** (e.g., Heureka.cz | Electronics | Mobile Phones). It is important for assigning products from the feed to the **correct categories** in Heureka's catalog. The pipe character **"|"** is used as the separator between category and subcategory levels. This is a **crucial element for proper product pairing**. If Heureka cannot pair categories due to an incorrectly filled CATEGORYTEXT, it will not proceed to pair products into product cards, and the product will not be displayed on Heureka. You need to provide the **complete full path**, ideally following **[Heureka's category tree](https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml)**. In that case, Heureka will automatically pair the categories and proceed to pair products into product cards. You can also use your own category names, but this will extend the pairing process and there is a risk that categories – and therefore products – will not be paired and your products will not be displayed on Heureka. * **Example of a correctly filled CATEGORYTEXT element (e.g., for a washing machine):** Heureka.cz | Large Appliances | Washers and Dryers | Washing Machines * **Example of an incorrectly filled CATEGORYTEXT element (e.g., for a washing machine):** Heureka.cz | Large Appliances | Washers and Dryers ### **How to Correctly Fill the CATEGORYTEXT Element in Mergado** Mergado **loads and updates Heureka's category tree data daily** and makes assigning the correct categories much easier. You can easily set the correct categories in bulk using the **Rename categories in bulk rule**. This rule works reliably when your **input categories are in the correct element** that Mergado expects for the given format. Before setting up categories, always check where and in what form your categories actually exist in the input feed (for Custom Format, for example, verify that elements are correctly mapped). In most cases, you can use **Rename categories in bulk**, which works with existing input categories and assigns them to Heureka's tree. However, situations may arise where categories are missing from the input or are in a different element than Mergado expects for the given format. For example, with a **Google feed**, Mergado normally looks for categories in the `g:google_product_category` element. However, some online store owners only have categories filled in the `g:product_type` element while `g:google_product_category` is empty. In that case, you need a different approach. For instance, use the **Bulk rewriting by values rule**, which lets you write categories from the incorrect input element directly into the CATEGORYTEXT element (Mergado will suggest possible categories from Heureka's tree). **How to use the *Rename categories in bulk* rule to fill CATEGORYTEXT:** 1. In the selected Heureka project, go to the **Rules** page and click **New rule**. 2. Select **Rename categories in bulk** as the rule type. 3. If you want to assign categories from Heureka's tree for all products, choose **All products** in the queries. Alternatively, select or create a new product query for which you want to assign categories. 4. Assign the **corresponding Heureka tree categories** to your online store categories. a. The easiest way is to use the **Suggest categories** function. Mergado will automatically fill your online store categories on the left side and assign the corresponding Heureka tree categories on the right. Then **review** Mergado's suggestions and adjust as needed. b. Another option is the **Pre-fill left side** function. Mergado fills in your online store categories on the left side. You then manually **assign the corresponding Heureka tree categories** on the right. Mergado will suggest suitable Heureka tree categories based on keywords you type. c. You can also fill in and assign categories **manually** on both sides. Even in this case, Mergado will suggest categories (both yours and from Heureka's tree) so you do not need to look them up elsewhere. > **Tip!** The order in which categories are listed in this rule matters. The rule applies rows from top to bottom. It is advisable to **place more general categories at the top and specific ones at the bottom**. You can adjust this order when creating the rule. 5. If you do not want to review all categories, you can use the **Show only** filter to display only problematic rows (Conflicting rows, Invalid output categories, or Values missing on input). 6. Enter a **rule name** and click **Create**. ## **PRODUCTNAME** **PRODUCTNAME is an element that must contain the exact product name**, and for successful pairing, its value must **match the name of the product card on Heureka**. It is a **mandatory element** of the Heureka feed and is needed for proper product display. This element is key for product pairing – that is, for assigning your products to the corresponding product cards on Heureka. For correct pairing, the PRODUCTNAME element must contain **all mandatory information for the selected category** (e.g., for clothing, the size must be included directly in the name). **[Mandatory data for individual categories and examples of correct names can be found on Heureka's website.](https://sluzby.heureka.cz/napoveda/povinne-nazvy/?_gl=1*1ib8mc7*_gcl_aw*R0NMLjE3NzIwMTM4MTIuQ2p3S0NBaUEyUHJNQmhBNEVpd0F3cEh5QzJFNnYwZG5iU3d2enFPTzBFLW9KRjdwaF9fbURfNmE4MnZwOVJGejZUMnZrbGhOcWU2SEdSb0M4djhRQXZEX0J3RQ..*_gcl_au*MTgwMjg4NzY0NS4xNzcwMTA3MTgwLjUxMDQ0NTcwNy4xNzcxOTQzMTU1LjE3NzE5NDMxNjE.)** For example, for the Men's socks category, the mandatory data are Brand | Line | Color | Size. A correctly filled PRODUCTNAME would look like this: VoXX ponozky Setra dark gray 35-38 At the same time, this element **must not contain excessive information unrelated to the product name**, such as a gift with the product, warranty information, free shipping, and similar items. The maximum text length is limited to **200 characters**, which you can automatically enforce by setting up the Truncate value rule. You can edit the PRODUCTNAME element in Mergado using various rule types, such as: Rewrite, Bulk rewriting by values, Data file import, or manual changes. If your products are already paired on Heureka and you then make **changes to the PRODUCTNAME element, the products will be unpaired** and must go through the pairing process again. The duration of this process depends on Heureka's capabilities. ### **How to Correctly Fill the PRODUCTNAME Element in Mergado** One of the most common issues with the PRODUCTNAME element is a missing manufacturer (brand) name or a missing parameter (e.g., size). #### **How to Add the Manufacturer Name to the PRODUCTNAME Element?** The simplest way to add the **manufacturer name** to PRODUCTNAME is to use the automation that Mergado offers. 1. In the selected project, click the **Automation** tab. 2. Click the automation called **Add producer to product title**. 3. Fill in the **Manufacturer element name** – enter the element from your **input feed** that contains the manufacturer name (e.g., MANUFACTURER). 4. Fill in the **Product name element name** – enter the element from your **input feed** that contains the product name (e.g., PRODUCTNAME). 5. As the **Output product name element**, enter **PRODUCTNAME**. 6. Click **Run automation**. This creates a **rule called "Add producer to product title."** Thanks to this rule, all products in the feed that are missing the manufacturer in their name will have the manufacturer name added to the PRODUCTNAME element. You can find the rule in the **list on the Rules page**, where you can also edit it. #### **How to Add Size or Another Parameter to the PRODUCTNAME Element?** If you want to **add another mandatory parameter** for a given category (e.g., size, material, or whether it is men's/women's/children's) to the PRODUCTNAME element, you need to create a **rule** in Mergado. 1. In the selected project, first create a product **query** on the **Products** page for the products where you want to add the selected parameter to PRODUCTNAME (e.g., for the Clothing category, you want to add the Size parameter to PRODUCTNAME, so you create a query containing all products from the Clothing category). [See this guide on how to work with product queries.](https://youtu.be/pDjUNyKac88?si=RPYlX8yRtydfrT6f) 2. Go to the **Rules** page and click **New rule**. 3. Select **Rewrite** as the rule type. 4. Choose the product **query** to which you want to apply this rule. 5. In the **Element** field, enter **PRODUCTNAME** (the element that will be modified by the rule). 6. In the **New value** field, enter **all elements that should be included in the PRODUCTNAME element** (including the original PRODUCTNAME if you want to keep it). → Since each product will have a different element value (each product has a different name/size/color), you need to mark these elements as **variables**. You do this by enclosing the element name with the **"%"** character at the beginning and end. 7. Enter a **rule name** and click **Create**. **Example:** Currently, the PRODUCTNAME element for a selected product contains "Nike t-shirt green." You want PRODUCTNAME to read "Nike t-shirt green XL." The size information is in the PARAM element, which contains nested elements PARAM_NAME (parameter name, e.g., size) and VAL (parameter value, e.g., XL). **In the New value field of the new rule, enter:** `%PRODUCTNAME% %PARAM{PARAM_NAME="VELIKOST"} | VAL%` Mergado will understand that the new value of the PRODUCTNAME element should contain the original value (%PRODUCTNAME%, e.g., Nike t-shirt green) plus the information found in the element PARAM -> PARAM_NAME="VELIKOST" -> VAL (e.g., XL). You can add other parameters to PRODUCTNAME in a similar way, for example material. In that case, you would add %PARAM {PARAM_NAME="MATERIAL"} | VAL% after the size, and Mergado would append, e.g., cotton after "Nike t-shirt green XL." It is important to remember that your **feed must actually contain the values for the selected parameters**. Otherwise, Mergado will have nothing to draw from and will not add anything to PRODUCTNAME. You also need to make sure you always **fill in the path to the parameter value (Element-Path) correctly** so Mergado knows how to reach it. The path notation may differ from the example above if the elements with parameters in your feed have different names. But as soon as you type the initial % variable marker, auto-suggestions will appear, and you can simply select from the list. ## **EAN** **EAN contains a numeric code that identifies individual products.** These are **official barcodes**, and Heureka supports the **EAN-13** format, which consists of thirteen digits. EAN is **mandatory for the categories Books, Textbooks, Maps and Guides, Movies, Music, and Comics**. For other categories, it is not mandatory, but it is recommended for all products, as it can significantly speed up pairing, helps automated processes, and is essential for **generating the Unpaired products report**. Although Heureka does not pair products into product cards based on EAN codes, its [Unpaired products report](https://heureka.group/cz-cs/datove-sluzby/report-nesparovanych-produktu/) – which Heureka generates and where you can find **information about unpaired products** – works specifically with EAN codes. If you send EANs to Heureka, it will look up unpaired products by EAN and recommend the correct name and category for pairing in the report. The [unpaired products report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/) is available in **Heureka's administration for your shop**. It is available only for online stores in PPC mode, and Heureka generates it once a day. ### **How to Check EAN Correctness in Mergado** #### **How to Find Products with Invalid EAN in Your Feed?** You can easily find products with invalid EAN using the **Find products with invalid EAN automation**. 1. In the selected project, click the **Automation** tab. 2. Click the automation called **Find products with invalid EAN**. 3. The automation has **EAN pre-set** as the EAN code element. Leave it as is. 4. Click **Run automation**. The automation will save products with invalid EAN into a **query called "Products with invalid EAN."** You can then fix the codes or temporarily hide these products (using the Hide product rule) until you fix the EANs. #### **How to Find Products with Missing EAN in Your Feed?** You can find products with missing EAN by **creating a query** for them. 1. On the **Products** page, select the **Simple interface** option in the table. 2. For **Search products**, choose on **input**. 3. In the search field, type **EAN** and then choose the **is empty** option. 4. Click **Search**. 5. All **products with a missing EAN** will be displayed. 6. Enter a **query name** (e.g., Products with missing EAN). 7. Click **Save**. On the same page, click the **Saved queries** tab to find this query. Ideally, try to fill in the EAN for these products as soon as possible, for example using the Data file import rule. ## **Advanced Automation with the Pairing Bear Extension** If you have correctly **filled EAN codes** in your feed and do not want to waste time manually pairing products and reviewing the [unpaired products report](https://sluzby.heureka.cz/obchody/nesparovane-produkty/), you can use the **[Pairing Bear](https://store.mergado.com/detail/pairingbear/#about) extension**. It **automatically pairs your products with product cards on Heureka based on EANs**, and for items that cannot be paired, it offers intelligent recommendations, such as adjusting the name or category. ## **Regular Checks with Mergado Audit** Regularly **checking your feed with [Mergado Audit](https://audit.mergado.com/) helps identify errors** that directly affect product pairing into product cards on Heureka. The audit lets you **continuously monitor these issues, catch feed changes in time**, and systematically increase the share of paired products and their performance. More information about Mergado Audit can be found in the article Mergado Audit: Guide to Technical Product Feed Checks. ### **What Does Mergado Audit Check for Pairing-Related Elements?** #### **CATEGORYTEXT** * Whether the CATEGORYTEXT element is missing or empty for products. * Whether products have multiple CATEGORYTEXT elements. Heureka only processes the first occurrence of CATEGORYTEXT for each item. * Flags when CATEGORYTEXT contains an invalid category level separator or extra separators. * Whether the CATEGORYTEXT element contains only a single value (one level) of category, or whether this element contains an invalid value. * Detects when CATEGORYTEXT contains links (URLs), which do not belong in this element. #### **PRODUCTNAME** * Whether the PRODUCTNAME element is missing or empty for products. * Whether PRODUCTNAME is duplicated – it should be unique for each product in the feed. * Whether the PRODUCTNAME element has the correct length (maximum 200 characters). * Detects when PRODUCTNAME contains prohibited words, links, or characters. For example, information about gifts or shipping does not belong in this element, nor do copyright, trademark, or similar symbols. #### **EAN** * Whether EAN is missing or empty for products. * Whether EAN codes are unique and there are no duplicate values (the same EAN for multiple products) in the feed. * Whether the EAN element contains prohibited values, such as letters, spaces, hyphens, etc., instead of a numeric code. * Whether the EAN element has the correct length. ## **Summary** Correctly filled **CATEGORYTEXT, PRODUCTNAME, and EAN elements form the foundation for successful product pairing** into product cards on Heureka. If these data are accurate, complete, and meet Heureka's requirements, it significantly increases the chance of correct pairing, better visibility, and effective bidding. However, keep in mind that **pairing is just one part of successful advertising**. Heureka has additional requirements for feed structure and quality, and meeting them is essential to prevent products from being rejected and campaigns from being restricted. We cover this topic in more detail in the article Data Optimization for Heureka: How to Fix Errors in Your Product Feed and Ensure Heureka Does Not Reject Products. ## **FAQ** ### **What is product pairing on Heureka and why is it so important?** Product pairing is the process of linking your online store's offer with a specific product card in Heureka's catalog. Paired products rank higher in search results, can use reviews and price comparisons, and enable full bidding. Without pairing, products only appear in full-text search, which significantly reduces their visibility and sales potential. ### **What advantages does correct product pairing bring to an online store?** Correctly paired products have better positions in search results and allow you to set the cost per click. Customers also see reviews, ratings, and comparisons with competitors, which increases the trustworthiness of your offer. Pairing is also one of the conditions for activating Heureka Marketplace and the "Buy via Heureka" button. ### **Which elements are key for successful product pairing?** Three feed elements play a crucial role: CATEGORYTEXT, PRODUCTNAME, and EAN. Each serves a different function – CATEGORYTEXT determines the category, PRODUCTNAME identifies the specific product. An important but not universally mandatory element is EAN, which helps with finding and checking unpaired items. If any of these elements is missing or incorrectly filled, pairing may fail. ### **How should the CATEGORYTEXT element be correctly filled?** CATEGORYTEXT must contain the complete path to the category according to Heureka's category tree. Individual categories and subcategories must be separated by the pipe character "|". It is important to include all category levels; otherwise, Heureka may not classify the product correctly. An incorrectly or incompletely filled CATEGORYTEXT can halt the entire pairing process. ### **How can I set the correct categories for Heureka in Mergado?** In Mergado, you can use the Rename categories in bulk rule, which lets you assign online store categories to categories from Heureka's tree. Functions like "Suggest categories" or "Pre-fill left side" can significantly speed up the process. It is also important to order rules correctly – from general categories to specific ones. ### **What must the PRODUCTNAME element contain for correct pairing?** PRODUCTNAME must match the product card name on Heureka and contain all mandatory data for the specific category, such as brand, color, or size. It must not include marketing information like free gift or free shipping. The maximum name length is 200 characters. ### **How do I add a missing brand to PRODUCTNAME in Mergado?** In Mergado, you can use the "Add producer to product title" automation, which adds the manufacturer name from the appropriate element (e.g., MANUFACTURER) to PRODUCTNAME. The automation creates a rule that ensures the adjustment is applied to all relevant products, improving the chances of correct pairing. ### **How do I add size or another parameter to the product name?** You need to create a Rewrite rule and use variables marked with the % character. Insert the original name into the new PRODUCTNAME value and add the path to the desired parameter (e.g., size from the PARAM element). It is essential to verify that the feed actually contains the needed values. ### **When is the EAN element mandatory and what is its significance?** EAN is mandatory for the categories Books, Textbooks, Maps and Guides, Movies, Music, and Comics, but we recommend filling it in for other categories as well. Although Heureka does not pair directly by EAN, it uses it in the Unpaired products report. With EAN, Heureka can recommend the correct name or category for pairing. ### **How do I detect invalid or missing EAN codes in Mergado?** For invalid EANs, use the "Find products with invalid EAN" automation, which creates a query of problematic items. Products with missing EAN can be found using simple search and a saved query. It is then advisable to fill in the EAN or temporarily hide the products. ### **What is Pairing Bear and how does it help with pairing?** Pairing Bear is an extension that automatically pairs products based on EAN codes. For unpaired items, it offers intelligent recommendations for adjusting the name or category. This saves time and minimizes the need to manually review Heureka's unpaired products report. ### **How does Mergado Audit help with product pairing checks?** Mergado Audit checks the correctness of CATEGORYTEXT, PRODUCTNAME, and EAN elements and detects errors, duplicates, or invalid values. It flags, for example, empty names, invalid category separators, or incorrect text lengths. ### **Why is it not enough to just handle pairing, and why do I need to address other feed requirements?** Pairing is just one part of successful Heureka advertising. The feed must also meet other technical and content requirements; otherwise, products may be rejected or campaigns restricted. That is why it is important to pay attention to overall data optimization and regular feed quality checks. --- ## [Assortment Report in Mergado](https://help.mergado.com/en/mergado-editor/advertising-channels-and-listings/heureka/assortment-report-in-mergado/) # **Assortment Report in Mergado** ## **Assortment Report from Heureka** Some Mergado extensions (e.g., Pairing Bear, Bidding Fox, Pricing Fox) work with reports from Heureka – most commonly the **assortment report**. Heureka generates these reports, **Mergado Keychain** downloads them, and individual extensions draw data from them for analysis. In this guide, you will learn **how the process works, how often reports are generated and downloaded**, and **what to do** when Keychain displays the message **"Connection issues"** or when data appears in extensions with a delay. ## **How It Works in Mergado (When Reports Are Created and Downloaded)?** * **Between 1:00–4:00 AM**, Mergado clicks **"Generate assortment report"** on Heureka. * **Within roughly two hours** of that click, Mergado attempts to **download and process** the report. * If the download fails, Mergado **retries at regular intervals**. * If it keeps failing, you will see an **orange "Connection issues" message** next to the connection in Keychain (the assortment report entry may show an **unspecified error**). * In practice, it can happen that **the Heureka connection is fine**, but **Heureka is not generating the report** – so there is nothing to download. * Changes in some extensions (e.g., a configured campaign or rule) may **not take effect until the following day**. ## **How to Verify and Resolve Issues with Assortment Report Downloads?** ### **1) Check the Connection Status in Keychain** 1. In Keychain, check whether the Heureka connection displays an orange **"Connection issues"** message. 2. Click **Edit**. 3. Verify that the **Heureka connection is working properly**. * If it is and you still see the message, proceed to step 2 – **Heureka may not be generating the report**. ### **2) Verify Report Generation in Heureka Administration** 1. In Heureka administration, open **Statistics and reports** from the left menu. 2. Check whether the **"Assortment report"** tab is available (where you would typically see the red highlight on screen). * **You should see the corresponding screen** with the assortment report. 3. **Cannot see the tab?** Verify that you meet the conditions for report generation: * you have the **"Verified by customers"** badge, **or** * **you have credit**. Details are available in Heureka's help section: [https://sluzby.heureka.cz/napoveda/sortiment-report/](https://sluzby.heureka.cz/napoveda/sortiment-report/) ### **3) Check Your Credit** * Even if you have **"Verified by customers"**, a **negative credit balance** may **prevent the assortment report from being generated**. ### **4) Evaluate the Status and Give It Time** * If the Keychain connection is **working properly** and Heureka **is generating the report**, but Keychain shows that **report data is outdated**, wait **about 1 day** – Heureka may **not have generated new reports yet**, so Mergado has **nothing to download**. ## **When to Contact Support** * If the **"Connection issues"** message **does not disappear after one day**, contact **Mergado technical support**. We will investigate the connection issue. ## **Tips and Recommendations** * When you see the **"Connection issues"** message, **first** verify in Heureka administration **whether the assortment report is actually being generated**. * **Check your credit** – a **negative balance** can **block report generation** even with the **"Verified by customers"** badge. * If Keychain reports a problem but clicking **Edit** shows the connection is **OK**, give the report **about a day** – new reports may not yet be available from Heureka. * Changes in extensions (campaigns, rules) may **not take effect until the following day**. ## **FAQ** ### **Why does Keychain show "Connection issues" for the assortment report?** Mergado tried to download the report repeatedly and was unsuccessful. The reason may also be that **Heureka is currently not generating the report** – so **there is nothing to download**. ### **The Heureka connection shows as working after clicking "Edit". Is that fine?** Yes, the connection may be OK, but **the report from Heureka may not exist yet**. In that case, wait **about 1 day** for a new report to be generated. ### **How often does Mergado trigger and download the assortment report?** **Between 1:00–4:00 AM**, Mergado clicks **"Generate assortment report"**, and within **roughly 2 hours**, it attempts to **download and process** the report. If an error occurs, it **retries repeatedly**. ### **Where can I find the assortment report in Heureka?** In Heureka administration, under the **Statistics and reports** section, on the **"Assortment report"** tab. ### **I cannot see the "Assortment report" tab. What now?** Verify that you meet Heureka's conditions: **"Verified by customers"** **or** **positive credit**. Details: [https://sluzby.heureka.cz/napoveda/sortiment-report/](https://sluzby.heureka.cz/napoveda/sortiment-report/) ### **I have "Verified by customers" but the report is not being generated. Why?** Check your **credit**. If it is **negative**, the **report may not be generated**. ### **I set up a campaign or rule in an extension but do not see the changes immediately. Is that normal?** Yes, **changes may not take effect until the next day**. ### **When should I contact support?** If the **"Connection issues"** message **does not disappear after 1 day** of verifying the connection and Heureka's conditions, write to **Mergado technical support** – we will investigate the connection. --- ## [Mergado Audit: Guide to technical product feed inspection](https://help.mergado.com/en/product-data-audit/mergado-audit/mergado-audit-guide-to-technical-feed-inspection/) # **Mergado Audit: Guide to technical product feed inspection** For successful advertising on comparison shopping engines and ad platforms, your product data needs to be **accurate, complete, and valid**. The technical state of your feed directly **affects product approval, pairing, and campaign performance**. **[Mergado Audit](https://audit.mergado.com/) is a free online tool** that shows you the actual condition of your XML or CSV feed within minutes — and **tells you exactly what to fix**. ## **1. What is Mergado Audit?** Mergado Audit is a tool that **automatically performs a technical check of your product XML or CSV feed** and reveals issues that need attention. **Mergado Audit:** * loads your data file once from a public URL, * runs a set of tests based on validators, * evaluates found errors, warnings, and recommendations, * displays specific solution suggestions. The Audit works as **feed diagnostics**. It doesn't modify data — it only analyzes **data quality and compliance with the requirements of the selected advertising channel** (e.g. Google or Heureka). It's worth noting that the Audit won't catch every possible issue. It focuses on technical and formal data accuracy based on defined validation rules. It doesn't evaluate business strategy, price competitiveness, product text quality, or actual campaign performance. ## **2. What it's used for** The main goal of the audit is to **detect issues** that can: * cause product rejections, * limit product visibility in filters, * hurt pairing with competing offers, * negatively impact advertising performance. **Practical benefits:** * **Detecting critical errors** — Find out why comparison engines or advertising systems (e.g. Google or Heureka) may be rejecting your products. * **Checking required parameters** — The Audit verifies the presence and correctness of required elements (e.g. price, availability, EAN, URL). * **Data quality analysis** — Checks not just whether required elements exist, but whether the data itself is valid. For example, price format, EAN code accuracy, or URL uniqueness. * **Improving filtering and pairing** — The Audit checks whether parameters affecting product pairing and better filter visibility are filled in correctly. * **Specific fix recommendations** — Results include problem descriptions and fix recommendations (often with links to documentation or video tutorials). ## **3. How Mergado Audit works** Mergado Audit is designed to be as **simple as possible, even for non-technical users**. **Where to run the audit:** * on the standalone page [audit.mergado.com](http://audit.mergado.com) * or directly from the Mergado Editor interface **What you need to start:** * A URL of your XML or CSV feed (publicly accessible) * An email address to receive the results **How to run the audit:** 1. Enter the **feed URL**. 2. Select the **target format** (e.g. Google, Heureka), or let the system detect the format automatically. → This step is important because each advertising channel has its own feed structure, required elements, and specific validation rules. The Audit needs to know **which rules to check the data against**. In other words, a Google feed is evaluated differently than a Heureka feed. 3. **Enter the email** where you want to receive the audit results. 4. Click **Run audit** and the audit performs the check. Processing time ranges from a few **minutes to a maximum of several hours for large feeds** (depending on file size and system load). ## **4. Evaluating the results** Results are clearly divided into **three severity levels**: 🔴 **Errors (red)** Serious issues that can lead to product rejection or prevent proper processing. 🟡 **Warnings (yellow)** Issues that don't directly block advertising but may reduce performance or data quality. 🟢 **Recommendations (green)** Tips for further feed optimization and improved competitiveness and advertising performance. ## **5. Pricing, limits, and availability** * **Price:** Mergado Audit is **free**. * **Registration:** No Mergado registration required. * **Repeat usage:** The Audit can be run repeatedly without any limits. * **Recommended frequency:** At least once a month (ideally after major feed changes). * **Maximum feed size:** The current limit is 256 MB. If you need to check a feed that exceeds this limit, you'll find instructions in the article What to do when your feed for Audit exceeds 256 MB. * **Results availability:** Results are available online for 10 days. ## **6. Who is Mergado Audit suitable for?** * Online stores that want to quickly **check feed quality**. * PPC specialists when **taking over a new account**. * Agencies as **initial project diagnostics**. * Companies that want to **detect technical issues** without a developer. ## **7. Specialized audits** In addition to the basic product feed audit, Mergado also offers **specialized tools focused on checking specific e-commerce areas**. All specialized audits are free. * **Image audit ([audit-obrazku.cz](http://audit-obrazku.cz)):** The image audit checks the technical parameters of product photos, such as resolution, background, format, or URL availability. It helps prevent image rejection in advertising systems. * **Bidding audit ([bidding-audit.cz](http://bidding-audit.cz)):** The bidding audit focuses on the state of your assortment in bidding campaigns on Heureka. It evaluates competitiveness, pairing, and strategy efficiency. * **Pricing audit ([pricing-audit.cz](http://pricing-audit.cz)):** The pricing audit reveals pricing issues on Heureka, compares your prices with competitors, and helps identify unpaired products or offers with zero or extreme prices. ## **Summary** Mergado Audit is a free tool for technical inspection of XML and CSV feeds that helps **quickly detect issues in product data**. It flags errors affecting product approval, pairing, and visibility in advertising systems, and provides clear recommendations for fixes. However, it's important to see it as a **diagnostic tool primarily focused on data quality** — not as a comprehensive marketing or strategic analysis. It delivers the most value when its outputs lead to further work on campaigns, pricing, or assortment. If you want to be sure your advertising stands on solid data, regular feed checks should be a natural part of your e-commerce routine. ## **FAQ** ### **What is Mergado Audit?** Mergado Audit is a free online tool for technical inspection of product XML and CSV feeds. It automatically analyzes data quality and flags errors, warnings, and recommendations based on the rules of the selected advertising channel (e.g. Google or Heureka). It also recommends specific solutions. ### **Is Mergado Audit free?** Yes. Using Mergado Audit is completely free. ### **Do I need a Mergado account to run the Audit?** No. No Mergado registration is required to run the audit. You can launch it on the standalone page [audit.mergado.com](http://audit.mergado.com). ### **Does the Audit modify data in my feed?** No. The Audit only analyzes data and evaluates its quality. It doesn't make any changes to the feed. ### **Why should I even audit my feed?** The state of your feed affects product approval, display in filters, pairing with competing offers, and overall advertising performance. The Audit helps detect issues that can slow down or block your advertising. ### **What errors does the Audit detect?** The Audit checks the feed according to the rules of the specific target platform the data is intended for (e.g. Google or Heureka). Each advertising channel has its own feed structure requirements, required elements, and value formats. The Audit evaluates data based on these rules. It detects, for example, missing required elements (price, availability, EAN, URL, etc.), invalid price format, invalid EAN codes, duplicate or broken URLs, feed structural errors, or data non-compliance with the selected platform's requirements. ### **Does the Audit also check data quality, or just presence?** It checks both. It monitors not only whether an element exists, but also whether its value is valid and properly formatted. ### **Can the Audit help improve product pairing?** Yes. Checking correctly filled parameters can significantly improve pairing and product visibility in filters. ### **How do I launch Mergado Audit?** 1. Go to [audit.mergado.com](http://audit.mergado.com). 2. Enter your feed URL. 3. Select the target format or let the system detect it automatically. 4. Enter an email for the results. 5. Click "Run audit." ### **Why do I need to select a target format?** Each advertising channel has its own feed structure and validation rules. The Audit needs to know which rules to evaluate the data against. A Google feed is checked differently than a Heureka feed. ### **What do I need to run the audit?** 1. A publicly accessible URL of an XML or CSV feed. 2. An email address for the results. ### **How long does the check take?** Usually a few minutes. For large feeds, processing may take longer (up to several hours), depending on file size and system load. ### **Can I run the audit multiple times?** Yes. The Audit can be run repeatedly without any limits. ### **How often should I run the audit?** We recommend at least once a month, ideally after every major feed or online store update. ### **What do audit results look like?** Results are divided into three levels: 🔴 Errors — Serious issues that can cause product rejection. 🟡 Warnings — Issues that may reduce advertising performance. 🟢 Recommendations — Tips for further optimization. ### **How long are results available?** Results are available online for 10 days. ### **Do results include fix instructions?** Yes. Each found issue includes a description and recommended solution. Links to documentation or video tutorials are often included. ### **What is the maximum feed size for auditing?** The maximum file size is 256 MB. ### **What if my feed is larger than the Audit limit?** You need to split the feed. Follow the instructions in the article "What to do when your feed for Audit exceeds 256 MB". ### **Does the Audit support both XML and CSV feeds?** Yes, it supports both formats. ### **Is the Audit suitable for beginners?** Yes. The tool is designed so even non-technical users can handle it. ### **Can agencies and PPC specialists use the Audit?** Yes. The Audit is suitable as initial diagnostics when taking over a new project. ### **Do I need a developer to fix errors?** Not always. Many errors can be fixed using feed editing tools (e.g. in Mergado Editor). For fundamental structural issues, developer involvement may be necessary. ### **Are there other audit types besides the basic feed audit?** Yes. Mergado also offers specialized audits — image audit, pricing audit, and bidding audit. ### **What is the Image Audit?** A tool that checks the technical parameters of product photos (resolution, format, URL availability, background). It helps prevent their rejection in advertising systems. ### **What is the Bidding Audit?** It analyzes the state of bidding campaigns on Heureka. It evaluates competitiveness, pairing, and strategy efficiency. ### **What is the Pricing Audit?** It focuses on pricing on Heureka. It identifies unpaired products, zero or extreme prices, or price non-competitiveness. ### **Are the specialized audits free?** Yes, all audit types are free. ### **Is the Audit suitable as a regular data quality check?** Yes. Running the audit regularly helps keep your feed in good shape long-term. --- ## [What to do when your feed for Audit exceeds 256 MB](https://help.mergado.com/en/product-data-audit/mergado-audit/what-to-do-when-feed-exceeds-256-mb/) # **What to do when your feed for Audit exceeds 256 MB** Mergado Audit checks the technical accuracy and data quality of your feed. Currently, it can only process files up to **256 MB**. If your feed exceeds this limit, the Audit won't start and you'll see the message: **"Maximum allowed file size exceeded."** This guide explains why this happens and shows you proven methods to temporarily reduce or split your feed so you can run the Audit. ## **Step-by-step guide** ### **1) Split the feed into smaller parts** If your infrastructure allows it, split the original feed into two smaller parts and check each one separately in the Audit. **Keep in mind:** * Each part of the feed must have a complete structure (header and closing tags) for the Audit to work correctly. ### **2) Temporarily reduce the feed by hiding some products in Mergado** If splitting isn't possible, reduce the data directly in Mergado. **How to do it:** **1. Create a product query** * Go to **Products** and create a query for roughly half of the items. * Choose criteria based on your feed structure — e.g. **category**, **price range**, or **number in `ITEM_ID`**. **2. Apply a hiding rule** * Open **Rules** → **New rule**. * Select **Hide product** as the rule type and apply it to the query you created. **3. Regenerate the feed** * **Settings** → **Regeneration** → **Regenerate changed**. **4. Run the Audit** * Run the Audit on this "reduced" **output feed**. ### **3) Additional ways to further reduce the size** If the output feed still exceeds 256 MB, try: * **Hide more products** (expand the query, e.g. add more categories or brands). * **Temporarily hide large elements**, typically **`DESCRIPTION`**. * Do this on the **Elements** page using the **toggle** on the right side. > **Tip!** Only hide elements temporarily for Audit purposes. After the check is done, **turn them back on** so the feed remains complete for export. ## **When to contact support** Are you sure the feed is under 256 MB but the Audit still reports an error? Contact **Mergado technical support** — we'll be happy to investigate. ## **FAQ** ### **Why can't Mergado Audit process a feed larger than 256 MB?** The current version of Audit has a **256 MB** limit. Larger files cannot be checked and you'll see the error "Maximum allowed file size exceeded." ### **What should I do if my feed exceeds the limit?** Either **split the feed** into smaller parts (each with a complete structure), or **temporarily reduce it** in Mergado by hiding some products or selected elements. ### **How do I temporarily hide some products?** On the **Products** page, create a query (e.g. by categories, prices, or `ITEM_ID`). In **Rules**, create a **New rule** → **Hide product** and apply it to the query. ### **How do I hide specific elements (e.g. DESCRIPTION)?** On the **Elements** page, use the **toggle** next to the element. Don't forget to **turn it back on** after the Audit. ### **Do I need to regenerate the feed after making changes?** Yes. Go to **Settings** → **Regeneration** → **Regenerate changed**, and only then run the Audit on the output feed. ### **When should I contact support?** If the feed is **under 256 MB** but the Audit still reports a size limit error or another issue, contact **Mergado technical support**. --- ## [Google Feed Validators 1: Errors and Solutions](https://help.mergado.com/en/product-data-audit/google-validators/google-feed-validators-1-error-definitions-and-recommended-solutions/) # **Google Feed Validators 1: Error definitions and recommended solutions** This document contains an overview of validators related exclusively to **Google elements in the product feed**, used in the **Mergado Audit** tool. Each validator describes a specific feed issue, its meaning, and the recommended fix procedure in Mergado. | title | description | |:-----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Element BARCODE contains an invalid value | Element BARCODE contains an invalid value | | Element EAN contains an invalid value | Element EAN contains an invalid value EAN is a unique numeric product code. It appears on packaging as a barcode.
Heureka supports EAN-13, which consists of 13 digits in a specific order.

*How to fix this error?*

A small number of products with this error can be fixed by manual editing. On the Products page, find the specific product with the incorrect EAN code. Use the pencil icon on the EAN element row to manually edit its value and correct or delete the incorrect EAN. Repeat for other products.

For a larger number of incorrect EAN codes, the approach depends on the specific situation and what is wrong in the EAN element:

- For example, if EAN contains an extra character, you can use a Find and Replace rule to remove that character.
- Or you may find it useful to first create a product query on the Products page with incorrect EAN values, and then add a Rewrite rule applied to this query, leaving the new value field empty. This will delete the incorrect values in the EAN element for products in the query.
- If you have the correct EAN codes available, for example in a CSV file, you can import them to feed products using a "Data file import" rule.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element ean contains an invalid value | Element ean contains an invalid value EAN is a unique numeric product code. It appears on packaging as a barcode. EAN consists of 8 or 12-14 digits in a specific order. | | Element EANCODE contains an invalid value | Element EANCODE contains an invalid value EAN is a unique numeric product code. It appears on packaging as a barcode.
Arukereso supports EAN-13, which consists of 13 digits in a specific order.

*How to fix this error?*

A small number of products with this error can be fixed by manual editing. On the Products page, find the specific product with the incorrect EAN code. Use the pencil icon on the EAN element row to manually edit its value and correct or delete the incorrect EAN. Repeat for other products.

For a larger number of incorrect EAN codes, the approach depends on the specific situation and what is wrong in the EAN element:

- For example, if EAN contains an extra character, you can use a Find and Replace rule to remove that character.
- Or you may find it useful to first create a product query on the Products page with incorrect EAN values, and then add a Rewrite rule applied to this query, leaving the new value field empty. This will delete the incorrect values in the EAN element for products in the query.
- If you have the correct EAN codes available, for example in a CSV file, you can import them to feed products using a "Data file import" rule.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element ean contains an invalid value | Element ean contains an invalid value The ean element contains a unique numeric product code. It appears on packaging as a barcode. EAN consists of 8 or 13 digits in a specific order. | | The value of element G:GTIN has an incorrect format | The value of element G:GTIN has an incorrect format Element g:gtin is a unique product identifier; online store owners typically fill it with the EAN code value.
In the Google Shopping feed, g:gtin can contain 0, 8, 12, 13, or 14 characters. Spaces or hyphens are allowed but will be ignored. Some products have an incorrect code format.

How to fix this error?

A small number of products with this error can be fixed by manual editing. On the Products page, find the specific product with the incorrect g:gtin code. Use the pencil icon on the g:gtin element row to manually edit its value and correct or delete the incorrect g:gtin. Repeat for other products.

For a larger number of incorrect g:gtin codes, the approach depends on the specific situation and what is wrong in the g:gtin element:

- For example, if g:gtin contains an extra character, you can use a Find and Replace rule to remove that character.
- Or you may find it useful to first create a product query on the Products page with incorrect g:gtin values, and then add a Rewrite rule applied to this query, leaving the new value field empty. This will delete the incorrect values in the g:gtin element for products in the query.
- If you have the correct g:gtin codes available, for example in a CSV file, you can import them to feed products using a "Data file import" rule.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | The value of element gtin has an incorrect format | The value of element gtin has an incorrect format Element gtin is a unique identifier for your product. It can contain 0, 8, 12, 13, or 14 characters. Spaces or hyphens are allowed but will be ignored. | | The value of element GTIN has an incorrect format | The value of element GTIN has an incorrect format Element GTIN is a unique identifier for your product. It can contain 0, 8, 12, 13, or 14 characters. Spaces or hyphens are allowed but will be ignored. | | The value of element G:GTIN has an incorrect format | The value of element G:GTIN has an incorrect format Element G:GTIN is a unique identifier for your product. It can contain 0, 8, 12, 13, or 14 characters. Spaces or hyphens are allowed but will be ignored. | | Element ISBN contains an invalid value | Element ISBN contains an invalid value ISBN is a unique book identifier. It contains numbers separated by hyphens.
Heureka supports ISBN-10 and ISBN-13 formats.

How to fix this error?

A small number of products with this error can be fixed by manual editing. On the Products page, find the specific product with the incorrect ISBN code. Use the pencil icon on the ISBN element row to manually edit its value and correct the incorrect ISBN. Repeat for other products.

For a larger number of incorrect ISBN codes, the approach depends on the specific situation and what is wrong in the ISBN element:

- For example, if ISBN contains an extra character, you can use a Find and Replace rule to remove that character.
- If you have the correct ISBN codes available, for example in a CSV file, you can import them to feed products using a "Data file import" rule.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | The value of element StructuredId has an incorrect format | The value of element StructuredId has an incorrect format Element StructuredId is a unique identifier for your product. It can contain 0, 8, 12, 13, or 14 characters. Spaces or hyphens are allowed but will be ignored. | | Element PRODUCTNO contains an invalid value | Element PRODUCTNO contains an invalid value | | The value of element gtin has an incorrect format | The value of element gtin has an incorrect format The gtin element is a unique identifier for your product. It can contain 0, 8, 12, 13, or 14 characters. Spaces or hyphens are allowed but will be ignored. | | Element PRODUCTNAME contains a disallowed value | Element PRODUCTNAME contains a disallowed value The PRODUCTNAME element must not contain non-breaking spaces  . | | Element CATEGORY contains a disallowed value | Element CATEGORY contains a disallowed value The CATEGORY element must not contain non-breaking spaces  . | | Element DESCRIPTION contains a disallowed value | Element DESCRIPTION contains a disallowed value The DESCRIPTION element must not contain non-breaking spaces  . | | Element EAN contains a disallowed value | Element EAN contains a disallowed value The EAN element must not contain non-breaking spaces  . | | Element ITEMGROUP_ID contains a disallowed value | Element ITEMGROUP_ID contains a disallowed value The ITEMGROUP_ID element must not contain non-breaking spaces  . | | Element ITEM_ID contains a disallowed value | Element ITEM_ID contains a disallowed value The ITEM_ID element must not contain non-breaking spaces  . | | Element MANUFACTURER contains a disallowed value | Element MANUFACTURER contains a disallowed value The MANUFACTURER element must not contain non-breaking spaces  . | | Element PRODUCTNAME contains a disallowed value | Element PRODUCTNAME contains a disallowed value The PRODUCTNAME element must not contain non-breaking spaces  . | | Element PRODUCTNO contains a disallowed value | Element PRODUCTNO contains a disallowed value The PRODUCTNO element must not contain non-breaking spaces  . | | Element SEO_PREFIX contains a disallowed value | Element SEO_PREFIX contains a disallowed value The SEO_PREFIX element must not contain non-breaking spaces  . | | The value of element DELIVERY_DATE has a borderline value of 8 days | The value of element DELIVERY_DATE has a borderline value of 8 days Heureka rounds the delivery time from the DELIVERY_DATE element. For example, if you enter 2 days, Heureka displays "up to 3 days", the same as for items that specify 3 days. Customers pay attention to this information. It is therefore advisable to optimize values that approach the limit to ensure the best display results.| | The value of element DELIVERY_DATE has a borderline value of 4 days | The value of element DELIVERY_DATE has a borderline value of 4 days Heureka rounds the delivery time from the DELIVERY_DATE element. For example, if you enter 2 days, Heureka displays "up to 3 days", the same as for items that specify 3 days. Customers pay attention to this information. It is therefore advisable to optimize values that approach the limit to ensure the best display results.| | The value of element DELIVERY_DATE has a borderline value | The value of element DELIVERY_DATE has a borderline value Zboží.cz rounds the delivery time. For example, if you enter 7 days, Zboží.cz displays "more than a week", the same as for items that specify e.g. 10 days. Customers pay attention to this information. It is therefore advisable to optimize values that approach the limit to ensure the best display results.| | Element contains a disallowed value | Element contains a disallowed value Do not include links to other pages where your product is also available for purchase. Must not contain words: promotion, shipping, warranty, etc. | | The product is probably sold out | The product is probably sold out The DESCRIPTION element contains keywords that may indicate the product is sold out or unavailable.
Check the listed products to see if they are sold out.

If the product is actually sold out or unavailable, we do not recommend including it in advertising data. You can remove such products from the feed using a "Product hiding" rule.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element G:TITLE contains a disallowed value | Element G:TITLE contains a disallowed value The value of element g:title must not contain information about free shipping, distribution, authorized seller, etc. — no additional promotional messages promoting your products. Check that g:title does not contain terms like "free shipping", "distribution", "authorized seller", "availability", "installment sale", etc. for the following products.| | Element TITLE contains a disallowed value | Element TITLE contains a disallowed value The G:TITLE element must not contain information about free shipping, distribution, authorized seller, etc. | | Element G:TITLE contains a disallowed value | Element G:TITLE contains a disallowed value The g:title element value cannot contain URL links. However, some of your products contain links or parts of URLs in this element.

How to fix this error?

You can remove links from the g:title element using, for example, a Find and Replace rule.

In the Find field, enter the link you want to delete, and leave the Replace field empty. This will remove the found text.

If there are many different links (each one is different), you can remove them in bulk using regular expressions.
If you need help composing a suitable regular expression, please contact our technical support — we will advise you. | | Element GIFT contains a disallowed value | Element GIFT contains a disallowed value The GIFT element must not contain the word "discount". Remove this word by editing the rule that creates the gift or by using a Find and Replace rule.
According to the Heureka specification, the gift should not be a discount or a service.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element ITEM_TYPE contains the value "bazar" | Element ITEM_TYPE contains the value "bazar" The value "Bazar" in the ITEM_TYPE element indicates the sale of used goods. Such items are barely displayed by the product search engine, they do not appear in product cards in categories. They can only be found via Heureka full-text search.
Consider hiding such products from the feed. You can do this in two steps:

1. On the Products page, create a query with the condition ITEM_TYPE = "Bazar", and then:
2. On the Rules page, add a new rule, choose the type "Hide product", and use the query from step 1. | | Element NAME contains a disallowed value | Element NAME contains a disallowed value The value in the Name element cannot contain words like 'discount', 'discounted', 'at a discount', 'favorable', 'promotion', 'promotional', 'free', 'free of charge', 'price reduction', 'clearance sale', 'price cut'.

How to fix this error?

You can remove disallowed words from the Name element using, for example, a Find and Replace rule.

In the Find field, enter the word you want to delete, and leave the Replace field empty. This will remove the found text.

If there are many different occurrences (each one is different), you can remove them in bulk using regular expressions.
If you need help composing a suitable regular expression, please contact our technical support — we will advise you. | | Product distribution is listed as unknown | Product distribution is listed as unknown The "Distribution" parameter indicates which market the product is intended for. For products sold in the Czech Republic, the most common values are "CZ" and "EU". Some of your products have distribution listed as unknown. Check whether this is intentional.

How to fix this error?

Rewrite the "Distribution" parameter value to, for example, "CZ" or "EU" if the product is intended for the Czech market. You can do this using a Rewrite rule or a Find and Replace rule. The path to the element (to the "Distribution" parameter value) would look like this in both rules:
PARAM { PARAM_NAME = "Distribution" } | VAL

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element PARAM_NAME contains a disallowed value | Element PARAM_NAME contains a disallowed value The parameter name in the PARAM element | PARAM_NAME cannot contain links. Some of your products have links in parameter names.

How to fix this error?

You can remove links from parameter names using, for example, a Find and Replace rule.
The full path to the element where you will perform the replacement would look like this:
PARAM | PARAM_NAME

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Parameter PARAM contains a disallowed value | Parameter PARAM contains a disallowed value The parameter value in element PARAM | VAL is used to specify the actual value of a product parameter. For example, specific colors, sizes, features, etc. It should be reasonably long and should not contain, for example, addresses to external websites, etc.
However, some products have these disallowed links in parameter values. You can remove them using a Find and Replace rule.| VAL

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element PRODUCTNAME contains disallowed words or characters | Element PRODUCTNAME contains disallowed words or characters The value of element PRODUCTNAME should not contain benefit words like "gift" or "shipping". It should also not contain characters "©", "™", nor information that the product is sold out or unavailable.

How to fix this error?

Unwanted words or characters in the product name can be removed in bulk using a Find and Replace rule.
In the Find field, enter the searched word, and leave the Replace field empty. This will remove the found text.
If the searched text is not found in PRODUCTNAME, the element value will remain unchanged.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element PRODUCT contains a disallowed value | Element PRODUCT contains a disallowed value The value of element PRODUCT should not contain extra words like "installments", "sale price", "discount", "bonus", "personal pickup", "free shipping", etc., nor information that the product is sold out or unavailable.

How to fix this error?

Unwanted words or characters in the product name can be removed in bulk using a Find and Replace rule.
In the Find field, enter the searched word, and leave the Replace field empty. This will remove the found text.
If the searched text is not found in PRODUCT, the element value will remain unchanged.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element TITLE contains a disallowed value | Element TITLE contains a disallowed value The TITLE element must not contain any additional messages promoting your products. Check that it does not contain terms like "free shipping", "distribution", "authorized seller", "availability", "installment sale", "installments", "discount", "sale price", "bonus", "personal pickup", etc.| | Element PRODUCTNAME contains a disallowed value | Element PRODUCTNAME contains a disallowed value The product name should not contain words like sale, discount, etc. | | Element Termeknev contains a disallowed value | Element Termeknev contains a disallowed value The Termeknev element must not contain any additional messages promoting your products. Check that it does not contain terms like 'áron alul', 'legjobbár', 'bónusz', 'vadonatúj', 'ingyenes', 'raktáron', 'minimum vásárlás', 'most rendelni', 'kedvezmény', 'felújított', 'garancia' and remove them if present. | | Element CATEGORYTEXT contains a link | Element CATEGORYTEXT contains a link The categorization path in the CATEGORYTEXT element cannot contain links. However, some of your products contain links in this element.

How to fix this error?

You can remove links from the CATEGORYTEXT element using, for example, a Find and Replace rule.

In the Find field, enter the link you want to delete, and leave the Replace field empty. This will remove the found text.

If there are many different links (each one is different), you can remove them in bulk using regular expressions.
If you need help composing a suitable regular expression, please contact our technical support — we will advise you. | | Element PRODUCT contains a link | Element PRODUCT contains a link The value in the PRODUCT element cannot contain links. However, some of your products contain links in this element.

How to fix this error?

You can remove links from the PRODUCT element using, for example, a Find and Replace rule.

In the Find field, enter the link you want to delete, and leave the Replace field empty. This will remove the found text.

If there are many different links (each one is different), you can remove them in bulk using regular expressions.
If you need help composing a suitable regular expression, please contact our technical support — we will advise you. | | Element PRODUCTNAME contains a link | Element PRODUCTNAME contains a link The PRODUCTNAME element is used for product identification and must not contain URL links, only text. | | Element TITLE contains a URL link | Element TITLE contains a URL link The TITLE element is used for product identification and must not contain URL links, only text. | | Element VISIBILITY contains the value 0 | Element VISIBILITY contains the value 0 The value of element VISIBILITY indicates whether the product should appear in the product search engine advertising. In your XML, some products have this element set to 0, and therefore they will not appear in advertising. | | Element CATEGORYTEXT contains an invalid separator | Element CATEGORYTEXT contains an invalid separator | | Element CATEGORYTEXT appears more than once | Element CATEGORYTEXT appears more than once | | Element CATEGORYTEXT contains redundant separators | Element CATEGORYTEXT contains redundant separators | | Element CATEGORYTEXT contains only one value | Element CATEGORYTEXT contains only one value The category designation should contain the full path to the product, including the category and its subcategories. | | Element CATEGORYTEXT has an invalid value | Element CATEGORYTEXT has an invalid value The element should designate the product category. The category should be properly described, including nesting into subcategories. | | Element CATEGORY contains an invalid separator | Element CATEGORY contains an invalid separator | | Element CATEGORY appears multiple times in the feed | Element CATEGORY appears multiple times in the feed The element CATEGORY may only appear once in your feed. Check its occurrences. | | Element CATEGORY contains redundant separators | Element CATEGORY contains redundant separators The element CATEGORY contains redundant category separators, probably at the end. Remove them. | | Element CATEGORY contains only one category | Element CATEGORY contains only one category Element CATEGORY contains only one category, which is not allowed by the search engine. Add more categories. | | Element CATEGORY contains an invalid value | Element CATEGORY contains an invalid value The feed must contain the complete category path from the Zboží.cz category tree. The vertical bar is used as the separator. | | Element fb_product_category contains an invalid separator | Element fb_product_category contains an invalid separator | | Element fb_product_category appears multiple times in the feed | Element fb_product_category appears multiple times in the feed The element fb_product_category may only appear once in your feed. Check its occurrences. | | Element fb_product_category contains redundant separators | Element fb_product_category contains redundant separators The element fb_product_category contains redundant category separators, probably at the end. Remove them. | | Element fb_product_category contains only one category | Element fb_product_category contains only one category Element fb_product_category contains only one category, which is not allowed by the search engine. Add more categories. | | Element fb_product_category contains an invalid value or is too short | Element fb_product_category contains an invalid value or is too short Element fb_product_category contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element product_type contains an invalid separator | Element product_type contains an invalid separator | | Element product_type appears multiple times in the feed | Element product_type appears multiple times in the feed The element product_type may only appear once in your feed. Check its occurrences. | | Element product_type contains redundant separators | Element product_type contains redundant separators The element product_type contains redundant category separators, probably at the end. Remove them. | | Element product_type contains only one category | Element product_type contains only one category Element product_type contains only one category, which is not allowed by the search engine. Add more categories. | | Element product_type contains an invalid value or is too short | Element product_type contains an invalid value or is too short Element product_type contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element G:GOOGLE_PRODUCT_CATEGORY contains an invalid separator | Element G:GOOGLE_PRODUCT_CATEGORY contains an invalid separator | --- ## [Google Feed Validators 2: Errors and Solutions](https://help.mergado.com/en/product-data-audit/google-validators/google-feed-validators-2-error-definitions-and-recommended-solutions/) # **Google Feed Validators 2: Error definitions and recommended solutions** This document contains an overview of validators related exclusively to **Google elements in the product feed**, used in the **Mergado Audit** tool. Each validator describes a specific feed issue, its meaning, and the recommended fix procedure in Mergado. | title | description | |:-----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Element G:GOOGLE_PRODUCT_CATEGORY appears multiple times in the feed | Element G:GOOGLE_PRODUCT_CATEGORY appears multiple times in the feed The element G:GOOGLE_PRODUCT_CATEGORY may only appear once in your feed. Check its occurrences. | | Element G:GOOGLE_PRODUCT_CATEGORY contains redundant separators | Element G:GOOGLE_PRODUCT_CATEGORY contains redundant separators The element G:GOOGLE_PRODUCT_CATEGORY contains redundant category separators, probably at the end. Remove them. | | Element G:GOOGLE_PRODUCT_CATEGORY contains only one category | Element G:GOOGLE_PRODUCT_CATEGORY contains only one category Element G:GOOGLE_PRODUCT_CATEGORY contains only one category, which is not allowed by the search engine. Add more categories. | | Element G:GOOGLE_PRODUCT_CATEGORY contains an invalid value or is too short | Element G:GOOGLE_PRODUCT_CATEGORY contains an invalid value or is too short Element G:GOOGLE_PRODUCT_CATEGORY contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element GOOGLE_PRODUCT_CATEGORY contains an invalid separator | Element GOOGLE_PRODUCT_CATEGORY contains an invalid separator | | Element GOOGLE_PRODUCT_CATEGORY appears multiple times in the feed | Element GOOGLE_PRODUCT_CATEGORY appears multiple times in the feed The element G:GOOGLE_PRODUCT_CATEGORY may only appear once in your feed. Check its occurrences. | | Element GOOGLE_PRODUCT_CATEGORY contains redundant separators | Element GOOGLE_PRODUCT_CATEGORY contains redundant separators The element G:GOOGLE_PRODUCT_CATEGORY contains redundant category separators, probably at the end. Remove them. | | Element GOOGLE_PRODUCT_CATEGORY contains only one category | Element GOOGLE_PRODUCT_CATEGORY contains only one category Element GOOGLE_PRODUCT_CATEGORY contains only one category, which is not allowed by the search engine. Add more categories. | | Element GOOGLE_PRODUCT_CATEGORY contains an invalid value or is too short | Element GOOGLE_PRODUCT_CATEGORY contains an invalid value or is too short Element GOOGLE_PRODUCT_CATEGORY contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element CATEGORYTEXT contains an invalid separator | Element CATEGORYTEXT contains an invalid separator The vertical bar is used as the separator between individual category levels: |

How to fix this error?

If you have a different character as the separator in the CATEGORYTEXT element, you can easily replace it with the vertical bar using a Find and Replace rule.
In the Find field, enter the current separator, in the Replace field, enter the character: |

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element CATEGORYTEXT appears more than once | Element CATEGORYTEXT appears more than once Heureka only processes the first occurrence of the CATEGORYTEXT element for each item. There is therefore no point in sending the CATEGORYTEXT element multiple times for one product to Heureka.

How to fix this error?

You can delete the second and subsequent occurrences of the CATEGORYTEXT element for products using a rule.| | Element CATEGORYTEXT contains redundant separators | Element CATEGORYTEXT contains redundant separators The separator character for category levels "vertical bar": | should only appear between individual categories. Some products have this character listed multiple times in a row, or there is no further category level after (or before) it.

How to fix this error?

This depends on the specific situation.
For example, if the separator is simply doubled, you can reduce it using a Find and Replace rule, in which you replace two separators: || with one: |
If you want to set the values in the CATEGORYTEXT element completely and correctly, we recommend using a Bulk category renaming rule, which includes an autocomplete feature for Heureka categories in the correct format.

If the problem is more complex, please contact our technical support — we will advise you on a specific solution. | | Element CATEGORYTEXT contains only one value | Element CATEGORYTEXT contains only one value The CATEGORYTEXT element should contain the full path to the most deeply nested product category. This means the main category including subcategories separated by the character | .

How to fix this error?

If you want to set the values in the CATEGORYTEXT element completely and correctly, we recommend using a Bulk category renaming rule, which includes an autocomplete feature for Heureka categories in the correct format.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element CATEGORYTEXT has an invalid value | Element CATEGORYTEXT has an invalid value The CATEGORYTEXT element should contain the full path to the most deeply nested product category. This means the main category including subcategories separated by the character | .

How to fix this error?

If you want to set the values in the CATEGORYTEXT element completely and correctly, we recommend using a Bulk category renaming rule, which includes an autocomplete feature for Heureka categories in the correct format.

If you still need help with the fix, please contact our technical support. We will advise you on a specific solution. | | Element Kategoria contains an invalid separator | Element Kategoria contains an invalid separator | | Element Kategoria appears multiple times in the feed | Element Kategoria appears multiple times in the feed The element Kategoria may only appear once in your feed. Check its occurrences. | | Element Kategoria contains redundant separators | Element Kategoria contains redundant separators The element Kategoria contains redundant category separators, probably at the end. Remove them. | | Element Kategoria contains only one category | Element Kategoria contains only one category Element Kategoria contains only one category, which is not allowed by the search engine. Add more categories. | | Element Kategoria contains an invalid value or is too short | Element Kategoria contains an invalid value or is too short Element Kategoria contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element PRODUCT_TYPE contains an invalid separator | Element PRODUCT_TYPE contains an invalid separator | | The feed contains the element PRODUCT_TYPE multiple times | The feed contains the element PRODUCT_TYPE multiple times The element PRODUCT_TYPE may only appear once in your feed. Check its occurrences. | | Element PRODUCT_TYPE contains redundant separators | Element PRODUCT_TYPE contains redundant separators The element PRODUCT_TYPE contains redundant category separators, probably at the end. Remove them. | | Element PRODUCT_TYPE contains only one value | Element PRODUCT_TYPE contains only one value Element PRODUCT_TYPE contains only one category, which is not allowed by the search engine. Add more categories. | | Element PRODUCT_TYPE contains an invalid value or is too short | Element PRODUCT_TYPE contains an invalid value or is too short Element PRODUCT_TYPE contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element G:PRODUCT_TYPE contains an invalid separator | Element G:PRODUCT_TYPE contains an invalid separator | | The feed contains the element G:PRODUCT_TYPE multiple times | The feed contains the element G:PRODUCT_TYPE multiple times The element G:PRODUCT_TYPE may only appear once in your feed. Check its occurrences. | | Element G:PRODUCT_TYPE contains redundant separators | Element G:PRODUCT_TYPE contains redundant separators The element G:PRODUCT_TYPE contains redundant category separators, probably at the end. Remove them. | | Element G:PRODUCT_TYPE contains only one value | Element G:PRODUCT_TYPE contains only one value Element G:PRODUCT_TYPE contains only one category, which is not allowed by the search engine. Add more categories. | | Element G:PRODUCT_TYPE contains an invalid value or is too short | Element G:PRODUCT_TYPE contains an invalid value or is too short Element G:PRODUCT_TYPE contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element G:PRODUCT_TYPE contains an invalid separator | Element G:PRODUCT_TYPE contains an invalid separator | | The feed contains the element G:PRODUCT_TYPE multiple times | The feed contains the element G:PRODUCT_TYPE multiple times The element G:PRODUCT_TYPE may only appear once in your feed. Check its occurrences. | | Element G:PRODUCT_TYPE contains redundant separators | Element G:PRODUCT_TYPE contains redundant separators The element G:PRODUCT_TYPE contains redundant category separators, probably at the end. Remove them. | | Element G:PRODUCT_TYPE contains only one value | Element G:PRODUCT_TYPE contains only one value Element G:PRODUCT_TYPE contains only one category, which is not allowed by the search engine. Add more categories. | | Element G:PRODUCT_TYPE contains an invalid value or is too short | Element G:PRODUCT_TYPE contains an invalid value or is too short Element G:PRODUCT_TYPE contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element google_product_category contains an invalid separator | Element google_product_category contains an invalid separator | | The feed contains the element google_product_category multiple times | The feed contains the element google_product_category multiple times The element google_product_category may only appear once in your feed. Check its occurrences. | | Element google_product_category contains redundant separators | Element google_product_category contains redundant separators The element google_product_category contains redundant category separators, probably at the end. Remove them. | | Element google_product_category contains only one value | Element google_product_category contains only one value Element google_product_category contains only one category, which is not allowed by the search engine. Add more categories. | | Element google_product_category contains an invalid value or is too short | Element google_product_category contains an invalid value or is too short Element google_product_category contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element product_type contains an invalid separator | Element product_type contains an invalid separator | | The feed contains the element product_type multiple times | The feed contains the element product_type multiple times The element product_type may only appear once in your feed. Check its occurrences. | | Element product_type contains redundant separators | Element product_type contains redundant separators The element product_type contains redundant category separators, probably at the end. Remove them. | | Element product_type contains only one value | Element product_type contains only one value Element product_type contains only one category, which is not allowed by the search engine. Add more categories. | | Element product_type contains an invalid value or is too short | Element product_type contains an invalid value or is too short Element product_type contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element google_product_category contains an invalid separator | Element google_product_category contains an invalid separator | | The feed contains the element google_product_category multiple times | The feed contains the element google_product_category multiple times The element google_product_category may only appear once in your feed. Check its occurrences. | | Element google_product_category contains redundant separators | Element google_product_category contains redundant separators The element google_product_category contains redundant category separators, probably at the end. Remove them. | | Element google_product_category contains only one value | Element google_product_category contains only one value Element google_product_category contains only one category, which is not allowed by the search engine. Add more categories. | | Element google_product_category contains an invalid value or is too short | Element google_product_category contains an invalid value or is too short Element google_product_category contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element product_type contains an invalid separator | Element product_type contains an invalid separator | | The feed contains the element product_type multiple times | The feed contains the element product_type multiple times The element product_type may only appear once in your feed. Check its occurrences. | | Element product_type contains redundant separators | Element product_type contains redundant separators The element product_type contains redundant category separators, probably at the end. Remove them. | | Element product_type contains only one value | Element product_type contains only one value Element product_type contains only one category, which is not allowed by the search engine. Add more categories. | | Element product_type contains an invalid value or is too short | Element product_type contains an invalid value or is too short Element product_type contains information about the category the product is assigned to by the seller. Check that it uses a valid taxonomy and contains enough categories. | | Element CATEGORYTEXT contains an invalid separator | Element CATEGORYTEXT contains an invalid separator | | Element CATEGORYTEXT appears more than once | Element CATEGORYTEXT appears more than once | | Element CATEGORYTEXT contains redundant separators | Element CATEGORYTEXT contains redundant separators | | Element CATEGORYTEXT contains only one value | Element CATEGORYTEXT contains only one value | | Element CATEGORYTEXT contains an invalid value or is too short | Element CATEGORYTEXT contains an invalid value or is too short | | Element PRODUCT does not contain the value of element PRODUCTNAME | Element PRODUCT does not contain the value of element PRODUCTNAME The PRODUCT element should contain the product name including attributes, such as "free gift", "+ case", etc. On Heureka, it will be displayed in the price comparison. | | Element G:TITLE does not contain text | Element G:TITLE does not contain text Element g:title represents the exact product name. A name usually contains at least some letters. If a product is named, for example, "48", it is likely that neither customers nor search engines can tell what it is.

How to fix this error?

If there are few such products, you can fix them manually. For a larger number, use a Find and Replace rule or an Overwrite rule.| | Element PRODUCT does not contain any letter | Element PRODUCT does not contain any letter PRODUCT represents the extended product name. A name usually contains at least some letters. If a product is named, for example, "48", it is likely that neither customers nor search engines can tell what it is.

How to fix this error?

If there are few such products, you can fix them manually. For a larger number, use a Find and Replace rule or an Overwrite rule.| | Element PRODUCTNAME does not contain any letter | Element PRODUCTNAME does not contain any letter PRODUCTNAME represents the exact product name. A name usually contains at least some letters. If a product is named, for example, "48", it is likely that neither customers nor search engines can tell what it is.

How to fix this error?

If there are few such products, you can fix them manually. For a larger number, use a Find and Replace rule or an Overwrite rule.| | Element TITLE does not contain text | Element TITLE does not contain text The TITLE element must be a text description of the name and manufacturer of your product. Check that it actually contains this information. | | Element actionFlagActive contains a disallowed value | Element actionFlagActive contains a disallowed value The actionFlagActive element should contain 0 or 1. | | Element ACTIVE contains a disallowed value | Element ACTIVE contains a disallowed value The ACTIVE element should contain true or false. | | Element ADULT contains a disallowed value | Element ADULT contains a disallowed value The ADULT element should contain 0 or 1. | | Element adult contains a disallowed value | Element adult contains a disallowed value The adult element should contain 0 or 1. | | Element ALLOWS_IPLATBA contains a disallowed value | Element ALLOWS_IPLATBA contains a disallowed value The ALLOWS_IPLATBA element should contain 0 or 1. | --- ## [Changing user details in your Mergado account](https://help.mergado.com/en/account-management-and-billing/user-account/changing-user-details/) # **Changing user details in your Mergado account** Got a new email or phone number, want invoices sent directly to your accountant, became a VAT payer and need to add a tax ID to your billing details, or changed your company name or address? You can easily and quickly make all these changes yourself directly in your Mergado account. We'll walk you through step by step what and where you can change or update in your account. ## **Changing your name, surname, and phone number** 1. On the **[Main page](https://accounts.mergado.com/)** (Dashboard) of your Mergado account, go to the **[User and billing details](https://accounts.mergado.com/settings/)** section. 2. Edit your name, surname, and phone number **in the corresponding fields**. 3. After making your changes, don't forget to click **Save settings** at the bottom of the page. ## **Changing your email** 1. On the **[Main page](https://accounts.mergado.com/)** (Dashboard) of your Mergado account, go to the **[Security](https://accounts.mergado.com/security/)** section. 2. In the **Change email** section, enter the new email you want to use with Mergado Editor (e.g. for receiving invoices or notifications from Mergado Editor or its extensions). 3. Confirm the email change by clicking **Submit email change request** — the change takes effect immediately. ## **Changing your password** 1. On the **[Main page](https://accounts.mergado.com/)** (Dashboard) of your Mergado account, go to the **[Security](https://accounts.mergado.com/security/)** section. 2. In the **Change password** section, fill in all the fields. 3. Confirm by clicking **Change password** — the new password is set immediately. ## **Changing billing details** 1. On the **[Main page](https://accounts.mergado.com/)** (Dashboard) of your Mergado account, go to the **[User and billing details](https://accounts.mergado.com/settings/)** section. 2. In the **Billing details** section, update or fill in the billing-related information (company name, billing email, company ID, tax ID, address, currency, or order number). 3. After making your changes, don't forget to click **Save settings** at the bottom of the page. > **Tip!** In the billing details section, there's a **Billing email** field where you can add any number of email addresses to **receive invoices** (e.g. your accountant, associates, business partners). If you leave this field empty, invoices will be sent to the email in the User details section. ## **Changing the billing period** 1. If you want to change the **billing period** (e.g. from monthly to annual for a 20% discount), go to the **[Payment settings](https://accounts.mergado.com/payment_options/)** section on the **[Main page](https://accounts.mergado.com/)** (Dashboard) of your Mergado account. 2. In the **Billing period** section, select **1 month** (for monthly billing) or **12 months** (for annual billing). 3. After making your changes, don't forget to click **Save settings** at the bottom of the page. > **Tip!** Always make billing period changes **at the end of the currently selected billing period**. All billing-related changes take effect **on the next invoice**. If you need to change details on an already issued document, please contact technical support at **mergado@mergado.com**. For more details about Mergado billing and its extensions, see this article. If you're in Mergado Editor, you can access user or billing detail changes by clicking the arrow icon in the top right corner of the page (next to your username), then clicking Account settings, which takes you to the [User and billing details](https://accounts.mergado.com/settings/) section. ## **FAQ** ### **How do I change my user details in my Mergado account?** You can easily change your details like name, password, email, or billing information in your Mergado account settings. On the [Main page](https://accounts.mergado.com/) (Dashboard), go to [User and billing details](https://accounts.mergado.com/settings/), [Payment settings](https://accounts.mergado.com/payment_options/), or [Security](https://accounts.mergado.com/security/). ### **How do I change my name, surname, or phone number in my Mergado account?** 1. On the main page (Dashboard) of your account, go to the User and billing details section. 2. Edit your name, surname, or phone number in the corresponding fields. 3. Don't forget to click Save settings at the bottom of the page. ### **How do I change the email associated with my Mergado account?** 1. On the main page (Dashboard) of your Mergado account, go to the Security section. 2. In the Change email section, enter the new email address (used for receiving invoices or notifications). 3. Click Submit email change request — the change takes effect immediately. ### **How do I change my Mergado account password?** 1. On the main page (Dashboard) of your Mergado account, go to the Security section. 2. In the Change password section, fill in all the fields. 3. Click Change password — the new password is set immediately. ### **How do I access account settings from within Mergado Editor?** Click the arrow icon in the top right corner of the page (next to your username). Then select Account settings — you'll be redirected to the User and billing details section. ### **How do I change my billing details in my Mergado account?** On the Main page (Dashboard), go to the User and billing details section. In the Billing details section, you can update or add: company name, billing email, company ID, tax ID, address, currency, order number. After making changes, click Save settings at the bottom. Changes take effect on the next invoice. ### **Can I redirect invoices directly to my accountant?** Yes. In the User and billing details section, there's a Billing email field where you can enter any number of email addresses to receive invoices automatically. So invoices can go directly to your accountant, business partners, or associates. ### **How do I change the billing period?** On the Main page (Dashboard), go to the Payment settings section. In the Billing period section, choose: * 1 month — monthly billing * 12 months — annual billing (with a 20% discount) Don't forget to click Save settings. Make billing period changes at the end of the currently selected billing period. The change takes effect on the next invoice. ### **What if I need to change details on an already issued invoice?** In this case, contact our support at **mergado@mergado.com**. --- ## [Creating and deleting a Mergado account via Google](https://help.mergado.com/en/account-management-and-billing/user-account/creating-and-deleting-account-via-google/) # **Creating and deleting a Mergado account via Google** This guide walks you through **creating (or signing in to) a Mergado account using the *Sign in with Google* button**, and also shows how to **disconnect** the Google integration. Signing in via Google is fast — no registration form needed. Disconnecting, on the other hand, is not done in Mergado but in your Google account settings. ## **Step-by-step guide** ### **A) Creating a new account / signing in to Mergado via Google** 1. On the Mergado login page, click **Sign in with Google**. 2. Enter your standard **Google account credentials** (email/name and password). 3. After successful login, you'll be automatically redirected to Mergado's **Dashboard**, where you can navigate to wherever you need. > Creating/signing in via Google is simple and fast. ### **B) How to disconnect your Google account from Mergado** > Note: disconnecting is **not done in Mergado** but **in your Google account settings**. 1. Open your **Google account** and go to the **Security** tab. 2. On the right side, you'll find a list of **apps and services** your Google account is connected to. * If not all apps are showing, click **See all connections**. 3. Find **Mergado** in the list and click the **arrow** on the right side. 4. You'll see details about the connection between your Google account and Mergado, including the option to **delete all connections** with the Mergado service. 5. Deleting the connection **disconnects Google from Mergado** — this also **deletes your Mergado account**. ## **Tips** * If you don't see Mergado in the list of connected services, use the **See all connections** option. * When signing in via Google, have your **email/name** credentials and **password** for the Google account ready. * Remember that **disconnecting is handled exclusively in your Google account** — no additional steps are needed in Mergado. ## **FAQ** ### **Can I create a Mergado account via Google?** Yes. Click **Sign in with Google**, sign in to your Google account, and you'll be redirected to Mergado's **Dashboard**. ### **What exactly do I enter when signing in via Google?** Standard Google account credentials: **email/name and password**. ### **Where do I end up in Mergado after signing in?** After successful login, you'll be redirected to the **Dashboard** and continue from there as needed. ### **How do I disconnect my Google account from Mergado?** In your **Google account**, on the **Security** tab, open the list of connected apps, find **Mergado**, click the arrow, and choose **delete connection**. ### **I don't see Mergado in connected apps. What should I do?** Click **See all connections** and search again. ### **What happens after deleting the connection in Google account?** The connection is terminated, which also **deletes your Mergado account**. ### **Do I need to do anything in Mergado to delete the account?** No. Disconnecting and account deletion are handled **in the Google account settings**. --- ## [Changing the plan for your online store](https://help.mergado.com/en/account-management-and-billing/plans-and-billing/changing-the-plan-for-your-eshop/) # **Changing the plan for your online store** If you want to change the plan for your online store, you should know that **you can't do it manually**. The plan level is **automatically determined by Mergado based on the number of products in your output feeds**. In other words, Mergado looks at how many projects (integrations) you have within a given online store and how many products are in the output of each project. It **adds up all output products and determines the plan type based on the total count**. If you have **multiple online stores, Mergado calculates the plan separately for each one**. Each online store will therefore be billed separately on your invoice. ## **FAQ** ### **How do I find out what plan I currently have?** You can easily check your current plan directly in Mergado. 1. On the **[main page](https://app.mergado.com/)** of Mergado, click the **online store** whose plan you want to check. 2. On the last row in the **Products** column, you'll see the **total number of output products** that determines your plan. 3. Click the **"i"** icon on the black bar. Here you'll see your **current plan** along with other information — the product limit for this plan and how much of it you're using, your billing period, and when your plan is prepaid until. You can also see plan information for all your online stores on the **User details** page. Go there by clicking the arrow icon in the top right corner of the page (next to your username) and clicking User details. ### **How do I change my online store's plan?** You **can't change the plan yourself**. The plan level is **automatically determined by Mergado based on the number of products in all output feeds** of the given online store. ### **I want to add products or create another project for my online store. How do I find out which plan I'll be on?** You can easily check the plan level in the **[Pricing](https://www.mergado.cz/cenik)** section on our website. 1. In the left green field, choose whether you want to see the price for **monthly or annual billing**. 2. In the right green field, choose whether to display **prices in CZK or EUR**. 3. Enter the **number of products** in your online store. 4. Enter the **number of integrations** (projects) for this online store. 5. See which plan your online store will fall into. ### **How do I know if my plan has increased?** When you exceed your currently prepaid plan, you'll receive an **email notification**. If based on this notification you make changes in the online store that bring it back to the original lower plan (e.g. delete a project or reduce the product count), we won't bill you for this short-term increase. If you don't make changes, we'll send you an invoice for the plan increase soon. ### **What if I'm reducing the product count or deleting projects? How do I lower the plan?** If you remove enough products or projects from your online store that it falls into a lower plan than the current one, you don't need to do anything or notify us. **Mergado automatically detects the product count decrease and lowers your plan.** ### **How are differences billed during plan changes?** Mergado billing works as a **subscription**. The price difference from a plan increase is therefore billed using a **differential invoice**. * If your plan **decreases** during the current prepaid period, this price change takes effect **in the next billing period**. * If your plan **increases** during the current prepaid period, this price change takes effect **in the current billing period** and the increase is billed via a **differential invoice**. More information about billing during plan changes can be found in this article. ### **How is the product count calculated for determining the final price?** The total product count for billing is calculated by **adding up products in all output feeds (projects) within the selected billed online store**. **For example:** You own an online store with three projects. One for Heureka with 2,000 products in the output feed. A second for Zboží.cz, also with 2,000 products in the output feed. A third for Google Merchants with 1,500 products in the output feed. That means: 2,000 + 2,000 + 1,500 = 5,500 products, which falls under the Basic plan with a limit of 10,000 products. ### **I have multiple online stores. Can I combine all feeds and get a plan based on the total?** No. Mergado calculates the plan **independently for each online store**. Even foreign language versions (e.g. .sk/.de/.pl) are counted as separate online stores, because in Mergado's context, an online store is defined by the input feed domain. ### **How are plans determined for Mergado extensions?** Individual **Mergado extensions have fixed prices**, which you can find in our [Pricing](https://www.mergado.cz/cenik) or the [Mergado Store](https://store.mergado.com/). The price is fixed and not affected by the number of output products. --- ## [Changing Billing Frequency for Mergado Extensions](https://help.mergado.com/en/account-management-and-billing/plans-and-billing/changing-billing-frequency/) # **Changing the billing frequency for Mergado and its extensions** If you're dealing with billing for Mergado and its extensions, you're in the right place. This article helps you understand how to set up billing properly and what options you have for managing payments. With our guide, it's easy and stress-free. ## **How to get started with billing setup?** Setting up billing in Mergado is straightforward and you can customize it to your needs. To get started, just **log in to your account**. In the **User and billing details** section, you can change your billing information, and in the **Payment settings** section, you choose the payment frequency — payments are made by **direct debit from your credit card**. ### **Step by step** 1. On the **[Main page](https://accounts.mergado.com/)** of your account, go to the **[User and billing details](https://accounts.mergado.com/settings/)** section. Fill in your billing information here. 2. Go to the **[Payment settings](https://accounts.mergado.com/payment_options/)** section and choose the **payment gateway** (Stripe or GoPay) through which you want your **credit card to be charged**. 3. In the same section, choose the **payment frequency** (Billing period): * **1 month** — billing occurs once a month * **12 months** — billing occurs once a year When you change the payment frequency, the changes **take effect on newly issued invoices**. ## **Who can change billing and manage billing details?** Billing in Mergado can only be managed by the **user with the Owner role**. This user has full access to all financial and billing matters of the online store. ### **Owner's billing permissions** * **Invoice responsibility:** The Owner is responsible for billing details used when issuing an invoice. Invoices are **always sent to the Owner's email**, or to the email(s) of the person or entity entered in the **Billing email** field in the **[User and billing details](https://accounts.mergado.com/settings/)** section. * **Setting billing frequency:** The Owner can change the payment frequency (e.g. to annual for a discount). This change is made in the **[Payment settings](https://accounts.mergado.com/payment_options/)** section. * **Managing billing details:** The Owner has access to edit billing details in the **[User and billing details](https://accounts.mergado.com/settings/)** section. * **Viewing invoices:** Only account Owners can find and download invoices. They have access to the **Invoices** section in their account. * **Recurring payment:** The Owner can set up or cancel recurring payments (direct debit) in the **User and billing details** section of their account. ### **Transferring Owner permissions** If **billing needs to be transferred to another user or entity**, you can change the Owner role. This change is made for a specific online store in the **Settings** section, on the **User permissions** tab. The transfer takes effect when the new Owner accepts ownership in their account. The new Owner will start receiving invoices and will have access to the Invoices section, while the previous owner automatically gets the Write permission. ### **Permission levels in Mergado** Mergado has three permission levels: **1. Owner:** Billing for selected services is charged to this user/entity. Has full access to editing billing details and payment frequency. Can add/remove permissions for other users or entities for their online store. Can edit online store content. **2. Write:** Can edit online store content but doesn't have access to billing details and invoices. Cannot add or remove user permissions for the online store and can only see themselves and the owner. **3. Read:** Has access to view the online store but cannot make any changes. ## **What are the benefits of annual billing?** If you set up annual payment frequency, you get a significant **financial discount**: * **20% discount on the Mergado plan.** * **20% discount on add-on extensions from the Mergado Store.** This discount applies to both new and existing customers. If you switch from monthly to annual billing, the discount **takes effect at the next billing after the current prepaid period expires**. ## **What are the billing options for add-on extensions?** It's important to know that **billing for the Mergado plan and add-on extensions is linked**. This means **add-on extensions are billed at the same frequency as the Mergado plan**. If you choose annual billing for the Mergado plan, your extensions will also be billed annually. ## **How to switch back to monthly billing?** If you want to switch back to monthly billing, just change the payment frequency in settings (see How to get started with billing setup). However, you'll lose the 20% discount on the plan and extensions. **The change takes effect after the current prepaid period expires.** ## **When is technical support needed?** In some cases, you need to contact technical support: * **Editing already issued invoices** – If you need to change billing details or period on a proforma invoice, write to technical support. * **Requesting overpayment transfer to the next billing period** – If you don't want an overpayment to be automatically refunded but want to use it for the next billing period. If you have any billing issues, we're happy to help. Contact us at **mergado@mergado.com**. ## **FAQ** ### **Can I change the billing frequency at any time?** You can change the billing frequency at the end of the currently selected billing period. ### **How do I change details on an issued invoice?** If you need to change details on an already issued invoice, contact our technical support at mergado@mergado.com. ### **What happens if I don't pay an invoice?** If you don't pay an invoice, Mergado temporarily disables all services you use, including extensions. Simply pay the outstanding amount and contact technical support to reactivate. ### **How do I start setting up billing in Mergado?** Just log in to your Mergado account and go to the Payment settings section, where you can choose a payment gateway and payment frequency. In the User and billing details section, fill in your billing information. ### **Who can change billing details?** Billing can only be managed by the user with the Owner role, who has full access to billing details and all account-related matters. ### **What are the benefits of annual billing?** If you choose annual billing, you get: * 20% discount on the Mergado plan. * 20% discount on add-on extensions from the Mergado Store. ### **How do I change the billing frequency?** To change the billing frequency, go to the Payment settings section in your account settings. ### **What happens if I don't pay an invoice?** If you don't pay an invoice, Mergado temporarily disables all services you use, including extensions. After paying the outstanding amount, contact technical support for reactivation. ### **How do I get a discount on add-on extensions?** If you set up annual billing, you get a 20% discount on all add-on extensions from the Mergado Store. ### **When do I need to contact technical support?** Contact technical support (mergado@mergado.com) in these cases: * Editing already issued invoices (e.g. changing details on a proforma invoice). * Requesting overpayment transfer to the next billing period: If you don't want an overpayment to be automatically refunded but want to use it for the next billing period. * Requesting a different payment method than direct debit. * Requesting billing termination and thus paid Mergado Editor services. ### **Is it possible to pay by other methods than direct debit?** If direct debit doesn't work for you, contact support at the email mergado@mergado.com and we'll try to find a payment method that suits you better. ### **How can I cancel billing and stop using Mergado?** To terminate paid Mergado Editor services, please contact support at the email mergado@mergado.com. --- ## [How differential invoicing works in Mergado](https://help.mergado.com/en/account-management-and-billing/plans-and-billing/how-differential-invoicing-works/) # **How differential invoicing works in Mergado** **Differential invoices** are issued due to **automatic plan adjustments and price differences** that arise when the number of products in your feed changes, when new online stores are created, or when extensions are activated. ## **Automatic plan changes** Billing in Mergado is based on **automatic plan adjustments according to the number of products in your output feeds**. If the product count changes and reaches a different plan tier, **the system automatically adjusts the billing**. This is how price differences between the old and new plan are reflected on your invoice. ### **How it works** **1. Plan change:** * If the number of items in your feed increases and reaches a **more expensive plan**, Mergado automatically switches to the higher tier. * If the product count decreases and the online store falls into a **lower plan**, the plan is automatically adjusted in Mergado. However, **if a payment has already been charged**, or a proforma or differential invoice has already been issued with the higher plan, you need to **contact technical support at mergado@mergado.com** to adjust the document. **2. Billing the change:** * If your plan **decreases** during the current prepaid period, this price change takes effect **in the next billing period**. * If your plan **increases** during the current prepaid period, this price change takes effect **in the current billing period** and the increase is billed via a **differential invoice**. **3. Plan increase:** * When the product count rises and the online store falls into a more expensive plan, the increase applies **automatically from the day the change occurred**. **4. Plan decrease:** * If the product count drops and the online store falls into a lower plan, the plan is **automatically adjusted and the lower price will be billed from the next billing period**. However, if a payment has already been charged, or a proforma or differential invoice has already been issued with the higher plan, you need to **contact technical support at mergado@mergado.com** to adjust the document. ## **Other differences and overpayments** If there's an overpayment (e.g. you pay more than required), Mergado will **automatically refund it**. If you'd like to **use the extra payment to cover the next billing period, contact technical support at mergado@mergado.com**. If you **change the billing frequency** (e.g. switching from monthly to annual for a 20% discount), this change takes effect **on newly issued invoices** after the current prepaid period expires. If you need to **change billing details on an already issued proforma invoice or tax document**, you must contact **technical support at mergado@mergado.com**. ## **Conclusion** Mergado automatically adjusts plans, and price differences between old and new plans are reflected in issued invoices. If there's an overpayment or plan change, the system handles the billing adjustment — and you can contact technical support for manual interventions when needed. ## **FAQ** ### **What is a differential invoice in Mergado?** A differential invoice accounts for automatic plan adjustments and reflects price differences between old and new plans, as well as price increases from creating new online stores or activating extensions. ### **How does plan changing work in Mergado?** Billing in Mergado automatically adjusts to changes in the number of products in your feed. If the product count increases or decreases, the system automatically switches to a higher or lower plan tier. ### **When does a plan change appear on the invoice?** When a plan change occurs, the price difference between the old and new plan is reflected on the next issued invoice. This change is made together with the next billing. ### **How does a plan increase work?** If the product count increases and the online store falls into a more expensive plan, the increase applies automatically from the day the change occurred. ### **What if I need to lower the plan?** If the product count decreases and the online store falls into a lower plan, the plan is automatically adjusted in Mergado. However, if a proforma or differential invoice has already been issued with the higher plan, you need to contact technical support to adjust the document. ### **What happens if I pay more than required (overpayment)?** If you pay more than required, Mergado will automatically refund the overpayment. If you'd like to use the extra payment to cover the next billing period, contact technical support (mergado@mergado.com). ### **Can I change billing details on an already issued proforma invoice or tax document?** If you need to change billing details on an already issued proforma invoice, you must contact technical support. ### **What happens when I change the billing frequency?** If you change the billing frequency (e.g. switching from monthly to annual for a 20% discount), the change takes effect on newly issued invoices after the current prepaid period expires. --- ## [How to cancel an invoice in Mergado](https://help.mergado.com/en/account-management-and-billing/plans-and-billing/how-to-cancel-an-invoice/) # **How to cancel an invoice in Mergado** In Mergado, you can't cancel an invoice directly in the user admin panel — you need to **contact technical support**. This process applies when you want to **cancel or modify already issued invoices**. The following guide shows you how to proceed with invoice cancellation and what steps to take. ## **When do you need to contact technical support?** ### **1. Change or cancellation of a proforma invoice and tax document** If you've received a proforma invoice or tax document and need to make a change (such as billing details or billing period) or cancel it, you must contact technical support (mergado@mergado.com). * **Reason:** Changes made in account settings only apply to newly issued invoices. If you need to modify an already issued proforma invoice, support will make the necessary changes for you. ### **2. Overpayment refund** If there was an **overpayment or duplicate payment, it will be automatically refunded**. If you'd like to **use the extra payment to cover the next billing period** instead, you need to contact technical support (mergado@mergado.com). ## **Billing contact** Direct all invoice and document inquiries to the email address of our technical support: **mergado@mergado.com**. ## **Viewing cancelled documents** It's important to know that cancelled documents are **not displayed in the Invoices section of your user account**. If an invoice was cancelled, it will no longer appear in the document list. ## **Conclusion** If you need to cancel an invoice or make any other change to already issued documents, don't forget to reach out to technical support. We'll be happy to help with adjustments, whether it's cancelling a proforma invoice, transferring an overpayment to the next billing period, or any other issue. For any questions, don't hesitate to contact us at mergado@mergado.com. ## **FAQ** ### **Can I cancel an invoice directly in the admin panel?** No, invoice cancellation can't be done directly in the admin panel. To cancel or modify an already issued invoice, you need to contact technical support (mergado@mergado.com). ### **When do I need to contact technical support?** Contact technical support in the following cases: 1. If you need to change or cancel a proforma invoice or tax document, e.g. change billing details or period. 2. If you have an overpayment and want to have it applied to the next billing period instead of an automatic refund. ### **How do I request an overpayment refund?** If you have an overpayment or extra payment, it will be automatically refunded. If you'd like to use the extra payment to cover the next billing period, contact technical support. ### **Where can I find a cancelled invoice?** Cancelled invoices are not displayed in the Invoices section of your account. After cancellation, the invoice will no longer appear in the document list. ### **How can I contact support for billing questions?** Direct all invoice and document inquiries to the email mergado@mergado.com. --- ## [How to change billing details](https://help.mergado.com/en/account-management-and-billing/plans-and-billing/how-to-change-billing-details/) # **How to change billing details** If you need to update billing details in your Mergado account, you have several options depending on whether you want to change details for future invoices or on already issued documents. This guide walks you through the entire process so you can handle it quickly and easily. ## **1. Changing billing details for future invoices (Admin panel)** If you want to update billing details for future invoices (e.g. change the company ID, tax ID, company name, or billing frequency), you can do it directly in your account settings. ### **How to do it** * **Editing billing details** – Change your billing details (such as contact information) in the **[User and billing details](https://accounts.mergado.com/settings/)** section of your account settings. * **Changing billing frequency** – If you want to change the billing period (e.g. switch from monthly to annual billing for a discount), adjust this in the **[Payment settings](https://accounts.mergado.com/payment_options/)** section of your account settings. Changes only apply to **newly issued invoices**. This means that already issued invoices will not be affected by these changes. ## **2. Changing details on an already issued invoice (Technical support)** If you need to modify billing details or billing period on an already issued proforma invoice or tax document, you can't make these changes yourself. In this case, you need to contact technical support. ### **How to do it** 1. Send an email to **mergado@mergado.com**, specifying what exactly you want to change on the issued invoice. 2. Technical support will help you and make the changes for you. ## **Conclusion** You can easily handle billing detail changes for future invoices yourself in your account settings. For changes on already issued invoices, you need to contact technical support. ## **FAQ** ### **How do I change billing details for future invoices?** Change your billing details for future invoices directly in the billing details settings of your account. You can update contact information, company ID, tax ID, or change the billing frequency (monthly/annual). ### **How do I change the billing frequency (monthly/annual)?** To change the billing frequency, go to the Payment settings section in your account. ### **When do billing detail changes take effect?** Billing detail changes only apply to newly issued invoices. Already issued invoices will not be affected by these changes. ### **How do I change details on an already issued invoice?** If you need to modify billing details on an already issued proforma invoice or tax document, contact technical support at mergado@mergado.com and specify the changes you need. ### **Can I change details on already issued invoices myself?** No, for changes on already issued invoices you need to contact technical support. --- ## [Changing permissions for an online store](https://help.mergado.com/en/account-management-and-billing/ownership-and-permissions/changing-permissions-for-eshop/) # **Changing permissions for an online store** Do you have an online store in Mergado but need someone else to **make changes in it** (e.g. an employee or agency)? Or are you a freelancer or agency managing an online store for a client who also wants access? Maybe they don't want to edit anything but just wants to occasionally check how the feeds look? Does your manager or business partner want to see what's happening in the online store while making sure they don't accidentally change any settings? All these situations can be resolved by **giving other users access to the online store in whatever form works best for you and them**. You simply grant them one of the available **Permissions**. The only requirement is that these people or entities have their **own Mergado accounts**, which are **free**. ## **What types of permissions are available in Mergado** Mergado has **three permission levels** that give you **different levels of control over individual online stores**: **1. Owner** * Billing for selected services is **charged to this user/entity** for the specific online store. Has full **access to editing billing details**, payment frequency, and invoices. * Can **add/remove permissions** (Write/Read) for other users or entities for the online store. * Can transfer the **Owner role to another user**. (At that point, they automatically receive the Write role and lose the permissions listed above.) * Can **edit online store content**. * **Each online store can have only one Owner.** **2. Write** * Can **edit content of the online store** for which the Owner has granted them Write access. * **Doesn't have** access to **billing details and invoices**. * **Cannot add or remove user permissions** for the online store and can only see themselves and the owner. * **Any number of users with Write permission** can be added to a single online store. **3. Read** * Has access to **view the online store** but cannot make any changes. * **Any number of users with Read permission** can be added to a single online store. ## **How to add or remove permissions for other users (Write/Read)** When you **create an online store in your account, you automatically become its Owner**. Invoices for the services you use will come to you, you can edit billing details, and you have all the permissions listed above. If you want to **give other people access to a selected online store**, first make sure they have their **own Mergado account**. 1. In Mergado, click the **arrow icon** in the top right corner of the page (next to your username) and go to the **User details** page. 2. Here you'll find the **list of your online stores**. Click the **three-person icon** next to the selected online store, which will take you to the **User permissions** section. 3. On the right side of the page, in the **Invite user** section, enter the **email of the user** you want to grant permission to. Below that, select the **permission you want to grant** (Write/Read) and click **Send invitation**. 4. The user will receive the **invitation by email**. They are **redirected to their Mergado account** via the link in the email and receive the permission once they accept the **invitation in Mergado**. If they don't accept, they won't get the permission. 5. On this page (**User permissions**), you'll also see a **list of all users** you've granted permissions to for the selected online store. You can change their permissions by clicking the **pencil icon** or remove them by clicking the **trash icon**. Similarly, other users can grant you permissions to their online stores. You can see a list of all online stores you have any type of permission for in the **User details** section of your Mergado account. ## **How to change the online store Owner** You become an online store Owner by creating an online store in your account. Or by having another user transfer this permission to you and you accepting it. As the Owner, **billing for selected services is charged** to you for the specific online store. You have **full access to editing billing details, payment frequency, and all invoices**. You can **add or remove permissions** (Write/Read) for other users or entities, and you can **edit online store content**. If you decide to **transfer online store Ownership to another user or entity**, the process is similar to granting Write or Read permissions. The difference is that **each online store can have only one Owner**. The transfer process works as follows: you grant the Owner permission to another user. This user receives an email invitation. They are redirected to their Mergado account via the link in the email, where they must accept the invitation. At that point, you **lose the Owner permission** (and all associated privileges) and are automatically granted **Write permission** for the online store (you can edit online store content but paid services for this online store are no longer billed to you). ### **How to transfer the online store Owner** Make sure the user you want to transfer the Owner permission to already has a **Mergado account**. 1. In Mergado, click the **arrow icon** in the top right corner of the page (next to your username) and go to the **User details** page. 2. Here you'll find the **list of your online stores**. Click the **three-person icon** next to the selected online store, which will take you to the **User permissions** section. 3. On the right side of the page, in the **Invite user** section, enter the **email of the user** you want to grant the permission to. Below that, select the **Owner permission** and click **Send invitation**. 4. The user receives the **invitation by email** and is redirected to their **Mergado account**. They receive the permission once they accept the **invitation**. If they don't accept, they won't get the permission. 5. After accepting the invitation, the **user becomes the online store Owner**. Your permission automatically changes to **Write**. From this point, paid services for this online store are billed to the **new Owner**, and you no longer have access to their billing details and invoices. ## **How to use permissions when working in Mergado** **You might want to grant or have *Write* permission for these reasons:** * I'm the owner and Owner of the online store, I pay Mergado invoices, but **an employee or external agency/freelancer manages my advertising** — I grant them Write permission. * I'm the owner of the online store, but **its management (including billing) is handled by an external agency**, yet I still want to be able to edit the online store. The agency has the Owner permission and I keep Write. * I'm not the owner or Owner of the online store (and thus don't pay Mergado invoices), but I'm an **employee or external agency/freelancer managing the client's feeds**. I have Write permission. **You might want to grant or have *Read* permission for these reasons:** * I'm the owner of the online store, but an external agency **fully handles its management (editing and billing)**. I want to see what's happening in the online store but don't want to make any changes, or want to avoid accidentally editing something. The agency has the Owner permission, **I have Read**. * I'm the owner of the online store, but my **business partner or associate** wants to be able to see what's happening — they get Read permission. **You might want to grant or have *Owner* permission for these reasons:** * I'm the owner of the online store and want **full control including billing, feed editing, and granting Write or Read permissions to other users**. Even if an employee or external agency/freelancer manages my feeds — I grant them Write in that case. * I'm an **external agency or freelancer billing my client for complete online store management including the Mergado fee**. I'm the Owner of the online store and grant the client Write or Read permission as needed. ## **How to find out who has permissions to my online store** You can find information about who has permissions to the **online store you own** on the **User permissions** page. Navigate there as follows: 1. In Mergado, click the **arrow icon** in the top right corner of the page (next to your username) and go to the **User details** page. 2. On the **User details** page, you'll see a **list of online stores you own**. Click the **three-person icon** next to the selected online store to go to the **User permissions** page. 3. Here you'll see a **list of all users** who have been granted Write or Read permission for this online store. 4. You can change their permissions by clicking the **pencil icon** or remove them by clicking the **trash icon**. ## **How to find out what permissions I have to other online stores** Information about **which online stores you have permissions for** is on the **User details** page. Go there by clicking the arrow icon in the top right corner of the page (next to your username) in Mergado and going to User details. This page serves as a **clear dashboard** where you can find important information about your account, online stores, extensions, and billing. You'll see a list of online stores **you own**, as well as a list of online stores where you've been **granted Write or Read permission**. ## **FAQ** ### **What types of permissions exist in Mergado?** Mergado has three permission levels: Owner, Write, and Read. The Owner has full control over the online store and billing, Write allows editing online store content without access to billing or permission management, and Read is view-only without the ability to make changes. ### **How can I grant access to other users for my online store?** You can add permissions to an online store only if you're the Owner. Here's how: 1. In Mergado, click the arrow icon in the top right corner of the page (next to your username) and go to the User details page. 2. Here you'll find the list of your online stores. Click the three-person icon next to the selected online store, which will take you to the User permissions section. 3. In the Invite user section, enter the email of the user you want to grant access to (this user must have their own Mergado account). 4. Select the permission type (Write/Read) and click Send invitation. 5. The user will receive the invitation by email. They are redirected to their Mergado account via the link in the email and receive the permission once they accept it. If they don't accept, they won't get the permission. On the same page (User permissions), you can see a list of all users with access to the online store, where you can change or remove their permissions. ### **How do I change the online store Owner?** 1. Make sure the user or entity you want to transfer ownership to has a Mergado account. 2. In Mergado, click the arrow icon in the top right corner of the page (next to your username) and go to the User details page. 3. Here you'll find the list of your online stores. Click the three-person icon next to the selected online store, which will take you to the User permissions section. 4. In the Invite user section, enter the user's or entity's email and select Owner as the permission. 5. Click Send invitation. 6. Once the user or entity accepts the invitation, they become the new Owner. Your permission automatically changes to Write. ### **How do I find out who has permissions to my online store?** You can find this information on the User permissions page. Go there by clicking the arrow icon in the top right corner in your account, then navigating to User details. You'll see a list of online stores you own. Click the three-person icon next to the selected online store to go to the User permissions page. There you'll see a list of all users with Write or Read access to the online store. You can change or remove their permissions at any time. ### **Does everyone I want to give access to need their own Mergado account?** Yes, each user must have their own Mergado account. Registration is free. ### **How many users can have access to an online store?** The number of users with Write or Read permission is unlimited. The only restriction is the Owner role — there can always be only one. ### **Can I change or remove permissions I've granted to a user?** If you're the online store Owner, yes. In the User permissions section, you can change the permission type (e.g. from Read to Write) or revoke access entirely at any time. If you have Write permission for an online store, you cannot add or remove permissions for other users, even if you were previously the Owner of that online store. ### **Can someone else grant me access to their online store?** Yes, the Owner of another online store can grant you access. The requirement is that you're a registered Mergado user. When the Owner grants you permission, you'll receive an email invitation, and via the link you'll be redirected to your account where you accept. All online stores you have access to will be visible in the User details section. ### **How do I accept a permission that an online store Owner granted me?** If an online store Owner grants you a permission (Write, Read, or Owner), you'll receive an email invitation from Mergado. Via the link in the email, you'll go to your Mergado account where you confirm the invitation and the permission becomes active. If you don't confirm the invitation, you won't get access to the online store. After accepting, you'll see the online store in your project overview and on the User details page. ### **Can multiple people manage a single online store in Mergado?** Yes. Each online store can have one Owner, whose billing details are used for invoicing. Additionally, an unlimited number of users with Write or Read permissions can access the online store, granted (or revoked) by the Owner. Other users manage or view the online store from their own accounts. ### **When should I grant Write permission?** When you want someone else to be able to edit online store content (e.g. an employee, external agency, or freelancer) but don't want to give them access to billing. Write permission is also ideal when you're the owner and want to edit the online store but don't want to deal with billing, which someone else handles. ### **When is Read permission appropriate?** When you want someone to have view-only access to the online store without being able to change anything. Useful for business partners, managers, or owners who want an overview but want to avoid accidental edits. ### **When do I need Owner permission?** When you want full control over the online store, including billing, payment settings, and access management. Owner permission is also used when, for example, an agency fully manages the online store and their client billing includes the Mergado fees. --- ## [Changing the Online Store Owner](https://help.mergado.com/en/account-management-and-billing/ownership-and-permissions/changing-the-eshop-owner/) # **Changing the online store Owner** Are you in a situation where you want to **transfer your online store management (including billing) to an agency**? Or are you an **agency handing the online store back to your client**? Have you sold an online store and need to transfer it to the new owner? You can handle all these changes easily by yourself — simply **change the permissions** and transfer your Owner role to another user or entity (e.g. an agency). We'll walk you through the process step by step. But first, let's start with the basics and explain what types of permissions are available in Mergado. ## **Permission levels in Mergado** Mergado has **three permission levels** that give you **different levels of control over individual online stores**: **1. Owner** * Billing for selected services is **charged to this user/entity** for the specific online store. Has **full access to editing** billing details, payment frequency, and invoices. * Can **add/remove permissions** (Write/Read) for other users or entities for the online store. * Can transfer the **Owner role to another user**. (At that point, they automatically receive the Write role and lose the permissions listed above.) * Can **edit online store content**. * **Each online store can have only one Owner.** **2. Write** * Can **edit content of the online store** for which the Owner has granted them Write access. * **Doesn't have** access to **billing details and invoices**. * **Cannot add or remove user permissions** for the online store and can only see themselves and the owner. * **Any number of users with Write permission** can be added to a single online store. **3. Read** * Has access to **view the online store** but cannot make any changes. * **Any number of users with Read permission** can be added to a single online store. ## **How to add permissions for other users (Write/Read)** When you **create an online store in your account, you automatically become its Owner**. Invoices for the services you use will come to you, you can edit billing details, and you have all the permissions listed above. If you want to **give other people access to a selected online store**, first make sure they have their **own Mergado account** (the user account itself is free). 1. In Mergado, click the **arrow icon** in the top right corner of the page (next to your username) and go to the **User details** page. 2. Here you'll find the **list of your online stores**. Click the **three-person icon** next to the selected online store, which will take you to the **User permissions** section. 3. On the right side of the page, in the **Invite user** section, enter the **email of the user** you want to grant permission to. Below that, select the **permission you want to grant** (Write/Read) and click **Send invitation**. 4. The user will receive the **invitation by email** and gets the permission once they **accept it**. If they don't accept, they won't get the permission. 5. On this page, you'll also see a **list of all users** you've granted permissions to for the selected online store. You can change their permissions by clicking the **pencil icon** or remove them by clicking the **trash icon**. **List of all online stores you have any type of permission for** is visible in the **User details** section of your Mergado account — other users can grant you permissions to their online stores the same way. ## **How to change the online store Owner** You become an online store Owner by **creating an online store in your account**. Or by having **another user transfer this permission to you** and you accepting it. As the Owner, **billing for selected services is charged** to you for the specific online store. You have **full access to editing billing details, payment frequency, and all invoices**. You can **add or remove permissions** (Write/Read) for other users or entities, and you can **edit online store content**. If you decide to **transfer online store Ownership to another user or entity**, the process is similar to granting Write or Read permissions. The difference is that **each online store can have only one Owner**. The transfer process works as follows: you grant the Owner permission to another user. This user must then **accept the invitation in their own account**. At that point, you **lose the Owner permission** (and all associated privileges) and are automatically granted **Write permission** for the online store (you can edit online store content but paid services for this online store are no longer billed to you). ### **How to transfer the online store Owner** Make sure the **user** you want to transfer the Owner permission to already has a **Mergado account**. 1. In Mergado, click the **arrow icon** in the top right corner of the page (next to your username) and go to the **User details** page. 2. Here you'll find the **list of your online stores**. Click the **three-person icon** next to the selected online store, which will take you to the **User permissions** section. 3. On the right side of the page, in the **Invite user** section, enter the **email of the user** you want to grant the permission to. Below that, select the **Owner permission** and click **Send invitation**. 4. After the user accepts the **invitation in their account, they become the online store Owner**. Your permission automatically changes to **Write**. From this point, paid services for this online store are billed to the **new Owner**, and you no longer have access to invoices or billing detail changes. ## **FAQ** ### **What types of permissions exist in Mergado?** Mergado has three types of online store permissions. * Owner — has full access to online store modifications, including billing, payment settings, and managing permissions for other users. Can transfer ownership to another user. Each online store can have only one owner. * Write — can edit online store content but doesn't have access to billing or user management. * Read — has view-only access to the online store, without the ability to make changes. ### **How can I add permissions for other users?** You can add permissions to an online store only if you're the Owner. Here's how: 1. In Mergado, click the arrow icon in the top right corner of the page (next to your username) and go to the User details page. 2. Here you'll find the list of your online stores. Click the three-person icon next to the selected online store, which will take you to the User permissions section. 3. In the Invite user section, enter the email of the user you want to grant access to (this user must have their own Mergado account). 4. Select the permission type (Write/Read) and click Send invitation. 5. The user will receive the invitation by email and gets the permission once they accept it. If they don't accept, they won't get the permission. On the same page, you can see a list of all users with access to the online store, where you can change or remove their permissions. ### **How do I change the online store Owner?** 1. Make sure the user or entity you want to transfer ownership to has a Mergado account. 2. In Mergado, click the arrow icon in the top right corner of the page (next to your username) and go to the User details page. 3. Here you'll find the list of your online stores. Click the three-person icon next to the selected online store, which will take you to the User permissions section. 4. In the Invite user section, enter the user's or entity's email and select Owner as the permission. 5. Click Send invitation. 6. Once the user or entity accepts the invitation, they become the new Owner. Your permission automatically changes to Write. ### **What happens after transferring online store Ownership?** The new Owner is billed for all services associated with the online store. The previous Owner automatically receives the Write role (can manage content but not billing). The previous Owner loses access to invoices and billing details. ### **How can I transfer online store management to an agency or client?** Transfer online store management (including billing) by changing permissions — transfer your Owner role to another user or entity (e.g. an agency). ### **What should I do if I sell my online store and need to transfer it to the new owner?** Simply grant the new owner the Owner permission. Once they accept the invitation, they become the online store Owner and you automatically receive the Write role, which the new Owner can revoke. --- ## [What is the Mergado Marketplaces extension?](https://help.mergado.com/en/mergado-marketplaces/what-is-mergado-marketplaces-extension/) # **What is the Mergado Marketplaces extension?** Mergado Marketplaces is an extension within the Mergado ecosystem that lets you automatically list and manage thousands of products on the Allegro and Kaufland Global Marketplace online marketplaces. The extension pairs products with the marketplace catalog, lists unique ones, and ensures stock levels and prices are always up to date. Thanks to regular synchronization, it only offers products that are actually in stock, preventing order cancellations and unhappy customers. Users of Shopify, WooCommerce, Shoptet Premium, Upgates, UNAS e-shop platforms and the POHODA accounting system can also conveniently manage orders directly in the admin panel of the system they use. The extension also makes it significantly easier to comply with GPSR regulatory requirements, keeping your offers visible at all times. ## **Pricing and billing** Extension pricing: * 286 CZK per month with monthly billing, * 228.80 CZK per month with annual billing. The price is set per e-shop (in Mergado) and is fixed, regardless of the number of products, orders, or marketplace connections. Due to technical dependencies, the extension is billed in line with the billing frequency you've chosen in Mergado Editor. You can't choose different billing frequencies for individual services. {{% hint info %}} Mergado Marketplaces has a 30-day free trial period. {{% /hint %}} ## **Key terms for the Mergado Marketplaces extension** - **Marketplace** — An online platform that aggregates products from other shops and e-shops in one place (e.g. Allegro, Kaufland). - **API connection** — An API connection enables efficient communication between Mergado and the marketplace, meaning regular and frequent data synchronization. The main advantage of an API marketplace connection is the frequency of availability updates. - **E-shop (in Mergado)** — A grouping of one or more projects belonging to a single e-shop domain (e.g. My-shop.com). - **Project** — After uploading an input feed into Mergado Editor, a project is created. All data modifications are done within the project (e.g. using selections, rules, and automations). - **Selection** — A group of products meeting a specified condition (e.g. from all products, filtering those with a price above 500 CZK). - **Product feed** — A structured data file containing elements with product information (name, category, selling price, etc.). - **Availability feed** — A data file containing information about product stock availability. The Mergado Marketplaces extension accepts availability feeds in Heureka or Mall format or in the Mergado Marketplaces format. - **Campaign** — In Mergado Marketplaces, you create campaigns that load data from the product feed and create offers on the marketplace. The advantage is the ability to set up different campaign configurations — e.g. if you have different shipping rates for small and large products, you create two campaigns with different rate tables. - **Default sales channel** — The Allegro market where you registered your business account. If you later decide to sell on other markets, offers on the default sales channel must remain active. You can't have offers inactive on the default sales channel while selling on another market. For example, if you registered your business account on allegro.cz, your default sales channel is Czech. - **Element** — A basic feed component carrying data (e.g. PRICE, PARAM, etc.). - **Nested element** — An element is nested if it's located between the opening and closing tags of another element in the XML feed. The most common example is PARAM_NAME and PARAM_VAL elements nested within a PARAM element. - **Element value** — An element carries data, which we refer to as the element's value (e.g. the value of element `99` is 99). - **Product** — Data in the input feed is divided into individual items containing data about that item. We call this item a product. - **Offer** — After uploading the product feed into Mergado Marketplaces, products become offers on the marketplace. On the marketplace, each product has one product card to which different sellers' offers can be linked. Offers differ in price and purchase terms, but basic product information on the product card, such as EAN code, manufacturer, or brand, is identical. - **Offer status** — Mergado Marketplaces receives offer statuses from the marketplace every 15 minutes (e.g. active, incomplete, with error). - **Marketplace catalog** — A product catalog where each unique product has one product card to which sellers can link their offers. - **Product card** — A card in the marketplace catalog containing all required and fixed product parameters. Offers are linked to the product card based on the product identifier. - **Product feed synchronization** — Synchronization of all data between the product feed and marketplace. During automatic feed regeneration in Mergado Editor, only changed products are synchronized. - **Regeneration** — Regeneration updates data in the project including the output feed. It consists of three processes: import, rule application, and export. - **Validation** — The validation section contains error messages explaining any issues that occurred when uploading product data to the marketplace. - **Sales documents** — These are return policies, complaint policies, and shipping rates that must be filled in on Allegro's admin before you can start selling. ## **What you need to launch Mergado Marketplaces** * ✅ A verified business account on the selected marketplace (Allegro or Kaufland) * ✅ An active Mergado Editor account * ✅ A product feed in Mergado Editor with EAN codes (from the GS1 database) * ✅ An [availability feed](https://help.mergado.com/en/mergado-marketplaces/availability-feed/) in Heureka/Mall format or a [product feed in Mergado Marketplaces format](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/) ## **Key features** ### **1. Automatic listing and product pairing** Mergado Marketplaces allows you to: * automatically and in real time list thousands of items on [Kaufland](https://help.mergado.com/en/mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/) and [Allegro](https://help.mergado.com/en/mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/) marketplaces, * pair items with the existing marketplace catalog, * [create brand new product cards](https://help.mergado.com/en/mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/) for products not yet in the catalog, * [add required parameters](https://help.mergado.com/en/mergado-marketplaces/completing-allegro-product-cards/) to existing incomplete Allegro product cards. {{% hint warning %}} Mergado Marketplaces currently supports listing a maximum of 200,000 products per campaign and 800,000 products per extension. For higher product counts, contact our customer support at mergado@mergado.com. {{% /hint %}} ### **2. Fast stock synchronization** Product availability is updated every 15 minutes. Sold-out items are automatically hidden from the listing and reactivated when restocked, so you always sell only what's actually in stock. {{% hint info %}} For availability synchronization, you need to connect an [availability feed](https://help.mergado.com/en/mergado-marketplaces/availability-feed/) in Heureka/Mall format or a [product feed in Mergado Marketplaces format](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/) to Mergado Marketplaces. {{% /hint %}} ### **3. Regular product data updates** All product data is automatically updated after every feed regeneration in Mergado Editor. ### **4. Order synchronization with your e-shop platform** In Mergado Marketplaces, you can activate [order synchronization](https://help.mergado.com/en/mergado-marketplaces/order-management-in-mergado-marketplaces/). Orders from Allegro and Kaufland are then automatically transferred to your e-shop platform every 5 minutes, letting you manage marketplace orders directly in your e-shop. Currently available for [Shopify](https://help.mergado.com/en/mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/), [WooCommerce](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/), [UNAS](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-unas-with-mergado-marketplaces/), [Upgates](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-upgates-with-mergado-marketplaces/) and [Shoptet Premium](https://help.mergado.com/en/mergado-marketplaces/importing-orders-into-shoptet-premium/). Order connections to e-shop platforms are created by entering the appropriate API key either in the Mergado Keychain extension (Shopify, UNAS) or directly in Mergado Marketplaces (WooCommerce, Shoptet Premium). ### **5. Order export in CSV or XML order feed** You can easily transfer marketplace orders to the [POHODA accounting system](https://help.mergado.com/en/mergado-marketplaces/importing-orders-into-pohoda-system/) using a prepared XML order feed, or export orders to a CSV file and work with them as needed. ### **6. GPSR regulation compliance** Mergado Marketplaces makes it easier to [add required information](https://help.mergado.com/en/mergado-marketplaces/gpsr-on-allegro-and-kaufland/) about the manufacturer, responsible person, or safety instructions. This keeps your offers visible and prevents Allegro or Kaufland from hiding them. ## **Notifications and validation messages** You can set up what [types of notifications you want to receive](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-notification-settings/) directly in Mergado Marketplaces. The extension also displays [validation messages](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-validation-messages/) that alert you to errors or inconsistencies in the submitted data. --- ## [Mergado Marketplaces feed format](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/) ## **What is the Mergado Marketplaces feed format?** This article explains the Mergado Marketplaces feed format, its advantages, and how it simplifies working with product and availability data for marketplace platforms. The Mergado Marketplaces feed format is based on the Mergado XML format. It's designed for users who want to use the Mergado Marketplaces extension but aren't sure which feed format is suitable for this add-on. Beyond simplifying the decision during project creation in Mergado Editor, this format also offers benefits like faster initial Mergado Marketplaces setup and the ability to synchronize availability through this feed format. ## **What is this feed format for?** When using Mergado Marketplaces, two types of data are needed: * Product data * Availability data {{% hint info %}} Most sellers have an availability feed available directly from their e-shop platform. Not sure where to find this feed in your e-shop platform? In the article [here](https://help.mergado.com/en/mergado-marketplaces/availability-feed/) you'll learn where to get the availability feed in Shoptet, Upgates, Eshop-rychle, WooCommerce, and FASTCentrik 💡 {{% /hint %}} If you don't have an availability feed available, don't worry. You can easily solve this with Mergado Editor ✅ 1. The first option is to create a new project in Mergado Editor purely for availability. Choose `Mall or Heureka availability feed` as the output format and use it in Mergado Marketplaces. A detailed guide can be found [here](https://help.mergado.com/en/mergado-marketplaces/availability-feed/). 2. However, if you have availability (stock count in numeric format) and product data in a single feed, you can create a project in Mergado Editor and choose `Mergado Marketplaces` as the output format. This way, a single feed is enough for synchronizing both product data and availability. ![image](/images-mergado-marketplaces/mergado-marketplaces-feed-format/01.png) ## **Advantages and disadvantages of the Mergado Marketplaces feed format** **Advantages:** - You only need a single feed in Mergado Editor containing both product and availability data. - Faster campaign creation in Mergado Marketplaces. For this format, our campaign creation wizard pre-fills elements and you don't need to enter an availability feed. ![image](/images-mergado-marketplaces/mergado-marketplaces-feed-format/02.png) **Disadvantages:** - Although Mergado Marketplaces synchronizes availability every 15 minutes, the data in your Mergado Marketplaces feed updates according to how often the feed is regenerated in Mergado Editor. For the most up-to-date availability, the best solution is still to get the availability feed directly from your e-shop platform. --- ## [Availability feed](https://help.mergado.com/en/mergado-marketplaces/availability-feed/) ## **Availability feed** This article explains what an availability feed is, what formats are supported, how to find or create one, and how to use it in Mergado Marketplaces. ## **What is an availability feed?** An availability feed is a file containing up-to-date information about product stock levels and availability in your e-shop. ## **What a proper availability feed should look like** A proper availability feed should contain these key pieces of information: - Product identifier - Stock count {{% hint info %}} The format may vary depending on the platform the feed is intended for (e.g. Heureka vs. Mall). {{% /hint %}} ## **Heureka availability feed** The Heureka availability feed should have the following structure: ```xml 13 2011-09-11 13:00 2 2011-09-11 18:00 ``` ## **Mall availability feed** The Mall availability feed has a similar structure: ```xml 1 5 true ``` Key elements are: - **`item id/ID`**: This element represents an individual product in the availability feed, where the **`id`** attribute serves as a unique product identifier that MUST EXACTLY MATCH the product ID in the product feed — otherwise availability can't be properly paired. - **`stock_quantity/IN_STOCK`**: This element contains a numerical value of the current stock count for the given product. ## **How to get an availability feed** 1. Check whether your e-shop platform automatically generates an availability feed. 2. If not, you can create one manually using tools like Mergado Editor. {{% hint info %}} You can also use the `Mergado Marketplaces` feed format, which works as both a product and availability feed. This means you don't need two separate feeds in Mergado Editor — one is enough 💡 More information [here](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/). {{% /hint %}} ## **Where to find the availability feed in your e-shop** ## **Shoptet** 1. In your Shoptet admin, go to Integrations → Heureka. 2. Select "XML feeds". 4. Find the "Availability XML feed" section. 5. Copy the generated feed URL. 6. Use this URL as the availability feed in Mergado Marketplaces or other services. ℹ️ **More information can be found on the Shoptet website [here](https://podpora.shoptet.cz/heureka-xml-feedy/).** ![image](/images-mergado-marketplaces/availability-feed/01.png) ## **UPgates** - To access the Heureka availability feed, you need to **activate** the **Heureka** add-on (the add-on is free). - In your e-shop, open the "**Add-ons**" section and search for "**Heureka**". - Click "**Activate**" on the Heureka add-on. - Go to the "**Add-ons > Heureka**" section. - In this section, you'll find the "**Availability feed**" area. - Here you'll find the generated URL of your availability feed. - Copy this URL. - Use this URL as the availability feed in Mergado Marketplaces or other services. ℹ️ **More information can be found on the UPgates website [here](https://www.upgates.cz/a/export-produktu-na-heureku).** ![image](/images-mergado-marketplaces/availability-feed/02.png) ![image](/images-mergado-marketplaces/availability-feed/03.png) {{% hint info %}} ⚠️ The first screenshot shows a test e-shop. The availability export on your actual e-shop will provide a URL. {{% /hint %}} ## **Eshop-rychle** - The availability feed is generated automatically and can be found in E-shop → Export → Product export. - In the "**Portal**" section, select "**heureka.cz availability**". - Generate the feed. - Copy the generated feed URL. - Use this URL as the availability feed in Mergado Marketplaces or other services. ℹ️ **More information can be found on the Eshop-rychle website [here](https://helpdesk.eshop-rychle.cz/docs/export-import/export-do-porovnavacu-zbozi/).** ![image](/images-mergado-marketplaces/availability-feed/04.png) ## **WooCommerce** - While WooCommerce doesn't natively support creating availability feeds for Heureka or Mall, plugins like [Toret](https://toret.cz/produkt/xml-feedy-pro-porovnavace-zbozi/ref/68/) or [WPify Woo Feedy](https://wpify.io/dokumentace/wpify-woo-feedy/#kontakt) can help. ## **FASTCentrik** You can easily generate the availability feed in the "XML feeds" section. ## **Availability feed security** {{% hint info %}} ⚠️ When generating a feed from your e-shop, pay attention to access settings. Some e-shops may automatically lock feeds, so it's important to check and set them as publicly accessible. {{% /hint %}} If you encounter the error message "*An error occurred while downloading the availability feed, make sure the file is accessible*" in Mergado Marketplaces, your availability feed is likely secured and the application can't access it. If your e-shop runs on Shoptet, you can find instructions on how to adjust your availability feed security settings **[here](https://www.mergado.cz/zabezpeceni-shoptet-feedu)**. ## How to create an availability feed in Mergado Editor If your e-shop platform doesn't offer an availability feed, you have two options for solving this with Mergado Editor: * If your product feed contains availability in numeric format, choose `Mergado Marketplaces` as the output format when creating a project in Mergado Editor. This lets you use the feed in Mergado Marketplaces for both product data and availability synchronization. More information [here](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/). ![image](/images-mergado-marketplaces/availability-feed/05.png) ![image](/images-mergado-marketplaces/availability-feed/06.png) * If your product feed doesn't contain availability, you can create an availability feed in Mall or Heureka format as a separate project and use an input feed with availability data (even a Google Sheets spreadsheet works). 1. Prepare your feed — it must contain a product identifier and stock count. {{% hint info %}} ⚠️ The product identifier MUST EXACTLY MATCH the product ID in your existing product feed — otherwise availability can't be properly paired. {{% /hint %}} 2. Log in to Mergado Editor and click "New project". ![image](/images-mergado-marketplaces/availability-feed/07.png) 3. Enter the URL of your input feed. Mergado Editor supports these formats: XML, JSON, CSV, or Google Sheets. ![image](/images-mergado-marketplaces/availability-feed/08.png) 4. Wait for the initial feed analysis to complete and select your e-shop. 5. After analysis, the Editor pre-selects the correct format based on the feed content. However, you're not bound to the pre-selected format. ![image](/images-mergado-marketplaces/availability-feed/09.png) 7. If Mergado couldn't recognize the input feed format, you can define your own format. If you know what format it is, select it from the input format options. ![image](/images-mergado-marketplaces/availability-feed/10.png) 8. On the output format page, select either Heureka availability or MALL marketplace availability feed. ![image](/images-mergado-marketplaces/availability-feed/11.png) 9. In the summary, you can review all the details you've entered. ![image](/images-mergado-marketplaces/availability-feed/12.png) 10. If you see a "Pairing elements error" message, click the "Edit" button (on the right) and add the product ID as a pairing element. ![image](/images-mergado-marketplaces/availability-feed/13.png) 11. Click the "Finish" button. ## How to properly use the availability feed in Mergado Marketplaces 1. In Mergado Marketplaces, create a new campaign. 2. During campaign setup, you'll reach the step for adding an availability feed. 3. Enter the URL of your availability feed. The availability feed must meet these conditions for successful product pairing: * The URL must be a Heureka or Mall availability feed, or a feed in Mergado Marketplaces format. * The availability feed must contain the same product IDs as the product feed. * The availability feed must be accessible to the application. 4. Get your availability feed either from your e-shop (as described in the examples above) or through Mergado Editor. In Mergado Editor, you can find your availability feed in the "Overview" section, where you'll find the "Copy URL to clipboard" option. 5. Enter this URL into the text field. 5. If you use any URL other than an XML format, or if the URL is incomplete (in the example image, the XML extension is missing), you'll see an "Invalid URL" or "An error occurred" message and the campaign creation process won't let you continue. In this case, make sure the URL is complete, in XML format, and is a Heureka or Mall availability feed, or a Mergado Marketplaces format feed. 6. If some product IDs don't match or are missing from the availability feed, clicking "Next step" will show a notification about the number of missing product IDs. This warning won't prevent you from continuing with campaign creation, and all other products will be paired correctly. If only a few products are affected, they're likely sold-out items and it's not an error. If the notification shows that the number of missing products equals the total number of products in your product feed, the availability feed doesn't contain any correct IDs and no products will be uploaded to the marketplace. Check that you're uploading the correct availability feed with the right product IDs matching your product feed. 7. If the availability feed is correct, finish creating the campaign. After successfully creating and synchronizing the campaign, you'll see which products uploaded correctly. 8. All products that weren't uploaded due to availability feed issues can be found in the campaign detail → Validation, where you'll see a list titled "The offer is missing availability, check that the availability feed has the correct format and that 'Product ID' matches in both the product and availability feeds". {{% hint info %}} If only a few products are affected, they're likely sold-out products and it's not an error. When restocked, the offer will be activated (provided a product card exists on the marketplace for that product). {{% /hint %}}

--- ## [Order management in Mergado Marketplaces](https://help.mergado.com/en/mergado-marketplaces/order-management-in-mergado-marketplaces/) # Order management in Mergado Marketplaces In Mergado Marketplaces, you can activate order downloading, giving you all marketplace orders in one place 🎉 You can also connect orders to: * [Upgates](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-upgates-with-mergado-marketplaces/) * [Shopify](https://help.mergado.com/en/mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/) * [UNAS](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-unas-with-mergado-marketplaces/) * [POHODA accounting system](https://help.mergado.com/en/mergado-marketplaces/importing-orders-into-pohoda-system/) * [WooCommerce](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/) * [Shoptet Premium](https://help.mergado.com/en/mergado-marketplaces/importing-orders-into-shoptet-premium/) {{% hint info %}} If you encounter errors or have ideas for expanding this functionality, don't hesitate to contact us at [mergado@mergado.cz](mailto:mergado@mergado.cz). {{% /hint %}} ## **Activation** To start downloading orders, you first need to activate this feature in the "Activation" section. Select the desired platforms and save your changes: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/01.png) {{% hint info %}} ⚠️ **To activate orders, you must have an active connection to the desired platform in the 'Connections' section.** {{% /hint %}} ## **History** In the history section, you'll find information about order activation/deactivation and synchronization progress: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/02.png) Additional data also contains information about the number of new orders, status changes, and order data changes: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/03.png) ## **Order overview** The order overview shows the most important information about your orders: * Marketplace logo * Market of purchase * Order ID + link to order detail on the marketplace via the icon ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/icon-link.png) * Order creation date * Customer name * Order items * Total order price * Fulfillment * FBM (Fulfillment by Merchant) * FBK (Fulfillment by Kaufland) * One Fulfillment by Allegro * Order status (open, not shipped, shipped, suspended, returned, cancelled, unknown) * Synchronization status {{% hint info %}} Orders are synchronized every 5 minutes. {{% /hint %}} ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/04.png) Clicking on an order opens the order detail: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/05.png) {{% hint info %}} If you've added an internal note to an order on Allegro or Kaufland, it will also appear in our extension. However, once you add or edit a note through Mergado Marketplaces, the internal note will stop synchronizing with the marketplace. {{% /hint %}} ## **Notifications** In the notifications section, you can set up alerts for new orders. You can configure which days and times you want to receive notifications and choose whether to be notified via Mergado messages or email: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/06.png) ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/07.png) Email notifications redirect you to the order detail on Allegro/Kaufland when you click the order ID, or you can view new orders in Mergado Marketplaces: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/08.png) ## **Order export** When exporting orders, you can choose which orders to include in the CSV: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/09.png) You can also choose which data to include in the CSV and optionally set custom column names: ![image](/images-mergado-marketplaces/order-management-in-mergado-marketplaces/10.png) --- ## [Mergado Marketplaces notification settings](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-notification-settings/) ## Mergado Marketplaces notification settings This article walks you through configuring email and Mergado message notifications in Mergado Marketplaces, covering general settings, error alerts, and order notifications. **How to set up notifications in Mergado Marketplaces? Let's walk through it step by step.** You can configure notifications in the main menu under the "Notifications" section. Here you can activate alerts for selected issues via email and Mergado messages. With notification settings, you decide what issues and campaigns you want to be informed about. {{% hint info %}} ℹ️ **You can also deactivate notification delivery at any time in this section.** {{% /hint %}} After opening the notification settings section, you'll notice 3 main sections: * General settings * Error alerts * Order management ## 1. General settings It's up to you how you want to be informed about potential issues. If you choose Mergado messages, notifications will appear in the top right corner of Mergado: ![image](/images-mergado-marketplaces/mergado-marketplaces-notification-settings/01.png) If you want to receive notifications by email, just activate this option and enter the email address where you want emails sent. Use the "Add email" button to add more email address fields. ![image](/images-mergado-marketplaces/mergado-marketplaces-notification-settings/02.png) An alert email might look like this: ![image](/images-mergado-marketplaces/mergado-marketplaces-notification-settings/03.png) ## 2. Error alerts It's also important to choose what issues you want to be informed about. You currently have these options: * **Connection errors** — if there's a problem with the Kaufland or Allegro connection, you'll be notified through your chosen communication channel. * **Order synchronization errors** * **Availability feed errors** — your availability feed may become unavailable for some reason, preventing availability updates on the marketplace. * **Failed feed synchronization** — alert about an error during product feed synchronization. * **Active offer drop** — alert about a significant drop in active offers for any campaign. For availability feed error alerts, a window will appear showing an overview of your campaigns, letting you choose which campaigns you want to be alerted about: ![image](/images-mergado-marketplaces/mergado-marketplaces-notification-settings/04.png) ## 3. Order management In the notifications section, you can also set up alerts for new orders. You can configure which days and times you want to receive notifications and choose whether to be notified via Mergado messages or email: ![image](/images-mergado-marketplaces/mergado-marketplaces-notification-settings/05.png) ![image](/images-mergado-marketplaces/mergado-marketplaces-notification-settings/06.png) Email notifications redirect you to the order detail on Allegro/Kaufland when you click the order ID, or you can view new orders in Mergado Marketplaces. {{% hint info %}} And don't forget to save your changes by clicking the blue "Save changes" button in the top right corner 💡 {{% /hint %}} --- ## [Mergado Marketplaces validation messages](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-validation-messages/) ## Mergado Marketplaces validation messages This article explains the most common validation messages: #### **No product card was found in the Allegro catalog under this product identifier. To create one, go to the 'Product cards' section`** * These products don't exist in the Allegro product catalog yet, so you need to create a product card for them in the "Product cards" section. A detailed guide can be found [here](https://help.mergado.com/en/mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/). #### **No product card was found in the Kaufland catalog under this EAN code. To create one, go to the 'Product cards' section** * These products don't exist in the Kaufland product catalog yet, so you need to create a product card for them in the "Product cards" section. A detailed guide can be found [here](https://help.mergado.com/en/mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/). #### **'Manufacturer data' with the name '...' does not exist** * You don't have a manufacturer card with this 'custom name' prepared on Allegro. You can check manufacturer cards and their custom names [here](https://salescenter.allegro.com/responsible-producers). The custom name must match exactly for the card to be paired with the offer. ![image](/images-mergado-marketplaces/mergado-marketplaces-validation-messages/01.png) ![image](/images-mergado-marketplaces/mergado-marketplaces-validation-messages/02.png) #### **Invalid value "..." was entered for the "Brand" parameter / Invalid value "..." was entered for the "Manufacturer" parameter** * Allegro recently made a change where you can no longer use the value "other" for the brand/manufacturer parameter and enter your own brand/manufacturer if it's not in the allowed values list. You now need to apply on Allegro to add a new value to the list of allowed brands/manufacturers, and only after Allegro approval can the product card be listed. You can apply for adding a new value [here](https://salescenter.allegro.com/parameter-value-suggestions/create-suggestion). {{% hint info %}} Allowed values for the brand/manufacturer parameter differ across categories. If you want to list products of a given brand/manufacturer in multiple categories, you need to fill out the Allegro form for all required categories. {{% /hint %}} #### **You cannot list offers with protected brand products due to missing confirmation of brand protection terms** * You must first confirm the brand protection terms on Allegro [here](https://salescenter.allegro.com/brands-to-protect?bi-s=art). Learn more in [this article](https://help.allegro.com/cs/sell/a/jak-se-starame-o-ochranu-znacek-na-allegru-q08bykna8fE) from Allegro. #### **Offer not found, it was probably deleted from your assortment on Allegro** * This occurs when a user either deleted the offer from Allegro themselves, or the offer was ended on Allegro for more than 60 days (while remaining in the Mergado Marketplaces campaign the whole time). Once an offer is ended for more than 60 days, Allegro archives it automatically, and our app still has the old Allegro offer ID stored and tries to connect to it. * 💡 We've already improved this process — when we receive this message from Allegro, the offer gets a "not synchronized" tag and a new offer is created on Allegro during the next regeneration. * If you still see this message in Mergado Marketplaces, just run a manual product feed synchronization in the campaign settings and wait for the next automatic feed synchronization. #### **The offer is missing availability, check that the availability feed has the correct format and that 'Product ID' matches in both the product and availability feeds** * With this message, it's possible that the given Product ID has no value in the availability feed, or the product is completely missing from the availability feed. If this message appears for all products, **check the availability feed format ([Heureka](https://sluzby.heureka.cz/napoveda/dostupnostni-feed/) and [Mall](https://knowledgebase.mallgroup.com/marketplace-mall-xml-feed/3/)) and whether 'Product ID' matches in both the product and availability feeds**. To troubleshoot: 1. Go to the validation section and click on this validation message. 2. Offers missing availability will be displayed. Copy the 'Product ID' of one of the products. 3. Go to campaign settings, copy the availability feed link at the bottom, and open it. 4. Use CTRL + F to search for the copied 'Product ID' and check whether availability exists in the feed. 5. Check whether you've mapped the correct element from your product feed to 'Product ID' in the campaign settings. If you need to change the mapping, open the elements section in the campaign settings, change the mapping, save changes, and click "Synchronize product feed". 6. If availability for the product doesn't exist in the availability feed, check whether these might be sold-out products. Such products shouldn't be listed on the marketplace anyway, so this error message is harmless. #### **The Allegro product card is missing required parameters, add them via 'Product card completion' in the 'Product cards' section** * The Allegro product card is missing required parameters. This message is not about your data, but about the data of the user who created the product card on Allegro, to which we're now trying to link your offer. You can add these parameters in the product cards section under "Product card completion". More information [here](https://help.mergado.com/en/mergado-marketplaces/completing-allegro-product-cards/). #### Allegro could not find an exact matching product * You should only encounter this error message in exceptional cases, which appears when multiple product cards with the same identifier exist in the Allegro product catalog. Our app evaluates the state of product cards on Allegro and assigns the offer to the best-filled one. However, if none of the product cards are valid, the offer won't be assigned to any and this message appears in validation. #### **An error occurred on Allegro's side: the product card in Allegro doesn't contain any image, so the offer couldn't be paired with the product card** * Our app now sends product images to Allegro, but only as offer images. If an Allegro product card is incomplete and missing parameters or images, our app can't add this data to the product card. However, you can try adding images manually directly in Allegro's listing form. Go to "List using form" on Allegro, search for the product's EAN, select the found product card, and click "REPORT INCORRECT PRODUCT INFORMATION". You can then add the missing images and submit the suggestion to Allegro. #### **The [shipping_group] parameter is not specified or has an incorrect value** * This error message informs you that your shipping groups are not correctly filled in on the Kaufland Seller Portal. Go to 'Settings' > '[Shipping settings](https://sellerportal.kaufland.de/shipping-groups)' in the Seller Portal and check/add a shipping group. The app automatically assigns your default shipping group to offers. {{% hint info %}} ℹ️ **If your validation message wasn't in the list or you still need help, don't hesitate to contact us.** {{% /hint %}} --- ## [How to create a campaign and upload products to Allegro](https://help.mergado.com/en/mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/) ## **How to create a campaign and upload products to Allegro** This step-by-step guide walks you through creating a campaign in Mergado Marketplaces and uploading your products to the Allegro marketplace. {{% hint info %}} First, you need to activate the [Mergado Marketplaces app in **Mergado Store**](https://store.mergado.com/detail/ordelogyproducts/#about). Before you begin, make sure you have: ✅ A verified business account on Allegro ✅ A product feed in Mergado Editor with EAN codes ✅ A Heureka/Mall availability feed or Mergado Marketplaces product feed {{% /hint %}} {{% hint info %}} 💡 Not sure which output feed format is best? The Mergado Marketplaces extension accepts all formats offered by Mergado Editor. However, a new option is the **Mergado Marketplaces feed format**, which you can use to synchronize both product data and availability. More information [here](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/). {{% /hint %}} In this article, we will show you how to create a campaign and upload products to Allegro. Before we start, make sure you have a **verified business account** on Allegro, and that you have **filled in the shipping price list, complaint terms, and return terms**. A detailed guide on registering a business account on Allegro can be found [here](https://help.allegro.com/sell/cs/c/registrace-uctu-allegro#q0aPBB8B0Cj). ⚠️ **Please note that the market where you create your account will be your default sales channel.** The default sales channel cannot be changed later, and you must always have your offers listed on this market. So if you want to sell on allegro.cz, create an account on Czech Allegro; if you want to sell on allegro.pl, create an account on Polish Allegro; and to sell on allegro.sk, create an account on Slovak Allegro. Within Allegro, you can then publish these offers on other markets as well. More information is available [here](https://help.allegro.com/sell/cs/c/sdileni-nabidek-na-zahranicnich-trzich). ## **Creating a connection** First, you need to create a new connection to Allegro in the app. Go to the Connections section and click on the Allegro logo. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/01.png) Click the "Connect" button. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/02.png) After clicking the "Connect" button, a new page will open in your browser. Click the "Next" button: ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/03.png) If you are not logged in, enter your credentials and log in: ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/04.png) Confirm the app connection for your account by clicking "Continue": ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/05.png) Allegro will notify you on the last page that you have successfully connected: ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/06.png) Then return to the app, where you will see a message about a successful connection: ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/07.png) ## **Creating a campaign** After creating a connection, go to the "Campaigns" tab in the menu. You will see a "Create campaign" button in the middle of the page. Our campaign creation wizard with 5 steps will greet you. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/08.png) ### 1. General The first step is to set the campaign name. The name can be anything you like, but we recommend choosing one that makes it clear at a glance what the campaign is about. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/09.png) ### 2. Marketplace The next step is to select and configure the correct marketplace — in our case, Allegro. An information window will notify you of your default sales channel on Allegro, where you will be selling. Offers will be listed on this market, so you need to match the price in the currency of the default sales channel. You now need to select a **[shipping price list](https://salescenter.allegro.com/delivery-settings), [complaint terms](https://salescenter.allegro.com/complaints-terms), and [return terms](https://salescenter.allegro.com/returns-terms)** for the campaign. Optionally, you can also attach [warranty information](https://salescenter.allegro.com/warranty-information). You can create these sales documents directly in the Allegro admin under the sales settings section. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/10.png) ### 3. Mergado In the next step, you need to select which Mergado project and product selection you want to upload to the marketplace. {{% hint info %}} Don't have any project to select yet? See how to upload a product feed to Mergado Editor [here](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-create-a-new-project-in-mergado/). {{% /hint %}} ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/11.png) {{% hint info %}} ℹ️ If you don't want to send all products from the project to the marketplace, **create a product selection in Mergado Editor with the products you want to list on the marketplace**. {{% /hint %}} Next, a section for mapping elements from the selected Mergado Editor project to elements in the Marketplaces app will open. You must map the elements **'EAN', 'Product ID', 'Price incl. VAT', and 'Product condition'**. In this step, you can also set **'Product condition'** and **'Order processing time'** uniformly for the entire campaign (for example, if you only sell new products). The other option is to map these values to your feed elements. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/12.png) {{% hint info %}} ⚠️ **GPSR regulation** At the end of the Mergado section, you need to fill in information related to the GPSR regulation. More information can be found [here](https://help.mergado.com/en/mergado-marketplaces/gpsr-on-allegro-and-kaufland/). {{% /hint %}} ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/13.png) ### 4. Availability feed The second-to-last step is setting up the availability feed. Simply enter the URL of your availability feed. We support Mall and [Heureka availability feeds](https://help.mergado.com/en/mergado-marketplaces/availability-feed/), as well as the [Mergado Marketplaces feed format](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/). The app will check the submitted availability feed. If you receive a message that all products are missing, you likely entered a different availability feed, or you incorrectly mapped the Product ID in the **Mergado** step. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/14.png) 💡 **If you don't have an availability feed in Mall or Heureka format, you can create one using Mergado Editor. More information can be found in our article [here](https://help.mergado.com/en/mergado-marketplaces/availability-feed/).** {{% hint info %}} ℹ️ If you encounter the error message "An error occurred while downloading the availability feed, make sure the file is accessible", your availability feed is likely secured and the app cannot access it. If your e-shop runs on Shoptet, you can find instructions on how to adjust your availability feed security settings **[here](https://www.mergado.cz/zabezpeceni-shoptet-feedu)**. {{% /hint %}} ### 5. Completion The last step is a summary of the campaign settings. Simply verify that everything is set up correctly and make any corrections if needed. Finally, click "Save". ✅ **The campaign has been created and your offers are now being uploaded to Allegro.** This process may take a while, so please be patient. However, the process of uploading offers to Allegro doesn't end here. It's a good idea to check the number of uploaded and failed products and fix any errors. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/15.png) {{% hint info %}} **After the product feed synchronization is complete, click on the campaign detail and check for any error messages in the validation section.** An explanation of the most common validation messages can be found [here](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-validation-messages/). {{% /hint %}} ❓ Do you see the validation error message "**No product card was found in the Allegro catalog under this product identifier. To create one, go to the 'Product cards' section**"? This message means that a product card doesn't exist yet in the Allegro catalog for the given products. A detailed guide on how to create a product card through our app can be found [here](https://help.mergado.com/en/mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/). --- ## [Upload Products to Kaufland via Mergado](https://help.mergado.com/en/mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/) ## How to create a campaign and upload products to Kaufland This step-by-step guide walks you through creating a campaign in Mergado Marketplaces and uploading your products to Kaufland Global Marketplace. {{% hint info %}} First, you need to activate the [Mergado Marketplaces app in Mergado Store](https://store.mergado.com/detail/ordelogyproducts/#about). Before you begin, make sure you have: ✅ A verified business account on Kaufland ✅ A product feed in Mergado Editor with EAN codes ✅ A Heureka/Mall availability feed or Mergado Marketplaces feed {{% /hint %}} {{% hint info %}} 💡 Not sure which output feed format is best? The Mergado Marketplaces extension accepts all formats offered by Mergado Editor. However, a new option is the **Mergado Marketplaces feed format**, which you can use to synchronize both product data and availability. More information [here](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/). {{% /hint %}} In this guide, we will show you **how to create a campaign and upload products to Kaufland Global Marketplace**. First, you need to create and properly set up your account on Kaufland Global Marketplace. Detailed information about registering on Kaufland marketplace can be found here: https://www.kaufland.de/i/seller-university/cz/registration/. ## Creating a connection In the Marketplaces app, first go to the "Connections" tab and click on the Kaufland logo: ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/01.png) On the connection detail page, you need to enter **API keys**, which you can find in your admin panel directly on the Kaufland marketplace website. Go to "Settings" > "Shop settings" > "API". Your API keys ("Client Key" and "Secret Key") are listed at the top. If there are none yet, simply generate new ones. **Save the keys securely after generation — you will only see them once, and they cannot be displayed again.** ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/02.png) Enter these keys into the Mergado Marketplaces app and click the Connect button — the connection should now be active. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/03.png) {{% hint info %}} ℹ️ If you regenerate keys in the Kaufland admin and get new ones, the original keys will become invalid. So if the Marketplaces app has the old keys saved and you generate new ones in the Kaufland admin, **the connection will stop working**. {{% /hint %}} ## Creating a campaign After creating a connection, go to the "Campaigns" tab in the menu. You will see a "Create campaign" button in the middle of the page. Our campaign creation wizard with 5 steps will greet you. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/04.png) ### 1. General The first step is to set the campaign name. The name can be anything you like, but we recommend choosing one that makes it clear at a glance what the campaign is about. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/05.png) ### 2. Marketplace In the next step, you need to choose which marketplace you want to upload offers to. Select "Kaufland". A field for selecting the **sales channel** (the country where the offers will be sold) and a **shipping group**, which you set up in the [Kaufland admin](https://sellerportal.kaufland.de/shipping-groups/), will open. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/06.png) ### 3. Mergado In the next step, you need to select which Mergado project and product selection you want to upload to the marketplace. {{% hint info %}} Don't have any project to select yet? See how to upload a product feed to Mergado Editor [here](https://help.mergado.com/en/mergado-editor/about-mergado/project-management-in-mergado/how-to-create-a-new-project-in-mergado/). {{% /hint %}} ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/07.png) ℹ️ If you don't want to send all products from the project to the marketplace, **create a product selection in Mergado Editor with the products you want to list on the marketplace**. Next, a section for mapping elements from the selected Mergado Editor project to elements in the Marketplaces app will open. You must map the elements **'EAN', 'Product ID', 'Price incl. VAT', 'Product condition', and 'Order processing time'**. The elements 'Product name', 'Product description', and 'Images' are optional and are only sent to Kaufland when creating or completing product cards. For offers that already have a product card in the Kaufland catalog, images from the Kaufland product card will be used. {{% hint info %}} ❗ **Please note that for the DE, AT, SK, IT, and FR sales channels, you must map the price in EUR; for the CZ sales channel in CZK; and for the PL sales channel in PLN.** {{% /hint %}} In this step, you can also set **'VAT'**, **'Product condition'**, and **'Order processing time'** uniformly for the entire campaign (for example, if you only sell new products). The other option is to map these values to your feed elements. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/08.png) ### 4. Availability The second-to-last step is setting up the availability feed. Simply enter the URL of your availability feed. We support Mall and [Heureka availability feeds](https://help.mergado.com/en/mergado-marketplaces/availability-feed/), as well as the [Mergado Marketplaces feed format](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-feed-format/). The app will check the submitted availability feed. If you receive a message that all products are missing, you likely entered a different availability feed, or you incorrectly mapped the Product ID in the **Mergado** step. ![image](/images-mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/09.png) 💡 **If you don't have an availability feed in Mall or Heureka format, you can create one using Mergado Editor. More information can be found in our article [here](https://help.mergado.com/en/mergado-marketplaces/availability-feed/).** {{% hint info %}} ℹ️ If you encounter the error message "An error occurred while downloading the availability feed, make sure the file is accessible", your availability feed is likely secured and the app cannot access it. If your e-shop runs on Shoptet, you can find instructions on how to adjust your availability feed security settings **[here](https://www.mergado.cz/zabezpeceni-shoptet-feedu)**. {{% /hint %}} ### 5. Completion The last step is just a final summary. Make sure everything is filled in correctly and make any corrections if needed. Complete the campaign creation by clicking the "Save" button in the bottom right corner. The campaign is now created and offers will start uploading to Kaufland marketplace automatically. This process may take some time. {{% hint info %}} ❗ **After the product feed synchronization is complete, click on the campaign detail and check for any error messages in the validation section.** An explanation of the most common validation messages can be found [here](https://help.mergado.com/en/mergado-marketplaces/mergado-marketplaces-validation-messages/). {{% /hint %}} ❓ Do you see the validation error message "**No product card was found in the Kaufland catalog under this EAN code. To create one, go to the 'Product cards' section**"? This message means that a product card doesn't exist yet in the Kaufland catalog for the given products. A detailed guide on how to create a product card through our app can be found [here](https://help.mergado.com/en/mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/). --- ## [Creating product cards for Allegro and Kaufland](https://help.mergado.com/en/mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/) ## **Creating product cards for Allegro and Kaufland** This guide shows how to create new product cards on Allegro and Kaufland via Mergado Marketplaces when a product does not yet exist in the marketplace catalog. If you encountered the validation message "**No product card was found in the Allegro catalog under this product identifier. To create one, go to the 'Product cards' section**" or "**No product card was found in the Kaufland catalog under this EAN code. To create one, go to the 'Product cards' section**" after creating a campaign, it means that a product card doesn't exist yet in the marketplace catalog for the given product, and you need to create a new one. In this article, we will show you how. ⚠️ For Kaufland, the product card creation process includes both products with the validation message "No product card was found in the Kaufland catalog under this EAN code. To create one, go to the 'Product cards' section" and products with the "Incomplete" status. This status means that your offer was successfully uploaded to Kaufland, but the product card it's linked to is incomplete and needs additional product data before the offer can be activated. **After creating a new Kaufland campaign, it's a good idea to wait for the first status synchronization and only then start creating product cards.** This way, all relevant products will be included in the process from the start. {{% hint info %}} 📔 **Glossary:** **Marketplace catalog** = A product catalog where each product has one product card that sellers can link their offers to. **Product card** = A card in the marketplace catalog containing all required product parameters (dimensions, material, color, etc.). Offers are then linked to the product card by product identifier. **Offer** = After uploading a product feed to the Mergado Marketplaces app, products become offers on the marketplace. On the marketplace, each product has one product card to which offers from various sellers are linked. Offers differ in price and purchasing terms, but the basic product details on the product card, such as EAN code, manufacturer, or brand, are identical. {{% /hint %}} You can access the product cards section either directly from the campaign menu or by clicking the icon next to the validation message: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/01.png) **1. MAPPING ALL REQUIRED ELEMENTS** To create product cards, you need to map certain elements that were previously optional within the app. These are: * **Images** * **Product name**: Make sure the product name is in the language of the storefront where you are selling. * **Category** * **Product description**: This element is required only for Kaufland. {{% hint info %}} ❗ You must have a filled-in EAN code as the product identifier. {{% /hint %}} ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/02.png) If you haven't mapped these elements yet, go to the campaign settings, open the elements section, and map the required elements. ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/03.png) Then save the changes and click "Synchronize product feed" at the bottom of the campaign settings. **2. MAPPING CATEGORIES** After mapping these elements, the product cards section will become available: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/04.png) **Here, you just need to map your product feed categories to the corresponding categories on Allegro/Kaufland and save the mapping.** This way, the app can determine which parameters are required for the given category on the marketplace. ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/05.png) When mapping categories, you have several options: - Bulk pre-mapping of categories using the "Suggest categories" function: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/06.png) - Finding a suitable category using the category tree: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/07.png) - Searching within the category tree: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/08.png) - Using the "Suggest category" function, where Allegro and Kaufland attempt to suggest the most suitable category: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/09.png) - Searching via category suggestion, where you enter your own search term in the search field: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/10.png) **3. FILLING IN PARAMETERS** Clicking on a mapped category displays a table of products that need a product card created in the given category. The table shows an overview of all required parameters that Allegro/Kaufland requires for creating a product card. ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/11.png) In the table, you can fill in two types of parameters: * **Required parameters**, which are highlighted in red and must be filled in to create a product card. * **Optional parameters**, which have a white background and are voluntary. You can fill in any number of optional parameters and also delete their values. Note that, just like with required parameters, their values cannot be changed after a product card is successfully created. When filling in parameters, you can add values: * At the individual product level * Or fill in values for the entire column of a given parameter You can also choose between entering a custom value and mapping to a feed element. Custom value: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/12.png) Mapping to a feed element: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/13.png) When mapping to a feed value, only the element name is displayed in the table, but the actual values will be sent to the marketplace when listing. {{% hint info %}} ℹ️ If your brand is not in Allegro's list of allowed values, you can choose "no brand" or apply to add the brand to Allegro's list via [this form](https://salescenter.allegro.com/parameter-value-suggestions/create-suggestion). Once Allegro approves the brand addition for the given category, you can list product cards with this brand through our app. {{% /hint %}} **4. LAUNCHING THE LISTING** After filling in all required parameters for at least one product, the "**Launch product card listing**" button will become available. ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/14.png) {{% hint info %}} 💡 After successful listing, you can edit parameters on the product card in the "**Listed card edits**" section. For both Allegro and Kaufland, only a **change proposal for the product card** is submitted, and it's up to the marketplace itself to accept or reject the change. For Allegro, after clicking "Propose product card changes", a window will pop up where you can choose whether Allegro should notify you about the proposal processing result (Allegro sends the result to the email associated with your Allegro account). For Kaufland, you need to check the result directly in the Seller Portal. {{% /hint %}} **The listing result** can be found after some time directly in the product listing table, where you'll see the following icons: ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/15.png) The product card has not been listed yet. ![image](/images-mergado-marketplaces/creating-product-cards-for-allegro-and-kaufland/16.png) An error occurred during product listing. Click the icon to see the specific error. The product card was successfully created. This status is displayed **only for Kaufland** and means the product card is in the approval process by Kaufland. This **process can take several days**. Once we receive feedback from Kaufland, the status will change to an exclamation mark or a checkmark. If the product card is approved, your offer will be linked to it during the next product feed synchronization. You can also check the listing result in the history section: **5. CHECKING PRODUCTS ON THE MARKETPLACE** After listing a product card on the marketplace, check the product and offers directly in the marketplace admin as well. {{% hint info %}} Approval of a product card on Kaufland can take several days. Once the card is approved, we will assign the "Not synchronized" status to the offer, and the offer will be linked to your newly created card during the next product feed synchronization. {{% /hint %}} 💡 **TIP AT THE END**: Automatic product card creation for new products In the product card creation section, you can check the '**Fill in for new products as well**' option for both required and optional parameters when filling in a parameter for the entire column. Once this option is enabled for all required parameters, the '**Activate automatic listing of new products**' option will become available. {{% hint info %}} By activating automatic listing of new products, product card creation will immediately start for all unlisted products with filled-in required parameters. After successful listing, you can edit the product card details in the "Listed card edits" section. {{% /hint %}} You can deactivate automatic listing of new products at any time. If an error occurs during automatic listing for a product card, you still need to correct the details according to the Allegro validation message and try to list the product manually. --- ## [Completing Allegro product cards](https://help.mergado.com/en/mergado-marketplaces/completing-allegro-product-cards/) ## **How to complete Allegro product cards** This article explains how to add missing required parameters to existing Allegro product cards using the Product card completion feature in Mergado Marketplaces. We have added the ability to **add required parameters to already existing cards from the Allegro catalog**. This applies to cases where Allegro has a product card under the given product identifier in its catalog, but the product card is not complete. To link an offer to this card, the Allegro product card needs to be completed. This is possible in the new "Product card completion" section. You can access this section through the product cards section or by clicking the icon next to the validation message "**The Allegro product card is missing required parameters, add them via 'Product card completion' in the 'Product cards' section**". ## 1. Determining Allegro categories The first step is to launch a process that determines what category the given product cards belong to on Allegro, so the app can offer appropriate allowed values for the missing parameters: ![image](/images-mergado-marketplaces/completing-allegro-product-cards/01.png) {{% hint info %}} Please note that determining Allegro categories may take a while if there are many products with this message. {{% /hint %}} The category list will be in English, as this is the format in which Allegro sends us the categories. Don't worry though — the parameters will be added to the product card on the market where you are selling. ## 2. Filling in missing parameters After clicking on a category, a list of products that need parameters completed in the given category will be displayed. A missing parameter is highlighted in red, and after filling it in, the "**Launch product card completion**" button will become available: ![image](/images-mergado-marketplaces/completing-allegro-product-cards/02.png) ## 3. Result of parameter completion - ✅ If the parameter is successfully completed, the product will disappear from the table and the offer will be automatically linked to the corrected card. - ❗ If Allegro returns an error, an exclamation mark icon with an error message will appear in the table, and the parameter will need to be corrected. After correcting the parameter value, you can re-launch the product card completion. --- ## [GPSR on Allegro and Kaufland](https://help.mergado.com/en/mergado-marketplaces/gpsr-on-allegro-and-kaufland/) ## GPSR on Allegro and Kaufland {{% hint info %}} **GPSR in brief** From 13 December 2024, the EU General Product Safety Regulation comes into effect, applying to most consumer products (more [here](https://eur-lex.europa.eu/CS/legal-content/summary/general-product-safety-regulation-2023.html)). Online marketplaces including Kaufland and Allegro require additional information from sellers as a result. Failure to provide this information may result in the marketplace hiding your offers. On Allegro, you need to fill in safety instructions and information, as well as manufacturer data or data about the person responsible for placing the product on the European market. On Kaufland, the required elements are the manufacturer/responsible person in the EU name, CE marking, and safety instructions. In this article, you will learn how to add these details to your products on online marketplaces. {{% /hint %}} ## What is GPSR? You may have already noticed that from **13 December 2024**, the EU General Product Safety Regulation (GPSR) comes into effect, introducing changes for sellers on online platforms. GPSR covers most consumer products, including new, used, repaired, and refurbished products as well as spare parts. **Excluded from the regulation are:** * medicines intended for humans or animals * food * animal feed * live plants and animals, genetically modified organisms, and genetically modified microorganisms in contained use, such as products from plants and animals directly relating to their future reproduction * animal by-products and derived products * plant protection products * equipment in or by which consumers are transported or travel, where that equipment is directly operated by a service provider as part of a transport service provided to consumers * aircraft referred to in Article 2(3)(d) of Regulation (EU) 2018/1139 * antiques To meet the product safety information obligation, the following details must be provided for each product covered by the regulation: a. The **manufacturer's** name, registered trade name, or registered trademark, postal address, and email address * **Data about the person responsible for placing the product on the European market** — this must be provided only if the manufacturer's headquarters are outside the European Union: name, postal address, and email address b. **Information enabling product identification**, including its image, category, and other identifiers such as EAN code, model, etc. c. **Warnings and safety information** — informing about how to safely use the product, for example: * Product user manual — add attachments in the official language of the country where you sell the product * Images of labels on the product packaging * A note with warnings related to the product d. If required, **CE marking and declarations of conformity** ℹ️ More information about GPSR can be found here: https://eur-lex.europa.eu/CS/legal-content/summary/general-product-safety-regulation-2023.html ## How to add information to your products on online marketplaces? ## Allegro
IMPORTANT CHANGES ON ALLEGRO FROM AUGUST 2025 **💡 How did it work until now?** Allegro previously introduced the option to fill in the 'Products placed on the EU market before 13.12.2024' parameter on its platform. If your products were placed on the European market before this date, you didn't need to fill in additional mandatory GPSR details. Now, also due to pressure from regulators, Allegro is changing its approach to GPSR data. **📢 What is changing on Allegro from August 2025?** 1️⃣ The 'Products placed on the EU market before 13.12.2024' field From 12 August 2025, this parameter can only be set for products with the condition 'Used', 'Retreaded', 'For parts', 'Remanufactured', 'Damaged', 'Refurbished by manufacturer', 'Refurbished by seller', 'For restoration', 'Renovated', 'No renovation needed', and 'After disassembly'. **For all new goods, complete safety information and manufacturer data must be provided — regardless of the date of market placement.** 2️⃣ The 'Warnings and safety information' field From 4 August 2025, it will no longer be possible to use the value 'Do not send safety information', which sellers could use to indicate that no safety information is available for the product. **Going forward, you must provide safety information in the form of an attachment or text.** **⚠️ Why should you address this and what steps should you take?** Once the changes take effect, Allegro will return an error message when editing active offers, and the offer will not be active until the data is provided. There is a risk that a large number of your offers could be deactivated within days of the changes being implemented. Adding these details can be time-consuming, so it's better to start working on it as soon as possible. Instructions for adding the elements "Warnings and safety information", "Manufacturer data", and "Responsible persons for placing on the European market" can be found below.
{{% hint info %}} 💡 If you don't fill in GPSR information for your offers, we will attempt to supplement this data from the Allegro product catalog during **manual product feed synchronization** (by clicking "Synchronize product feed" in the campaign settings) and during **offer creation** (for new campaigns or new products in a campaign). This data is generated by Allegro using artificial intelligence, so we recommend carefully reviewing the details on your offers afterwards. {{% /hint %}} --- As part of GPSR, the following details are filled in at the offer level on Allegro: * **Products placed on the EU market before 13.12.2024** * From 12 August 2025, the parameter "Products placed on the EU market before 13.12.2024" can only be set for products with the condition 'Used', 'Retreaded', 'For parts', 'Remanufactured', 'Damaged', 'Refurbished by manufacturer', 'Refurbished by seller', 'For restoration', 'Renovated', 'No renovation needed', and 'After disassembly'. * **Manufacturer data** * **Responsible persons for placing on the European market** * **Warnings and safety information** ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/01.png) **1. Manufacturer data and data about the person responsible for placing the product on the European market** You can add manufacturer data in the "[Manufacturer data](https://salescenter.allegro.com/responsible-producers)" section under the "Sales settings" tab directly in Allegro Sales Center. Data about the person responsible for placing the product on the European market needs to be provided only if the manufacturer's headquarters are outside the European Union. You can add this information in the "[Responsible persons](https://salescenter.allegro.com/responsible-persons)" section under the "Sales settings" tab directly in Allegro Sales Center. This way, you prepare all manufacturer and responsible person cards on Allegro, which should contain: * First name and surname, registered trade name, or registered trademark * Address * Email address or a link to a contact form For each manufacturer/person, you also enter a "Custom name" — pay attention to this detail, as you will use this name to assign manufacturers and responsible persons to offers in Mergado Marketplaces. ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/02.png) Once you have all manufacturers and responsible persons prepared in Allegro Sales Center, you can go to the Mergado Marketplaces app. You can then add these details in the campaign settings in Mergado Marketplaces, where you can choose a single manufacturer for all products in the campaign or map the element to a feed. When mapping to a feed element, use the custom names of the sellers as you entered them in the Allegro admin as values. Then save the campaign settings changes and click "Synchronize product feed" at the bottom of the settings. ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/03.png) ℹ️ You can add custom names of manufacturers and responsible persons to the feed in 2 ways:
1. Creating a new element and adding values using selections Go to the "Elements" section of the project you use in the Mergado Marketplaces app. Then click "Add new element": ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/04.png) The name is entirely up to you. For our purposes, we chose the name RESPONSIBLE_PRODUCER for manufacturer data: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/05.png) Create different product selections in Mergado Editor for groups of products to which you want to assign the same manufacturer data. For example, by values in the MANUFACTURER element: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/06.png) Once you have all selections prepared, go to the "Rules" section and select "New rule". The rule name is arbitrary — in our case, for example, "Adding custom names for RESPONSIBLE_PRODUCER". As the rule type, select "Bulk overwrite by selections" and choose your newly created element: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/07.png) Under "New value", enter the "Custom name" of the given manufacturer from your Allegro admin for each product selection: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/08.png) In the Mergado Marketplaces campaign settings, map "Manufacturer data" to your newly created feed element and launch the product feed synchronization: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/09.png) After synchronization is complete, check the "Validation" section in the Mergado Marketplaces app to see if any errors occurred when uploading this data to Allegro. You can use the same procedure for "Responsible persons for placing on the European market". If you don't want to send this detail for certain products, just leave the element value empty in your feed.
2. CSV file import You can also import data into the feed using a CSV file, where the first column serves as the product identifier and additional columns contain elements and their values that you want to import into the feed. Let's demonstrate this with the example of "Responsible persons for placing on the European market". Prepare individual person cards on Allegro: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/10.png) In the given Mergado Editor project, create a new element that you will populate with values via CSV import: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/11.png) The column names in the CSV file must match the names of existing elements in your project. Also, remember to enter the "Custom names" of individual responsible persons from the Allegro admin: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/12.png) Once you have the CSV file ready, go to the "Rules" section of the given project and create a new rule. As the rule type, select "Data file import" and upload the CSV file: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/13.png) After applying the rules, you can check the product overview to verify that the element values were correctly filled in: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/14.png) In the Mergado Marketplaces campaign settings, map "Responsible persons for placing on the European market" to your newly created feed element and launch the product feed synchronization. 🔗 More information about CSV import can be found here: https://www.mergado.cz/blog/csv-import-mergado-release
{{% hint info %}} 💡 If the "**Custom name**" you entered on Allegro for manufacturer data is **identical** (including letter case, etc.) to the value you have in the feed for the MANUFACTURER element (or another element for manufacturer), you can map manufacturer cards using this element without needing to create a new one. {{% /hint %}} **2. Warnings and safety information** This can be a product user manual in the sales channel language, images of labels on the product packaging, or a text with warnings. You can add this detail in the campaign settings in Mergado Marketplaces by mapping to a feed element or entering a single value for all products in the campaign: * When choosing a single value for the entire campaign, enter **plain text without HTML formatting with a maximum length of 2,000 characters** * When mapping to a feed element, the values can be: * Publicly accessible **URLs** starting with http:// or https://, from which files in PDF, JPEG, JPG, or PNG format with a maximum size of 50 MB can be downloaded. * **Plain text without HTML** formatting with warnings related to the product. ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/15.png) ℹ️ You can add information to the feed in two ways (see the procedure above): * Creating a new element and adding values using selections * CSV file import {{% hint info %}} ⚠️ Since all GPSR details on Allegro are filled in at the offer level, you can change these details in the campaign settings at any time. {{% /hint %}} 🔗 More information can be found on the Allegro website [here](https://help.allegro.com/sell/cs/a/jake-povinnosti-vam-uklada-gpsr-O3YPWLrz4im#). ## Kaufland On Kaufland, GPSR details are provided at the product card level. For products covered by the regulation, the following should be added: * **Manufacturer/responsible person in the EU name** * **CE marking** * **Safety instructions**
Selling on Kaufland via Mergado Marketplaces (API connection) These details can be added via the Mergado Marketplaces app only when you are creating new product cards or completing incomplete cards. **The Mergado Marketplaces app does not allow editing of already existing product cards.** **1. Creating new product cards or completing incomplete cards** When creating or completing product cards in the "Product cards" section, simply add these three details if the given product falls under GPSR: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/16.png) ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/17.png) **2. Adding details to already existing product cards** If you already have products listed on Kaufland, you can add the necessary data to product cards in 2 ways: a) Via a one-time import: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/18.png) ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/19.png) The import should contain: * **ean** * **locale** (e.g. cs-CZ) And the elements you want to add as part of GPSR, such as: * **product_safety_contact.name** * **product_safety_contact.address** (in the format "Street 1, City, 615 00, CZ") * **product_safety_contact.email_address** * **product_safety_contact.phone_number** * **safety_guidelines** (these are legal texts for which Kaufland has specific allowed values, such as: "Warning! Product is not suitable for children under 36 months") * **ce_certificate** (a publicly accessible URL from which a file in jpg, gif, svg, png, or pdf format can be downloaded) A list of allowed values for safety_guidelines **[here](https://docs.google.com/spreadsheets/d/17uu69dyqQ8BkfpWVfeM7CvY9KtnNyC9QUIM0P5dcMRI/edit?gid=2131277475#gid=2131277475)**. You can create the file in Google Sheets, for example, and it could look like this: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/20.png) Download the file in CSV format and upload it to Kaufland. b) Via Mergado Editor, where you can easily create these elements and add their values in two ways (see the procedure above): * Creating new elements and adding their values using selections * CSV file import In Mergado Editor, prepare these elements and populate them with allowed values: ![image](/images-mergado-marketplaces/gpsr-on-allegro-and-kaufland/21.png) For the purposes of a one-time import, the file can contain only the ean, locale, and new elements you want to add as part of GPSR. Then download the feed from the Editor and perform a one-time import to Kaufland.
Selling on Kaufland via Mergado Editor (feed connection) If you are connected to Kaufland via feeds and are already regularly sending a product feed to Kaufland, you can add the following elements to your feed (see the image above): * product_safety_contact.name * product_safety_contact.address (in the format "Street 1, City, 615 00, CZ") * product_safety_contact.email_address * product_safety_contact.phone_number * safety_guidelines (these are legal texts for which Kaufland has specific allowed values, such as: "Warning! Product is not suitable for children under 36 months") * ce_certificate (a publicly accessible URL from which a file in jpg, gif, svg, png, or pdf format can be downloaded) A list of allowed values for safety_guidelines **[here](https://docs.google.com/spreadsheets/d/17uu69dyqQ8BkfpWVfeM7CvY9KtnNyC9QUIM0P5dcMRI/edit?gid=2131277475#gid=2131277475)**. If you have "Automatic product data upload" set up in Kaufland, there is no need to perform a one-time import. The new data will be automatically sent to Kaufland when Kaufland next downloads the output feed.
🔗 More information can be found here: https://www.kauflandglobalmarketplace.com/cs/seller-university/pravni-pruvodce/gpsr/ {{% hint info %}} **Disclaimer:** This information does not constitute and does not replace legal advice. Please inform yourself at your own responsibility and, if necessary, seek legal advice regarding whether the products you offer fall under the relevant categories and requirements. {{% /hint %}}
--- ## [Importing orders into Shoptet Premium](https://help.mergado.com/en/mergado-marketplaces/importing-orders-into-shoptet-premium/) ## **Importing orders into Shoptet Premium** This article explains how to set up automatic order import from Allegro and Kaufland into Shoptet Premium via Mergado Marketplaces, including API key generation and status synchronization. Is your e-shop running on Shoptet Premium? With Mergado Marketplaces, you can import marketplace orders directly into your e-shop platform. Order synchronization runs every 5 minutes, and new orders with the "Not shipped" status are imported into Shoptet. The following status synchronization occurs from Mergado Marketplaces to Shoptet: * "Not shipped" 👉 "Pending" * "Shipped" 👉 "Order completed" * "Cancelled" 👉 "Cancelled" ## **How to start importing orders into Shoptet Premium?** ### 1. Create API keys 🗝️ In the Shoptet Premium admin, go to `Integrations > Private API` and add a new private token. ![image](/images-mergado-marketplaces/importing-orders-into-shoptet-premium/01.png) ### 2. Connect Shoptet Premium with Mergado Marketplaces 🔗 In Mergado Marketplaces, go to the **Connections** section and select the Shoptet Premium connection. Simply fill in the previously generated API token and the connection will be successfully established. ![image](/images-mergado-marketplaces/importing-orders-into-shoptet-premium/02.png) ### 2. Activate synchronization 🔄 Go to the **Orders > Activation** section, activate synchronization, and save the changes. You can pause synchronization at any time on the activation page. ![image](/images-mergado-marketplaces/importing-orders-into-shoptet-premium/03.png) {{% hint info %}} 🕑 The order management system does not synchronize retroactively. So you don't need to worry about your system being flooded with all previous orders when you start it. {{% /hint %}} ### 💡 **Important information:** * Products are matched to your Shoptet catalog by matching the "Product ID" in Mergado Marketplaces with the "Product code" in the Shoptet catalog. * The VAT rate for products matched to your catalog is taken directly from it. For unmatched products, the default VAT rate from your Shoptet admin is used. * To import orders in foreign currencies, you need to enable foreign currencies in the Shoptet admin under "Settings" -> "Basic settings" -> "Currencies". {{% hint info %}} ℹ️ If you encounter any issues or have an idea for improvement, let us know at support [mergado@mergado.cz](mailto:mergado@mergado.cz) or on the forum. Thank you! {{% /hint %}} --- ## [Connecting orders to WooCommerce with Mergado Marketplaces](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/) ## Connecting orders to WooCommerce with Mergado Marketplaces The Mergado Marketplaces extension allows you to **manage orders through WooCommerce**. If you run an online store on WooCommerce and sell on Allegro or Kaufland, you can now work with your orders directly in your shop's admin interface. {{% hint info %}} 🎪 **Our vision** is simple: Manage marketplaces like your online store. Easily list products via Mergado and handle order management directly in your e-shop platform – just as you're used to. {{% /hint %}} The first integrated platform is WooCommerce, but you can look forward to **additional functions for this integration** and **future integrations with other e-commerce platforms**. --- ## How does it work? Orders from Allegro or Kaufland are automatically transferred to WooCommerce every 5 minutes via Mergado Marketplaces. When you update an order in your shop (e.g., mark it as shipped), the status is also synced back to the marketplace. If we get a tracking number from WooCommerce, we also forward it to the marketplace. **However, you still need to monitor the marketplace admin interface.** --- ## How to enable order management for WooCommerce? ### 1. Create a WooCommerce connection in Mergado Keychain Within the Mergado extensions, you will also find Mergado Keychain for managing connections. Click on WooCommerce and enter your e-shop URL: ![image](/images-mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/01.png) You will then be redirected to WooCommerce, where you will confirm Mergado's access to your e-shop: ![image](/images-mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/02.png) If the connection was successfully established, a green message and an icon will appear next to WooCommerce: ![image](/images-mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/03.png) --- ### 2. Activate Mergado Marketplaces In the Extensions section in Mergado, activate Mergado Marketplaces. In Mergado Marketplaces, go to the Connections section and verify that the WooCommerce connection is active: ![image](/images-mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/04.png) --- ### 3. Activate synchronization Go to **Orders > Activation**, activate the synchronization, and save changes. You can pause the synchronization at any time in the Activation section. {{% hint info %}} ℹ️ The order management system does **not** sync orders retroactively. You don't need to worry about your system being flooded with past orders after enabling it. {{% /hint %}} ![image](/images-mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/05.png) All done! 🎉 From now on, your orders will sync regularly between your Marketplaces and WooCommerce. --- ## Order Metadata The only place where we can pass additional order data is the order metadata. Currently, you'll find the following in the metadata: * The order number from the marketplace * For Allegro: pickup point code and location ![image](/images-mergado-marketplaces/connecting-orders-to-woocommerce-with-mergado-marketplaces/06.png) --- ## Current Limitations * We can currently fetch tracking numbers **only** when using the official [Zásilkovna plugin](https://www.zasilkovna.cz/digitalni-integrace/woocommerce) or the [Toret Zásilkovna plugin](https://toret.cz/produkt/woocommerce-zasilkovna/). * Without a tracking number, we cannot change the order status to **"shipped"** on Kaufland. * We do **not** support **custom order statuses** in WooCommerce (if used, the status appears as "unknown" and we do not update the marketplace). * We do not develop a WooCommerce extension – we only use API connections. Therefore, your WooCommerce admin interface will not be enhanced visually or functionally by this integration. --- {{% hint info %}} ℹ️ If you encounter any issues or have improvement ideas, please contact our support at [mergado@mergado.com](mailto:mergado@mergado.com) or post here in the forum. Thank you! {{% /hint %}} --- ## [Connecting orders to UNAS with Mergado Marketplaces](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-unas-with-mergado-marketplaces/) ## **Connecting orders to UNAS with Mergado Marketplaces** This guide explains how to connect orders from Allegro and Kaufland to your UNAS e-shop platform via Mergado Marketplaces, including API key setup and synchronization configuration. In the Mergado Marketplaces app, you can use **order management via UNAS**. If you run an e-shop on UNAS and sell on Allegro or Kaufland, you can now work with your orders directly in your e-shop admin. Below you will find the procedure for setting up order synchronization with UNAS. **1. Creating a UNAS connection in Mergado Keychain** To create the connection, you need to fill in the following in Mergado Keychain: * API key * Shop name (ID) You can find this information in UNAS under `Beállítások` > `Külső kapcsolatok` > `API kapcsolat`. Click the `API kulcs létrehozása` button and create an API key for Mergado. For proper functioning, Mergado Marketplaces needs to perform the following operations: * getOrder * setOrder * getOrderStatus * setOrderStatus * getMethod After saving, copy the API key and enter it along with the shop name into Mergado Keychain: ![image](/images-mergado-marketplaces/connecting-orders-to-unas-with-mergado-marketplaces/01.png) **2. Currency settings in UNAS** If you sell on multiple markets via Mergado Marketplaces, you need to enable foreign currencies in the UNAS settings under `Beállítások` > `Pénznemek, Árkijelzés` > `Pénznemek`. Add all currencies for the countries where you sell via Mergado Marketplaces. ![image](/images-mergado-marketplaces/connecting-orders-to-unas-with-mergado-marketplaces/02.png) **3. Activating UNAS in Mergado Marketplaces** Once you have a successful connection in Mergado Keychain and currencies prepared, you can activate orders in Mergado Marketplaces under `Orders` > `Activation`. Check UNAS and save the changes. For order synchronization to work properly, you also need to have orders activated for at least one marketplace. **4. Additional settings in Mergado Marketplaces** **Matching shipping and payment methods** After activating orders, you can match shipping and payment methods from marketplaces to your UNAS values in the "Connections" section. This section dynamically loads shipping and payment method values based on incoming orders. It's a good idea to regularly check this section and match any new values that may have appeared. {{% hint info %}} If you don't match shipping and payment methods, we will send the payment and shipping method to UNAS in the format we receive them from the marketplace. {{% /hint %}} ![image](/images-mergado-marketplaces/connecting-orders-to-unas-with-mergado-marketplaces/03.png) **VAT rates** To create an order in UNAS, it is mandatory to include the price excluding VAT for order items. You can fill in the VAT rate in the settings of individual campaigns for Allegro and Kaufland. If you don't have a VAT rate set for your offers, the standard rate for the given country will be used to calculate the price excluding VAT. **Status matching between Mergado Marketplaces and UNAS** * Not shipped 👉 Waiting for processing (Feldolgozásra vár) * Processing 👉 Confirmed (Visszaigazolva) * Shipped 👉 Delivery (Kiszállítás) * Cancelled 👉 if this status is not available in your UNAS, our app will create a custom 'Cancelled' status --- ## [Importing orders into the POHODA system](https://help.mergado.com/en/mergado-marketplaces/importing-orders-into-pohoda-system/) ## **Importing orders into the POHODA system** This guide walks you through setting up order import from Allegro and Kaufland marketplaces into the POHODA accounting system using Mergado Marketplaces. Need to get your marketplace orders into the POHODA system? Mergado Marketplaces now generates a feed with new orders that you can import into POHODA. In this guide, we will walk you through everything step by step: {{% hint info %}} 📝 **Notes before you start:** * For the Allegro order ID, only the first 30 characters are written to the feed due to a limitation on the POHODA side * POHODA automatically prevents duplicate order imports * Only orders with the "Not shipped" status are imported {{% /hint %}} ## **Settings in Mergado Marketplaces** 1. In the "Connections" section, click on the POHODA logo and fill in the following details: * **Company ID number**: The company ID must match the ID set in the POHODA accounting unit. * Authorization: fill in the **username and password** to secure the order feed. Save these details carefully, as you will need to enter them into the POHODA system later. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/01.png) 2. After saving successfully, go to 'Orders' -> 'Activation', select POHODA and the marketplaces from which you want to download orders, and save the changes. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/02.png) 4. You can then return to the POHODA system connection detail in the 'Connections' section, where you will find the order feed URL to enter into the POHODA system following the instructions below. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/03.png) ### **Matching payments and carriers** Both payments and carriers are matched by the **'Name'** field. The name entered in Mergado Marketplaces and in the POHODA system must be completely identical for payments and carriers to be matched correctly. In the payment and carrier matching section in Mergado Marketplaces, you will only see the values that have appeared in your orders with the "Not shipped" status: ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/04.png) {{% hint info %}} 💡 We recommend leaving the order export enabled for at least one week and then matching payment methods and carriers. **We also recommend regularly checking this section for new payment methods or carriers that may need to be matched.** {{% /hint %}} ⚠️ If an order appears with an unknown payment method or carrier (the detail has not been matched yet), the order will be written to the feed, but the carrier will not be passed to the POHODA system, and the payment will be automatically set to "By order". ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/05.png) ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/06.png) ### VAT rates for order items If we receive a VAT rate for the ordered goods from the marketplace, we also display the given rate in the order feed. The feed shows the rate value for the given country along with a high or low flag (e.g., `high`) depending on whether it is a standard or reduced rate for the specific country. Make sure you have the correct VAT rates set up in your POHODA admin. {{% hint info %}} If your orders don't include a VAT rate, you can select the VAT rate in the campaign settings for individual marketplaces, either uniformly or by mapping it to a feed element. {{% /hint %}} ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/07.png) If we don't receive a VAT rate for goods in the order, the goods will be written to the order feed without a VAT rate. ## Basic settings in the POHODA system In the POHODA accounting unit, go to 'Settings -> Internet shops -> Internet shop settings': ![|602x279](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeWh0Kkg71ZBwIWpXKrhvO3dYvEt7XlefZvfdEbfArT_v14dAYCRKt3sw0aZxSjLo25iNRTMZd_eV_MAbfsfeOnueNVDQN1YxKlE9EqzkLreYuq2I0ecX11rYPQD2SOABaEQKLYIA?key=0yXv9pNy1FZs5Wz8wksuig) * Internet shop: select 'General internet shop' * 'General' tab: fill in at least the "Shop name" (e.g., the e-shop domain) ![|602x209](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfekQW6CrD_GcjCXVXxVUnpWi3ckbebr8FdSNOAcqyMUAe2I8U4F0Zkr1mFDC_P6W54elpZ__Z24bV23QHpYOupQJobERHcZICMjUvumd5J_vyhM9NSvdNkztbRK1OkEzhhW-5MhQ?key=0yXv9pNy1FZs5Wz8wksuig) * 'Settings' tab: check 'Maximum response time [s]' and increase the number to approximately 120 (for an average number of orders) ![|602x209](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcomj1oZsbJXdAylnGwJrSNi7Mlr7ZKAUu0U-ZVGMAGc_h-4u4eEcLoUZWk9lddkYX_9YrYTHWLb6fCuLFgDkrAYv366Sg1tTHahiDWNdKmC5DW2-noZsb1evSzxsZAgACzQi40pg?key=0yXv9pNy1FZs5Wz8wksuig) * 'WEB client' tab: check 'Web service requires authentication' and fill in the 'Username' and 'Password' that you entered in Mergado Marketplaces ![|602x209](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc7VzoRbVrrvJGG8VW76OA9PSLgKa7x-tWa5JPMqnQVRIMYMVW5paT5ypC49LIW25DMDmUSeNa68dMHjjSxN6kNdtknWDfivMxN1uMLJaoYACFgIESw86bdGPtERltf8aCBjsNw?key=0yXv9pNy1FZs5Wz8wksuig) * 'Import' tab: paste the feed URL copied from Mergado Marketplaces into the 'URL for Orders' field ![|602x256](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdoZlNnAp3Wjmkcke6xz39gxSQmH3broWhq62Uaci2qDVwctaO4-41DlmGrA4nli0q5my95DHedMnvb4Lx0us1-Ak9DXuxefameyQYpNPOpR_5f6cOUBlymMWh_06tayg_cXKayyg?key=0yXv9pNy1FZs5Wz8wksuig) {{% hint info %}} Don't forget to save the changed details! {{% /hint %}} {{% hint info %}} ⚠️ If you sell via marketplaces on international markets, you need to have foreign currencies enabled in the POHODA system. Instructions can be found [here](https://www.stormware.cz/prirucka-pohoda-online/nastaveni/cizi_meny/). {{% /hint %}} ## One-time order import 1) In the POHODA accounting unit, go to 'File -> Data communication -> Internet commerce'. ![|602x276](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfEBUBqoh8Ve_HOLcNwA0uYJeZ6E3sRwR42cLOtEU6-2tC_NGDzvbgw8J8QNtkdg2jwoiaJuf5RLat8XrL95wCtHKjMpXtPtomtVY9EPdsTXoukYuktbBvHDSoCCPkhixuwSbq0?key=0yXv9pNy1FZs5Wz8wksuig) 2) Select the internet shop and the 'Download from the internet' option: ![|440x341](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc0WWbEN_JNkvpna5_XKVgYSG_BWrlSe7QJzdtWuSkPpnJ8VaGMbYCp0Ag2xD-5omZvd9BfGD84MHOHksUTLt11Dh-zDBSwjIjK7tDdPHmzA99omqOCFp5n3TpTrmmrYxKpJTc4FA?key=0yXv9pNy1FZs5Wz8wksuig)![|440x341](https://lh7-rt.googleusercontent.com/docsz/AD_4nXekV-UWEFTxm5avI2MO5dtqiiJMlmRzO2mepoVod78aduvqYvPN1RZ8Z2e2nJSKjshHYdKxIYtk4xKl-x_ILJE3CW6qU7Kyvy5wj4wgVC06DJF3n2t-fAqMKbJ6LWK7H58UAEAtQg?key=0yXv9pNy1FZs5Wz8wksuig) 3) Check 'Received orders' -> 'all' (all orders from Mergado Marketplaces with the 'not shipped' status): ![|440x341](https://lh7-rt.googleusercontent.com/docsz/AD_4nXf6gxU5vHfKvRgYtqZnJjTQPDEvGUgDPSiivSeqmjSCOzg37k5ZLeba-iFrni7CZXgR2LCQhCai8m-1vgfq6EqNFfDOu9tNUdzCIjOYi7j8SUoLVd1j5GToT6ipNryNlrItud56BA?key=0yXv9pNy1FZs5Wz8wksuig)![|440x341](https://lh7-rt.googleusercontent.com/docsz/AD_4nXe_GL_Teo-D5TrqCZ2_7wNlYWUfv94-sDnTtadb_8zebzEGqoWbFpnDfUoqjmeePlOhfYV7JnKWhmosN_P8bXSJlyw4lY1FF-_7tdSzyFVvTdbJa51NHsDRwfp06XvKn5B_7srZUQ?key=0yXv9pNy1FZs5Wz8wksuig) 4) Click 'Next' to start the transfer -> if the transfer was successful, 'Status: OK' will be displayed: ![|440x341](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc6DgjUKS5hOzIl2EaWHjBJA5Ncb8xymjS7Nwmq1V0weuqag_2nvERb9jqYIzJ0UNCMZ971irT_YklCwqy3pC0tm8LHFGDjnzMEtCEQyX-slEypuZb60lU_xYwnECuZ30srGguscQ?key=0yXv9pNy1FZs5Wz8wksuig)![|440x341](https://lh7-rt.googleusercontent.com/docsz/AD_4nXf30WkzGR1iQpzl7_QXOgdZtt1P7ffFNp1hByuylWB5xOv_WA4Heq3vMthUKKX60CQXeQ0gXuE4xYYtAYM-KxFsNi1kZwZEwkG1JlgWILBRCo4HVGmLcokNVrPmc1JorZYkadkCGg?key=0yXv9pNy1FZs5Wz8wksuig) {{% hint info %}} ⚠️ **If an error occurred during the import, or if the import was incomplete, a link to a file will also appear in the window. Download this file and send us the document named "responseStatePohoda_XYZ" to support so we can determine the cause of the issue.** {{% /hint %}} 5) In the 'Invoicing -> Received orders' section, you can see the imported orders: ![|602x344](https://lh7-rt.googleusercontent.com/docsz/AD_4nXde5BB2ThSeHAoAfSnHqHH0msaeIiN4Qr47ET7qz9ow81duCA1yCR3pzG-_Dw1NO0f0vxURGIijzK4PH9LNuQQK7nRZA6zVhyaRIyUtbsbJRzXE_q9l5H4H3mUNUsG65MYA9dCKNA?key=0yXv9pNy1FZs5Wz8wksuig) ## Automatic order import With the POHODA E1 version, you can set up automatic order import as a scheduled task. The setup can be done as follows: 1) In the POHODA system, go to 'Settings – Internet shops – Internet shop settings': ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/08.png) 2) Click on 'Scenarios', then right-click on 'Shortcut' and select 'Create scenario': ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/09.png) 3) In the scenario settings, choose a name and description, then select the activity the scenario should perform. Finally, save the scenario. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/10.png) 4) The next step is creating automatic tasks. Click on 'File -> Accounting units' and select the accounting unit for which the tasks will be created. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/11.png) 5) In the menu, select 'Database' -> 'Automatic tasks': ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/12.png) 6) The first setting will be the activity configuration. Select the general internet shop, accounting unit, user and password (if needed), which internet shop it concerns, and which scenario you want to configure. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/13.png) ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/14.png) 7) In the 'Automatic task' field, set the name and description of the task and configure the scheduler. Select the frequency, first execution time, and its repetition. The longest period that can be set is 1 year. ![image](/images-mergado-marketplaces/import-objednavek-do-systemu-pohoda/15.png) {{% hint info %}} ℹ️ If you encounter any issues or have an idea for improvement, let us know at support [mergado@mergado.cz](mailto:mergado@mergado.cz) or on the forum. Thank you! {{% /hint %}}
--- ## [Creating a Shopify connection for Mergado Marketplaces](https://help.mergado.com/en/mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/) ## **Creating a Shopify connection for Mergado Marketplaces** This step-by-step guide explains how to create a Shopify app, set the required API permissions, and connect your Shopify store to Mergado Marketplaces for order synchronization. If you want to use order import for Shopify, you first need to create a Shopify connection in Mergado Keychain. {{% hint info %}} If you already have a connection to Mergado via API through a "custom app" in the Shopify admin in Mergado Keychain, you just need to update the list of permissions for that app in Shopify as described below. {{% /hint %}} This guide **strictly follows the official Shopify documentation and the current user interface** for creating apps using the **Shopify Developer Dashboard**. **Official sources:** https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard {{% hint info %}} You are creating a **custom API app for one specific e-shop**. The app **does not need to be** published to the Shopify App Store. {{% /hint %}} ## **1. Creating an app in Shopify** For Mergado Marketplaces to have API access to your Shopify account, you need to create an app with the required permissions: ### a) Open the Shopify Developer Dashboard You can access the Shopify Developer Dashboard in two ways: **Option A: Direct access** 1. Go to https://dev.shopify.com/ 2. Log in with your Shopify account 3. Open the **Apps** section in the left menu **Option B: Via the Shopify admin** 1. Open the **Shopify admin** of your e-shop 2. Go to **Settings** → **Apps** 3. Click on **Develop apps** 4. Click on **Build apps in Dev Dashboard** ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/01.png) --- ### b) Create a new app 1. Make sure you are in the **Apps** section 2. Click on **Create app** 3. Choose **Start from Dev Dashboard** 4. Enter the app name (e.g., `Mergado integration`) 5. Click on **Create** ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/02.png) After creating the app, you will be redirected to the **Versions** tab. --- ### c) Create an app version and set permissions (scopes) Every app must have at least one **version** to be installable in an e-shop. ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/03.png) --- ### d) Setting access permissions ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/04.png) 1. In the **Access** section, click on **Select scopes** 2. In the modal window, search for and check: {{% hint info %}} Required permissions for Mergado Marketplaces: * `read_customers` + `write_customers` * `write_orders` + `read_orders` * `read_products` * `read_shipping` + `write_shipping` * `write_order_edits` + `read_order_edits` {{% /hint %}} {{% hint info %}} And if you also want to import products into Mergado via API, add: * `write_products` * `read_products` * `read_markets` {{% /hint %}} 3. Confirm by clicking **Done** --- ### e) Publishing (releasing) the version 1. Scroll down on the page 2. Click on **Release** 3. In the confirmation window, you can leave the version name empty 5. Confirm by clicking **Release** ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/05.png) The app version is now published and ready for installation. --- ### f) Install the app in your e-shop ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/06.png) ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/07.png) 1. Open **Home** in the left menu 2. Click on **Install app** in the top right corner 3. Select the Shopify e-shop you want to connect with Mergado 4. You will be redirected to the Shopify admin 7. Confirm the installation by clicking **Install** The app is now installed in your e-shop. --- ### 2. Connecting Shopify in Mergado Keychain ![image](/images-mergado-marketplaces/creating-shopify-connection-for-mergado-marketplaces/08.png) To connect Shopify in Mergado Keychain, you need: * **Shopify URL:** * Open the **Shopify admin** of the connected e-shop * Open **Home** in the left menu * In the **Domains** section, copy the e-shop URL * Example: `your-store.myshopify.com` * **Shopify API access key**: * Return to the **Shopify Developer Dashboard** * Open your app * Go to **Settings** * In the **Credentials** section, copy the **Secret** value and paste it into Mergado Keychain --- ### 3. Activating orders in Mergado Marketplaces Go to the **Orders > Activation** section in Mergado Marketplaces, click on the Shopify icon, and save the changes. You can pause synchronization at any time on the activation page. Orders are synchronized every 5 minutes. {{% hint info %}} ℹ️ The order management system does not synchronize retroactively. So you don't need to worry about your system being flooded with all previous orders when you start it. {{% /hint %}} Done! 🎉 From now on, orders will be regularly transferred between your marketplaces and Shopify. --- ## [Connect Orders to Upgates with Mergado Marketplaces](https://help.mergado.com/en/mergado-marketplaces/connecting-orders-to-upgates-with-mergado-marketplaces/) # **Connecting Orders to Upgates with Mergado Marketplaces** In the Mergado Marketplaces extension, you can use **order management via Upgates**. If you run an e-shop on Upgates and sell on Allegro or Kaufland, you can now manage your orders directly in your e-shop administration. Below you will find the steps to set up order synchronization with Upgates. ### **How to activate the plugin in Upgates?** The first step is to activate our official plugin in your Upgates administration. In Upgates, go to the `Plugins` > `Plugin List` section and search for Mergado Marketplaces. After clicking `Activate`, you will see a notification with an overview of all the permissions our plugin needs for order synchronization. Click `Confirm`. ![image](/images-mergado-marketplaces/connecting-orders-to-upgates-with-mergado-marketplaces/01.png) 🔗 Link to the Mergado Marketplaces plugin: https://doplnky.upgates.cz/detail/mergado-marketplaces ### **How to create a connection in Mergado Marketplaces?** After activating the plugin in Upgates, you will see the next steps directly in Upgates. It is important to copy the API token, which you will find at the bottom of the page. Then paste this token in Mergado Marketplaces in the `Connections` section on the Upgates detail page into the `API Token` field and click `Save`. ![image](/images-mergado-marketplaces/connecting-orders-to-upgates-with-mergado-marketplaces/02.png) ### **How to set up synchronization in Mergado Marketplaces?** After a successful connection, the Upgates connection detail in Mergado Marketplaces will display a section for mapping Upgates language versions of your e-shop to marketplace sales channels. Consider which markets you will sell on via Allegro and Kaufland and prepare the corresponding language versions (`Settings` > `Basic` > `Languages`) and currency (`Settings` > `Basic` > `Currencies`) in your Upgates administration. ![image](/images-mergado-marketplaces/connecting-orders-to-upgates-with-mergado-marketplaces/03.png) Once you have filled in the language versions, you can map the following for each market: * **Statuses** from Mergado Marketplaces to your order statuses in Upgates * If you do not map order statuses, new orders will be created in Upgates with the `Received` status and further status changes will not be taken into account. * **Payment and shipping methods** to your values in Upgates * In this section, shipping and payment method values are dynamically loaded based on incoming orders. It is therefore advisable to check this section regularly and map any new values that may have appeared. * If you do not map shipping and payment methods, we will send the payment and shipping method to Upgates in the format we receive them from the marketplace. **⚠️ Please pay attention to at least mapping language versions and order statuses. Without mapping them, order synchronization will not work optimally.** {{% hint info %}} ℹ️ **VAT Rate** To create an order in Upgates, it is mandatory to specify the VAT rate for order items. You can set the VAT rate in the settings of individual campaigns for both Allegro and Kaufland. If you do not have the VAT rate filled in for your offers, the standard VAT rate for the given country will be used. {{% /hint %}} ### How to activate orders? Once everything is ready, you can activate order synchronization for Upgates in the `Orders` > `Activation` section. For order synchronization to work correctly, orders must also be activated for at least one marketplace. {{% hint info %}} 💡 **How do you know it is a marketplace order?** For each order, we send `Mergado Marketplaces import` as an internal note on the order detail in Upgates. In the `Advanced` section, you will find the marketplace order ID under `External Order Number`. {{% /hint %}} ## Frequently Asked Questions **What happens if I don't map order statuses?** New orders will be created in Upgates with the `Received` status and further status changes on the marketplace will not be transferred to Upgates. **Is it necessary to set a VAT rate?** Yes, specifying the VAT rate for order items is mandatory when creating an order in Upgates. If you don't have it filled in, the standard VAT rate for the given country will be used. **How do I recognize a marketplace order in Upgates?** Each marketplace order contains an internal note `Mergado Marketplaces import` and the marketplace order ID can be found under `External Order Number` in the `Advanced` section. **Do I need to activate orders for the marketplace as well?** Yes, for order synchronization to work correctly, orders must be activated both for Upgates and for at least one marketplace (Allegro or Kaufland). **What if I don't map shipping and payment methods?** Mergado Marketplaces will send the payment and shipping method to Upgates in the format received from the marketplace. We recommend checking this section regularly and mapping any new values. --- 🔗 For more information, see [Order Management in Mergado Marketplaces](https://help.mergado.com/en/mergado-marketplaces/order-management-in-mergado-marketplaces/) or the guides for creating campaigns on [Allegro](https://help.mergado.com/en/mergado-marketplaces/how-to-create-campaign-and-upload-products-to-allegro/) and [Kaufland](https://help.mergado.com/en/mergado-marketplaces/how-to-create-campaign-and-upload-products-to-kaufland/). --- ## [What is the Keychain extension and how to set it up?](https://help.mergado.com/en/mergado-keychain/what-is-keychain-extension-and-how-to-set-it-up/) # **What is the Keychain extension and how to set it up?** [Mergado Keychain](https://store.mergado.com/detail/mergadokeychain/#about) is an extension that **connects your Mergado account with external systems** such as Heureka, Zboží.cz, Google Analytics, Shopify, and many others. It works as a **secure key** — a place where you store your login credentials for these platforms, and Mergado can then automatically pull the necessary data for other extensions like [Bidding Fox](https://store.mergado.com/detail/biddingfox.dev/#about) or [Pricing Fox](https://store.mergado.com/detail/pricingfox/#about), or for generating statistics and analyses. Once you connect your accounts from other platforms, you don't need to enter login credentials every time. Mergado connects to the platforms automatically and keeps access up to date. ## **Why you need Mergado Keychain** You need Keychain when you decide to **use [Mergado extensions](https://store.mergado.com/) that work with data from external platforms** you use. For example, if you decide to bid on Heureka using the Bidding Fox extension, you need to set up the Heureka connection in Keychain for Bidding Fox to work properly. You also need to set up a Keychain connection if you want to track sales statistics and analyses on the **Analytics** tab of your projects for Heureka or Zboží.cz. This ensures that Mergado Editor and its extensions can **work with up-to-date data from external sources** — without manual login or file uploads. **Thanks to Keychain:** * all your **connections and access credentials are in one place**, * **you don't need to repeatedly enter** access credentials for external platforms into individual extensions, * your data from Heureka, Zboží.cz, Google Analytics, and other systems **syncs automatically**, * all connections are **encrypted and secure** — your access credentials are not visible even to our technical support team. The extension is **completely free** for all users and is **automatically activated** when you create a project in Mergado. You then need to complete the connection to a specific platform by **entering your access credentials**. Learn what each connection in Mergado Keychain is used for in this article. ## **How Mergado Keychain works** After you enter your login credentials for the selected external system (e.g. Heureka) in Keychain, it **stores them, encrypts them securely, and makes them available only to Mergado Editor and its selected extensions**. This allows Mergado and its selected extensions to **load campaign performance data**, track clicks, revenue and conversions, check credit balances on comparison shopping engines, or work with exports and statistics from your accounts. ## **How to activate Mergado Keychain** Keychain is **automatically activated** for each of your online stores when you create a project in Mergado — no manual setup is needed. Set up connections with individual platforms **as follows**: 1. On the **[main page](https://app.mergado.com/) of Mergado Editor**, click the **online store** for which you want to set up a Keychain connection with an external system. 2. On the **left sidebar**, you'll see a list of your active extensions. Click **Mergado Keychain**. 3. In the **Connections** section, select the **platform** from the list (e.g. Heureka, Zboží.cz, Google Analytics, or Shopify) for which you want to create a connection, and click **Create**. 4. Fill in the **required details** and click **Log in**. In the **Sources** section, you can also connect a **static XML file** to Mergado through Keychain. This lets Mergado process advanced information such as cost of goods or profit calculations. ## **How to solve the most common issues** ### **1. Keychain reports a connection error** This most commonly happens because **the password was changed on the platform, due to a temporary service outage on the platform's side, or because the connection has expired** (typically after a long period of inactivity or a change in the platform's security policies). In this case, **cancel the existing connection in Keychain, restore the login**, and confirm access again. ### **2. Connection doesn't work after changing the Heureka password** After every **password change**, you need to **renew the connection in Keychain** — log out and log back in with the new credentials. ### **3. Connection can't be restored** If the connection repeatedly fails, try: 1. logging in using an incognito browser window, 2. clearing your browser cache, 3. verifying that the login credentials work directly on the platform. ## **FAQ** ### **What is Mergado Keychain?** Mergado Keychain is an extension that connects your Mergado account with external platforms such as Heureka, Zboží.cz/Sklik, Google Analytics, or Shopify. It securely stores your login credentials so that Mergado Editor and its extensions (e.g. Bidding Fox or Pricing Fox) can work with the necessary data from the platforms you use. ### **Do I need Keychain if I only use Mergado Editor?** If you only work with Mergado Editor for feed editing, Keychain isn't always essential. However, if you want to track sales statistics and analyses on the **Overview** or **Analytics** tabs for your Zboží.cz or Heureka projects, you need to set up a connection in Keychain. A Keychain connection is also required when creating a project where you use data from your online store running on platforms like Shopify or UNAS as the product data source. A Keychain connection is essential for using extensions like Pricing Fox, Bidding Fox, or Mergado Marketplaces. ### **Is Mergado Keychain paid?** No. The Mergado Keychain extension is free for Mergado Editor users and is activated automatically when you create a project. ### **How do I know if I have Keychain activated?** In Mergado, on the [User details](https://app.mergado.com/user/details/) page, go to the **Extension access** section. In the **For online stores** column, you'll see **Mergado Keychain**, which is activated automatically when you create a project. Clicking Mergado Keychain shows you the list of online stores where Keychain is active (meaning the online stores under which you have projects). From there, you can navigate directly to a specific online store where you want to set up a connection. ### **How do I create a connection with Heureka or Zboží.cz?** 1. On the [main page](https://app.mergado.com/) of Mergado Editor, click the online store for which you want to set up a Keychain connection with an external system. 2. On the left sidebar, you'll see a list of your active extensions. Click Mergado Keychain. 3. In the Connections section, select the platform from the list (e.g. Heureka, Sklik API Fénix, Google Analytics, or Shopify) for which you want to create a connection, and click Create. 4. Fill in the required details and click Log in. ### **Can I connect Sklik through Keychain?** Yes. If you want to give Mergado access to data from Sklik/Zboží.cz, set up the Sklik API Fénix connection in Keychain. ### **What should I do if Keychain disconnects or reports a connection error?** This most commonly happens due to a password change on the external platform, a temporary service outage, or connection expiration (e.g. after a long period of inactivity). In this case, cancel the existing connection in Keychain, log in again, and confirm access. ### **The connection stopped working after I changed my Heureka password. What should I do?** After every credential change, you need to re-create the connection in Keychain — log out and log back in with the new credentials. This applies not only to Heureka but to all other external systems you have connected in Keychain. ### **I can't restore the connection in Keychain. What else can I try?** Try these steps: * log in using an incognito browser window, * clear your cache and cookies, * for Heureka, verify that your login credentials work directly in the Heureka admin panel. ### **Are my login credentials safe?** Yes. All credentials you enter into Keychain are encrypted and securely stored. They are not visible even to Mergado's technical support team. --- ## [Mergado Keychain Connections Explained](https://help.mergado.com/en/mergado-keychain/what-are-individual-connections-in-mergado-keychain-used-for/) # **What are the individual connections in Mergado Keychain used for?** ## **1. Sklik API Fénix** Create the Sklik API Fénix connection if you use extensions that need **access to data from Zboží.cz/Sklik**, i.e. data related to advertising on **Seznam Nákupy**. Create this connection even if you don't use any extensions but want to track **advertising cost trends or clicks** in easy-to-read charts on the **Analytics** page of your project. The data collected is used exclusively for analytical and optimization purposes. Mergado **does not gain access to personal customer data** or individual order details. ### **Extensions that require a Keychain connection for Sklik data access** * **[Pricing Fox](https://store.mergado.com/detail/pricingfox)** — For Pricing Fox to retrieve and process competitor data (price, stock availability, bidding position, gifts included with purchase, manufacturers, categories), and to get product performance statistics, you need to create a connection by adding Sklik API Fénix to Keychain. * **[Bidding Fox](https://store.mergado.com/detail/biddingfox)** — For Bidding Fox to retrieve and process data about product card positions, product and shipping prices, competitor availability, and product performance statistics, you need to create a connection by adding Sklik API Fénix to Keychain. * **[Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements)** — For Bidding Fox Elements to retrieve and process advertising performance statistics, you need to create a connection by adding Sklik API Fénix to Keychain. ### **How to create a connection in Keychain** 1. In Keychain, find **Sklik API Fénix** in the **Connections** menu and click **Create**. 2. Enter the **Shop ID** and **API Fénix key**, which you can obtain from your **Sklik account**. You can find the exact steps for [generating the API Fénix key in the Sklik help pages](https://napoveda.sklik.cz/pokrocila-prace-s-daty/sklik-api/#api-fenix-klic). * To generate the API key, you must log in to Sklik directly with the account and password for which you want to generate the key. Logging in as an Account Administrator is not sufficient. 3. Click **Save** to create the connection. ## **2. Heureka** Create the Heureka connection if you use extensions that need access to Heureka data. Create this connection even if you don't use any extensions but want to track your advertising performance on Heureka on the **Analytics** tab. You'll find statistics and charts for: * revenue, * advertising costs, * clicks, * conversions, * profit, * products with statistics, * conversion rate, * average CPC, * average CPO, * average PNO, * average conversion value, * average conversion profit. Creating a Keychain connection also expands the **Overview** tab with statistics for: * product pairing rate, * number of online stores on a product card, * number of clicks, * orders, * revenue. After creating a Keychain connection, Mergado will have access to **selected statistical data** from your Heureka account. Specifically: ### **Performance data** * number of clicks * click costs (CPC) * number of orders * revenue * profit and cost-to-revenue ratio (PNO) * number of products included in statistics * number of products without available statistical data ### **Account status information** * credit balance and status * information about active PPC mode * certification information (e.g. Verified by Customers) * whether the shop responds to customer inquiries * product XML feed availability * contact details listed in Heureka admin * shop logo * number of international account variants ### **Summary account statistics** * total costs * total number of clicks The collected data is used exclusively for **statistical purposes, product performance evaluation, and campaign optimization**. Mergado **does not gain access to personal customer data** or individual order details. ### **Extensions that require a Keychain connection for Heureka data access** * **[Pricing Fox](https://store.mergado.com/detail/pricingfox)** — For Pricing Fox to retrieve and process competitor data (price, stock availability, bidding position, gifts included with purchase, manufacturers, categories), you need to create a Keychain connection and enter the Heureka API key directly in the Pricing Fox extension. * **[Bidding Fox](https://store.mergado.com/detail/biddingfox)** — For Bidding Fox to retrieve data from the Heureka Assortment Report and process advertising performance statistics and current product card information, you need to create a Keychain connection and enter the Heureka API key directly in the Bidding Fox extension. * **[Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements)** — For Bidding Fox Elements to retrieve data from the Heureka Assortment Report and process advertising performance statistics, you need to create a Keychain connection and enter the Heureka API key directly in the Bidding Fox Elements extension. * **[Pricing Rank](https://store.mergado.com/detail/pricingrank)** — For Pricing Rank to retrieve and process data from the Heureka Assortment Report, you need to create a Keychain connection. * **[Heureka Watchdog](https://store.mergado.com/detail/heurekawatchdog)** — For Heureka Watchdog to detect unpaired products, find products that are alone on cards, or discover other issues preventing advertising, you need to create a Keychain connection. * **[Pricing Monitor](https://store.mergado.com/detail/pricingmonitor)** — For Pricing Monitor to track and analyze your product prices compared to competitors, you need to create a Keychain connection. * **[Credito](https://store.mergado.com/detail/credito)** — For Credito to check your credit balance, you need to create a Keychain connection. ### **How to create a connection in Keychain** 1. In Keychain, find **Heureka** in the **Connections** menu and click **Create**. 2. Enter the same **login credentials (email and password)** you use to log in to your **Heureka account admin panel**. * If you **change your login credentials** in your Heureka account, **don't forget to update them here as well** — otherwise Keychain will report a connection error. Delete the connection and recreate it with the new credentials. 3. Choose whether you want to create a connection for **Czech or Slovak Heureka**. 4. Click **Save** to create the connection. ## **3. Google Analytics 4** Create this connection if you use extensions that need **access to Google Analytics 4 data**. Create this connection even if you don't use any of the following extensions but want to track your advertising analyses and performance on the **Analytics** and **Overview** tabs of your projects. Specifically, Mergado will display collected data about: * number of visits/clicks, * number of orders, * total order value. ### **Extensions that require a Keychain connection for Google Analytics 4 data access** * **[Pricing Fox](https://store.mergado.com/detail/pricingfox)** * **[Bidding Fox](https://store.mergado.com/detail/biddingfox)** * **[Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements)** * **[Fox Data+](https://store.mergado.com/detail/foxplus)** ### **How to create a connection in Keychain** 1. In Keychain, find **Google Analytics 4** in the **Connections** menu and click **Create**. 2. Log in with your **Google account** and **approve Mergado's access** to your data to create the connection. ## **4. Google Sheets** This connection allows you to **export the output feed from Mergado to Google Sheets** on your Google Drive. ### **How to create a connection in Keychain** 1. In Keychain, find **Google Sheets** in the **Connections** menu and click **Create**. 2. Log in with your **Google account** and **approve Mergado's access** to your data to create the connection. If you need to **import data from your Google Sheets into Mergado** instead, you don't need to create a Keychain connection — you just need to [properly set up sheet sharing as CSV](https://support.google.com/docs/answer/183965?hl=cs) for the selected spreadsheet. ## **5. Shopify** Create this connection if **you run your online store on the Shopify platform and want to get your product data into a project** in Mergado Editor. You'll also need this connection if you decide to use the **[Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) extension**. The connection allows [Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) to **sync orders** from online marketplaces and automatically transfer them to your online store every 5 minutes, where you can conveniently manage them alongside your regular online store orders. To create a Keychain connection, you'll need a **Client ID** and **Client Secret**. You can find how to generate these Shopify API credentials in the article New project - Generating Shopify API credentials. ### **How to create a connection in Keychain** 1. In Keychain, find **Shopify** in the **Connections** menu and click **Create**. 2. Fill in the **Shopify Store URL for Admin API**. * This is not the regular URL of your online store. It's the **Shopify store address for API communication**. This address is in the format *store-name.myshopify.com*. * You can find the store-name in the **Shopify admin** URL. Example: admin.shopify.com/store/{store-name}/ 3. Fill in the **Client ID**. 4. Fill in the **Client Secret**. 5. Click **Log in** to create the connection. ## **6. UNAS** Create this connection if **you run your online store on the UNAS platform and want to get your product data into a project** in Mergado Editor. You'll also need this connection if you decide to use the **[Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts) extension**. The connection allows Mergado Marketplaces to **sync orders** from online marketplaces and automatically transfer them to your online store every 5 minutes, where you can conveniently manage them alongside your regular online store orders. To create a Keychain connection, you'll need an **API key**. You can find how to generate the required API key in UNAS in the article How to connect the UNAS online store platform to Mergado Editor. ### **How to create a connection in Keychain** 1. In Keychain, find **UNAS** in the **Connections** menu and click **Create**. 2. Fill in the **Shop name (ID)**. 3. Fill in the **API key**. 4. Click **Save** to create the connection. --- ## [What IP addresses does Mergado and its extensions use?](https://help.mergado.com/en/security-and-technical-requirements/what-ip-addresses-does-mergado-use/) # **What IP addresses does Mergado and its extensions use?** ## **Why you should know Mergado's IP addresses** If your online store or server that provides **data feeds is protected and you verify access using an IP address whitelist** (i.e. you only allow access from specific addresses), you need to know **which IP address Mergado and its extensions use to access your feed**. If you don't allow these IP addresses, Mergado won't be able to download your feed and the extensions won't work correctly. ## **What is Mergado's IP address** For **Mergado Editor** itself to work, just allow the following IP address: > **81.31.39.112** ## **What are the IP addresses of Mergado extensions** If you decide to start using any of the Mergado **extensions** available in the [Mergado Store](https://store.mergado.com/?lang=cs), you also need to add the corresponding **extension's IP address** to your whitelist: |Extension|IP address| | --- | --- | |[Bidding Fox](https://store.mergado.com/detail/biddingfox/?lang=cs#about)|81.31.39.116| |[Bidding Fox Elements](https://store.mergado.com/detail/biddingfoxelements/?lang=cs#about)|81.31.39.116| |[Blending Bull](https://store.mergado.com/detail/blendingbull/?lang=cs#about)|178.238.44.169| |[Credito](https://store.mergado.com/detail/credito/?lang=cs#about)|178.238.44.138| |[Feed Image Editor](https://store.mergado.com/detail/feedimageeditor/?lang=cs#about)|81.31.39.116| |[Fox Data+](https://store.mergado.com/detail/foxplus/?lang=cs#about)|81.31.39.116| |[Heureka Watchdog](https://store.mergado.com/detail/heurekawatchdog/?lang=cs#about)|178.238.44.138| |[Kvinono](https://store.mergado.com/detail/kvinono/?lang=cs#about)|81.31.39.114| |[Mergado Agencies](https://store.mergado.com/detail/mergadoagencies/?lang=cs#about)|81.31.39.114| |[Mergado Dashboards](https://store.mergado.com/detail/mergadodashboards/?lang=cs#about)|81.31.39.114| |[Mergado Drive](https://store.mergado.com/detail/mergadodrive/?lang=cs#about)|178.238.44.165| |[Mergado Files](https://store.mergado.com/detail/files/?lang=cs#about)|178.238.44.163| |[Mergado Keychain](https://store.mergado.com/detail/mergadokeychain/?lang=cs#about)|81.31.39.112| |[Mergado Logbook](https://store.mergado.com/detail/logbook/?lang=cs#about)|178.238.44.138| |[Mergado Marketplaces](https://store.mergado.com/detail/ordelogyproducts/?lang=cs#about)|81.31.39.114| |[Mergado Notifications](https://store.mergado.com/detail/mergadonotifications/?lang=cs#about)|81.31.39.114| |[Mergado Orders](https://store.mergado.com/detail/mergadoorders/?lang=cs#about)|81.31.39.114| |[Mergado Pages](https://store.mergado.com/detail/pages/?lang=cs#about)|178.238.44.138| |[Mergado Sources](https://store.mergado.com/detail/clickinggoat/?lang=cs#about)|81.31.39.114| |[Mergado ToDo List](https://store.mergado.com/detail/todo/?lang=cs#about)|178.238.44.138| |[Mergado Translate](https://store.mergado.com/detail/ordelogytranslate/?lang=cs#about)|81.31.39.114| |[Pairing Bear](https://store.mergado.com/detail/pairingbear/?lang=cs#about)|81.31.39.112| |[PPC Wolf](https://store.mergado.com/detail/ppcwolf/?lang=cs#about)|178.238.44.164| |[Pricing Fox](https://store.mergado.com/detail/pricingfox/?lang=cs#about)|81.31.39.116| |[Pricing Monitor](https://store.mergado.com/detail/pricingmonitor/?lang=cs#about)|178.238.44.138| |[Pricing Rank](https://store.mergado.com/detail/pricingrank/?lang=cs#about)|178.238.44.138| |[Repairman](https://store.mergado.com/detail/xmlrepairman/?lang=cs#about)|178.238.44.138| |[Scraping Camel](https://store.mergado.com/detail/scrapingcamel/?lang=cs#about)|178.238.44.145| |[Seznam Index Checker](https://store.mergado.com/detail/seznamindexchecker/?lang=cs#about)|178.238.44.138| |[Symlink Stork](https://store.mergado.com/detail/symlinkstork/?lang=cs#about)|178.238.44.138| |[URL Checker](https://store.mergado.com/detail/urlchecker/?lang=cs#about)|178.238.44.138| ## **FAQ** ### **Why do I need to know Mergado's IP address?** If your input feed is protected by an IP address whitelist, you must add Mergado's IP address to the allowed list. Otherwise, Mergado won't be able to access your data and the project can't be processed. ### **What should I do if my feed is whitelisted and Mergado can't download it?** If your input feed is secured with an IP address whitelist, it means only pre-approved IP addresses can access the feed. For Mergado to load the feed, its IP address must be on the allowed list. Add 81.31.39.112 to your whitelist. If you also use Mergado extensions, check whether their IP addresses need to be added as well (if they differ from Mergado's IP address). ### **Do I only need to allow one IP address, or do I need to add all of them?** If you only use Mergado Editor (without extensions), allowing 81.31.39.112 is sufficient. However, if you use extensions (e.g. Bidding Fox, Pricing Fox, Feed Image Editor), you also need to add their IP addresses to the whitelist. ### **What should I do if Mergado reports that the feed couldn't be downloaded?** Check the following: 1. Whether IP address 81.31.39.112 is listed in your online store's whitelist. 2. Whether the server isn't blocking access due to SSL or a certificate issue. 3. That the feed isn't protected by multiple methods at the same time (e.g. whitelist + hash, which is a common mistake with Shoptet feeds). ### **Do Mergado's IP addresses change often?** No. Mergado's IP addresses are stable and changes happen only rarely. In case of a change, we always publish the information in advance. ### **How do I verify that Mergado is actually downloading my feed?** In your Mergado project, go to the History page and filter the Event type column by Download. You'll see records of every feed download attempt including the time and IP address. This helps you verify whether access is working correctly. --- ## [Can I secure the output feed in Mergado?](https://help.mergado.com/en/security-and-technical-requirements/can-i-secure-the-output-feed/) # **Can I secure the output feed in Mergado?** ## **Why secure your output feed** The output feed from Mergado contains all the data you send to advertising platforms (e.g. Heureka, Google, or Facebook) after editing. Although this feed is typically only read by the platform you share it with, it's understandable that you want to **protect your advertising data** and keep unauthorized people out. ## **How Mergado protects output feeds** Mergado doesn't support password-protecting output feeds (HTTP authentication), but access to output feeds is naturally restricted thanks to their unique and undiscoverable URLs. ### **1. Long hash in the URL** Every output feed generated by Mergado has a **unique URL containing a long security key (hash)**. This hash is impossible to guess, making the feed not publicly discoverable or indexable by search engines. Your output feed URL will look something like this: *https://data.mergado.com/12345/export_87f14aab7e9d4c21.xml* **Only those you share the URL with** (e.g. the advertising platform the output feed is intended for) will know the address. ### **2. Access via secure HTTPS** All communication between Mergado and target platforms uses the **encrypted HTTPS protocol**, so feed data **cannot be read or intercepted during transfer**. ### **3. Access logging** Mergado **records the history of feed downloads** (including date, time, IP address, and server response). This lets you monitor whether only expected platforms are downloading the feed, or whether someone unauthorized is accessing it. You can find download information on the **History** page of each project, where you can filter recorded events to show only **Downloads** and see when and who downloaded the output feed. > **Tip!** For easier searching, we recommend downloading the filtered download history as a CSV file and opening it in Excel, where you can search for specific user agents, group data, or apply additional filters. ### **4. Protection via the Symlink Stork extension** If you want full control over who can access your output feed, you can use the **[Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about) extension**. It lets you **allow access to your output feed URL only from selected IP addresses**. Learn more about Symlink Stork and this feature here. ## **How to get a new output feed URL for an existing project** In Project Settings, you can **generate a new security key (hash) for the existing URL**. This changes the 32-character random string in the original URL. **To generate a new hash:** 1. In the selected project, go to the **Settings** page. 2. Next to the **Output feed** field, click the pencil icon. 3. Check the **I know what I'm doing** checkbox. 4. Confirm by clicking **Generate new URL**. 5. The output URL change takes effect **after the next data export**. * If you don't want to wait for automatic regeneration, run the export manually. Go to the **Settings** page, click the **Regeneration** tab, and click **Run export**. Once the export finishes, you'll see the updated output feed URL on the **Overview** page. > **Tip!** Changing the output feed URL affects all connected services. Don't forget to **check the services where you use this URL and update it wherever needed**. Another option for getting a completely new output feed URL is to **duplicate the project and then delete the original**. During duplication, **most information is carried over** from the original project, but a new unique output feed URL is created for the duplicate. You can then delete the original project (which also removes its output feed URL) and replace the original URL on advertising channels with the new one. Learn more about project duplication in this article. ## **FAQ** ### **Is it possible to password-protect the output feed?** No, output feeds in Mergado can't be password-protected (e.g. via HTTP authentication). However, they are protected by their unique URL, which cannot be guessed or publicly found through search engines. ### **How is the output feed protected?** Each output feed has its own unique URL containing a long security key (hash). This makes the feed non-indexable, and only those you share the link with (e.g. Heureka, Google, Facebook) know the address. Additionally, Mergado transfers all data via the encrypted HTTPS protocol, so it can't be read during transfer. ### **Can I find out who is downloading the output feed?** Yes. On the History page of each project, you can view feed download records — when downloads occurred, from which IP address, and what server response was returned. This lets you check whether only expected systems (e.g. Heureka, Google) are downloading the feed, or if someone else is accessing it. You can also filter and export the download history to CSV for further analysis. ### **What if I want the output feed to have a new URL?** You can get a new output feed URL in two ways: **1. Generate a new security key (hash):** In the project, go to **Settings** and next to the **Output feed** field, click the pencil icon. Check **I know what I'm doing** and confirm by clicking **Generate new URL**. This changes the 32-character security key in the original URL. The URL change takes effect after the next data export. If you don't want to wait for automatic regeneration, you can run the export manually in **Settings** → **Regeneration** → **Run export**. Once the export finishes, you'll find the updated URL on the **Overview** page. *Tip: The URL change affects all services that use this address (e.g. advertising platforms or analytics systems). Don't forget to update it in those places.* **2. Duplicate the project:** If you need a completely new URL, you can duplicate the project. The new project keeps most settings but gets a new unique output feed URL. You can then delete the original project, removing its output feed URL, and replace it with the new address on advertising channels. Learn more about project duplication in this article. ### **Why doesn't Mergado support traditional password protection?** Password protection would prevent direct access for advertising systems (e.g. Heureka or Google), which connect to the feed automatically and can't enter login credentials. A unique URL with a hash is therefore a safer and more universal solution that doesn't limit your campaign functionality. ### **Can I restrict output feed access to specific IP addresses?** Yes, you can. If you want only specific servers to access your output feed, use the [Symlink Stork](https://store.mergado.com/detail/symlinkstork/#about) extension. It lets you set up access so that only selected IP addresses can reach the output feed — all other access attempts will be blocked. This gives you maximum control over who can download your data. --- ## [Can Mergado download secured feeds?](https://help.mergado.com/en/security-and-technical-requirements/can-mergado-download-secured-feeds/) # **Can Mergado download secured feeds?** Want to make sure nobody unauthorized gets access to your product data, but also need Mergado to reach them? You don't have to compromise between security and easy data management. Here's how to make **Mergado work with your secured input feed**. ## **Input feed security options** ### **1. HTTP authentication (username + password)** If your feed is **password-protected**, Mergado can load it only if you **include the login credentials in the feed URL**. Enter the feed into Mergado in this format: ***https://username:password@www.your-eshop.com/feed.xml* (where the part after the @ sign is your feed URL)**. **a. Creating a new project** When creating a new project, enter the input feed URL in the format *https://username:password@www.your-eshop.com/feed.xml* **b. Securing the input feed of an existing project** If you've decided to password-protect a previously unsecured input feed of an existing Mergado project, simply **replace the original input feed URL** with the URL in the format *https://username:password@www.your-eshop.com/feed.xml* **Replace the input feed in Project Settings:** * In Mergado, go to the **project** where you used the feed you've now secured with a password. * Click on **Settings** in the left menu. * In the **General project settings** tab, replace the original URL in the **Input feed** field with the URL in the format *https://username:password@www.your-eshop.com/feed.xml* * Click **Save**. * We recommend **regenerating the project** afterwards. * On the same **Settings** page, click the **Regeneration** tab and then **Regenerate all** and check the output data. ### **2. IP address restriction (whitelist)** If your feed is protected by a **whitelist** — meaning it's accessible only from specific pre-approved IP addresses — you need to add **Mergado's IP address** to the whitelist (the list of allowed IP addresses). Mergado downloads your input feed from this IP address: > **81.31.39.112** ### **3. Security via hash (secret key in the URL)** Your feed might be secured with a **hash** — a long string of characters that acts as an access key. This means the feed isn't publicly discoverable, but **Mergado can load it without any issues**. Just enter the input feed URL containing the hash into Mergado. For example: *https://www.your-eshop.com/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a* If you've decided to secure the input feed with a hash on an already existing Mergado project, simply **replace the current input feed URL** with the URL containing the hash. **Replace the input feed in Project Settings:** * In Mergado, go to the **project** where you used the feed you've now secured with a hash. * Click on **Settings** in the left menu. * In the **General project settings** tab, replace the original URL in the **Input feed** field with the URL in the format *https://www.your-eshop.com/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a* * Click **Save**. * We recommend **regenerating the project** afterwards. * On the same **Settings** page, click the **Regeneration** tab and then **Regenerate all** and check the output data. ## **Securing Shoptet feeds** Having trouble with **Mergado not downloading your input feed from Shoptet**? The issue is likely in the **security settings**. **Shoptet's admin panel offers two ways to secure XML feeds:** a. IP address restriction (whitelist) b. Hash-based security Mergado can handle either method, but problems occur when **both are enabled at the same time**. You need to **enable only one security method in your Shoptet admin** and then either add Mergado's IP address to the whitelist or enter the feed URL with the hash into Mergado. **How to fix it:** 1. Log in to your **Shoptet account**. 2. In the admin panel, click **Integrations** in the left menu, then **XML feeds**. 3. Click the **Security** tab. 4. In the **Access protection** section, check only one security method. 5. **Save** the settings. ## **FAQ** ### **Can Mergado handle a password-protected feed?** Yes. Mergado can load a feed protected with a username and password (HTTP authentication). Just enter the input feed URL in the format: https://username:password@www.your-eshop.com/feed.xml If you added the password after creating the project, replace the original URL with the new one in Project Settings. ### **Can I add password protection to an existing project's input feed?** Yes. If you've decided to protect the input feed with a password, you need to replace the original input feed URL with one that includes the username and password. The new URL will be in the format: https://username:password@www.your-eshop.com/feed.xml Replace the input feed URL as follows: 1. In Mergado, go to the project where you used the feed you've now secured with a password. 2. Click Settings in the left menu. 3. In the General project settings tab, replace the original URL in the Input feed field with the URL in the format https://username:password@www.your-eshop.com/feed.xml 4. Click Save. 5. In the Regeneration tab, click Regenerate all and verify that the data loads correctly. ### **Can I secure an existing project's input feed with a hash?** Yes. If you've decided to protect the input feed with a hash, you need to replace the original input feed URL with one that includes the hash. The new URL will be in the format: https://www.your-eshop.com/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a Replace the input feed URL as follows: 1. In Mergado, go to the project where you used the feed you've now secured with a hash. 2. Click Settings in the left menu. 3. In the General project settings tab, replace the original URL in the Input feed field with the URL in the format https://www.your-eshop.com/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a 4. Click Save. 5. In the Regeneration tab, click Regenerate all and verify that the data loads correctly. ### **My feed only allows access from certain IP addresses. What do I do?** If you use a whitelist to secure your feed, you need to add Mergado's IP address. Mergado downloads feeds from IP address: 81.31.39.112 ### **My feed is secured with a hash. Can Mergado download it?** Yes. Just enter the full URL including the hash into Mergado (e.g.: https://www.your-eshop.com/feed.xml?hash=8c3b71f08f8b0e3b0a9a7a). Mergado will recognize the hash and load the feed without any issues. ### **Mergado won't load my feed from Shoptet. What should I do?** Check the security settings in your Shoptet admin panel. Shoptet offers two types of protection: * IP address restriction (whitelist), * hash-based security. If both methods are active at the same time, Mergado can't access the feed. Keep only one method enabled and then either add Mergado's IP address to the whitelist or enter the URL with the hash into Mergado. Steps in Shoptet: 1. Log in to the admin panel. 2. Click Integrations → XML feeds → Security. 3. In the Access protection section, check only one security method. 4. Save the settings. --- ## [Access to the demo environment](https://help.mergado.com/en/for-developers/access-to-demo-environment/) # **Access to the demo environment** This guide walks you through **creating your own app for the Mergado Store**, connecting it to the Mergado API, and safely testing it directly in Mergado without having to pay. Mergado allows developers to build custom integrations ("apps") that extend the editor's functionality or communicate with its API. There is no official "demo environment" with preloaded data — instead, you'll set up your own test project in just a few steps. ## **Step-by-step guide** ### **1) Create a Mergado account** If you don't have an account yet, create one at **app.mergado.com**. ### **2) Create your own app** 1. Open: **[https://app.mergado.com/developers/create-app/](https://app.mergado.com/developers/create-app/)** 2. Fill in the basic app details. 3. After creation, you'll get access credentials (specifically, access to entities where the app is enabled). ### **3) Set up a test project *(if your app works at the project level)*** 1. Create a **new project** in Mergado for testing. 2. Upload a **test feed** — a **small feed** with a few products is enough. 3. In the **project settings**, switch the project to **test mode** so you **don't have to pay** for testing. ### **4) Enable the app on the project** In the **project settings**, enable (turn on) your app. This gives it access to the **entities** (feeds/projects) it has permission to read and modify. ### **5) Authorization and API calls** * Authorization process: **[https://mergado.github.io/docs/api/authorization.html](https://mergado.github.io/docs/api/authorization.html)** * API documentation: **[https://mergado.docs.apiary.io/#](https://mergado.docs.apiary.io/#)** > **Note about the API version:** The version you use affects endpoint behavior. If the version doesn't match, behavior may differ from the documentation. ## **Tips for efficient testing** * **There is no central demo shop** — each developer sets up their own test project. * **Test mode** ensures you **don't pay** for testing. * If your app requires **project-level access**, **enable it** on a specific project. * For **quick tests**, a **small feed** with a few products is enough — **no need** to upload production data. * Use a **separate test account/project** for integrations so you **don't affect** production data. ## **FAQ** ### **Is there an official demo environment with data?** No. There is no central demo data available. Create your own test project in Mergado. ### **Where do I create a Mergado account?** At **app.mergado.com**. ### **Where do I create my app?** At **[https://app.mergado.com/developers/create-app/](https://app.mergado.com/developers/create-app/)**. After filling in the basic details, you'll get access to entities where the app is enabled. ### **How do I test without charges?** Enable **test mode** in the **project settings**. ### **Do I need a project if my app works with projects?** Yes. Create a **test project**, upload a **small feed**, and **enable** the app on the project. ### **How do I grant my app access to project data?** **Enable** the app in the **project settings**. It then gets access to the feeds/projects it can read/modify. ### **Where can I find the API authorization process?** In the documentation: **[https://mergado.github.io/docs/api/authorization.html](https://mergado.github.io/docs/api/authorization.html)**. ### **Where is the full API documentation?** At **[https://mergado.docs.apiary.io/#](https://mergado.docs.apiary.io/#)**. ### **An endpoint behaves differently than documented. What should I do?** Check the **API version**. Endpoint behavior is versioned, and a different version may lead to different behavior. ### **How large a feed should I use for tests?** A **small feed** with a few products is enough — it's ideal for fast iteration. ### **How do I protect production data during development?** Use a **separate test account/project** so changes don't affect production. ---