关于Customer Attributes的数据文件和数据源

将Customer Attributes上传到Experience Cloud的数据文件要求和多个数据源。

您需要拥有从企业访问 CRM 或类似数据的权限。上载到Experience Cloud的数据必须是.csv文件。 如果您通过 FTP 或 sFTP 上传,则还需要上传一个 .fin 文件。

Customer Attributes设计为每天处理一些文件。 为了缓解延迟处理较多小文件的问题,在处理前一批文件后 30 分钟内由同一组织发送的文件将被路由到优先级较低的队列。

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

文件类型
描述
.csv

以逗号分隔的值文件(例如在 Excel 中创建的文件)。该文件包含客户属性数据。

命名要求: 请确保文件扩展名不包含空格。

.fin

(必需).fin 文件会告知系统您已完成数据上传。.fin 文件的名称必须匹配 .csv 文件的名称。

Adobe 建议创建一个具有 .fin 扩展名的空文本文件。空文件可节省空间和上传时间。

注意:不允许重新命名已上传的 .fin 文件。.fin 文件必须单独上传,并且不得是之前已上传的重命名文件。

在客户属性 FTP 中上传 .fin 文件后,系统会快速检索数据(在一分钟之内)。其他基于 FTP 的 Adobe 系统则与之不同,它们提取数据并不那么频繁(大约每小时一次)。

在使用拖放上传方法时不需要 .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。

在使用拖放上传方法时不需要 .fin 文件。

客户 ID 列

第一列必须是唯一的客户 ID。使用的 ID 应该与传递给 Experience Cloud ID 服务的 ID 相对应。

对于 Analytics,其为存储在 prop 或 eVar 中的 ID。

对于Target,其为setCustomerID值。

此客户 ID 是 CRM 在数据库中针对每个人使用的唯一标识符。其余列为来自 CRM 的属性。您选择要上传的属性数量。

建议对列标题使用友好、可读的名称,但不是必需的。当您在上传后验证架构时,可以将友好名称映射到上传的行和列。

关于客户 ID

企业通常使用 CRM 系统中的客户 ID。此 ID 是在人员登录时使用 setCustomerIDs 调用设置的。在上传到Experience Cloud的CRM文件中,还使用此ID作为密钥。 别名 ID 是 Audience Manager 中数据存储的友好名称,其中存储了别名数据。系统将别名发送到此数据存储(通过 setCustomerID)。CRM 文件将应用于该数据存储中的数据。

有关 setCustomerIDs 的信息,请参阅客户 ID 和身份验证状态

后续标题和列

后续标题应表示每个属性的名称。

这些列应包含来自 CRM 的客户属性。

属性限制

您可以以Experience Cloud将数百个 .csv 列上传到客户属性服务。 但是,在配置订阅并选择属性时,根据您拥有的应用程序,将会受到以下限制:

  • Analytics Standard:总共 3 个
  • Analytics Premium:每个报表包 200 个
  • Adobe Target Standard: 5 个
  • Adobe Target Premium: 200 个
行数限制
对行数的限制未知。
列数限制
为实用起见,请将列数限制在 200 左右。
字符限制
创建 Analytics 订阅时,已上传文件的字段长度将被截断为 255。
FTP 指南和大小限制
  • FTP 的最大文件大小限制为每次上传 4 GB。
  • 最小文件大小限制为每次上传 10 MB。
  • 您可以每半小时上传一个文件。
  • 您应当将您的 .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。

请注意,从2022年10月开始,Data Warehouse回填方法将不再可用。

数据馈送
客户属性在数据馈送中不可用。

使用多个数据源 section_76DEB6001C614F4DB8BCC3E5D05088CB

创建、修改或删除客户属性源时,大约会有一小时的延迟。在此之后,ID 才开始与新的数据源进行同步。

每个客户属性源的别名 ID 必须是唯一的。如果您有多个数据源使用同一 ID,可按照以下方式对其进行设置:

在 VisitorAPI.js 或 Dynamic Tag Management 的 Experience Cloud ID 工具中:

设置两个客户 ID,使其分别对应于适当的数据源:

Visitor.setCustomerIDs({
     "ds_id1":"123456",
     "ds_id2":"123456"
});

(请参阅客户 ID 和身份验证状态以了解更多信息。)

Experience Cloud > 人员 > 客户属性 ​中:

使用与上述客户 ID 对应的唯一别名 ID 创建两个客户属性来源。使用此方法可以将相同的引用 ID 发送到多个客户属性源。

recommendation-more-help
872fc4ed-f5f7-4b59-a6f8-4ddabe5aac1f