選べるギフトのCSV一括登録・更新

「選べるギフトの数が多く、1件ずつ画面で作るのは手間がかかる」という課題に対し、CSVファイルで選べるギフトをまとめて登録・更新できます。季節の入れ替えで子商品の構成をまとめて変えたいときや、新しいカタログを一度にたくさん公開したいときに便利です。

選べるギフトそのものの仕組みや、親商品・子商品の準備については選べるギフト機能をご覧ください。カートで販売中の商品を候補にするときの準備は、カートの既存商品から親商品・子商品を準備するをご覧ください。CSVで登録する前に、親商品と子商品が「商品管理」に登録されている必要があります。

カートの既存商品から親商品・子商品を準備する

「カートで販売中の商品を、そのまま選べるギフトの候補にしたい」ときは、カートから書き出した商品データをもとに、AnyGiftの商品登録用CSVで子商品と親商品を作ってからインポートします。futureshop・ebisumart と商品を同期しているストアでは、カートにない商品（_egift を付けた子商品など）が同期のたびに AnyGift から削除されるため、この手順は使えません。

	親商品	子商品
役割	贈り手がカートに入れて購入する「選べるギフト」本体	受取者が候補から選ぶ商品
商品ID	商品ページのタグに入る本来の商品ID（例: `T-001`）	本来の商品IDの末尾に `_egift` を付けたもの（例: `T-001_egift`）

商品IDの末尾に _egift を付けるのは、商品ページで使う本来の商品IDを親商品に割り当て、子商品と重ならないようにするためです。

手順1：カートから商品データを書き出す

ご利用のカートの商品管理画面から、商品（とバリエーション）のCSVをダウンロードします。

手順2：子商品の行を作る

書き出した商品データを、商品登録用CSVの形式に転記します
「商品ID」列の末尾に _egift を付けます（例: T-001 → T-001_egift）
商品ID以外の列（商品名・SKU ID・価格・画像など）は、書き出した内容のまま使います

手順3：親商品の行を作る

選べるギフトにしたい商品ごとに、親商品の行を1行追加します
商品名・画像・価格などは子商品の行からコピーして、贈り手に見せたい内容に直します
「商品ID」には、_egift を付けない本来の商品ID（例: T-001）を入れます
「商品バリエーション(SKU)ID」には商品IDと同じ値（例: T-001）を、「商品バリエーション(SKU)名」には default を入れます

SKU IDの重複に注意

SKU IDはストア内で重複できません。インポートする商品のSKU IDが、既に登録されている別の商品のSKU IDと同じ場合、その商品は登録されず、インポート結果に「他の商品 [ID:○○] のバリエーションとして登録されています: (SKU ID)」というエラーが行番号付きで表示されます。その場合はCSVのSKU IDを直してから、もう一度インポートしてください。親商品のSKU IDが子商品のSKU IDと同じ値にならないかも確認してください。

手順4：商品登録用CSVをインポートする

商品管理の「インポート」から、手順2・3で作ったCSVを登録します。手順はCSV 一括インポートと同じです。

手順5：選べるギフトのCSVを作ってインポートする

下のCSVファイルの形式に沿って、1列目に親商品のSKU ID（例: T-001）、2列目に子商品のSKU IDを書き、登録・更新の手順でインポートします。

CSVファイルの形式

1行が「親商品と、その候補になる子商品1つ」の組み合わせを表します。子商品が4つある選べるギフトなら、同じ親商品の行を4行書きます。

列	内容	例
1列目	親商品のバリエーション（SKU）ID	`GIFT-SET-A`
2列目	子商品のバリエーション（SKU）ID	`TEA-001`
3列目	受取者が選べる個数（1以上）	`1`
4列目	ステータス（`公開中` または `下書き`）	`公開中`

例えば、「紅茶4種から1つ選べるギフト」は次のように書きます。

親商品バリエーション(SKU)ID,子商品バリエーション(SKU)ID,選べる個数,ステータス
GIFT-SET-A,TEA-001,1,公開中
GIFT-SET-A,TEA-002,1,公開中
GIFT-SET-A,TEA-003,1,公開中
GIFT-SET-A,TEA-004,1,公開中

ファイルを作るときは、次の点に注意してください。

