Všetko čo potrebujete vedieť o vlastnom formáte feedu (Custom Format)#

1. Úvod do Vlastného formátu (Custom Format)#

Čo je vlastný formát#

Vlastný formát je funkcia, pomocou ktorej naučíte Mergado rozpoznať a spracovávať takmer akýkoľvek XML alebo CSV súbor. Umožňuje nahrať do Mergada ľubovoľný feed, definovať jeho štruktúru a následne s dátami pracovať rovnako ako s bežnými integrovanými formátmi. Ďalej umožňuje vytvoriť v Mergade feed vo formáte, ktorý nie je medzi oficiálnymi integráciami.

Vlastný formát určujete vy – popisujete Mergadu, aké elementy má importovať či exportovať a ako s nimi zaobchádzať. Táto funkcionalita je určená najmä pre menej obvyklé, upravené alebo strojom nerozpoznateľné formáty, ktoré by Mergado bez vašej definície nedokázalo načítať.

Načo slúži?#

Vlastný formát má niekoľko kľúčových využití:

1. Prispôsobenie vstupu a výstupu#

Umožňuje prispôsobiť štruktúru dát vašim potrebám – na vstupe aj na výstupe projektu.

2. Väčšia kontrola nad dátami#

Pomáha presne určiť, ako majú byť produktové dáta v Mergade spracované, zobrazené a exportované.

3. Import neznámych feedov#

Vhodný pri práci s formátmi, ktoré Mergado nepozná: dodávateľské feedy, zastarané či výrazne upravené štruktúry, custom feedy alebo doplnkové feedy (napr. skladové, cestovné ponuky, recenzie).

4. Zachovanie pôvodnej štruktúry feedu#

Ak vstupné XML obsahuje po koreňovom elemente priamo jednotlivé produkty, možno pomocou vlastného formátu zachovať pôvodnú štruktúru bez úprav – užitočné u nestabilných dodávateľských zdrojov.

5. Export do vlastného formátu#

Slúži tiež na vytvorenie výstupného feedu vo formáte, ktorý Mergado zatiaľ oficiálne nepodporuje. Typické je to pri expanzii na nové trhoviská alebo pre menšie porovnávače. Stačí použiť šablónu feedu obsahujúcu aspoň jednu vzorovú položku.

Ako Mergado pracuje s dátami (Mergado XML a prevodník)?#

Mergado XML#

Všetky dátové prevody v Mergade prebiehajú cez jednotný medziformát Mergado XML. Ten slúži ako „univerzálny jazyk“, do ktorého sa prevedú vstupné dáta a z ktorého sa následne generujú výstupné formáty.

Prevodník#

Prevodník je mechanizmus, ktorý prevádza dáta medzi formátmi. Použije sa vždy, keď sa líši vstupný a výstupný formát. Prevodník sa aktivuje aj v prípadoch, keď je na vstupe aj na výstupe Google Merchants formát.

Rola vlastného formátu#

Vlastný formát vám umožňuje vytvoriť vlastný prevodník. Pri definícii CF Mergadu vysvetľujete, čo ktorá časť vášho feedu znamená a na aký ekvivalent v Mergado XML sa má namapovať.

Najdôležitejším krokom (platí iba pri práci s XML feedom) je správny výber elementov pre:

• CHANNEL (názov elementu v Mergado XML)
  • tzv. Root, teda koreňový element obaľujúci všetky produkty v XML feede
  • v XML feede je takýto element iba jeden,
  • obvykle je jeho otvárací tag úplne na začiatku feedu a jeho uzatvárací tag úplne na konci feedu
  • názov koreňového elementu môže byť v každom feede iný, príklady podľa formátu:
    • Google:
    • Heureka
    • Mergado XML
• ITEM (názov elementu v Mergado XML)
  • element obaľujúci jednu položku (produkt)
  • v XML feede je takýto element uvedený toľkokrát, koľko máte položiek/produktov.,
  • Každý produkt/položka feedu má práve jeden obaľovací element
  • názov obaľovacieho elementu produktu môže byť v každom feede iný, príklady podľa formátu:
    • Google:
    • Heureka
    • Mergado XML

Tieto dva elementy určujú štruktúru, v ktorej Mergado dáta spracováva.

Kedy má zmysel vlastný formát použiť?#

Na vstupe#

• Mergado nerozpozná formát feedu.
• Pracujete s neznámym, upraveným alebo custom formátom.
• Potrebujete zachovať pôvodnú štruktúru feedu.
• Napájate doplnkové dáta, ktoré nie sú integrované (sklad, služby, recenzie).

Na výstupe#

• Potrebujete feed v nepodporovanom formáte.
• Chcete mať kontrolu nad koreňovými elementmi a štruktúrou výstupného XML.
• Máte k dispozícii vzorový feed, z ktorého možno vytvoriť šablónu.

Obmedzenia a na čo si dať pozor#

1. Ignorovanie elementov mimo ITEM#

Vlastný formát nedokáže spracovať elementy umiestnené nad obaľovacím elementom položky. Všetko, čo nie je pod ITEM, Editor u feedu spracovaného cez vlastný formát nevidí. To znamená, že informácie umiestnené medzi CHANNEL a ITEM môžu byť stratené.

Riešenie pre zložité štruktúry: Rozloženie feedu na dva projekty a ich opätovné spojenie pomocou rozšírenia Blending Bull.

2. Prevod môže spôsobiť stratu dát#

Prevodník sa uplatní aj v prípade, že prevádzate z rovnakého vlastného formátu na ten rovnaký. Ak nie je mapovanie kompletné, môže dôjsť k strate informácií v novom feede (v pôvodnom feede zostanú zachované, len s nimi Mergado nepracuje).

3. Koreňové elementy na výstupe#

Koreňové elementy vytvára Mergado Editor automaticky podľa zvoleného výstupného formátu. Nejde ich teda vytvoriť ručne ako štandardné elementy v editore. Ak teda potrebujete neštandardné koreňové elementy vo výstupnom feede, jediný spôsob ako ovplyvniť koreňové elementy je zvolením správnej šablóny pre vlastný formát, ktorý potom použijete na výstupe.

4. Nutnosť aktualizácie pri zmenách#

Ak sa vo vstupnom súbore objaví nový element, vlastný formát pre neho nemá nastavené chovanie. Mergado taký element automaticky importuje a neskryje, dostane sa tak automaticky do výstupného feedu bez zmeny. V takom prípade je nutné aktualizovať štruktúru vlastného formátu a doplniť nastavenie mapovania nového elementu. Po uložení a pregenerovaní projektu sa potom zmeny automaticky prejavia.

Prípadne ak by nové elementy spôsobili nevalidnosť výstupného feedu, ide to najrýchlejšie opraviť skrytím nových elementov ručne na stránke Elementy a spustiť Export projektu (bez aplikácie pravidiel).

FAQ#

Čo je vlastný formát v Mergade?#

Vlastný formát je funkcia, vďaka ktorej naučíte Mergado spracovať takmer akýkoľvek XML alebo CSV súbor, bez ohľadu na to, či ho Mergado bežne podporuje. Umožňuje definovať, aké elementy feed obsahuje a ako s nimi má systém pracovať pri importe aj exporte. Slúži tiež na vytvorenie výstupného feedu vo vlastnom formáte, napríklad pre platformy alebo kanály, ktoré Mergado štandardne nepodporuje.

Načo vlastný formát slúži?#

Vlastný formát umožňuje prispôsobiť dátovú štruktúru projektu vašim potrebám. Pomáha presne riadiť spôsob, akým Mergado načítava, zobrazuje a exportuje produktové dáta. Je užitočný najmä pre import neštandardných alebo upravených feedov a pre export do formátov, ktoré nie sú súčasťou integrovaných kanálov.

Kedy má zmysel vlastný formát použiť na vstupe?#

Vlastný formát je vhodný, keď Mergado nedokáže feed rozpoznať alebo ak pracujete s custom, upraveným či doplnkovým feedom, ktorý sa nezmestí do existujúcich integrácií. Pomáha tiež tam, kde potrebujete zachovať pôvodnú štruktúru feedu, ak XML obsahuje položky priamo pod koreňovým elementom. Môžete ho využiť aj pre vstupné doplnkové dáta ako sklad, služby alebo recenzie.

Kedy má zmysel vlastný formát použiť na výstupe?#

