商品ファイルを使用した商品の一括作成および更新
商品ファイルを準備してSHOPLINEにインポートすることで、新しい商品を作成したり既存の商品を一括で更新したりできます。目的に応じて、以下のいずれかのCSVファイルから始めてください:
- 新しい商品を作成する場合: 商品テンプレートをダウンロードし、商品情報を入力して、完成したファイルをSHOPLINEにインポートします。
- 既存の商品を更新する場合: 既存の商品をエクスポートし、エクスポートしたファイルで情報を更新してから、そのファイルをSHOPLINEに再インポートします。
| 注:SHOPLINEは商品テンプレートおよびエクスポートされた商品データをCSV形式で提供しています。商品をインポートする際は、CSVまたはXLSXファイルをアップロードできます。 |
このガイドでは、適切な商品ファイルの入手方法、商品およびバリエーションデータの準備、利用可能なフィールドの理解、SHOPLINEへの商品インポート方法、および一般的なインポート問題のトラブルシューティングについて説明します。
商品を一括で作成または更新する準備
商品ファイルを準備する前に、以下のようなインポートしたい商品情報を集めてください:
- 商品名および説明
- サイズ、色、フレーバーなどのバリエーション
- 販売価格および原価
- SKUコードおよびバーコード
- 在庫情報
- 商品画像
- 配送情報
商品価格については、以下を入力してください:
- ストアが税抜価格を表示している場合は税抜価格。
- ストアが税込価格を表示している場合は税込価格。
一括作成または更新用の商品ファイルの入手
開始すべきファイルは、新しい商品を作成するか既存の商品を更新するかによって異なります。
新しい商品のための商品テンプレートのダウンロード
商品を一括作成するには、商品テンプレートをダウンロードしてください:
- SHOPLINE管理画面で、商品に移動します。
-
右上のインポートをクリックし、ローカルからインポートを選択します。
-
インポートウィンドウで、商品テンプレートをクリックします。
- ダウンロードしたCSVファイルを開き、商品情報を入力します。
| 注:商品テンプレートのダウンロードや開封時に問題が発生した場合は、Chromeを使用してみてください。 |
一括更新のための既存商品エクスポート
既存の商品を一括で更新するには、まず現在の商品データをエクスポートします。エクスポートしたファイルを使用することで、インポート時にSHOPLINEが既存の商品を照合するための識別子を保持できます。
- SHOPLINE管理画面から、商品に移動します。
-
エクスポートをクリックします。
-
エクスポート範囲の下で、エクスポートしたい商品を選択します:
- すべての商品:ストア内のすべての商品をエクスポートします。
- 選択した商品:商品リストから選択した商品のみをエクスポートします。
- フィルターのすべての結果:商品リストに適用したフィルターに一致するすべての商品をエクスポートします。
-
(任意)エクスポート範囲としてすべての商品またはフィルターのすべての結果を選択した場合、メールでエクスポートのドロップダウンからメールアドレスを選択して、エクスポートされたファイルを受け取ることができます。
- 利用可能なメールアドレス:ストアオーナーのメールアドレスまたは有効化されたスタッフアカウントのメールアドレスのみ選択可能です。ドロップダウンには最初の100件のメールアドレスのみ表示されます。他のメールアドレスを手動で入力することはできません。
- メールの表示と検索:メールアドレスは「メールアドレス(名前)」の形式で表示されます。アカウントにメールアドレスがある場合はリストの上部に表示されます。メールアドレスまたはスタッフ名で検索でき、メールアドレスの一致が優先されます。
- (任意)商品メタフィールドを含める場合は、商品メタフィールドを選択し、最大20個のメタフィールドを選択します。
-
エクスポートをクリックします。選択したメールアドレスの有無により、システムのエクスポート処理が異なります:
- メールアドレスを選択した場合:エクスポートされたファイルは選択したメールアドレスに送信されます。一括処理でエクスポートのステータスも確認できます。
- メールアドレスを選択しなかった場合:エクスポート完了後にファイルをダウンロードできる一括処理ページにリダイレクトされます。
- メールまたは一括処理ページからCSVファイルをダウンロードし、必要に応じて商品情報を更新してください。
|
注意事項:
|
インポート用の商品ファイルの準備
商品テンプレートをダウンロードするか既存の商品をエクスポートした後、スプレッドシートアプリケーションでファイルを開き、商品データを入力または更新してください。
商品ファイルを準備する際は、以下の要件に従ってください:
- 商品テンプレートまたはエクスポートされたファイルには、2つのヘッダー行があります。1行目はフィールドの説明、2行目はフィールド名です。両方の行をそのままにして、3行目から商品データの入力を開始してください。フィールド名や列の順序を変更しないでください。変更するとインポートが失敗する可能性があります。
- 特に指定がない限り、値を入力しない場合でもファイル内のすべての列を保持してください。
- すべての必須フィールドを入力し、「商品ファイルフィールドの理解」に記載されている各フィールドの要件に従ってください。
- 複数のバリエーションがある商品については、各バリエーションの組み合わせごとに別々の行を使用してください。タイトルは各商品の最初の行にのみ入力し、それ以降のバリエーションの行ではタイトルフィールドを空白にしてください。
- 既存の商品を更新する場合は、ハンドルおよびバリエーション関連のフィールドが正しく入力されていることを確認し、意図せず新しい商品を作成したり既存のバリエーション構造を変更したりしないようにしてください。
- SHOPLINEはインポートにCSVおよびXLSXファイルをサポートしており、最大ファイルサイズは40 MBです。
- CSVファイルを扱う際、一部のスプレッドシートアプリケーションはファイルの書式やエンコーディングを開くまたは保存する際に変更することがあります。CSVファイルに文字化けや読めない文字が表示される場合は、「CSVファイルの文字化けの解決」を参照してください。
- 各セルの内容がスプレッドシートアプリケーションでサポートされている制限を超えないようにし、切り捨てや書式の問題を防いでください。:
- Microsoft ExcelおよびWPS: セルあたり32,767文字
- Apple Numbers: セルあたり1,000,000文字
商品ファイルフィールドの理解
商品テンプレートとエクスポートされた商品ファイルは同じ一般的なフィールド構造を使用しています。以下の表を使って各フィールドが何を制御し、どのように値を入力するかを理解してください。
|
注意事項:
|
商品識別フィールド
| フィールド | 説明 | 要件 | |
| 商品ID(エクスポートのみ) | システム生成の商品の一意のID |
|
|
| バリエーションID(任意) | 更新時に既存のバリエーションを識別するために使用されるシステム生成の一意のID |
|
|
| Handle(任意) | インポート時に商品を照合するために使用される一意の商品識別子 |
|
|
| タイトル(必須) | 商品名 |
|
基本商品情報フィールド
| フィールド | 説明 | 要件 | |
| サブタイトル(任意) | 商品サブタイトルまたはキャッチフレーズ |
|
|
| 商品説明html(任意) | 詳細な商品説明 |
|
|
| SPU(任意) | マーチャント定義の内部商品識別子 |
|
|
| ブランド(任意) | 商品ブランドまたは製造元 |
|
|
| タグ(任意) | 商品を分類し、検索やフィルタリングをサポートするためのタグ |
|
|
| カテゴリ(任意) | 商品が属するカテゴリのハンドル |
|
商品画像フィールド
| フィールド | 説明 | 要件 | |
| マスター画像(任意) | 商品画像のURL |
|
|
| 画像代替テキスト(任意) | アクセシビリティとSEOのために使用される商品画像の代替テキスト |
|
SEOおよび商品在庫フィールド
| フィールド | 説明 | 要件 | |
| SEOタイトル(任意) | 検索結果に表示される商品ページのSEOタイトル |
|
|
| SEOディスクリプション(任意) | 検索結果に表示される商品ページのメタディスクリプション |
|
|
| 公開(任意) | オンラインストア販売チャネルに商品が公開されているかどうか |
|
|
| ステータス(任意) | すべての販売チャネルにおける商品の在庫状況 |
|
|
| 非掲載(任意) | 商品がストアフロントの商品リスト、検索、レコメンデーション、検索エンジンを通じて発見可能かどうか |
|
|
| 標準化された商品タイプ(任意) | 標準の商品カテゴリ(Google 商品カテゴリに基づく)、税計算などの目的で使用されます |
|
|
| カスタム商品タイプ(任意) | マーチャント定義の商品カテゴリ |
|
|
| 作成時間(任意) | 商品作成時間。主に過去の商品のデータ移行時に使用されます。 |
|
バリエーションフィールド
| フィールド | 説明 | 要件 | |
| SKU(任意) | 商品またはバリエーションのマーチャント定義の識別子 |
|
|
| Option1 name(任意) | 最初のバリエーションオプションの名前、例:カラー |
|
|
| Option1 value(任意;Option1 nameに値がある場合は必須) | 最初のバリエーションオプションの値、例:赤 |
|
|
| オプション2~オプション5名(任意) | 2番目から5番目のバリエーションオプションの名前 | オプション1名と同じ要件に従ってください。 | |
| オプション2~オプション5値(任意;対応するオプション名に値がある場合は必須) | 2番目から5番目のバリエーションオプションの値 | オプション1値と同じ要件に従ってください。 | |
| オプション1値画像(任意) | 最初のオプション値に割り当てられた画像URL |
|
|
| オプション2~オプション5値画像(任意) | 対応するオプション値に割り当てられた画像URL | オプション1値画像と同じ要件に従ってください。 | |
| 画像(任意) | 特定のSKUに割り当てられた画像URL |
|
|
| SKU画像代替テキスト(任意) | SKU画像の代替テキスト |
|
| ⚠️ 警告: 既存の商品を更新する際は、そのバリエーション構造を変更するつもりがない限り、既存のオプション名やオプション値をクリアしないでください。空白フィールドをスキップはこれらのフィールドには適用されません。 |
価格設定、在庫、税金、および配送フィールド
| フィールド | 説明 | 要件 |
| SKU 販売価格(任意) | SKU の販売価格 |
|
| SKU 定価(任意) | SKU の元の価格または比較価格 |
|
| SKU 重量(任意) | SKU の重量 |
|
| SKUの重量単位(任意) | SKUの重量に使用される単位 |
|
| SKU在庫追跡(任意) | 在庫追跡が有効かどうか |
|
| SKU在庫ポリシー(任意) | SKUが在庫切れのときに顧客が継続して購入できるかどうか |
|
| SKU在庫数量(任意) | SKUの在庫数量 |
|
| 単価(任意) | 単位あたりのコスト |
|
| バーコード(ISBN、UPC、GTINなど)(任意) | SKUを識別するためのバーコード |
|
| SKU税ポリシー(任意) | SKUが課税対象かどうか |
|
| SKU配送ポリシー(任意) | SKUが配送を必要とするかどうか |
|
| HSコード(任意) | 税関申告に使用されるHarmonized System(HS)コード |
|
| 配送元(任意) | SKUの配送元を表す国/地域コード |
|
| 注:ストアで複数の在庫ロケーションを使用している場合、SKU在庫数量は商品インポートでは反映されません。一括在庫更新機能を使用して、ロケーション間の在庫数量を更新してください。 |
その他の商品フィールド
| フィールド | 説明 | 要件 | |
| パス(任意) | 商品のページ用のカスタム相対URLパス |
|
|
| ギフトカード(任意) | 商品がギフトカードかどうか |
|
|
| 含む / マーケット(エクスポートのみ) | 商品が特定のマーケットに公開されているかどうか |
|
|
| 販売価格 / マーケット(エクスポートのみ) | 特定のマーケットにおけるSKUの販売価格。 |
|
|
| メタフィールド説明(エクスポートのみ) | 商品のメタフィールド値 |
|
バリエーションのない商品の商品ファイルへの追加
バリエーションのない商品は、1つのrowに情報を入力します。
-
Titleに商品名を入力します。
注:商品を識別・管理しやすくするために、わかりやすく具体的な商品タイトルを使用してください。例えば、Tシャツではなく、SHOPLINE アニバーサリー Tシャツのようにより詳細なタイトルを使用します。 - (任意) Handleを入力するか、空欄のままにしてSHOPLINEに生成させます。
- (任意) 商品のSKUを入力します。
- SKU priceに販売価格を入力します。空欄の場合、価格は0に設定されます。
- 商品に設定したいその他のフィールドを入力します。
- 別の商品を追加する場合は、次のrowに情報を入力します。
バリエーションのある商品の商品ファイルへの追加
バリエーションのある商品は、各バリエーションの組み合わせごとに別々のrowに入力し、該当するフィールドを完成させます。
例えば、Tシャツに「Color」と「Size」の2つのオプションがある場合、以下のようにフィールドを入力します:
- Option1 name: Colorを入力します。
- Option1 value: 対応する色、例えばRedを入力します。
- Option2 name: Sizeを入力します。
- Option2 value: 対応するサイズ、例えばSを入力します。
各色とサイズの組み合わせは別々のバリエーションを表し、それぞれにrowが必要です。以下の例をご覧ください:
| Title | Option1 name | Option1 value | Option2 name | Option2 value | SKU |
| SHOPLINE Tシャツ | Color | Red | Size | S | TSHIRT-RED-S |
| (空欄) | (空欄) | Red | (空欄) | M | TSHIRT-RED-M |
| (空欄) | (空欄) | Yellow | (空欄) | S | TSHIRT-YELLOW-S |
| (空欄) | (空欄) | Yellow | (空欄) | M | TSHIRT-YELLOW-M |
フィールドを入力する際は、以下のガイドラインに従ってください:
- 商品レベルのフィールド:各商品の最初の行にタイトル、ブランド、タグなどのフィールドを入力します。許可されている場合は、以降のバリエーションの行は空白のままにしてください。
- バリエーションオプションフィールド:ハンドルやオプション名(例:オプション1名)は、すべてのバリエーション行に入力するか、最初の行のみに入力できます。
- SKUレベルのフィールド:SKU、SKU販売価格、SKU在庫ポリシーなどのフィールドに、それぞれのバリエーションの対応する値を入力します。
バリエーションの上書きを防ぐためのタイトルフィールドの正しい入力方法
複数のバリエーションがある商品では、タイトルは最初のバリエーション行のみに入力し、それ以降の行は空白のままにしてください。そうしないと、既存の商品を更新する際に、各後続の行が前の行を上書きし、最後のバリエーションだけが残る可能性があります。
以下の例は、S、M、Lの3サイズの商品に対して、タイトルを正しくおよび誤って入力した場合の例です。
✅ 正しい例:タイトルは最初の行のみに入力
| ハンドル | タイトル | オプション1名 | オプション1値 | SKU販売価格 |
| shopline-shirt | SHOPLINE Tシャツ | サイズ | S | 10 |
| shopline-shirt | (空白) | サイズ | M | 11 |
| shopline-shirt | (空白) | サイズ | L | 12 |
この設定では、インポートされた商品は3つのバリエーション(S、M、L)とそれぞれの販売価格を保持します。
❌ 誤った例:すべてのバリエーション行にタイトルを繰り返し入力
| ハンドル | タイトル | オプション1名 | オプション1値 | SKU販売価格 |
| shopline-shirt | SHOPLINE Tシャツ | サイズ | S | 10 |
| shopline-shirt | SHOPLINE Tシャツ | サイズ | M | 11 |
| shopline-shirt | SHOPLINE Tシャツ | サイズ | L | 12 |
この設定で既存の商品を更新すると、各後続の行が前の行を上書きし、最終的にバリエーションLのみが販売価格12で残る可能性があります。
| ⚠️ 警告:タイトルが繰り返し入力されてバリエーションが上書きされても、システムはインポート成功と報告する場合があります。空白フィールドを無視を有効にしてもこの問題は防げません。必ず各商品の最初の行のみにタイトルを入力し、インポート後にすべてのバリエーションが存在することを確認してください。 |
SHOPLINEへの商品のインポート
商品ファイルを準備したら、SHOPLINEにアップロードして商品を一括で作成または更新します:
- SHOPLINE管理画面から、商品に移動します。
-
右上のインポートをクリックし、ローカルからインポートを選択します。
- <strong>インポート</strong>ウィンドウで、以下のいずれかの方法でCSVまたはXLSXファイルをアップロードします:
- アップロードエリアをクリックして、デバイスからファイルを選択する。
- ファイルをアップロードエリアにドラッグ&ドロップする。
-
インポート設定で、SHOPLINEがファイルを処理する方法に応じてオプションを設定します:
-
同じハンドルの商品を上書きする(ハンドル列がない商品は新規商品として追加されます): 選択すると、ファイル内のハンドルが既存の商品と一致する場合、その商品が上書きされます。選択しない場合、重複するハンドルには自動的に数字のサフィックスが付加され、新しい商品としてインポートされます。ハンドルがない商品はどちらの場合も新規商品として作成されます。
- 空白フィールドをスキップする(未選択の場合、ファイル内の空白が既存データを上書きします): ファイル内の空白フィールドが既存の商品データを上書きしないようにするには有効にします。無効の場合、空白フィールドが既存の値をクリアする可能性があります。
- 商品メタフィールドのみを更新する(既存商品のみ対応 — ハンドルが一致しない行はインポートされません): 既存商品のメタフィールドのみを更新したい場合に有効にします。ハンドルが既存商品と一致しない行はインポートされません。
- 在庫数量を更新しない: ファイル内の在庫数量で既存の在庫を更新したくない場合に有効にします。
-
同じハンドルの商品を上書きする(ハンドル列がない商品は新規商品として追加されます): 選択すると、ファイル内のハンドルが既存の商品と一致する場合、その商品が上書きされます。選択しない場合、重複するハンドルには自動的に数字のサフィックスが付加され、新しい商品としてインポートされます。ハンドルがない商品はどちらの場合も新規商品として作成されます。
- <strong>インポート</strong>をクリックします。
|
注意事項:
|
インポート後の商品確認
インポートが完了したら、商品に移動して作成または更新された商品を確認してください。
影響を受けた商品を開き、以下の重要な情報を確認することをお勧めします:
- 商品情報
- バリエーションとSKU
- 販売価格と原価
- 在庫設定
- 商品画像
- 商品ステータスとオンラインストアでの公開状況
- 税金および配送設定
既存の商品を更新している場合は、意図したフィールドが更新されていること、既存の商品またはバリエーション情報が意図せず上書きされていないことを確認してください。
商品インポートの問題解決
商品ファイルがインポートできない、または一部の商品情報が期待通りにインポートされない場合は、以下を確認してください:
- ファイル形式: CSVまたはXLSXファイルをインポートしていること、ファイルサイズが40MBを超えていないことを確認してください。
- 文字化けや読めない文字: スプレッドシートソフトで開いたり修正した後にCSVファイルに文字化けや読めない文字が含まれている場合は、「CSVファイルの文字化けを解決する方法」を参照してください。
- 列ヘッダー: 商品テンプレートまたはエクスポートされたファイルを使用する場合は、1行目にフィールドの説明、2行目にフィールド名を保持してください。
- 必須フィールド: すべての必須フィールドに有効な値が入力されていることを確認してください。
- フィールドの書式: このガイドに記載されている書式、長さ、データタイプの要件を満たしているか確認してください。
- ハンドル: 商品を更新する際は、ファイル内のハンドルが更新対象の既存商品と完全に一致していることを確認してください。
- バリエーション構造: オプション名、オプション値、バリエーションの組み合わせが正しく入力されていることを確認してください。
- インポート成功後にバリエーションが欠落する場合: 同じ商品の複数のバリエーション行でタイトルが繰り返されていないか確認してください。繰り返されている場合は、最初の行のみにタイトルを残し、それ以降のバリエーション行は空白にしてください。
- 画像: 画像のURLとファイル形式が適用される要件を満たしていることを確認してください。
- 空白フィールド: 商品を更新する場合は、空白フィールドをスキップが有効になっているか、該当フィールドに特別な空白フィールドの動作があるかを確認してください。
- 在庫: ストアで複数の在庫ロケーションを使用している場合は、商品インポートではなく一括在庫更新機能を使って在庫数量を更新してください。
- リクエストパラメーターエラー: Microsoft Excelで編集した後に商品ファイルをインポートする際にリクエストパラメーターエラーが発生した場合は、「商品インポート時の「リクエストパラメーター」エラーのトラブル解決」を参照してください。
CSVファイルに文字化けや誤った書式が表示される場合は、別のスプレッドシートまたはCSV編集ツールで開いて保存し直してから再度インポートを試みてください。
この記事はAIを使用して翻訳されており、不正確な部分が含まれている可能性があります。最も正確な情報については、元の英語版をご参照ください。