使用Platform Web SDK设置Adobe Target

了解如何使用Adobe Experience Platform Web SDK实施Adobe Target。 了解如何交付体验以及如何将其他参数传递到Target。

Adobe Target 是一种Adobe Experience Cloud应用程序，可为您提供定制和个性化客户体验所需的一切功能，从而最大限度地增加您的Web和移动设备网站、应用程序及其他数字渠道的收入。

学习目标

在本课程结束时，您可以通过Target的Web SDK实施执行以下操作：

先决条件

要完成此部分中的课程，您必须首先：

添加闪烁处理

在开始之前，请根据标记库的加载方式，确定是否需要额外的闪烁处理解决方案。

异步实施

异步加载标记库时，页面可能会在Target将默认内容替换为个性化内容之前完成渲染。 这种行为可能会导致所谓的“闪烁”，在这种情况下，会先短暂显示默认内容，然后再将该内容替换为个性化内容。 如果要避免出现这种闪烁情况，Adobe建议在紧靠异步标签嵌入代码之前的位置添加一个特殊的预隐藏代码片段。

此代码片段已存在于Luma网站上，但让我们仔细了解一下此代码的用途：

<script>
  !function(e,a,n,t){var i=e.head;if(i){
  if (a) return;
  var o=e.createElement("style");
  o.id="alloy-prehiding",o.innerText=n,i.appendChild(o),setTimeout(function(){o.parentNode&&o.parentNode.removeChild(o)},t)}}
  (document, document.location.href.indexOf("adobe_authoring_enabled") !== -1, ".personalization-container { opacity: 0 !important }", 3000);
</script>

预隐藏代码片段使用您选择的CSS定义在页面头中创建样式标记。 在收到来自Target的响应或达到超时时，将删除此样式标记。

预隐藏行为由代码片段末尾的两个配置控制。

标记中还提供了预隐藏代码片段：

同步实施

Adobe建议如Luma网站上所示异步实施标记。 但是，如果同步加载标记库，则不需要预先隐藏的代码片段。 预隐藏样式而是在Platform Web SDK扩展设置中指定。

同步实施的预隐藏样式可按如下方式配置：

要了解有关Platform Web SDK如何管理闪烁的更多信息，请参阅指南部分： 管理闪烁以提供个性化体验.

配置数据流

必须先在数据流配置中启用Target，Platform Web SDK才能交付任何Target活动。

要在数据流中配置Target，请执行以下操作：

资产令牌

Target Premium客户可以选择使用属性管理用户权限。 Target属性允许您围绕用户可以运行Target活动的位置建立边界。 请参阅 企业权限 部分以了解详细信息。

要设置或查找属性令牌，请导航至 Adobe Target > 管理 > 属性. 此 </> 图标可显示实施代码。 此 at_property value是您将在数据流中使用的属性令牌。

每个数据流只能指定一个属性令牌，但属性令牌覆盖允许您指定替代属性令牌以替换数据流中定义的主属性令牌。 的更新 sendEvent 覆盖数据流也需要操作。

目标环境Id

环境 中的Target帮助您管理开发的所有阶段的实施。 此可选设置指定要用于每个数据流的Target环境。

Adobe建议为每个开发、暂存和生产数据流分别以不同的方式设置Target环境ID，以简化操作。 或者，您可以使用在Target界面中组织环境 主机 功能。

要设置或查找环境ID，请导航至 Adobe Target > 管理 > 环境.

目标第三方ID命名空间

通过这个可选设置，您可以指定要用于Target第三方ID的身份符号。 Target仅支持在单个身份符号或命名空间上同步配置文件。 欲了解更多信息，请参见 mbox3rdPartyId的实时配置文件同步 部分。

标识符号位于下的标识列表中 数据收集 > 客户 > 身份.

对于本教程中使用Luma站点的目的，请使用身份符号 lumaCrmId 在课程中设置的关于 身份.

呈现可视化个性化决策

可视化个性化决策是指在Adobe Target的可视化体验编辑器中创建的体验。 首先，您应该了解Target和标记界面中使用的术语：

更新 发送事件 操作

如果数据流中启用了Target，则Platform Web SDK会交付来自Target的可视个性化决策。 但是， 它们不会自动呈现. 您必须更新 发送事件 用于启用自动渲染的操作。

渲染可视化个性化决策设置使Platform Web SDK自动应用使用Target可视化体验编辑器或“全局mbox”指定的任何修改。

如果您希望使用自定义代码自行呈现或处理这些决策，则可以保留 呈现可视化个性化决策 设置已禁用。 Platform Web SDK非常灵活，它提供了这项功能让您能够完全控制。 您可以参阅指南以了解有关 手动渲染个性化内容.

