Pravidlo: Import dátového súboru (CSV / XML)#

Pomocou pravidla Import dátového súboru môžete importovať dáta z externého XML alebo CSV súboru do už existujúcich položiek vo vašom projekte. Súbor možno do pravidla nahrať priamo ako upload, alebo zadať URL adresu, z ktorej sa dáta pravidelne načítavajú. Týmto spôsobom môžete obohatiť produktové dáta napríklad o dostupnosť, výkonnostné štatistiky, marže alebo iné doplňujúce informácie.

Extra funkcie#

  • Režim mapování:
    • Klíč se shoduje – hodnoty párovacieho elementu sú v zdroji aj v Mergade úplne rovnaké.
      • Hodnota z importovaného súboru sa načíta iba vtedy, ak sa hodnota v importe rovná hodnote párovacieho elementu v projekte.
      • Typicky sa používa na párovanie podľa unikátneho ID produktu.
    • Klíč je obsažen – hodnoty párovacieho elementu sa čiastočne zhodujú.
      • Hodnota z importovaného súboru sa načíta iba vtedy, ak je párovacia hodnota z importu obsiahnutá v hodnote párovacieho elementu v projekte.
      • Typicky sa používa pri párovaní podľa kľúčového slova v názve alebo kategóriách produktu.
  • Podporované typy súboru:
    • XML
    • CSV
    • Google Sheets (cez zverejnenie Sheetu ako CSV na verejnej URL adrese)
  • Spôsob napojenia súboru:
    • Nahrání souboru (upload) – jednorazový import.
      • Ak sa dáta v súbore zmenia, je nutné súbor znova ručne nahrať.
    • Zadání URL – dynamické napojenie.
      • Ak sa dáta v súbore zmenia, nové hodnoty sa načítajú automaticky pri každom pregenerovaní projektu.
  • Oddělovač polí:
    • Čiarka, bodkočiarka, zvislítko – podľa formátu v zdrojovom súbore (čiarka je predvolená)

Konkrétne príklady#

Príklad 1: Import skladovej dostupnosti z Heureka dostupnostného XML feedu#

Tento príklad ukazuje, ako pomocou pravidla Import dátového súboru (CSV / XML) obohatiť štandardný produktový feed o informácie o dostupnosti produktov z externého XML feedu (napr. Heureka).

1. Príprava projektu pred importom – pred samotným importom je potrebné pripraviť projekt tak, aby potom import fungoval.

  • Názvy elementov, ktoré chcete importovať (alebo názvy stĺpcov v CSV súbore), musia byť zhodné s názvami elementov v projekte, do ktorých budete dáta zapisovať.
  • Ak chcete importovať element, ktorý v projekte zatiaľ neexistuje, je potrebné ho vytvoriť ručne:
    • Otvorte stránku Elementy.
    • Kliknite na tlačidlo Nový element.
    • Zadajte názov elementu a potvrďte vytvorenie.
  • Elementy, do ktorých budete importovať, môžu byť skryté – ich viditeľnosť nemá vplyv na import.

2. Vytvorenie nového pravidla:

  • Otvorte stránku Pravidla.
  • Kliknite na tlačidlo Nové pravidlo.

3. Výber typu pravidla:

  • V poli Typ pravidla vyberte možnosť Import dátového súboru (CSV / XML).

4. Výber produktov:

  • V poli Výběr zvoľte buď Všechny produkty, alebo vytvorte vlastný Produktový výběr pre špecifické produkty, na ktoré chcete pravidlo použiť.

5. Zdroj dátového súboru:

  • Pomocou prepínača (Radio button) vyberte, odkiaľ sa má súbor načítať:
    • Zadat URL
      • V poli URL adresa vložte adresu k XML alebo CSV súboru (napr. URL dostupnostného feedu z Heureky).
      • Kliknite na tlačidlo Import.
      • Mergado automaticky detekuje, či ide o CSV alebo XML, a podľa toho prispôsobí rozhranie pravidla.
    • Nahrát soubor z počítače
      • V poli Datový soubor kliknite na tlačidlo Nahrát soubor a vyberte súbor z počítača (napr. Heureka dostupnostný feed).
      • Mergado opäť automaticky rozpozná formát a prispôsobí nastavenie.
      • 💡 Tip: Maximálna veľkosť nahraného súboru je 25 MB.

6. Element ohraničující položku (iba pre XML import):

  • V poli Element ohraničující položku nastavte element, ktorý v XML súbore ohraničuje položku (typicky je to napríklad SHOPITEM alebo ITEM), vrátane nadradeného koreňového (tzv. ROOT) elementu.
    • V našom prípade použijeme: item_list | item

