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

将客户属性上传到 Experience Cloud 的数据文件要求和多个数据源。

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

上传客户属性是为了每天处理一些文件。为了缓解延迟处理大量小文件的问题,在处理前一批文件后 30 分钟内由同一组织发送的文件将被路由到优先级较低的队列。

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

文件类型 描述

.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 文件。

属性数据文件的要求

CSV 示例

CSV 文件必须遵循以下格式:

在文本编辑器中查看的同一文件:

准则

项目 描述

拖放

拖放文件应小于 100 MB。

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

客户 ID 列

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

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

对于 Target,其为 setCustomerID 值。(请参阅 Analytics 和 Adobe Target - 同步客户 ID

此客户 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。

数据馈送

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

利用多个数据源

创建、修改或删除客户属性来源时,大约会有一小时的延迟。在此之后,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 发送到多个客户属性来源。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now