将Adobe Target与Platform Web SDK一起使用

Adobe Experience Platform Web SDK 可以在web渠道中提供和呈现管理 Adobe Target 的个性化体验。您可以使用名为可视化体验编辑器(VEC)的WYSIWYG编辑器，或者使用非可视化界面（基于表单的体验编辑器）来创建、激活和提供活动和个性化体验。

以下功能已经过测试，目前在Target中受支持：

• A/B测试
• A4T展示和转化报表
• Automated Personalization活动
• 体验定位活动
• 多变量测试(MVT)
• Recommendations活动
• 本机Target展示和转化报表
• VEC支持

启用Adobe Target

要启用Target，请执行以下操作：

1. 在datastream中使用相应的客户端代码启用Target。
2. 将renderDecisions选项添加到事件中。

然后，您也可以选择添加以下选项：

• decisionScopes:通过向事件添加此选项来检索特定活动（对于通过基于表单的编辑器创建的活动非常有用）。
• 预隐藏代码片段:仅隐藏页面的某些部分。

使用Adobe Target VEC

要将VEC与Platform Web SDK实施结合使用，请安装并激活Firefox或Chrome VEC助手扩展。

有关更多信息，请参阅​Adobe Target指南​中的Visual Experience Composer帮助程序扩展。

自动渲染VEC活动

Adobe Experience Platform Web SDK能够在Web上自动呈现通过Adobe Target的VEC定义的体验，以供用户使用。 要指示Experience Platform Web SDK自动渲染VEC活动，请发送包含renderDecisions = true的事件：

alloy
("sendEvent", 
  { 
  "renderDecisions": true, 
  "xdm": {
    "commerce": { 
      "order": {
        "purchaseID": "a8g784hjq1mnp3", 
         "purchaseOrderNumber": "VAU3123", 
         "currencyCode": "USD", 
         "priceTotal": 999.98 
         } 
      } 
    }
  }
);

使用基于表单的编辑器

基于表单的体验编辑器是一个非可视化界面，可用于配置具有不同响应类型（如JSON、HTML、图像等）的A/B测试、体验定位、Automated Personalization和Recommendations活动。 根据Target返回的响应类型或决策，可以执行您的核心业务逻辑。 要检索基于表单的编辑器活动的决策，请发送一个事件，其中包含您要为其检索决策的所有“decisionScopes”。

alloy
  ("sendEvent", { 
    decisionScopes: [
      "foo", "bar"], 
      "xdm": {
        "commerce": { 
          "order": { 
            "purchaseID": "a8g784hjq1mnp3", 
            "purchaseOrderNumber": "VAU3123", 
            "currencyCode": "USD", 
            "priceTotal": 999.98 
          } 
        } 
      } 
    }
  );

决策范围

decisionScopes 定义要在其中呈现个性化体验的页面区域、位置或部分。这些decisionScopes是可自定义的，且由用户定义。 对于当前的[!DNL Target]客户，decisionScopes也称为“mbox”。 在[!DNL Target] UI中， decisionScopes显示为“位置”。

__view__范围

Experience Platform Web SDK提供了无需依赖SDK即可检索VEC操作来为您呈现VEC操作的功能。 发送定义为decisionScopes的__view__事件。

alloy("sendEvent", {
      "decisionScopes": ["__view__", "foo", "bar"], 
      "xdm": { 
        "web": { 
          "webPageDetails": { 
            "name": "Home Page"
          }
        } 
      }
    }
  ).then(function(results) {
    for (decision of results.decisions) {
      if (decision.decisionScope === "__view__") {
        console.log(decision.content)
      }
    }
  });

XDM中的受众

在为通过Platform Web SDK交付的Target活动定义受众时，必须定义并使用XDM。 定义XDM架构、类和架构字段组后，可以创建由XDM数据定义的用于定位的Target受众规则。 在Target中，XDM数据作为自定义参数显示在Audience Builder中。 XDM使用点表示法进行序列化（例如，web.webPageDetails.name）。

如果您的Target活动包含使用自定义参数或用户配置文件的预定义受众，则这些活动无法通过SDK正确交付。 您必须改用XDM，而不是使用自定义参数或用户配置文件。 但是，通过Platform Web SDK支持的一些现成受众定位字段不需要XDM。 在Target UI中，不需要XDM的字段如下：

• 定位库
• Adobe Target 中的地域
• 网络
• Operating System
• 网站页面
• 浏览器
• 流量源
• 时间范围

有关更多信息，请参阅​Adobe Target指南​中的受众类别。

单个配置文件更新

使用Platform Web SDK可将配置文件更新为Target配置文件，并将Platform Web SDK作为体验事件更新为。

要更新Target配置文件，请确保配置文件数据与以下内容一起传递：

• 在 “data {“
• 在 “__adobe.target”
• 前缀“profile.”，例如，如下所示

使用此命令的典型Platform Web SDK代码如下所示：

sendEvent使用用户档案数据

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform stuff (event & profile) }
});

示例代码

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    device: {
      screenWidth: 9999
    }
  },
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30,
	"entity.id" : "123",
	"entity.genre" : "Drama"
      }
    }
  }
}) 
.then(console.log);

请求推荐

下表列出了Recommendations属性，以及是否通过Platform Web SDK支持每个属性：

调试

mboxTrace和mboxDebug已被弃用。 使用Platform Web SDK 调试。

术语

决策： 在中 Target，决策与从活动中选择的体验相关联。

架构： 决策的架构是中的选件类 Target型。

范围： 决定的范围。在Target中，范围为mBox。 全局mBox是__view__范围。

XDM: XDM将序列化为点表示法，然后作为mBox Target 参数放入中。