概要

dfplus.ioに取込んだ商品データのことを「マスターデータ」と呼びます。マスターデータを加工することで、データフィードを作成します。

この記事ではdfplus.ioで利用可能な商品データ形式と取込設定について記載します。

dfplus.ioでは、CSVやTSVファイルの商品データをマスターデータとして取込む「通常取込」と、特定のECシステムから商品情報をマスターデータとして取込む「ECシステム連携」があります。

すぐに使えるサンプルマスターデータはこちらからどうぞ。
下の画像を右クリックし、URLをコピーして動作確認でご利用ください。

マスタデータの仕様
設定方法
運用開始後の商品データ構成変更時の注意点
- 見出し行がある商品データを利用している場合
- 見出し行がない商品データを利用している場合
  - 取込エラーの解消について
サーバー取込とローカルファイルアップロードの切り替え
マスターデータのダウンロード方法

マスタデータの仕様

対応している商品データの文字コード

マスターデータとして取り込む商品データファイルについて、下記の文字コードに対応しています。

UTF-8
UTF-16
Shift_JIS (CP932, Windows-31J)
EUC-JP (eucJP-ascii, eucJP-ms, CP51932)
ISO-2022-JP

IPアドレスについて

dfplus.ioが商品データを取り込む際に使用するIPアドレスを記載します。商品データ保管環境へのアクセスにIPアドレス制限が行われている場合は、下記のIPアドレスを許可してください。

52.69.241.47
52.196.213.86
52.193.169.195

アクセス制限について

お客様の商品データが Amazon S3 をご利用の際は IPアドレスを指定したアクセス制限ができません。
下記の例を参考にAmazon S3のバケットポリシーを利用してアクセス制限をして下さい。

  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "識別子(アカウント内でユニークなIDを指定します)",
      "Action": "s3:GetObject",
      "Effect": "Allow",
      "Resource": [
        "arn:aws:s3:::s3のResorce名を指定して下さい",
        "arn:aws:s3:::s3のResorce名を指定して下さい/*"
      ],
      "Condition": {
        "StringEquals": {
          "aws:sourceVpce": [
            "vpce-0c8e6065",
            "vpce-03b6586a"
          ]
        }
      },
      "Principal": "*"
    }
  ]
}

設定方法

dfplus.ioへ商品データを取込んでマスタデータを設定します。

1. 取込設定

1-1. 商品データの取込方法を選択

商品データの取込方法には、任意の場所へ商品データをアップロードした後にdfplus.ioで取込む「サーバー取込」、PCから直接商品データを取込む「ファイルアップロード」、特定のECシステムと連携し、ECシステムに登録されている商品情報をdfplus.ioに取込む「ECシステム連携」の3つの取込方法があります。

サーバー取込

「通常取込」を選択し、「商品データ取込先」に任意の場所へアップロードされた商品データのパス（置き場所）を設定してください。

商品データ取込先にアクセスする際に、ユーザー名とパスワードが必要な場合は、「ユーザー名」「パスワード」の入力欄に設定してください。

サーバー取込に関する設定手順はこちらをご参照ください。

ファイルアップロード

「通常取込」を選択し、「商品データ」の枠へPCから商品データをドラッグアンドドロップしてください（もしくは「ファイルを選択」から商品データを選択してください）。

※なお、dfplus.io管理画面からFTPアカウントを発行することができます。こちらを商品データの置き場（サーバー）として利用することができます（FTPアカウントの発行方法はこちらをご参照ください）。

ファイルアップロードに関する設定手順はこちらを参照ください。

ECシステム連携

「ECシステム連携」を選択し、連携するECシステムごとの設定を行ってください。

ECシステム連携に関する設定手順はこちらをご参照ください。

1-2. ファイル形式を選択

商品データ取込先で指定したファイルの形式を選択します。

CSV（カンマで区切られたテキストファイル）
TSV（タブで区切られたテキストファイル）

※サイトクローリングによるデータ取得は対応しておりません。必ずマスターデータとして使用するファイル（商品データ）をご用意ください。

1-3. 見出し行あり/なしを選択

