Transporter内での商品のCSV列の説明

商品のCSVファイルの列の説明。

プラス: Transporterアプリは、Shopify PlusのマーチャントだけがShopify アプリストアで利用できます。

Transporterアプリを使用して商品をShopifyにインポートするには、このレコードタイプのみを含むCSVファイルが必要です。

CSVサンプルファイル

サンプル商品のCSVファイルをダウンロードします。products.csv

Transporterのコマンドラインツールを使用してこのCSVファイルを生成する、また後述のフォーマットに従って自分で作成することもできます。

列の説明

以下の表では、CSVファイルの列ヘッダーについて説明します。

個別のCSVの列ヘッダーを説明した表
説明
Handle
(必須)
商品の固有ID。解読可能な文字列をスペースなしで指定します。通常、ハンドルは小文字の商品タイトルで、スペースや特殊文字はハイフン (-) に置き換えられます。たとえば、titan-t-shirt)。ハンドルは、オンラインストアの商品ページのURLに表示されます (例: https://titan.plus/products/titan-t-shirt)。この列は必須です。
Title
(必須)
商品の名前。たとえば、タイタンのTシャツなど。この列は必須です。
Body 商品の説明。HTMLフォーマットタグをこの説明に追加できます。たとえば、「<綿100%> </ b>で作られたこのTシャツで注目を集めること間違いありません」
Vendor 商品の販売元の名前。デフォルト値はストアの名前となっています。例: Titan Incorporated
Category 商品カテゴリーは、自動コレクションの条件として使用でき、管理画面での商品の絞り込みや、税の計算に役立ちます。1つの商品に設定できる商品カテゴリーは1つのみです。
Tags カンマで区切られたタグの文字列。絞り込みと検索に使用されます。カンマで区切られたタグに使用できる文字数は、255文字までです。例: Emotive, Flash Memory, MP3, Music。デフォルト値は""となります。
Template Suffix オンラインストアフロントが商品とそのバリエーションを表示するために使用するテンプレートのサフィックス。デフォルトのテンプレートの名前はproductです。サフィックスはありません。このデフォルトテンプレートを使用するには、列を空白のままにします。別のテンプレートを使用するには、そのテンプレートのサフィックスの名前を入力します。たとえば、product.mysuffixという名前のテンプレートを使用する場合、mysuffixを入力します。
Published Scope

商品がShopify POSチャネルで使用可能かどうかを示します。有効な値:

  • web - 商品はShopify POSチャネルでは使用できません。
  • global - 商品はShopify POSチャネルでは使用できます。これはデフォルト値です。

それぞれの値は、大文字と小文字が区別されます

Published 商品がオンラインストアで使用可能かどうか。有効な値:
  • true - 商品はオンラインストアで使用できます。
  • false - 商品はオンラインストアで使用できません (この列がfalseに設定されている場合はPublished Atに値を指定しないでください)。

それぞれの値は、大文字と小文字が区別されます

Published At 商品がオンラインストアで利用可能になった日時 (ISO 8601フォーマット)。たとえば、2007-12-31T19:00:00-05:00Publishedfalseに設定されている場合は、この列の値を指定しないでください。
Option1 Name カスタム商品のプロパティ名。たとえば、サイズ素材など。最長: 255文字。
Option1 Value カスタム商品オプションの値。たとえば、小さい、およびウール
Option2 Name サイズ素材などのカスタム商品のプロパティ名。最長: 255文字。
Option2 Value カスタム商品オプションの値。
Option3 Name サイズ素材などのカスタム商品のプロパティ名。最長: 255文字。
Option3 Value カスタム商品オプションの値。
Variant SKU ストアの商品バリエーションの固有ID。ストアがフルフィルメントサービス (つまり、Variant Fulfillment Serviceが含まれている) を使用している場合、この列が必要です。たとえば、IPOD2008PINK
Metafields Global Title Tag 検索エンジンに表示される名前に使用されるSEO目的の商品バリエーションの名前。値を指定しないと、デフォルトTitle列の値が使用されます。

Metafields Global Title Tagの値は、ストアの商品ページのコードにあるメタタイトルタグ (<meta name='title'>) に表示されます。商品にバリエーションがある場合は、バリエーションに個別のメタタグがないため、このタイトルのバリエーションに関する情報を含めることができます。この値を後で変更する必要がある場合は、商品のページで行うことができます。詳細については、「ShopifyストアにSEOのキーワードを追加する」を参照してください。最大: 70文字。
Metafields Global Description Tag 検索エンジンに表示される説明に使用されるSEO目的の商品バリエーションの説明。値を指定しないと、デフォルトではBody列の値が使用されます。

このメタフィールドのグローバル説明タグの値は、ストアの商品ページのコードにあるメタディスクリプションタグ (<meta name='description-of-product'>) で使用されます。商品にバリエーションがある場合は、バリエーションに個別のメタタグがないため、この説明のバリエーションに関する情報を含めることができます。この値を後で変更する必要がある場合は、管理画面の商品のページで行うことができます。詳細については、「ShopifyストアにSEOのキーワードを追加する」を参照してください。最大: 320文字。
Metafield Namespace メタフィールドセット用のコンテナー。メタフィールドをインポートするには、以下4つのメタフィールド列に値を含める必要があります。Metafield NamespaceMetafield KeyMetafield Value、またMetafield Type。メタフィールドに対してカスタムネームスペースを定義して、それらがアプリやShopifyで使用されているネームスペース (デフォルトのglobalを含む) と区別できるようにする必要があります。最長: 20文字。
Metafield Key メタフィールドの名前。この列は、他のメタフィールド列が含まれている場合に必要です。最長: 30文字。
Metafield Value メタデータとして保存する情報。この列は、他のメタフィールド列が含まれている場合に必要です。
Metafield Type メタフィールドの情報タイプ。有効な値:
  • string
  • integer
  • json_string

それぞれの値は、大文字と小文字が区別されますこの列は、他のメタフィールド列が含まれている場合に必要です。

Variant Grams グラム単位での商品バリエーションの重量。この列を空白のままとする場合、その値はデフォルトで0に設定されます。この値には重量の単位 (g) を含めないでください。重量がグラム以外で測定される場合、代わりにVariant Weight列を使用します。この列でVariant Weight Unit列を使用しないでください。
Variant Inventory Tracker 商品バリエーションの在庫追跡方法を表します。有効な値は次のとおりです。
  • Shopify - 在庫数量の変化をShopifyが追跡します。
  • fulfillment-service-handle - 在庫数量の変化をShopify外でフルフィルメントサービスが追跡します。この列の値は、Variant Fulfillment Service列の値と一致する必要があります。

それぞれの値は、大文字と小文字が区別されます

Variant Inventory Qty 販売可能な商品バリエーションの個数 (正の整数) を表します。たとえば、5。デフォルトでは0です。この列を空白のままとする場合、その値は0に設定されます。Shopifyが在庫を追跡するのでなければ (つまり、Variant Inventory Tracker列がfalseに設定されていれば)、この列は空白のままとします。在庫数量はストアのデフォルトのロケーションに適用されます。異なるロケーションにおいての在庫数量の変更については、「CSVファイルを使用した在庫のエクスポートまたはインポート」を参照してください。
Variant Inventory Policy 在庫切れの際にお客様が商品バリエーションの注文をすることができるかどうか。有効な値:
  • deny - 在庫切れの場合、お客様は商品バリエーションを注文できません。これはデフォルト値です。
  • continue - 在庫切れの場合、お客様は商品バリエーションを注文できます。

それぞれの値は、大文字と小文字が区別されます

バリエーション在庫の費用 商品バリエーションにかかる費用の記録です。
Variant Fulfillment Service 注文時に商品バリエーションを発送するフルフィルメントサービス。有効な値:
  • manual - 商品バリエーションの注文を手動でフルフィルメントします。これはデフォルト値です。この列を空白のままとした場合、この値がデフォルトで割り当てられます。
  • handle of the fulfillment service - フルフィルメントサービスは商品バリエーションの注文をフルフィルメントします。フルフィルメントサービスを使用する場合は、Variant SKUの列も含める必要があります。

それぞれの値は、大文字と小文字が区別されます

Variant Price 商品バリエーションの価格
バリエーションの割引前価格 商品バリエーションの比較または推奨価格。
Variant Requires Shipping バリエーションを配送する必要があるかどうか。有効な値:
  • true - お客様がこの商品バリエーションを注文する際には住所を提供する必要があります。これはデフォルト値です。
  • false - お客様の住所はオプションです。

それぞれの値は、大文字と小文字が区別されます

Variant Taxable この商品バリエーションが売れたときに課税するかどうか。有効な値:
  • true - 課税されます。これがデフォルトです。
  • false - 課税されません。

それぞれの値は、大文字と小文字が区別されます

Variant Barcode 商品バリエーションのバーコード、UPC、またはISBN番号。
Image Attachment Base64のエンコードされた画像。
Image Src

商品画像のURL (例: http://titan.plus/images/product-image.png)。HTTPではないURLはサポートされません。Transporterアプリはインポート時に画像をダウンロードし、ストアにアップロードします。画像には.png、.gifあるいは.jpgフォーマットを使用できます。画像をアップロードした後にファイル名を変更することはできません。バリエーション特有の画像がある場合、Variant Imageの列に追加します。

単一の商品に対して複数の画像をアップロードするには、各画像用に新しい行を作成します。それぞれの行のHandle列に商品のハンドル、この列に画像のURLを入力します。その画像の他の情報 (位置など) を含めるには、関連する画像の列に情報を入力します。

Image Position ストアフロントの商品ページに表示する画像の順序を表す番号。たとえば、最初に表示させたい商品画像には1を入力します。
Image Alt Text 画像を簡単に説明する代替テキスト。何らかの理由で画像を読み込めない場合、代わりに代替テキストがストアフロントに表示されます。SEOの検索エンジンのためにも、視覚障害のあるお客様に画像を説明するための支援技術としても代替テキストが使用されています。最大で512文字です。
Variant Image 商品バリエーションの画像のURL。商品バリエーションの行のいずれかで、商品バリエーションの画像URLをこの列に入力します。商品バリエーションで表示できる画像は1つのみです。
Variant Weight 商品バリエーションの重量。この列とVariant Grams列を併用しないでください。デフォルト値は0です。値に重量単位を含めないでください。Variant Weight Unit列を使用して、重量単位を指定します。たとえば、商品の重量が100ポンド (lb) で、Variant Weight Unitlbに設定されている場合、この列には100と入力してください。
Variant Weight Unit Variant Weight列で商品バリエーションの重量に適用される測定単位。有効な値はg、kg、oz、およびlbです。デフォルト値は、ストアのデフォルト測定単位となります。Variant Weight UnitVariant Grams列を併用しないでください。
Variant Tax Code 商品のAvalara税コードこのパラメーターは、Avalara AvaTaxアプリをインストールしたストアにのみ適用されます。たとえば、物品の税コードはP000000です。

ファイル名

CSVファイルの名前には、productという単語 (含まれるオブジェクトタイプの名前) を含める必要があります。たとえば、myproducts.csvです。ファイルはUTF-8フォーマットである必要があります。

商品バリエーションが複数ある場合

複数の商品バリエーションがある場合は、各バリエーションを説明する行を作成する必要があります。

商品の行:

  • オプション名の列にオプション名を入力します (例: Color Option1 Nameと入力します)。
  • HandleTitleTypeなど、商品全体に適用される詳細を入力します。

商品バリエーションの行:

  • Handle列に商品ハンドルを入力します。
  • 商品バリエーション行ではオプション名 (Option1 NameOption2 Nameなど) を繰り返さないでください。
  • オプション値の列にオプション値を入力します (たとえば、Option1 NameColor 名として入力した場合は Option1 Value White, BlackBlueなどの値を入力できます)。

次の例をご覧ください。

Screenshot of a product with multiple variants

複数画像

単一の商品 (バリエーションがない) に対して複数の画像をアップロードするには、各画像用に行を作成します。それぞれの行のHandle列に商品のハンドル、Image Src列に画像のURLを入力します。その画像の他の情報 (その位置など) を含めるには、関連する列に情報を入力します (Image Position列など)。

商品バリエーションを持つ商品の画像をアップロードするには、各商品バリエーションの行を作成します。各商品のバリエーション行で、Handle列に商品のハンドルを入力し、Variant Image列に商品バリエーションのURLを入力します。商品バリエーションあたり1つの画像しかインポートできません。

次の例をご覧ください。

Screenshot of a product that has multiple images and multiple product variants

複数のメタフィールド

単一の商品に対して複数のメタフィールドをインポートするには、各メタフィールドの行を作成します。各行に、Handle 列に商品のハンドルを入力し、適切な列にデータをメタフィールドします。各改行には Handle 列とすべてのメタフィールド列にのみ情報が含まれている必要があります。

たとえば、以下の図では1つの商品を3つのバリエーションでインポートします。この商品には、Surf Shoe CoとRubberという2つのメタフィールドがあります。各バリエーションには、1つのメタフィールドがあります。

メタフィールドバリエーションを持つ商品のスクリーンショット

テンプレートとして使用する複数のメタフィールドを持つ商品のサンプルCSVファイルをダウンロードして表示することができます。

関連リンク

Shopifyで販売を開始する準備はできていますか?

無料体験を試す