自定义个性化连接 custom-personalization-connection
目标更改日志 changelog
概述 overview
设置此目标以允许客户网站上运行的外部个性化平台、内容管理系统、广告服务器和其他应用程序从Adobe Experience Platform检索受众信息。
先决条件 prerequisites
根据您的实施，此目标需要使用以下数据收集方法之一：
- 如果要从网站收集数据，请使用Adobe Experience Platform Web SDK。
- 如果要从移动应用程序收集数据，请使用Adobe Experience Platform Mobile SDK。
- 如果您未使用Web SDK或Mobile SDK，或者要根据配置文件属性对Edge Network体验进行个性化，请使用用户服务器API。
支持的受众 supported-audiences
此部分介绍哪些类型的受众可以导出到此目标。
导出类型和频率 export-type-frequency
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。
连接参数 parameters
在设置此目标时，必须提供以下信息：
- 名称：填写此目标的首选名称。
- 描述：输入目标的描述。 例如，您可以提及要将此目标用于哪个营销活动。 此字段为可选字段。
- 集成别名：此值作为JSON对象名称发送到Experience PlatformWeb SDK。
- 数据流ID：这决定了页面的响应中将包含受众的数据收集数据流。 下拉菜单仅显示已启用目标配置的数据流。有关详细信息，请参阅配置数据流。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读激活配置文件和受众边缘个性化目标。
导出的数据 exported-data
如果您使用Adobe Experience Platform中的Tags来部署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.
});
具有属性的自定义Personalization的示例响应
使用具有属性 的 自定义Personalization时，API响应将与以下示例类似。
具有属性的自定义Personalization 与 自定义Personalization 之间的区别在于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如何实施数据治理的详细信息，请阅读数据治理概述。