CDIファイル形式ガイドライン

これらのガイドラインは、顧客データ・インポート(CDI)ファイルをOracle Maxymiser UIにアップロードできる正しい形式にするために用意されています。ファイル形式を担当し、ファイルをアップロードできるようにする場合は、次のガイドラインを十分に理解してください。また、インポートに必要な形式のガイダンスを提供するサンプル・デモ用のCDIファイルも用意されています。

列エントリとファイル形式

CDIファイルには、次の列を含めてください。

Visitor ID: インポート・ファイルはヘッダー行で始まる必要があり、最初の列にはWebサイトから収集したものと一致する訪問者IDが含まれている必要があります。Webサイト上に存在するこれらの一意の訪問者IDは、Oracle Maxymiser UIの対応する「External Visitor ID」フィールドにマップされます。CDIウィザードの「Field Paring」ステップを使用して、対応する訪問者IDを選択できます。外部CDIファイルで使用される「Visitor ID」フィールドの最大長は50文字です。CDIファイルの訪問者ID値には、XML形式仕様に従って、無効な記号を含めることはできません。詳細は、http://www.w3.org/TR/xml/#charsetsを参照してください。
ノート: Webサイト上のユーザー外部訪問者IDを使用してCDIファイルからデータを取得するため、このIDをすでに収集していることを確認してください。
Column Entries: 「Visitor ID」列に加え、CDIファイルの最大20個の列を事前定義済の自由形式テキストのカスタム属性とペアにし、さらに最大20個の列をOracle Maxymiser UIのプリセットのカスタム属性とペアにすることができます。

次の点を考慮してください。

列ヘッダーには、文字と数字(aからz、AからZ、0から9)のみを含めます。大文字、小文字、スペースおよびアンダースコアを使用できます。先頭と末尾にはスペースと引用符を使用できません。
CDIファイルのデータを変更する場合は、ファイル内の列の数と名前が属性マッピングに含まれる列と完全に一致するようにしてください。また、インポートに使用されるすべてのカスタム属性をインポート前に公開しておく必要があります。
列データ行には、次の文字を含めることができます。AからZ、aからz、0から9、アンダースコア、さらにXML標準で有効とみなされる文字(XML形式の説明を参照)です。つまり、特殊文字(@、=、/、*)を含むUTF-8範囲の大部分です。列の最大サイズは、「VisitorID」列(ファイルの最初の列)では50文字、自由形式テキストのカスタム属性にマップされている列では50文字、プリセットのカスタム属性にマップされている列では15文字です。
値内の二重引用符は、前にもう1つ二重引用符を付けることによってエスケープする必要があります。次に例を示します。

"Special rate ""1.99"""
複数の属性値はファイル・インポートではサポートされていませんが、顧客データAPIで設定できます。
ファイル内で列データ行を意図的に空白のままにする場合は、検証エラーにならないように、そのデータ行をセパレータで囲む必要があります。

CDIファイル形式

サポートされているファイル・タイプは、テキスト(TXT)、カンマ区切り値(CSV)およびタブ区切り値(TSV)です。

CDIファイルの場所および転送

CDIファイルをホストしているサーバーは少なくとも2MB/秒の転送速度に対応できる必要があり、そうでない場合は転送が中止されることがあります。
Oracle Maxymiserでは、ファイル転送用にHTTPSプロトコルとSFTPプロトコルがサポートされています。

動的ファイル名を使用したCDIファイルの日付バージョニング

CDIスケジュール・インポート機能の使用を予定している場合は、動的ファイル名を使用することもできます。ファイル名に次のワイルドカードを使用して、正しいCDIデータ・セットがアップロードされるようにします。ファイル名の末尾に次の文字列を使用して、インポートの日付に解決します。

$(YYYYMMDD) (YYYYは年、MMは月、DDは日付)。たとえば、>http://www.mysite.com/Customer_Profile_WEEKLY_$(YYYYMMDD).txtです。

すべてのCDIスケジュールにUTCタイム・ゾーンが使用されるため、動的ファイル名を使用する場合は、この係数が必要になります。たとえば、毎週月曜日の午前1時(UTC)にインポートするようにスケジュールを設定する場合は、ローカル・タイム・ゾーンではなく、このUTC時間の前に、サーバーでファイルが生成されるようにする必要があります。

提供するファイルがこれと同じ構文を使用していることを確認してください。日付の書式は、YYYYMMDDにする必要があります。たとえば、Customer_Profile_WEEKLY_20170701.txtやCustomer_Profile_WEEKLY_20170801.txtです。このワイルドカードを使用した場合、スケジュール・インポートの時点で最新の日付スタンプを持つファイルがアップロードされます。

サンプルのCDIファイル

サンプルのCDIファイルをダウンロードするには、CRM_Demo_File.zipをクリックします。抽出されるサンプルはCSVファイルです。ファイルはカンマ、タブまたはパイプで区切られている必要があります。次のヘッダーが含まれています。