顧客属性データファイルとソース
顧客属性データをCX Enterpriseにアップロードするためのデータファイル要件と複数のデータソース。
企業内の CRM データや同様のデータにアクセスする必要があります。 CX Enterpriseにアップロードするデータは、.csv ファイルである必要があります。 FTP や sFTP を利用してアップロードする場合は、.fin ファイルもアップロードします。
Customer Attributesは、1日に数個のファイルを処理するように設計されています。 小さなファイルを多数処理することで発生する処理の遅延を軽減するために、同じ組織から以前のバッチ後 30 分以内に送信されたファイルは、優先順位の低いキューにルーティングされます。
許可されるファイルタイプと命名規則
.csv.fin.fin ファイルは、データのアップロードが完了したことをシステムに通知します。 .fin ファイルの名前は、.csv ファイルの名前と一致する必要があります。 Adobeでは、.fin拡張子を持つ空のテキストファイルを作成することをお勧めします。 空のファイルは、スペースとアップロード時間を節約します。 注： .fin ファイルの名前を変更することは、アップロード後に許可されません。 .fin ファイルは個別にアップロードする必要があり、以前にアップロードしたファイルの名前を変更することはできません。 顧客属性FTPに.fin ファイルをアップロードすると、システムはデータを迅速に（1分以内に）取得します。 これは、データの取得頻度が低い（1時間に1回程度）他のAdobe FTP ベースのシステムとは異なります。 ドラッグ&ドロップ アップロード方式を使用する場合、.fin ファイルは必要ありません。.gz または .zip.gz （gzip）または.zip – 圧縮ファイル用。 .zip ファイルに複数のファイルを含めることはできません。 命名要件：.zipまたは.gzの名前は、.csv ファイルの名前と一致する必要があります。 例えば、.csv ファイルがcrm_small.csvの場合、.zip ファイルはcrm_small.csv.zipになります。 .fin ファイルは.csvと一致する必要があります。属性データファイルの要件
CSV の例
CSV ファイルは次の形式に準拠する必要があります。
テキストエディターで閲覧された同じファイル：
ガイドライン
ドラッグ＆ドロップファイルは 100 MB 未満にしてください。
Web の UI でドラッグ＆ドロップしてアップロードする場合、.fin ファイルは不要です。
1 列目は一意の顧客 ID でなければなりません。 使用するIDは、CX Enterprise ID サービスに渡されるIDに対応する必要があります。
Analytics の場合は、prop または eVar に格納されている ID です。
Targetの場合は、setcustomerID値。
この顧客 ID は、データベース内の各ユーザーを表すために CRM で使用する一意の ID です。 残りの列は CRM から取得される属性です。 アップロードする属性の数を選択します。
列の見出しには読みやすく、わかりやすい名前を使用することが推奨されますが、必須ではありません。 アップロード後におこなうスキーマの検証の際に、アップロードされた行と列にわかりやすい名前をマッピングできます。
顧客IDについて
通常、企業は、CRM システムからの顧客 ID を使用します。 このIDは、ユーザーがログインしたときに setcustomerID 呼び出しを使用して設定されます。 このIDは、CX EnterpriseにアップロードされるCRM ファイルのキーとしても使用されます。 エイリアス ID は、エイリアスデータが格納される Audience Manager のデータストアの識別子です。 システムは、このデータストアに（setcustomerIDを介して）エイリアスを送信します。 CRM ファイルは、このデータストアのデータに適用されます。
個のsetcustomerID について詳しくは、個の顧客IDと認証状態を参照してください。
2 列目以降のヘッダーは、各属性の名前を表す必要があります。
これらの列は、CRM から取得される顧客属性を含んでいる必要があります。
数百の .csv 列をCX Enterpriseの顧客属性サービスにアップロードできます。 ただし、サブスクリプションを設定して属性を選択する場合、所有するアプリケーションに応じて、次の制限が適用されます。
- Analytics Standard：合計 3 件
- Analytics Premium：レポートスイートあたり 200 件
- Adobe Target Standard：5 件
- Adobe Target Premium：200 件
- FTP のファイルサイズの上限は、各アップロードで 4 GB です。
- ファイルサイズの下限は、各アップロードで 10 MB です。
- 30 分ごとに 1 つのファイルをアップロードできます。
- .csv（および .fin）ファイルを FTP サイトのルートフォルダーにアップロードする必要があります。
重要：FTP アカウントの合計許容量は 40 GB です。 処理されたデータを削除するのは、ユーザーの責任です。
各属性ソースには、コンマで区切った同数のフィールドが含まれる必要があります。
改行、二重引用符またはコンマを含むフィールドは引用符で囲む必要があります。
フィールド内の二重引用符文字は、バックスラッシュ（\）を使用してエスケープする必要があります。
空白の列は null として保存されます。
顧客属性データをアップロードする際、連続してアップロードする複数のファイルがある場合（特にファイルが大きい場合）は、前のファイルが処理されていることを確認してから次のファイルをアップロードするようにしてください。 これは、前のファイルがCustomer Attributes FTP アカウント内の処理済みまたは失敗したフォルダーに移動されたタイミングを確認することで監視できます。
大きなファイルを小さなファイルに分割し、それらを短時間で連続して送信すると、次のファイルを送信する前に各ファイルが処理されない限り、処理速度が低下する可能性があります。
顧客属性は、Analyticsの基になる訪問者プロファイルに関連付けられます。 このように、Customer AttributesはAnalyticsの訪問者プロファイルの全期間にわたって訪問者に関連付けられます。 このプロファイルには、顧客が最初にログインする前の行動が含まれます。
Data Warehouse のバックフィル手法を使用している場合、データは Analytics ID（AID）に基づく post_visid_high/low に関連付けられます。 CX Enterprise ID サービスを使用している場合、データはCX Enterprise ID （MID）に基づくpost_visid_high/lowに関連付けられます。
Data Warehouseのバックフィル方式は、2022年10月からは使用できなくなります。
複数のデータソースの使用
顧客属性ソースを作成、変更または削除する場合、ID が新しいデータソースと同期され始めるまで、約 1 時間の遅延があります。
各顧客属性ソースのエイリアス ID は、一意である必要があります。 同じ ID を活用する複数のデータソースがある場合、次のように設定します。
VisitorAPI.jsまたはDynamic Tag ManagementのCX Enterprise ID ツールで：
適切なデータソースに対応する 2 つの顧客 ID を設定します。
Visitor.setcustomerIDs({
"ds_id1":"123456",
"ds_id2":"123456"
});
（詳しくは、顧客IDと認証状態を参照してください）。
CX Enterprise > Customer Attributesで：
上記の顧客 ID に対応する一意のエイリアス ID を使用して、2 つの顧客属性ソースを作成します。 この手法を使用すると、同じ参照 ID を複数の顧客属性ソースに送信できます。