文档Experience Platform目标指南

实时查找边缘上的配置文件属性

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 用户

Adobe Experience Platform使用实时客户个人资料作为所有个人资料数据的单一真实来源。 为了快速实时检索数据，它使用边缘配置文件，这些是分布在Edge Network中的轻量级配置文件。 这允许快速实时的个性化用例。

用例 use-cases

以下是边缘配置文件查找有用的两个用例。

  • 实时Personalization：从边缘配置文件中快速检索配置文件信息，以个性化用户在您网站上的体验。
  • 客户支持：当客户致电支持中心代理时，实时检索配置文件信息。

本页介绍要实时查找边缘用户档案数据、提供个性化体验或通过下游应用程序告知决策规则必须执行的步骤。

术语和先决条件 prerequisites

在配置本页中所述的用例时，您将使用以下Experience Platform组件：

  • 数据流：数据流接收来自Web SDK的传入事件数据并使用边缘配置文件数据进行响应。
  • 合并策略：您将创建一个Active-On-Edge合并策略，以确保边缘配置文件使用正确的配置文件数据。
  • 自定义Personalization连接：您将配置新的自定义个性化连接，以将配置文件属性发送到Edge Network。
  • Edge Network API：您将使用Edge Network API 交互式数据收集功能从Edge配置文件中快速检索配置文件属性。

性能护栏 guardrails

Edge配置文件查找用例受下表所述的特定性能护栏的约束。 有关Edge Network API护栏的更多详细信息，请参阅护栏文档页面。

Edge Network服务
Edge区段
每秒请求数
通过Edge Network API的自定义个性化目标
是
1500
通过Edge Network API的自定义个性化目标
否
1500

步骤1：创建和配置数据流 create-datastream

按照数据流配置文档中的步骤使用以下​ Service ​设置创建新数据流：

  • Service: Adobe Experience Platform
  • Personalization Destinations：已启用
  • Edge Segmentation：如果需要边缘分段，请启用此选项。 如果您只想在边缘上查找配置文件属性，但不想根据边缘配置文件执行任何分段，则将此选项保留为禁用。

显示数据流配置屏幕的Experience Platform UI图像。

步骤2：配置受众以进行Edge评估 audience-edge-evaluation

在Edge上查找配置文件属性时，需要配置受众以进行Edge评估。

确保您计划激活的受众已将Edge上的活动合并策略设置为默认值。 Active-On-Edge合并策略确保在边缘上持续评估受众，并且可用于实时个性化用例。

按照创建合并策略中的说明进行操作，并确保启用​ Active-On-Edge Merge Policy ​切换开关。

IMPORTANT
如果您的受众使用不同的合并策略，您将无法从边缘检索配置文件属性，也无法执行边缘配置文件查找。

步骤3：将配置文件属性数据发送到Edge Network configure-custom-personalization-connection

要实时查找Edge用户档案（包括属性和受众成员资格数据），需要在Edge Network中提供这些数据。 为此，您必须创建与​ Custom Personalization With Attributes ​目标的连接并激活受众，包括要在边缘配置文件中查找的属性。

使用属性连接配置自定义Personalization

有关如何创建新目标连接的详细说明，请按照目标连接创建教程中的说明进行操作。

配置新目标时，在字段中选择您在步骤1 Datastream ID​中创建的数据流。 对于​Integration alias，您可以使用任何有助于将来识别此目标连接的值，如目标名称。

Experience Platform UI图像显示“具有属性的自定义Personalization”配置屏幕。

将受众激活到具有属性的自定义Personalization连接

创建​ Custom Personalization With Attributes ​连接后，即可将配置文件数据发送到Edge Network。

note important
IMPORTANT
  • 要激活数据并启用工作流的映射步骤，您需要​View Destinations、Activate Destinations、View Profiles​和​View Segments 访问控制权限。