使用可视化体验编辑器设置Target活动

现在，基本实施部分已完成，请在Target中创建体验定位(XT)活动，以验证所有内容是否均可正常工作。 您可以参阅Target教程，了解 创建体验定位活动 如果您需要帮助。

使用调试器进行验证

如果设置活动，则应该会看到内容在页面上呈现。 但是，即使没有实时活动，您也可以查看“发送事件”网络调用，以确认Target配置正确。

设置和呈现自定义决策范围

自定义决策范围（以前称为“mbox”）可用于通过基于Target表单的HTML编辑器以结构化方式交付体验或JSON内容。 交付给其中一个自定义范围的内容不会由Platform Web SDK自动呈现。 可以使用Tags中的操作渲染。

将范围添加到 发送事件操作

修改页面加载规则以添加自定义决策范围：

处理来自Target的响应

现在，您已配置Platform Web SDK以请求的内容 homepage-hero 范围，必须对响应执行一些操作。 Platform Web SDK标记扩展提供了 发送事件完成 事件，当收到来自 发送事件 已收到操作。

使用基于表单的体验编辑器设置Target活动

现在您有了手动呈现自定义决策范围的规则，可以在Target中创建另一个体验定位(XT)活动。 这次使用基于表单的体验编辑器。

使用调试器进行验证

如果您激活了活动，则应该会在页面上看到内容渲染。 但是，即使没有实时活动，您也可以查看 发送事件 网络调用以确认Target正在为您的自定义范围请求内容。

将参数发送到Target

在本节中，您将传递特定于Target的数据，并深入了解XDM数据如何映射到Target参数。

页面(mbox)参数和XDM

所有XDM字段均自动作为 页面参数 或mbox参数。

其中一些XDM字段将映射到Target后端中的特殊对象。 例如， web.webPageDetails.URL 将自动可用于构建基于URL的定位条件，或作为 page.url 创建配置文件脚本时的对象。

特殊参数和数据对象

有些数据点对于没有从XDM对象映射的Target可能很有用。 这些特殊的Target参数包括：

这些参数必须在 data 对象而不是中的 xdm 对象。 此外，页面（或mbox）参数也可包含在 data 对象。

要填充数据对象，请创建以下数据元素，并重用在中创建的数据元素 创建数据元素 教训：

更新页面加载规则

在XDM对象之外传递Target的其他数据需要更新任何适用的规则。 对于此示例，您唯一必须做的修改是包括新的 data.content 数据元素到常规页面加载规则和产品页面查看规则。

拆分个性化和Analytics请求

Luma网站上的数据层是在tags嵌入代码之前完全定义的。 这样，我们就可以使用单次调用来获取个性化内容(例如从Adobe Target)并发送分析数据(例如发送到Adobe Analytics)。

但是，在许多网站上，数据层的加载时间不够早，或者速度不够快，无法同时为两个应用程序使用一个调用。 在这些情况下，您可以使用两个 发送事件 单个页面加载上的操作，并将第一个操作用于个性化，将第二个操作用于analytics。 通过这种方式拆分事件，可以尽早触发个性化事件，同时等待数据层完全加载后再发送Analytics事件。 这类似于许多Web SDK之前的实施，在这些实施中，Adobe Target会触发 target-global-mbox 之后，Adobe Analytics会触发 s.t() 在页面底部调用

要创建置顶个性化请求，请执行以下操作：

要创建analytics-on-bottom请求：

使用调试器进行验证

现在规则已更新，您可以使用Adobe Debugger验证数据是否正确传递。

在Target界面中验证

接下来，查看Target界面，确认已收到数据，并且这些数据可用于受众和活动。 XDM数据会自动映射到自定义Target参数。 您可以验证Target是否收到了XDM数据，并且可以通过创建受众来使用该数据。

接下来，验证是否已成功传递登录状态配置文件属性。

如果您具有Target Premium，则还可以验证实体数据是否正确传递，以及产品数据是否已写入Recommendations产品目录。

使用保障进行验证

此外，您可以酌情使用Assurance ，以确认Target决策请求获得了正确的数据并且任何服务器端转换均正确发生。 您还可以确认营销活动和体验信息包含在Adobe Analytics调用中，即使Target决策调用和Adobe Analytics调用是单独发送也是如此。

这可以确认，当我们在页面上稍后触发分析跟踪调用时，已正确发送在我们进行Target决策调用时排队等候稍后传输的A4T信息。

现在，您已完成本课程，应该可以使用Platform Web SDK有效实施Adobe Target。

下一步：