メタフィールドを同期する
AI概要
Tipo Syncで、Source storeからDestination storeへ商品とバリエーションのメタフィールドを同期する方法を説明します。Source storeでメタフィールドの共有をオンにし、Destination storeでメタフィールドの同期をオンにしてから、namespace.keyで同期するメタフィールドを選びます。データ型は2つのストアで完全に一致している必要があります。
もっと見る表示を減らす
- 参照型とMetaObjectsはサポートされていません。メタフィールドのデータ型は両方のストアで一致している必要があります。
- Source storeで Settings を開いて Share Metafields をオンにし、ProductまたはVariantのリソースを選んで、namespace.keyの形式で定義を追加します。
- Destination storeで Stores を開き、接続の詳細を開いて Metafields sync をオンにし、リソースを選択します。
- Save をクリックします。不足している定義はDestination storeに自動で作成されます。
- Source storeの空の値が、Destination storeの既存の値を上書きすることはありません。
AIが生成した要約です。誤りを含む場合があるため、下記のガイド全文をご確認ください。
このガイドでは、Tipoアプリでメタフィールドを送信元ストアから送信先ストアへ同期する方法を説明します。
ℹ️ メタフィールドとは?
Section titled “ℹ️ メタフィールドとは?”- Product metafields
- Variant metafields(有効にしている場合)
Tipo アプリは次のメタフィールドを同期できます:
- 素材、サイズチャート、仕様
- カスタムバッジ(例:“best_seller”)
- テーマやアプリで使用される追加の商品詳細
メタフィールドは、次のような追加の商品データを保存するためにShopifyで使用されるカスタムフィールドです:
✅ サポートされているメタフィールドのタイプ
Section titled “✅ サポートされているメタフィールドのタイプ”- 複数行テキスト(Multi-line text)
- リッチテキスト(Rich text)
- 整数(Integer)
- 小数(Decimal)
- 日時(Date and time)
- 日付(Date)
- ディメンション(Dimension)
- 容量(Volume)
- 重量(Weight)
- 真偽(True or false)
- 評価(Rating)
- URL
- 金額(Money)
- リンク(Link)
- JSON
🚫 まだサポートされていないもの:
参照タイプ(例:商品参照、コレクション参照)は現在サポートされていません。
🛠️ ステップ1:送信元ストアでメタフィールドを設定する
Section titled “🛠️ ステップ1:送信元ストアでメタフィールドを設定する”- アプリを開き、**設定(Settings)**をクリックして、**メタフィールドを共有(Share Metafields)**をオンにします
- 共有するリソースを選択します。
- 商品リソース(Product resource) – 商品メタフィールドを共有します。
- バリエーションリソース(Variant resource) – バリエーションメタフィールドを共有します。
- 特定のメタフィールド定義を追加して、共有するメタフィールドを限定します。
-
**メタフィールドを参照(Browse metafields)**アイコンをクリックするか、
-
次の形式でメタフィールド定義を入力します。
namespace.key例:
custom.materialseo.titlespecifications.weight
-
- Click Save to update the changes


🛠️ ステップ2:送信先ストアでメタフィールドを設定する
Section titled “🛠️ ステップ2:送信先ストアでメタフィールドを設定する”- アプリを開き、**ストア(Stores)**をクリックして、送信元ストアのURLをクリックし、接続の詳細を開きます

-
**メタフィールド同期(Metafields sync)**をオンにします
-
同期する内容を選択します
**許可するデータ(Allow data)**で、次の一方または両方を選択します。
- 商品リソース → 商品メタフィールドを同期
- バリエーションリソース → バリエーションメタフィールドを同期
-
右側の検索アイコンをクリックして、サポートされているすべてのメタフィールドを表示し、**同期する有効なメタフィールドを選択(Select valid metafield to sync)**ボタンをクリックします


- 保存をクリックして変更を更新します
🔄 同期中の動作
Section titled “ 🔄 同期中の動作”1) 送信先ストアにメタフィールド定義がない場合
Section titled “1) 送信先ストアにメタフィールド定義がない場合”アプリは、必要に応じて送信先ストアにメタフィールド定義を自動的に作成します。
作成後、同期されたメタフィールドの値が送信先ストアの商品/バリエーションに表示されます。
2) メタフィールドは存在するが「構造化」されていない場合(非構造化メタフィールド)
Section titled “2) メタフィールドは存在するが「構造化」されていない場合(非構造化メタフィールド)”場合によっては、送信先ストアでメタフィールドが完全に定義/構造化されていなくても同期されることがあります。
Shopify管理画面で確認するには:
- ストアの**設定(Settings)→ カスタムデータ(Metafields and metaobjects)**を開きます
- 商品(Product)(またはバリエーション(Variant))を選択します
- **非構造化メタフィールドを表示(View unstructured metafields)**を開きます
💡 ヒント:後でこれらのメタフィールドを手動で定義/構造化すると、ストアのデータをきれいで一貫した状態に保てます。