1行目は見出し行として読み飛ばされます。データは2行目から書いてください
文字コードは UTF-8、拡張子は .csv にしてください
4列目に 公開中 以外（空欄を含む）を書いた場合は「下書き」として登録されます
同じ親商品の行では、選べる個数とステータスは最初の行の値が使われます。行ごとに違う値を書いても反映されないため、そろえておいてください
同じ親商品の中で、同じ子商品を2行書かないでください。 重複があるとその親商品の登録に失敗し、既に登録されていた選べるギフトも消えてしまいます
親商品を、別の選べるギフトの子商品として使わないでください。また、子商品を別の選べるギフトの親商品として使うこともしないでください。管理画面で作るときと同じ組み合わせのルールを守ってください
受取画面での子商品の並び順は、CSVに書いた行の順になります

いちばん簡単な作り方

「選べるギフト一覧」の「CSVダウンロード」で出力されるファイルは、インポートと同じ形式です。まず今の設定をダウンロードし、それを編集してアップロードすると、列の並びを間違えずに済みます。

登録・更新の手順

管理画面の左メニューから「選べるギフト機能」を開きます
「選べるギフト一覧」の「インポート」を押します
作成したCSVファイルを追加し、「実行」を押します
登録が終わるまで、画面に進み具合が表示されます。完了するまで画面を閉じずにお待ちください
すべて成功すると「登録しました」と表示され、一覧に戻ります

登録中に「キャンセル」を押すと、まだ処理を始めていない親商品の登録を止めます。キャンセルを押した時点で処理中だった分と、登録が終わった分は残ります。どこまで登録されたかは「選べるギフト一覧」で確認してください。

既に登録されている選べるギフトを更新する場合

CSVに書いた親商品の選べるギフトが既にある場合は、CSVの内容で丸ごと置き換えられます。子商品を1つ足したいときも、残しておきたい子商品を含めたすべての子商品の行を書いてください。CSVに書かなかった子商品は、その選べるギフトの候補から外れます。

CSVに書かなかった親商品の選べるギフトは変更されません。

エラーが出たとき

登録できなかった行があると、成功件数と失敗件数、失敗した行の行番号と理由が表示されます。

登録は親商品ごとに行われます。ある親商品の行に1つでもエラーがあると、次のどちらかになります。

画面側で検出されるエラー（SKU IDの入力漏れ・選べる個数の誤り）は、その行だけが登録から外れ、同じ親商品の残りの行で選べるギフトが作られます。外れた子商品は候補に入りません
登録処理で検出されるエラー（商品が見つからない、親商品と子商品が同じなど）は、その親商品の行がすべて登録されず、全行に同じ理由が表示されます

どちらの場合も、直した行だけをアップロードすると、選べるギフトがその行だけの内容に置き換わってしまいます。エラーを直したら、「再登録する」から、エラーが出た親商品の行をすべて含めたCSVをアップロードしてください。エラーのなかった親商品の行は、含めても含めなくてもかまいません。

表示されるメッセージ	主な原因と対処
親商品SKUCodeが未入力です／子商品SKUCodeが未入力です	1列目または2列目が空欄です。SKU IDを入力してください
選択可能な数量は1以上を指定してください。	3列目が空欄・0・数字以外になっています
親商品バリエーション（SKU: ○○）が見つかりません	「商品管理」に、そのSKU IDの商品が登録されていません。SKU IDの誤りか、商品の登録漏れがないか確認してください
子商品バリエーション（SKU: ○○）が見つかりません	同上（子商品側）
親商品と子商品に同じ商品を指定することはできません	1列目と2列目に同じ商品が入っています
処理中にエラーが発生しました／登録に失敗しました	同じ親商品の中に同じ子商品の行が2つあるなど、保存できない内容が含まれています。重複を消してから、その親商品の行をすべて含めて再登録してください。直らない場合はAnyGift担当窓口へお問い合わせください
.csv で終わるファイルを選択してください。／UTF-8のファイルを選択してください	ファイル形式または文字コードが違います。Excel で保存する場合は「CSV UTF-8（コンマ区切り）」を選んでください

公開前に確認してください

ステータスを 公開中 にして登録すると、親商品のeギフトがONになっていれば、すぐに購入者が選べる状態になります。初めて登録するときは 下書き で登録し、管理画面で内容を確認してから公開すると安心です。