# メタフィールドを同期する

このガイドでは、Tipoアプリでメタフィールドを送信元ストアから送信先ストアへ同期する方法を説明します。

### ℹ️ メタフィールドとは？

* **Product metafields**
* **Variant metafields**（有効にしている場合）

Tipo アプリは次のメタフィールドを同期できます：

* 素材、サイズチャート、仕様
* カスタムバッジ（例：“best\_seller”）
* テーマやアプリで使用される追加の商品詳細

メタフィールドは、次のような追加の商品データを保存するためにShopifyで使用されるカスタムフィールドです：

***

### ✅ **サポートされているメタフィールドのタイプ**

* 複数行テキスト（Multi-line text）
* リッチテキスト（Rich text）
* 整数（Integer）
* 小数（Decimal）
* 日時（Date and time）
* 日付（Date）
* ディメンション（Dimension）
* 容量（Volume）
* 重量（Weight）
* 真偽（True or false）
* 評価（Rating）
* URL
* 金額（Money）
* リンク（Link）
* JSON

🚫 **まだサポートされていないもの:**\
参照タイプ（例：商品参照、コレクション参照）は現在サポートされていません。

***

### 🛠️ ステップ1：送信元ストアでメタフィールドを設定する

1. アプリを開き、**設定（Settings）**をクリックして、**メタフィールドを共有（Share Metafields）**をオンにします
2. 共有するリソースを選択します。
   * **商品リソース（Product resource）** – 商品メタフィールドを共有します。
   * **バリエーションリソース（Variant resource）** – バリエーションメタフィールドを共有します。
3. 特定のメタフィールド定義を追加して、共有するメタフィールドを限定します。
   * **メタフィールドを参照（Browse metafields）**アイコンをクリックするか、
   * 次の形式でメタフィールド定義を入力します。

     ```
     namespace.key
     ```

     例：

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

***

### 🛠️ ステップ2：送信先ストアでメタフィールドを設定する

1. アプリを開き、**ストア（Stores）**をクリックして、送信元ストアのURLをクリックし、接続の詳細を開きます

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

2. **メタフィールド同期（Metafields sync）**をオンにします
3. 同期する内容を選択します

   **許可するデータ（Allow data）**で、次の一方または両方を選択します。

   * **商品リソース** → 商品メタフィールドを同期
   * **バリエーションリソース** → バリエーションメタフィールドを同期
4. 右側の検索アイコンをクリックして、サポートされているすべてのメタフィールドを表示し、**同期する有効なメタフィールドを選択（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. **保存**をクリックして変更を更新します

***

### &#x20;🔄 同期中の動作

#### **1) 送信先ストアにメタフィールド定義がない場合**

アプリは、必要に応じて送信先ストアにメタフィールド定義を自動的に作成します。

作成後、同期されたメタフィールドの値が送信先ストアの商品／バリエーションに表示されます。

#### **2) メタフィールドは存在するが「構造化」されていない場合（非構造化メタフィールド）**

場合によっては、送信先ストアでメタフィールドが完全に定義／構造化されていなくても同期されることがあります。

Shopify管理画面で確認するには：

* ストアの**設定（Settings）→ カスタムデータ（Metafields and metaobjects）**を開きます
* **商品（Product）**（または**バリエーション（Variant）**）を選択します
* **非構造化メタフィールドを表示（View unstructured metafields）**を開きます

💡 ヒント：後でこれらのメタフィールドを手動で定義／構造化すると、ストアのデータをきれいで一貫した状態に保てます。

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

#### **3) 送信元ストアに値がない場合、送信先は上書きされません**

送信先にメタフィールドが存在していても、送信元の値が空の場合、Tipo Sync は送信先の値を上書きしません。

#### **4) データタイプは一致している必要があります（非常に重要）**

メタフィールドのデータタイプは、送信元と送信先で完全に一致している必要があります。

データタイプが一致しない例：

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

⚠️ データタイプが一致しない場合、同期が失敗するか、そのメタフィールドがスキップされることがあります。

***

### 📌 例：商品メタフィールド「Material」を同期する

送信元ストアから送信先ストアへ、アプリを使って**Material**（例：“Cotton”、“Leather”、“Wool”）という**カスタム商品メタフィールド**を同期したいとします。

