Show Menu
トピック×

顧客属性のデータファイルおよびデータソースについて

顧客属性を Experience Cloud にアップロードするためのデータファイル要件および複数のデータソースに関する情報です。
CRMまたは企業の類似データにアクセスする必要があります。 Experience Cloud にアップロードするデータは .csv ファイルでなければなりません。FTP や sFTP を利用してアップロードする場合は、 .fin ファイルもアップロードします。
顧客属性は、1 日に数ファイルを処理するように設計されています。小さなファイルを多数処理することで発生する問題を軽減するために、同じ組織から 30 分以内に送信されたファイルは、優先順位の低いキューにルーティングされます。

許可されるファイルタイプと命名規則

ファイルタイプ 説明
.csv
コンマ区切り値ファイル(Excelで作成したファイルなど)。 これは、顧客属性データを含むファイルです。
命名規則: ファイル名の拡張子に空白が含まれていないことを確認します。
.fin
(必須) .fin ファイルは、データのアップロードの終了をシステムに知らせます。 .fin ファイルの名前は .csv ファイルの名前と一致する必要があります。
アドビは、 .fin 拡張子を持つ空のテキストファイルを作成することを推奨します。空のファイルを使用して容量やアップロード時間を節約できます。
注意: .fin ファイルのアップロード後にファイル名を変更することはできません。 .fin ファイルは別個にアップロードする必要があり、既にアップロード済みのファイルの名前を変更しても、.fin ファイルとしては認識されません。
.fin ファイルを顧客属性 FTP でアップロードすると、データはすばやく取得されます(1 分以内)。これは、あまり頻繁にデータを取得しない(1 時間に 1 回程度)他のアドビ FTP ベースのシステムとは異なる点です。
Web の UI でドラッグ&ドロップしてアップロードする場合、 .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 ファイルは不要です。
顧客ID列
最初の列は一意の顧客IDである必要があります。 使用するIDは、Experience Cloud IDサービスに渡されるIDに対応している必要があります。
Analyticsの場合、propまたはeVarに保存されるID。
ターゲットの場合、setCustomerID値。 (See Analytics & Adobe Target - synching the customer ID )
この顧客IDは、CRMがデータベース内の各ユーザーに対して使用する一意の識別子です。 残りの列は、CRMから取得された属性です。 アップロードする属性の数を選択します。
列見出しにはわかりやすく読みやすい名前を付けることをお勧めしますが、必須ではありません。 アップロード後におこなうスキーマの検証の際に、アップロードされた行と列にわかりやすい名前をマッピングできます。
顧客IDについて
通常、企業はCRMシステムの顧客IDを使用します。 この ID は、ユーザーのログイン時に setCustomerIDs 呼び出しを使用して設定されます。このIDは、Experience CloudにアップロードされるCRMファイルのキーとしても使用されます。 An Alias ID is a friendly name for a data store in Audience Manager, where the alias data is stored. システムは、エイリアスを(setCustomerIDsを介して)このデータストアに送信します。 CRMファイルは、そのデータストア内のデータに適用されます。
setCustomerIDs 情報については、 顧客 ID と認証の状態 を参照してください。
後続のヘッダーと列
後続のヘッダーは、各属性の名前を表す必要があります。
これらの列には、CRMの顧客属性が含まれている必要があります。
属性の制限
数百の .csv 列を Experience Cloud の顧客属性サービスにアップロードできます。ただし、購読を設定して属性を選択する場合は、所有するソリューションに応じて次の制限が適用されます。
  • Analytics Standard: 合計 3 件
  • Analytics Premium: レポートスイートあたり 200 件
  • Adobeターゲット標準: 5
  • Adobeターゲットプレミアム: 200
行の制限
行数に対する既知の制限はありません。
列の制限
実際的には、列数を200前後に制限します。
文字制限
Analytics購読を作成すると、アップロードされたファイルのフィールドの長さが255文字に切り捨てられます。
FTPのガイドラインとサイズの制限
  • FTP のファイルサイズの上限は、各アップロードで 4 GB です。
  • ファイルサイズの下限は、各アップロードで 10 MB です。
  • 30 分ごとに 1 つのファイルをアップロードできます。
  • .csv (および .fin )ファイルを FTP サイトのルートフォルダーにアップロードする必要があります。
重要:FTP アカウントの合計許容量は 40 GB です。処理済みのファイルを削除するのは、お客様の責任です。
ファイル要件
各属性ソースには、コンマで区切られた同じ数のフィールドを含める必要があります。
改行、重複引用符またはコンマを含むフィールドは引用符で囲む必要があります。
フィールド内の重複引用符文字は、バックスラッシュ(\)を使用してエスケープする必要があります。
空白の列は Null として保存されます。
複数のファイル
顧客属性データをアップロードする際、連続してアップロードする複数のファイルがある場合(特にファイルが大きい場合)は、前のファイルが処理されていることを確認してから次のファイルをアップロードするようにしてください。これを監視するには、前のファイルが顧客属性 FTP アカウント内の処理済みフォルダーまたは失敗フォルダーに移動したタイミングを確認します。
大きなファイルを小さなファイルに分割し、それらを短時間で連続して送信すると、次のファイルを送信する前に各ファイルが完全に処理されない限り、処理速度が低下する可能性があります。
文字エンコーディング
日本の場合、UTF-8は必須です。
履歴データ
顧客属性は、Analyticsの基になる訪問者プロファイルに結び付けられます。 したがって、顧客属性は、Analyticsでのその訪問者プロファイルの全期間にわたって訪問者に関連付けられます。 これには、顧客が初めてログインする前に発生した動作も含まれます。
Data Warehouseのバックフィル方式を使用する場合、データはAnalytics ID(AID)に基づくpost_visid_high/lowに結び付けられます。 Experience Cloud IDサービスを使用している場合、データはExperience Cloud ID(MID)に基づくpost_visid_high/lowに結び付けられます。
データフィード
顧客属性は、データフィードでは使用できません。

複数のデータソースの活用

顧客属性ソースを作成、変更または削除すると、IDが新しいデータソースと同期され始める前に約1時間遅延が発生します。
各顧客属性ソースのエイリアスIDは一意である必要があります。 同じIDを利用する複数のデータソースがある場合は、次のように設定する必要があります。
Dynamic Tag ManagementのVisitorAPI.jsまたはExperience Cloud IDツール:
適切なデータソースに対応する 2 つの顧客 ID を設定します。
Visitor.setCustomerIDs({ 
     "ds_id1”:"123456", 
     "ds_id2":"123456" 
});

(See Customer IDs and Authentication States for more information.)
In the Experience Cloud > People > Customer Attributes :
上記の顧客IDに対応する一意のエイリアスIDを使用して、2つの顧客属性ソースを作成します。 この方法を使用すると、同じ参照IDを複数の顧客属性ソースに送信できます。