FTPサーバから商品画像・商品グループ画像・アイテムをアップロード

商品画像・商品グループ画像・アイテムはFTPサーバからアップロードして登録できます。

※FTPサーバ情報はフューチャーショップサポートよりご案内いたします。
※FTP専用のサーバとなりますので、いわゆるWebサーバ領域としてはご利用いただけません。

＜目次＞

• 商品画像の一括アップロード
• 商品グループ画像の一括アップロード
• 商品画像・商品グループ画像の取得方法
• 商品画像・商品グループ画像のFTPサーバのディレクトリと画像URL
• アイテム（デザイン画像・JavaScriptファイル・CSSファイルなど）のアップロード
  • FTPサーバのディレクトリ（アイテム）
• ご注意事項

対応ファイル形式は、JPEG（.jpg）のみになります。 JPEG（.JPG）・JPEG（.jpeg）・PNG・GIFなどはご利用できません。
使用可能な商品画像ファイルの最大容量は1MBまでです。

商品情報が登録されている場合、以下の手順で商品画像を登録できます。
登録されていない商品の画像は登録できません。

画像をアップロードすると、商品画像登録用ファイル（CSVファイル）アップロードなしで、商品画像として掲載されます。

商品画像に商品バリエーションを設定する、またはALTテキストを登録する、あるいは商品サムネイル画像や画像並び順を任意に指定するには商品画像登録用ファイル（CSVファイル）をアップロードします。

詳しくは運用＞商品管理＞商品データ一括登録をご覧ください。

＜手順＞

1. FTPサーバの /upload/image/ ディレクトリに商品画像を配置します。
   
   
2. 商品画像をZIP形式のファイルにして配置してください。
   • ZIPファイル容量は512MBまでです。
   • ZIPファイル内にファイル数は、500ファイルまでにしてください。
   • ZIPファイル内にフォルダなどを含めず、画像のみをZIPファイルに圧縮してください。
     
     
3. ZIPファイル名は product_ + 任意の文字列 + .zip （「product」の後の文字は半角アンダーバーです）としてください。
   任意の文字列には半角英数、「_（アンダーバー）」、「-（ハイフン）」、「.（ピリオド）」が使用できます。「product.zip」も可能です。
   
   
4. アップロードできるのは、オリジナル画像のみとなります。リサイズ処理は、画像表示時に自動で最適化される仕様となっております。
   そのため、サイズ違いの画像（リサイズ画像）はアップロードできません。
   
   
5. FTPサーバの指定ディレクトリへZIPファイルを配置すれば、自動的に取り込み処理が行われます。（定期的な自動処理となります。）
   処理状況は運用＞商品管理＞商品データ一括登録履歴一覧に表示されます。
   
   

商品画像について詳しくは商品画像設定（コマースクリエイター）をご覧ください。

アップロード作業前に、アップロードにあたっての注意事項をご確認ください。

画像ファイル名について

アップロードするオリジナル画像のファイル名は以下としてください。

商品URLコード-画像No(01-40).jpg

対応ファイル形式は、JPEG（.jpg）のみになります。 JPEG（.JPG）・JPEG（.jpeg）・PNG・GIFなどはご利用できません。
使用可能な商品画像ファイルの最大容量は1MBまでです。

商品グループ情報が登録されている場合、以下の手順で商品画像を登録できます。
登録されていない商品グループの画像は登録できません。

＜手順＞

1. FTPサーバの /upload/image/ ディレクトリに商品グループ画像を配置します。
   
   
2. 商品グループ画像をZIP形式のファイルにして配置してください。
   • ZIPファイル容量は512MBまでです。
   • ZIPファイル内にファイル数は、500ファイルまでにしてください。
   • ZIPファイル内にフォルダなどを含めず、画像のみをZIPファイルに圧縮してください。
     
     
3. ZIPファイル名は category_ + 任意の文字列 + .zip （「category」の後の文字は半角アンダーバーです）としてください。
   任意の文字列には半角英数、「_（アンダーバー）」、「-（ハイフン）」、「.（ピリオド）」が使用できます。「category.zip」も可能です。
   
   
4. 取り込み処理が終了すると、商品グループ画像として掲載されます。
   商品グループ画像にALTテキストを登録するには、商品グループ一括登録（コマースクリエイター）（CSVファイル）をアップロードします。
   詳しくは運用＞商品管理＞商品データ一括登録をご覧ください。

アップロード作業前に、アップロードにあたっての注意事項をご確認ください。

画像ファイル名について

アップロードするオリジナル画像のファイル名は以下としてください。

商品グループURLコード.jpg

バックアップなどのために、登録されている商品画像・商品グループ画像をFTPから取得できます。
商品画像はFTPサーバの /itembox/product/、商品グループ画像は /itembox/category/ から取得できます。

商品画像・商品グループ画像のアップロードディレクトリとURLは以下となります。

商品IDは商品情報登録時にシステムから自動発番されるIDです。
商品グループIDは商品グループ登録時にシステムから自動発番されるIDです。

商品IDは、Googleデータフィード登録用ファイル（コマースクリエイター）-商品番号【基本情報】に出力されます。
運用＞商品管理＞商品データ一括取得にてCSVをダウンロードしてご利用ください。

対応ファイル形式は、JPEG（.jpg）、GIF（.gif）、PNG（.png）、SVG（.svg）になります。
使用可能な画像ファイルの最大容量は1ファイルあたり30MBまでです。

