アイテムマスタデータのフォーマット

商品情報をRtoaster action+に登録するため、アイテムマスタ(アイテム情報)のインポートが必要です。

フォーマット形式

  • ヘッダー部分はアイテム設定で設定されているフィールド名を使用します。
  • CSVファイルに記載されている制御文字は、CR、LF、水平タブ以外は削除されます。
    • 空白(半角全角)、タブは削除されます。
    • 削除された結果、空文字になるようなデータが存在するとインポート時にエラーになります。
  • 文字コードはShift-JIS、UTF-8でインポート可能です。

Rtoasterアイテムマスタデータ仕様書はこちらをご参照ください。

CSVフォーマットのサンプル

注意事項

  • アイテム設定で設定されているフィールド全てをヘッダー部分に記載してください。
    存在しないものがあるとエラーになります。
    • アイテム設定で設定されていないフィールドがヘッダーに存在するとエラーになります。
    • 固定アイテムフィールドは任意設定です。
      ヘッダーが存在しなくてもエラーにはなりません。
  • 各項目には以下の入力制限があります。アイテムマスタをインポートされる際はご注意ください。
    • アイテムコード / グループ:150文字以内
    • アイテム名 / カテゴリ  :250文字以内
    • 汎用フィールド     :2,500文字以内
    • 価格          : 0 ~ 999,999,999.99
    • 価値          : 0 ~ 99,999,999.999
  • 汎用フィールド以外は必ず各項目に値を入れる必要があります。
  • 全角、半角問わず文字数でカウントします。
  • 改行は1文字としてカウントされます。
  • 価格は、数値(カンマ区切り可)のみとなります。
    価格の値に「¥」を付与する場合は、Webテンプレート設定を利用してください

固定アイテムフィールド(特殊フィールド)

自動レコメンド基本設定のアイテム設定で設定されているフィールド以外に、
アイテムの状況を管理する為にご利用いただける特殊なフィールドです。

《閲覧履歴の特殊なフィールド設定について》

  • レコメンド方法が「閲覧履歴」の場合、アイテムマスタの特殊なフィールド設定の状態に関わらず
    アイテムが表示されます。
  • 特殊なフィールド設定の内容を反映させるためには、「フィルタを設定」から『特殊フィールドを利用して無効となっている商品を表示しない』を有効としてください。
    ※デフォルトでは、特殊フィールドによる制御が無効になっています。
  • 特殊なフィールド設定を行ったアイテムマスタをインポートすると、
    即時にサイト側のレコメンドへ反映されます。
  • 各アイテムの特殊フィールドの設定値(フラグの値)はRtoaster action+管理画面(アイテム確認・停止)から確認することができません。
    お客様で管理いただいているアイテムマスタをご確認ください。
  • 「削除フラグ」「無視フラグ」についての詳細はRtoasterアイテムマスタデータ仕様書をご参照ください。

在庫フラグ

  • 在庫切れ等の理由でレコメンド結果として表示しないアイテムがある場合に設定します。
ヘッダー 詳細および設定値
在庫フラグ

商品の在庫の有無を示すフィールドです。 

《設定値》

  • 在庫あり(レコメンドする場合)  : 1
  • 在庫なし(レコメンドしない場合) : 0

在庫フラグ:0とした場合、該当するアイテムはレコメンド表示されず、閲覧・購買学習の対象外となります。

表示フラグ

  • アイテムの閲覧・購買学習にのみ利用し、レコメンド結果として表示しないアイテムがある場合に設定します。
ヘッダー 詳細および設定値
表示フラグ

自動レコメンドの結果として商品を表示することを示すフィールドです。

《設定値》

  • 表示する (レコメンドする場合)  : 1
  • 表示しない(レコメンドしない場合) : 0

表示フラグ:0とした場合、該当するアイテムはレコメンド表示されませんが、閲覧・購買学習の対象となります。

開始日時、終了日時

  • レコメンドする商品の開始日時と終了日時を設定します。
    期間限定の商品や、自動レコメンドの「新着アイテム」などに利用します。
  • 開始日時前または終了日時後の商品はレコメンド対象外になります。
ヘッダー 詳細および設定値
開始日時

商品のレコメンド開始日時を示すフィールドです。

《設定値》

  • YYYY/MM/DD hh:mm
    例)2013/01/01 09:00
    • hh:mmは任意設定になります。
    • hh:mmを指定する場合はYYYY/MM/DDの後に半角スペースを入れてください。
終了日時 

商品のレコメンド終了日時を示すフィールドです。

《設定値》

  • YYYY/MM/DD hh:mm
    例)2013/01/01 09:00
    • hh:mmは任意設定になります。
    • hh:mmを指定する場合はYYYY/MM/DDの後に半角スペースを入れてください。

在庫フラグ、表示フラグを変更する

インポート済みのアイテムマスタのうち、在庫フラグ、表示フラグの登録情報だけを変更することができます。

  • 在庫フラグを変更
  • 表示フラグを変更
  • 在庫フラグと表示フラグを変更

以下いずれかのフォーマットを用いて差分更新でアイテムマスタをインポートした場合、
該当アイテムの各カラムの状態を変更することができます。

 

■ CSVフォーマットのサンプル

在庫フラグのみ変更する場合
在庫フラグと表示フラグを変更する場合

《Rtoaster action+自動データアップロードプログラムでのご利用について》

  • 『在庫フラグ』『表示フラグ』の変更を行う場合、importer-1.9.0以降のご利用が必須となります。
  • Rtoaster action+自動データアップロードプログラムの最新版はこちらから取得していただけます。