# 一意の識別子に基づいて商品を同期する

アプリでは、次のいずれかの一意の識別子を使って、**送信元ストア（Source store）**から**送信先ストア（Destination store）**へ商品を同期できます。

* **ハンドル（Handle）**（推奨）
* **SKU**
* **バーコード（Barcode）**

**一意の識別子**とは、両方のストアで同じ値を持ち、商品を正しくマッチングするために使える商品の値のことです。

商品がマッチングされると、Tipoアプリは設定に基づいて更新内容（価格、タイトル、画像など）を同期できます。

### ✅ どの識別子を使えばよいですか？

#### 1. ハンドル（Handle）（推奨）

**概要：**\
ハンドルは、各商品のURLに使われる一意の文字列です。商品タイトルから自動的に生成されますが、Shopifyで手動で編集することもできます。

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

**同期のロジック：**\
送信元ストアの商品が送信先ストアの商品と同じハンドルを持つ場合、アプリは同じ商品とみなしてデータを同期します。

**例：**

| 送信元ストア               | 送信先ストア          |
| -------------------------- | -------------------------- |
| 商品タイトル："Red Shirt" | 商品タイトル："Red Shirt" |
| ハンドル：`red-shirt`        | ハンドル：`red-shirt`        |

ハンドルが一致しているため、この商品は**正しく同期されます**。

❗**ヒント：** ストアの商品構成が同一の場合は、常にハンドルでの同期をご利用ください。

***

#### 2. SKU（在庫管理単位）

**概要：**\
SKUは、在庫を管理するために商品バリエーションごとに割り当てるコードです。

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

**同期のロジック：**\
アプリは、両方のストアで同じSKUを持つ商品バリエーションをマッチングします。

**例：**

| 送信元ストア                     | 送信先ストア                |
| -------------------------------- | -------------------------------- |
| 商品："Sneakers"              | 商品："Sneakers"              |
| バリエーション：Size 42 - SKU：`SNK-42` | バリエーション：Size 42 - SKU：`SNK-42` |

SKUが一致しているため、このバリエーションは同期されます。

❗**警告：** 複数の商品でバリエーションに同じSKUが使われていると、誤ったマッチングが発生する可能性があります。

***

#### 3. バーコード（Barcode）

**概要：**\
**バーコード**は、世界で一意の商品識別子で、主に小売店のスキャンシステムで使われます。

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

**同期のロジック：**\
アプリは、Shopifyのバーコードフィールドに基づいて**商品バリエーション**をマッチングします。

**例：**

| 送信元ストア                              | 送信先ストア                         |
| ----------------------------------------- | ----------------------------------------- |
| 商品："Water Bottle"                   | 商品："Water Bottle"                   |
| バリエーション：500ml - バーコード：`1234567890123` | バリエーション：500ml - バーコード：`1234567890123` |

バーコードが一致しているため、この商品は正しく同期されます。

❗**注意：**&#x20;

このオプションは、ストア間ですべてのバリエーションが一意のバーコードを使用している場合にのみご利用ください。

***

### ⚙️ **識別子を選択する手順**

#### **新しい接続の場合：**

接続する前に、同期したい商品情報を[こちら](/product-syncs/select-products-to-sync)で確認して選択してください。

1\. **送信先**ストアでアプリを開き、**ストア（Stores）**をクリックし、**ストアを接続（Connect store）**ボタンをクリックします

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

2\. 送信元ストアで取得した**接続コード（Connection Code）**を入力します（送信元ストアのアプリの設定内にあります）。​

3\. **全般（General）** > **マッチングとインポート（Matching & Imports）**で、**存在しない場合は新しいアイテムを作成し、同じハンドルを持つ既存のアイテムを更新する（Create new items if not exist and update current items that have the same handle）**を選択します

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

4\. **商品同期（Product sync）**設定を有効にし、**一意の識別子（Unique Identifier）**を選択して、それに基づいて商品を同期します

例：ハンドルを選択した場合、同じハンドルを持つ商品がストア間で同期されます。&#x20;

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

5. 保存して接続を開始します

#### **稼働中の接続の場合**

1\. **送信先**ストアに移動し、**ストア**をクリックして、送信元ストアのストアURLをクリックし、接続の詳細を表示します

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

2\. 商品の同期に使用する一意の識別子を選択します

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

3. **保存**をクリックして変更を適用します。

***

### 🔄 同期中の動作

🧪 例（ハンドルでのマッチング）

**送信元ストアの商品**

* 商品：Ceramic Table Lamp
* ハンドル：`ceramic-table-lamp`

**送信先ストア**

* ハンドルが`ceramic-table-lamp`の商品が存在する場合 → 更新されます
* 存在しない場合 → インポートされます（有効な場合）

**⚙️ 同期中のマッチングの仕組み**

同期が実行されると、次のように処理されます。

1. Tipo Syncが送信元ストアから商品を読み取ります
2. 送信先ストアで同じ識別子を持つ商品を検索します
3. その後、次のように判断します。
   * &#x20;**一致が見つかった場合** → 既存の商品フィールドを更新します（同期の選択内容に基づく）
   * &#x20;**一致が見つからなかった場合** → 新しい商品をインポート／作成します（インポートモードで許可されている場合）

***

### 🌟 ベストプラクティス

* ストア間で商品構成が同一の場合は、**ハンドル**を使用してください。
* **SKU**は、すべてのバリエーションに**一意のSKU**がある場合にのみ使用してください。
* **バーコード**は、バーコードを一貫して使用している小売環境で使用してください。

***

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

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