#### **ステップ1：Shopifyでメタフィールドを定義する**

**送信元ストア**で：

1. **Shopify管理画面 >** ストアの**設定（Settings）> カスタムデータ（Metafields and metaobjects）**を開き、**商品（Product）**（または**バリエーション（Variant）**）を選択します
2. （まだ作成していない場合は）**定義を追加（Add definition）**をクリックし、メタフィールド定義を入力します。
   * **名前（Name）**：Material
   * **ネームスペース（Namespace）**：`custom`
   * **キー（Key）**：`material`
   * **タイプ（Type）**：1行テキスト（Single line text）

\=>  これで、メタフィールドの完全なキーは次のようになります：`custom.material`

**送信先ストア**でも同じ手順を繰り返します（キーとタイプが一致している必要があります）。

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

#### **ステップ2：商品にメタフィールドのデータを追加する**

**送信元ストア**で商品を開き、**メタフィールド（Metafields）**までスクロールして > **Material**の下に次のように入力します：`Cotton`

これで、この商品はメタフィールド`custom.material = "Cotton"`を持つようになります。

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

#### **ステップ3：Tipoアプリで同期を設定する**&#x20;

* **送信先ストア**でアプリを開き、接続設定（Connect Configuration）**> メタフィールド同期（Metafield Sync）**に進みます
* **特定のメタフィールド（Specific Metafields）**を選択し、メタフィールドのキーを正確に入力します：`custom.material`&#x20;

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

**結果**

* アプリは送信元ストアで`custom.material`を見つけます
* 送信先の商品にそれが**存在しない**場合、アプリは**作成します**\
  \=>   結果：両方のストアで`custom.material = "Cotton"`になります
* 送信先に存在していても送信元が空の場合、値は**上書きしません**

***

### ❓よくある質問（FAQ）

#### Q1：ストアで`namespace.key`を設定するには？

特定のメタフィールドを同期するには、**メタフィールド定義キー**を次の形式で入力する必要があります：`namespace.key`（例：`custom.color`）。

Shopify管理画面での確認方法は次のとおりです。

1. Shopify管理画面で**設定（Settings）> カスタムデータ（Custom Data）> 商品（Products）**に移動します
2. 同期したいメタフィールドをクリックします\
   → **Namespace**と**Key**の値が表示されます
3. これらを次の形式で組み合わせます：`namespace.key`\
   → 例：`custom.description`

#### Q2：メタフィールドが同期されないのはなぜですか？

メタフィールドが正しく同期されない場合、次のいずれかが原因として考えられます。

1. **メタフィールドの同期が有効になっていない**\
   両方のストアでメタフィールドの同期がオンになっていることを確認してください。
   * **送信元ストア**で**メタフィールドを共有（Share Metafields）**を有効にします。
   * **送信先ストア**で**メタフィールドを受信（Receive Metafields）**を有効にします。

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

2. **メタフィールド定義キーが追加されていない**

メタフィールドの同期を有効にするだけでなく、同期したい**メタフィールド定義キー（namespace.key）**も追加する必要があります。

* **設定 → メタフィールドを共有**に移動します
* **有効にする（Enable）**にチェックが入っていることを確認します
* **許可するデータ**で、次の形式でメタフィールド定義を追加します。\
  `namespace.key`\
  例：`custom.material`&#x20;

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

3. **サポートされていないメタフィールドのタイプ**\
   **参照タイプ（Reference types）**や**メタオブジェクト（MetaObjects）**など、一部のメタフィールドのデータタイプはサポートされていません。

赤：アプリで同期できない、サポートされていないメタフィールド

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

4. **ストア間でメタフィールドのタイプが一致していない**\
   送信元と送信先のメタフィールドは、**同じデータタイプと構造**である必要があります。\
   よくある不一致の例：

* 一方のメタフィールドが**1行テキスト**で、もう一方が**複数行テキスト**。
* 一方が**単一の値（Single value）**を使用し、もう一方が**値のリスト（List of values）**を使用している。

これらを解決するには、両方のストアのメタフィールドで**ネームスペース**、**キー**、**データタイプ**が同じであることを確認してから、もう一度同期をお試しください。

***

**🙋 サポートが必要ですか？**

解決しない場合は、<hi@tipo.io>までお気軽にご連絡ください。引き続きサポートいたします。
