Datové feedy

Datový feed umožňuje třetím stranám číst data z vašeho e-shopu ve strojově čitelné formě, zpravidla v datovém formátu XML. Nejčastěji se datové feedy využívají pro export zboží na srovnávače cen jako jsou Heureka či Zboží anebo pro tzv. mapu webu, čili sitemap pro vyhledávače.

V ContOSu lze uživatelsky definovat řadu takových feedů. Navíc je možné využít funkce, které dokáží do takového feedu filtrovat pouze specifické záznamy, např. produkty od určité ceny, produkty z určitých kategorií nebo produkty s nějakou přiřazenou specifickou vlastností.

Je také možné, aby každý feed měl svou vlastní URL adresu.

Definice v ContOSu

Datový feed se definuje v nastavení e-shopu na kartě Adresy. Přepneme se na typ adresy zboží a můžeme začít definovat jednotlivé feedy.


Každý feed má svou jedinečnou URL adresu, kterou pak předáváte třetí straně: zpravidla jí uvedete tam, kde bude potřeba zadat URL adresu feedu. Definice feedu, který je určený pro srovnávač zboží Heureka, a který exportuje pouze zboží z určité kategorie (v tomto příkladě je ID 259 kategorie Počítače) a s rozsahem cen od 11900 do 40000 Kč pak vypadá takto:

Po zadání jeho URL adresy do prohlížeče získáme tento výstup:

Podporované typy feedů

Klíčové slovo se zapisuje jako součást parametru adresy (querystring)

  • Heureka: feedtype=heureka
  • Seznam Zboží: feedtype=zbozi
  • Google Nákupy / Facebook: feedtype=google
  • Můj antikvariát: feedtype=mujantikvariat
  • Sitemap: feedtype=sitemap
  • Newsletter: feedtype=newsletter

Podporované výstupní formáty

Klíčové slovo se zapisuje jako součást parametru adresy (querystring)

  • xml: format=xml
  • json: format=json
  • csv: format=csv

Další podpora

  • jazyk, lze si zvolit, v jakém jazyce (čeština, slovenština, angličtina a němčina) se exportují názvy produktů, kategorií a vlastností: lang=CS|SK|EN|DE
  • měna, lze určit, v jaké měně (měna definována v ContOSu) budou exportovány údaje o cenách: currency=CZK|EUR

Filtrování dat

V URL lze specifikovat podmínky, dle kterých se data pro feed vybírají. Vyhledávací podmínky se definují jako querystring.

Kategorie zboží

Nejprve zjistíme ID  kategorie, kterou chceme do feedu zahrnout a to tak, že v číselníku kategorií si zobrazíme detail kategorie a v záhlaví přečteme její ID.

kat=<id>

Kategorií může být více, pak je oddělíme čárkou. Např.  kat=259,262,270

Štítek zboží

Nejprve zjistíme ID  štítku, které mají produkty, jež chceme do feedu zahrnout a to tak, že v číselníku štítků si ID přečteme.

tag=<id>

Kategorií může být více, pak je oddělíme čárkou. Např.  tag=1,2

Rozpětí cen

Parametr p-min představuje minimální cenu a parametr p-max cenu maximální. Rozpětí cen od 100 do 40000 včetně pak bude vypadat takto:

p-min=100&p-max=40000

Vlastnost produktu

Do feedu můžeme filtrovat i produkty s nějakou konkrétní vlastností a její hodnotou. Opět si nejprve z číselníku vlastností zjistíme ID dané vlastnosti.

Parametr pro filtr pak zapíšeme ve tvaru id-vlastnosti=hodnota|id-hodnoty

Hledání

Produkty můžeme také specifikovat řetězcem, dle kterého se mají vyhledat. Zápis, kde vybereme pouze produkty s názvem "Acer", bude vypadat takto:

search=Acer


Tip: Všechny tyto parametry lze kombinovat. Jednotlivé skupiny parametrů oddělujeme znakem &.