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ě”- Otevřete aplikaci > klikněte na Nastavení (Settings) > zapněte Sdílet metapole (Share Metafields)
- Vyberte zdroj, který chcete sdílet:
- Zdroj Produkt (Product resource) – sdílení metapolí produktů.
- Zdroj Varianta (Variant resource) – sdílení metapolí variant.
- 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.keyNapříklad:
custom.materialseo.titlespecifications.weight
-
- 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ě”- Otevřete aplikaci > klikněte na Obchody (Stores) > klikněte na adresu URL zdrojového obchodu a otevřete detail připojení

-
Zapněte Synchronizaci metapolí (Metafields sync)
-
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
-
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)


- 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_fieldvsmulti_line_text_fieldnumber_integervsnumber_decimalproduct_referencevstext
⚠️ 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ě:
- Přejděte do Shopify Admin > otevřete Nastavení obchodu > Metapole a metaobjekty > vyberte Produkt (nebo Varianta)
- 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.materialve 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
❓Časté dotazy
Sekce “❓Časté dotazy”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:
- Přejděte do Shopify Admin > Nastavení > Vlastní data > Produkty
- Klikněte na metapole, které chcete synchronizovat
→ Zobrazí se hodnoty Namespace a Key - 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:
- 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ě.

- 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

- 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

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