使用 Adobe Target 和 Platform Web SDK

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

以下功能已经过测试，目前在 Target:

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

Platform Web SDK 系统图

下图可帮助您了解 Target 和 Platform Web SDK 边缘决策。

启用 Adobe Target

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

1. 启用 Target 在 数据流 和相应的客户端代码。
2. 添加 renderDecisions 选项。

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

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

使用Adobe Target VEC

要将VEC与 Platform Web SDK 实施、安装和激活 Firefox 或 铬黄 VEC助手扩展。

有关更多信息，请参阅 可视化体验编辑器助手扩展 在 Adobe Target指南.

呈现个性化内容

请参阅 呈现个性化内容 以了解更多信息。

XDM中的受众

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

如果 Target 具有使用自定义参数或用户配置文件的预定义受众的活动，无法通过SDK正确交付这些活动。 您必须改用XDM，而不是使用自定义参数或用户配置文件。 但是，通过 Platform Web SDK 不需要XDM的XDM。 这些字段在 Target 不需要XDM的UI:

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

有关更多信息，请参阅 受众类别 在 Adobe Target指南.

响应令牌

响应令牌主要用于将元数据发送到Google、Facebook等第三方。 在 meta 字段 propositions -> items. 以下是一个示例：

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

要收集响应令牌，您必须订阅 alloy.sendEvent 承诺，迭代 propositions
并从 items -> meta. 每 proposition 具有 renderAttempted 布尔字段，指示是否 proposition 是否呈现。 请参阅以下示例：

alloy("sendEvent",
  {
    renderDecisions: true,
    decisionScopes: [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

启用自动渲染后，命题数组包含：

在页面加载时：

• 基于表单的编辑器 propositions with renderAttempted 标志设置为 false
• 基于可视化体验编辑器的建议，包括 renderAttempted 标志设置为 true
• 基于可视化体验编辑器的建议，用于单页应用程序视图 renderAttempted 标志设置为 true

在查看时 — 更改（对于缓存的视图）：

• 基于可视化体验编辑器的建议，用于单页应用程序视图 renderAttempted 标志设置为 true

禁用自动渲染时，命题数组包含：

在页面加载时：

• 基于表单的编辑器 propositions with renderAttempted 标志设置为 false
• 基于可视化体验编辑器的建议，包括 renderAttempted 标志设置为 false
• 基于可视化体验编辑器的建议，用于单页应用程序视图 renderAttempted 标志设置为 false

在查看时 — 更改（对于缓存的视图）：

• 基于可视化体验编辑器的建议，用于单页应用程序视图 renderAttempted 标志设置为 false

单个配置文件更新

的 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 data }
});

如何将用户档案属性发送到Adobe Target:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

请求推荐

下表列出 Recommendations 属性以及是否通过 Platform Web SDK:

如何将Recommendations属性发送到Adobe Target:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

调试

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

术语

建议： 在 Target，则命题会将与从活动中选择的体验相关联。

架构： 决策的架构是 Target.

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

XDM: XDM将序列化为点符号，然后放入 Target 作为mBox参数。