Vlastný formát na výstupe sa hodí, keď potrebujete vytvoriť feed v podobe, ktorú Mergado štandardne negeneruje. Často ide o expanziu na nové platformy alebo napojenie na interné systémy s vlastnou štruktúrou XML. Stačí mať vzorový feed, podľa ktorého Mergado vytvorí výstupnú šablónu.

Čo je Mergado XML a prečo je dôležité?#

Mergado XML je interný medziformát, cez ktorý prebiehajú všetky dátové prevody. Funguje ako „univerzálny jazyk“, do ktorého sa preloží vstupné dáta, a z ktorého sa ďalej generujú výstupné formáty. Vďaka tomu nemusí existovať prevodník pre každý pár formátov zvlášť.

Čo robí prevodník?#

Prevodník prevádza hodnoty medzi dátovými formátmi – z ľubovoľného vstupu do Mergado XML a z neho do výstupného formátu. U vybraných formátov (napr. Google Merchants) sa aktivuje aj v prípadoch, keď je rovnaký formát na vstupe aj na výstupe . Ak nie je mapovanie kompletné, môže prevodník niektoré hodnoty vynechať, čo je dôvod, prečo sa odporúča venovať mapovaniu pozornosť.

Akú rolu má vlastný formát pri prevode dát?#

Vlastný formát umožňuje vytvoriť vlastný prevodník na mieru vášmu feedu. Presne určujete, čo jednotlivé elementy znamenajú a ako sa majú previesť do Mergado XML. Vďaka tomu získate kontrolu nad štruktúrovaním dát aj cez platformy, ktoré Mergado štandardne nepozná.

Čo znamená správne vybrať CHANNEL a ITEM?#

CHANNEL je koreňový element Mergado XML feedu a určuje, kde celý dokument začína a končí. ITEM je obaľovací element jednej položky a v Mergado XML sa vyskytuje toľkokrát, koľko máte produktov. Správne mapovanie týchto dvoch elementov je základným predpokladom pre to, aby Mergado dokázalo váš feed spracovať. CSV feed tieto elementy nemá a preto mapovanie týchto elementov odpadá.

Aké obmedzenia má vlastný formát?#

Vlastný formát nevie spracovať elementy, ktoré ležia mimo ITEM, teda napríklad informácie umiestnené medzi CHANNEL a ITEM. Tieto prvky Mergado ignoruje a v projekte s nimi nemožno priamo pracovať. Ak ich potrebujete zachovať, je nutné použiť iný postup, napríklad dvojprojektový model a zlúčenie cez Blending Bull.

Prečo môže dôjsť k strate dát pri prevode?#

Vlastný formát ignoruje elementy v XML feedoch, ktoré sú umiestnené medzi CHANNEL a ITEM. Ak takéto elementy obsahujú informácie, ktoré potrebujete, je potrebné použiť iný postup, napríklad dvojprojektový model a zlúčenie cez Blending Bull.

Ako Mergado pracuje s koreňovými elementmi na výstupe?#

Koreňové elementy vznikajú podľa zvoleného výstupného formátu a nemožno ich priamo editovať. Ak potrebujete inú štruktúru, je nutné použiť vlastný formát vytvorený podľa vzorového feedu, prípadne úpravu cez Blending Bull. Tým zaistíte, že výstupný feed bude mať presne také záhlavie a obal, aké požadujete.

Čo robiť, keď sa vo vstupnom feede objaví nový element?#

Nový element sa automaticky importuje do projektu, ale Mergado nevie, čo s ním, pretože nie je súčasťou pôvodného mapovania. V takej situácii je potrebné aktualizovať štruktúru vlastného formátu a doplniť mapovanie nového elementu. Potom projekt pregenerujete a dáta sa načítajú a prevedú správne.

Ako zistím, kedy je lepšie vlastný formát nepoužívať?#

Vlastný formát nie je potrebný tam, kde existuje oficiálna integrácia. Ak máte pochybnosti, je vhodné situáciu konzultovať so supportom.

Načo slúži vzorový feed?#

Vzorový feed slúži ako šablóna pri tvorbe výstupného vlastného formátu. Mergado podľa neho určí štruktúru koreňových elementov, obaľovacích tagov a ďalších prvkov, ktoré sa majú vo výstupe zachovať. Stačí minimálny príklad – pokojne jeden produkt. Vzorový feed musí byť dostupný na URL adrese.

Ako poznám, že je vlastný formát správne nakonfigurovaný?#

Či je formát definovaný správne poznáte podľa toho, že projekt načíta všetky potrebné elementy a výstupný feed má očakávanú štruktúru. Kritickým miestom je správne mapovanie CHANNEL a ITEM, prípadne párovacieho elementu v projekte. Ak výstupné dáta zodpovedajú požadovanej šablóne a nedochádza k strate informácií, je konfigurácia v poriadku.

Čo robiť, keď tvorba projektu s vlastným formátom skončí chybou?#

Skontrolujte mapovanie vlastného formátu. Častou chybou u XML feedov je nesprávne namapovaný koreňový element alebo element obaľujúci položku. Oba elementy môžu byť namapované iba raz, na jeden element vo vašom feede. Ďalšou chybou býva nesprávne zvolený párovací element. Najistejšie je zvoliť element s id produktov, kombinovaný napr. s elementom s EANmi alebo s URL produktov/obrázkov. Ak máte pochybnosti ako správne vlastný formát nastaviť, je vhodné nastavenie konzultovať so supportom.

2. Kde možno vlastný formát vytvoriť a spravovať#

Vlastný formát môžete v Mergade definovať dvoma spôsobmi: priamo pri zakladaní projektu alebo v samostatnej sekcii určenej pre prácu s vlastnými formátmi. Oba prístupy sa vzájomne dopĺňajú a umožňujú vytvoriť aj neskôr znovu použiť ľubovoľnú definíciu formátu.

Definícia pri tvorbe projektu#

V rámci zakladania projektu možno určiť vlastný formát ako pre vstupný feed, tak pre výstupný feed. Táto možnosť sa objaví vždy, keď Mergado nedokáže priradiť vstupnému súboru žiadny integrovaný formát, prípadne keď potrebujete vytvoriť špecifický výstup.

Vlastný formát na vstupe#

K vytvoreniu vlastného formátu pre vstupný feed sa dostanete v 3. kroku sprievodcu založením projektu. Ak systém pozná štruktúru pripojeného feedu, ponúkne možnosť detekovaný formát zmeniť tlačidlom Vybrat jiný formát, a následne máte možnosť buď vybrať iný oficiálny formát zo selectboxu, alebo práve pre vstupný feed vytvoriť vlastný formát pomocou tlačidla Definovat vlastní formát.

Ak systém nepozná štruktúru pripojeného feedu, ponúkne možnosť buď vybrať oficiálny formát zo selectboxu ručne, alebo pre vstupný feed vytvoriť vlastný formát pomocou tlačidla Definovat vlastní formát.

Pri vytváraní vlastného formátu pre vstupný feed systém ponúka dva prístupy:

• Zjednodušený průchod – vhodný pre rýchle nastavenie základnej štruktúry.
• Podrobné nastavení – umožňuje detailné mapovanie všetkých nájdených elementov.

Oba spôsoby vedú k rovnakému cieľu: určiť, kde začína feed, ktoré elementy predstavujú jednotlivé produkty a ktorý element obsahuje unikátnu hodnotu u všetkých produktov.

Pre správne spracovanie vstupného feedu je nutné namapovať aspoň:

• koreňový element (CHANNEL),
• obaľovací element produktov (ITEM),
• identifikátor produktu (ITEM_ID) – element s unikátnou hodnotou pre každú položku.

Samozrejme môžete namapovať aj všetky elementy zo vstupného feedu, čo vám môže uľahčiť následnú prácu (napríklad znížiť počet potrebných pravidiel). Pre samotný import dát to však nutné nie je.

Vlastný formát na výstupe#

K vytvoreniu vlastného formátu pre výstupný feed sa dostanete v 4. kroku sprievodcu založením projektu. Použite tlačidlo Definovat vlastní formát. V ďalšom kroku je potrebné vložiť URL vzorového feedu, teda šablóny, podľa ktorej sa vlastný formát nastaví a podľa ktorej bude výstupný feed vytvorený.

Pozor. Vzorový feed nejde nahrať Uploadom, URL adresa je povinná. Ak teda máte šablónu ako súbor, vytvorte URL adresu pomocou cloudového úložiska, napr Dropbox, alebo môžete využiť rozšírenie Mergado Files.

