# Synchronizace metapolí

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

### ℹ️ 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í**

* 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ě

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

<figure><img src="/media/4360c99527c6a4de655c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

<figure><img src="/media/7a7d4dfafe848ed0a876.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

***

### 🛠️ 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í

<figure><img src="/media/b99e7e334515ad4e086d.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. Zapněte **Synchronizaci metapolí (Metafields sync)**
3. 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
4. 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)**&#x20;

<figure><img src="/media/4360c99527c6a4de655c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

<figure><img src="/media/7a7d4dfafe848ed0a876.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

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

***

### &#x20;🔄 Co se děje během synchronizace

#### **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)**

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

<figure><img src="/media/755ea231da077f6819c8.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **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é)**

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“

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

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

<figure><img src="/media/e68676d721f26cb93ef7.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **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"`.

<figure><img src="/media/97a6ddb98ed50e435682.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Krok 3: Nastavte synchronizaci v aplikaci Tipo**&#x20;

* Otevřete naši aplikaci v **cílovém obchodě** > přejděte na Konfigurace připojení **> Synchronizace metapolí**
* Zvolte **Konkrétní metapole > z**adejte klíč metapole přesně: `custom.material`&#x20;

<figure><img src="/media/7a7d4dfafe848ed0a876.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

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

***

### ❓Časté dotazy

#### 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í?

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

<figure><img src="/media/4360c99527c6a4de655c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. **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`&#x20;

<figure><img src="/media/f4d2b012b6b982aa41e6.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

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

<figure><img src="/media/85f75cd1117f373c78df.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

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