7. Párovací element v aktuálnom projekte:

  • Vyberte element z aktuálneho projektu v Mergade, podľa ktorého chcete párovať produkty s dátami z importovaného súboru, napríklad id produktu: g:id
    • 💡Tip: Ak je to možné, vyberajte párovací element zo vstupného feedu projektu. Umožní to rýchlejšie vyhodnocovanie a spracovanie pravidla pri pregenerovaní projektu

8. Párovací element v importovanom súbore:

  • Vyberte element z importovaného súboru, ktorý obsahuje hodnoty zodpovedajúce vybranému párovaciemu elementu v aktuálnom projekte, napr. atribút s id produktu v Heureka dostupnostnom feede: @id

9. Párovať podľa vstupných hodnôt:

  • Checkbox Párovat podle vstupních hodnot je defaultne zapnutý.
    • Ak je aktívny, dáta sa párujú podľa pôvodných hodnôt zo vstupného feedu projektu (pred akoukoľvek úpravou Mergadom).
    • Ak ho vypnete, párovanie prebehne podľa hodnôt, ktoré už mohli byť upravené inými pravidlami.
    • ⚠️ Upozornenie: Vypnutie tejto voľby môže spomaliť spracovanie dát.

10. Pokročilé nastavenia:

  • V sekcii Pokročilá nastavení nastavte:
    • Režim mapování pomocou Selectboxu
      • v našom prípade použijeme režim Klíč se přesně shoduje
    • či Rozlišovat velikost písmen pomocou Checkboxu
      • v našom prípade necháme checkbox vypnutý

11. Pomenovanie pravidla:

  • V poslednom kroku zadajte názov pravidla, napríklad Import dostupnosti.

Ďalšie využitie pravidla#

  • Jednorazový import EAN kódov alebo iných hodnôt (napríklad: GPSR údaje alebo URL adresy chýbajúcich obrázkov)
  • Napojenie dynamických hodnôt z Google Sheets do Mergada
    • Výkonnostné dáta z Google Analytics (kliky, zobrazenia, objednávky)
    • Sezónnosť produktov
    • Skladové zásoby
  • Import custom_label pre PPC
  • Import dát pre segmentáciu a nastavenie custom_label pre PPC
  • Import nákupných cien a marží pre automatický pricing pomocou rozšírenia Pricing Fox
  • Import prekladov (ak mám preklady v inom jazyku v inom feede a potrebujem ich dostať do Mergada)

FAQ#

Na čo slúži pravidlo Import dátového súboru?#

Pravidlo slúži na import externých dát z XML alebo CSV súboru do už existujúcich produktov v projekte Mergado. Môžete tak obohatiť feed o informácie, ktoré pôvodný zdroj neobsahuje – napr. skladovú dostupnosť, maržu, nákupnú cenu, výkonnostné štatistiky alebo dynamické štítky pre PPC kampane.

Aké formáty súborov Mergado podporuje?#

  • XML (napr. Heureka dostupnostný feed)
  • CSV (napr. tabuľkový export z interného systému alebo ERP)
  • Google Sheets, ak je publikovaný ako CSV na verejnej URL adrese

💡 Maximálna veľkosť nahraného súboru je 25 MB.

Aký je rozdiel medzi nahraním súboru a zadaním URL adresy?#

  • Nahrání souboru (upload) – Jednorazový import. Ak sa dáta v súbore zmenia, je potrebné súbor ručne nahrať znova.
  • Zadání URL adresy – Dynamické napojenie. Pri každom pregenerovaní projektu sa automaticky načítajú aktuálne hodnoty z externého súboru.
  • 💡 Odporúčané pre dátové zdroje, ktoré sa pravidelne aktualizujú (napr. dostupnosť, ceny, výkonnosť).

Čo znamená „Element ohraničující položku“ pri XML importe? #

Tento prvok určuje, ktorý XML uzol predstavuje jednotlivý produkt. Napr. v Heureka feede je to SHOPITEM, v iných XML feedoch to môže byť ITEM alebo PRODUCT. V Mergade sa zapisuje aj s koreňovým elementom, napr.: item_list | item.

Ako prebieha párovanie produktov medzi importovaným súborom a projektom?#

Pomocou párovacích elementov:

  • V aktuálnom projekte vyberiete element, podľa ktorého sa majú produkty párovať (napr. g:id).
  • V importovanom súbore vyberiete zodpovedajúci element alebo atribút (napr. @id).

💡 Ideálne je, keď hodnoty týchto elementov sú jedinečné a zhodné medzi projektom a súborom.

Aký je rozdiel medzi režimom „Klíč se shoduje“ a „Klíč je obsažen“? #

  • Klíč se shoduje – hodnoty párovacích elementov musia byť úplne rovnaké (123 = 123).
    Používa sa napr. pri párovaní podľa ID produktov.
  • Klíč je obsažen – párovanie prebieha, ak sa hodnota v párovacom elemente z importu nachádza vnútri hodnoty v párovacom elemente v projekte (napr. 123 je obsiahnutý v SKU_12345). Vhodné na párovanie podľa časti textu (napr. názvu alebo kategórie).

