# Synkronoi metakentät

Tämä opas kertoo, miten synkronoit metakenttiä lähdekaupasta kohdekauppaan Tipo-sovelluksessa.

### ℹ️ Mitä metakentät ovat?

* **Tuotteen metakentät**
* **Variantin metakentät** (jos otat sen käyttöön)

Tipo-sovellus voi synkronoida metakenttiä seuraaville:

* materiaali, kokotaulukko, tekniset tiedot
* mukautetut merkit (esim. ”best\_seller”)
* teemojen tai sovellusten käyttämät lisätuotetiedot

Metakentät ovat Shopifyn mukautettuja kenttiä, joilla tallennetaan lisätietoja tuotteista, kuten:

***

### ✅ **Tuetut metakenttätyypit**

* Multi-line text
* Rich text
* Integer
* Decimal
* Date and time
* Date
* Dimension
* Volume
* Weight
* True or false
* Rating
* URL
* Money
* Link
* JSON

🚫 **Ei vielä tuettu:**\
Viitetyypit (esim. tuotteeseen tai kokoelmaan viittaava kenttä) eivät ole tällä hetkellä tuettuja.

***

### 🛠️ Vaihe 1: Määritä metakentät lähdekaupassa

1. Avaa sovellus > napsauta **Settings** > kytke **Share Metafields** päälle
2. Valitse resurssi, jonka haluat jakaa:
   * **Product resource** – Jaa tuotteen metakentät.
   * **Variant resource** – Jaa variantin metakentät.
3. Lisää tiettyjä metakenttämäärityksiä rajataksesi jaettavat metakentät.
   * Napsauta **Browse metafields** -kuvaketta tai
   * Syötä metakenttämääritys muodossa:

     ```
     namespace.key
     ```

Esimerkiksi:

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

***

### 🛠️ Vaihe 2: Määritä metakentät kohdekaupassa

1. Avaa sovellus > napsauta **Stores** > napsauta lähdekaupan URL-osoitetta avataksesi yhteyden tiedot

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

2. Kytke **Metafields sync** päälle
3. Valitse, mitä synkronoidaan

Valitse kohdassa **Allow data** toinen tai molemmat:

* **Product Resource** → synkronoi tuotteen metakentät
   * **Variant Resource** → synkronoi variantin metakentät
4. Napsauta oikealla olevaa hakukuvaketta nähdäksesi kaikki tuetut metakentät > napsauta **Select valid metafield to sync** -painiketta&#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. Päivitä muutokset napsauttamalla **Save**-painiketta

***

### &#x20;🔄 Mitä synkronoinnin aikana tapahtuu

#### **1) Jos kohdekaupassa ei ole metakenttämääritystä**

Sovellus luo metakenttämäärityksen automaattisesti kohdekauppaan tarvittaessa.

Kun se on luotu, synkronoidut metakenttäarvot näkyvät tuotteella/variantilla kohdekaupassa.

#### **2) Jos metakentät ovat olemassa, mutta niitä ei ole ”jäsennelty” (jäsentämättömät metakentät)**

Joissakin tapauksissa metakentät voivat synkronoitua, vaikka niitä ei ole täysin määritetty tai jäsennelty kohdekaupassa.

Tarkistaaksesi ne Shopify Adminissa:

* **Avaa kaupan Settings → Metafields and metaobjects**
* Valitse **Product** (tai **Variant**)
* Avaa **View unstructured metafields**

💡 Vinkki: Voit määrittää tai jäsentää nämä metakentät myöhemmin manuaalisesti, jotta kaupan tiedot pysyvät siistinä ja johdonmukaisina.

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

#### **3) Jos lähdekaupassa ei ole arvoa, kohdekauppaa ei ylikirjoiteta**

Jos metakenttä on olemassa kohdekaupassa, mutta lähdekaupan arvo on tyhjä, Tipo Sync ei ylikirjoita kohdekaupan arvoa.

#### **4) Tietotyyppien on täsmättävä (erittäin tärkeää)**

Metakenttien tietotyyppien on täsmättävä täysin lähdekaupan ja kohdekaupan välillä.

Esimerkkejä tietotyyppien epäsopivuudesta:

* `single_line_text_field` vs `multi_line_text_field`
* `number_integer` vs `number_decimal`
* `product_reference` vs `text`

⚠️ Jos tietotyypit eivät täsmää, synkronointi voi epäonnistua tai ohittaa kyseisen metakentän.

***

### 📌 Esimerkki: Tuotteen metakentän synkronointi – ”Material”

