XML Feed — Kategorie

Feed pro import kategorií e-shopu do UpSearch. Kategorie se zobrazují ve výsledcích vyhledávání a v našeptávači.

Struktura

<?xml version="1.0" encoding="utf-8"?>
<categories>
    <title>Název e-shopu</title>
    <link>https://www.example.com/</link>
    <item>
        <!-- data kategorie -->
    </item>
</categories>

Parametry položky

Parametr	Typ	Povinný	Popis
id	integer	✅ Ano	Unikátní identifikátor kategorie
name	string	✅ Ano	Název kategorie
url	string (URL)	✅ Ano	URL stránky kategorie
hierarchy	string	❌ Ne	Hierarchická cesta oddělená | (např. "Elektronika | Mobilní telefony")
image	string (URL)	❌ Ne	Obrázek kategorie
is_empty	boolean	❌ Ne	true pokud kategorie neobsahuje žádné produkty

Hierarchy

Element hierarchy umožňuje zobrazit cestu ke kategorii ve vyhledávání (breadcrumb). Oddělovač je | (mezera, svislítko, mezera).

Prázdné kategorie

Doporučujeme posílat <is_empty>false</is_empty> u kategorií s produkty. Prázdné kategorie (is_empty=true) mohou být ve vyhledávání potlačeny.

Příklad

<?xml version="1.0" encoding="utf-8"?>
<categories>
    <title>Název e-shopu</title>
    <link>https://www.example.com/</link>

    <!-- Kořenová kategorie -->
    <item>
        <id>101</id>
        <name>Elektronika</name>
        <url>https://www.example.com/elektronika/</url>
        <is_empty>false</is_empty>
    </item>

    <!-- Podkategorie s hierarchií -->
    <item>
        <id>102</id>
        <name>Mobilní telefony</name>
        <url>https://www.example.com/elektronika/mobilni-telefony/</url>
        <hierarchy>Elektronika | Mobilní telefony</hierarchy>
        <image>https://www.example.com/images/categories/mobily.jpg</image>
        <is_empty>false</is_empty>
    </item>

    <!-- Podkategorie 2. úrovně -->
    <item>
        <id>103</id>
        <name>Samsung Galaxy</name>
        <url>https://www.example.com/elektronika/mobilni-telefony/samsung-galaxy/</url>
        <hierarchy>Elektronika | Mobilní telefony | Samsung Galaxy</hierarchy>
        <is_empty>false</is_empty>
    </item>

    <!-- Prázdná kategorie -->
    <item>
        <id>104</id>
        <name>Gramofony</name>
        <url>https://www.example.com/gramofony/</url>
        <is_empty>true</is_empty>
    </item>
</categories>

Validátor feedu

Ověřte strukturu vašeho feedu pomocí XML Feed Validátoru — zkontroluje povinná pole a datové typy.