自定义个性化连接 custom-personalization-connection

目标更改日志 changelog

发行月份
更新类型
描述
2023 年 5 月
功能和文档更新
自2023年5月起,自定义个性化 ​连接支持基于属性的个性化,通常可供所有客户使用。
IMPORTANT
配置文件属性可能包含敏感数据。 要保护此数据,在为基于属性的个性化配置​ 自定义Personalization ​目标时,必须使用Edge Network服务器API。 所有服务器API调用必须在经过身份验证的上下文中进行。
您可以添加一个服务器端集成,该集成利用您已经用于Web或Mobile SDK实施的相同数据流,从而通过Edge Network服务器API检索配置文件属性。
如果不遵循上述要求,则仅基于受众成员资格进行个性化。

概述 overview

设置此目标以允许客户网站上运行的外部个性化平台、内容管理系统、广告服务器和其他应用程序从Adobe Experience Platform检索受众信息。

先决条件 prerequisites

根据您的实施,此目标需要使用以下数据收集方法之一:

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

支持的受众 supported-audiences

此部分介绍哪些类型的受众可以导出到此目标。

受众来源
支持
描述
Segmentation Service
✓ {\f13 }
通过Experience Platform分段服务生成的受众。
自定义上传
✓ {\f13 }
受众已将从CSV文件导入到Experience Platform中。

导出类型和频率 export-type-frequency

项目
类型
注释
导出类型
Profile request
您正在请求在单个配置文件的自定义个性化目标中映射的所有受众。 可以为其他Adobe数据收集数据流设置其他自定义个性化目标。
导出频率
正在流式传输
流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案,连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

IMPORTANT
若要连接到目标,您需要​ 查看目标 ​和​ 管理目标 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。

要连接到此目标,请按照目标配置教程中描述的步骤操作。

连接参数 parameters

设置此目标时,必须提供以下信息:

  • 名称:填写此目标的首选名称。
  • 描述:输入目标的描述。 例如,您可以提及要将此目标用于哪个营销活动。 此字段为可选字段。
  • 集成别名:此值作为JSON对象名称发送到Experience PlatformWeb SDK。
  • 数据流ID:这决定了页面的响应中将包含受众的数据收集数据流。 下拉菜单仅显示已启用目标配置的数据流。有关详细信息,请参阅配置数据流

启用警报 enable-alerts

您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅使用UI订阅目标警报的指南

完成提供目标连接的详细信息后,选择​ 下一步

激活此目标的受众 activate

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

有关将受众激活到此目标的说明,请阅读激活配置文件和受众边缘个性化目标

导出的数据 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如何实施数据治理的详细信息,请阅读数据治理概述

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