Na čo slúži voľba „Párovat podle vstupních hodnot“? #

Táto voľba určuje, či Mergado bude pri párovaní používať:

  • vstupné hodnoty zo zdrojového feedu (predvolené nastavenie), alebo
  • hodnoty po aplikácii pravidiel (ak voľbu vypnete).

💡 Odporúča sa ponechať zapnuté – párovanie je potom stabilnejšie a rýchlejšie. Vypnutie môže spomaliť generovanie projektu. Pozor však na to, či zvolený párovací element z projektu má vstupné hodnoty. Ak nemá, je potrebné túto voľbu vypnúť, inak párovanie nebude fungovať

Čo znamená možnosť „Rozlišovat velikost písmen“ v pokročilom nastavení? #

Ak je voľba aktívna, párovanie berie ohľad na rozdiel medzi malými a veľkými písmenami.
Napr. ABC ≠ Abc.
Ak ju necháte vypnutú (odporúčané), Mergado ignoruje rozdiel medzi veľkosťou písmen.

Čo sa stane, ak niektorý element z importovaného súboru v projekte neexistuje?#

Import nebude fungovať, kým si daný element v projekte nevytvoríte ručne (s rovnakým názvom).
Na stránke Elementy kliknite na Nový element, zadajte názov (napr. availability) a potvrďte.
Element môže byť aj skrytý – viditeľnosť neovplyvňuje import.

Môžem importovať viac hodnôt naraz (napr. dostupnosť, cenu a EAN)?#

Áno. Pravidlo Import dátového súboru umožňuje import viacerých stĺpcov (CSV) alebo elementov (XML) súčasne, ak sú správne mapované.

Ako môžem import využiť pre dáta z Google Sheets?#

  1. V Google Sheets kliknite na Soubor → Sdílet → Publikovat na webu.
  2. Vyberte formát CSV a skopírujte vygenerovanú URL.
  3. Túto URL vložte do poľa URL adresa v pravidle Import dátového súboru.
  4. Pri každom pregenerovaní Mergado načíta aktuálne dáta zo Sheetu.

💡 Týmto spôsobom možno napojiť napr. dynamické štítky, výkonnostné dáta alebo denné ceny.

Ako skontrolujem, že sa dáta správne importovali?#

Po uložení a aplikovaní pravidiel alebo po pregenerovaní feedu môžete:

  • otvoriť stránku Produkty, nájsť konkrétny produkt a overiť, že sa nové dáta objavili v príslušných elementoch,
  • alebo použiť funkciu Průchod pravidly, ktorá zobrazí, ako boli dáta napárované a načítané.

💡 Ak sa hodnoty neimportovali, skontrolujte názvy elementov a párovacie kľúče.

Dá sa pravidlo použiť aj na jednorazový import dát?#

Áno. Pre jednorazové doplnenie (napr. EAN kódov alebo GPSR údajov) stačí súbor nahrať ručne. Pravidlo však v projekte musí zostať, inak sa nahrané dáta opäť zmažú.

Možno pomocou pravidla importovať aj výkonnostné dáta z Google Analytics alebo iných nástrojov?#

Áno, ak máte dáta dostupné v CSV (alebo XML) formáte. Alternatívnym riešením je využiť rozšírenie Bidding Fox Elements, ktoré tieto dáta do Mergada načítava automaticky. Napríklad môžete importovať počty klikov, zobrazení alebo objednávok podľa produktového ID. Týmto spôsobom obohatíte feed o výkonnostné metriky, ktoré možno následne využiť na optimalizáciu biddingových stratégií.

Čo robiť, keď import neprebehne správne?#

Skontrolujte:

  1. či je súbor prístupný (URL je verejná, nevyžaduje prihlásenie),
  2. že má správne kódovanie UTF-8,
  3. že názvy elementov/stĺpcov zodpovedajú názvom v projekte,
  4. a že je párovanie správne nastavené.

💡 Na testovanie môžete nahrať súbor s menším počtom položiek a overiť, či sa správne mapuje.

Dá sa import využiť aj pre automatické cenotvorby (napr. marže, nákupné ceny)?#

Áno. Pomocou importu možno do feedu pridať napr. nákupné ceny alebo marže, ktoré následne využijete v pravidlách Výpočet alebo Zaokrúhliť číslo pre dynamický pricing. V kombinácii s rozšírením Pricing Fox možno dokonca plne automatizovať úpravu cien.

Súvisiace články

Bol tento článok užitočný?