Ak máte vlastný formát už pripravený, môžete ho vybrať ako výstupný formát projektu. Tým určíte, ako bude vyzerať finálne XML alebo CSV, bez ohľadu na to, či Mergado daný formát bežne podporuje. Ak bol formát vytvorený zo vzorového feedu, Mergado zachová koreňové elementy aj ich usporiadanie.

Pri vytváraní vlastného formátu pre výstupný feed systém ponúka iba jeden prístup:

• Podrobné nastavení – umožňuje detailné mapovanie všetkých nájdených elementov.
• Zjednodušený průchod tu nie je dostupný

Pre správne vytvorenie výstupného feedu je nutné namapovať aspoň:

• koreňový element (CHANNEL),
• obaľovací element produktov (ITEM).

V tomto prípade Mergado výstupný feed pripraví, vytvorí všetky elementy zo šablóny do projektu, ale pretože nevie čo jednotlivé elementy znamenajú, elementy nenaplní a je potrebné to nastaviť ručne pomocou pravidiel.

Samozrejme môžete namapovať aj všetky ostatné elementy zo vzorového feedu, čo vám môže uľahčiť následnú prácu (napríklad znížiť počet potrebných pravidiel).

Sekcia „Vlastní formáty“ v hlavnom menu #

Samostatnú správu vlastných formátov nájdete v ľavom menu Mergado Editora v záložke Vlastní formáty, ak stojíte na úrovni užívateľa (ľavé menu sa mení podľa toho, či spravujete užívateľa, eshop, alebo projekt). Táto sekcia slúži ako centrálne miesto pre prácu so všetkými formátmi vytvorenými v účte.

Tu je možné:

• vytvoriť nový formát bez nadväznosti na konkrétny projekt,
• zadať URL vzorového súboru (example feed),
• vykonať mapovanie elementov,
• upraviť alebo znovu analyzovať už existujúci formát.

Táto sekcia slúži ako centrálne miesto, kde môžete vlastné formáty udržiavať, testovať a pripravovať pre použitie v ďalších projektoch.

Opakované použitie vlastných formátov#

Akonáhle vlastný formát vytvoríte – či už v sprievodcovi, alebo v samostatnej sekcii – uloží sa v Mergade a môžete ho používať ľubovoľne dlho, a to:

• na vstupe, ak chcete spracovať ďalší feed s rovnakou štruktúrou,
• na výstupe, ak potrebujete generovať nový feed v rovnakej podobe.

Ak už máte uložený aspoň jeden vlastný formát, je pri vytváraní ďalšieho nového vlastného formátu k dispozícii tiež funkcia Předvyplnit dle, ktorá umožní prevziať štruktúru (nastavené mapovanie) už existujúceho formátu. Tým sa zrýchli práca v prípadoch, keď pracujete s viacerými formátmi, ktoré majú podobné schéma.

FAQ#

Kde môžem v Mergade vytvoriť vlastný formát?#

Vlastný formát môžete vytvoriť dvoma spôsobmi – priamo pri zakladaní projektu alebo v samostatnej sekcii Vlastní formáty v ľavom menu. Oba spôsoby sa dopĺňajú a umožňujú pripraviť formát buď rýchlo počas práce na projekte, alebo ho vytvoriť dopredu. Formát je po uložení dostupný pre opakované použitie vo všetkých projektoch.

Ako vytvorím vlastný formát na vstupe pri zakladaní projektu?#

V 3. kroku sprievodcu založením projektu Mergado ponúkne vytvorenie vlastného formátu vtedy, ak nepozná štruktúru feedu alebo ak ručne vyberiete možnosť “Vybrat jiný formát”. Následne môžete buď použiť zjednodušený priechod, alebo podrobné nastavenie. Stačí namapovať CHANNEL, ITEM (u XML feedov) a ideálne aj identifikátor produktu, aby mohol projekt správne pracovať s položkami.

Čo je nutné minimálne namapovať, aby mohlo Mergado feed načítať?#

Pre minimálnu funkčnosť je nutné namapovať CHANNEL, ITEM (u XML feedov) a jeden element s unikátnou hodnotou (najčastejšie ITEM_ID). To stačí na to, aby Mergado dokázalo identifikovať začiatok dokumentu, jednotlivé produkty a ich jednoznačný kľúč. Ostatné elementy je možné doplniť neskôr.

Ako vytvorím vlastný formát na výstupe?#

Vytvára sa v 4. kroku založenia projektu pomocou voľby Definovat vlastní formát. Je nutné vložiť URL vzorového XML súboru (example feedu), podľa ktorého Mergado zostaví štruktúru výstupu. Potom mapujete aspoň základné elementy a formát uložíte pre použitie v projekte.

Prečo musím mať vzorový feed dostupný na URL adrese?#

Mergado výstupný formát vytvára výhradne zo súboru dostupného cez URL, pretože potrebuje štruktúru importovať pri analýze. Nahranie súboru cez upload nie je podporované. Ak nemáte vlastný hosting, môžete použiť cloudovú službu (Dropbox, One Drive) alebo vytvoriť súbor pomocou Mergado Files.

Prečo sa u výstupného formátu neponúka zjednodušený priechod?#

U výstupného formátu je vždy k dispozícii iba podrobné nastavenie. Je to zámer, pretože cieľová štruktúra vychádza zo vzorového feedu a je potrebné plne kontrolovať prevod do šablóny. Zjednodušené mapovanie by u výstupu nemuselo byť dostatočne presné.

Čo sa stane, keď pri tvorbe výstupného formátu namapujem len minimum?#

Mergado vytvorí výstupný feed s koreňovými elementmi zo šablóny, v projekte vytvorí prázdne elementy podľa šablóny, ale elementy bez namapovania nebudú vyplnené žiadnymi hodnotami. Tieto hodnoty je potom nutné doplniť ručne pravidlami. Preto je vhodné doplniť mapovanie pre čo najviac elementov zo vzorového feedu.

Načo slúži sekcia „Vlastní formáty“ v ľavom menu? #

Táto sekcia slúži na centrálnu správu všetkých vlastných formátov v účte. Môžete tu vytvárať nové formáty, upravovať existujúce, a aktualizovať ich štruktúru Je to najvhodnejšie miesto pre prípravu formátov, ktoré budete v budúcnosti opakovane používať.

Je možné používať jeden vlastný formát v rôznych projektoch?#

Áno, každý uložený vlastný formát je dostupný pre opakované použitie. Môžete ho použiť na vstupe aj na výstupe v ľubovoľnom počte projektov. To je užitočné najmä vtedy, keď pracujete s viacerými feedmi, ktoré zdieľajú rovnakú štruktúru.

Načo slúži možnosť „Předvyplnit dle“ pri tvorbe nového formátu? #

Umožňuje prevziať štruktúru (mapovanie elementov) zo skôr vytvoreného vlastného formátu. Je ideálna, ak pracujete s viacerými formátmi s rovnakou alebo podobnou schémou. Vďaka tomu nemusíte pri každom novom formáte začínať od nuly.

3. Zjednodušený priechod vs. Podrobné nastavenie pri definícii vlastného formátu#

Pri vytváraní vlastného formátu na vstupe v rámci sprievodcu vytvorenia nového projektu môžete pracovať dvoma spôsobmi: buď použijete zjednodušený priechod, alebo prejdete do podrobného nastavenia. Oba prístupy slúžia k rovnakému cieľu – vysvetliť Mergadu štruktúru feedu – ale líšia sa tým, akú mieru kontroly a koľko možností užívateľovi ponúkajú.

Zjednodušený priechod je vhodný pre rýchle spracovanie feedov. Podrobné nastavenie poskytuje úplnú kontrolu nad mapovaním elementov aj konfiguráciou formátu.

1. Zjednodušený priechod#

Zjednodušený priechod sa zobrazí iba pri vytváraní vlastného formátu na vstupe v rámci sprievodcu vytvorenia nového projektu. Wizard užívateľovi ponúkne rýchlu cestu, ako základnú štruktúru definovať. Cieľom je zjednodušiť nastavenie vlastného formátu pre nových užívateľov ponukou mapovania len tých najdôležitejších elementov a skrytím pokročilého nastavenia, ktoré možno zmeniť neskôr.

Kedy sa používa#

• V rámci sprievodcu vytvárania nového projektu pri nastavení formátu vstupného feedu.
• Keď chcete čo najrýchlejšie vytvoriť funkčné mapovanie.

Čo zjednodušený priechod ponúka#

