ファイルベースの宛先に対するファイル形式オプションの設定

IMPORTANT
このドキュメントで説明するファイル形式オプションは、現在 CSV ファイルでのみ使用できます。

書き出したファイルに対して様々なファイル形式オプションを設定するオプションは、ファイルベースの宛先(Amazon S3Azure Blob または SFTP など)に接続するときに使用できます。

Experience Platform UI を使用して、書き出したファイルに対して様々なファイル形式オプションを設定できます。 書き出されたファイルの複数のプロパティを変更して、側のファイル受信システムの要件に合わせて、Experience Platformから受信したファイルを最適に読み取って解釈できます。

CSV ファイルのファイル形式設定 file-configuration

ファイル形式オプションを表示するには、宛先への接続 ワークフローを開始します。 データタイプ:セグメント​および​ ファイルタイプ:CSV ​を選択して、書き出されたCSV ファイルで使用可能なファイル形式設定を表示します。

IMPORTANT
接続先には、これらのオプションの一部が使用できない場合があります。 宛先でサポートするファイル形式オプションは、宛先の開発者が決定します。 宛先の開発者は、宛先に接続する際に使用できるオプションを決定できます。 必須オプションは、Experience Platform UI でアスタリスクでマークされます。
Adobeで構築されたクラウドストレージの宛先 – Amazon S3Azure BlobAzure Data Lake Storage Gen2Data Landing ZoneGoogle Cloud StorageSFTP – 現在、以下に示す6つのCSV オプションのみをサポートしています。

使用可能なファイル形式オプションの一部を示す画像。

区切り delimiter

このコントロールを使用して、書き出されたCSV ファイルの各フィールドと値に区切り記号を設定します。 利用可能なオプションは次のとおりです。

  • コロン (:)
  • カンマ (,)
  • パイプ (|)
  • セミコロン (;)
  • タブ (\t)

delimiter-examples

書き出されたCSV ファイル内のコンテンツの以下の例と、UI内の各選択を表示します。

  • ​ コロン (:)が選択された出力の例:male:John:Doe
  • ​ カンマ (,)が選択された出力の例:male,John,Doe
  • ​ パイプ (|)が選択された出力例:male|John|Doe
  • ​ セミコロン (;)が選択された出力の例:male;John;Doe
  • ​ タブ (\t)が選択された出力の例:male \t John \t Doe

引用符文字 quote-character

このオプションを使用して、二重引用符を削除するか、書き出した文字列内に保持するかを制御します。

使用できる選択肢は次のとおりです。

  • Null文字(\0000) ​。 書き出したCSV ファイルから二重引用符を削除するには、このオプションを使用します。
  • 二重引用符(") ​。 文字列値に区切り記号または二重引用符が含まれている場合は、このオプションを使用します。 このオプションを使用すると、書き出したCSV ファイル内に区切り記号または二重引用符を保持できるため、どの値がどのフィールドに対応するかを正しく特定できます。

quote-character-examples

入力値Anna,"Doe,John"を考慮してください。

書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。

  • Null文字(\0000) ​を選択した出力の例:Anna,Doe,John
  • 二重引用符(") ​が選択された出力の例:Anna,"Doe,John"

エスケープ文字 escape-character

既に引用符で囲まれた値の中で引用符をエスケープする場合は、このオプションを使用します。 例えば、文字列の一部が既に二重引用符で囲まれている二重引用符で囲まれた文字列がある場合、このオプションは便利です。 このオプションは、内側の二重引用符を置き換える文字を決定します。 利用可能なオプションは次のとおりです。

  • バックスラッシュ (\)
  • 一重見積もり(')

escape-character-examples

書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。

  • 戻るスラッシュ (\)が選択された出力の例:"Test,\"John\",LastName"
  • 一重引用符(')が選択された出力の例:"Test,'"John'",LastName"

空の値出力 empty-value-output

このコントロールを使用して、空の値の文字列表現を設定します。 このオプションは、書き出されたCSV ファイルで空の値がどのように表示されるかを指定します。 利用可能なオプションは次のとおりです。

  • Null (null) ​
  • 二重引用符(")​の空文字列
  • 空の文字列

empty-value-examples

書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。

  • nullが選択された出力の例:male,NULL,TestLastName。 この場合、Experience Platformは空の値をnull値に変換します。
  • ""​が選択された出力例:male,"",TestLastName。 この場合、Experience Platformは、空の値を二重引用符のペアに変換します。
  • 空の文字列が選択された出力例:male,,TestLastName。 この場合、Experience Platformは空の値を保持し、そのまま(二重引用符なしで)書き出します。
TIP
以下のセクションの空の値出力とnull値出力の違いは、空の値が空の実際の値を持つということです。 NULL値にはまったく値がありません。 空の値はテーブル上の空のガラスと考え、null値はテーブル上にガラスがまったくないと考えてください。

Null 値出力 null-value-output

このコントロールを使用して、書き出されたファイル内の null 値の文字列表現を設定します。 このオプションは、書き出されたCSV ファイルでnull値がどのように表示されるかを決定します。 利用可能なオプションは次のとおりです。

  • Null (null) ​
  • 二重引用符(")​の空文字列
  • 空の文字列

null-value-examples

書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。

  • nullが選択された出力の例:male,NULL,TestLastName。 この場合、変換は行われず、CSV ファイルにはnull値が含まれます。
  • ""​が選択された出力例:male,"",TestLastName。 この場合、Experience Platformは、空の文字列の周囲に二重引用符で囲まれたnull値を置き換えます。
  • 空の文字列が選択された出力例:male,,TestLastName。 この場合、Experience Platformはnull値を空の文字列(二重引用符なし)に置き換えます。

圧縮形式 compression-format

データをファイルに保存する際に使用する圧縮タイプを設定します。 GZIP と NONE がサポートされています。 このオプションは、圧縮ファイルを書き出すかどうかを決定します。

エンコード encoding

UI のスクリーンショットには表示されません。 保存した CSV ファイルのエンコーディング(文字セット)を指定します。 オプションは UTF-8 または UTF-16 です。

引用符をエスケープする文字 char-to-escape-quote

UI のスクリーンショットには表示されません。 引用符を含む値を、常に引用符で囲む必要があるかどうかを示すフラグ。

デフォルトでは、引用符文字を含むすべての値をエスケープします。

行区切り記号 line-separator

UI のスクリーンショットには表示されません。 書き込みに使用する行区切り記号を定義します。 最大長は 1 文字です。

先頭の空白を無視 ignore-leading-whitespace

UI のスクリーンショットには表示されません。 書き出される値の先頭の空白をスキップするかどうかを示すフラグ。

Trueが選択された出力の例: "male","John","TestLastName"
Falseが選択された出力の例:" male","John","TestLastName"

末尾の空白を無視 ignore-trailing-whitespace

UI のスクリーンショットには表示されません。 書き出す値の末尾の空白をスキップするかどうかを示すフラグ。

Trueが選択された出力の例: "male","John","TestLastName"
Falseが選択された出力の例:"male ","John","TestLastName"

次の手順 next-steps

このドキュメントでは、CSV データファイルのファイル書き出しオプションを設定し、ダウンストリームのファイル受信システムの要件に合わせてファイルの内容を調整する方法を確認しました。 次に、ファイルベースの宛先のアクティベーションのチュートリアルを読んで、目的のクラウドストレージの場所へのファイルの書き出しを開始します。

recommendation-more-help
experience-platform-help-destinations