将Adobe Target与Platform Web SDK一起使用

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

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

启用Adobe Target

要启用Target,请执行以下操作:

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

然后,您也可以选择添加以下选项:

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

使用Adobe Target VEC

要将VEC与Platform Web SDK实施结合使用,请安装并激活FirefoxChrome 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.”,例如,如下所示
类型 描述
renderDecisions 布尔值 指示个性化组件是否应解释DOM操作
decisionScopes 阵列<String> 要检索决策的范围列表
xdm 对象 在XDM中格式化的数据,这些数据会作为体验事件进入Platform Web SDK中
data 对象 发送到目标类下Target解决方案的任意键/值对。

使用此命令的典型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支持每个属性:

类别 属性 支持状态
Recommendations — 默认实体属性 entity.id 受支持
entity.name 受支持
entity.categoryId 受支持
entity.pageUrl 受支持
entity.thumbnailUrl 受支持
entity.message 受支持
entity.value 受支持
entity.inventory 受支持
entity.brand 受支持
entity.margin 受支持
entity.event.detailsOnly 受支持
Recommendations — 自定义实体属性 entity.yourCustomAttributeName 受支持
Recommendations — 保留的mbox/页面参数 excludedIds 受支持
cartIds 受支持
productPurchasedId 受支持
类别亲和度的页面或项目类别 user.categoryId 受支持

调试

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

术语

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

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

范围: 决定的范围。在Target中,范围为mBox。 全局mBox是__view__范围。

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

在此页面上