コマースクリエイター＞アイテムに登録するファイルを、FTPサーバーからアップロード/ダウンロードできます。

基本仕様

• FTPサーバの /itembox/item/ ディレクトリにファイルを配置します。
• /itembox/item/ ディレクトリ配下に直接、またはディレクトリを作成し、その配下にファイルをアップロードできます。
• ディレクトリ名・ファイル名には、半角英数字と記号「.」「_」「-」「/」を利用できます。
• 同じディレクトリ、同じファイル名でアップロードすれば、上書きは可能です。

コマースクリエイター＞アイテムとの関係性

• /itembox/item/ディレクトリは、コマースクリエイター＞アイテムと同期しています。
• アップロードしたファイルは、コマースクリエイター＞アイテムに表示されます。
  アイテム名は（/itembox/item/以下の）ファイルパス」となります。
• FTPでアップロードした場合、管理タグは設定できません。
  管理タグを設定したい場合は、コマースクリエイター＞アイテムから行ってください。一括で設定する方法はありません。
• FTPサーバから削除すると、コマースクリエイター＞アイテムからも削除されます。

URLについて

• アップロードしたファイルは、 https://{店舗key}.itembox.cloud/item/ファイルパス（アイテムのパス） のURLで表示できます。
  （例）「/item/sample.png」のURLは、「https://{店舗key}.itembox.cloud/item/sample.png」となります。

ご注意事項

• 初期配置されているディレクトリ /itembox/item/s/ 配下には、htmlファイルおよびJavaScriptファイルのみ配置できます。
  htmlファイル・JavaScriptファイル以外をアップロードすると正しく読み込めなくなる場合があります。
  その他の形式のファイルは、パスに「/s」以外を指定してください。
• /itembox/item/s/ ・ /itembox/item/top/ は用途が固定された既定のディレクトリ名です。削除しないでください。
• ZIPファイルでの一括アップロードはできません。
• アイテムにアップロードした画像はキャッシュ機構により一時的に保存されていますので、アイテムをURLにて直接指定して表示した場合、上書きしてもすぐには更新されません。（1分程度）
  ただし、パターンパーツ（カルーセル・コラム）の画像表示機能を使用している場合や、フリーパーツやフリーページ本文にて「アイテム置換文字」を使用して表示している場合は、すぐに更新されます。

FTPサーバのディレクトリ（アイテム）

初期は下記のようなディレクトリ構成となっています。

アイテムについて

• アイテムにアップロードできるファイルの最大容量は、1ファイルあたり30MBです。（管理画面・FTPサーバ共通）
• 動画ファイルについては、1ファイルで30MBを超える場合がございます。
  外部の動画配信サービス（【参考】虎の巻）をご利用ください。CMSサーバー（VPS）への配置もお控えください。
• パターンパーツなどで、画像として取り扱うファイル形式はJPEG（ jpeg / jpg ）、GIF（gif）、PNG（png）、SVG（svg）となります。
• 登録可能な画像ファイルは縦・横とも9,999ピクセルまでとなります。

アイテムについて詳しくはコマースクリエイター＞アイテム一覧をご覧ください。

＜ご注意事項＞

FTPサーバはコマースクリエイター＞アイテムのファイルを登録・更新・削除する仕組みですので、いわゆるサーバサイドプログラム（PHPやPerlなど）を実行することはできません。必要な場合は「CMSサーバー（VPS）オプション」をご利用ください。

最新ファイルを読み込ませる記載方法

CSSに画像ファイルなどのURLを直接記載する場合は、以下のように 「タイムスタンプ」を記載してください 。
「最新ファイルに変更したにもかかわらず表示が変わらない（キャッシュをクリアしなくてはならない）」などを防げます。

https://{店舗key}.itembox.cloud/item/{アイテム一覧で指定したパス}?t=[タイムスタンプ]

タイムスタンプは、「年月日秒」単位まで指定可能です。（秒数はアップロード時以前の秒であれば、おおよそで構いません。）

【例】2020年7月9日5時00分30秒に更新したファイルを読み込ませたい場合
https://{店舗key}.itembox.cloud/item/sample.jpg?t=20200709050030

＜ご注意事項＞

• ファイルを更新した場合は、タイムスタンプも更新してください。
• ファイルをアップロードする前にファイルのパスを記述したページを公開した場合にも、キャッシュが発生（ファイルがない状態をキャッシュ）する場合がありますので、その際には同様にタイムスタンプを記述してください。

アップロードにあたっての注意事項

複数ファイルを続けてアップロードする際、処理エラーとなり、一括登録が停止してしまう場合があります。

運用＞商品管理＞商品データ一括登録履歴一覧のページを更新し、処理の完了をご確認後、1ファイルずつアップロードしてください。
特にファイルサイズが大きい場合などは、1ファイルごとに履歴をご確認ください。

＜ご注意事項＞

• 商品情報およびバリエーションなどの情報を登録後に（商品画像を登録する）ZIPファイルをアップロードしてください。
  画像登録処理と同時に、商品やバリエーションを登録することはできません。
• ZIPファイルの処理中に、対象の商品情報を管理画面で変更・追加されますと、ファイル登録処理に影響がでる場合があります。
  商品情報変更作業をされない時間に、ZIPファイルアップロードを行うことを推奨いたします。
• 画像ファイルの容量、混雑状況により処理時間がかかる場合があります。
  余裕を持った作業スケジュールをご計画いただくことをおすすめします。
• 空のディレクトリをアップロードすることはできません。