• Zobrazenie základných elementov v prehľadnej podobe.
• Zvýraznenie kľúčových prvkov používaných reklamnými kanálmi.
• Zrozumiteľnejšie názvy elementov než v technickom zobrazení.
• Chytré mapovanie, ktoré sa pokúsi automaticky priradiť elementy podľa názvov a významu.

Ako funguje chytré mapovanie#

Systém navrhne párovanie — napr. description → DESCRIPTION, EAN → EAN, ID → ITEM_ID. Užívateľ potom iba skontroluje správnosť návrhov a prípadne upraví jednotlivé voľby.

Kedy je zjednodušený priechod ideálny#

• Keď potrebujete rýchlo začať pracovať s dátami.
• Keď sa štruktúra feedu prevažne drží bežných konvencií.
• Keď ide o jednorazové alebo menej komplexné mapovanie.

2. Podrobné nastavenie (kompletná definícia vlastného formátu)#

Podrobné nastavenie je plná verzia rozhrania pre definíciu vlastného formátu. Obsahuje všetky možnosti, ktoré možno u mapovania elementov využiť.

Kedy sa používa#

• Feed má zložitú alebo netypickú štruktúru.
• Je nutné presne kontrolovať, ako sa každý element spracuje.
• Pripravujete formát pre opakované použitie alebo pre výstupný feed.
• Je potrebné definovať význam podelementov, variantov alebo parametrov.

Čo zahŕňa podrobné nastavenie#

1. Parametre vlastného formátu

Všeobecná konfigurácia, ktorá určuje chovanie formátu:

• vhodný názov formátu,
• nastavenie štátu (vplyv na meny),
• možnosť prevziať nastavenie z existujúceho formátu,
• voľba pre rozdelenie variantov na samostatné produkty,
• definícia vlastného stromu kategórií.

2. Nastavenie spracovania dát (mapovanie elementov)

Kľúčová časť, ktorá určuje, ako Mergado interpretuje jednotlivé časti feedu.

Zásadné elementy:

• koreňový element (napr. CHANNEL)
• obaľovací element produktov (napr. ITEM)
• identifikátor produktu (napr. ITEM_ID) – element s unikátnou hodnotou pre každú položku

Ďalšie možnosti:

• priame mapovanie na Mergado XML
• operácie pre elementy bez podelementov (Propsat jak je, Skrýt, Význam elementu)
• špeciálne operácie pre obaľovacie elementy (napr. DELIVERY, PARAM, VARIANT)
• možnosť namapovať ľubovoľné množstvo elementov pre jednoduchšiu následnú prácu v projekte

Porovnanie zobrazenia: Zjednodušený priechod vs. Podrobné nastavenie#

Aký postup zvoliť#

• Použite zjednodušený priechod, ak potrebujete rýchlo založiť projekt a feed má relatívne prehľadnú štruktúru.
• Zvoľte podrobné nastavenie, ak pracujete s komplexným feedom, pripravujete šablónu pre výstup alebo potrebujete presne definovať význam jednotlivých elementov.

FAQ#

Čo je zjednodušený priechod pri vytváraní vlastného formátu?#

Zjednodušený priechod je variantou rozhrania v 3. kroku sprievodcu, ktorá ponúka iba najdôležitejšie elementy a rýchlejšiu cestu k vytvoreniu funkčného mapovania. Je navrhnutý tak, aby užívateľa nezahltil pokročilým nastavením a umožnil rýchly štart aj u neznámych feedov. Ponúka chytré mapovanie, ktoré automaticky odporučí priradenie elementov podľa názvov a významu.

Kedy sa zjednodušený priechod zobrazí?#

Zobrazí sa výhradne pri vytváraní vlastného formátu na vstupe a len vtedy, ak Mergado nerozpozná štruktúru feedu alebo užívateľ zvolí definíciu vlastného formátu ručne. V týchto situáciách je cieľom zrýchliť základné nastavenie tak, aby bol projekt čo najskôr pripravený na prácu. Podrobné nastavenie možno vyvolať kedykoľvek.

Ako funguje chytré mapovanie v rámci zjednodušeného priechodu?#

Chytré mapovanie sa pokúsi automaticky priradiť elementy podľa ich názvu a typického významu. Užívateľ iba skontroluje navrhnuté hodnoty a prípadne ručne upraví, aký element má byť spojený s ekvivalentom v Mergado XML. Tento krok výrazne zrýchľuje prácu najmä u bežných alebo jednoduchších štruktúr feedov.

Kedy je vhodné použiť zjednodušený priechod?#

Zjednodušený priechod je ideálny, ak potrebujete rýchlo začať pracovať s dátami a feed má pomerne štandardnú štruktúru. Vhodný je tiež vtedy, keď ide o jednorazové spracovanie alebo keď nechcete hneď na začiatku riešiť detailné nastavenie. Ak feed neobsahuje zložitú hierarchiu, často postačí práve táto varianta.

Čo je podrobné nastavenie vlastného formátu?#

Podrobné nastavenie je plná varianta tvorby vlastného formátu, ktorá umožňuje mapovať jednotlivé elementy aj ich podelementy s maximálnou presnosťou. Obsahuje tiež všetky parametre formátu, ako je štát, názov alebo rozdeľovanie variantov, a umožňuje definovať chovanie zložitejších štruktúr. Tento prístup je určený pre feedy s viacerými úrovňami alebo pripravované výstupné formáty.

Kedy je vhodné použiť podrobné nastavenie?#

Podrobné nastavenie je najlepšia voľba vtedy, keď feed obsahuje zložitú, neštandardnú alebo viacúrovňovú štruktúru. Rovnako tak je vhodné, ak potrebujete úplne presne kontrolovať, ako sa budú dáta v projekte spracovávať a exportovať. Je nevyhnutné tiež pri príprave formátu, ktorý sa bude používať opakovane alebo na výstupe.

Aké elementy je nutné namapovať v oboch prípadoch?#

Či už použijete zjednodušený priechod, alebo podrobné nastavenie, musíte vždy určiť koreňový element (CHANNEL) (platí pre XML feedy), obaľovací element produktu (ITEM) (platí pre XML feedy), a aspoň jeden identifikátor produktu (najčastejšie ITEM_ID). Tieto elementy sú kľúčom k tomu, aby Mergado dokázalo dátový feed správne načítať a identifikovať jednotlivé položky. Mapa ostatných elementov závisí od toho, čo budete v projekte potrebovať.

Čo ponúka podrobné nastavenie navyše oproti zjednodušenému?#

Podrobné nastavenie umožňuje definovať význam každého elementu a nastavovať špeciálne operácie u elementov s podelementmi, napríklad u parametrov, dopravy alebo variantov. Navyše obsahuje všetky parametre formátu a ponúka možnosť prevziať štruktúru z existujúceho CF. Poskytuje teda najvyššiu možnú presnosť prevodu dát.

Aký postup zvoliť – zjednodušený alebo podrobný?#

Zjednodušený priechod zvoľte vtedy, keď ide o rýchle vytvorenie projektu a feed má jednoduchú a čitateľnú štruktúru. Podrobné nastavenie použite v prípade, že plánujete s dátami pracovať dlhodobo, alebo ak je feed zložitý a vyžaduje presné mapovanie. Voľba postupu závisí predovšetkým od zložitosti dát a od toho, či je pre vás dôležitejšia rýchlosť, alebo presnosť.

Môže zjednodušený priechod nahradiť podrobné nastavenie?#

Áno, v mnohých jednoduchších prípadoch postačí. Ak ale feed obsahuje varianty, parametre, viacstupňovú štruktúru alebo plánujete ďalšie exporty, bude podrobné nastavenie vo výsledku presnejšie a stabilnejšie. Odporúča sa teda začať zjednodušeným prístupom a prejsť na detailný režim, ak zistíte, že je potrebné viac kontroly.

4. Tvorba vlastného formátu – Detailné nastavenie#

Detailné nastavenie vlastného formátu je krok, v ktorom Mergadu presne určíte, ako má interpretovať štruktúru vášho feedu. Na základe týchto informácií vzniká prevodník medzi vaším dátovým formátom a Mergado XML. Táto fáza nasleduje po analýze štruktúry zdrojového súboru.

Analýza štruktúry feedu#

Pri vytváraní vlastného formátu Mergado najprv načíta a analyzuje pripojený súbor. Z jeho štruktúry určí, ktoré elementy je možné mapovať, a vytvorí ich prehľad.

Čo analýza robí#

• načíta štruktúru XML alebo CSV zo zadanej URL
• identifikuje dostupné elementy aj ich štruktúru
• pripraví zoznam elementov, ktoré možno namapovať na Mergado XML