3) 送信元ストアに値がない場合、送信先は上書きされません
Section titled “3) 送信元ストアに値がない場合、送信先は上書きされません”送信先にメタフィールドが存在していても、送信元の値が空の場合、Tipo Sync は送信先の値を上書きしません。
4) データタイプは一致している必要があります(非常に重要)
Section titled “4) データタイプは一致している必要があります(非常に重要)”メタフィールドのデータタイプは、送信元と送信先で完全に一致している必要があります。
データタイプが一致しない例:
single_line_text_fieldとmulti_line_text_fieldnumber_integerとnumber_decimalproduct_referenceとtext
⚠️ データタイプが一致しない場合、同期が失敗するか、そのメタフィールドがスキップされることがあります。
📌 例:商品メタフィールド「Material」を同期する
Section titled “📌 例:商品メタフィールド「Material」を同期する”送信元ストアから送信先ストアへ、アプリを使ってMaterial(例:“Cotton”、“Leather”、“Wool”)というカスタム商品メタフィールドを同期したいとします。
ステップ1:Shopifyでメタフィールドを定義する
Section titled “ステップ1:Shopifyでメタフィールドを定義する”送信元ストアで:
- Shopify管理画面 > ストアの設定(Settings)> カスタムデータ(Metafields and metaobjects)を開き、商品(Product)(またはバリエーション(Variant))を選択します
- (まだ作成していない場合は)**定義を追加(Add definition)**をクリックし、メタフィールド定義を入力します。
- 名前(Name):Material
- ネームスペース(Namespace):
custom - キー(Key):
material - タイプ(Type):1行テキスト(Single line text)
=> これで、メタフィールドの完全なキーは次のようになります:custom.material
送信先ストアでも同じ手順を繰り返します(キーとタイプが一致している必要があります)。

ステップ2:商品にメタフィールドのデータを追加する
Section titled “ステップ2:商品にメタフィールドのデータを追加する”送信元ストアで商品を開き、**メタフィールド(Metafields)**までスクロールして > Materialの下に次のように入力します:Cotton
これで、この商品はメタフィールドcustom.material = "Cotton"を持つようになります。

ステップ3:Tipoアプリで同期を設定する
Section titled “ステップ3:Tipoアプリで同期を設定する ”- 送信先ストアでアプリを開き、接続設定(Connect Configuration)**> メタフィールド同期(Metafield Sync)**に進みます
- **特定のメタフィールド(Specific Metafields)**を選択し、メタフィールドのキーを正確に入力します:
custom.material

結果
- アプリは送信元ストアで
custom.materialを見つけます - 送信先の商品にそれが存在しない場合、アプリは作成します
=> 結果:両方のストアでcustom.material = "Cotton"になります - 送信先に存在していても送信元が空の場合、値は上書きしません
❓よくある質問(FAQ)
Section titled “❓よくある質問(FAQ)”Q1:ストアでnamespace.keyを設定するには?
Section titled “Q1:ストアでnamespace.keyを設定するには?”特定のメタフィールドを同期するには、メタフィールド定義キーを次の形式で入力する必要があります:namespace.key(例:custom.color)。
Shopify管理画面での確認方法は次のとおりです。
- Shopify管理画面で**設定(Settings)> カスタムデータ(Custom Data)> 商品(Products)**に移動します
- 同期したいメタフィールドをクリックします
→ NamespaceとKeyの値が表示されます - これらを次の形式で組み合わせます:
namespace.key
→ 例:custom.description
Q2:メタフィールドが同期されないのはなぜですか?
Section titled “Q2:メタフィールドが同期されないのはなぜですか?”メタフィールドが正しく同期されない場合、次のいずれかが原因として考えられます。
- メタフィールドの同期が有効になっていない
両方のストアでメタフィールドの同期がオンになっていることを確認してください。- 送信元ストアで**メタフィールドを共有(Share Metafields)**を有効にします。
- 送信先ストアで**メタフィールドを受信(Receive Metafields)**を有効にします。

- メタフィールド定義キーが追加されていない
メタフィールドの同期を有効にするだけでなく、同期したい**メタフィールド定義キー(namespace.key)**も追加する必要があります。
- 設定 → メタフィールドを共有に移動します
- **有効にする(Enable)**にチェックが入っていることを確認します
- 許可するデータで、次の形式でメタフィールド定義を追加します。
namespace.key
例:custom.material

- サポートされていないメタフィールドのタイプ
**参照タイプ(Reference types)やメタオブジェクト(MetaObjects)**など、一部のメタフィールドのデータタイプはサポートされていません。
赤:アプリで同期できない、サポートされていないメタフィールド

- ストア間でメタフィールドのタイプが一致していない
送信元と送信先のメタフィールドは、同じデータタイプと構造である必要があります。
よくある不一致の例:
- 一方のメタフィールドが1行テキストで、もう一方が複数行テキスト。
- 一方が**単一の値(Single value)を使用し、もう一方が値のリスト(List of values)**を使用している。
これらを解決するには、両方のストアのメタフィールドでネームスペース、キー、データタイプが同じであることを確認してから、もう一度同期をお試しください。
🙋 サポートが必要ですか?
解決しない場合は、hi@tipo.ioまでお気軽にご連絡ください。引き続きサポートいたします。