Haluat synkronoida **mukautetun tuotteen metakentän** nimeltä **Material** (esim. ”Cotton”, ”Leather”, ”Wool”) **lähdekaupastasi** **kohdekauppaasi** tämän sovelluksen avulla.

#### **Vaihe 1: Määritä metakenttä Shopifyssa**

Lähdekaupassasi:

1. Siirry kohtaan **Shopify Admin >** avaa kauppa **Settings > Metafields and metaobjects** > valitse **Product** (tai **Variant**)
2. Napsauta **Add definition** (jos sitä ei ole vielä luotu) > täytä metakenttämääritys:
   * **Name**: Material
   * **Namespace**: `custom`
   * **Key**: `material`
   * **Type**: Single line text

\=>  Tämä antaa koko metakenttäavaimen: `custom.material`

Toista tämä vaihe **kohdekaupassasi** (avaimen ja tyypin on täsmättävä).

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

#### **Vaihe 2: Lisää metakenttätiedot tuotteisiin**

Siirry lähdekaupassasi tuotteeseen ja vieritä kohtaan **Metafields** > kohdassa **Material** syötä: `Cotton`

Tällä tuotteella on nyt metakenttä `custom.material = "Cotton"`.

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

#### **Vaihe 3: Määritä synkronointi Tipo-sovelluksessa**&#x20;

* Avaa sovellus **kohdekaupassa** > siirry kohtaan Connect Configuration **> Metafield Sync**
* Valitse **Specific Metafields > s**yötä metakenttäavain täsmälleen: `custom.material`&#x20;

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

**Tulos**

* Sovellus löytää `custom.material` lähdekaupasta
* Jos sitä **ei ole** kohdetuotteessa, sovellus **luo sen**\
  \=>   Tulos: `custom.material = "Cotton"` molemmissa kaupoissa
* Jos se on kohdekaupassa, mutta lähdekaupassa arvo on tyhjä, emme **ylikirjoita** arvoa

***

### ❓UKK

#### K1: Miten asetan `namespace.key`-arvon kaupassani?

Synkronoidaksesi tietyn metakentän, sinun on syötettävä **metakenttämäärityksen avain** tässä muodossa: `namespace.key` (esimerkiksi: `custom.color`).

Näin löydät sen Shopify-hallinnasta:

1. Siirry Shopify Adminiin >cavigate to **Settings > Custom Data > Products**
2. Napsauta metakenttää, jonka haluat synkronoida\
   → Näet **Namespace**- ja **Key**-arvot
3. Yhdistä ne tässä muodossa: `namespace.key`\
   → Esimerkki: `custom.description`

#### K2: Miksi metakenttäni eivät synkronoidu?

Jos metakenttäsi eivät synkronoidu oikein, syy voi olla jokin seuraavista:

1. **Metakenttien synkronointi ei ole käytössä**\
   Varmista, että metakenttien synkronointi on päällä molemmissa kaupoissa:
   * Ota **Share Metafields** käyttöön **lähdekaupassa**.
   * Ota **Receive Metafields** käyttöön **kohdekaupassa**.

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

2. **Metakenttämäärityksen avainta ei ole lisätty**

Metakenttien synkronoinnin käyttöönoton lisäksi sinun on lisättävä myös **metakenttämäärityksen avain (namespace.key)**, jonka haluat synkronoida.

* Siirry kohtaan **Settings → Share Metafields**
* Varmista, että **Enable** on valittu
* Lisää kohdassa **Allow data** metakenttämääritys tässä muodossa:\
  `namespace.key`\
  Esimerkki: `custom.material`&#x20;

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

3. **Ei tuettuja metakenttätyyppejä**\
   Jotkin metakenttätyypit eivät ole tuettuja, kuten **viitetyypit** tai **MetaObjects**.

Punainen: Metakentät, joita sovellus ei voi synkronoida

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

4. **Metakenttätyypit eroavat kauppojen välillä**\
   Lähdekaupan ja kohdekaupan metakentän on oltava **samantyyppinen ja -rakenteinen**.\
   Yleisiä eroja ovat:

* Toinen metakenttä on **Single line text**, toinen **Multi-line text**.
* Toinen metakenttä käyttää **Single value** -arvoa, toinen **List of values** -arvoa.

Korjataksesi nämä ongelmat varmista, että metakentillä on molemmissa kaupoissa sama **namespace**, **key** ja **data type**, ja yritä sitten synkronointia uudelleen.

***

**🙋 Tarvitsetko yhä tukea?**

Jos tarvitset edelleen apua, ota meihin rohkeasti yhteyttä osoitteeseen <hi@tipo.io>. Autamme mielellämme lisää.