Aktualizácia štruktúry#

Ak sa neskôr vo vstupnom súbore objaví nový element, je nutné ho do nastavenia vlastného formátu doplniť. Slúži na to voľba Aktualizovat strukturu ze souboru, ktorá načíta nové prvky a umožní u nich určiť, ako sa majú do Mergada prepísať.

Nastavenie základných parametrov vlastného formátu#

V tejto časti určíte všeobecné parametre formátu. Tieto voľby sa netýkajú jednotlivých elementov, ale chovania formátu ako celku.

Dostupné parametre#

Mapovanie elementov (Nastavenie spracovania dát)#

Táto časť určuje, ako bude Mergado interpretovať elementy vášho feedu. Mapovanie definuje vzťah medzi konkrétnym elementom a jeho ekvivalentom v Mergado XML.

Povinné elementy (platí iba pre XML)#

Pre funkčné spracovanie feedu je nutné namapovať aspoň tieto dva prvky:

• CHANNEL – koreňový obal celého feedu,
• ITEM – obaľovací element jednej položky.

Bez týchto dvoch elementov nemožno XML feed importovať.

Odporúčané elementy#

Mergado umožňuje mapovať ľubovoľné množstvo ďalších elementov. Čím viac prvkov namapujete, tým menej práce budete mať neskôr s pravidlami a tým lepšie možno feed prevádzať na iné výstupné formáty.

Operácie pre jednoduché elementy#

U elementov, ktoré nemajú podelementy, možno použiť tri typy operácií:

Operácie pre obaľovacie elementy#

U elementov, ktoré majú v sebe ďalšiu štruktúru, možno zvoliť špeciálne operácie, ktoré sprístupnia nastavenie pre ich podelementy.

Príklady:

• DELIVERY – nastavíte cenu dopravy, názov či kód dopravcu,
• PARAM – definícia parametrov produktu,
• VARIANT – práca s jednotlivými variantami položky.

Ak element nemá podelementy, ale obsahuje atribút (napr. <PARAM name="Barva">Červená</PARAM>, kde name je atribút), Mergado ho novo rozpozná ako obaľovací a v selecte ponúkne ako špeciálne operácie (PARAM, DELIVERY, VARIANT…), tak bežné operácie / význam elementu. Vy si vyberiete, ako chcete element spracovať. Platí to ako v Podrobnom nastavení vlastného formátu, tak vo Wizarde.

Dopady mapovania#

• Rozsiahlejšie mapovanie uľahčí následný export do iných formátov.
• Minimálne mapovanie vyžaduje viac práce v pravidlách (kopírovanie a dopĺňanie hodnôt).
• Elementy umiestnené mimo ITEM nemožno spracovať – Mergado ich ignoruje.

FAQ#

Čo znamená analýza štruktúry feedu pri tvorbe vlastného formátu?#

Analýza je prvý krok, v ktorom Mergado načíta súbor z URL a identifikuje všetky dostupné elementy. Z ich hierarchie zostaví štruktúru, ktorú následne ponúkne k mapovaniu. Tento proces určuje, s čím možno vo vlastnom formáte pracovať.

Čo mám robiť, keď sa vo vstupnom feede objaví nový element?#

Je potrebné otvoriť definíciu uloženého vlastného formátu a použiť voľbu „Aktualizovat strukturu ze souboru“. Tým sa načíta nový element do zoznamu a vy môžete určiť, ako sa má v Mergade spracovať. Po uložení a pregenerovaní dát je nový element súčasťou projektu.

Načo slúži základné nastavenie vlastného formátu?#

Tieto parametre určujú chovanie formátu ako celku a neriešia jednotlivé elementy. Patrí sem názov formátu, nastavenie štátu, voľba pre prácu s variantami alebo aktivácia vlastného stromu kategórií. Správne nastavenie parametrov zjednoduší jeho budúce použitie v ďalších projektoch.

Prečo je dôležité správne pomenovať vlastný formát?#

Názov formátu sa zobrazuje v zozname formátov a uľahčuje orientáciu najmä v prípade, že ich máte viac. Dobre zvolený názov umožní rýchlo identifikovať, pre aký typ feedu bol formát vytvorený. Predídete tým chybám pri opakovanom použití.

Ako funguje voľba „Předvyplnit dle“? #

Táto možnosť sprístupní existujúce vlastné formáty a umožní prevziať ich štruktúru. Hodí sa, ak potrebujete vytvoriť podobný formát alebo pracujete s feedmi s rovnakou schémou. Vďaka tomu nemusíte všetko mapovať od začiatku.

Čo znamenajú operácie „Propsat jak je“, „Skrýt“ a „Význam elementu“? #

• „Propsat jak je“ - Element sa importuje a exportuje bez zmien, ak ho pravidlo Převodník alebo užívateľ nenastaví ako skrytý.
• „Skrýt“ zaistí, že sa Element importuje a nastaví sa ako skrytý. Možno s ním pracovať v rámci pravidiel, vytvárania výberov, alebo ho prípadne ručne odkryť.
• „Význam elementu“ slúži na mapovanie elementu na ekvivalent v Mergado XML

Kedy sa vyplatí mapovať aj ďalšie elementy mimo povinných?#

Ak plánujete export do iných formátov alebo budete pracovať s dátami v pravidlách, je detailné mapovanie výrazne prínosné. Menej namapovaných elementov znamená viac práce pri dopĺňaní hodnôt v projekte. Čím presnejšie mapovanie, tým jednoduchšie ďalšie spracovanie.

Ako fungujú špeciálne operácie pre obaľovacie elementy?#

Používajú sa vtedy, keď má element vlastnú vnorenú štruktúru, napríklad parametre, dopravu alebo varianty. Výberom špeciálnej operácie sprístupníte nastavenie pre ich podelementy. To umožňuje detailne definovať, ako majú byť hodnoty týchto štruktúr spracované.

Prečo Mergado ignoruje elementy mimo ITEM?#

Vlastný formát vie pracovať len s časťou XML, ktorú tvoria jednotlivé položky produktu. Elementy nad ITEM, napríklad informácie medzi CHANNEL a ITEM, nie sú súčasťou modelu produktových dát. Preto sa pri importe ignorujú a projekt nad nimi nemá kontrolu.

Ako poznám, že je mapovanie dostatočné?#

Ak dokážete načítať feed, pracovať s dátami bez nutnosti rozsiahlych pravidiel a export je bez strát informácií, je mapovanie nastavené správne. Kritickým bodom je zachytenie všetkých elementov, ktoré budete neskôr upravovať alebo exportovať. Ak musíte často dopĺňať hodnoty pravidlami, mapovanie je pravdepodobne príliš stručné.

Aký je vzťah medzi mapovaním a prevodníkom?#

Mapovanie určujete vy a práve podľa neho prevodník prevádza dáta do Mergado XML. Ak nejaký element nenamapujete, prevodník o ňom „nevie“ a nepracuje s ním. Dobré mapovanie teda určuje kvalitu celého prevedeného feedu.

Čo keď môj element nemá podelementy, ale má atribút – dá sa ho namapovať ako PARAM?#

Áno. Mergado novo rozpozná elementy, ktorých jedinými „potomkami“ sú atribúty, a ponúkne u nich v mapovaní ako špeciálne operácie (PARAM, DELIVERY, VARIANT), tak bežné operácie/význam elementu. Skôr bolo možné taký element namapovať len ako bežný element.

5. Vlastný formát na vstupe#

Vlastný formát na vstupe slúži na načítanie dátových feedov, ktoré Mergado nerozpozná, a na ich prevod do internej štruktúry Mergado XML. Vďaka tomu možno v Mergade spracovať takmer ľubovoľný XML alebo CSV súbor.

Kedy sa používa vlastný formát na vstupe#

Potreba definovať vlastný formát vzniká vtedy, keď systém nedokáže určiť štruktúru vstupného feedu a zobrazí informáciu, že formát nie je známy. V takej situácii ponúkne vytvorenie vlastného formátu.

Typické scenáre#

• Dodávateľské feedy alebo inak štruktúrované XML/CSV,
• Custom feedy vytvorené na mieru. Typicky u väčších e-shopov.
• Zastarané alebo výrazne upravené varianty známych formátov,
• Doplnkové feedy, napríklad skladové alebo servisné,
• Feedy poskytujúce iné typy služieb (recenzie, cestovné ponuky).
• atď.

