在此页面上:了解如何使用“更新配置文件”操作活动,以随着客户在历程中的进展扩充或更正现有Adobe Experience Platform配置文件。
使用 更新配置文件 操作活动,在客户完成历程时扩充或更正现有Adobe Experience Platform配置文件。 您可以设置源自历程事件、已配置数据源或静态值的字段值,以使用户档案数据保持准确和可操作,而无需离开历程画布。 在配置此活动之前,请查看适用的护栏和限制。
数据集选择 dataset-selection
更新配置文件活动需要专用数据集来存储更新。 由于此活动仅更新配置文件存储 (而不是Datalake),因此所有更新都应保存在专门为 更新配置文件 操作指定的启用配置文件的数据集中。
此外,更新配置文件活动配置不需要标识命名空间。 因此,请确保所选数据集使用启动历程的操作所使用的相同身份命名空间,因为它是这些更新将使用的命名空间。 所选数据集也可以使用身份映射。 选择具有正确标识命名空间或使用标识映射的数据集失败,将导致 更新配置文件 活动失败。
配置更新用户档案活动 use-profile-update
请按照以下步骤在历程中配置 更新配置文件 活动。
-
开始设计您的历程。 在创建您的第一个历程中了解详情。
-
在调色板的 操作 部分中,将 更新配置文件 活动拖放到画布中。
在历程调色板中
下的用户档案活动
-
从列表中选择架构。
note NOTE 只有已存在于所选XDM配置文件架构中的字段才可供选择。 如果您需要的字段未列出,请首先将其添加到Adobe Experience Platform中的架构。 -
单击 字段 以选择要更新的字段。
-
从列表中选择数据集。
note NOTE 更新配置文件操作可实时更新配置文件数据,但不会更新数据集。 需要选择数据集,因为用户档案是与数据集相关的记录。 -
单击 值 字段以定义要使用的值:
-
使用简单表达式编辑器,您可以从数据源或传入事件中选择字段。
配置文件属性更新的
-
如果要定义特定值或利用高级函数,请选择高级模式。
用于复杂配置文件更新的高级模式表达式编辑器
-
-
若要在同一操作中更新其他配置文件属性,请单击“更新其他字段”并重复字段和值的选择。 在一个 更新配置文件 操作中,您最多可以添加5个字段/值对。 查看护栏和限制。
更新配置文件活动现已配置完成。
测试用户档案更新 using-the-test-mode
请注意,在测试模式中,配置文件更新会立即在测试配置文件上生效,并且不会模拟。
只有测试轮廓才能进入处于测试模式的历程。 您可以创建新的测试用户档案,也可以将现有用户档案转换为测试用户档案。 在Adobe Experience Platform中,可通过CSV文件导入或API调用更新配置文件属性。 更快速的替代方法是在历程本身中使用 更新配置文件 活动,将测试配置文件布尔字段设置为true。
有关如何将现有配置文件转换为测试配置文件的更多信息,请参阅此部分。
护栏和限制 guardrails
- 更新配置文件操作只能在具有命名空间的历程中使用。
- 该操作仅更新现有字段 — 它不会创建新的配置文件字段。
- 该操作仅支持简单字段类型(字符串、数字、布尔值)。 不支持定义为枚举、建议值、对象数组或复杂集合(例如产品列表)的XDM字段。
- 无法使用 更新配置文件 操作生成体验事件,例如购买。
- 与任何其他操作一样,您可以在错误或超时🔗的情况下定义替代路径。 两个操作不能并行放置。
- 不能保证用户档案更新在同一历程的下游立即可用。 避免在写入字段的 更新配置文件 操作之后放置直接读取字段的操作,因为更新的值可能尚未反映出来。
- 更新配置文件活动仅更新配置文件存储,不更新数据湖。
- 在单个 更新配置文件 操作中最多可以更新五个字段/值对。 使用 更新其他字段 按钮添加更多对。
- 为了获得更好的性能,请将多个属性更新分组为单个 更新配置文件 操作,而不是为每个属性使用一个操作。
本节包含结构化知识,用于支持与本主题相关的解释、检索和问答。
要全面了解相关信息,应将此信息与本页上的文档相结合。 这两个源都不是独立的;页面描述了功能,而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。
- TL;DR:本页介绍如何配置更新配置文件活动,以在客户历程过程中使用历程事件、数据源或静态值的数据扩充或更正现有Adobe Experience Platform配置文件。
意图:
- 配置更新用户档案活动,以在历程中修改现有用户档案属性
- 选择专用于更新配置文件操作的启用配置文件的数据集
- 将历程事件、数据源或静态值中的字段值映射到配置文件属性
- 在单个活动中更新多个用户档案属性(最多五个)
- 在历程测试模式下测试配置文件更新
术语表:
- 更新配置文件活动:在配置文件通过历程 (产品特定) 时实时将新值写入Adobe Experience Platform配置文件中现有字段的操作活动
- 配置文件存储:包含实时客户配置文件数据的Adobe Experience Platform存储,不同于数据湖(产品特定)
- 身份命名空间:用于区分用于匹配正在更新的配置文件的身份上下文(如电子邮件、CRM ID)的标签(产品特定)
- 启用配置文件的数据集:一个Adobe Experience Platform数据集,配置为将记录贡献给统一配置文件(产品特定)
护栏:
- 更新配置文件操作只能在定义了命名空间的历程中使用。
- 该操作仅更新现有XDM字段;它无法创建新配置文件字段。
- 仅支持简单字段类型(字符串、数字、布尔值);不支持枚举、对象数组和复杂集合。
- 该操作无法生成体验事件,例如购买。
- 在单个“更新配置文件”操作中,最多可以更新五个字段/值对。
- 请勿与批处理或流式摄取流程共享专用数据集,因为其他摄取运行将覆盖更新配置文件更改。
- 配置文件更新可能无法在同一历程执行中的下游立即可用。
- 活动仅更新配置文件存储,而不更新数据湖。
术语:
- 规范名称:更新配置文件 — 缩写:无 — 变体:更新配置文件活动,更新配置文件活动
- 同义词: “Profile Store” = “Real-Time Customer Profile store”
- 请勿混淆:“配置文件存储”(由此活动更新)≠“数据湖”(此活动未更新)
常见问题解答:
- 问:更新用户档案活动能否创建新的用户档案字段? — 否,它只能更新选定XDM配置文件架构中已存在的字段。
- 问:为何应使用专用数据集执行更新配置文件操作? — 使用批处理或流式摄取共享数据集可能会导致其他摄取运行覆盖更新配置文件活动所做的更改。
- 问:同一历程中的下游活动是否可以立即看到配置文件更新? — 否,如果某个操作在更新用户档案活动写入字段后立即读取同一字段,则可能尚未反映更新的值。
- 问:在单个“更新配置文件”操作中可以更新多少字段? — 使用“更新其他字段”按钮可在单个活动中配置最多五个字段/值对。
- 问:配置文件更新是否适用于测试模式? — 是,在测试模式下,更新会在测试用户档案上立即生效,并且不会模拟。