自定义个性化连接

目标更改日志

发行月份 更新类型 描述
2023 年 5 月 功能和文档更新 截至2023年5月， 自定义个性化 连接支持 基于属性的个性化 并向所有客户正式提供。
重要

配置文件属性可能包含敏感数据。 为了保护此数据， 自定义个性化 目标要求您使用 边缘网络服务器API 在为基于属性的个性化配置目标时。 所有服务器API调用必须在 已验证的上下文.


如果您已在使用Web SDK或Mobile SDK进行集成，则可以通过添加服务器端集成来通过服务器API检索属性。


如果不遵循上述要求，则仅基于区段成员资格进行个性化。

概述

此目标提供了一种方法，可将区段信息从Adobe Experience Platform检索到外部个性化平台、内容管理系统、广告服务器以及在客户网站上运行的其他应用程序。

先决条件

此集成由 Adobe Experience Platform Web SDK 或 Adobe Experience Platform Mobile SDK. 您必须使用这些SDK之一才能使用此目标。

重要

在创建自定义个性化连接之前，请阅读有关如何执行以下操作 将受众数据激活到边缘个性化目标. 本指南将指导您跨多个Experience Platform组件完成同页和下一页个性化用例所需的配置步骤。

导出类型和频率

项目 类型 注释
导出类型 Profile request 您正在请求在单个配置文件的自定义个性化目标中映射的所有区段。 可以为不同的设置不同的自定义个性化目标 Adobe数据收集数据流.
导出频率 流 流目标为基于API的“始终运行”连接。 一旦根据区段评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。 详细了解 流式目标.

连接到目标

重要

要连接到目标，您需要 管理目标 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

要连接到此目标，请按照 目标配置教程.

连接参数

While 设置 必须提供以下信息，才能使用此目标：

  • 名称：填写此目标的首选名称。
  • 描述：输入目标的描述。 例如，您可以提及要将此目标用于哪个营销活动。 此字段是可选的。
  • 集成别名：此值作为JSON对象名称发送到Experience PlatformWeb SDK。
  • 数据流ID：此值确定在响应页面时将包含区段的数据收集数据流。 下拉菜单仅显示已启用目标配置的数据流。参见 配置数据流 了解更多详细信息。

启用警报

您可以启用警报，以接收有关流向目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的更多信息，请参阅以下指南中的 使用UI订阅目标警报.

完成提供目标连接的详细信息后，选择 下一个.

将区段激活到此目标

重要

要激活数据，您需要 管理目标， 激活目标， 查看配置文件、和 查看区段 访问控制权限. 阅读 访问控制概述 或与产品管理员联系以获取所需的权限。

读取 激活用户档案和区段边缘个性化目标 有关将受众区段激活到此目标的说明。

导出的数据

如果您使用 Adobe Experience Platform中的标记 要部署Experience PlatformWeb SDK，请使用 发送事件完成 功能和自定义代码操作将具有 event.destinations 用于查看导出数据的变量。

以下是的示例值 event.destinations 变量：

[
   {
      "type":"profileLookup",
      "destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
      "alias":"personalizationAlias",
      "segments":[
         {
            "id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         },
         {
            "id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         }
      ]
   }
]

如果您没有使用 标记 要部署Experience PlatformWeb SDK，请使用 处理来自事件的响应 功能以查看导出的数据。

可以解析来自Adobe Experience Platform的JSON响应，以查找要与Adobe Experience Platform集成的应用程序的相应集成别名。 区段ID可以作为定位参数传递到应用程序的代码中。 下面是目标响应特有的内容示例。

alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "commerce": {
      "order": {
        "purchaseID": "a8g784hjq1mnp3",
        "purchaseOrderNumber": "VAU3123",
        "currencyCode": "USD",
        "priceTotal": 999.98
      }
    }
  }
}).then(function(result) {
    if(result.destinations) { // Looking to see if the destination results are there

        // Get the destination with a particular alias
        var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
        if(personalizationDestinations.length > 0) {
             // Code to pass the segment IDs into the system that corresponds to personalizationAlias
        }
        var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
        if(adServerDestinations.length > 0) {
            // Code to pass the segment ids into the system that corresponds to adServerAlias
        }
     }
   })
  .catch(function(error) {
    // Tracking the event failed.
  });

的示例响应 使用属性进行自定义个性化

使用时 使用属性进行自定义个性化，则API响应将类似于以下示例。

两者之间的差异 使用属性进行自定义个性化 和 自定义个性化 是包含 attributes API响应中的部分。

[
    {
        "type": "profileLookup",
        "destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
        "alias": "personalizationAlias",
        "attributes": {
             "countryCode": {
                   "value" : "DE"
              },
             "membershipStatus": {
                   "value" : "PREMIUM"
              }
         },
        "segments": [
            {
                "id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            },
            {
                "id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            }
        ]
    }
]

数据使用和管理

全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。 有关以下方面的详细信息： Adobe Experience Platform 实施数据管理，请阅读 数据治理概述.

在此页面上