阅读访问控制概述或联系您的产品管理员以获取所需的权限。

  1. 转到​Connections > Destinations，然后选择​ Catalog ​选项卡。

    在Experience Platform UI中突出显示 目标目录选项卡。

  2. 找到​ Custom Personalization With Attributes ​目标卡，然后选择​Activate audiences，如下图所示。

    激活目录中目标卡上突出显示的受众控件。

  3. 选择您之前配置的目标连接，然后选择​Next。

    在激活工作流中选择目标步骤。

  4. 选择您的受众。 使用受众名称左侧的复选框选择要激活到目标的受众，然后选择​Next。

    您可以从多种类型的受众中进行选择，具体取决于其来源：

    • Segmentation Service：分段服务在Experience Platform中生成的受众。 有关详细信息，请参阅分段文档。

    • Custom upload：受众在Experience Platform之外生成，并以CSV文件形式上传到Experience Platform。 要了解有关外部受众的更多信息，请参阅有关导入受众的文档。

    • 其他类型的受众，来自其他Adobe解决方案，如Audience Manager。

      在激活工作流中选择突出显示多个受众的受众步骤。

  5. 选择要使其可用于边缘轮廓的轮廓属性。

    • 选择源属性。 要添加源属性，请选择​ Add new field ​列上的​ Source field ​控件，然后搜索或导航到所需的XDM属性字段，如下所示。

      显示如何在映射步骤中选择目标属性的屏幕录制。

    • 选择目标属性。 要添加目标属性，请选择​ Add new field ​列上的​ Target field ​控件，并键入要将源属性映射到其中的自定义属性名称。

      显示如何在映射步骤 中选择XDM属性的屏幕录制

完成配置文件属性的映射后，选择​Next。

在​ Review ​页面上，您可以看到所选内容的摘要。 选择​ Cancel ​以中断流，Back​以修改您的设置，或​ Finish ​以确认您的选择并开始将配置文件数据发送到Edge Network。

审核步骤中的选择摘要。

同意策略评估

如果您的组织购买了​ Adobe Healthcare Shield ​或​Adobe Privacy & Security Shield，请选择​ View applicable consent policies ​以查看应用的同意政策以及激活中因此包含的用户档案数。 有关详细信息，请阅读同意策略评估。

数据使用策略检查

在​ Review ​步骤中，Experience Platform还会检查是否存在任何数据使用策略违规。 下面显示了一个违反策略的示例。 在解决该违规之前，您无法完成受众激活工作流。 有关如何解决策略违规的信息，请参阅数据治理文档部分中的数据使用策略违规。

数据策略违规示例。

筛选受众

在​ Review ​步骤中，您可以使用页面上的可用过滤器只显示其计划或映射已作为此工作流的一部分更新的受众。 您还可以切换要查看的表列。

显示审核步骤中可用的受众过滤器的屏幕录制。

如果您对您的选择感到满意，并且未检测到任何违反策略的情况，请选择​ Finish ​以确认您的选择。

步骤4：查找边缘上的配置文件属性 configure-edge-profile-lookup

到现在您应该已经完成了数据流的配置，您已经创建了新的具有属性的自定义Personalization目标连接，并且您已使用此连接将发送配置文件属性，您将能够查找到Edge Network。

下一步是配置您的个性化解决方案，以从边缘配置文件中检索配置文件属性。

IMPORTANT
配置文件属性可能包含敏感数据。 要保护此数据，必须通过Edge Network API检索配置文件属性。 此外，您必须通过Edge Network API 交互式数据收集终结点检索配置文件属性，才能对API调用进行身份验证。
如果您不遵循上述要求，则将仅基于受众成员资格进行个性化，并且用户档案属性将不可使用。

您在步骤1中配置的数据流现在已准备好接受传入事件数据并使用边缘配置文件信息进行响应。

配置集成以检索边缘配置文件信息，如下面的示例所示。

请求 request

