Show Menu
主题×

关于客户属性的数据文件和数据源

将客户属性上传到Experience Cloud的数据文件要求和多个数据源。
您需要从企业访问CRM或类似数据。 您上传到 Experience Cloud 的数据必须是 .csv 文件。如果您通过 FTP 或 sFTP 上传,则还需要上传一个 .fin 文件。
上传客户属性是为了每天处理一些文件。为了缓解延迟处理大量小文件的问题,在处理前一批文件后 30 分钟内由同一组织发送的文件将被路由到优先级较低的队列。

允许的文件类型和命名要求

文件类型 描述
.csv
以逗号分隔的值文件(如在Excel中创建的文件)。 这是包含客户属性数据的文件。
命名要求: 确保文件扩展名不包含空格。
.fin
(必需) .fin 文件会告知系统您已完成数据上传。 .fin 文件的名称必须匹配 .csv 文件的名称。
Adobe 建议创建一个具有 .fin 扩展名的空文本文件。空文件可节省空间和上传时间。
注意:不允许重新命名已上传的 .fin 文件。 .fin 文件必须单独上传,并且不得是之前已上传的重命名文件。
After you upload the .fin file in the Customer Attributes FTP, the system retrieves data quickly (within one minute). 其他基于 FTP 的 Adobe 系统则与之不同,它们提取数据并不那么频繁(大约每小时一次)。
在使用拖放上传方法时不需要 .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。
在使用拖放上传方法时不需要 .fin 文件。
客户ID列
第一列必须是唯一的客户ID。 使用的ID应与要传递到Experience Cloud ID服务的ID相对应。
对于Analytics,ID存储在prop或eVar中。
对于目标,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. 系统将别名发送到此数据存储(通过setCustomerID)。 CRM文件将应用于该数据存储中的数据。
有关 setCustomerIDs 的信息,请参阅 客户 ID 和身份验证状态
后续标题和列
后续的标题应代表每个属性的名称。
这些列应包含来自CRM的客户属性。
属性限制
您可以向 Experience Cloud 中的客户属性服务上传数百个 .csv 列。但是,在配置订阅和选择属性时,根据您拥有的解决方案,以下限制适用:
  • Analytics Standard : 3共
  • Analytics Premium : 每个报告包200个
  • Adobe目标标准: 5
  • Adobe目标Premium: 200
行限制
对行数没有已知限制。
列限制
为实用起见,将列数限制在200左右。
字符限制
创建Analytics订阅时,已上传文件的字段长度将截断为255。
FTP 指南和大小限制
  • FTP 的最大文件大小限制为每次上传 4 GB。
  • 最小文件大小限制为每次上传 10 MB。
  • 您可以每半小时上传一个文件。
  • 您应当将您的 .csv (和 .fin )文件放在 FTP 站点的根文件夹中。
重要提示:FTP 帐户允许的总空间量为 40 GB。您有责任删除已处理的文件。
文件要求
每个属性源应包含相同数量的逗号分隔字段。
包含换行符、多次引号或逗号的字段必须加引号。
字段中的多次引号字符必须使用反斜杠(\)进行转义。
空列存储为 null
多个文件
上传客户属性数据时,如果您要快速且连续上传多个文件,尤其是文件较大时,请确保在上一个文件处理完成之后再上传下一个文件。您可以通过检查先前文件何时被移动到客户属性FTP帐户中的已处理或失败文件夹来监视此情况。
如果将大文件分成较小的文件,并连续快速提交这些文件,实际上可能会减慢处理速度,除非您可以确保在提交下一个文件之前已完全处理每个文件。
字符编码
对于日本,UTF-8是必填的。
历史数据
客户属性与Analytics中的基础访客用户档案关联。 因此,在Analytics中,访客属性与该访客用户档案整个生命周期的相关联。 这包括客户首次登录之前发生的行为。
如果使用数据仓库回填方法,则数据将绑定到基于Analytics ID(AID)的post_visid_high/low。 如果您使用的是Experience Cloud ID服务,则数据将绑定到基于Experience Cloud ID(MID)的post_visid_high/low。
数据馈送
客户属性在数据馈送中不可用。

利用多个数据源

在创建、修改或删除客户属性源时,在ID开始与新数据源同步前约有一小时的延迟。
每个客户属性源的别名ID必须唯一。 如果您有多个利用同一ID的数据源,应按如下方式设置它们:
在VisitorAPI.js或动态标签管理中的Experience Cloud ID工具中:
设置两个客户 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创建两个客户属性源。 使用此方法可向多个客户属性源发送相同的引用ID。