Pravidlo: Import datového souboru (CSV / XML)

Nápověda
, , , , , , ,
1

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

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í.
        • :light_bulb: 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
      • :light_bulb: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.
      • :warning: 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

:light_bulb: 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.
    • :light_bulb: 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).

:light_bulb: 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).

:light_bulb: 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.

:light_bulb: 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.

:light_bulb: 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.

:light_bulb: 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.