インポートとエクスポート
CSVファイルを使ってストア間でオプションセットを移動したり、バックアップを作成したり、他の商品オプションアプリから移行したりします。
オプションセットをエクスポートでは、オプションセットを含むCSVファイルを作成します。オプションセットをインポートでは、このアプリで作成したCSVファイル、または対応している他の商品オプションアプリからエクスポートしたCSVファイルをアップロードできます。
これらのツールは、大きな変更を加える前のオプションセットのバックアップ、開発ストアから本番ストアへの設定の移動、乗り換え元のアプリからの移行に使います。
どちらの操作も、オプションセットページのオプションセットを作成の横にあります。インポートとエクスポートはプランによって個別に管理されるため、一方だけ利用できる場合があります。
エクスポート
-
特定のセットだけをエクスポートしたい場合は、含めるオプションセットを選択します。
すべてをエクスポートする場合は、この手順を省略します。
-
オプションセットをエクスポートを選択し、範囲を選ぶ
選択肢 含まれる内容 現在のページ 表示中のページにあるすべてのオプションセット すべてのオプションセット ストア内のすべてのオプションセット 選択済み:N件のオプションセット 選択した行のみ。何も選択していない場合は利用できません。 形式はプレーンCSVファイルです。
-
もう一度オプションセットをエクスポートを選択する
ブラウザで
OptionsExport.csvがダウンロードされます。