Postup vytvorenia vlastného formátu pri importe feedu#

Definícia vlastného formátu prebieha v 3. kroku sprievodcu zakladaním projektu.

1. Vytvorte nový projekt a vložte URL vstupného feedu.
2. Ak Mergado štruktúru nerozpozná, zvoľte Definovat vlastní formát.
3. Namapujte povinné elementy:

• CHANNEL
• ITEM

4. Namapujte ďalšie elementy, s ktorými budete v projekte pracovať (URL, NAME, ITEM_ID, …).
5. Formát pomenujte a uložte.
6. V 4. kroku môžete

• Ponechať rovnaký vlastný formát aj na výstup, štruktúra feedu sa tak nebude meniť.
• Vybrať pomocou selectboxu iný oficiálny formát, napr. Google, Meta aj.
• Vytvoriť nový vlastný formát pre výstup.

7. V poslednom kroku skontrolujte, či sú vybrané párovacie elementy. Ak nie, je nutné ich nastaviť.

Nastavenie párovacieho elementu#

Párovací element je kľúčovým údajom, ktorý Mergado používa pre jednoznačnú identifikáciu každej položky v projekte.

Čo je dôležité:

• Musí mať unikátnu hodnotu pre každý produkt.
• Najčastejšie sa používa element s ID produktov alebo iný jednoznačný identifikátor (URL, EAN,..).
• V rekapitulácii krokov je nutné skontrolovať, že je párovací element správne vybraný.

Párovací element funguje ako „rodné číslo“ pre každú položku. Umožňuje Mergadu bezpečne sledovať a spracovávať jednotlivé produkty bez ohľadu na to, ako sa ich hodnoty v priebehu práce menia.

Koľko elementov mapovať#

Minimum – pre funkcionalitu#

Pre import postačí namapovať iba povinné elementy (CHANNEL, ITEM a prípadne ITEM_ID).

Maximum – pre efektivitu#

Namapovať viac elementov znamená jednoduchšiu prácu v ďalších krokoch projektu.

Výhody detailného mapovania:

• menej potrebných pravidiel pre kopírovanie hodnôt,
• rýchlejší prevod do iných výstupných formátov,
• lepšia čitateľnosť a stabilita projektu.

Príklad dopadu: Ak nenamapujete element s názvom produktu, musíte ho neskôr do formátu doplniť pravidlom. Ak ho namapujete už pri definícii CF, Mergado ho potom správne automaticky prevedie do výstupného feedu.

Aktualizácia štruktúry pri zmenách feedu#

Ak sa u vstupného feedu objavia nové elementy, uložený vlastný formát ich automaticky neprevezme. Je potrebné:

1. Otvoriť daný vlastný formát.
2. Kliknúť na Aktualizovat strukturu ze souboru.
3. Novo nájdeným elementom priradiť spôsob spracovania.
4. Uložiť a projekty s týmto vlastným formátom pregenerovať.

Tým zaručíte konzistentné spracovanie feedu aj po jeho zmenách.

FAQ#

Kedy je potrebné použiť vlastný formát na vstupe?#

Vlastný formát použijete vtedy, keď Mergado nedokáže rozpoznať štruktúru vstupného feedu a zobrazí informáciu, že formát nie je známy. Typicky ide o dodávateľské, custom, zastarané alebo výrazne upravené feedy. V týchto situáciách je nutné Mergadu vysvetliť štruktúru dát, aby ich dokázalo spracovať.

Aké typy feedov najčastejšie vyžadujú vlastný formát na vstupe?#

Najčastejšie ide o dodávateľské a custom feedy, ktoré nemajú verejnú špecifikáciu alebo sa líšia od štandardov. Patrí sem tiež doplnkové feedy, napríklad skladové, servisné alebo feedy obsahujúce služby ako recenzie či cestovné ponuky. Vlastný formát sa používa aj u upravených či zastaraných verzií inak známych formátov.

Ako prebieha vytvorenie vlastného formátu pri importe?#

Vytvorenie prebieha v 3. kroku sprievodcu založením projektu, kde zvolíte možnosť „Definovat vlastní formát“. Následne namapujete povinné elementy CHANNEL a ITEM (u XML feedov) a ďalšie položky, s ktorými budete v projekte pracovať. Na záver formát uložíte.

Čo je párovací element a prečo je tak dôležitý?#

Párovací element je údaj, ktorý umožňuje Mergadu jednoznačne identifikovať každú položku. Musí mať unikátnu hodnotu pre každý produkt – najčastejšie ide o ITEM_ID, URL alebo EAN. Bez správne nastaveného párovacieho elementu nemožno feed importovať správne ani správne párovať zmeny.

Koľko elementov je vhodné pri definícii vlastného formátu namapovať?#

Pre základnú funkčnosť stačí namapovať CHANNEL, ITEM (u XML feedov) a jeden unikátny identifikátor. Ak ale chcete minimalizovať neskoršiu prácu, je vhodné namapovať aj ďalšie elementy, pretože to zjednoduší prácu s pravidlami a uľahčí prevod na iné výstupné formáty. Detailné mapovanie zvyšuje stabilitu a prehľadnosť projektu.

Čo sa stane, keď nenamapujete niektoré dôležité elementy?#

Nenamapované elementy sa v projekte síce objavia, ale Mergado ich nebude vedieť správne využiť a bude ich potrebné dopĺňať ručne pomocou pravidiel. To vedie k vyššej pracnosti a môže spôsobiť chyby pri exporte. Presné mapovanie preto výrazne uľahčí neskoršiu prácu.

Ako postupovať, keď sa vo vstupnom feede objavia nové dátové polia?#

Je nutné otvoriť definíciu vlastného formátu a použiť voľbu „Aktualizovat strukturu ze souboru“. Mergado načíta nové elementy a vy im priradíte spôsob spracovania. Potom projekt pregenerujete, aby sa zmeny prejavili.

Môže sa vlastný formát použiť aj vtedy, keď Mergado formát pozná?#

Áno, v niektorých prípadoch môže byť výhodné vytvoriť vlastný formát aj u rozpoznaného feedu, napríklad ak chcete zachovať pôvodnú štruktúru alebo potrebujete pracovať s prvkami, ktoré štandardný prevodník neberie do úvahy. V takom prípade jednoducho zvolíte možnosť „Vybrat jiný formát“ a následne definujete vlastný.

Čo robiť, ak si nie som istý, či je vlastný formát nastavený správne?#

Odporúča sa skontrolovať načítané elementy, párovací element a štruktúru výstupného feedu projektu. Ak vidíte všetky hodnoty, s ktorými potrebujete pracovať, a dáta sa správne párujú, je formát v poriadku. Ak narazíte na problémy, je lepšie sa vrátiť do mapovania alebo kontaktovať podporu.

6. Použitie vlastného formátu na výstupe#

Vlastný formát na výstupe slúži na to, aby Mergado dokázalo generovať produktový feed v takej štruktúre, ktorú štandardne nepodporuje. Vhodný je všade tam, kde potrebujete mať výstupný súbor presne podľa špecifických požiadaviek platformy, systému alebo interných procesov.

Kedy sa výstupný vlastný formát používa#

Výstupný vlastný formát využijete predovšetkým v situáciách, keď:

• potrebujete feed pre platformu, ktorá nie je v Mergade integrovaná,
• vytvárate napojenie na nový e-commerce kanál,
• pracujete s menšími porovnávačmi alebo internými systémami s vlastnou štruktúrou dát,
• je nutné dosiahnuť konkrétnu štruktúru koreňových elementov (napr. …).

Výstupný vlastný formát umožňuje definovať podobu výsledného feedu tak, aby presne zodpovedala požadovanému formátu.

Čo je vzorový feed a prečo je potrebný#

Výstupný vlastný formát sa vytvára na základe vzorového feedu – čo je vzorový XML alebo CSV súbor obsahujúci aspoň jednu položku.

Prečo je vzorový feed dôležitý#

• Slúži ako šablóna, podľa ktorej sa Mergado naučí, ako má finálny feed vyzerať.
• Definuje koreňové elementy, ktoré chcete mať v cieľovej štruktúre.
• Môže byť úplne fiktívny – postačí jediná fiktívna položka, na ktorých hodnotách nezáleží.

Požiadavky na vzorový feed#

• Musí byť dostupný pod URL adresou.
• Musí obsahovať koreňovú štruktúru, ktorú chcete na výstupe.
• Môže mať minimálny obsah, napríklad:

