XML Feedy UpSearch
UpSearch podporuje import dat z e-shopu pomocí XML feedů. Každý typ obsahu má vlastní feed a vlastní kolekci v UpSearch.
Podporované typy feedů
| Feed | Kořenový element | Popis | Povinný |
|---|---|---|---|
| Produkty | <products> | Hlavní produktový feed s cenami, variantami, badge | ✅ Ano |
| Produkty — doplňkový | <products> | Aktualizace cen a skladů (každých 10 min) | ❌ Ne |
| Kategorie | <categories> | Kategorie e-shopu s hierarchií | ❌ Ne |
| Značky | <brands> | Výrobci a značky | ❌ Ne |
| Články | <articles> | Blogové články a rádce | ❌ Ne |
| Stránky | <pages> | Statické stránky (obchodní podmínky, kontakt apod.) | ❌ Ne |
| Obsahy | <contents> | Články + stránky v jednom feedu | ❌ Ne |
| Pobočky | <branches> | Kamenné prodejny a výdejní místa | ❌ Ne |
Společná struktura
Všechny feedy mají společný základ:
<?xml version="1.0" encoding="utf-8"?>
<{root_element}>
<title>Název e-shopu</title>
<link>https://www.example.com/</link>
<item>
<!-- data položky -->
</item>
<item>
<!-- další položka -->
</item>
</{root_element}>
Pravidla
- Kódování: UTF-8
- ID: Každá položka musí mít unikátní
<id>v rámci feedu - URL: Všechny URL musí být absolutní (včetně
https://) - Obrázky: Doporučené minimální rozlišení — 50×50 px (autocomplete), 500×500 px (detail)
- HTML v textu: Element
<text>může obsahovat HTML — musí být escapované (<h3>) nebo v CDATA
Frekvence importu
| Typ feedu | Interval | Popis |
|---|---|---|
Hlavní (feed_type = 1) | Každých 30 minut | Plný nahrazující import |
Doplňkový (feed_type = 2) | Každých 10 minut | Aktualizace cen a skladů |
Nastavení feedu v administraci
- Přihlaste se do UpSearch administrace
- Přejděte do Nastavení → Feedy
- Klikněte na Přidat feed
- Vyplňte URL feedu a vyberte typ
- Feed se automaticky naimportuje
Doplňkový feed
Pokud se ceny nebo sklady mění častěji, vytvořte doplňkový feed (typ „Doplňkový") jen s poli id, price, price_view, stock_info a store_count. Importuje se každých 10 minut.
Validátor feedu
Před nastavením feedu v administraci si můžete ověřit jeho strukturu pomocí XML Feed Validátoru. Validátor zkontroluje, zda feed obsahuje všechna povinná pole ve správném formátu.