Přeskočit na obsah

Hledejte návody pro Multistore Inventory Sync.

    Stáhnout MarkdownUložit kopii tohoto návodu

    Synchronizace metapolí

    Přehled od AI

    Zjistěte, jak v Tipo Sync synchronizovat metapole produktů a variant ze zdrojového obchodu do cílového. Ve zdrojovém obchodě zapnete sdílení metapolí a v cílovém obchodě synchronizaci metapolí, poté vyberete, která metapole se mají synchronizovat, pomocí namespace.key. Datové typy se musí mezi oběma obchody přesně shodovat.

    Zobrazit víceZobrazit méně
    • Typy odkazů (reference) a MetaObjects nejsou podporovány; datové typy metapolí musí být v obou obchodech stejné.
    • Ve zdrojovém obchodě otevřete Settings, zapněte Share Metafields, zvolte zdroj Product nebo Variant a přidejte definice ve tvaru namespace.key.
    • V cílovém obchodě otevřete Stores, otevřete detail propojení, zapněte Metafields sync a vyberte zdroje.
    • Klikněte na Save; chybějící definice se v cílovém obchodě vytvoří automaticky.
    • Prázdná hodnota ze zdroje nikdy nepřepíše existující hodnotu v cílovém obchodě.

    Shrnutí vytvořené umělou inteligencí. Může obsahovat chyby, proto si přečtěte celý návod níže.

    Tento návod vysvětluje, jak v aplikaci Tipo synchronizovat metapole ze zdrojového obchodu do cílového obchodu.

    ℹ️ Co jsou metapole?

    Sekce “ℹ️ Co jsou metapole?”
    • Metapole produktů
    • Metapole variant (pokud tuto možnost povolíte)

    Aplikace Tipo dokáže synchronizovat metapole pro:

    • materiál, tabulku velikostí, specifikace
    • vlastní štítky (např. „best_seller“)
    • další podrobnosti o produktu používané šablonami či aplikacemi

    Metapole jsou vlastní pole v Shopify, do kterých se ukládají doplňující data o produktu, například:


    ✅ Podporované typy metapolí

    Sekce “✅ Podporované typy metapolí”
    • Víceřádkový text
    • Formátovaný text
    • Celé číslo
    • Desetinné číslo
    • Datum a čas
    • Datum
    • Rozměr
    • Objem
    • Hmotnost
    • Ano nebo ne
    • Hodnocení
    • URL
    • Peníze
    • Odkaz
    • JSON

    🚫 Zatím nepodporováno:
    Referenční typy (např. odkaz na produkt, odkaz na kolekci) momentálně nejsou podporovány.


    🛠️ Krok 1: Nastavení metapolí ve zdrojovém obchodě

    Sekce “🛠️ Krok 1: Nastavení metapolí ve zdrojovém obchodě”
    1. Otevřete aplikaci > klikněte na Nastavení (Settings) > zapněte Sdílet metapole (Share Metafields)
    2. Vyberte zdroj, který chcete sdílet:
      • Zdroj Produkt (Product resource) – sdílení metapolí produktů.
      • Zdroj Varianta (Variant resource) – sdílení metapolí variant.
    3. Přidáním konkrétních definic metapolí omezíte, která metapole se sdílejí.
      • Klikněte na ikonu Procházet metapole (Browse metafields), nebo

      • zadejte definici metapole ve formátu:

        namespace.key

        Například:

        custom.materialseo.titlespecifications.weight
    4. Click Save to update the changes

    🛠️ Krok 2: Nastavení metapolí v cílovém obchodě

    Sekce “🛠️ Krok 2: Nastavení metapolí v cílovém obchodě”
    1. Otevřete aplikaci > klikněte na Obchody (Stores) > klikněte na adresu URL zdrojového obchodu a otevřete detail připojení
    1. Zapněte Synchronizaci metapolí (Metafields sync)

    2. Vyberte, co se má synchronizovat

      V části Povolená data (Allow data) vyberte jednu nebo obě možnosti:

      • Zdroj Produkt (Product Resource) → synchronizace metapolí produktů
      • Zdroj Varianta (Variant Resource) → synchronizace metapolí variant
    3. Klikněte na ikonu vyhledávání vpravo, zobrazí se všechna podporovaná metapole > klikněte na tlačítko Vybrat platné metapole k synchronizaci (Select valid metafield to sync)

    1. Kliknutím na Uložit změny uložíte

    🔄 Co se děje během synchronizace

    Sekce “ 🔄 Co se děje během synchronizace”

    1) Pokud cílový obchod nemá definici metapole

    Sekce “1) Pokud cílový obchod nemá definici metapole”

    Aplikace definici metapole v cílovém obchodě automaticky vytvoří (v případě potřeby).

    Po jejím vytvoření se synchronizované hodnoty metapolí zobrazí u produktu či varianty v cílovém obchodě.

    2) Pokud metapole existují, ale nejsou „strukturovaná“ (nestrukturovaná metapole)

    Sekce “2) Pokud metapole existují, ale nejsou „strukturovaná“ (nestrukturovaná metapole)”

    V některých případech se metapole synchronizují, i když v cílovém obchodě nejsou plně definována či strukturována.

    Chcete-li je zkontrolovat v Shopify Admin:

    • otevřete Nastavení obchodu → Metapole a metaobjekty
    • Vyberte Produkt (nebo Varianta)
    • Otevřete Zobrazit nestrukturovaná metapole

    💡 Tip: Tato metapole můžete později ručně definovat a strukturovat, aby byla data ve vašem obchodě přehledná a konzistentní.

    3) Pokud zdrojový obchod nemá hodnotu, cílová se nepřepíše

    Sekce “3) Pokud zdrojový obchod nemá hodnotu, cílová se nepřepíše”

    Pokud metapole v cílovém obchodě existuje, ale zdrojová hodnota je prázdná, Tipo Sync hodnotu v cílovém obchodě nepřepíše.

    4) Datové typy se musí shodovat (velmi důležité)

    Sekce “4) Datové typy se musí shodovat (velmi důležité)”

    Datové typy metapolí se musí mezi zdrojovým a cílovým obchodem přesně shodovat.

    Příklady neshody datových typů:

    • single_line_text_field vs multi_line_text_field
    • number_integer vs number_decimal
    • product_reference vs text

    ⚠️ Pokud se datové typy neshodují, synchronizace může selhat nebo se dané metapole přeskočí.


    📌 Příklad: Synchronizace metapole produktu – „Materiál“

    Sekce “📌 Příklad: Synchronizace metapole produktu – „Materiál“”

    Chcete pomocí naší aplikace synchronizovat vlastní metapole produktu s názvem Materiál (např. „Cotton“, „Leather“, „Wool“) ze zdrojového obchodu do cílového obchodu.

    Krok 1: Definujte metapole v Shopify

    Sekce “Krok 1: Definujte metapole v Shopify”

    Ve vašem zdrojovém obchodě:

    1. Přejděte do Shopify Admin > otevřete Nastavení obchodu > Metapole a metaobjekty > vyberte Produkt (nebo Varianta)
    2. Klikněte na Přidat definici (pokud ještě nebyla vytvořena) > vyplňte definici metapole:
      • Název: Material
      • Jmenný prostor (Namespace): custom
      • Klíč (Key): material
      • Typ: Jednořádkový text

    => Tím získáte úplný klíč metapole: custom.material

    Tento krok zopakujte i ve svém cílovém obchodě (klíč a typ se musí shodovat).

    Krok 2: Přidejte data metapole k produktům

    Sekce “Krok 2: Přidejte data metapole k produktům”

    Ve zdrojovém obchodě otevřete produkt a sjeďte dolů do části Metapole > pod Material zadejte: Cotton

    Tento produkt má nyní metapole custom.material = "Cotton".

    Krok 3: Nastavte synchronizaci v aplikaci Tipo

    Sekce “Krok 3: Nastavte synchronizaci v aplikaci Tipo ”
    • Otevřete naši aplikaci v cílovém obchodě > přejděte na Konfigurace připojení > Synchronizace metapolí
    • Zvolte Konkrétní metapole > zadejte klíč metapole přesně: custom.material

    Výsledek

    • Naše aplikace najde custom.material ve zdrojovém obchodě
    • Pokud u produktu v cílovém obchodě neexistuje, aplikace jej vytvoří
      => Výsledek: custom.material = "Cotton" v obou obchodech
    • Pokud v cílovém obchodě existuje, ale zdroj je prázdný, hodnotu nepřepíšeme

    Q1: Jak ve svém obchodě zjistit namespace.key?

    Sekce “Q1: Jak ve svém obchodě zjistit namespace.key?”

    Chcete-li synchronizovat konkrétní metapole, musíte zadat klíč definice metapole ve formátu: namespace.key (například: custom.color).

    Takto jej najdete ve svém Shopify Admin:

    1. Přejděte do Shopify Admin > Nastavení > Vlastní data > Produkty
    2. Klikněte na metapole, které chcete synchronizovat
      → Zobrazí se hodnoty Namespace a Key
    3. Spojte je ve formátu: namespace.key
      → Příklad: custom.description

    Q2: Proč se moje metapole nesynchronizují?

    Sekce “Q2: Proč se moje metapole nesynchronizují?”

    Pokud se vaše metapole nesynchronizují správně, může to mít jednu z následujících příčin:

    1. Synchronizace metapolí není povolena
      Ujistěte se, že je synchronizace metapolí zapnutá v obou obchodech:
      • Povolte Sdílet metapole ve zdrojovém obchodě.
      • Povolte Přijímat metapole (Receive Metafields) v cílovém obchodě.
    1. Není přidán klíč definice metapole

    Kromě povolení synchronizace metapolí musíte také přidat klíč definice metapole (namespace.key), který chcete synchronizovat.

    • Přejděte do Nastavení → Sdílet metapole
    • Ujistěte se, že je zaškrtnuto Povolit
    • V části Povolená data přidejte definici metapole ve formátu:
      namespace.key
      Příklad: custom.material
    1. Nepodporované typy metapolí
      Některé datové typy metapolí nejsou podporovány, například referenční typy nebo metaobjekty.

    Červeně: nepodporovaná metapole, která aplikace nemůže synchronizovat

    1. Neshodující se typy metapolí mezi obchody
      Metapole ve zdrojovém a cílovém obchodě musí mít stejný datový typ a strukturu.
      Časté neshody:
    • Jedno metapole je Jednořádkový text, zatímco druhé je Víceřádkový text.
    • Jedno metapole používá Jednu hodnotu, zatímco druhé Seznam hodnot.

    Tyto problémy vyřešíte tak, že ověříte, že metapole v obou obchodech mají stejný namespace, key a datový typ, a poté synchronizaci zkusíte znovu.


    🙋 Potřebujete další pomoc?

    Pokud stále potřebujete pomoc, napište nám na hi@tipo.io. Rádi vám dále pomůžeme.