<?xml version="1.0" encoding="UTF-8"?> <PRODUCTS> <PRODUCT> <ID>1</ID> </PRODUCT> </PRODUCTS>

Ako vytvoriť vzorový feed#

Existujú dva spôsoby:

1. Ručné vytvorenie súboru#

• pripravíte XML v textovom editore, alebo CSV v tabuľkovom editore
• uložíte ho na server
• sprístupníte pod URL adresou

2. Pomocou doplnku Mergado Files#

• aktivujete rozšírenie Mergado Files
• vytvoríte nový súbor
• vložíte ukážkovú položku, ktorú získate napríklad od porovnávačov
• uložíte ho ako XML alebo CSV
• získate URL, ktorú použijete pri definícii formátu

Mergado Files je ideálny, ak potrebujete vzorový feed rýchlo upravovať alebo testovať.

Postup vytvorenia vlastného formátu na výstupe#

Vlastný formát na výstup sa vytvára buď dopredu v sekcii Vlastní formáty v ľavom menu na úrovni užívateľa, alebo priamo počas vytvárania nového projektu v 4. kroku wizardu.

1. Otvorte Vlastní formáty a kliknite na Nový vlastní formát.
2. Do poľa Zdrojový soubor vložte URL vzorového feedu.
3. Formát pomenujte.
4. Namapujte elementy:

• minimom je nastavenie koreňových obaľovacích elementov (CHANNEL, ITEM),
• odporúča sa namapovať všetky elementy, ktoré budete generovať vo výstupe.

5. Uložte formát.

Po uložení sa vlastný formát stáva opakovane použiteľným. V každom projekte ho možno vybrať ako výstupný (aj ako vstupný) formát.

Ako Mergado generuje výstupný feed podľa vlastnej šablóny#

Výstupný vlastný formát určuje finálnu štruktúru feedu. Mergado pri generovaní výstupu:

• použije koreňové elementy presne tak, ako boli uvedené vo vzorovom feede,
• využije definované mapovanie pre prevod hodnôt z vášho vstupného feedu do výsledného formátu,
• zachová poradie a štruktúru elementov podľa šablóny.

Vďaka tomu možno rýchlo vytvoriť ľubovoľný XML alebo CSV feed bez nutnosti vývoja novej integrácie zo strany Mergada.

Efektivita mapovania#

Aj keď pre výstupný feed stačí namapovať minimum, výhodnejšie je definovať mapovanie čo najpodrobnejšie:

• získate lepšiu kontrolu nad výsledkom,
• znížite potrebu pravidiel pre dopĺňanie hodnôt,
• umožníte jednoduchšie opakované použitie formátu v ďalších projektoch.

FAQ#

Kedy má zmysel použiť vlastný formát na výstupe?#

Vlastný formát na výstupe použijete vždy, keď potrebujete feed v štruktúre, ktorú Mergado štandardne neponúka. Typicky ide o napojenie na novú platformu, menší porovnávač alebo interný systém s vlastnou štruktúrou. Umožňuje vám presne riadiť podobu výstupného XML alebo CSV, vrátane koreňových elementov.

Čo je vzorový (example) feed a načo slúži?#

Vzorový feed je ukážkový XML alebo CSV súbor, ktorý obsahuje aspoň jednu položku a zodpovedá cieľovej štruktúre, ktorú chcete generovať. Mergado podľa neho načíta koreňové elementy, vnútornú štruktúru a poradie elementov. Slúži ako šablóna, podľa ktorej sa výstupný feed následne generuje.

Musí byť vzorový feed reálny, alebo môže byť fiktívny?#

Vzorový feed môže byť úplne fiktívny – stačí jedna položka s minimom hodnôt. Dôležité je, aby mal správnu štruktúru elementov, nie konkrétne dáta. Hodnoty ako ID, názov alebo cena sú v tomto kontexte iba ukážkové.

Prečo musí byť vzorový feed dostupný na URL adrese?#

Mergado načítava štruktúru priamo z URL, aby ju mohlo pri analýze použiť ako zdroj pre definíciu formátu. Nahranie súboru bez URL nie je možné. Ak nemáte vlastný hosting, môžete použiť cloudové služby alebo doplnok Mergado Files.

Akým spôsobom môžem vzorový feed vytvoriť?#

Buď si pripravíte XML alebo CSV v textovom/tabuľkovom editore a uložíte ho na server s verejnou URL, alebo použijete rozšírenie Mergado Files. V Mergado Files vytvoríte nový súbor, vložíte ukážkovú položku, uložíte ho v správnom formáte a získate URL pre použitie vo vlastnom formáte. Druhá možnosť je vhodná, ak potrebujete vzorový feed priebežne upravovať.

Ako prebieha vytvorenie vlastného formátu na výstupe?#

V sekcii Vlastní formáty zvolíte „Nový vlastní formát“ a ako zdrojový súbor zadáte URL vzorového feedu. Po analýze súboru formát pomenujete a namapujete potrebné elementy, minimálne CHANNEL a ITEM. Uložený formát potom môžete vybrať ako výstupný formát v ľubovoľnom projekte. Alternatívne môžete vlastný formát vytvoriť priamo počas vytvárania nového projektu v 4. kroku wizardu kliknutím na Definovat vlastní formát a vložením URL vzorového feedu. Po uložení vlastného formátu sa vrátite späť do wizardu kde bude vytvorený vlastný formát vyplnený ako výstupný formát.

Ako Mergado použije vlastný formát pri generovaní výstupného feedu?#

Pri exporte Mergado vychádza zo šablóny načítanej zo vzorového feedu, zachová jeho koreňové elementy aj štruktúru. Pomocou mapovania prevedie hodnoty z Mergado XML do správnych elementov vo výstupe. Výsledkom je feed v podobe, ktorá zodpovedá vašim požiadavkám bez nutnosti vlastného programovania.

Čo sa stane, ak vo výstupnom formáte namapujem len minimum elementov?#

Mergado síce vytvorí výstupný feed so správnou štruktúrou, ale elementy nebudú naplnené dátami. Hodnoty nenamapovaných elementov bude nutné doplniť pravidlami alebo ďalším nastavením v projekte. Taký postup je funkčný, ale menej efektívny pri dlhodobom používaní.

Prečo je vhodné mapovať čo najviac elementov aj na výstupe?#

Detailné mapovanie vám dáva lepšiu kontrolu nad tým, ako sa dáta do výstupu zapisujú, a znižuje množstvo pravidiel, ktoré musíte v projekte vytvárať. Zároveň zjednodušuje opakované použitie rovnakého formátu v ďalších projektoch. Vyplatí sa najmä v situáciách, keď formát slúži viacerým klientom alebo viacerým e-shopom.

Dá sa výstupný vlastný formát použiť aj ako vstupný?#

Áno, akonáhle je formát raz vytvorený, je k dispozícii v zozname formátov pre vstup aj výstup. To môže byť užitočné napríklad pri transformáciách medzi rôznymi internými systémami alebo pri kontrole dát.

7. Práca so zložitejšími XML štruktúrami#

Táto sekcia popisuje situácie, keď dátový feed obsahuje prvky umiestnené mimo obvyklú štruktúru produktov, teda mimo element ITEM. U týchto feedov naráža vlastný formát na určité obmedzenia a je nutné použiť alternatívne postupy.

Obmedzenia vlastného formátu pri importe#

Vlastný formát dokáže pracovať iba s elementmi umiestnenými vnútri zvoleného obaľovacieho elementu položky (ITEM). Prvky, ktoré sa v hierarchii nachádzajú nad ním alebo mimo neho, Mergado Editor ignoruje.

Informácie medzi CHANNEL a ITEM#

• Niektoré XML feedy obsahujú ďalšiu úroveň dát medzi CHANNEL a ITEM (napr. kategórie, doprava, metadáta).
• Tieto elementy nie sú súčasťou samotnej položky, a preto nie sú pri importe načítané.

Typické príklady problémových feedov#

• XML feedy s globálnymi informáciami o kategóriách uloženými mimo produkty.
• Dátové zdroje, kde sú informácie o doprave definované na úrovni CHANNEL.
• Komplexné feedy s viacstupňovou štruktúrou medzi koreňovým elementom a jednotlivými položkami.

Riešenie: dvojprojektový model + Blending Bull#

Ak je potreba zachovať celú štruktúru XML feedu, vrátane prvkov mimo ITEM, možno použiť dvojstupňový postup:

