# Metafield'ları senkronize etme

Bu kılavuz, Tipo uygulamasında metafield'ları Source store'dan Destination store'a nasıl senkronize edeceğinizi açıklar.

### ℹ️ Metafield'lar nedir?

* **Ürün metafield'ları**
* **Varyant metafield'ları** (etkinleştirirseniz)

Tipo uygulaması şunlar için metafield'ları senkronize edebilir:

* malzeme, beden tablosu, teknik özellikler
* özel rozetler (ör. “best\_seller”)
* temalar/uygulamalar tarafından kullanılan ek ürün ayrıntıları

Metafield'lar, şu gibi ek ürün verilerini depolamak için kullanılan Shopify'daki özel alanlardır:

***

### ✅ **Desteklenen metafield türleri**

* Çok satırlı metin
* Zengin metin
* Tam sayı
* Ondalık
* Tarih ve saat
* Tarih
* Boyut
* Hacim
* Ağırlık
* Doğru veya yanlış
* Derecelendirme
* URL
* Para
* Bağlantı
* JSON

🚫 **Henüz desteklenmiyor:**\
Referans türleri (ör. ürün referansı, koleksiyon referansı) şu anda desteklenmemektedir.

***

### 🛠️ Adım 1: Source store'da metafield'ları yapılandırın

1. Uygulamayı açın > **Settings** öğesine tıklayın > **Share Metafields** seçeneğini açın
2. Paylaşmak istediğiniz kaynağı seçin:
   * **Product resource** – Ürün metafield'larını paylaşın.
   * **Variant resource** – Varyant metafield'larını paylaşın.
3. Hangi metafield'ların paylaşılacağını sınırlamak için belirli metafield tanımları ekleyin.
   * **Browse metafields** simgesine tıklayın veya
   * Tanımı şu biçimde girin:

     ```
     namespace.key
     ```

Örneğin:

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

***

### 🛠️ Adım 2: Destination store'da metafield'ları yapılandırın

1. Uygulamayı açın > **Stores** öğesine tıklayın > bağlantı ayrıntılarını açmak için source store URL'sine tıklayın

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

2. **Metafields sync** seçeneğini açın
3. Neyi senkronize edeceğinizi seçin

**Allow data** altında bir veya ikisini seçin:

* **Product Resource** → ürün metafield'larını senkronize et
   * **Variant Resource** → varyant metafield'larını senkronize et
4. Desteklenen tüm metafield'ları görmek için sağdaki arama simgesine tıklayın > **Select valid metafield to sync** düğmesine tıklayın&#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. Değişiklikleri güncellemek için **Save** öğesine tıklayın

***

### &#x20;🔄 Senkronizasyon sırasında neler olur

#### **1) Destination store'da metafield tanımı yoksa**

Uygulama, gerektiğinde Destination store'da metafield tanımını otomatik olarak oluşturur.

Oluşturulduktan sonra, senkronize edilen metafield değerleri Destination store'daki ürün/varyantta görünür.

#### **2) Metafield'lar varsa ama “yapılandırılmamışsa” (Unstructured metafields)**

Bazı durumlarda metafield'lar Destination store'da tam olarak tanımlanmamış veya yapılandırılmamış olsa bile senkronize edilebilir.

Bunları Shopify Admin'de incelemek için:

* **Store Settings → Metafields and metaobjects** bölümünü **açın**
* **Product** (veya **Variant**) seçin
* **View unstructured metafields** bölümünü açın

💡 İpucu: Mağaza verilerinizi temiz ve tutarlı tutmak için bu metafield'ları daha sonra manuel olarak tanımlayabilir/yapılandırabilirsiniz.

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

#### **3) Source store'da değer yoksa Destination üzerine yazılmaz**

Bir metafield Destination'da mevcutsa ancak Source değeri boşsa, Tipo Sync Destination değerinin üzerine yazmaz.

#### **4) Veri türleri eşleşmelidir (çok önemli)**

Metafield veri türleri Source ve Destination arasında tam olarak eşleşmelidir.

Veri türü uyuşmazlığı örnekleri:

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

⚠️ Veri türleri eşleşmezse senkronizasyon başarısız olabilir veya o metafield atlanabilir.

***

### 📌 Örnek: Ürün metafield'ını senkronize etme – “Material”

Uygulamamızı kullanarak **Source Store**'unuzdan **Destination Store**'unuza **Material** adlı bir **özel ürün metafield'ını** (ör. “Cotton”, “Leather”, “Wool”) senkronize etmek istiyorsunuz.

