CSVファイルのインポート準備

インポートするデータの準備

以下のタイプのデータセットでファイルインポートデータソースを使用することをお勧めします：

• デモグラフィックデータ
• プロスペクトとリードデータ
• 過去の購入と返金
• オフラインでのやり取り（サポート、ダイレクトマーケティング、イベント出席など）

ファイルの効率的な処理を確保するために、大きなファイルを100,000行ごとの小さなファイルに分割することを強くお勧めします。大きなファイルサイズもサポートされていますが、50MBを超えるファイルサイズはエラーの可能性が高まるため、お勧めしません。

インポートされたデータを最大限に活用するために、CSVファイルの各行には、データを顧客に関連付ける一意の訪問IDの列があることを確認してください。詳細については、ファイルインポートデータソースを使用した訪問識別を参照してください。

ファイル命名規則

SFTPまたはS3を通じてアップロードされた複数のファイルは、ファイル名のアルファベット順に処理されます。

ファイル名のプレフィックス

CSVファイルは次の名前形式を使用する必要があります：{prefix}_{version}.csv。この形式は次の部分で構成されています：

CSVファイルのバージョンを区別するためにバージョン番号の使用を強くお勧めします。

使用するファイル名のプレフィックスは一意でなければなりません。例えば、プレフィックスstore-transactionsとstore-transactions-returnsを使用すると、同じ初期プレフィックスstore-transactionsを共有するため、予期しない結果が発生します。

ファイル名の制限

ファイル名は以下のルールに従う必要があります：

• ファイル名には次の文字のみを含めることができます：文字（a-zまたはA-Z）、数字（0-9）、ハイフン（-）、アンダースコア（_）、ピリオド（.）。
• ファイル名は大文字と小文字を区別します。例えば、store-transactions_20230319-a.csvとStore-Transactions_20230319-a.csvは異なるファイルなので、混乱を避けるために小文字のファイル名を使用することをお勧めします。

ファイル名の例

複数のファイル

次の例は、2023年3月19日の店内購入で、aとbの2つのファイルに分けられています。

複数のバージョン

次の例は、2023年3月14日と2023年3月15日の店内返品の2つのファイルです。

ファイルデータ形式

ファイルの構成

ファイルを次のガイドラインに従って整理することをお勧めします：

• ファイルエンコーディング
  UTF-8 (BOMエンコーディングなし)を推奨します。
• 列名
  • CSVファイルの最初の行にはファイルの列名を含める必要があります。その後の各行はイベントまたは訪問レコードを表し、少なくとも1つの訪問識別属性を含む必要があります。
  • 列名にはハッシュ（#）、キャレット（^）、または空白文字を含めることはできません。
  • 列名は大文字と小文字を区別し、属性名と完全に一致する必要があります。
• 列の値
  列の値は1,000文字を超えてはなりません。この制限を超える文字は切り捨てられます。
• 列の順序
  列の順序は問題ではありませんが、訪問ID列を最初に配置することをお勧めします。
• 余分な/欠落している列
  AudienceStream属性として構成されていない余分な列は無視されます。CSVファイルに存在しないマップされた列はスキップされます。
• 訪問IDで行をグループ化
  各行には訪問ID列があり、ファイルには同じ訪問のための複数の行が含まれる場合があります。同じ訪問IDを含む行は、インポートプロセスを最適化するためにまとめるべきです。

データタイプの形式

以下のデータタイプを適切にフォーマットすることをお勧めします：

• カンマを含む値をダブルクォートで囲む
  値にカンマ（,）が含まれている場合、CSV列の整合性を保証するためにダブルクォートで囲む必要があります。すべての値をダブルクォートで囲むことをお勧めします。データ内のダブルクォート文字を示すためには、ダブルクォートを二重に（""）使用します。
• 文字列の配列形式
  ファイル属性が文字列の配列にマップされるようにするための次の例の形式を使用します：

  "[""one"",""two"",""three""]"
  

• 数値の配列形式
  ファイル属性が数値の配列にマップされるようにするための次の例の形式を使用します：

  "[1.99,20.99]"
  

• ブール値の配列形式
  ファイル属性がブール値の配列にマップされるようにするための次の例の形式を使用します：

  "[0, 1]","[0, 1]"
  

• 日付の正規化
  • あるフィールドに対するファイル全体の日付値は一貫していなければなりません。
  • 各日付値はその列に指定された形式と一致しなければなりません。例えば、期待される形式がyyyy-MM-ddである場合、値は4桁の年と2桁の月と日の値を含む必要があります。例：2021-02-09。
  • 次の日付コンポーネントがサポートされています：年、月、日、時間、分、秒、ミリ秒、AM/PM、ISO、RFC、紀元。サポートされている日付コンポーネントの詳細については、Java SimpleDateFormat Patternsを参照してください。
  • 日付はミリ秒単位のエポックタイムスタンプとしてTealiumに保存されます。
• 空の値の正規化
  一部の行にはすべての列に値が含まれていない場合があります。これらの列が空であり、“null”、“empty”、“blank"などのプレースホルダー値を含まないことを確認してください。
• 通貨額から特殊文字を省略
  “OrderTotal"や"ProductPrice"のような通貨額を表す列には、記号やカンマを含めてはなりません。