Tutorial

Shopify製品にメタフィールドを追加する

多くの製品に対してメタフィールドを追加または更新することは、手動で行うと時間がかかります。DataEaseを使用すれば簡単です。製品をエクスポートし、ExcelやCSVでnamespace:keyペアを使用してメタフィールドの値を編集し、それをShopifyにインポートします。すべて型安全な検証付きです。

🎯 目標

CSV/ExcelとDataEaseを使用して製品のメタフィールドを一括で追加または更新します。型安全な値を持つクリーンなnamespace:keyペアを使用します。


📋 手順

1. 製品をエクスポートする

DataEaseで、New Export → Productsに移動します。最低限含めるもの:

  • id
  • handle

現在のデータを確認するために既存のメタフィールドをオプションで追加します。

これにより、編集の準備が整ったすべての製品を含むファイルが得られます。


2. メタフィールドの編集方法を選択する

DataEaseはメタフィールドを編集するための2つの方法をサポートしています:

動的カラム(推奨): キーごとに1つのカラムを追加し、metafield: {namespace} / {key}(例:metafield: my_fields / material)と名付けます。値をセルに直接入力します。

単一の「metafields」カラム: 1つのセルに複数のエントリをnamespace:key = value; namespace2:key2 = value2(セミコロン区切り)として提供します。


3. ファイルを編集する

エクスポートしたファイルをExcelまたはGoogle Sheetsで開きます。変更したい各行について:

  1. commandをUPDATEに設定します
  2. 適切な形式を使用してメタフィールドの値を入力します:
    • 文字列: プレーンテキスト(例:Organic Cotton)
    • 数値: 数値形式(例:42, 19.95)
    • ブール値: TRUE / FALSE
    • 日付/時間: ISO-8601形式(例:2025-11-05T10:00:00+01:00)
    • JSON: 有効なJSON(例:{"color":"red","size":"m"})

完了したら、ファイルを.xlsxまたは.csvとして保存します。


4. インポートと検証

  1. DataEaseでNew Importを開始します
  2. 編集したファイルをアップロードします
  3. カラムをマッピングします(Product IDが推奨)
  4. Validationを実行します

検証レポートを開き、Validation Statusで指摘された型/形式の問題を修正します。


5. インポートを実行する

検証が通過したら、Run ImportをクリックしてShopifyにメタフィールドを適用します。

完了したら、Shopify管理画面で製品をスポットチェックして、すべてが正しく表示されていることを確認します。


📝 重要な注意事項

  • メタフィールドのクリア: UPDATE時にそのキーの動的カラムのセルを空白にして削除します
  • 型: バリデーターはShopifyメタフィールドの型(文字列、数値、ブール値、日付/時間、jsonなど)をチェックします。適切な形式を使用して検証を通過します
  • 一貫性: namespaceとキーを一貫して保ちます(my_fields.material、混在した大文字小文字やスペースを使用しない)
  • バリアントメタフィールド: バリアントレベルのエクスポート(Variantsガイド参照)でも同じアプローチを使用し、Variant IDと対応するメタフィールドカラムを使用します

💡 最小限のCSV例

動的カラム(推奨):

id,command,metafield: my_fields / material,metafield: my_fields / season
gid://shopify/Product/123,UPDATE,Organic Cotton,Summer 2025

単一の「metafields」カラム:

id,command,metafields
gid://shopify/Product/456,UPDATE,"my_fields:material = Organic Cotton; my_fields:season = Summer 2025"

メタフィールドをクリアする(動的カラムを空白のままにする):

id,command,metafield: my_fields / material
gid://shopify/Product/789,UPDATE,

🎉 以上です!

メタフィールドが一括で追加または更新されました。
問題が発生した場合や質問がある場合は、サポートチームにお気軽にお問い合わせください。