要检索边缘配置文件数据，请向POST端点发送空/interact调用，该端点具有要查找包含在事件中的配置文件属性的主标识，如下所示。

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
                    }
                ]
            }
        }
    }

}'
参数
类型
必需
描述
dataStreamId
String
可以。
您在步骤1中创建的数据流的数据流ID。

响应 response

成功的响应返回HTTP状态200 OK，其中的Handle对象包含与以下选项卡中的示例类似的信息，具体取决于是否在边缘上找到配置文件。

NOTE
API响应是模块化的，handle对象可以包含多个不同类型的payload对象。 与边缘配置文件查找相关的信息被分组到具有payload的"type": "activation:pull"对象下，
配置文件存在于边缘

如果配置文件存在于边缘，则根据激活到边缘的配置文件属性和受众，您可以期待一个包含属性和受众成员资格的响应，如下所示。

code language-json 
{
  "requestId": "3c600138-d785-42ca-a025-bb725f4b5da9",
  "handle": [
    {
      "payload": [
        {
          "type": "profileLookup",
          "destinationId": "9218b727-ec59-4a46-b8b9-05503f138c5d",
          "alias": "rk-demo-custom-personalization-XXXX",
          "attributes": {
            "zip": {
              "value": "19000"
            },
            "firstName": {
              "value": "Test"
            },
            "lastName": {
              "value": "User123"
            },
            "gender": {
              "value": "male"
            },
            "city": {
              "value": "Philadelphia"
            },
            "state": {
              "value": "PA"
            },
            "email": {
              "value": "test123@adobetest.com"
            }
          },
          "segments": [
            {
              "id": "85018bd8-7ad1-4e17-ae30-8389c04bd3c0",
              "namespace": "ups"
            },
            {
              "id": "d09a8159-8b30-4178-b2f2-7a8c5e3168d9",
              "namespace": "ups"
            }
          ]
        }
      ],
      "type": "activation:pull",
      "eventIndex": 0
    }
  ]
}

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
参数 描述
payload 包含边缘查找信息的payload对象。 响应可能包含多个其他payload对象，这些对象与边缘查找无关。
type 在响应中，负载按其类型分组。 边缘配置文件查找的有效负载类型始终设置为profileLookup。
destinationId 您在​ Custom Personalization ​步骤3中创建的连接实例的ID。
alias 目标连接的别名，由用户在创建自定义Personalization目标连接时配置。
attributes 此数组包含您在步骤3中激活的受众的边缘配置文件属性。
segments 此数组包括您在步骤3中激活的受众。
type handle对象按类型分组。 对于边缘配置文件查找用例，handle对象的类型始终为activation:pull。
eventIndex Edge Network以数组的形式从客户端接收事件。 数组中的事件顺序在处理期间保持不变，并反映在此索引中。 事件索引从0开始。
边缘上不存在配置文件

如果配置文件在边缘上不存在，您可以看到与以下类似的响应。

code language-json 
{
  "requestId": "531b541a-4541-419e-ac99-fd7e452f0c0f",
  "handle": [
    {
      "payload": [],
      "type": "activation:pull",
      "eventIndex": 0
    }
  ]
}

handle对象提供了下表描述的信息。

table 0-row-2 1-row-2 2-row-2 3-row-2
参数 描述
payload 当边缘上不存在该配置文件时，payload对象为空。
type payload对象按类型分组。 对于边缘配置文件查找用例，payload对象的类型始终为activation:pull。
eventIndex Edge Network以数组的形式接收来自客户端的事件。 数组中的事件顺序在处理期间保持不变，并反映在此索引中。 事件索引从0开始。
SUCCESS
如果您已正确配置集成，则现在可以访问Edge配置文件数据，并且可以使用Edge配置文件的属性和受众成员资格在下游个性化引擎中触发实时个性化。

结论 conclusion

通过执行上述步骤，您可以高效地实时查找边缘配置文件属性，从而通过下游应用程序实现个性化体验和明智决策。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6