取り込む商品データの1行目が項目名の場合は、「見出し行あり」にチェックしてください。
1行目から商品の値の場合は、チェックを外してください。

1-4. 「次へ」を選択し、取込設定を保存して項目設定に進む

取込設定の入力を終えたら、「次へ」進んでください。
正しい情報が入力されていれば、ファイルの1行目の情報が次のページで表示されます。

2. 項目設定

2-1. 識別しやすい項目名に変更する

この後のデータフィード設定で認識しやすいように、マスターデータの項目名を変更できます。
例えば、1行目に項目名が存在していない場合や、元のファイルにはアルファベットで列名が記載されているが、日本語名にしたい場合などです。

※項目名への記号文字（ % や @、() など）の使用は非推奨です。今後のバージョンアップで使用禁止になる可能性があります。取込した商品データの1行目に記号が含まれている場合は、記号文字を使用しない名称を指定してください。 ※この変更は、あくまでdfplus.io内のマスターデータのみに反映されます。

2-2. 拡張項目を追加する（オプション）

もし、商品データに存在しない項目（カラム）を追加したい場合は、拡張項目を設定できます。
拡張項目は、後の変換ルールやフィード項目マッピングで使用可能です。

拡張項目はいつでも追加可能です。また、ルール設定画面でも作成可能です。
必要に応じて設定してください。

拡張項目に関する詳細はこちらをご参照ください。

2-3. 「保存」を選択し、項目設定を保存してマスタデータのトップページに戻る

項目設定を終えたら「保存」を選択し、項目設定を保存してください。
項目設定が正しく保存されると、マスターデータのトップページに移動します。

3. 「今すぐ取込」

取込設定と項目設定が完了していると、マスターデータのトップページに設定の内容が反映されます。
「いますぐ取込」ボタンを選択し商品データをdfplus.ioへ取込んでください。

※商品データの取込は「スケジュール」を利用することで定期的に実施することもできます。

運用開始後の商品データ構成変更時の注意点

既存の商品データと構成の異なる商品データを取込むと「取込エラー」が発生します。

見出し行がある商品データを利用している場合

見出し行がある商品データをマスターデータとして利用している場合は、「マスターデータ構成の変更」から取込エラーを解消することが可能です。詳細はこちらをご参照ください。

見出し行がない商品データを利用している場合

見出し行がない商品データをマスターデータとして利用している場合は、できるだけ商品データの構成変更（列の削除・追加・順序の変更）をしないようにしてください。
取込済みの商品データと構成の異なる商品データを取込んだ場合、設定済みのデータフィードの全てのマッピングやルールの設定にもずれが生じてしまうため、全ての設定を見直す必要があります。

事故を防ぐため、見出し行がない商品データへの列の追加はファイルの右端に追加し、列の削除、列の順序変更しないようにしてください。

取込エラーの解消について

商品データの状況に応じて、作業内容が変わります。2の場合は、影響範囲が多岐に渡りますので、一度サポート窓口までご相談ください。

新規の列をファイルの右端に追加しており、既存の列の順序に変更がないことが確定している場合
- 取込設定から項目設定を更新することで、既存設定に影響なく解消できます。
既存列の間に新規列を追加した場合や、列数を減らした場合
- - 既存のデータフィードの再設定が必要です。
    影響範囲が多岐にわたるため、復旧手順でお困りの場合は、一度サポート窓口までご相談ください。
    - お問い合わせ先：https://support.dfplus.io/hc/ja/requests/new

サーバー取込とローカルファイルアップロードの切り替え

サーバー取込とローカルファイルアップロードは、切り替えが可能です。
手元の商品データでお試しした後、サーバー取込へ切り替えて本番の商品データを取込等の運用が可能です。

※既にサーバー取込、もしくローカルファイルアップロードで取込設定をしていた場合に、それぞれもう一方の取込方法へ切り替えし取込設定を保存すると、既存の取込設定は破棄されます。

マスターデータのダウンロード方法

取り込んだマスターデータを dfplus io からダウンロードができます。

今すぐ取込ボタン横のメニューを開いてダウンロードをクリックするとダウンロードが始まります。

関連
- マスターデータ・データフィードのファイルが文字化けした場合の対処方法

概要

目次