实时查找边缘上的配置文件属性
Adobe Experience Platform使用实时客户个人资料作为所有个人资料数据的单一真实来源。 为了快速实时检索数据，它使用边缘配置文件，这些是分布在Edge Network中的轻量级配置文件。 这允许快速实时的个性化用例。
用例 use-cases
以下是边缘配置文件查找有用的两个用例。
- 实时Personalization：从边缘配置文件中快速检索配置文件信息，以个性化用户在您网站上的体验。
- 客户支持：当客户致电支持中心代理时，实时检索配置文件信息。
本页介绍要实时查找边缘用户档案数据、提供个性化体验或通过下游应用程序告知决策规则必须执行的步骤。
术语和先决条件 prerequisites
在配置本页中所述的用例时，您将使用以下Experience Platform组件：
- 数据流：数据流接收来自Web SDK的传入事件数据并使用边缘配置文件数据进行响应。
- 合并策略：您将创建一个Edge上的Active-On合并策略，以确保边缘配置文件使用正确的配置文件数据。
- 自定义Personalization连接：您将配置新的自定义个性化连接，以将配置文件属性发送到Edge Network。
- Edge Network API：您将使用Edge Network API 交互式数据收集功能从Edge配置文件中快速检索配置文件属性。
性能护栏 guardrails
Edge配置文件查找用例受下表所述的特定性能护栏的约束。 有关Edge Network API护栏的更多详细信息，请参阅护栏文档页面。
步骤1：创建和配置数据流 create-datastream
按照数据流配置文档中的步骤使用以下 服务 设置创建新数据流：
- 服务： Adobe Experience Platform
- Personalization目标：已启用
- Edge分段：如果需要边缘分段，请启用此选项。 如果您只想在边缘上查找配置文件属性，但不想根据边缘配置文件执行任何分段，则将此选项保留为禁用。
步骤2：配置受众以进行Edge评估 audience-edge-evaluation
在Edge上查找配置文件属性时，需要配置受众以进行Edge评估。
确保您计划激活的受众已将Edge上的活动合并策略设置为默认值。 Active-On-Edge合并策略确保在🔗边缘上持续评估受众，并且可用于实时个性化用例。
按照创建合并策略中的说明进行操作，并确保启用 Edge上的活动合并策略 切换开关。
步骤3：将配置文件属性数据发送到Edge Network configure-custom-personalization-connection
要实时查找边缘用户档案（包括属性和受众成员资格数据），需要在Edge Network中提供这些数据。 为此，您必须创建与 具有属性的自定义Personalization 目标的连接，并激活受众，包括要在边缘配置文件中查找的属性。
创建具有属性 的 自定义Personalization连接后，现在即可将配置文件数据发送到Edge Network。
| note important |
|---|
| IMPORTANT |
| 阅读访问控制概述或联系您的产品管理员以获取所需的权限。 |
-
转到连接>目标，然后选择 目录 选项卡。
在Experience Platform UI中突出显示
-
找到 具有属性的自定义Personalization 目标卡，然后选择激活受众，如下图所示。
-
（可选）使用搜索框按名称查找目标连接，或选择过滤器图标以根据您的首选条件缩小结果范围。
-
选择您之前配置的目标连接，然后选择下一步。
-
选择您的受众。 使用受众名称左侧的复选框选择要激活到目标的受众，然后选择下一步。
使用搜索框按名称查找受众，或选择过滤器图标按评估类型（边缘、流式传输或批处理）、命名空间来源或标记缩小结果范围。
note tip TIP 您可以按照在受众浏览屏幕上使用的相同标记进行过滤。 您在其中添加到受众的任何标记都会转移到此屏幕中。 
您可以从多种类型的受众中进行选择，具体取决于其来源：
-
选择要使其可用于边缘轮廓的轮廓属性。
-
选择源属性。 要添加源属性，请在 Source字段 列上选择 添加新字段 控件，然后搜索或导航到所需的XDM属性字段，如下所示。
-
选择目标属性。 要添加目标属性，请选择 目标字段 列上的 添加新字段 控件，并键入要将源属性映射到其中的自定义属性名称。
-
完成配置文件属性的映射后，选择下一步。
在 审核 页面上，您可以看到所选内容的摘要。 选择 取消 以中断流，上一步以修改您的设置，或者选择 完成 以确认您的选择并开始将配置文件数据发送到Edge Network。
在 审核 步骤中，您可以使用页面上的可用过滤器来仅显示其计划或映射已作为此工作流的一部分更新的受众。 您还可以切换要查看的表列。
如果您对您的选择感到满意，并且未检测到任何违反策略的情况，请选择 完成 以确认您的选择。
步骤4：查找边缘上的配置文件属性 configure-edge-profile-lookup
到现在您应该已经完成了数据流的配置，您已经创建了新的具有属性的自定义Personalization目标连接，并且您已使用此连接将发送配置文件属性，您将能够查找到Edge Network。
下一步是配置您的个性化解决方案，以从边缘配置文件中检索配置文件属性。
您在步骤1中配置的数据流现在已准备好接受传入事件数据并使用边缘配置文件信息进行响应。
配置集成以检索边缘配置文件信息，如下面的示例所示。
请求 request
要检索边缘配置文件数据，请向/interact端点发送空POST调用，该端点具有要查找包含在事件中的配置文件属性的主标识，如下所示。
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event":
{
"xdm": {
"identityMap": {
"Email": [
{
"id":"test123@adobetest.com",
"primary":true
}
]
}
}
}
}'
响应 response
成功的响应返回HTTP状态200 OK，其中的Handle对象包含与以下选项卡中的示例类似的信息，具体取决于是否在边缘上找到配置文件。
handle对象可以包含多个不同类型的payload对象。 与边缘配置文件查找相关的信息被分组到具有"type": "activation:pull"的payload对象下，如果配置文件存在于边缘，则根据激活到边缘的配置文件属性和受众，您可以期待一个包含属性和受众成员资格的响应，如下所示。
| code language-json |
|---|
|
handle对象提供了下表描述的信息。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto | |
|---|---|
| 参数 | 描述 |
payload |
包含边缘查找信息的payload对象。 响应可能包含多个其他payload对象，这些对象与边缘查找无关。 |
type |
在响应中，负载按其类型分组。 边缘配置文件查找的有效负载类型始终设置为profileLookup。 |
destinationId |
您在步骤3中创建的 自定义Personalization 连接实例的ID。 |
alias |
目标连接的别名，由用户在创建自定义Personalization目标连接时配置。 |
attributes |
此数组包含您在步骤3中激活的受众的边缘配置文件属性。 |
segments |
此数组包括您在步骤3中激活的受众。 |
type |
handle对象按类型分组。 对于边缘配置文件查找用例，handle对象的类型始终为activation:pull。 |
eventIndex |
Edge Network以数组的形式从客户端接收事件。 数组中的事件顺序在处理期间保持不变，并反映在此索引中。 事件索引从0开始。 |
如果配置文件在边缘上不存在，您可以看到与以下类似的响应。
| code language-json |
|---|
|
handle对象提供了下表描述的信息。
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto | |
|---|---|
| 参数 | 描述 |
payload |
当边缘上不存在该配置文件时，payload对象为空。 |
type |
payload对象按类型分组。 对于边缘配置文件查找用例，payload对象的类型始终为activation:pull。 |
eventIndex |
Edge Network以数组的形式接收来自客户端的事件。 数组中的事件顺序在处理期间保持不变，并反映在此索引中。 事件索引从0开始。 |
结论 conclusion
通过执行上述步骤，您可以高效地实时查找边缘配置文件属性，从而通过下游应用程序实现个性化体验和明智决策。