Customer Attributes のデータファイルとデータソースについて
顧客属性データをExperience Cloudにアップロードするためのデータファイル要件および複数のデータソース。
企業内の CRM データや同様のデータにアクセスする必要があります。Experience Cloudにアップロードするデータは、.csv ファイルにする必要があります。 FTP や sFTP を利用してアップロードする場合は、.fin ファイルもアップロードします。
Customer Attributes は、1 日に数個のファイルを処理するように設計されています。 小さなファイルを多数処理することで発生する処理の遅延を軽減するために、同じ組織から以前のバッチ後 30 分以内に送信されたファイルは、優先順位の低いキューにルーティングされます。
許可されるファイルタイプと命名規則 section_6F64FA02ACCC4215B0862CB6A1821FBF
.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 と一致する必要があります。属性データファイルの要件 section_169FBF5B7BBA47CE825B7A330CF3FE98
CSV の例
CSV ファイルは次の形式に準拠する必要があります。
テキストエディターで閲覧された同じファイル：
ガイドライン
ドラッグ＆ドロップファイルは 100 MB 未満にしてください。
Web の UI でドラッグ＆ドロップしてアップロードする場合、.fin ファイルは不要です。
1 列目は一意の顧客 ID でなければなりません。使用する ID は、Experience Cloud ID サービスに渡される ID に対応している必要があります。
Analytics の場合は、prop または eVar に格納されている ID です。
Target の場合、setcustomerID 値。
この顧客 ID は、データベース内の各ユーザーを表すために CRM で使用する一意の ID です。残りの列は CRM から取得される属性です。アップロードする属性の数を選択します。
列の見出しには読みやすく、わかりやすい名前を使用することが推奨されますが、必須ではありません。アップロード後におこなうスキーマの検証の際に、アップロードされた行と列にわかりやすい名前をマッピングできます。
顧客 ID について
通常、企業は、CRM システムからの顧客 ID を使用します。この ID は、ユーザーがログインしたときに setcustomerIDs 呼び出しを使用して設定されます。 この ID は、Experience Cloudにアップロードされる CRM ファイルでもキーとして使用されます。 エイリアス ID は、エイリアスデータが格納される Audience Manager のデータストアの識別子です。システムはこのデータストアに（setcustomerIDs を介して）エイリアスを送信します。 CRM ファイルは、このデータストアのデータに適用されます。
setcustomerID 詳細 ついては、顧客 ID 認証状態のを参照してください。
2 列目以降の見出しは、各属性の名前を表す必要があります。
これらの列は、CRM から取得される顧客属性を含んでいる必要があります。
数百の.csv 列 Experience Cloudの顧客属性サービスにアップロードできます。 ただし、サブスクリプションを設定して属性を選択する場合、所有するアプリケーションに応じて、次の制限が適用されます。
- 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 に関連付けられます。Experience Cloud ID サービスを使用している場合、データは Experience Cloud ID（MID）に基づく post_visid_high/low に結び付けられます。
なお、Data Warehouseのバックフィルは、2022 年 10 月以降、使用できなくなります。
複数のデータソースの使用 multiple
顧客属性ソースを作成、変更または削除する場合、ID が新しいデータソースと同期され始めるまで、約 1 時間の遅延があります。
各顧客属性ソースのエイリアス ID は、一意である必要があります。同じ ID を活用する複数のデータソースがある場合、次のように設定します。
VisitorAPI.js または Dynamic Tag Management の Experience Cloud ID ツール：
適切なデータソースに対応する 2 つの顧客 ID を設定します。
Visitor.setcustomerIDs({
"ds_id1":"123456",
"ds_id2":"123456"
});
（詳しくは、 顧客 ID と認証状態を参照してください。）
Experience Cloud > Customer Attributes で以下を実行します。
上記の顧客 ID に対応する一意のエイリアス ID を使用して、2 つの顧客属性ソースを作成します。この手法を使用すると、同じ参照 ID を複数の顧客属性ソースに送信できます。