在此页面上：了解如何使用“更新配置文件”操作活动，以随着客户在历程中的进展扩充或更正现有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字段。
- 无法使用 更新配置文件 操作生成体验事件，例如购买。
- 与任何其他操作一样，您可以在错误或超时🔗的情况下定义替代路径。 两个操作不能并行放置。
- 不能保证用户档案更新在同一历程的下游立即可用。 避免在写入字段的 更新配置文件 操作之后放置直接读取字段的操作，因为更新的值可能尚未反映出来。
- 更新配置文件活动仅更新配置文件存储，不更新数据湖。
- 在单个 更新配置文件 操作中最多可以更新五个字段/值对。 使用 更新其他字段 按钮添加更多对。
- 为了获得更好的性能，请将多个属性更新分组为单个 更新配置文件 操作，而不是为每个属性使用一个操作。
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure the Update Profile activity to enrich or correct an existing Adobe Experience Platform profile with data from journey events, datasources, or static values as a customer progresses through a journey.
Intents:
- Configure the Update Profile activity to modify existing profile attributes during a journey
- Select a profile-enabled dataset dedicated to Update Profile actions
- Map field values from journey events, datasources, or static values to profile attributes
- Update multiple profile attributes (up to five) in a single activity
- Test profile updates in journey test mode
Glossary:
- Update Profile activity: An action activity that writes new values to existing fields in an Adobe Experience Platform profile in real time as a profile moves through a journey (product-specific)
- Profile Store: The Adobe Experience Platform store that holds real-time customer profile data, distinct from the Data Lake (product-specific)
- Identity namespace: A label that distinguishes identity contexts (e.g., email, CRM ID) used to match the profile being updated (product-specific)
- Profile-enabled dataset: An Adobe Experience Platform dataset configured to contribute records to the unified profile (product-specific)
Guardrails:
- The Update Profile action can only be used in journeys that have a namespace defined.
- The action only updates existing XDM fields; it cannot create new profile fields.
- Only simple field types are supported (string, number, boolean); enumerations, object arrays, and complex collections are not supported.
- The action cannot generate experience events such as purchases.
- Up to five field/value pairs can be updated in a single Update Profile action.
- Do not share the dedicated dataset with batch or streaming ingestion processes, as other ingestion runs will overwrite Update Profile changes.
- Profile updates may not be immediately available downstream in the same journey execution.
- The activity only updates the Profile Store, not the Data Lake.
Terminology:
- Canonical name: Update Profile — Acronym: none — variants: Update Profile activity, Update Profile action
- Synonyms: “Profile Store” = “Real-Time Customer Profile store”
- Do not confuse: “Profile Store” (updated by this activity) ≠ “Data Lake” (not updated by this activity)
FAQ:
- Q: Can the Update Profile activity create new profile fields? — No, it can only update fields that already exist in the selected XDM Profile schema.
- Q: Why should I use a dedicated dataset for Update Profile actions? — Sharing the dataset with batch or streaming ingestion can cause other ingestion runs to overwrite the changes made by the Update Profile activity.
- Q: Are profile updates immediately visible to downstream activities in the same journey? — No, updated values may not yet be reflected if an action reads the same field immediately after the Update Profile activity writes it.
- Q: How many fields can I update in a single Update Profile action? — Up to five field/value pairs can be configured in a single activity using the “Update another field” button.
- Q: Do profile updates apply in test mode? — Yes, in test mode the updates take effect immediately on the test profile and are not simulated.