#### **Adım 1: Metafield'ı Shopify'da tanımlayın**

**Source Store**'unuzda:

1. **Shopify Admin >** bölümüne gidin, mağazayı açın **Settings > Metafields and metaobjects** > **Product** (veya **Variant**) seçin
2. **Add definition** düğmesine tıklayın (henüz oluşturulmadıysa) > metafield tanımını doldurun:
   * **Name**: Material
   * **Namespace**: `custom`
   * **Key**: `material`
   * **Type**: Single line text

\=>  Bu, tam metafield anahtarını verir: `custom.material`

Bu adımı **Destination Store**'unuzda da tekrarlayın (aynı anahtar ve tür ile eşleşmelidir).

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

#### **Adım 2: Ürünlere metafield verisi ekleyin**

**Source Store**'unuzda bir ürüne gidin, **Metafields** bölümüne kadar aşağı kaydırın > **Material** altına şunu girin: `Cotton`

Bu ürün artık `custom.material = "Cotton"` metafield'ına sahip.

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

#### **Adım 3: Tipo uygulamasında senkronizasyonu yapılandırın**&#x20;

* Uygulamamızı **Destination Store**'da açın > Connect Configuration **> Metafield Sync** bölümüne gidin
* **Specific Metafields** seçin > metafield anahtarını tam olarak girin: `custom.material`&#x20;

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

**Sonuç**

* Uygulamamız Source Store'da `custom.material` alanını bulacaktır
* Destination üründe **yoksa**, uygulama bunu **oluşturur**\
  \=>   Sonuç: Her iki mağazada da `custom.material = "Cotton"`
* Destination'da varsa ama Source boşsa, değeri **üzerine yazmayız**

***

### ❓SSS

#### S1: Mağazanızda `namespace.key` nasıl ayarlanır?

Belirli bir metafield'ı senkronize etmek için, **metafield tanımı anahtarını** şu biçimde girmeniz gerekir: `namespace.key` (örneğin: `custom.color`).

Shopify yönetim panelinizde bunu şöyle bulabilirsiniz:

1. Shopify Admin'inize gidin > **Settings > Custom Data > Products** bölümüne gidin
2. Senkronize etmek istediğiniz metafield'a tıklayın\
   → **Namespace** ve **Key** değerlerini göreceksiniz
3. Bunları şu biçimde birleştirin: `namespace.key`\
   → Örnek: `custom.description`

#### S2: Metafield'larım neden senkronize olmuyor?

Metafield'larınız doğru senkronize edilmiyorsa bunun nedeni aşağıdakilerden biri olabilir:

1. **Metafield senkronizasyonu etkin değil**\
   Her iki mağaza için de metafield senkronizasyonunun açık olduğundan emin olun:
   * **Source Store**'da **Share Metafields** seçeneğini etkinleştirin.
   * **Destination Store**'da **Receive Metafields** seçeneğini etkinleştirin.

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

2. **Metafield tanımı anahtarı eklenmemiş**

Metafield senkronizasyonunu etkinleştirmenin yanı sıra, senkronize etmek istediğiniz **metafield tanımı anahtarını (namespace.key)** da eklemeniz gerekir.

* **Settings → Share Metafields** bölümüne gidin
* **Enable** kutusunun işaretli olduğundan emin olun
* **Allow data** altında metafield tanımını şu biçimde ekleyin:\
  `namespace.key`\
  Örnek: `custom.material`&#x20;

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

3. **Desteklenmeyen metafield türleri**\
   **Reference types** veya **MetaObjects** gibi bazı metafield veri türleri desteklenmez.

Kırmızı: Uygulama tarafından senkronize edilemeyen desteklenmeyen metafield'lar

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

4. **Mağazalar arasında uyuşmayan metafield türleri**\
   Source ve Destination'daki metafield **aynı veri türüne ve yapıya** sahip olmalıdır.\
   Yaygın uyuşmazlıklar şunlardır:

* Bir metafield **Single line text**, diğeri **Multi-line text** olabilir.
* Bir metafield **Single value** kullanırken diğeri **List of values** kullanabilir.

Bu sorunları çözmek için her iki mağazadaki metafield'ların aynı **namespace**, **key** ve **veri türüne** sahip olduğunu doğrulayın, ardından yeniden senkronize etmeyi deneyin.

***

**🙋 Hâlâ desteğe ihtiyacınız var mı?**

Hâlâ yardıma ihtiyacınız varsa lütfen <hi@tipo.io> adresinden bizimle iletişime geçmekten çekinmeyin. Size memnuniyetle yardımcı olacağız.