現在のページ、すべて、または選択したものだけをエクスポートできます。
インポート
-
オプションセットをインポートを選択してファイルを追加する
オプションセットをインポートを選択し、ファイルをドロップゾーンにドラッグするか、デバイスから参照してアップロードします。
対応しているファイル形式:
.csv、.txt、.xlsx、.xls。ファイルサイズの上限は10MBです。ファイルを手動で作成する場合は、ファイル構造をゼロから作るのではなく、ダイアログにあるサンプルCSVテンプレートを使ってください。
-
インポート元のアプリを選択する
インポートするアプリを選択で、ファイル内の列をどのように解釈するかをアプリに伝えます。デフォルトは Globo Product Options, Variant で、Easify、Avis、OPTIS、Qikify、Hulk、APO のファイルにも対応しています。
間違ったアプリを選択することが、インポートのエラーやデータの誤ったマッピングの最も一般的な原因です。
-
「インポートしたすべてのオプションセットをアクティブに設定」はオフのままにする
デフォルトでは、インポートしたオプションセットは下書きとして保存されるため、顧客に表示される前に確認できます。インポートしたセットを公開する準備ができていると確信できる場合にのみ、このオプションを有効にしてください。
-
アップロードして続行を選択し、インポートしたセットを確認する
インポートした各オプションセットを開き、オプション、名前フィールド、アドオンの設定、商品ルールを確認します。
ファイルを自分で作成する
他のアプリからエクスポートするのでない場合は、サンプルファイルから始めてください。主なオプションタイプそれぞれの動作する例が1つずつ含まれているため、推測せずに正確な列のレイアウトを確認できます。
列の仕組み
| 列 | 内容 |
|---|---|
option_id | オプションを識別します。同じオプションに値を追加するには、追加の行でこれを繰り返します |
option_type | text、select、checkbox、color-swatches など |
option_label、option_name | 顧客が読むテキストと、注文に表示される名前。ラベルと名前をご覧ください |
required、min、max | Yes または No、およびそのオプションタイプの制限 |
placeholder、helptext | フィールド内のヒントと、その横に表示されるテキスト |
option_value | 1つの選択肢。選択タイプでは、選択肢ごとに1行が必要です |
addon | その行のアドオン価格 |
swatch_value | カラースウォッチの場合は #FF0000 などの16進数カラー、画像スウォッチの場合は画像のURL |
paragraph | 段落要素の内容 |
products | オプションセットを適用する商品 |
真似すべきパターンは、サンプル内のすべての選択タイプで使われているものです。オプション自体の列を最初の行に入力し、追加の値ごとに option_id と option_value だけを入力した行を追加します。
select-1,select,Select,Select,No,,,Please select,,select 1,,,,select-1,,,,,,,,,select 2,,,,他のアプリから移行する
インポートの手順は上記と同じですが、さらに2つの推奨事項があります。
- オプションセットを有効にせずにインポートします。 まず内容を確認し、準備ができたら有効にします。
- 以前のアプリをアンインストールする前に、インポートしたセットを少なくとも1つ、実際の商品でテストします。 先に以前のアプリをアンインストールすると、顧客にすぐ気づかれる空白期間が生じる可能性があります。
アプリによってオプションの構造が異なるため、多少の手直しが必要になる場合があります。特に次の点に注意してください。
| 確認項目 | 理由 |
|---|---|
| アドオン価格設定 | 他のアプリの価格設定は正確に対応しない場合があります。各価格を確認し、適切な価格設定モードを選択してください。アドオン価格設定をご覧ください |
| 条件付きロジック | 演算子はアプリによって異なる場合があるため、一部の条件は作り直す必要があるかもしれません。 |
| オプションの名前フィールド | 読みやすく一意であることを確認してください。ラベルと名前をご覧ください |
| 商品ルール | 各オプションセットが意図した商品を対象にしていることを確認してください。 |
| スウォッチの画像 | 以前のアプリが画像を自前でホストしていた場合は、再度アップロードする必要があるかもしれません。 |
移行されるものとされないもの
エクスポートしたオプションセットには、それ自体の設定が含まれます。ストア全体の設定は別に扱われます。
- 色、枠線、タイポグラフィー、カスタムCSS、ウィジェットの位置と動作 — 設定からエクスポートします。設定のインポートとエクスポートをご覧ください。
- ウィジェットのテキストと検証メッセージ — 設定 > 翻訳。
- 自動化 — ストアごとに設定します。
- アドオン商品 — 新しい商品で価格設定したアドオンは、インポート時にインポート先のストアで新しい商品が作成されます。既存の商品にリンクされたアドオンは元のストアの商品を参照しているため、ストア間でインポートした後にリンクし直してください。
- 無効なアドオン価格 — アプリが保存できない価格を含むオプションセットはスキップされ、インポート時にそのオプションが示されます:… のアドオン価格を保存できません。数値を使用し、負の価格は使わず、パーセンテージは0より大きくしてください。 ファイル内の該当する価格を修正し、再度インポートしてください。
注意事項
- インポートしたオプションセットは新しいセットとして追加され、既存のセットが統合されたり上書きされたりすることはありません。同じファイルを2回インポートすると、コピーが2つ作成されます。
- インポートには、プランの上限と機能が適用されます。ファイルにプランでサポートされていない機能が含まれている場合、一部だけが適用されるのではなく、インポート全体が拒否されます。
- アプリの以前のバージョンからエクスポートしたファイルも引き続きサポートされています。アプリが以前の列形式を自動で検出します。
エクスポートしたCSVの内容(列ごと)
この情報が必要になるのは、ファイルを手作業で読んだり編集したりする場合だけです。
ファイルには、オプション値ごとに1行があります。テキストフィールドなど値のないオプションは1行になります。オプションセット全体またはオプション全体を表す列は、最初の行にのみ入力され、残りの行は空欄になります。
| 列 | 内容 |
|---|---|
option_set_id | オプションセットのID。そのセットのすべての行で繰り返されます |
option_set_name | オプションセットの名前。最初の行のみ |
option_id | セット内でのオプションの内部ID |
option_type | オプションのタイプ |
option_label | オプションのラベル(翻訳を含む) |
option_name | オプションの名前 |
required | 必須項目がオンの場合は yes |
allow_multiple | 複数選択または複数ファイルのアップロードがオンの場合は yes |
min、max | オプションの最小値と最大値(そのタイプで何を測るかによる) |
placeholder | オプションのプレースホルダー |
helptext | オプションのヘルプテキストとその位置 |
option_value | この行の値(独自のヘルプテキストがある場合はそれも含む) |
addon | アドオンの設定:モード、商品とバリエーション、価格 |
swatch_name | スウォッチの内部名 |
swatch_value | 色、分割スウォッチの2色、または画像のアドレス |
swatch_asset_name | アップロードした画像のファイル名 |
default_value | オプションのデフォルト値 |
rich_text_value | 段落、ポップアップモーダル、HTML、サイズ表、タブのリッチテキストの内容 |
advanced_settings | 詳細設定タブとパーソナライザータブのすべての設定(1つのセル内) |
columnWidth | オプションの列幅 |
conditionalField | このオプションで条件付きロジックがオンの場合は yes |
condition_logic | 条件付きロジックのルールそのもの |
products | 商品ルール。最初の行のみ |
customers | 顧客ルール。最初の行のみ |
countries | 国ルール。最初の行のみ |
settings | パーソナライザーの背景を含む、オプションセットの設定。最初の行のみ |
このページは役に立ちましたか?
フィードバックありがとうございます。 足りなかった情報を教える
問題を報告