1. Prvý projekt – obsahuje produkty.
2. Druhý projekt – obsahuje doplnkové informácie, ktoré nie sú súčasťou ITEM.
3. Zlúčenie – výstupné dáta oboch projektov sa spoja pomocou rozšírenia Blending Bull.

Ako dvojprojektový model funguje#

Zlúčenie pomocou Blending Bull#

1. Aktivujte rozšírenie Blending Bull.
2. V časti Datové zdroje vyberte výstupy oboch projektov.
3. V sekcii Soubory vytvorte nový výstupný súbor a následne vyberte vytvorené dátové zdroje z predchádzajúceho kroku.
4. Podľa potreby doplňte úpravy pomocou pravidiel.

Prečo tento postup funguje#

Každý projekt načíta iba tú časť štruktúry, s ktorou Mergado vie pracovať. Blending Bull následne umožní obe časti znovu spojiť a získať kompletný dátový výstup.

Editácia koreňových elementov na výstupe#

Koreňové elementy výstupného feedu nemožno v Mergade priamo upraviť. Ak potrebujete inú štruktúru obalových elementov, existujú dve alternatívy: úprava cez Blending Bull, alebo vytvorenie vlastnej šablóny.

Úpravy cez Blending Bull#

Blending Bull umožňuje pracovať s výstupným feedom ako s textovým súborom. Vďaka tomu možno upravovať:

• koreňové elementy,
• záhlavie,
• pätičku,
• názvy elementov.

Pravidlá typu „Najít a nahradit“

Pomocou pravidiel v Blending Bulle možno vykonať hromadné zmeny názvov elementov. Napríklad:

• SHOP → PRODUCTS, SHOPITEM → PRODUCT.

Tým možno ľahko upraviť výstupnú štruktúru bez nutnosti zásahu do projektu samotného.

Alternatívy k Blending Bullu (pre kontrolu výstupnej štruktúry)#

Existujú dva ďalšie spôsoby, ako ovplyvniť štruktúru výstupu:

1. Vytvorenie šablóny pomocou vlastného formátu

• Použijete fiktívny alebo existujúci feed s požadovanými koreňovými elementmi.
• Tento feed použijete pri tvorbe vlastného formátu na výstup.
• Mergado potom zachová koreňové elementy presne tak, ako boli v example feede.

2. Požiadanie o pridanie nového integrovaného formátu

• Ak máte špecifikáciu cieľového formátu, možno kontaktovať podporu Mergada.
• Formát môže byť pridaný medzi oficiálne podporované integrácie.
• Následne ho možno vybrať ako bežný výstupný formát.
• Pridanie nového formátu ale musí prejsť prioritizačným procesom a môže trvať dlhšie.

FAQ#

Prečo Mergado ignoruje niektoré elementy vo vstupnom XML feede?#

Vlastný formát dokáže pracovať iba s elementmi, ktoré sú umiestnené vnútri obaľovacieho elementu položky (ITEM). Všetko, čo je mimo neho – napríklad elementy medzi CHANNEL a ITEM – sa pri importe nespracuje. Tieto informácie nie sú súčasťou produktových dát, a preto ich Editor nevidí.

Ako poznám, že je feed problémový a vyžaduje špeciálny postup?#

Najjednoduchší postup je otvoriť si výstupný feed a porovnať to so vstupným feedom. Typické príklady sú feedy, kde sú kategórie, doprava alebo ďalšie metadáta umiestnené na úrovni CHANNEL alebo v niekoľkých vrstvách nad ITEM. Ak po importe niektoré dôležité údaje chýbajú, je to známka toho, že sa nachádzajú mimo štruktúru, ktorú Mergado vie načítať. V takých situáciách je nutné použiť alternatívny postup.

Čo je dvojprojektový model a kedy ho použiť?#

Dvojprojektový model sa používa, keď potrebujete zachovať alebo spracovať časti XML feedu, ktoré nepatria pod ITEM. Jeden projekt načíta produkty a druhý načíta doplnkové informácie. Následne sa oba výstupy spoja pomocou rozšírenia Blending Bull.

Ako dvojprojektový model prakticky funguje?#

V projekte s produktmi namapujete CHANNEL a ITEM predstavujúci jednotlivé položky. V projekte so špecifikáciami ponecháte rovnaký CHANNEL, ale ako ITEM zvolíte obalový element doplnkových informácií. Oba projekty načítavajú rovnaký vstupný feed a Blending Bull ich následne spojí do jedného výstupu.

Prečo je Blending Bull nevyhnutný pre zlúčenie zložitých štruktúr?#

Mergado samo o sebe nedokáže skombinovať dáta z dvoch rôznych projektov s rôznymi objektmi (produkty). Blending Bull vytvorí výstupný súbor, do ktorého môžete pridať oba výstupy a prípadne ich ešte upraviť pomocou pravidiel. Vďaka tomu získate kompletnú dátovú štruktúru, ktorá zodpovedá pôvodnému feedu.

Načo slúžia pravidlá typu „Najít a nahradit“ v Blending Bulle? #

Pomocou týchto pravidiel možno hromadne meniť názvy elementov, koreňové tagy alebo časti záhlavia a pätičky. Je to riešenie pre prípady, keď potrebujete upraviť výstupný feed tak, aby zodpovedal špecifickému formátu. Aj týmto spôsobom môžete napríklad prejmenovať SHOP na PRODUCTS alebo iné kľúčové elementy.

Dá sa v Mergade priamo upraviť koreňové elementy výstupného feedu?#

Nie, koreňové elementy nemožno v štandardnom rozhraní priamo editovať. Možno ich ovplyvniť buď tak, že vytvoríte vlastný formát na základe vzorového feedu, alebo pomocou úprav v Blending Bulle. Oba postupy zaistia správnu podobu výstupnej štruktúry.

Kedy má zmysel vytvoriť vlastnú šablónu pomocou výstupného vlastného formátu?#

Ak máte jasne danú štruktúru výstupného XML, napríklad špecifikáciu partnera alebo vlastného systému, je výstupný vlastný formát najčistejším riešením. Definíciou formátu podľa vzorového feedu zaistíte, že Mergado vždy vygeneruje dáta v požadovanom tvare. Tento postup je najstabilnejší pre dlhodobé použitie.

Je možné požiadať o pridanie nového oficiálneho formátu do Mergada?#

Áno, ak máte dokumentáciu a jasnú špecifikáciu cieľového formátu, môžete požiadať podporu o pridanie medzi oficiálne integrácie. Tento proces ale podlieha prioritizácii a môže trvať dlhšie. Ak potrebujete výsledok rýchlo, výstupný vlastný formát alebo Blending Bull je rýchlejšia cesta.

Ako poznám, že je nutné použiť dvojprojektový model?#

Ak po importe chýbajú informácie, ktoré sa nachádzajú mimo ITEM, alebo ak feed obsahuje viac úrovní nad produktmi, je dvojprojektový model obvykle jediným spôsobom, ako zachovať kompletnú štruktúru. Rovnako tak je nutný vtedy, ak potrebujete kombinovať produktové dáta s globálnymi informáciami uloženými mimo samotné položky.

8. Vysvetlenie pojmov#

Mergado XML ako univerzálny jazyk#

Mergado XML funguje ako univerzálny medziformát, cez ktorý Mergado prevádza všetky produktové dáta. Nie je nutné mať pre každý vstupný a výstupný formát samostatný prevodník – stačí jedna spoločná štruktúra, do ktorej sa dáta preložia.

Vlastný formát ako slovník a gramatické pravidlá#

Vlastný formát určuje, ako jednotlivé elementy vášho feedu „preložiť“ do Mergado XML. Ide o sadu pravidiel, ktorá umožní Mergadu rozpoznať štruktúru takmer akéhokoľvek feedu.

Vzorový feed ako cieľový jazyk#

Pri tvorbe výstupného formátu slúži vzorový feed ako definícia toho, ako má výsledná štruktúra vyzerať. Mergado z neho načíta:

• koreňovú štruktúru,
• názvy elementov,
• organizáciu položiek.

Tým získate výstupný feed presne podľa vlastnej špecifikácie.

Príklady prevodov#

• Import (dodávateľský feed → formát e-shopu)
  • Mergado pripraví štruktúru tak, aby bola kompatibilná s formátom e-shopu, vrátane cien, dostupností alebo parametrov.
• Export (interné dáta → Heureka, Google, vlastné platformy)
  • Ak platforma neponúka priamy export, možno pomocou vlastného formátu vytvoriť výstup, ktorý splní požadovanú špecifikáciu.