自定义个性化连接 custom-personalization-connection
目标更改日志 changelog
概述 overview
设置此目标以允许客户网站上运行的外部个性化平台、内容管理系统、广告服务器和其他应用程序从Adobe Experience Platform检索受众信息。
先决条件 prerequisites
此集成由 Adobe Experience Platform Web SDK 或 Adobe Experience Platform移动SDK. 您必须使用这些SDK之一才能使用此目标。
支持的受众 supported-audiences
此部分介绍哪些类型的受众可以导出到此目标。
导出类型和频率 export-type-frequency
连接到目标 connect
要连接到此目标，请按照 目标配置教程.
连接参数 parameters
同时 设置 此目标必须提供以下信息：
- 名称：填写此目标的首选名称。
- 描述：输入目标的描述。 例如，您可以提及要将此目标用于哪个营销活动。 此字段为可选字段。
- 集成别名：此值作为JSON对象名称发送到Experience PlatformWeb SDK。
- 数据流ID：此值确定在对页面的响应中将包含受众的数据收集数据流。 下拉菜单仅显示已启用目标配置的数据流。请参阅 配置数据流 以了解更多详细信息。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅以下内容中的指南： 使用UI订阅目标警报.
完成提供目标连接的详细信息后，选择 下一个.
激活此目标的受众 activate
读取 激活用户档案和受众边缘个性化目标 有关将受众激活到此目标的说明。
导出的数据 exported-data
如果您使用 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 audience 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 audience IDs into the system that corresponds to adServerAlias
}
}
})
.catch(function(error) {
// Tracking the event failed.
});
的示例响应 使用属性进行自定义个性化
使用时 使用属性进行自定义个性化，则API响应将与以下示例类似。
两者之间的差异 使用属性进行自定义个性化 和 自定义个性化 是包含 attributes 部分。
[
{
"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"
}
]
}
]
数据使用和治理 data-usage-governance
全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。 有关如何执行操作的详细信息 Adobe Experience Platform 实施数据管理，请阅读 数据管理概述.